chrome.input.ime

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

Chrome 85 und höher

ID der Schaltflächen im Hilfsfenster.

Enum

"addToDictionary"

AssistiveWindowProperties

Chrome 85 und höher

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

Chrome 85 und höher

Art des Hilfsfensters.

Wert

AutoCapitalizeType

Chrome 69 und höher

Der Typ des Textfelds mit automatischer Groß-/Kleinschreibung.

Enum

"characters"

InputContext

Beschreibt einen Eingabekontext

Attribute

• autoCapitalize

  AutoCapitalizeType

  Chrome 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öher

  Legt 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

  InputContextType

  Werttyp, den dieses Textfeld bearbeitet (Text, Zahl, URL usw.)

InputContextType

Chrome 44 und höher

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öher

  Gibt 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 Ereignis onKeyEvent.

• shiftKey

  Boolescher Wert optional

  Gibt an, ob die Umschalttaste gedrückt wurde.

• Typ

  KeyboardEventType

  Entweder Keyup oder Keydown.

KeyboardEventType

Chrome 44 und höher

Enum

"keyup"

MenuItem

Ein Menüpunkt, der von einer Eingabemethode verwendet wird, um mit dem Nutzer über das Sprachmenü zu interagieren.

Attribute

• aktiviert

  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

Chrome 44 und höher

Die Art des Menüpunkts. Optionsfelder zwischen den Trennzeichen werden als gruppiert betrachtet.

Enum

"radio"

MenuParameters

Chrome 88 und höher

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

Chrome 44 und höher

Auf welche Maustasten geklickt wurde

Enum

ScreenType

Chrome 44 und höher

Der Bildschirmtyp, unter dem der IME aktiviert wird.

Enum

"normal"

"secondary-login"

UnderlineStyle

Chrome 44 und höher

Die Art der Unterstreichung, mit der dieses Segment geändert wird.

Enum

WindowPosition

Chrome 44 und höher

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()

Versprechen

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.

Parameters

• 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

  • Erfolgreich

    boolean

Rückgaben

• Promise<boolean>

  Chrome 111 und höher

  Promise-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()

Versprechen

chrome.input.ime.commitText(
  parameters: object,
  callback?: function,
)

Legt den angegebenen Text für die aktuelle Eingabe fest.

Parameters

• 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

  • Erfolgreich

    boolean

Rückgaben

• Promise<boolean>

  Chrome 111 und höher

  Promise-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()

Versprechen

chrome.input.ime.deleteSurroundingText(
  parameters: object,
  callback?: function,
)

Löscht den Text um das Caret-Zeichen herum.

Parameters

• 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ückgaben

• Promise<void>

  Chrome 111 und höher

  Promise-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.

Parameters

• 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()

Versprechen

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.

Parameters

• 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

    KeyboardEvent[]

    Daten zum Schlüsselereignis.

• callback

  Funktion optional

  Der Parameter callback sieht so aus:

  ()=>void

Rückgaben

• Promise<void>

  Chrome 111 und höher

  Promise-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()

Versprechen Chrome 86 oder höher

chrome.input.ime.setAssistiveWindowButtonHighlighted(
  parameters: object,
  callback?: function,
)

Hebt eine Schaltfläche in einem Hilfsfenster hervor bzw. hebt die Markierung auf.

Parameters

• Parameter

  Objekt

  • announceString

    String optional

    Der Text, den der Screenreader vorlesen soll.

  • buttonID

    AssistiveWindowButton

    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ückgaben

• Promise<void>

  Chrome 111 und höher

  Promise-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()

Versprechen Chrome 85 oder höher

chrome.input.ime.setAssistiveWindowProperties(
  parameters: object,
  callback?: function,
)

Blendet ein Hilfsfenster mit den angegebenen Eigenschaften ein/aus.

Parameters

• Parameter

  Objekt

  • contextID

    Zahl

    ID des Kontexts, zu dem das Unterstützungsfenster gehört.

  • Properties

    AssistiveWindowProperties

    Eigenschaften des Hilfsfensters.

