chrome.input.ime

ملاحظة مُهمّة: تعمل واجهة برمجة التطبيقات هذه على ChromeOS فقط.

الوصف

استخدِم واجهة برمجة التطبيقات chrome.input.ime لتطبيق أداة IME مخصّصة لنظام التشغيل Chrome. ويتيح هذا للإضافة التعامل مع ضغطات المفاتيح وضبط المقطوعة الموسيقية وإدارة النافذة المرشّحة.

الأذونات

input

يجب الإفصاح عن إذن "إدخال" في بيان الإضافة لاستخدام واجهة برمجة تطبيقات enter.ime. على سبيل المثال:

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

مدى التوفّر

نظام التشغيل ChromeOS فقط

أمثلة

ينشئ الرمز التالي أداة تحرير أسلوب الإدخال (IME) التي تحوّل الأحرف المكتوبة إلى أحرف كبيرة.

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

الأنواع

AssistiveWindowButton

الإصدار 85 من Chrome والإصدارات الأحدث

رقم تعريف الأزرار في نافذة مساعِدة

التعداد

"addToDictionary"

AssistiveWindowProperties

الإصدار 85 من Chrome والإصدارات الأحدث

خصائص النافذة المساعِدة

أماكن إقامة

• announceString

  سلسلة اختيارية

  سلاسل لـ ChromeVox للإعلان عنها.

• كتابة

• مرئي

  boolean

  لضبط "صحيح" لإظهار AssistiveWindow، يتم ضبط القيمة على "خطأ" على الإخفاء.

AssistiveWindowType

الإصدار 85 من Chrome والإصدارات الأحدث

نوع النافذة المساعِدة

القيمة

AutoCapitalizeType

الإصدار 69 من Chrome والإصدارات الأحدث

نوع الكتابة بالأحرف الكبيرة تلقائيًا في حقل النص.

التعداد

InputContext

يصف سياق الإدخال

أماكن إقامة

• autoCapitalize

  AutoCapitalizeType

  الإصدار 69 من Chrome والإصدارات الأحدث

  نوع الكتابة بالأحرف الكبيرة تلقائيًا في حقل النص.

• autoComplete

  boolean

  ما إذا كان الحقل النصي يريد ميزة الإكمال التلقائي

• autoCorrect

  boolean

  ما إذا كان الحقل النصي يريد التصحيح التلقائي.

• contextID

  الرقم

  يُستخدم هذا لتحديد أهداف عمليات الحقل النصي. يصبح رقم التعريف هذا غير صالح فور طلب onBur.

• shouldDoLearning

  boolean

  الإصدار 68 من Chrome والإصدارات الأحدث

  ما إذا كان يجب استخدام النص الذي تم إدخاله في حقل النص لتحسين اقتراحات الكتابة للمستخدم.

• spellCheck

  boolean

  ما إذا كان الحقل النصي يريد إجراء تدقيق إملائي.

• كتابة

  InputContextType

  نوع القيمة التي يعدّلها الحقل النصي هذا (النص، الرقم، عنوان URL، إلخ)

InputContextType

الإصدار 44 من Chrome أو الإصدارات الأحدث

نوع القيمة التي يعدّلها الحقل النصي هذا (النص، الرقم، عنوان URL، إلخ)

التعداد

"null"

KeyboardEvent

يمكنك الاطلاع على http://www.w3.org/TR/DOM-Level-3-الأحداث/#events-لوحة المفاتيحEvent

أماكن إقامة

• altKey

  قيمة منطقية اختيارية

  لتحديد ما إذا كان قد تم الضغط على مفتاح ALT أم لا

• altgrKey

  قيمة منطقية اختيارية

  الإصدار 79 من Chrome أو الإصدارات الأحدث

  لتحديد ما إذا كان قد تم الضغط على مفتاح ALTGR أم لا.

• capsLock

  قيمة منطقية اختيارية

  سواء تم تمكين CAPS_LOCK أم لا.

