chrome.input.ime

.

Opis

Implementacja niestandardowego edytora IME dla ChromeOS przy użyciu interfejsu API chrome.input.ime. Dzięki temu rozszerzenie może obsługiwać naciśnięcia klawiszy, ustawiać kompozycję i zarządzać oknem propozycji.

Uprawnienia

input

Musisz zadeklarować „input” uprawnienia w pliku manifestu rozszerzenia na korzystanie z interfejsu APIinput.ime. Przykład:

{
  "name": "My extension",
  ...
  "permissions": [
    "input"
  ],
  ...
}

Dostępność

Tylko ChromeOS

Przykłady

Ten kod tworzy edytor IME, który konwertuje wpisane litery na wielkie litery.

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;
    }
  }
);

Typy

AssistiveWindowButton

Chrome 85 i nowsze

Identyfikator przycisków w oknie wspomagającym.

Typ wyliczeniowy

"cofnij"

"addToDictionary"

AssistiveWindowProperties

Chrome 85 i nowsze

Właściwości okna wspomagającego.

Właściwości

  • announceString

    ciąg znaków opcjonalny

    Ciągi tekstowe, które ChromeVox ma przeczytać na głos.

  • typ

    "cofnij"

  • widoczna

    wartość logiczna

    Ustawia wartość „true” (prawda), aby wyświetlić okno AssistiveWindow, lub na wartość „false”, aby ją ukryć.

AssistiveWindowType

Chrome 85 i nowsze

Typ okna wspomagającego.

Wartość

"cofnij"

AutoCapitalizeType

Chrome w wersji 69 lub nowszej

Typ automatycznego wstawiania wielkich liter w polu tekstowym.

Typ wyliczeniowy

"characters"

"words"

"zdania"

InputContext

Opisuje kontekst danych wejściowych

Właściwości

  • autoCapitalize
    Chrome w wersji 69 lub nowszej

    Typ automatycznego wstawiania wielkich liter w polu tekstowym.

  • autoComplete

    wartość logiczna

    Określa, czy pole tekstowe ma być uzupełnione automatycznie.

  • autoCorrect

    wartość logiczna

    Określa, czy pole tekstowe ma obsługiwać autokorektę.

  • contextID

    liczba

    Służy do określania celów operacji na polach tekstowych. Ten identyfikator staje się nieprawidłowy od razu po wywołaniu funkcji onBlur.

  • shouldDoLearning

    wartość logiczna

    Chrome w wersji 68 lub nowszej

    Określa, czy tekst wpisany w polu tekstowym ma być używany do poprawy podpowiedzi podczas pisania.

  • spellCheck

    wartość logiczna

    Określa, czy pole tekstowe ma być sprawdzane przez sprawdzanie pisowni.

  • Typ wartości edytowanej w tym polu tekstowym (tekst, liczba, adres URL itp.)

InputContextType

Chrome w wersji 44 lub nowszej

Typ wartości edytowanej w tym polu tekstowym (tekst, liczba, adres URL itp.)

Typ wyliczeniowy

"text"

"search"

"tel"

"url"

"email"

"number"

"password"

"null"

KeyboardEvent

Zobacz http://www.w3.org/TR/DOM-Level-3-Events/#events-KlawiaturaEvent

Właściwości

  • altKey

    Wartość logiczna opcjonalna

    Określa, czy został naciśnięty klawisz ALT.

  • altgrKey

    Wartość logiczna opcjonalna

    Chrome w wersji 79 lub nowszej

    Określa, czy został naciśnięty klawisz ALTGR.

  • capsLock

    Wartość logiczna opcjonalna

    Wskazuje, czy jest włączony CAPS_LOCK.

  • kod

    ciąg znaków

    Wartość wciśniętego klawisza fizycznego. Bieżący układ klawiatury ani stan modyfikatora nie ma wpływu na tę wartość.

  • ctrlKey

    Wartość logiczna opcjonalna

    Określa, czy został naciśnięty klawisz CTRL.

  • extensionId

    ciąg znaków opcjonalny

    Identyfikator rozszerzenia nadawcy tego kluczowego zdarzenia.

  • klucz

    ciąg znaków

    Wartość naciśniętego klawisza

  • keyCode

    liczba opcjonalnie

    Wycofany kod klucza HTML, który jest zależny od systemu i implementacji kod numeryczny określający niezmodyfikowany identyfikator powiązany z naciśniętym klawiszem.

  • requestId

    ciąg znaków opcjonalny

    (Wycofano) Identyfikator żądania. Zamiast tego użyj parametru requestId ze zdarzenia onKeyEvent.

  • shiftKey

    Wartość logiczna opcjonalna

    Określa, czy został naciśnięty klawisz SHIFT.

  • Jeden z klawiszy Keyup lub Keydown.

