chrome.input.ime

अहम जानकारी: यह एपीआई सिर्फ़ ChromeOS पर काम करता है.

ब्यौरा

Chrome OS के लिए, पसंद के मुताबिक IME लागू करने के लिए, chrome.input.ime एपीआई का इस्तेमाल करें. यह आपके एक्सटेंशन को कीस्ट्रोक हैंडल करने, कंपोज़िशन सेट करने, और कैंडिडेट विंडो को मैनेज करने की अनुमति देता है.

अनुमतियां

input

आपको "इनपुट" का एलान करना होगा एक्सटेंशन मेनिफ़ेस्ट में अनुमति होनी चाहिए. इसके लिए उदाहरण:

{
  "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

Chrome 85+

सहायक विंडो में बटन का आईडी.

Enum

"पहले जैसा करें"

"addToDictionary"

AssistiveWindowProperties

Chrome 85+

सहायक विंडो के प्रॉपर्टी.

प्रॉपर्टी

• announceString

  स्ट्रिंग ज़रूरी नहीं

  घोषणा करने के लिए ChromeVox के लिए स्ट्रिंग.

• टाइप

  "पहले जैसा करें"
  

• दिख रहा है

  बूलियन

  AssistiveWindow को दिखाने के लिए, 'सही' को सेट करता है. साथ ही, 'गलत' को छिपाने के लिए सेट करता है.

AssistiveWindowType

Chrome 85+

सहायक विंडो का टाइप.

मान

"पहले जैसा करें"

AutoCapitalizeType

Chrome 69 और उसके बाद के वर्शन

टेक्स्ट फ़ील्ड का अपने-आप कैपिटल लेटर का टाइप.

Enum

"वर्ण"

"शब्द"

"वाक्य"

InputContext

इनपुट कॉन्टेक्स्ट के बारे में बताता है

प्रॉपर्टी

• autoCapitalize

  AutoCapitalizeType

  Chrome 69 और उसके बाद के वर्शन

  टेक्स्ट फ़ील्ड का अपने-आप कैपिटल लेटर का टाइप.

• autoComplete

  बूलियन

  टेक्स्ट फ़ील्ड में अपने-आप पूरा होने की सुविधा चाहिए या नहीं.

• autoCorrect

  बूलियन

  टेक्स्ट फ़ील्ड में ऑटो करेक्ट की सुविधा चाहिए या नहीं.

• contextID

  संख्या

  इसका इस्तेमाल टेक्स्ट फ़ील्ड से जुड़ी कार्रवाइयों के टारगेट तय करने के लिए किया जाता है. ऑनब्लर को कॉल करते ही यह आईडी अमान्य हो जाता है.

• shouldDoLearning

  बूलियन

  Chrome 68 और उसके बाद के वर्शन

  क्या टेक्स्ट फ़ील्ड में डाले गए टेक्स्ट का इस्तेमाल, टाइप करने के सुझावों को बेहतर बनाने के लिए किया जाना चाहिए.

• spellCheck

  बूलियन

  टेक्स्ट फ़ील्ड में स्पेल चेक की सुविधा है या नहीं.

• टाइप

  InputContextType

  इस टेक्स्ट फ़ील्ड में किए गए बदलावों के मान का प्रकार (टेक्स्ट, संख्या, यूआरएल वगैरह)

InputContextType

Chrome 44 और उसके बाद वाले वर्शन के लिए

इस टेक्स्ट फ़ील्ड में किए गए बदलावों के मान का प्रकार (टेक्स्ट, संख्या, यूआरएल वगैरह)

Enum

"text"

"खोज"

"tel"

"url"

"ईमेल"

"नंबर"

"password"

"शून्य"

KeyboardEvent

http://www.w3.org/TR/DOM-Level-3-Events/#events-keyboardEvent देखें

प्रॉपर्टी

• altKey

  बूलियन ज़रूरी नहीं

  ALT बटन को दबाया जाता है या नहीं.

• altgrKey

  बूलियन ज़रूरी नहीं

  Chrome 79 और उसके बाद के वर्शन

  ALTGR बटन दबाया गया या नहीं.

• capsLock

  बूलियन ज़रूरी नहीं

  CAPS_LOCK सक्षम है या नहीं.

• कोड

  स्ट्रिंग

  दबाए जा रहे फ़िज़िकल बटन की वैल्यू. वैल्यू पर, कीबोर्ड के मौजूदा लेआउट या कार्रवाई बदलने वाली स्थिति का कोई असर नहीं पड़ता है.

• ctrlKey

  बूलियन ज़रूरी नहीं

  CTRL कुंजी दबाई गई है या नहीं.

• extensionId

  स्ट्रिंग ज़रूरी नहीं

  इस मुख्य इवेंट को भेजने वाले व्यक्ति का एक्सटेंशन आईडी.

• बटन

  स्ट्रिंग

  दबाई जा रही कुंजी का मान

• keyCode

  नंबर वैकल्पिक

  अब काम नहीं करने वाला HTML keyCode, जो सिस्टम और लागू करने पर निर्भर संख्यात्मक कोड है. यह कोड दबाए गए बटन से जुड़ा बिना बदलाव वाला आइडेंटिफ़ायर होता है.

• requestId

  स्ट्रिंग ज़रूरी नहीं

  (अब काम नहीं करता) अनुरोध का आईडी. इसके बजाय, onKeyEvent इवेंट से requestId पैरामीटर का इस्तेमाल करें.

• shiftKey

  बूलियन ज़रूरी नहीं

  SHIFT बटन दबाया जाता है या नहीं.

• टाइप

  KeyboardEventType

  कीअप या कीडाउन में से कोई एक.

KeyboardEventType

Chrome 44 और उसके बाद वाले वर्शन के लिए

Enum

"कीअप"

"कीडाउन"

MenuItem

भाषा के मेन्यू में जाकर, उपयोगकर्ता से इंटरैक्ट करने के लिए इस्तेमाल किया जाने वाला मेन्यू आइटम. इसका इस्तेमाल इनपुट के तरीके से किया जाता है.

प्रॉपर्टी

• सही का निशान लगाया गया

  बूलियन ज़रूरी नहीं

  इससे पता चलता है कि इस आइटम को चेक से बनाया जाना चाहिए.

• चालू किया गया

  बूलियन ज़रूरी नहीं

  इससे पता चलता है कि इस आइटम को चालू कर दिया गया है.

• आईडी

  स्ट्रिंग

  स्ट्रिंग, जिसे इस मेन्यू आइटम से जुड़े कॉलबैक को भेजा जाएगा.

• लेबल

  स्ट्रिंग ज़रूरी नहीं

  इस आइटम के मेन्यू में दिखाया गया टेक्स्ट.

• शैली

  MenuItemStyle ज़रूरी नहीं

  मेन्यू आइटम का टाइप.

• दिख रहा है

  बूलियन ज़रूरी नहीं

  इससे पता चलता है कि यह आइटम दिख रहा है.

MenuItemStyle

Chrome 44 और उसके बाद वाले वर्शन के लिए

मेन्यू आइटम का टाइप. सेपरेटर के बीच मौजूद रेडियो बटन को ग्रुप माना जाता है.

Enum

"जांचें"

"रेडियो"

"विभाजक"

MenuParameters

Chrome 88 और उसके बाद के वर्शन

प्रॉपर्टी

• engineID

  स्ट्रिंग

  इस्तेमाल करने के लिए इंजन का आईडी.

• आइटम

  MenuItem[]

  जोड़ने या अपडेट करने के लिए मेन्यू आइटम. उन्हें उसी क्रम में जोड़ा जाएगा जिस क्रम में वे कलेक्शन में मौजूद हैं.

MouseButton

Chrome 44 और उसके बाद वाले वर्शन के लिए

माउस के किन बटन पर क्लिक किया गया.

Enum

"बाएं"

"बीच में"

"राइट"

ScreenType

Chrome 44 और उसके बाद वाले वर्शन के लिए

वह स्क्रीन टाइप जिसके तहत IME चालू है.

Enum

"सामान्य"

"लॉगिन"

"लॉक"

"सेकंडरी-लॉगिन"

UnderlineStyle

Chrome 44 और उसके बाद वाले वर्शन के लिए

इस सेगमेंट में बदलाव करने के लिए अंडरलाइन का टाइप.

Enum

"अंडरलाइन"

" Doubleअंडरलाइन"

"noअंडरलाइन"

WindowPosition

Chrome 44 और उसके बाद वाले वर्शन के लिए

उम्मीदवार की विंडो कहां दिखानी है. अगर 'कर्सर' पर सेट है, तो विंडो कर्सर के बाद में होती है. अगर इसे 'कंपोज़िशन' पर सेट किया जाता है, तो विंडो को कंपोज़िशन की शुरुआत में लॉक कर दिया जाता है.

Enum

"कर्सर"

"कंपोज़िशन"

तरीके

clearComposition()

प्रॉमिस

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

मौजूदा कंपोज़िशन हटाएं. अगर इस एक्सटेंशन के पास चालू IME का मालिकाना हक नहीं है, तो यह कार्रवाई नहीं की जा सकती.

पैरामीटर

• पैरामीटर

  ऑब्जेक्ट

  • contextID

    संख्या

    उस संदर्भ का आईडी जहां कंपोज़िशन को मिटाया जाएगा

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  (success: boolean) => void

  • सफलता

    बूलियन

रिटर्न

• Promise<boolean>

  Chrome 111 और उसके बाद वाले वर्शन के लिए

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

commitText()

प्रॉमिस

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

दिए गए टेक्स्ट को मौजूदा इनपुट में शामिल करता है.

पैरामीटर

• पैरामीटर

  ऑब्जेक्ट

  • contextID

    संख्या

    उस कॉन्टेक्स्ट का आईडी जहां टेक्स्ट लिखा जाएगा

  • टेक्स्ट

    स्ट्रिंग

    कमिट किए जाने वाले टेक्स्ट

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  (success: boolean) => void

  • सफलता

    बूलियन

रिटर्न

• Promise<boolean>

  Chrome 111 और उसके बाद वाले वर्शन

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

deleteSurroundingText()

प्रॉमिस

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

कैरेट के आस-पास के टेक्स्ट को मिटाता है.

पैरामीटर

• पैरामीटर

  ऑब्जेक्ट

  • contextID

    संख्या

    उस कॉन्टेक्स्ट का आईडी जहां आस-पास का टेक्स्ट मिटाया जाएगा.

  • engineID

    स्ट्रिंग

    इवेंट पाने वाले इंजन का आईडी.

  • लंबाई

    संख्या

    मिटाए जाने वाले वर्णों की संख्या

  • ऑफ़सेट

    संख्या

    कैरेट स्थिति से ऑफ़सेट, जहां से हटाना शुरू होगा. यह वैल्यू नेगेटिव हो सकती है.

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  () => void

रिटर्न

• प्रॉमिस<void>

  Chrome 111 और उसके बाद वाले वर्शन के लिए

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

hideInputView()

chrome.input.ime.hideInputView()

इनपुट व्यू विंडो छिपा देता है, जो सिस्टम में अपने-आप पॉप-अप होती है. अगर इनपुट व्यू विंडो पहले से ही छिपी हुई है, तो यह फ़ंक्शन कुछ नहीं करेगा.

keyEventHandled()

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

इससे पता चलता है कि onKeyEvent से मिले मुख्य इवेंट को मैनेज किया जाता है. इसे सिर्फ़ तब कॉल किया जाना चाहिए, जब onKeyEvent लिसनर एसिंक्रोनस हो.

पैरामीटर

• requestId

  स्ट्रिंग

  हैंडल किए गए इवेंट के लिए अनुरोध का आईडी. यह keyEvent.requestId से होना चाहिए

• जवाब

  बूलियन

  अगर कीस्ट्रोक को हैंडल किया जाता है, तो वैल्यू सही होती है. अगर ऐसा नहीं होता है, तो गलत होता है

sendKeyEvents()

प्रॉमिस

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

मुख्य इवेंट भेजता है. वर्चुअल कीबोर्ड के लिए इस फ़ंक्शन के इस्तेमाल की उम्मीद है. जब कोई उपयोगकर्ता किसी वर्चुअल कीबोर्ड पर मौजूद कुंजी(कुंजियों) को दबाता है, तो इस फ़ंक्शन का इस्तेमाल उस इवेंट को सिस्टम में लागू करने के लिए किया जाता है.

पैरामीटर

• पैरामीटर

  ऑब्जेक्ट

  • contextID

    संख्या

    उस कॉन्टेक्स्ट का आईडी जहां मुख्य इवेंट भेजे जाएंगे या मुख्य इवेंट को नॉन-इनपुट फ़ील्ड में भेजने के लिए शून्य होना चाहिए.

  • keyData

    KeyboardEvent[]

    मुख्य इवेंट का डेटा.

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  () => void

रिटर्न

• प्रॉमिस<void>

  Chrome 111 और उसके बाद वाले वर्शन

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

setAssistiveWindowButtonHighlighted()

प्रॉमिस Chrome 86 और उसके बाद वाले वर्शन के लिए

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

सहायक विंडो में किसी बटन को हाइलाइट/अनहाइलाइट करता है.

पैरामीटर

• पैरामीटर

  ऑब्जेक्ट

  • announceString

    स्ट्रिंग ज़रूरी नहीं

    स्क्रीन रीडर के लिए जानकारी, जिसके बारे में एलान करना है.

  • buttonID

    AssistiveWindowButton

    बटन का आईडी

  • contextID

    संख्या

    सहायक विंडो के मालिकाना हक वाले कॉन्टेक्स्ट का आईडी.

  • हाइलाइट की गई

    बूलियन

    बटन को हाइलाइट किया जाना चाहिए या नहीं.

  • windowType

    "पहले जैसा करें"
    

    उस विंडो का टाइप जिससे बटन जुड़ा है.

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  () => void

रिटर्न

• प्रॉमिस<void>

  Chrome 111 और उसके बाद वाले वर्शन के लिए

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

setAssistiveWindowProperties()

प्रॉमिस Chrome 85 और उसके बाद वाले वर्शन के लिए

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

दी गई प्रॉपर्टी के साथ सहायक विंडो को दिखाता है/छिपाता है.

पैरामीटर

• पैरामीटर

  ऑब्जेक्ट

  • contextID

    संख्या

    सहायक विंडो के मालिकाना हक वाले कॉन्टेक्स्ट का आईडी.

  • प्रॉपर्टी

    AssistiveWindowProperties

    सहायक विंडो के प्रॉपर्टी.

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  (success: boolean) => void

  • सफलता

    बूलियन

रिटर्न

• Promise&lt;boolean&gt;

  Chrome 111 और उसके बाद वाले वर्शन के लिए

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

setCandidates()

प्रॉमिस

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

उम्मीदवार की मौजूदा सूची सेट करता है. अगर इस एक्सटेंशन के पास चालू IME का मालिकाना हक नहीं है, तो यह कार्रवाई नहीं की जा सकेगी

पैरामीटर

• पैरामीटर

  ऑब्जेक्ट

  • उम्मीदवार

    object[]

    उम्मीदवार की विंडो में दिखाने के लिए उम्मीदवारों की सूची

    • मेटा जानकारी

      स्ट्रिंग ज़रूरी नहीं

      उम्मीदवार के बारे में बताने वाला अतिरिक्त टेक्स्ट

    • उपयुक्त कीवर्ड/टारगेटिंग सेटिंग

      स्ट्रिंग

      उम्मीदवार

    • आईडी

      संख्या

      उम्मीदवार का आईडी

    • लेबल

      स्ट्रिंग ज़रूरी नहीं

      उम्मीदवार के नाम के बगल में दिखने वाली छोटी स्ट्रिंग. अक्सर, शॉर्टकट बटन या इंडेक्स

    • parentId

      नंबर वैकल्पिक

      इन उम्मीदवारों को जोड़ने के लिए आईडी

    • इस्तेमाल

      ऑब्जेक्ट ज़रूरी नहीं

      शब्द का इस्तेमाल या उसके बारे में पूरी जानकारी.

      • शरीर

        स्ट्रिंग

        ब्यौरे के ब्यौरे की बॉडी स्ट्रिंग.

      • title

        स्ट्रिंग

        ब्यौरे की टाइटल स्ट्रिंग.

  • contextID

    संख्या

    उस कॉन्टेक्स्ट का आईडी जिसके पास कैंडिडेट विंडो का मालिकाना हक है.

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  (success: boolean) => void

  • सफलता

    बूलियन

रिटर्न

• Promise&lt;boolean&gt;

  Chrome 111 और उसके बाद वाले वर्शन के लिए

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

setCandidateWindowProperties()

प्रॉमिस

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

उम्मीदवार विंडो की प्रॉपर्टी सेट करता है. एक्सटेंशन के पास चालू IME का मालिकाना हक न होने पर, यह कार्रवाई नहीं की जा सकती

पैरामीटर

• पैरामीटर

  ऑब्जेक्ट

  • engineID

    स्ट्रिंग

    प्रॉपर्टी को सेट करने के लिए इंजन का आईडी.

  • प्रॉपर्टी

    ऑब्जेक्ट

    • auxiliaryText

      स्ट्रिंग ज़रूरी नहीं

      उम्मीदवार की विंडो के सबसे नीचे दिखाया जाने वाला टेक्स्ट.

    • auxiliaryTextVisible

      बूलियन ज़रूरी नहीं

      सहायक टेक्स्ट दिखाने के लिए 'सही', लेकिन छिपाने के लिए 'गलत'.

    • currentCandidateIndex

      नंबर वैकल्पिक

      Chrome 84 और उसके बाद के वर्शन

      कुल उम्मीदवारों में से, चुने गए मौजूदा उम्मीदवार का इंडेक्स.

    • cursorVisible

      बूलियन ज़रूरी नहीं

      कर्सर को दिखाने के लिए सही, इसे छिपाने के लिए गलत.

    • pageSize

      नंबर वैकल्पिक

      हर पेज पर दिखाए जाने वाले उम्मीदवारों की संख्या.

    • totalCandidates

      नंबर वैकल्पिक

      Chrome 84 और उसके बाद के वर्शन

      उम्मीदवार की विंडो के लिए उम्मीदवारों की कुल संख्या.

    • वर्टिकल

      बूलियन ज़रूरी नहीं

      सही है अगर उम्मीदवार विंडो को वर्टिकल रेंडर किया जाना है, तो इसे हॉरिज़ॉन्टल बनाने के लिए गलत.

    • दिख रहा है

      बूलियन ज़रूरी नहीं

      उम्मीदवार विंडो को दिखाने के लिए सही है, उसे छिपाने के लिए गलत है.

    • windowPosition

      WindowPosition वैकल्पिक

      उम्मीदवार की विंडो कहां दिखानी है.

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  (success: boolean) => void

  • सफलता

    बूलियन

रिटर्न

• Promise&lt;boolean&gt;

  Chrome 111 और उसके बाद वाले वर्शन के लिए

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

setComposition()

प्रॉमिस

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

मौजूदा कंपोज़िशन सेट करें. अगर इस एक्सटेंशन के पास चालू IME का मालिकाना हक नहीं है, तो यह कार्रवाई नहीं की जा सकती.

पैरामीटर

• पैरामीटर

  ऑब्जेक्ट

  • contextID

    संख्या

    उस कॉन्टेक्स्ट का आईडी जहां कंपोज़िशन टेक्स्ट को सेट किया जाएगा

  • कर्सर

    संख्या

    कर्सर के टेक्स्ट की जगह.

  • मिलते-जुलते सेगमेंट

    ऑब्जेक्ट[] ज़रूरी नहीं

    सेगमेंट और उनसे जुड़े टाइप की सूची.

    • खत्म करें

      संख्या

      उस वर्ण का इंडेक्स जिसके बाद इस सेगमेंट को खत्म करना है.

    • शुरू करें

      संख्या

      उस वर्ण का इंडेक्स जिस पर यह सेगमेंट शुरू करना है

    • शैली

      UnderlineStyle

      इस सेगमेंट में बदलाव करने के लिए अंडरलाइन का टाइप.

  • selectionEnd

    नंबर वैकल्पिक

    उस टेक्स्ट की जगह जहां चुनाव खत्म होता है.

  • selectionStart

    नंबर वैकल्पिक

    टेक्स्ट में वह जगह जहां से चुनाव शुरू होता है.

  • टेक्स्ट

    स्ट्रिंग

    सेट किया जाने वाला टेक्स्ट

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  (success: boolean) => void

  • सफलता

    बूलियन

रिटर्न

• Promise&lt;boolean&gt;

  Chrome 111 और उसके बाद वाले वर्शन के लिए

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

setCursorPosition()

प्रॉमिस

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

उम्मीदवार विंडो में कर्सर की स्थिति सेट करें. अगर यह एक्सटेंशन सक्रिय IME का स्वामी नहीं है, तो यह एक नो-ऑप होगा.

पैरामीटर

• पैरामीटर

  ऑब्जेक्ट

  • candidateID

    संख्या

    उम्मीदवार का आईडी, जिसे चुनना है.

  • contextID

    संख्या

    उस कॉन्टेक्स्ट का आईडी जिसके पास कैंडिडेट विंडो का मालिकाना हक है.

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  (success: boolean) => void

  • सफलता

    बूलियन

रिटर्न

• Promise&lt;boolean&gt;

  Chrome 111 और उसके बाद वाले वर्शन के लिए

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

setMenuItems()

प्रॉमिस

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

इस IME के चालू होने पर, भाषा मेन्यू में दिए गए मेन्यू आइटम जोड़ता है.

पैरामीटर

• पैरामीटर

  MenuParameters

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  () => void

रिटर्न

• प्रॉमिस<void>

  Chrome 111 और उसके बाद वाले वर्शन

  मेनिफ़ेस्ट V3 और उसके बाद के वर्शन में प्रॉमिस काम करते हैं. हालांकि, कॉलबैक की सुविधा इन मामलों में दी जाती है पुराने सिस्टम के साथ काम करने की सुविधा. एक ही फ़ंक्शन कॉल में दोनों का इस्तेमाल नहीं किया जा सकता. कॉन्टेंट बनाने प्रॉमिस उसी टाइप के साथ ठीक होता है जिसे कॉलबैक में पास किया जाता है.

updateMenuItems()

प्रॉमिस

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

तय किए गए मेन्यू आइटम की स्थिति अपडेट करता है

पैरामीटर

• पैरामीटर

  MenuParameters

• कॉलबैक

  फ़ंक्शन वैकल्पिक

  callback पैरामीटर ऐसा दिखता है:

  () => void

रिटर्न

• प्रॉमिस<void>

  Chrome 111 और उसके बाद वाले वर्शन के लिए

  मेनिफ़ेस्ट 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,
)

यह इवेंट तब भेजा जाता है, जब मौजूदा InputContext की प्रॉपर्टी बदल जाती हैं, जैसे कि टाइप. यह उन सभी एक्सटेंशन को भेजा जाता है जो इस इवेंट को सुन रहे हैं और उपयोगकर्ता ने चालू किए हैं.

पैरामीटर

• कॉलबैक

  फ़ंक्शन

  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 | तय नहीं है

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 के पहले वर्ण की पूरी पोज़िशन पता चलती है.

    • टेक्स्ट

      स्ट्रिंग

      कर्सर के आस-पास का टेक्स्ट. यह इनपुट फ़ील्ड में मौजूद सभी टेक्स्ट का सिर्फ़ एक सबसेट है.