• رمز

  سلسلة

  قيمة المفتاح الخارجي الذي يتم الضغط عليه ولا تتأثر القيمة بتنسيق لوحة المفاتيح الحالي أو حالة التعديل.

• ctrlKey

  قيمة منطقية اختيارية

  تحديد ما إذا تم الضغط على مفتاح CTRL أم لا.

• extensionId

  سلسلة اختيارية

  رقم تعريف الإضافة لمرسِل هذا الحدث الرئيسي.

• مفتاح

  سلسلة

  قيمة المفتاح الذي يتم الضغط عليه

• keyCode

  الرقم اختياري

  يشير هذا المصطلح إلى رمز HTML تم إيقافه نهائيًا، وهو رمز رقمي يعتمد على النظام والتنفيذ ويشير إلى المعرّف غير المعدّل المرتبط بالمفتاح الذي تم الضغط عليه.

• requestId

  سلسلة اختيارية

  (متوقف) رقم تعريف الطلب. استخدِم مَعلمة requestId من الحدث onKeyEvent بدلاً من ذلك.

• shiftKey

  قيمة منطقية اختيارية

  لتحديد ما إذا كان قد تم الضغط على مفتاح SHIFT أم لا.

• كتابة

  KeyboardEventType

  أحد مفاتيح التحكّم أو مفتاح التبديل

KeyboardEventType

الإصدار 44 من Chrome أو الإصدارات الأحدث

التعداد

"keyup"

"keydown"

MenuItem

عنصر قائمة يستخدمه أسلوب الإدخال للتفاعل مع المستخدم من قائمة اللغة.

أماكن إقامة

• تم التحديد

  قيمة منطقية اختيارية

  تشير هذه السمة إلى أنه يجب رسم هذا العنصر باستخدام علامة اختيار.

• مفعّلة

  قيمة منطقية اختيارية

  يشير إلى تفعيل هذا العنصر.

• id

  سلسلة

  سلسلة سيتم تمريرها إلى معاودة الاتصال التي تشير إلى MenuItem هذا.

• label

  سلسلة اختيارية

  النص المعروض في القائمة لهذا العنصر.

• style

  MenuItemStyle اختيارية

  نوع عنصر القائمة.

• مرئي

  قيمة منطقية اختيارية

  يشير إلى أنّ هذا العنصر مرئي.

MenuItemStyle

الإصدار 44 من Chrome أو الإصدارات الأحدث

نوع عنصر القائمة. تعتبر أزرار الاختيار بين الفواصل مجمعة.

التعداد

MenuParameters

الإصدار 88 من Chrome أو الإصدارات الأحدث

أماكن إقامة

• engineID

  سلسلة

  رقم تعريف المحرّك المُراد استخدامه.

• items

  MenuItem[]

  أصناف القائمة المراد إضافتها أو تعديلها ستتم إضافتها بالترتيب الذي توجد به في الصفيف.

MouseButton

الإصدار 44 من Chrome أو الإصدارات الأحدث

أزرار الماوس التي تم النقر عليها.

التعداد

ScreenType

الإصدار 44 من Chrome أو الإصدارات الأحدث

نوع الشاشة التي يتم من خلالها تفعيل أداة IME.

التعداد

UnderlineStyle

الإصدار 44 من Chrome أو الإصدارات الأحدث

نوع التسطير المطلوب تعديل هذا المقطع.

التعداد

WindowPosition

الإصدار 44 من Chrome أو الإصدارات الأحدث

مكان عرض النافذة المرشحة في حال ضبط السياسة على "المؤشر"، تتبع النافذة المؤشر. في حال الضبط على "الإنشاء"، يتم قفل النافذة في بداية المقطوعة الموسيقية.

التعداد

الطُرق

clearComposition()

وعد بذلك

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

محو المقطوعة الحالية لن تنجح هذه العملية إذا لم تكن هذه الإضافة تمتلك أداة IME النشطة.

المعلمات