KeyboardEventType

Chrome w wersji 44 lub nowszej

Typ wyliczeniowy

"keyup"

"keydown"

MenuItem

Pozycja menu używana przez metodę wprowadzania tekstu do interakcji z użytkownikiem za pomocą menu języka.

Właściwości

  • zaznaczono

    Wartość logiczna opcjonalna

    Wskazuje, że ten element powinien być rysowany ze znacznikiem wyboru.

  • włączone

    Wartość logiczna opcjonalna

    Wskazuje, że ten element jest włączony.

  • id

    ciąg znaków

    Ciąg, który zostanie przekazany do wywołań zwrotnych odwołujących się do tego elementu MenuItem.

  • etykieta

    ciąg znaków opcjonalny

    Tekst wyświetlany w menu tego elementu.

  • styl

    Opcjonalny MenuItemStyle

    Typ elementu menu.

  • widoczna

    Wartość logiczna opcjonalna

    Wskazuje, że element jest widoczny.

MenuItemStyle

Chrome w wersji 44 lub nowszej

Typ elementu menu. Przyciski opcji między separatorami są uważane za zgrupowane.

Typ wyliczeniowy

"check"

"radio"

"separator"

MenuParameters

Chrome 88 i nowsze

Właściwości

  • engineID

    ciąg znaków

    Identyfikator wyszukiwarki, której chcesz użyć.

  • items

    Elementy MenuItem do dodania lub zaktualizowania. Zostaną one dodane w kolejności, w jakiej występują w tablicy.

MouseButton

Chrome w wersji 44 lub nowszej

które przyciski myszy zostały kliknięte;

Typ wyliczeniowy

"left"

"middle"

"right"

ScreenType

Chrome w wersji 44 lub nowszej

Typ ekranu, w którym edytor IME został aktywowany.

Typ wyliczeniowy

"normal"

"login"

"lock"

"secondary-login"

UnderlineStyle

Chrome w wersji 44 lub nowszej

Typ podkreślenia modyfikującego ten segment.

Typ wyliczeniowy

"underline"

"doubleUnderline"

"noUnderline"

WindowPosition

Chrome w wersji 44 lub nowszej

Gdzie wyświetlać okno z propozycjami. Jeśli ustawisz wartość „kursor”, okno będzie podążać za kursorem. Jeśli zasada jest ustawiona na „kompozycję”, okno jest zablokowane na początku kompozycji.

Typ wyliczeniowy

"kursor"

"composition"

Metody

clearComposition()

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

Wyczyść bieżącą kompozycję. Jeśli to rozszerzenie nie jest właścicielem aktywnego IME, zakończy się niepowodzeniem.

Parametry

  • parametry

    Obiekt

    • contextID

      liczba

      Identyfikator kontekstu, w którym kompozycja zostanie wyczyszczona

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak:

    (success: boolean) => void
    .

    • sukces

      wartość logiczna

Zwroty

  • Promise<boolean>

    Chrome w wersji 111 lub nowszej

    Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

commitText()

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

Zatwierdź podany tekst na bieżące dane wejściowe.

Parametry

  • parametry

    Obiekt

    • contextID

      liczba

      Identyfikator kontekstu, w którym zostanie zatwierdzony tekst

    • tekst

      ciąg znaków

      Tekst do zatwierdzenia

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak:

    (success: boolean) => void
    .

    • sukces

      wartość logiczna

Zwroty

  • Promise<boolean>

    Chrome w wersji 111 lub nowszej

    Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

deleteSurroundingText()

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

Usuwa tekst wokół kursora.

Parametry

  • parametry

    Obiekt

    • contextID

      liczba

      Identyfikator kontekstu, w którym zostanie usunięty otaczający go tekst.

    • engineID

      ciąg znaków

      Identyfikator wyszukiwarki, która odbiera zdarzenie.

    • długość

      liczba

      Liczba znaków do usunięcia

    • odliczyć

      liczba

      Przesunięcie od pozycji kursora od miejsca, w którym rozpocznie się usuwanie. Ta wartość może być ujemna.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak:

    () => void
    .

Zwroty

  • Obietnica<void>

    Chrome w wersji 111 lub nowszej

    Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

hideInputView()

