chrome.input.ime

Açıklama

Chrome OS için özel bir IME uygulamak üzere chrome.input.ime API'yi kullanın. Bu, uzantınızın tuş vuruşlarını işlemesine, besteyi ayarlamasına ve aday pencereyi yönetmesine olanak tanır.

İzinler

input

Giriş.ime API'yi kullanmak için uzantı manifestinde "giriş" iznini beyan etmeniz gerekir. Örneğin:

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

Kullanılabilirlik

Yalnızca ChromeOS

Örnekler

Aşağıdaki kod, yazılan harfleri büyük harfe dönüştüren bir IME oluşturur.

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

Türler

AssistiveWindowButton

Chrome 85 ve sonraki sürümler

Yardımcı penceredeki düğmelerin kimliği.

Enum

"addToDictionary"

AssistiveWindowProperties

Chrome 85 ve sonraki sürümler

Yardımcı pencerenin özellikleri.

Özellikler

  • announceString

    dize isteğe bağlı

    ChromeVox'un duyuracağı dizeler.

  • tür

  • görünür

    boolean

    AssistiveWindow'u göstermek için doğru değerine, false (yanlış) değerine ayarlanır.

AssistiveWindowType

Chrome 85 ve sonraki sürümler

Yardımcı zaman aralığının türü.

Değer

AutoCapitalizeType

Chrome 69 ve sonraki sürümler

Metin alanının otomatik olarak büyük harf yapma türü.

Enum

"characters"

"sentences"

InputContext

Giriş Bağlamını açıklar

Özellikler

  • autoCapitalize
    Chrome 69 ve sonraki sürümler

    Metin alanının otomatik olarak büyük harf yapma türü.

  • autoComplete

    boolean

    Metin alanının otomatik tamamlamayı isteyip istemediği.

  • autoCorrect

    boolean

    Metin alanının otomatik düzeltmeyi isteyip istemediği.

  • contextID

    sayı

    Metin alanı işlemlerinin hedeflerini belirtmek için kullanılır. onBlur çağrıldığı anda bu kimlik geçersiz hale gelir.

  • shouldDoLearning

    boolean

    Chrome 68 ve sonraki sürümler

    Metin alanına girilen metnin, kullanıcıya yönelik yazma önerilerini iyileştirmek için kullanılıp kullanılmayacağı.

  • spellCheck

    boolean

    Metin alanının yazım denetimi isteyip istemediği.

  • Bu metin alanında düzenlenen değerin türü (Metin, Sayı, URL vb.)

InputContextType

Chrome 44 ve sonraki sürümler

Bu metin alanında düzenlenen değerin türü (Metin, Sayı, URL vb.)

Enum

"text"

"search"

"tel"

"url"

"email"

"number"

"password"

"null"

KeyboardEvent

http://www.w3.org/TR/DOM-Level-3-Events/#events-keyboardEvent adresine bakın

Özellikler

  • altKey

    boole isteğe bağlı

    ALT tuşuna basılıp basılmayacağını belirler.

  • altgrKey

    boole isteğe bağlı

    Chrome 79 ve sonraki sürümler

    ALTGR tuşuna basılıp basılmayacağı.

  • capsLock

    boole isteğe bağlı

    CAPS_LOCK'nın etkin olup olmadığı.

  • kod

    dize

    Basılan fiziksel tuşun değeri. Değer, geçerli klavye düzeninden veya değiştirici durumundan etkilenmez.

  • ctrlKey

    boole isteğe bağlı

    CTRL tuşuna basılıp basılmadığını belirtir.

  • extensionId

    dize isteğe bağlı

    Bu önemli etkinliği gönderenin uzantı kimliği.

  • anahtar

    dize

    Basılan tuşun değeri

  • keyCode

    sayı isteğe bağlı

    Kullanımdan kaldırılan HTML keyCode, basılan anahtarla ilişkilendirilmiş değiştirilmemiş tanımlayıcıyı belirten sisteme ve uygulamaya bağımlı sayısal koddur.

  • requestId

    dize isteğe bağlı

    (Kullanımdan kaldırıldı) İsteğin kimliği. Bunun yerine onKeyEvent etkinliğindeki requestId parametresini kullanın.

  • shiftKey

    boole isteğe bağlı

    ÜST KARAKTER tuşuna basılıp basılmadığı.

  • Tuş tutma veya keydown özelliklerinden biri.