• المَعلَمات

  عنصر

  • contextID

    الرقم

    رقم تعريف السياق الذي سيتم فيه محو المقطوعة الموسيقية

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  (success: boolean) => void

  • النجاح

    boolean

المرتجعات

• Promise<boolean>

  الإصدار 111 من Chrome والإصدارات الأحدث

  تتوفّر الوعود في الإصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال للتوافق مع الأنظمة القديمة. لا يمكنك استخدام كلتيهما في نفس استدعاء الدالة. ويحلّ الوعد بالنوع نفسه الذي يتم إرساله إلى معاودة الاتصال.

commitText()

وعد بذلك

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

تنفيذ النص المقدَّم مع الإدخال الحالي

المعلمات

• المَعلَمات

  عنصر

  • contextID

    الرقم

    معرّف السياق الذي سيتمّ فيه الالتزام بالنص

  • text

    سلسلة

    النص المطلوب الالتزام به

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  (success: boolean) => void

  • النجاح

    boolean

المرتجعات

• Promise<boolean>

  الإصدار 111 من Chrome والإصدارات الأحدث

  تتوفّر الوعود في الإصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال للتوافق مع الأنظمة القديمة. لا يمكنك استخدام كلتيهما في نفس استدعاء الدالة. ويحلّ الوعد بالنوع نفسه الذي يتم إرساله إلى معاودة الاتصال.

deleteSurroundingText()

وعد بذلك

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

لحذف النص حول علامة الإقحام.

المعلمات

• المَعلَمات

  عنصر

  • contextID

    الرقم

    معرّف السياق الذي سيتم فيه حذف النص المحيط

  • engineID

    سلسلة

    رقم تعريف المحرّك الذي يتلقّى الحدث.

  • length

    الرقم

    عدد الأحرف المراد حذفها

  • اقتطاع

    الرقم

    الإزاحة من موضع علامة الإقحام حيث سيبدأ الحذف. يمكن أن تكون هذه القيمة سالبة.

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  () => void

المرتجعات

• Promise<void>

  الإصدار 111 من Chrome والإصدارات الأحدث

  تتوفّر الوعود في الإصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال للتوافق مع الأنظمة القديمة. لا يمكنك استخدام كلتيهما في نفس استدعاء الدالة. ويحلّ الوعد بالنوع نفسه الذي يتم إرساله إلى معاودة الاتصال.

hideInputView()

chrome.input.ime.hideInputView()

إخفاء نافذة عرض الإدخال التي تنبثق تلقائيًا من خلال النظام إذا كانت نافذة عرض الإدخال مخفية مسبقًا، لن تفعل هذه الدالة أي شيء.

keyEventHandled()

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

يشير هذا الرمز إلى أنّه تمّت معالجة الحدث الرئيسي الذي تم استلامه من خلال onKeyEvent. يجب طلب ذلك فقط إذا كان مستمع onKeyEvent غير متزامن.

المعلمات

• requestId

  سلسلة

  رقم تعريف الطلب للحدث الذي تمت معالجته. يجب أن يكون هذا المعرّف من keyEvent.requestId

• رد

  boolean

  True إذا تمت معالجة ضغطة المفتاح، وfalse إذا لم يتم إجراء ذلك

sendKeyEvents()

وعد بذلك

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

إرسال الأحداث الرئيسية. من المتوقع أن يتم استخدام هذه الدالة بواسطة لوحات المفاتيح الافتراضية. عندما يضغط المستخدم على المفاتيح على لوحة المفاتيح الافتراضية، يتم استخدام هذه الدالة لنشر هذا الحدث في النظام.

المعلمات

• المَعلَمات

  عنصر

  • contextID

    الرقم

    رقم تعريف السياق الذي سيتم إرسال الأحداث الرئيسية إليه أو صفر لإرسال الأحداث الرئيسية إلى حقل لا يتضمن إدخالاً

  • keyData

    KeyboardEvent[]

    بيانات الحدث الرئيسي

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  () => void