• callback

  Funktion optional

  Der Parameter callback sieht so aus:

  (success: boolean)=>void

  • Erfolgreich

    boolean

Rückgaben

• Promise<boolean>

  Chrome 111 und höher

  Promise-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()

Versprechen

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

Parameters

• 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

  • Erfolgreich

    boolean

Rückgaben

• Promise<boolean>

  Chrome 111 und höher

  Promise-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()

Versprechen

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

Parameters

• 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öher

      Index 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öher

      Die 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

  • Erfolgreich

    boolean

Rückgaben

• Promise<boolean>

  Chrome 111 und höher

  Promise-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()

Versprechen

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.

Parameters

• 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

      UnderlineStyle

      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

  • Erfolgreich

    boolean

Rückgaben

• Promise<boolean>

  Chrome 111 und höher

  Promise-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()

Versprechen

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.

Parameters

• 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

  • Erfolgreich

    boolean

Rückgaben

• Promise<boolean>

  Chrome 111 und höher

  Promise-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()

Versprechen

chrome.input.ime.setMenuItems(
  parameters: MenuParameters,
  callback?: function,
)

Fügt die angegebenen Menüpunkte zum Sprachmenü hinzu, wenn dieser IME aktiv ist.

Parameters

• Parameter

  MenuParameters

• callback

  Funktion optional

  Der Parameter callback sieht so aus:

  ()=>void

Rückgaben

• Promise<void>

  Chrome 111 und höher

  Promise-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()

Versprechen

chrome.input.ime.updateMenuItems(
  parameters: MenuParameters,
  callback?: function,
)

Aktualisiert den Status der angegebenen MenuItems

Parameters

• Parameter

  MenuParameters

• callback

  Funktion optional

  Der Parameter callback sieht so aus:

  ()=>void

Rückgaben

• Promise<void>

  Chrome 111 und höher

  Promise-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.

Parameters

• callback

  Funktion

  Der Parameter callback sieht so aus:

  (engineID: string,screen: ScreenType)=>void

  • engineID

    String

  • Bildschirm

    ScreenType

onAssistiveWindowButtonClicked

Chrome 85 und höher

chrome.input.ime.onAssistiveWindowButtonClicked.addListener(
  callback: function,
)

Dieses Ereignis wird gesendet, wenn auf eine Schaltfläche in einem Hilfsfenster geklickt wird.

Parameters

• callback

  Funktion

  Der Parameter callback sieht so aus:

  (details: object)=>void

  • Details

    Objekt

    • buttonID

      AssistiveWindowButton

      ID der angeklickten Schaltfläche

    • windowType

      AssistiveWindowType

      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.

Parameters

• 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.

Parameters

• callback

  Funktion

  Der Parameter callback sieht so aus:

  (engineID: string,candidateID: number,button: MouseButton)=>void

  • engineID

    String

  • candidateID

    Zahl

  • Schaltfläche

    MouseButton

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.

Parameters

• 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.

Parameters

• callback

  Funktion

  Der Parameter callback sieht so aus:

  (context: InputContext)=>void

  • context

    InputContext

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.

Parameters

• callback

  Funktion

  Der Parameter callback sieht so aus:

  (context: InputContext)=>void

  • context

    InputContext

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.

Parameters

• callback

  Funktion

  Der Parameter callback sieht so aus:

  (engineID: string,keyData: KeyboardEvent,requestId: string)=>boolean|undefined

  • engineID

    String

  • keyData

    KeyboardEvent

  • requestId

    String

  • Gibt zurück

    boolean|undefined

onMenuItemActivated

chrome.input.ime.onMenuItemActivated.addListener(
  callback: function,
)

Wird aufgerufen, wenn der Nutzer einen Menüpunkt auswählt

Parameters

• 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.

Parameters

• 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.

Parameters

• 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öher

      Die Offset-Position von text. Da text nur einen Teil des Textes um den Cursor herum enthält, gibt Offset die absolute Position des ersten Zeichens von text an.

    • Text

      String

      Der Text um den Cursor herum. Dies ist nur eine Teilmenge des gesamten Textes im Eingabefeld.