KeyboardEventType

Chrome 44 ve sonraki sürümler

Enum

"keyup"

"keydown"

MenuItem

Dil menüsünden kullanıcıyla etkileşim kurmak için bir giriş yöntemi tarafından kullanılan menü öğesi.

Özellikler

  • işaretli

    boole isteğe bağlı

    Bu öğenin çekle çizilmesi gerektiğini belirtir.

  • etkin

    boole isteğe bağlı

    Bu öğenin etkin olduğunu belirtir.

  • id

    dize

    Bu MenuItem'i referans alan geri çağırmalara aktarılacak dize.

  • etiket

    dize isteğe bağlı

    Bu öğe için menüde görüntülenen metin.

  • style

    MenuItemStyle isteğe bağlı

    Menü öğesinin türü.

  • görünür

    boole isteğe bağlı

    Bu öğenin görünür olduğunu belirtir.

MenuItemStyle

Chrome 44 ve sonraki sürümler

Menü öğesinin türü. Ayırıcılar arasındaki radyo düğmeleri gruplanmış olarak kabul edilir.

Enum

"check"

MenuParameters

Chrome 88 ve sonraki sürümler

Özellikler

  • engineID

    dize

    Kullanılacak motorun kimliği.

  • items

    Eklenecek veya güncellenecek Menü Öğeleri. Bunlar, dizide var oldukları sırayla eklenir.

MouseButton

Chrome 44 ve sonraki sürümler

Hangi fare düğmelerinin tıklandığı.

Enum

"left"

"middle"

"right"

ScreenType

Chrome 44 ve sonraki sürümler

IME'nin etkinleştirildiği ekran türü.

Enum

"normal"

"login"

UnderlineStyle

Chrome 44 ve sonraki sürümler

Bu segmentin değiştirileceği alt çizginin türü.

Enum

"doubleUnderline"

WindowPosition

Chrome 44 ve sonraki sürümler

Aday penceresinin gösterileceği yer. "İmleç" olarak ayarlanırsa pencere, imleci takip eder. "Beste" değerine ayarlanırsa pencere, bestenin başına kilitlenir.

Enum

"composition"

Yöntemler

clearComposition()

Söz
chrome.input.ime.clearComposition(
  parameters: object,
  callback?: function,
)

Geçerli besteyi temizle. Bu uzantı, etkin IME'nin sahibi değilse işlem başarısız olur.

Parametreler

  • Parametreler

    nesne

    • contextID

      sayı

      Bestenin temizleneceği bağlamın kimliği

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür:

    (success: boolean) => void

    • başarılı

      boolean

İlerlemeler

  • Promise<boolean>

    Chrome 111 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geri çağırma işlevleri, geriye dönük uyumluluk için sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

commitText()

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

Sağlanan metni, mevcut girişe kaydeder.

Parametreler

  • Parametreler

    nesne

    • contextID

      sayı

      Metnin kaydedileceği bağlamın kimliği

    • text (metin)

      dize

      Kaydedilecek metin

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür:

    (success: boolean) => void

    • başarılı

      boolean

İlerlemeler

  • Promise<boolean>

    Chrome 111 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geri çağırma işlevleri, geriye dönük uyumluluk için sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

deleteSurroundingText()

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

Düzeltme işaretinin etrafındaki metni siler.

Parametreler

  • Parametreler

    nesne

    • contextID

      sayı

      Çevresindeki metnin silineceği bağlamın kimliği.

    • engineID

      dize

      Etkinliği alan motorun kimliği.

    • length

      sayı

      Silinecek karakter sayısı

    • telafi etmek

      sayı

      Silme işleminin başlayacağı imleç konumundan uzaklık. Bu değer negatif olabilir.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür:

    () => void

İlerlemeler

  • Promise<void>

    Chrome 111 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geri çağırma işlevleri, geriye dönük uyumluluk için sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

hideInputView()

chrome.input.ime.hideInputView()