المرتجعات

• Promise<void>

  الإصدار 111 من Chrome والإصدارات الأحدث

  تتوفّر الوعود في الإصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال للتوافق مع الأنظمة القديمة. لا يمكنك استخدام كلتيهما في نفس استدعاء الدالة. ويحلّ الوعد بالنوع نفسه الذي يتم إرساله إلى معاودة الاتصال.

setAssistiveWindowButtonHighlighted()

وعود Chrome 86+

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

تمييز زر في نافذة مساعِدة أو إلغاء تحديده

المعلمات

• المَعلَمات

  عنصر

  • announceString

    سلسلة اختيارية

    النص الذي سيعلنه قارئ الشاشة.

  • buttonID

    AssistiveWindowButton

    رقم تعريف الزر

  • contextID

    الرقم

    رقم تعريف السياق الذي يملك نافذة المساعدة.

  • بارزة

    boolean

    لتحديد ما إذا كان يجب تحديد الزر أم لا.

  • windowType

    نوع النافذة التي ينتمي إليها الزر.

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  () => void

المرتجعات

• Promise<void>

  الإصدار 111 من Chrome والإصدارات الأحدث

  تتوفّر الوعود في الإصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال للتوافق مع الأنظمة القديمة. لا يمكنك استخدام كلتيهما في نفس استدعاء الدالة. ويحلّ الوعد بالنوع نفسه الذي يتم إرساله إلى معاودة الاتصال.

setAssistiveWindowProperties()

وعود Chrome 85+

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

لإظهار/إخفاء نافذة مساعِدة بالخصائص المذكورة

المعلمات

• المَعلَمات

  عنصر

  • contextID

    الرقم

    رقم تعريف السياق الذي يملك نافذة المساعدة.

  • المواقع

    AssistiveWindowProperties

    خصائص النافذة المساعِدة

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  (success: boolean) => void

  • النجاح

    boolean

المرتجعات

• Promise<boolean>

  الإصدار 111 من Chrome والإصدارات الأحدث

  تتوفّر الوعود في الإصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال للتوافق مع الأنظمة القديمة. لا يمكنك استخدام كلتيهما في نفس استدعاء الدالة. ويحلّ الوعد بالنوع نفسه الذي يتم إرساله إلى معاودة الاتصال.

setCandidates()

وعد بذلك

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

لإعداد قائمة المرشحين الحالية. يتعذّر تنفيذ هذا الإجراء إذا لم تكن هذه الإضافة تمتلك أداة IME النشطة

المعلمات

• المَعلَمات

  عنصر

  • مرشحون

    الكائن[]

    قائمة المرشحين للعرض في نافذة العناصر المرشحة

    • علامة توضيح

      سلسلة اختيارية

      نص إضافي يصف المرشّح

    • عنصر محفّز لعرض الإعلان

      سلسلة

      المرشح

    • id

      الرقم

      معرّف المرشح

    • label

      سلسلة اختيارية

      سلسلة قصيرة يتم عرضها بجانب العنصر المرشح، وغالبًا ما يكون مفتاح الاختصار أو الفهرس

    • parentId

      الرقم اختياري

      رقم التعريف لإضافة هذه العناصر المرشحة ضمن

    • الاستخدام

      الكائن اختياري

      استخدام الكلمة أو وصف تفصيلي لها.

      • body

        سلسلة

        سلسلة النص الأساسي للوصف التفصيلي.

      • title

        سلسلة

        سلسلة العنوان لوصف التفاصيل.

  • contextID

    الرقم

    رقم تعريف السياق الذي يملك النافذة المرشحة.

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  (success: boolean) => void

  • النجاح

    boolean

المرتجعات

• Promise<boolean>

  الإصدار 111 من Chrome والإصدارات الأحدث

  تتوفّر الوعود في الإصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال للتوافق مع الأنظمة القديمة. لا يمكنك استخدام كلتيهما في نفس استدعاء الدالة. ويحلّ الوعد بالنوع نفسه الذي يتم إرساله إلى معاودة الاتصال.

