chrome.input.ime

Açıklama

Chrome OS için özel bir IME uygulamak için 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

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

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

Ö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

  string isteğe bağlı

  ChromeVox'un duyuru yapması için kullanılan dizeler.

• tür

• görünür

  boolean

  AssistiveWindow'u göstermek için true değerini, gizlemek için false değerini ayarlar.

AssistiveWindowType

Chrome 85 ve sonraki sürümler

Yardımcı pencere türü.

Değer

AutoCapitalizeType

Chrome 69 ve sonraki sürümler

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

Enum

"characters"

"sentences"

InputContext

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

Özellikler

• autoCapitalize

  AutoCapitalizeType

  Chrome 69 ve sonraki sürümler

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

• autoComplete

  boolean

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

• autoCorrect

  boolean

  Metin alanında otomatik düzeltme istenip istenmediği.

• contextID

  sayı

  Bu, metin alanı işlemlerinin hedeflerini belirtmek için kullanılır. Bu kimlik onBlur çağrıldığı anda 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 istemeyeceğini belirler.

• tür

  InputContextType

  Bu metin alanının düzenlediği değerin türü (Metin, Sayı, URL vb.)

InputContextType

Chrome 44 ve sonraki sürümler

Bu metin alanının düzenlediği değerin türü (Metin, Sayı, URL vb.)

Enum

"text" (metin)

"tel"

"url"

"number"

"null"

KeyboardEvent

Bkz. http://www.w3.org/TR/DOM-Level-3-Events/#events-KlavyeEvent

Özellikler

• altKey

  boole isteğe bağlı

  ALT tuşuna basılı olup olmadığı.

• altgrKey

  boole isteğe bağlı

  Chrome 79 ve sonraki sürümler

  ALTGR tuşuna basılı olup olmadığı.

• capsLock

  boole isteğe bağlı

  CAPS_LOCK öğesinin etkin olup olmadığı.

• kod

  dize

  Basılan fiziksel anahtarın 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ı olup olmadığı.

• extensionId

  string isteğe bağlı

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

• anahtar

  dize

  Basılan anahtarın değeri

• keyCode

  numara isteğe bağlı

  Basılan anahtarla ilişkili değiştirilmemiş tanımlayıcıyı belirten, sisteme ve uygulamaya bağımlı sayısal kod olan kullanımdan kaldırılmış HTML keyCode.

• requestId

  string 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ı olup olmadığı.

• tür

  KeyboardEventType

  Keyup veya keydown değerlerinden biri.

KeyboardEventType

Chrome 44 ve sonraki sürümler

Enum

"keyup"

"keydown"

MenuItem

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

Özellikler

• işaretli

  boole isteğe bağlı

  Bu öğenin onay işaretiyle çizilmesi gerektiğini belirtir.

• etkin

  boole isteğe bağlı

  Bu öğenin etkinleştirildiğini gösterir.

• id

  dize

  Bu MenuItem öğesine başvuran geri çağırmalara geçirilecek dize.

• etiket

  string isteğe bağlı

  Bu öğenin menüsünde 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 gruplandırılmış olarak kabul edilir.

Enum

"check"

MenuParameters

Chrome 88 ve sonraki sürümler

Özellikler

• engineID

  dize

  Kullanılacak motorun kimliği.

• items

  MenuItem[]

  Eklenecek veya güncellenecek Menü Öğeleri. Dizide var oldukları sıraya göre eklenirler.

MouseButton

Chrome 44 ve sonraki sürümler

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

Enum

"left"

"middle"

"right" (sağ)

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 segmentte değiştirilecek alt çizginin türü.

Enum

"doubleUnderline"

"noUnderline"

WindowPosition

Chrome 44 ve sonraki sürümler

Aday penceresinin nerede gösterileceği. "İmleç" olarak ayarlanırsa pencere imleci izler. "Beste" değerine ayarlanırsa pencere bestenin başlangıcına kilitlenir.