chrome.input.ime.hideInputView()

Ukrywa okno widoku danych wejściowych, które jest automatycznie wyświetlane przez system. Jeśli okno widoku danych wejściowych jest już ukryte, ta funkcja nie będzie wykonywać żadnych działań.

keyEventHandled()

chrome.input.ime.keyEventHandled(
  requestId: string,
  response: boolean,
)

Wskazuje, że kluczowe zdarzenie odebrane przez onKeyEvent jest obsługiwane. Tę metodę należy wywoływać tylko wtedy, gdy detektor onKeyEvent jest asynchroniczny.

Parametry

  • requestId

    ciąg znaków

    Identyfikator żądania obsługiwanego zdarzenia. Powinien on pochodzić z klucza keyEvent.requestId

  • odpowiedź

    wartość logiczna

    Prawda, jeśli po naciśnięciu klawisza zostało obsłużone, fałsz, jeśli nie

sendKeyEvents()

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

Wysyła kluczowe zdarzenia. Ta funkcja powinna być używana na klawiaturach wirtualnych. Gdy użytkownik naciśnie klawisze na klawiaturze wirtualnej, ta funkcja służy do rozpowszechniania zdarzenia w systemie.

Parametry

  • parametry

    Obiekt

    • contextID

      liczba

      Identyfikator kontekstu, w którym będą wysyłane kluczowe zdarzenia, lub wartość 0 w przypadku wysyłania kluczowych zdarzeń do pola, które nie służy do wprowadzania danych.

    • keyData

      Dane o kluczowym zdarzeniu.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak:

    () => void
    .

Zwroty

  • Obietnica<void>

    Chrome w wersji 111 lub nowszej

    Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

setAssistiveWindowButtonHighlighted()

Obietnica Chrome w wersji 86 lub nowszej
chrome.input.ime.setAssistiveWindowButtonHighlighted(
  parameters: object,
  callback?: function,
)

Podświetla lub odznacza przycisk w oknie, które pomaga.

Parametry

  • parametry

    Obiekt

    • announceString

      ciąg znaków opcjonalny

      Tekst do odczytania przez czytnik ekranu.

    • Identyfikator przycisku.

    • contextID

      liczba

      Identyfikator kontekstu będący właścicielem okna wspomagającego.

    • wyróżniona

      wartość logiczna

      Określa, czy przycisk ma być wyróżniony.

    • windowType

      "cofnij"

      Typ okna, do którego należy przycisk.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak:

    () => void
    .

Zwroty

  • Obietnica<void>

    Chrome w wersji 111 lub nowszej

    Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

setAssistiveWindowProperties()

Obietnica Chrome w wersji 85 lub nowszej
chrome.input.ime.setAssistiveWindowProperties(
  parameters: object,
  callback?: function,
)

Pokazuje/ukrywa pomocne okno z podanymi właściwościami.

Parametry

  • parametry

    Obiekt

    • contextID

      liczba

      Identyfikator kontekstu będący właścicielem okna wspomagającego.

    • Właściwości okna wspomagającego.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak:

    (success: boolean) => void
    .

    • sukces

      wartość logiczna

Zwroty

  • Promise&lt;boolean&gt;

    Chrome w wersji 111 lub nowszej

    Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

setCandidates()

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

Ustawia bieżącą listę kandydatów. Ten błąd występuje, jeśli to rozszerzenie nie jest właścicielem aktywnego edytora IME

Parametry

  • parametry

    Obiekt

    • kandydaci

      object[]

      Lista kandydatów do wyświetlenia w oknie z sugestiami

      • adnotacja

        ciąg znaków opcjonalny

        Dodatkowy tekst opisujący kandydata

      • kandydat

        ciąg znaków

        Kandydat

      • id

        liczba

        Identyfikator kandydata

      • etykieta

        ciąg znaków opcjonalny

        Krótki ciąg znaków wyświetlany obok kandydata, często klawisz skrótu lub indeks.

      • parentId

        liczba opcjonalnie

        Identyfikator, do którego należy dodać tych kandydatów

      • wykorzystanie

        obiekt opcjonalny

        Użycie lub szczegółowy opis słowa.

        • treść

          ciąg znaków

          Ciąg tekstowy opisu szczegółów.

        • tytuł

          ciąg znaków

          Tytuł i opis szczegółów.

    • contextID

      liczba

      Identyfikator kontekstu, do którego należy okno z kandydatami.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak:

    (success: boolean) => void
    .

    • sukces

      wartość logiczna