setCandidateWindowProperties()

وعد بذلك

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

لضبط خصائص النافذة المرشحة يتعذّر تنفيذ هذا الإجراء إذا لم تكن الإضافة تمتلك أداة IME النشطة

المعلمات

• المَعلَمات

  عنصر

  • engineID

    سلسلة

    رقم تعريف المحرّك المطلوب ضبط الخصائص عليه

  • المواقع

    عنصر

    • auxiliaryText

      سلسلة اختيارية

      النص الذي يظهر أسفل نافذة المرشح.

    • auxiliaryTextVisible

      قيمة منطقية اختيارية

      صحيح لعرض النص المساعِد، وخطأ لإخفائها.

    • currentCandidateIndex

      الرقم اختياري

      الإصدار 84 من Chrome أو الإصدارات الأحدث

      فهرس المرشح الذي تم اختياره حاليًا من إجمالي إجمالي المرشحين.

    • cursorVisible

      قيمة منطقية اختيارية

      صحيح لإظهار المؤشر، وخطأ لإخفائها.

    • pageSize

      الرقم اختياري

      عدد العناصر المرشحة للعرض في كل صفحة.

    • totalCandidates

      الرقم اختياري

      الإصدار 84 من Chrome أو الإصدارات الأحدث

      إجمالي عدد المرشحين للنافذة المرشحة.

    • فئة

      قيمة منطقية اختيارية

      True إذا كان يجب عرض النافذة المرشحة بالوضع العمودي، وfalse لجعلها أفقية.

    • مرئي

      قيمة منطقية اختيارية

      صحيح لإظهار نافذة المرشح، وخطأ لإخفائها.

    • windowPosition

      WindowPosition اختياري

      مكان عرض النافذة المرشحة

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  (success: boolean) => void

  • النجاح

    boolean

المرتجعات

• Promise<boolean>

  الإصدار 111 من Chrome والإصدارات الأحدث

  تتوفّر الوعود في الإصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال للتوافق مع الأنظمة القديمة. لا يمكنك استخدام كلتيهما في نفس استدعاء الدالة. ويحلّ الوعد بالنوع نفسه الذي يتم إرساله إلى معاودة الاتصال.

setComposition()

وعد بذلك

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

ضبط المقطوعة الموسيقية الحالية لن تنجح هذه العملية إذا لم تكن هذه الإضافة تمتلك أداة IME النشطة.

المعلمات

• المَعلَمات

  عنصر

  • contextID

    الرقم

    معرّف السياق الذي سيتمّ فيه ضبط نص المقطوعة الموسيقية

  • مؤشر

    الرقم

    الموضع في نص المؤشر.

  • مماثلة

    object[] اختياري

    قائمة الشرائح والأنواع المرتبطة بها.

    • إنهاء

      الرقم

      فهرس الحرف الذي سيتم إنهاء هذا الجزء بعده.

    • بدء

      الرقم

      فهرس الحرف المطلوب بدء هذا الجزء عنده

    • style

      UnderlineStyle

      نوع التسطير المطلوب تعديل هذا المقطع.

  • selectionEnd

    الرقم اختياري

    الموضع في النص الذي ينتهي عنده التحديد.

  • selectionStart

    الرقم اختياري

    الموضع في النص الذي يبدأ به التحديد.

  • text

    سلسلة

    النص المطلوب ضبطه

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  (success: boolean) => void

  • النجاح

    boolean

المرتجعات

• Promise<boolean>

  الإصدار 111 من Chrome والإصدارات الأحدث

  تتوفّر الوعود في الإصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال للتوافق مع الأنظمة القديمة. لا يمكنك استخدام كلتيهما في نفس استدعاء الدالة. ويحلّ الوعد بالنوع نفسه الذي يتم إرساله إلى معاودة الاتصال.

setCursorPosition()

وعد بذلك

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

