chrome.input.ime

الوصف

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

الأذونات

input

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

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

أمثلة

ينشئ الرمز التالي أداة 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

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

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

التعداد

"addToDictionary"

AssistiveWindowProperties

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

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

أماكن إقامة

• announceString

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

  سلاسل يجب أن يعلنها ChromeVox

• كتابة

• مرئي

  boolean

  لضبط true لعرض AssistiveWindow، وتعيين false للإخفاء.

AssistiveWindowType

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

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

القيمة

AutoCapitalizeType

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

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

التعداد

InputContext

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

أماكن إقامة

• autoCapitalize

  AutoCapitalizeType

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

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

• autoComplete

  boolean

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

• autoCorrect

  boolean

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

• contextID

  الرقم

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

• shouldDoLearning

  boolean

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

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

• spellCheck

  boolean

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

• كتابة

  InputContextType

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

InputContextType

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

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

التعداد

"text"

"url"

"null"

KeyboardEvent

يمكنك الاطّلاع على http://www.w3.org/TR/DOM-Level-3-events/#events-KeyboardEvent

أماكن إقامة

• altKey

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

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

• altgrKey

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

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

  تحدِّد هذه السمة ما إذا تم الضغط على مفتاح ALTGR أم لا.

• capsLock

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

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

• رمز

  سلسلة

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

• ctrlKey

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

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

• extensionId

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

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

• مفتاح

  سلسلة

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

• keyCode

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

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

• requestId

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

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

• shiftKey

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

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

• كتابة

  KeyboardEventType

  إمّا الضغط على مفتاح أو مفتاح السهم المتّجه للأسفل.

KeyboardEventType

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

التعداد

"keydown"

MenuItem

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

أماكن إقامة

• تم وضع علامة فيه

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

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

• مفعّلة

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

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

• id

  سلسلة

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

• label

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

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

• style

  MenuItemStyle اختيارية

  نوع صنف في القائمة

• مرئي

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

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

MenuItemStyle

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

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

التعداد

MenuParameters

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

أماكن إقامة

• engineID

  سلسلة

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

• عناصر

  MenuItem[]

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

MouseButton

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

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

التعداد

ScreenType

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

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

التعداد

"secondary-login"

UnderlineStyle

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

نوع التسطير لتعديل هذا الجزء

التعداد

WindowPosition

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

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

التعداد

الطُرق

clearComposition()

وعد

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

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

المَعلمات

• المَعلَمات

  كائن

  • contextID

    الرقم

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

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  (success: boolean)=>void

  • نجاح

    boolean

المرتجعات

• Promise<boolean>

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

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

commitText()

وعد

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

لتطبيق النص المقدّم في الإدخال الحالي

المَعلمات

• المَعلَمات

  كائن

  • contextID

    الرقم

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

  • text

    سلسلة

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

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  (success: boolean)=>void

  • نجاح

    boolean

المرتجعات

• Promise<boolean>

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

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

deleteSurroundingText()

وعد

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

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

المَعلمات

• المَعلَمات

  كائن

  • contextID

    الرقم

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

  • engineID

    سلسلة

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

  • length

    الرقم

    عدد الأحرف المطلوب حذفها

  • فرق التوقيت

    الرقم

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

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  ()=>void

المرتجعات

• Promise<void>

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

  تتوفّر الوعود في إصدار 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>

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

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

setAssistiveWindowButtonHighlighted()

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

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

يبرز أو يؤدي إلى إلغاء تمييز زر في نافذة مساعدة.

المَعلمات

• المَعلَمات

  كائن

  • announceString

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

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

  • buttonID

    AssistiveWindowButton

    معرف الزر

  • contextID

    الرقم

    رقم تعريف السياق الذي يحتوي على نافذة المساعدة.

  • بارزة

    boolean

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

  • windowType

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

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  ()=>void

المرتجعات

• Promise<void>

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

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

setAssistiveWindowProperties()

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

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

لإظهار/إخفاء نافذة مساعدة بالسمات المحددة

المَعلمات

• المَعلَمات

  كائن

  • contextID

    الرقم

    رقم تعريف السياق الذي يحتوي على نافذة المساعدة.

  • المواقع

    AssistiveWindowProperties

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

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  (success: boolean)=>void

  • نجاح

    boolean

المرتجعات

• Promise<boolean>

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

  تتوفّر الوعود في إصدار 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>

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

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

setCandidateWindowProperties()

وعد

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

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

المَعلمات

• المَعلَمات

  كائن

  • engineID

    سلسلة

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

  • المواقع

    كائن

    • auxiliaryText

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

      النص الذي يتم عرضه في أسفل نافذة المرشّح.

    • auxiliaryTextVisible

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

      يتم ضبط هذه السمة على "صحيح" لعرض النص الإضافي، وعلى القيمة "false" لإخفائها.

    • currentCandidateIndex

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

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

      تمثّل هذه السمة فهرس المرشح الحالي من إجمالي عدد المرشحين.

    • cursorVisible

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

      انقر على "صحيح" لعرض المؤشر، وعلى "خطأ" لإخفائها.

    • pageSize

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

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

    • totalCandidates

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

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

      تمثّل هذه السمة إجمالي عدد المرشحين للنافذة.

    • فئة

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

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

    • مرئي

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

      انقر على "صحيح" لعرض نافذة "المرشح"، وعلى الخيار "خطأ" لإخفائها.

    • windowPosition

      WindowPosition اختياري

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

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  (success: boolean)=>void

  • نجاح

    boolean

المرتجعات

• Promise<boolean>

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

  تتوفّر الوعود في إصدار 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>

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

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

setCursorPosition()

وعد

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

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

المَعلمات

• المَعلَمات

  كائن

  • candidateID

    الرقم

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

  • contextID

    الرقم

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

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  (success: boolean)=>void

  • نجاح

    boolean

المرتجعات

• Promise<boolean>

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

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

setMenuItems()

وعد

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

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

المَعلمات

• المَعلَمات

  MenuParameters

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  ()=>void

المرتجعات

• Promise<void>

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

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

updateMenuItems()

وعد

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

تعمل هذه السياسة على تعديل حالة عناصر MenuItems المحدّدة.

المَعلمات

• المَعلَمات

  MenuParameters

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  ()=>void

المرتجعات

• Promise<void>

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

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

فعاليات

onActivate

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

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

المَعلمات

• معاودة الاتصال

  الوظيفة

  تبدو معلَمة callback على النحو التالي:

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

  • engineID

    سلسلة

  • رصد

    ScreenType

onAssistiveWindowButtonClicked

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

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

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

المَعلمات

• معاودة الاتصال

  الوظيفة

  تبدو معلَمة 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

    boolean|undefined

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

    كائن

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

      الرقم

      تمثّل هذه السمة موضع بداية الاختيار. تشير هذه القيمة إلى موضع علامة الإقحام في حال عدم تحديد قيمة.

    • البؤرة

      الرقم

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

    • فرق التوقيت

      الرقم

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

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

    • text

      سلسلة

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