Zwroty

  • Promise&lt;boolean&gt;

    Chrome w wersji 111 lub nowszej

    Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

setCandidateWindowProperties()

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

Ustawia właściwości okna propozycji. Ten błąd występuje, jeśli rozszerzenie nie jest właścicielem aktywnego edytora IME

Parametry

  • parametry

    Obiekt

    • engineID

      ciąg znaków

      Identyfikator wyszukiwarki, w której chcesz ustawić właściwości.

    • usługi

      Obiekt

      • auxiliaryText

        ciąg znaków opcjonalny

        Tekst wyświetlany na dole okna z propozycjami zmian.

      • auxiliaryTextVisible

        Wartość logiczna opcjonalna

        Ustaw wartość True, aby wyświetlić tekst pomocniczy, a false, aby go ukryć.

      • currentCandidateIndex

        liczba opcjonalnie

        Chrome 84 i nowsze

        Indeks aktualnie wybranego kandydata w stosunku do łącznej liczby kandydatów.

      • cursorVisible

        Wartość logiczna opcjonalna

        Wartość Prawda, aby pokazywać kursor, albo fałsz, żeby go ukryć.

      • pageSize

        liczba opcjonalnie

        Liczba propozycji wyświetlanych na stronie.

      • totalCandidates

        liczba opcjonalnie

        Chrome 84 i nowsze

        Łączna liczba kandydatów w oknie kandydatów.

      • kategoria

        Wartość logiczna opcjonalna

        Wartość „prawda”, jeśli okno kandydujące ma być renderowane w pionie, lub „fałsz”, jeśli chcesz ustawić je w poziomie.

      • widoczna

        Wartość logiczna opcjonalna

        Wartość True (prawda), by wyświetlić okno z informacjami o kandydatach, albo false, aby je ukryć.

      • windowPosition

        Gdzie wyświetlać okno z propozycjami.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak:

    (success: boolean) => void
    .

    • sukces

      wartość logiczna

Zwroty

  • Promise&lt;boolean&gt;

    Chrome w wersji 111 lub nowszej

    Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

setComposition()

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

Ustaw bieżącą kompozycję. Jeśli to rozszerzenie nie jest właścicielem aktywnego IME, zakończy się niepowodzeniem.

Parametry

  • parametry

    Obiekt

    • contextID

      liczba

      Identyfikator kontekstu, w którym zostanie ustawiony tekst kompozycji

    • kursor

      liczba

      Pozycja w tekście kursora.

    • segmenty

      obiekt[] opcjonalny

      Lista segmentów i powiązanych z nimi typów.

      • end

        liczba

        Indeks znaku, po którym ma się kończyć ten segment.

      • rozpocznij

        liczba

        Indeks znaku, od którego ma się zaczynać ten segment

      • Typ podkreślenia modyfikującego ten segment.

    • selectionEnd

      liczba opcjonalnie

      Pozycja w tekście, na której kończy się zaznaczenie.

    • selectionStart

      liczba opcjonalnie

      Pozycja w tekście, od której zaczyna się zaznaczenie.

    • tekst

      ciąg znaków

      Tekst do ustawienia

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak:

    (success: boolean) => void
    .

    • sukces

      wartość logiczna

Zwroty

  • Promise&lt;boolean&gt;

    Chrome w wersji 111 lub nowszej

    Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

setCursorPosition()

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

Ustaw pozycję kursora w oknie propozycji. Jeśli to rozszerzenie nie jest właścicielem aktywnego edytora IME, jest to prawidłowe działanie.

Parametry

  • parametry

    Obiekt

    • candidateID

      liczba

      Identyfikator kandydata, którego chcesz użyć.

    • contextID

      liczba

      Identyfikator kontekstu, do którego należy okno z kandydatami.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak:

    (success: boolean) => void
    .

    • sukces

      wartość logiczna

Zwroty

  • Promise&lt;boolean&gt;

    Chrome w wersji 111 lub nowszej

    Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

setMenuItems()

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

Dodaje podane pozycje menu do menu języka, gdy ten edytor IME jest aktywny.

Parametry

  • parametry
  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak:

    () => void
    .

Zwroty

  • Obietnica<void>

    Chrome w wersji 111 lub nowszej

    Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

updateMenuItems()

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

Aktualizuje stan określonych elementów MenuItems

Parametry

  • parametry
  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak:

    () => void
    .