اضبط موضع المؤشر في النافذة المرشحة. لا يمكن اتّخاذ هذا الإجراء إذا كانت هذه الإضافة لا تملك أداة IME النشطة.

المعلمات

• المَعلَمات

  عنصر

  • candidateID

    الرقم

    رقم تعريف المرشّح المطلوب اختياره

  • contextID

    الرقم

    رقم تعريف السياق الذي يملك النافذة المرشحة.

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  (success: boolean) => void

  • النجاح

    boolean

المرتجعات

• Promise<boolean>

  الإصدار 111 من Chrome والإصدارات الأحدث

  تتوفّر الوعود في الإصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال للتوافق مع الأنظمة القديمة. لا يمكنك استخدام كلتيهما في نفس استدعاء الدالة. ويحلّ الوعد بالنوع نفسه الذي يتم إرساله إلى معاودة الاتصال.

setMenuItems()

وعد بذلك

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

تتم إضافة عناصر القائمة المتوفرة إلى قائمة اللغة عندما يكون أداة IME هذه نشطة.

المعلمات

• المَعلَمات

  MenuParameters

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  () => void

المرتجعات

• Promise<void>

  الإصدار 111 من Chrome والإصدارات الأحدث

  تتوفّر الوعود في الإصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال للتوافق مع الأنظمة القديمة. لا يمكنك استخدام كلتيهما في نفس استدعاء الدالة. ويحلّ الوعد بالنوع نفسه الذي يتم إرساله إلى معاودة الاتصال.

updateMenuItems()

وعد بذلك

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

لتعديل حالة عناصر MenuItems المحدّدة

المعلمات

• المَعلَمات

  MenuParameters

• رد الاتصال

  الدالة اختيارية

  تظهر المَعلمة callback على النحو التالي:

  () => void

المرتجعات

• Promise<void>

  الإصدار 111 من Chrome والإصدارات الأحدث

  تتوفّر الوعود في الإصدار Manifest V3 والإصدارات الأحدث، ولكن يتم توفير عمليات معاودة الاتصال للتوافق مع الأنظمة القديمة. لا يمكنك استخدام كلتيهما في نفس استدعاء الدالة. ويحلّ الوعد بالنوع نفسه الذي يتم إرساله إلى معاودة الاتصال.

فعاليات

onActivate

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

يتم إرسال هذا الحدث عند تفعيل أداة IME. ويشير إلى أنّ أداة IME سيتلقّى أحداث onKeyPress.

المعلمات

• رد الاتصال

  الوظيفة

  تظهر المَعلمة callback على النحو التالي:

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

  • engineID

    سلسلة

  • رصد

    ScreenType

onAssistiveWindowButtonClicked

الإصدار 85 من Chrome والإصدارات الأحدث

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

يتم إرسال هذا الحدث عند النقر على زر في نافذة مساعدة.

المعلمات

• رد الاتصال

  الوظيفة

  تظهر المَعلمة callback على النحو التالي:

  (details: object) => void

  • التفاصيل

    عنصر

    • buttonID

      AssistiveWindowButton

      رقم تعريف الزر الذي تم النقر عليه.

    • windowType

      AssistiveWindowType

      نوع النافذة المساعِدة

onBlur

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

يتم إرسال هذا الحدث عندما يترك التركيز مربع نص. ويتم إرسالها إلى جميع الإضافات التي تستمع إلى هذا الحدث، ويفعّلها المستخدم.

المعلمات

• رد الاتصال

  الوظيفة

  تظهر المَعلمة callback على النحو التالي:

  (contextID: number) => void

  • contextID

    الرقم

onCandidateClicked

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

يتم إرسال هذا الحدث إذا كانت هذه الإضافة تمتلك أداة IME النشطة.

المعلمات

• رد الاتصال

  الوظيفة

  تظهر المَعلمة callback على النحو التالي:

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

  • engineID

    سلسلة

  • candidateID

    الرقم

  • زر

    MouseButton

onDeactivated

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