Enum

"cursor"

"composition"

Yöntemler

clearComposition()

Söz

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

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

Parametreler

• Parametreler

  nesne

  • contextID

    sayı

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

• geri çağırma

  Functions (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 geriye dönük uyumluluk için geri çağırmalar 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 geçerli girişe kaydeder.

Parametreler

• Parametreler

  nesne

  • contextID

    sayı

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

  • text (metin)

    dize

    Kaydedilecek metin

• geri çağırma

  Functions (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 geriye dönük uyumluluk için geri çağırmalar 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,
)

İmlecin etrafındaki metni siler.

Parametreler

• Parametreler

  nesne

  • contextID

    sayı

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

  • engineID

    dize

    Etkinliği alan motorun kimliği.

  • length

    sayı

    Silinecek karakter sayısı

  • ofset

    sayı

    Silme işleminin başlayacağı düzeltme işareti konumundan uzaklık. Bu değer negatif olabilir.

• geri çağırma

  Functions (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 geriye dönük uyumluluk için geri çağırmalar 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ızsa ç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 kullanıldıysa doğru, değilse false (yanlış)

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, 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ş dışı alana göndermek için sıfırdır.

  • keyData

    KeyboardEvent[]

    Önemli etkinlikle ilgili veriler.

• geri çağırma

  Functions (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 geriye dönük uyumluluk için geri çağırmalar 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()

Söz Chrome 86 ve üstü sürümler

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

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

Parametreler

• Parametreler

  nesne

  • announceString

    string isteğe bağlı

    Ekran okuyucunun anons edeceği metin.

  • buttonID

    AssistiveWindowButton

    Düğmenin kimliği

  • contextID

    sayı

    Yardımcı pencereye sahip 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

  Functions (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 geriye dönük uyumluluk için geri çağırmalar 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,
)

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

Parametreler

• Parametreler

  nesne

  • contextID

    sayı

    Yardımcı pencereye sahip bağlamın kimliği.

  • mülkler

    AssistiveWindowProperties

    Yardımcı pencerenin özellikleri.

• geri çağırma

  Functions (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 geriye dönük uyumluluk için geri çağırmalar 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,
)

Mevcut aday listesini ayarlar. Bu uzantı etkin IME'ye sahip 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

      string isteğe bağlı

      Adayı açıklayan ek metin

    • aday

      dize

      Aday

    • id

      sayı

      Adayın kimliği

    • etiket

      string isteğe bağlı

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

    • parentId

      numara isteğe bağlı

      Bu adayların ekleneceği kimlik

    • kullanım

      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 penceresine sahip bağlamın kimliği.

• geri çağırma

  Functions (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 geriye dönük uyumluluk için geri çağırmalar 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 pencerenin özelliklerini ayarlar. Uzantı etkin IME'ye sahip değilse bu işlem başarısız olur

Parametreler

• Parametreler

  nesne

  • engineID

    dize

    Özelliklerin ayarlanacağı motorun kimliği.

  • mülkler

    nesne

    • auxiliaryText

      string 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 true (doğru), gizlemek için false (yanlış) değerini alır.

    • currentCandidateIndex

      numara isteğe bağlı

      Chrome 84 ve sonraki sürümler

      Toplam adaylar içinde seçili mevcut adayın dizini.

    • cursorVisible

      boole isteğe bağlı

      Doğru (true), imleci göstermek için false (yanlış) değerini girin.

    • pageSize

      numara isteğe bağlı

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

    • totalCandidates

      numara isteğe bağlı

      Chrome 84 ve sonraki sürümler

      Aday zaman aralığı için toplam aday sayısı.

    • dikey

      boole isteğe bağlı

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

    • görünür

      boole isteğe bağlı

      True (doğru), Aday penceresini göstermek için false, gizlemek için false.

    • windowPosition

      WindowPosition (Pencere Konumu) isteğe bağlı

      Aday penceresinin nerede gösterileceği.

• geri çağırma

  Functions (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 geriye dönük uyumluluk için geri çağırmalar 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 bu işlem başarısız olur.

Parametreler

• Parametreler

  nesne

  • contextID

    sayı

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

  • imleç

    sayı

    İmleç metnindeki konum.

  • potansiyel

    object[] isteğe bağlı

    Segmentlerin listesi ve ilişkili türleri.

    • end

      sayı

      Bu segmentin ardından bitecek karakterin dizini.

    • start

      sayı

      Bu segmentin başlatılacağı karakterin dizini

    • style

      UnderlineStyle

      Bu segmentte değiştirilecek alt çizginin türü.

  • selectionEnd

    numara isteğe bağlı

    Seçimin sona erdiği metindeki konum.

  • selectionStart

    numara isteğe bağlı

    Seçimin başladığı metindeki konum.

  • text (metin)

    dize

    Ayarlanacak metin

• geri çağırma

  Functions (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 geriye dönük uyumluluk için geri çağırmalar 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ı etkin IME'ye sahip değilse işlem yapılamaz.

Parametreler

• Parametreler

  nesne

  • candidateID

    sayı

    Seçilecek adayın kimliği.

  • contextID

    sayı

    Aday penceresine sahip bağlamın kimliği.

• geri çağırma

  Functions (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 geriye dönük uyumluluk için geri çağırmalar 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

  MenuParameters

• geri çağırma

  Functions (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 geriye dönük uyumluluk için geri çağırmalar 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

  MenuParameters

• geri çağırma

  Functions (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 geriye dönük uyumluluk için geri çağırmalar 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. Bu mesaj, IME'nin onKeybas etkinliklerini alacağını gösterir.

Parametreler

• geri çağırma

  işlev

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

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

  • engineID

    dize

  • ekran

    ScreenType

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

  • ayrıntılar

    nesne

    • buttonID

      AssistiveWindowButton

      Tıklanan düğmenin kimliği.

    • windowType

      AssistiveWindowType

      Yardımcı pencerenin türü.

onBlur

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

Bu etkinlik, odak bir metin kutusundan çıktığında 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,
)

Etkin IME'nin sahibi bu uzantıysa 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

  • engineID

    dize

  • candidateID

    sayı

  • düğme

    MouseButton

onDeactivated

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

Bu etkinlik, bir IME devre dışı bırakıldığında gönderilir. Bu mesaj, IME'nin artık onKeypress 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,
)

Bu etkinlik, odak bir metin kutusuna girdiğ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

  • context

    InputContext

onInputContextUpdate

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

Bu etkinlik, geçerli InputContext özelliğinin ö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

  • context

    InputContext

onKeyEvent

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

İşletim sisteminden önemli bir etkinlik gönderildiğinde tetiklenir. Etkin IME'nin sahibi bu uzantıya aitse etkinlik uzantıya gönderilir. Etkinlik, yanlış işlendiyse işleyici işlevi true (doğru) döndürecektir. Etkinlik eşzamansız olarak değerlendirilecekse, bu işlev tanımsız döndürmeli ve IME'nin daha sonra sonuçla 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

  • engineID

    dize

  • keyData

    KeyboardEvent

  • requestId

    dize

  • returns

    boolean|undefined

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

İmleç 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 ileri ve geri 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 düzeltme işareti konumunu gösterir.

    • odak

      sayı

      Seçimin bitiş konumu. Bu değer, seçim yoksa düzeltme işareti konumunu gösterir.

    • ofset

      sayı

      Chrome 46 ve sonraki sürümler

      text öğesinin ofset konumu. text yalnızca imlecin etrafındaki metnin bir alt kümesini içerdiğinden, ofset değeri text öğesinin ilk karakterinin mutlak konumunu belirtir.

    • text (metin)

      dize

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