Zwroty

  • Obietnica<void>

    Chrome w wersji 111 lub nowszej

    Obietnice są obsługiwane w Manifest V3 i nowszych, ale wywołania zwrotne są podane w przypadku zgodność wsteczną. Nie można użyć obu w tym samym wywołaniu funkcji. Polecenie promowana jest realizowane z tym samym typem, który jest przekazywany do wywołania zwrotnego.

Wydarzenia

onActivate

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

To zdarzenie jest wysyłane po aktywacji IME. Wskazuje, że edytor IME będzie otrzymywać zdarzenia onKeyPress.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak:

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

onAssistiveWindowButtonClicked

Chrome 85 i nowsze
chrome.input.ime.onAssistiveWindowButtonClicked.addListener(
  callback: function,
)

To zdarzenie jest wysyłane po kliknięciu przycisku w oknie pomocniczym.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak:

    (details: object) => void
    .

onBlur

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

To zdarzenie jest wysyłane, gdy zaznaczenie opuści pole tekstowe. Jest on wysyłany do wszystkich rozszerzeń, które nasłuchują tego zdarzenia, i włączony przez użytkownika.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak:

    (contextID: number) => void
    .

    • contextID

      liczba

onCandidateClicked

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

To zdarzenie jest wysyłane, jeśli to rozszerzenie jest właścicielem aktywnego edytora IME.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak:

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

    • engineID

      ciąg znaków

    • candidateID

      liczba

    • przycisk

onDeactivated

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

To zdarzenie jest wysyłane po dezaktywacji IME. Jest to sygnał, że edytor IME nie będzie już otrzymywać zdarzeń onKeyPress.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak:

    (engineID: string) => void
    .

    • engineID

      ciąg znaków

onFocus

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

To zdarzenie jest wysyłane, gdy zaznaczenie przechodzi do pola tekstowego. Jest on wysyłany do wszystkich rozszerzeń, które nasłuchują tego zdarzenia, i włączony przez użytkownika.

Parametry

onInputContextUpdate

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

To zdarzenie jest wysyłane, gdy zmienią się właściwości bieżącego kontekstu wejściowego, takie jak typ. Jest on wysyłany do wszystkich rozszerzeń, które nasłuchują tego zdarzenia, i włączony przez użytkownika.

Parametry

onKeyEvent

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

Uruchamiane, gdy z systemu operacyjnego zostanie wysłane kluczowe zdarzenie. Zdarzenie zostanie wysłane do rozszerzenia, jeśli jest ono właścicielem aktywnego edytora IME. Jeśli zdarzenie nie zostało przetworzone jako fałsz, funkcja odbiornika powinna zwracać wartość „true” (prawda). Jeśli zdarzenie będzie oceniane asynchronicznie, funkcja musi zwrócić niezdefiniowany element, a IME musi później wywołać z wynikiem funkcję keyEventHandled().

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak:

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

    • engineID

      ciąg znaków

    • keyData
    • requestId

      ciąg znaków

    • returns

      boolean | nie zdefiniowano

onMenuItemActivated

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

Wywoływane, gdy użytkownik wybiera pozycję w menu

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak:

    (engineID: string, name: string) => void
    .

    • engineID

      ciąg znaków

    • nazwa

      ciąg znaków

onReset

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

To zdarzenie jest wysyłane, gdy Chrome zakończy trwającą sesję wprowadzania tekstu.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak:

    (engineID: string) => void
    .

    • engineID

      ciąg znaków

onSurroundingTextChanged

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

Wywoływana po zmianie edytowalnego ciągu wokół kursora lub przesunięcia kursora. Długość tekstu jest ograniczona do 100 znaków dla obu kierunku.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak:

    (engineID: string, surroundingInfo: object) => void
    .

    • engineID

      ciąg znaków

    • surroundingInfo

      Obiekt

      • anchor

        liczba

        Pozycja początkowa zaznaczenia. Jeśli nie można dokonać wyboru, ta wartość wskazuje pozycję kursora.

      • ostrość

        liczba

        Pozycja końcowa zaznaczenia. Jeśli nie można dokonać wyboru, ta wartość wskazuje pozycję kursora.

      • odliczyć

        liczba

        Chrome w wersji 46 lub nowszej,

        Pozycja przesunięcia text. Ponieważ text uwzględnia tylko podzbiór tekstu wokół kursora, przesunięcie wskazuje pozycję bezwzględną pierwszego znaku text.

      • tekst

        ciąg znaków

        Tekst wokół kursora. Jest to tylko podzbiór całego tekstu w polu do wprowadzania danych.