يتم إرسال هذا الحدث عند إيقاف أداة IME. ويشير إلى أنّ أداة IME لن تتلقّى أحداث onKeyPress بعد الآن.

المعلمات

• رد الاتصال

  الوظيفة

  تظهر المَعلمة callback على النحو التالي:

  (engineID: string) => void

  • engineID

    سلسلة

onFocus

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

يتم إرسال هذا الحدث عندما يدخل التركيز في مربّع نص. ويتم إرسالها إلى جميع الإضافات التي تستمع إلى هذا الحدث، ويفعّلها المستخدم.

المعلمات

• رد الاتصال

  الوظيفة

  تظهر المَعلمة callback على النحو التالي:

  (context: InputContext) => void

  • سياق

    InputContext

onInputContextUpdate

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

يتم إرسال هذا الحدث عندما تتغير خصائص enterContext الحالي، مثل النوع. ويتم إرسالها إلى جميع الإضافات التي تستمع إلى هذا الحدث، ويفعّلها المستخدم.

المعلمات

• رد الاتصال

  الوظيفة

  تظهر المَعلمة callback على النحو التالي:

  (context: InputContext) => void

  • سياق

    InputContext

onKeyEvent

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

يتم الإطلاق عند إرسال حدث رئيسي من نظام التشغيل. سيتم إرسال الحدث إلى الإضافة إذا كانت هذه الإضافة تمتلك أداة IME النشطة. يجب أن تعرض دالة المستمع القيمة "صواب" إذا تم التعامل مع الحدث على أنه "خطأ" إذا لم يكن كذلك. في حال تقييم الحدث بشكل غير متزامن، يجب أن تعرض هذه الدالة قيمة غير محدّدة وأن يستدعي أداة IME لاحقًا keyEventHandled() مع النتيجة.

المعلمات

• رد الاتصال

  الوظيفة

  تظهر المَعلمة callback على النحو التالي:

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

  • engineID

    سلسلة

  • keyData

    KeyboardEvent

  • requestId

    سلسلة

  • returns

    منطقية | غير محدّدة

onMenuItemActivated

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

يتم الاتصال عندما يختار المستخدم صنفًا في القائمة.

المعلمات

• رد الاتصال

  الوظيفة

  تظهر المَعلمة callback على النحو التالي:

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

  • engineID

    سلسلة

  • الاسم

    سلسلة

onReset

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

يتم إرسال هذا الحدث عندما ينهي Chrome جلسة إدخال النص الجارية.

المعلمات

• رد الاتصال

  الوظيفة

  تظهر المَعلمة callback على النحو التالي:

  (engineID: string) => void

  • engineID

    سلسلة

onSurroundingTextChanged

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

يتم استدعاء هذا الإجراء عند تغيير السلسلة القابلة للتعديل حول علامة الإقحام أو عند نقل موضع علامة الإقحام. الحد الأقصى لعدد الأحرف المسموح به هو 100 حرف لكل اتجاه.

المعلمات

• رد الاتصال

  الوظيفة

  تظهر المَعلمة callback على النحو التالي:

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

  • engineID

    سلسلة

  • surroundingInfo

    عنصر

    • علامة ارتساء

      الرقم

      موضع بداية التحديد. وتشير هذه القيمة إلى موضع علامة الإقحام إذا لم يكن هناك تحديد.

    • البؤرة

      الرقم

      موضع النهاية للتحديد. وتشير هذه القيمة إلى موضع علامة الإقحام إذا لم يكن هناك تحديد.

    • اقتطاع

      الرقم

      الإصدار 46 من Chrome والإصدارات الأحدث

      موضع الإزاحة text بما أنّ text لا تتضمن سوى مجموعة فرعية من النص حول المؤشر، تشير الإزاحة إلى الموضع المطلق للحرف الأول في text.

    • text

      سلسلة

      النص حول المؤشر. هذه ليست سوى مجموعة فرعية من كل النص في حقل الإدخال.