Sistem tarafından otomatik olarak açılan giriş görünümü penceresini gizler. Giriş görünümü penceresi zaten gizliyse bu işlev hiçbir şey yapmaz.

keyEventHandled()

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

onKeyEvent tarafından alınan önemli etkinliğin işlendiğini belirtir. Bu, yalnızca onKeyEvent işleyicisi eşzamansız ise çağrılmalıdır.

Parametreler

  • requestId

    dize

    İşlenen etkinliğin istek kimliği. Bu, keyEvent.requestId parametresinden gelmelidir

  • yanıt

    boolean

    Tuş vuruşu yapıldıysa doğru, değilse false

sendKeyEvents()

Söz
chrome.input.ime.sendKeyEvents(
  parameters: object,
  callback?: function,
)

Önemli etkinlikleri gönderir. Bu işlevin sanal klavyeler tarafından kullanılması beklenmektedir. Bir kullanıcı, sanal klavyedeki tuşlara bastığında bu işlev söz konusu etkinliği sisteme yaymak için kullanılır.

Parametreler

  • Parametreler

    nesne

    • contextID

      sayı

      Önemli etkinliklerin gönderileceği bağlamın kimliği veya önemli etkinlikleri giriş olmayan alana göndermek için sıfır.

    • keyData

      Önemli etkinlikle ilgili veriler.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür:

    () => void

İlerlemeler

  • Promise<void>

    Chrome 111 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geri çağırma işlevleri, geriye dönük uyumluluk için sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

setAssistiveWindowButtonHighlighted()

Promise Chrome 86 ve sonraki sürümler
chrome.input.ime.setAssistiveWindowButtonHighlighted(
  parameters: object,
  callback?: function,
)

Yardımcı pencerede bir düğmeyi vurgular/vurgulamaz.

Parametreler

  • Parametreler

    nesne

    • announceString

      dize isteğe bağlı

      Ekran okuyucunun duyuracağı metin.

    • Düğmenin kimliği

    • contextID

      sayı

      Yardımcı pencerenin sahibi olan bağlamın kimliği.

    • öne çıkarıldı

      boolean

      Düğmenin vurgulanıp vurgulanmayacağı.

    • windowType

      Düğmenin ait olduğu pencere türü.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür:

    () => void

İlerlemeler

  • Promise<void>

    Chrome 111 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geri çağırma işlevleri, geriye dönük uyumluluk için sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

setAssistiveWindowProperties()

Söz Chrome 85 ve sonraki sürümler
chrome.input.ime.setAssistiveWindowProperties(
  parameters: object,
  callback?: function,
)

Belirtilen özelliklere sahip bir yardımcı pencereyi gösterir/gizler.

Parametreler

  • Parametreler

    nesne

    • contextID

      sayı

      Yardımcı pencerenin sahibi olan bağlamın kimliği.

    • Yardımcı pencerenin özellikleri.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür:

    (success: boolean) => void

    • başarılı

      boolean

İlerlemeler

  • Promise<boolean>

    Chrome 111 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geri çağırma işlevleri, geriye dönük uyumluluk için sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

setCandidates()

Söz
chrome.input.ime.setCandidates(
  parameters: object,
  callback?: function,
)

Geçerli aday listesini belirler. Bu uzantı, etkin IME'nin sahibi değilse bu işlem başarısız olur

Parametreler

  • Parametreler

    nesne

    • adaylar

      nesne[]

      Aday penceresinde gösterilecek adayların listesi

      • ek açıklama

        dize isteğe bağlı

        Adayı açıklayan ek metin

      • aday

        dize

        Aday

      • id

        sayı

        Adayın kimliği

      • etiket

        dize isteğe bağlı

        Adayın yanında gösterilen kısa dize (genellikle kısayol tuşu veya dizin)

      • parentId

        sayı isteğe bağlı

        Bu adayların ekleneceği kimlik

      • kullanım

        nesne isteğe bağlı

        Kelimenin kullanımı veya ayrıntılı açıklaması.

        • body

          dize

          Ayrıntı açıklamasının gövde dizesi.

        • title

          dize

          Ayrıntılar açıklamasının başlık dizesi.

    • contextID

      sayı

      Aday penceresinin sahibi olan bağlamın kimliği.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür:

    (success: boolean) => void

    • başarılı

      boolean

