chrome.input.ime

ब्यौरा

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

अनुमतियां

input

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

{
  "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 और इसके बाद के वर्शन

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

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

    नंबर

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

  • shouldDoLearning

    boolean

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

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

  • spellCheck

    boolean

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

  • टाइप

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

InputContextType

Chrome 44 और इसके बाद के वर्शन

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

Enum

"tel"

"null"

KeyboardEvent

http://www.w3.org/TR/DOM-Level-3-Events/#events-इसके-कीबोर्ड इवेंट देखें

प्रॉपर्टी

  • altKey

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

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

  • altgrKey

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

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

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

  • capsLock

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

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

  • कोड

    स्ट्रिंग

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

  • ctrlKey

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

    Ctrl बटन दबाया गया है या नहीं.

  • extensionId

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

    इस कीइवेंट को भेजने वाले का एक्सटेंशन आईडी.

  • बटन

    स्ट्रिंग

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

  • keyCode

    नंबर ज़रूरी नहीं

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

  • requestId

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

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

  • shiftKey

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

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

  • टाइप

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

KeyboardEventType

Chrome 44 और इसके बाद के वर्शन

Enum

MenuItem

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

प्रॉपर्टी

  • चुना गया

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

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

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

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

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

  • id

    स्ट्रिंग

    वह स्ट्रिंग जिसे इस मेन्यू आइटम का रेफ़रंस देने वाले कॉलबैक को पास किया जाएगा.

  • लेबल

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

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

  • शैलीकृत करें

    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

      स्ट्रिंग

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

    • लंबाई

      नंबर

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

    • ऑफ़सेट

      नंबर

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

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं

    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 का मालिकाना हक नहीं है, तो यह काम नहीं करता

पैरामीटर

  • पैरामीटर

    ऑब्जेक्ट

    • उम्मीदवार

      ऑब्जेक्ट[]

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

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

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

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

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

        स्ट्रिंग

        उम्मीदवार

      • id

        नंबर

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

      • लेबल

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

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

      • 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

      नंबर

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

    • कर्सर

      नंबर

      कर्सर के टेक्स्ट में जगह.

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

      Object[] ज़रूरी नहीं

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

      • खत्म करें

        नंबर

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

      • शुरू करें

        नंबर

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

      • शैलीकृत करें

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

    • 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 को Key Press इवेंट से इवेंट मिलेंगे.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

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

    • engineID

      स्ट्रिंग

    • स्क्रीन

onAssistiveWindowButtonClicked

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

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

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (details: object)=>void

    • विवरण

      ऑब्जेक्ट

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

      नंबर

    • बटन

onDeactivated

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

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

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (engineID: string)=>void

    • engineID

      स्ट्रिंग

onFocus

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

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

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (context: InputContext)=>void

onInputContextUpdate

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

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

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

    (context: InputContext)=>void

onKeyEvent

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

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

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

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

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

    • engineID

      स्ट्रिंग

    • keyData
    • 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

      ऑब्जेक्ट

      • एंकर

        नंबर

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

      • focus

        नंबर

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

      • ऑफ़सेट

        नंबर

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

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

      • टेक्स्ट

        स्ट्रिंग

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