Beschreibung
Verwenden Sie die chrome.input.ime
API, um einen benutzerdefinierten IME für Chrome OS zu implementieren. Dadurch kann deine Erweiterung Tastenanschläge verarbeiten, die Zusammensetzung festlegen und das Kandidatenfenster verwalten.
Berechtigungen
input
Sie müssen die Berechtigung „input“ im Erweiterungsmanifest deklarieren, um die API „input.ime“ zu verwenden. Beispiel:
{
"name": "My extension",
...
"permissions": [
"input"
],
...
}
Beispiele
Mit dem folgenden Code wird ein IME erstellt, der eingegebene Buchstaben in Großbuchstaben umwandelt.
var context_id = -1;
chrome.input.ime.onFocus.addListener(function(context) {
context_id = context.contextID;
});
chrome.input.ime.onKeyEvent.addListener(
function(engineID, keyData) {
if (keyData.type == "keydown" && keyData.key.match(/^[a-z]$/)) {
chrome.input.ime.commitText({"contextID": context_id,
"text": keyData.key.toUpperCase()});
return true;
} else {
return false;
}
}
);
Typen
AssistiveWindowButton
ID der Schaltflächen im Hilfsfenster.
Enum
"addToDictionary"
AssistiveWindowProperties
Eigenschaften des Hilfsfensters.
Attribute
-
announceString
String optional
Strings für die Ansage von ChromeVox.
-
Typ
-
sichtbar
boolean
Legt „true“ fest, um AssistiveWindow anzuzeigen, und „false“ auf „Ausblenden“.
AssistiveWindowType
Art des Hilfsfensters.
Wert
AutoCapitalizeType
Der Typ des Textfelds mit automatischer Groß-/Kleinschreibung.
Enum
"characters"
InputContext
Beschreibt einen Eingabekontext
Attribute
-
autoCapitalizeChrome 69 und höher
Der Typ des Textfelds mit automatischer Groß-/Kleinschreibung.
-
autoComplete
boolean
Gibt an, ob das Textfeld automatisch vervollständigt werden soll.
-
autoCorrect
boolean
Gibt an, ob für das Textfeld eine Autokorrektur erwünscht ist.
-
contextID
Zahl
Hiermit werden Ziele von Textfeldvorgängen angegeben. Diese ID wird ungültig, sobald onBlur aufgerufen wird.
-
shouldDoLearning
boolean
Chrome 68 und höherLegt fest, ob in das Textfeld eingegebener Text zur Verbesserung der Eingabevorschläge für den Nutzer verwendet werden soll.
-
spellCheck
boolean
Gibt an, ob für das Textfeld eine Rechtschreibprüfung erforderlich ist.
-
Typ
Werttyp, den dieses Textfeld bearbeitet (Text, Zahl, URL usw.)
InputContextType
Werttyp, den dieses Textfeld bearbeitet (Text, Zahl, URL usw.)
Enum
"tel"
"url"
"null"
KeyboardEvent
Weitere Informationen: http://www.w3.org/TR/DOM-Level-3-Events/#events-KeyboardEvent
Attribute
-
altKey
Boolescher Wert optional
Gibt an, ob die ALT-Taste gedrückt wurde.
-
altgrKey
Boolescher Wert optional
Chrome 79 und höherGibt an, ob die ALTGR-Taste gedrückt wurde.
-
capsLock
Boolescher Wert optional
Gibt an, ob CAPS_LOCK aktiviert ist oder nicht.
-
Code
String
Wert der gedrückten physischen Taste. Der Wert wird nicht vom aktuellen Tastaturlayout oder dem Modifikatorstatus beeinflusst.
-
ctrlKey
Boolescher Wert optional
Gibt an, ob die STRG-Taste gedrückt wurde.
-
extensionId
String optional
Die Erweiterungs-ID des Absenders dieses Schlüsselereignisses.
-
Schlüssel
String
Wert der gedrückten Taste
-
keyCode
Nummer optional
Der veraltete HTML-keyCode, der vom System- und implementierungsabhängigen numerischen Code des Codes für die unveränderte Kennung ist, die mit der gedrückten Taste verknüpft ist.
-
requestId
String optional
(Eingestellt) Die ID der Anfrage. Verwenden Sie stattdessen den Parameter
requestId
aus dem EreignisonKeyEvent
. -
shiftKey
Boolescher Wert optional
Gibt an, ob die Umschalttaste gedrückt wurde.
-
Entweder Keyup oder Keydown.
KeyboardEventType
Enum
"keyup"
MenuItem
Ein Menüpunkt, der von einer Eingabemethode verwendet wird, um mit dem Nutzer über das Sprachmenü zu interagieren.
Attribute
-
ausgewählt
Boolescher Wert optional
Gibt an, dass dieses Element mit einem Häkchen gezeichnet werden soll.
-
aktiviert
Boolescher Wert optional
Gibt an, dass das Element aktiviert ist.
-
id
String
String, der an Callbacks übergeben wird, die auf dieses MenuItem verweisen.
-
Label
String optional
Text, der im Menü für dieses Element angezeigt wird.
-
Stil
MenuItemStyle optional
Die Art des Menüpunkts.
-
sichtbar
Boolescher Wert optional
Gibt an, dass dieses Element sichtbar ist.
MenuItemStyle
Die Art des Menüpunkts. Optionsfelder zwischen den Trennzeichen werden als gruppiert betrachtet.
Enum
"radio"
MenuParameters
Attribute
-
engineID
String
ID der zu verwendenden Suchmaschine.
-
items
MenuItem[]
MenuItems, die hinzugefügt oder aktualisiert werden sollen. Sie werden in der Reihenfolge hinzugefügt, in der sie im Array vorhanden sind.
MouseButton
Auf welche Maustasten geklickt wurde
Enum
ScreenType
Der Bildschirmtyp, unter dem der IME aktiviert wird.
Enum
"normal"
"secondary-login"
UnderlineStyle
Die Art der Unterstreichung, mit der dieses Segment geändert wird.
Enum
WindowPosition
Wo das Kandidatenfenster angezeigt werden soll. Wenn „cursor“ festgelegt ist, folgt das Fenster dem Cursor. Wenn der Wert auf "composition" gesetzt ist, ist das Fenster an den Anfang der Komposition gesperrt.
Enum
Methoden
clearComposition()
chrome.input.ime.clearComposition(
parameters: object,
callback?: function,
)
Aktuelle Komposition löschen. Wenn dieser Erweiterung nicht Inhaber des aktiven IME ist, schlägt der Vorgang fehl.
Parameter
-
Parameter
Objekt
-
contextID
Zahl
ID des Kontexts, in dem die Komposition gelöscht wird
-
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:(success: boolean) => void
-
Erfolg
boolean
-
Rückgabe
-
Promise<boolean>
Chrome 111 und höherPromise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.
commitText()
chrome.input.ime.commitText(
parameters: object,
callback?: function,
)
Legt den angegebenen Text für die aktuelle Eingabe fest.
Parameter
-
Parameter
Objekt
-
contextID
Zahl
ID des Kontexts, in dem für den Text ein Commit durchgeführt wird
-
Text
String
Text für den Commit
-
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:(success: boolean) => void
-
Erfolg
boolean
-
Rückgabe
-
Promise<boolean>
Chrome 111 und höherPromise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.
deleteSurroundingText()
chrome.input.ime.deleteSurroundingText(
parameters: object,
callback?: function,
)
Löscht den Text um das Caret-Zeichen herum.
Parameter
-
Parameter
Objekt
-
contextID
Zahl
ID des Kontexts, in dem der umgebende Text gelöscht wird.
-
engineID
String
ID der Suchmaschine, die das Ereignis empfängt.
-
Länge
Zahl
Anzahl der Zeichen, die gelöscht werden sollen
-
kompensiert
Zahl
Der Versatz von der Caret-Position, an der das Löschen beginnt. Dieser Wert kann negativ sein.
-
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:() => void
Rückgabe
-
Promise<void>
Chrome 111 und höherPromise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.
hideInputView()
chrome.input.ime.hideInputView()
Blendet das Eingabeansichtsfenster aus, das vom System automatisch geöffnet wird. Wenn das Eingabeansichtsfenster bereits ausgeblendet ist, führt diese Funktion nichts aus.
keyEventHandled()
chrome.input.ime.keyEventHandled(
requestId: string,
response: boolean,
)
Gibt an, dass das von onKeyEvent empfangene Schlüsselereignis verarbeitet wird. Dieser Parameter sollte nur aufgerufen werden, wenn der onKeyEvent-Listener asynchron ist.
Parameter
-
requestId
String
Anfrage-ID des Ereignisses, das verarbeitet wurde. Muss aus „keyEvent.requestId“ stammen
-
Antwort
boolean
„True“, wenn der Tastenanschlag verarbeitet wurde, „false“, wenn er nicht verwendet wurde
sendKeyEvents()
chrome.input.ime.sendKeyEvents(
parameters: object,
callback?: function,
)
Sendet die Schlüsselereignisse. Diese Funktion wird normalerweise von virtuellen Tastaturen verwendet. Wenn ein Nutzer Taste(n) auf einer Bildschirmtastatur drückt, wird dieses Ereignis mit dieser Funktion an das System weitergegeben.
Parameter
-
Parameter
Objekt
-
contextID
Zahl
ID des Kontexts, in dem die Schlüsselereignisse gesendet werden, oder Null, um Schlüsselereignisse an ein Nicht-Eingabefeld zu senden
-
keyData
Daten zum Schlüsselereignis.
-
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:() => void
Rückgabe
-
Promise<void>
Chrome 111 und höherPromise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.
setAssistiveWindowButtonHighlighted()
chrome.input.ime.setAssistiveWindowButtonHighlighted(
parameters: object,
callback?: function,
)
Hebt eine Schaltfläche in einem Hilfsfenster hervor bzw. hebt die Markierung auf.
Parameter
-
Parameter
Objekt
-
announceString
String optional
Der Text, den der Screenreader vorlesen soll.
-
buttonID
Die ID der Schaltfläche
-
contextID
Zahl
ID des Kontexts, zu dem das Unterstützungsfenster gehört.
-
hervorgehoben
boolean
Legt fest, ob die Schaltfläche hervorgehoben werden soll.
-
windowType
Der Fenstertyp, zu dem die Schaltfläche gehört.
-
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:() => void
Rückgabe
-
Promise<void>
Chrome 111 und höherPromise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.
setAssistiveWindowProperties()
chrome.input.ime.setAssistiveWindowProperties(
parameters: object,
callback?: function,
)
Blendet ein Hilfsfenster mit den angegebenen Eigenschaften ein/aus.
Parameter
-
Parameter
Objekt
-
contextID
Zahl
ID des Kontexts, zu dem das Unterstützungsfenster gehört.
-
Properties
Eigenschaften des Hilfsfensters.
-
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:(success: boolean) => void
-
Erfolg
boolean
-
Rückgabe
-
Promise<boolean>
Chrome 111 und höherPromise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.
setCandidates()
chrome.input.ime.setCandidates(
parameters: object,
callback?: function,
)
Legt die aktuelle Kandidatenliste fest. Dieser Fehler tritt auf, wenn diese Erweiterung nicht Inhaber des aktiven IME ist
Parameter
-
Parameter
Objekt
-
Kandidaten
Objekt[]
Liste der Kandidaten, die im Kandidatenfenster angezeigt werden sollen
-
Annotation
String optional
Zusätzlicher Text zur Beschreibung des Kandidaten
-
Variante
String
Die sich bewerbende Person
-
id
Zahl
ID des Kandidaten
-
Label
String optional
Kurze Zeichenfolge, die neben dem Kandidaten angezeigt wird, oft die Tastenkombination oder der Index
-
parentId
Nummer optional
Die ID, unter der diese Kandidaten hinzugefügt werden sollen
-
Nutzung
Objekt optional
Die Verwendung oder detaillierte Beschreibung des Wortes.
-
body
String
Der Textstring der Detailbeschreibung.
-
Titel
String
Der Titelstring der Detailbeschreibung.
-
-
-
contextID
Zahl
ID des Kontexts, zu dem das Kandidatenfenster gehört.
-
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:(success: boolean) => void
-
Erfolg
boolean
-
Rückgabe
-
Promise<boolean>
Chrome 111 und höherPromise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.
setCandidateWindowProperties()
chrome.input.ime.setCandidateWindowProperties(
parameters: object,
callback?: function,
)
Legt die Eigenschaften des Kandidatenfensters fest. Dieser Fehler tritt auf, wenn die Erweiterung nicht Inhaber des aktiven IME ist
Parameter
-
Parameter
Objekt
-
engineID
String
ID der Suchmaschine, für die Eigenschaften festgelegt werden sollen.
-
Properties
Objekt
-
auxiliaryText
String optional
Text, der unten im Kandidatenfenster angezeigt wird.
-
auxiliaryTextVisible
Boolescher Wert optional
True, um den Hilfstext anzuzeigen, false, um ihn auszublenden.
-
currentCandidateIndex
Nummer optional
Chrome 84 und höherIndex des aktuell ausgewählten Kandidaten aus der Gesamtzahl der Kandidaten.
-
cursorVisible
Boolescher Wert optional
True, um den Cursor anzuzeigen, false, um ihn auszublenden.
-
pageSize
Nummer optional
Die Anzahl der Kandidaten, die pro Seite angezeigt werden sollen.
-
totalCandidates
Nummer optional
Chrome 84 und höherDie Gesamtzahl der Kandidaten für das Kandidatenfenster.
-
Branche
Boolescher Wert optional
"True", wenn das mögliche Fenster vertikal gerendert werden soll, und "false", um es horizontal zu machen.
-
sichtbar
Boolescher Wert optional
True, um das Kandidatenfenster anzuzeigen, falsch, um es auszublenden.
-
windowPosition
WindowPosition optional
Wo das Kandidatenfenster angezeigt werden soll.
-
-
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:(success: boolean) => void
-
Erfolg
boolean
-
Rückgabe
-
Promise<boolean>
Chrome 111 und höherPromise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.
setComposition()
chrome.input.ime.setComposition(
parameters: object,
callback?: function,
)
Hier legen Sie die aktuelle Zusammensetzung fest. Wenn dieser Erweiterung nicht Inhaber des aktiven IME ist, schlägt der Vorgang fehl.
Parameter
-
Parameter
Objekt
-
contextID
Zahl
ID des Kontexts, in dem der Kompositionstext festgelegt wird
-
cursor
Zahl
Position im Text des Cursors.
-
Segmente
Objekt[] optional
Liste der Segmente und der zugehörigen Typen.
-
end
Zahl
Index des Zeichens, nach dem dieses Segment beendet werden soll.
-
start
Zahl
Index des Zeichens, bei dem dieses Segment beginnen soll
-
Stil
Die Art der Unterstreichung, mit der dieses Segment geändert wird.
-
-
selectionEnd
Nummer optional
Position im Text, an der die Auswahl endet.
-
selectionStart
Nummer optional
Position im Text, an der die Auswahl beginnt.
-
Text
String
Festzulegender Text
-
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:(success: boolean) => void
-
Erfolg
boolean
-
Rückgabe
-
Promise<boolean>
Chrome 111 und höherPromise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.
setCursorPosition()
chrome.input.ime.setCursorPosition(
parameters: object,
callback?: function,
)
Legt die Position des Cursors im Kandidatenfenster fest. Wenn diese Erweiterung nicht Inhaber des aktiven IME ist, ist dies ein Leerbefehl.
Parameter
-
Parameter
Objekt
-
candidateID
Zahl
ID des auszuwählenden Kandidaten.
-
contextID
Zahl
ID des Kontexts, zu dem das Kandidatenfenster gehört.
-
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:(success: boolean) => void
-
Erfolg
boolean
-
Rückgabe
-
Promise<boolean>
Chrome 111 und höherPromise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.
setMenuItems()
chrome.input.ime.setMenuItems(
parameters: MenuParameters,
callback?: function,
)
Fügt die angegebenen Menüpunkte zum Sprachmenü hinzu, wenn dieser IME aktiv ist.
Parameter
-
Parameter
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:() => void
Rückgabe
-
Promise<void>
Chrome 111 und höherPromise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.
updateMenuItems()
chrome.input.ime.updateMenuItems(
parameters: MenuParameters,
callback?: function,
)
Aktualisiert den Status der angegebenen MenuItems
Parameter
-
Parameter
-
callback
Funktion optional
Der Parameter
callback
sieht so aus:() => void
Rückgabe
-
Promise<void>
Chrome 111 und höherPromise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.
Veranstaltungen
onActivate
chrome.input.ime.onActivate.addListener(
callback: function,
)
Dieses Ereignis wird gesendet, wenn ein IME aktiviert wird. Sie signalisiert, dass der IME onKeyPress-Ereignisse empfängt.
Parameter
-
callback
Funktion
Der Parameter
callback
sieht so aus:(engineID: string, screen: ScreenType) => void
-
engineID
String
-
Bildschirm
-
onAssistiveWindowButtonClicked
chrome.input.ime.onAssistiveWindowButtonClicked.addListener(
callback: function,
)
Dieses Ereignis wird gesendet, wenn auf eine Schaltfläche in einem Hilfsfenster geklickt wird.
Parameter
-
callback
Funktion
Der Parameter
callback
sieht so aus:(details: object) => void
-
Details
Objekt
-
buttonID
ID der angeklickten Schaltfläche
-
windowType
Der Typ des Hilfsfensters.
-
-
onBlur
chrome.input.ime.onBlur.addListener(
callback: function,
)
Dieser Termin wird gesendet, wenn der Fokus ein Textfeld verlässt. Sie wird an alle Erweiterungen gesendet, die dieses Ereignis abhören, und vom Nutzer aktiviert.
Parameter
-
callback
Funktion
Der Parameter
callback
sieht so aus:(contextID: number) => void
-
contextID
Zahl
-
onCandidateClicked
chrome.input.ime.onCandidateClicked.addListener(
callback: function,
)
Dieses Ereignis wird gesendet, wenn dieser Erweiterung der aktive IME gehört.
Parameter
-
callback
Funktion
Der Parameter
callback
sieht so aus:(engineID: string, candidateID: number, button: MouseButton) => void
-
engineID
String
-
candidateID
Zahl
-
Schaltfläche
-
onDeactivated
chrome.input.ime.onDeactivated.addListener(
callback: function,
)
Dieses Ereignis wird gesendet, wenn ein IME deaktiviert wird. Sie signalisiert, dass der IME keine onKeyPress-Ereignisse mehr empfängt.
Parameter
-
callback
Funktion
Der Parameter
callback
sieht so aus:(engineID: string) => void
-
engineID
String
-
onFocus
chrome.input.ime.onFocus.addListener(
callback: function,
)
Dieser Termin wird gesendet, wenn der Fokus in ein Textfeld fällt. Sie wird an alle Erweiterungen gesendet, die dieses Ereignis abhören, und vom Nutzer aktiviert.
Parameter
-
callback
Funktion
Der Parameter
callback
sieht so aus:(context: InputContext) => void
-
context
-
onInputContextUpdate
chrome.input.ime.onInputContextUpdate.addListener(
callback: function,
)
Dieses Ereignis wird gesendet, wenn sich die Attribute des aktuellen InputContext, z. B. der Typ, ändern. Sie wird an alle Erweiterungen gesendet, die dieses Ereignis abhören, und vom Nutzer aktiviert.
Parameter
-
callback
Funktion
Der Parameter
callback
sieht so aus:(context: InputContext) => void
-
context
-
onKeyEvent
chrome.input.ime.onKeyEvent.addListener(
callback: function,
)
Wird ausgelöst, wenn ein Schlüsselereignis vom Betriebssystem gesendet wird Das Ereignis wird an die Erweiterung gesendet, wenn diese Erweiterung Inhaber des aktiven IME ist. Die Listener-Funktion sollte "true" zurückgeben, wenn das Ereignis andernfalls mit "false" verarbeitet wurde. Wenn das Ereignis asynchron ausgewertet wird, muss diese Funktion undefiniert zurückgeben und der IME muss später keyEventHandled() mit dem Ergebnis aufrufen.
Parameter
-
callback
Funktion
Der Parameter
callback
sieht so aus:(engineID: string, keyData: KeyboardEvent, requestId: string) => boolean | undefined
-
engineID
String
-
keyData
-
requestId
String
-
Gibt zurück
Boolescher Wert | nicht definiert
-
onMenuItemActivated
chrome.input.ime.onMenuItemActivated.addListener(
callback: function,
)
Wird aufgerufen, wenn der Nutzer einen Menüpunkt auswählt
Parameter
-
callback
Funktion
Der Parameter
callback
sieht so aus:(engineID: string, name: string) => void
-
engineID
String
-
name
String
-
onReset
chrome.input.ime.onReset.addListener(
callback: function,
)
Dieses Ereignis wird gesendet, wenn Chrome die laufende Texteingabesitzung beendet.
Parameter
-
callback
Funktion
Der Parameter
callback
sieht so aus:(engineID: string) => void
-
engineID
String
-
onSurroundingTextChanged
chrome.input.ime.onSurroundingTextChanged.addListener(
callback: function,
)
Wird aufgerufen, wenn der bearbeitbare String um das Caret-Zeichen herum geändert wird oder wenn die Caret-Position verschoben wird. Die Textlänge ist auf 100 Zeichen für jede Richtung beschränkt.
Parameter
-
callback
Funktion
Der Parameter
callback
sieht so aus:(engineID: string, surroundingInfo: object) => void
-
engineID
String
-
surroundingInfo
Objekt
-
anchor
Zahl
Die Startposition der Auswahl. Dieser Wert gibt die Caret-Position an, wenn keine Auswahl erfolgt.
-
Konzentration
Zahl
Die Endposition der Auswahl. Dieser Wert gibt die Caret-Position an, wenn keine Auswahl erfolgt.
-
kompensiert
Zahl
Chrome 46 und höherDie Offset-Position von
text
. Datext
nur einen Teil des Textes um den Cursor herum enthält, gibt Offset die absolute Position des ersten Zeichens vontext
an. -
Text
String
Der Text um den Cursor herum. Dies ist nur eine Teilmenge des gesamten Textes im Eingabefeld.
-
-