İlerlemeler

  • Promise<boolean>

    Chrome 111 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geri çağırma işlevleri, geriye dönük uyumluluk için sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

setCandidateWindowProperties()

Söz
chrome.input.ime.setCandidateWindowProperties(
  parameters: object,
  callback?: function,
)

Aday penceresinin özelliklerini ayarlar. Uzantı, etkin IME'nin sahibi değilse bu işlem başarısız olur

Parametreler

  • Parametreler

    nesne

    • engineID

      dize

      Özelliklerin ayarlanacağı motorun kimliği.

    • mülkler

      nesne

      • auxiliaryText

        dize isteğe bağlı

        Aday penceresinin alt kısmında gösterilen metin.

      • auxiliaryTextVisible

        boole isteğe bağlı

        Yardımcı metni görüntülemek için doğru, gizlemek için false değerini alır.

      • currentCandidateIndex

        sayı isteğe bağlı

        Chrome 84 ve sonraki sürümler

        Tüm adaylar içinde mevcut seçilen adayın dizini.

      • cursorVisible

        boole isteğe bağlı

        İmleci göstermek için doğru, gizlemek için false (yanlış) değerini alır.

      • pageSize

        sayı isteğe bağlı

        Sayfa başına görüntülenecek aday sayısı.

      • totalCandidates

        sayı isteğe bağlı

        Chrome 84 ve sonraki sürümler

        Aday dönemi için toplam aday sayısı.

      • dikey

        boole isteğe bağlı

        Aday pencerenin dikey olarak oluşturulması gerekiyorsa doğru değerini, yatay yapmak için false (yanlış) değerini alır.

      • görünür

        boole isteğe bağlı

        Candidate penceresini göstermek için doğru, gizlemek için yanlış değerine sahiptir.

      • windowPosition

        WindowPosition isteğe bağlı

        Aday penceresinin gösterileceği yer.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür:

    (success: boolean) => void

    • başarılı

      boolean

İlerlemeler

  • Promise<boolean>

    Chrome 111 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geri çağırma işlevleri, geriye dönük uyumluluk için sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

setComposition()

Söz
chrome.input.ime.setComposition(
  parameters: object,
  callback?: function,
)

Geçerli besteyi ayarlayın. Bu uzantı, etkin IME'nin sahibi değilse işlem başarısız olur.

Parametreler

  • Parametreler

    nesne

    • contextID

      sayı

      Beste metninin ayarlanacağı bağlamın kimliği

    • imleç

      sayı

      İmlecin metnindeki konum.

    • potansiyel

      nesne[] isteğe bağlı

      Segmentlerin ve ilişkili türlerinin listesi.

      • end

        sayı

        Bu segmentin sonra biteceği karakterin dizini.

      • start

        sayı

        Bu segmentin başlatılacağı karakterin dizini

      • Bu segmentin değiştirileceği alt çizginin türü.

    • selectionEnd

      sayı isteğe bağlı

      Metinde seçimin sona erdiği konum.

    • selectionStart

      sayı isteğe bağlı

      Metinde seçimin başladığı konum.

    • text (metin)

      dize

      Ayarlanacak metin

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür:

    (success: boolean) => void

    • başarılı

      boolean

İlerlemeler

  • Promise<boolean>

    Chrome 111 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geri çağırma işlevleri, geriye dönük uyumluluk için sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

setCursorPosition()

Söz
chrome.input.ime.setCursorPosition(
  parameters: object,
  callback?: function,
)

İmlecin aday penceresindeki konumunu ayarlayın. Bu uzantının etkin IME'ye sahip olmadığı durumlarda işlem yapılamaz.

Parametreler

  • Parametreler

    nesne

    • candidateID

      sayı

      Seçilecek adayın kimliği.

    • contextID

      sayı

      Aday penceresinin sahibi olan bağlamın kimliği.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür:

    (success: boolean) => void

    • başarılı

      boolean

İlerlemeler

  • Promise<boolean>

    Chrome 111 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geri çağırma işlevleri, geriye dönük uyumluluk için sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

setMenuItems()

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

Bu IME etkin olduğunda, sağlanan menü öğelerini dil menüsüne ekler.

