chrome.input.ime

जानकारी

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

अनुमतियां

input

Input.ime API का इस्तेमाल करने के लिए, आपको एक्सटेंशन मेनिफ़ेस्ट में "इनपुट" अनुमति का एलान करना होगा. जैसे:

{
  "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 के लिए स्ट्रिंग.

  • टाइप

  • दिख रहा है

    boolean

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

AssistiveWindowType

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

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

वैल्यू

AutoCapitalizeType

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

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

Enum

InputContext

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

प्रॉपर्टी

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

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

  • autoComplete

    boolean

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

  • autoCorrect

    boolean

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

  • contextID

    नंबर

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

  • shouldDoLearning

    boolean

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

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

  • spellCheck

    boolean

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

  • टाइप

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

InputContextType

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

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

Enum

"text"

"tel"

"url"

"password"

"null"

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

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

Enum

MenuItem

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

प्रॉपर्टी

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

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

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

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

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

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

  • आईडी

    स्ट्रिंग

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

  • लेबल

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

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

  • स्टाइल

    MenuItemStyle ज़रूरी नहीं

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

  • दिख रहा है

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

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

MenuItemStyle

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

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

Enum

MenuParameters

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

प्रॉपर्टी

  • engineID

    स्ट्रिंग

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

  • items

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

MouseButton

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

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

Enum

ScreenType

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

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

Enum

UnderlineStyle

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

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

Enum

WindowPosition

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

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

Enum

तरीके

clearComposition()

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

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

पैरामीटर

  • पैरामीटर

    ऑब्जेक्ट

    • contextID

      नंबर

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

  • कॉलबैक

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

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

    (success: boolean) => void

    • सफलता

      boolean

सामान लौटाना

  • Promise<boolean>

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

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

commitText()

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

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

पैरामीटर

  • पैरामीटर

    ऑब्जेक्ट

    • contextID

      नंबर

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

    • टेक्स्ट

      स्ट्रिंग

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

  • कॉलबैक

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

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

    (success: boolean) => void

    • सफलता

      boolean

सामान लौटाना

  • Promise<boolean>

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

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

deleteSurroundingText()

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

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

पैरामीटर

  • पैरामीटर

    ऑब्जेक्ट

    • contextID

      नंबर

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

    • engineID

      स्ट्रिंग

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

    • length

      नंबर

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

    • ऑफ़सेट

      नंबर

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

  • कॉलबैक

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

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

    () => void

सामान लौटाना

  • Promise<void>

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

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

hideInputView()

chrome.input.ime.hideInputView()

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

keyEventHandled()

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

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

पैरामीटर

  • requestId

    स्ट्रिंग

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

  • जवाब

    boolean

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

sendKeyEvents()

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

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

पैरामीटर

  • पैरामीटर

    ऑब्जेक्ट

    • contextID

      नंबर

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

    • keyData

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

  • कॉलबैक

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

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

    () => void

सामान लौटाना

  • Promise<void>

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

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

setAssistiveWindowButtonHighlighted()

वादा Chrome 86+
chrome.input.ime.setAssistiveWindowButtonHighlighted(
  parameters: object,
  callback?: function,
)

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

पैरामीटर

  • पैरामीटर

    ऑब्जेक्ट

    • announceString

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

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

    • बटन का आईडी

    • contextID

      नंबर

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

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

      boolean

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

    • windowType

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

  • कॉलबैक

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

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

    () => void

सामान लौटाना

  • Promise<void>

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

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

setAssistiveWindowProperties()

वादा Chrome 85+
chrome.input.ime.setAssistiveWindowProperties(
  parameters: object,
  callback?: function,
)

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

पैरामीटर

  • पैरामीटर

    ऑब्जेक्ट

    • contextID

      नंबर

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

    • प्रॉपर्टी

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

  • कॉलबैक

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

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

    (success: boolean) => void

    • सफलता

      boolean

सामान लौटाना

  • Promise<boolean>

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

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

setCandidates()

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

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

पैरामीटर

  • पैरामीटर

    ऑब्जेक्ट

    • उम्मीदवार

      ऑब्जेक्ट[]

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

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

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

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

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

        स्ट्रिंग

        उम्मीदवार

      • आईडी

        नंबर

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

      • लेबल

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

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

      • parentId

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

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

      • इस्तेमाल

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

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

        • body

          स्ट्रिंग

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

        • title

          स्ट्रिंग

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

    • contextID

      नंबर

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

  • कॉलबैक

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

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

    (success: boolean) => void

    • सफलता

      boolean

सामान लौटाना

  • Promise<boolean>

    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

    • सफलता

      boolean

सामान लौटाना

  • Promise<boolean>

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

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

setComposition()

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

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

पैरामीटर

  • पैरामीटर

    ऑब्जेक्ट

    • contextID

      नंबर

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

    • कर्सर

      नंबर

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

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

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

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

      • खत्म करें

        नंबर

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

      • शुरू करें

        नंबर

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

      • स्टाइल

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

    • selectionEnd

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

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

    • selectionStart

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

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

    • टेक्स्ट

      स्ट्रिंग

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

  • कॉलबैक

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

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

    (success: boolean) => void

    • सफलता

      boolean

सामान लौटाना

  • Promise<boolean>

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

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

setCursorPosition()

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

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

पैरामीटर

  • पैरामीटर

    ऑब्जेक्ट

    • candidateID

      नंबर

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

    • contextID

      नंबर

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

  • कॉलबैक

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

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

    (success: boolean) => void

    • सफलता

      boolean

सामान लौटाना

  • Promise<boolean>

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

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

setMenuItems()

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

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

पैरामीटर

  • पैरामीटर
  • कॉलबैक

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

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

    () => void

सामान लौटाना

  • Promise<void>

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

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

updateMenuItems()

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

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

पैरामीटर

  • पैरामीटर
  • कॉलबैक

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

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

    () => void

सामान लौटाना

  • Promise<void>

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

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

इवेंट

onActivate

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

यह इवेंट IME के चालू होने पर भेजा जाता है. इससे पता चलता है कि IME को onKeyPress इवेंट मिलेंगे.

पैरामीटर

  • कॉलबैक

    function

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

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

    • engineID

      स्ट्रिंग

    • स्क्रीन

onAssistiveWindowButtonClicked

Chrome 85 और उसके बाद के वर्शन
chrome.input.ime.onAssistiveWindowButtonClicked.addListener(
  callback: function,
)

यह इवेंट तब भेजा जाता है, जब सहायक विंडो में मौजूद किसी बटन पर क्लिक किया जाता है.

पैरामीटर

  • कॉलबैक

    function

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

    (details: object) => void

    • जानकारी

      ऑब्जेक्ट

onBlur

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

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

पैरामीटर

  • कॉलबैक

    function

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

    (contextID: number) => void

    • contextID

      नंबर

onCandidateClicked

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

यह इवेंट तब भेजा जाता है, जब यह एक्सटेंशन चालू IME का मालिक होता है.

पैरामीटर

  • कॉलबैक

    function

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

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

    • engineID

      स्ट्रिंग

    • candidateID

      नंबर

    • बटन

onDeactivated

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

यह इवेंट IME के बंद होने पर भेजा जाता है. इससे पता चलता है कि IME को onKeyPress इवेंट नहीं मिलेंगे.

पैरामीटर

  • कॉलबैक

    function

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

    (engineID: string) => void

    • engineID

      स्ट्रिंग

onFocus

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

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

पैरामीटर

  • कॉलबैक

    function

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

    (context: InputContext) => void

onInputContextUpdate

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

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

पैरामीटर

  • कॉलबैक

    function

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

    (context: InputContext) => void

onKeyEvent

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

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

पैरामीटर

  • कॉलबैक

    function

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

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

    • engineID

      स्ट्रिंग

    • keyData
    • requestId

      स्ट्रिंग

    • returns

      बूलियन | तय नहीं है

onMenuItemActivated

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

तब कॉल किया जाता है, जब उपयोगकर्ता मेन्यू आइटम चुनता है

पैरामीटर

  • कॉलबैक

    function

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

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

    • engineID

      स्ट्रिंग

    • नाम

      स्ट्रिंग

onReset

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

यह इवेंट तब भेजा जाता है, जब Chrome मौजूदा टेक्स्ट इनपुट सेशन को खत्म करता है.

पैरामीटर

  • कॉलबैक

    function

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

    (engineID: string) => void

    • engineID

      स्ट्रिंग

onSurroundingTextChanged

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

यह तब कॉल किया जाता है, जब कैरेट के आस-पास मौजूद बदलाव की जा सकने वाली स्ट्रिंग बदल जाती है या इसकी जगह बदल जाती है. आगे और पीछे की हर दिशा के लिए, टेक्स्ट में ज़्यादा से ज़्यादा 100 वर्ण हो सकते हैं.

पैरामीटर

  • कॉलबैक

    function

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

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

    • engineID

      स्ट्रिंग

    • surroundingInfo

      ऑब्जेक्ट

      • एंकर

        नंबर

        चुने गए हिस्से की शुरुआत की पोज़िशन. कोई विकल्प न चुनने पर, यह वैल्यू कैरेट की पोज़िशन के बारे में बताती है.

      • focus

        नंबर

        चुने गए का आखिरी स्थान. कोई विकल्प न चुनने पर, यह वैल्यू कैरेट की पोज़िशन के बारे में बताती है.

      • ऑफ़सेट

        नंबर

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

        text की ऑफ़सेट स्थिति. text में कर्सर के आस-पास सिर्फ़ टेक्स्ट का एक सबसेट शामिल है. इसलिए, ऑफ़सेट के हिसाब से text के पहले वर्ण की पूरी पोज़िशन पता चलती है.

      • टेक्स्ट

        स्ट्रिंग

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