Parametreler

  • Parametreler
  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür:

    () => void

İlerlemeler

  • Promise<void>

    Chrome 111 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geri çağırma işlevleri, geriye dönük uyumluluk için sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

updateMenuItems()

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

Belirtilen MenuItems öğesinin durumunu günceller

Parametreler

  • Parametreler
  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür:

    () => void

İlerlemeler

  • Promise<void>

    Chrome 111 ve sonraki sürümler

    Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geri çağırma işlevleri, geriye dönük uyumluluk için sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

Etkinlikler

onActivate

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

Bu etkinlik, bir IME etkinleştirildiğinde gönderilir. IME'nin onKey Press etkinliklerini alacağını belirtir.

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür:

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

onAssistiveWindowButtonClicked

Chrome 85 ve sonraki sürümler
chrome.input.ime.onAssistiveWindowButtonClicked.addListener(
  callback: function,
)

Bu etkinlik, yardımcı penceredeki bir düğme tıklandığında gönderilir.

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür:

    (details: object) => void

onBlur

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

Odak, metin kutusundan ayrıldığında bu etkinlik gönderilir. Bu etkinliği dinleyen tüm uzantılara gönderilir ve kullanıcı tarafından etkinleştirilir.

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür:

    (contextID: number) => void

    • contextID

      sayı

onCandidateClicked

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

Bu uzantı, etkin IME'ye sahipse bu etkinlik gönderilir.

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür:

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

onDeactivated

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

Bu etkinlik, bir IME devre dışı bırakıldığında gönderilir. IME'nin artık onKey Press etkinliklerini almayacağını gösterir.

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür:

    (engineID: string) => void

    • engineID

      dize

onFocus

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

Odak, bir metin kutusuna girdiğinde bu etkinlik gönderilir. Bu etkinliği dinleyen tüm uzantılara gönderilir ve kullanıcı tarafından etkinleştirilir.

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür:

    (context: InputContext) => void

onInputContextUpdate

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

Bu etkinlik, geçerli GirişBağlamının özellikleri (ör. tür) değiştiğinde gönderilir. Bu etkinliği dinleyen tüm uzantılara gönderilir ve kullanıcı tarafından etkinleştirilir.

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür:

    (context: InputContext) => void

onKeyEvent

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

İşletim sisteminden önemli bir etkinlik gönderildiğinde tetiklenir. Bu uzantı etkin IME'ye sahipse etkinlik uzantıya gönderilir. Etkinlik yanlış işlendiyse işleyici işlevi true (doğru) değerini döndürmelidir. Etkinlik, eşzamansız olarak değerlendirilecekse bu işlev tanımsız döndürmelidir ve IME'nin daha sonra sonucu içeren keyEventHandled() yöntemini çağırması gerekir.

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür:

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

    • returns

      boole | tanımsız

onMenuItemActivated

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

Kullanıcı bir menü öğesi seçtiğinde çağrılır

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür:

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

    • engineID

      dize

    • ad

      dize

onReset

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

Bu etkinlik, Chrome devam eden metin girişi oturumunu sonlandırdığında gönderilir.

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür:

    (engineID: string) => void

    • engineID

      dize

onSurroundingTextChanged

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

imleç etrafındaki düzenlenebilir dize değiştirildiğinde veya düzeltme işareti konumu taşındığında çağrılır. Metin uzunluğu her iki yön için 100 karakterle sınırlıdır.

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür:

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

    • engineID

      dize

    • surroundingInfo

      nesne

      • anchor

        sayı

        Seçimin başlangıç konumu. Bu değer, seçim yoksa imleç konumunu gösterir.

      • odak

        sayı

        Seçimin bitiş konumu. Bu değer, seçim yoksa imleç konumunu gösterir.

      • telafi etmek

        sayı

        Chrome 46 ve sonraki sürümler

        text öğesinin ofset konumu. text, imlecin çevresinde yalnızca bir metin alt kümesini içerdiğinden, ofset text ilk karakterinin mutlak konumunu gösterir.

      • text (metin)

        dize

        İmlecin etrafındaki metin. Bu, giriş alanındaki tüm metnin yalnızca bir alt kümesidir.