ट्रांसलिट्रेट एपीआई रेफ़रंस

आसान ट्रांसलिट्रेशन

नीचे दिए गए तरीके से JavaScript का इस्तेमाल करके, यूज़र इंटरफ़ेस (यूआई) के बिना आसान ट्रांसलिट्रेशन किया जा सकता है.

तरीका ब्यौरा

google.language.transliterate(wordsArray, srcLang, destLang, callback)

google.language.transliterate(wordsArray, srcLang, destLang, callback) दुनिया भर में इस्तेमाल किया जाने वाला ऐसा तरीका है जिससे सोर्स टेक्स्ट की डेस्टिनेशन भाषा में ट्रांसलिट्रेट किया जाता है. एपीआई, result ऑब्जेक्ट के तौर पर दिए गए callback फ़ंक्शन को एसिंक्रोनस तरीके से नतीजे देता है. इस तरीके के लिए पैरामीटर:

  • wordsArray टेक्स्ट को एक कैटगरी के तौर पर ट्रांसलिट्रेट करने की सुविधा देता है.
  • srcLang, सोर्स भाषा को भाषा कोड के तौर पर दिखाता है. उदाहरण के लिए, LanguageCode enum देखें.
  • destLang में, भाषा का कोड, डेस्टिनेशन भाषा के तौर पर सेट होता है. उदाहरण के लिए, LanguageCode enum देखें.
  • callback, कॉलबैक फ़ंक्शन है जिसे result मिलता है.

google.language.transliterate() के लिए, सामान लौटाने की कोई वैल्यू मौजूद नहीं है.

ट्रांसलिट्रेशन के लिए इस आसान तरीके में google.language.transliterate नेमस्पेस का इस्तेमाल होता है (न कि google.elements.transliteration का, जो ट्रांसलिट्रेट एपीआई में हर दूसरे तरीके का नेमस्पेस है).

google.language.transliterate(), result ऑब्जेक्ट का आउटपुट देता है.

नतीजे के ऑब्जेक्ट, सर्वर के अनुरोधों की JSON एन्कोडिंग का इस्तेमाल करके बनाए जाते हैं. इसलिए, हमने औपचारिक JavaScript ऑब्जेक्ट लागू न करने का विकल्प चुना है. इसके बजाय, हमने ऑब्जेक्ट को क्रम से बनाए गए फ़ॉर्म से, डाइनैमिक तौर पर result ऑब्जेक्ट बनाया है.

हालांकि, ऑब्जेक्ट का कोई औपचारिक लागू होना नहीं है, लेकिन वे मौजूद हैं. साथ ही, हम उन्हें वैसा ही दस्तावेज़ देते हैं, जैसे किसी बैकिंग JavaScript को लागू करना होता है. इसका कम से कम असर होता है. इसका मतलब यह है कि नाम वाला कोई कंस्ट्रक्टर नहीं है. हर नतीजे के लिए, जैसे कि सिस्टम ने नया Object() कॉल किया और फिर उस ऑब्जेक्ट पर औपचारिक प्रॉपर्टी सेट कीं. ये प्रॉपर्टी नीचे दी गई हैं.

  • <result>
    • error?
      ट्रांसलिट्रेट में कोई गड़बड़ी होने पर मौजूद.
    • transliterations
      आकार की श्रेणी wordsArray इनपुट के आकार के बराबर है.
      • transliteratedWords
        ज़्यादा से ज़्यादा साइज़ 5 की श्रेणी, जिसमें wordsArray में मौजूद शब्दों से जुड़े ट्रांसलिट्रेशन हैं.

ट्रांसलिट्रेशन कंट्रोल JavaScript रेफ़रंस

नीचे दिए गए कंस्ट्रक्टर और तरीकों की मदद से, आप एपीआई के ज़रिए दिए गए यूज़र इंटरफ़ेस (यूआई) में ट्रांसलिट्रेशन कर सकते हैं.

कंस्ट्रक्टर - google.elements.transliteration.TransliterationControl(options)

निर्माता ब्यौरा

google.elements.transliteration.
TransliterationControl(options)

.TransliterationControl(options), बदलाव करने लायक एचटीएमएल डीओएम एलिमेंट के सेट पर ट्रांसलिट्रेशन चालू करता है. साथ ही, कई तरीके देता है, ताकि आप उन एलिमेंट में ट्रांसलिट्रेशन को कंट्रोल कर सकें. options आर्ग्युमेंट में ये फ़ील्ड हो सकते हैं:

  • sourceLanguage, एक ज़रूरी स्ट्रिंग है, जो LanguageCode enum (जैसा कि google.elements.transliteration.ENGLISH में है) का इस्तेमाल करके स्रोत भाषा के बारे में बताती है. फ़िलहाल, स्रोत की भाषा सिर्फ़ अंग्रेज़ी में ही इस्तेमाल की जा सकती है.
  • destinationLanguage एक ज़रूरी श्रेणी है जो LanguageCode enum का इस्तेमाल करके डेस्टिनेशन भाषा के बारे में बताती है (जैसा कि google.elements.transliteration.HINDI में है).

    यूज़र इंटरफ़ेस (यूआई) में, उपलब्ध डेस्टिनेशन भाषाएं, मेन्यू में दिखती हैं. इसमें पहली भाषा डिफ़ॉल्ट रूप से चुनी गई अरे होती है. दी गई सोर्स भाषा के लिए सही डेस्टिनेशन भाषाओं के बारे में ज़्यादा जानने के लिए, कृपया getDestinationLanguages देखें.
  • transliterationEnabled एक वैकल्पिक फ़ील्ड है, जो बताता है कि डिफ़ॉल्ट रूप से ट्रांसलिट्रेशन चालू करना है या नहीं. अगर आप डिफ़ॉल्ट रूप से ट्रांसलिट्रेशन चालू करना चाहते हैं, तो true की वैल्यू के साथ यह फ़ील्ड बताएं. डिफ़ॉल्ट मान false है.
  • shortcutKey एक वैकल्पिक स्ट्रिंग फ़ील्ड है. यह शॉर्टकट कुंजी को चालू या बंद करने के लिए टॉगल करता है. शॉर्टकट कुंजी के बारे में बताने के लिए, ऐसी स्ट्रिंग के बारे में बताएं जिसमें 'Ctrl', 'Alt' या 'Shift' और अंग्रेज़ी वर्णमाला के साथ स्ट्रिंग मौजूद हैं. उदाहरण के लिए, 'Ctrl+g' और 'Ctrl+Shift+a' ये दोनों मान्य शॉर्टकट कुंजी संयोजन हैं.

    ध्यान दें: आप Shift को सिर्फ़ मॉडिफ़ायर के तौर पर इस्तेमाल नहीं कर सकते. हालांकि, आप इसे Alt या Control के साथ इस्तेमाल कर सकते हैं.

यह तरीका इन स्थितियों में अपवाद बनाता है:

  • अमान्य sourceLanguage या destinationLanguage
  • sourceLangauge और destinationLanguage भाषा की जोड़ी में काम न करने वाली भाषाएं
  • shortcutsKey का अमान्य कॉम्बिनेशन

नीचे दिया गया कोड स्निपेट, ट्रांसलिट्रेशन कंट्रोल का इंस्टेंस बनाने का तरीका बताता है: 

function onLoad() {
  var options = {
    sourceLanguage: 'en',
    destinationLanguage: ['hi'],
    shortcutKey: 'ctrl+g',
    transliterationEnabled: true
  };

  // Create an instance on TransliterationControl with the required
  // options.
  var control = new google.elements.transliteration.TransliterationControl(options);
}

ट्रांसलिट्रेशन कंट्रोल के तरीके

इन तरीकों का इस्तेमाल, google.elements.transliteration.TransliterationControl नेमस्पेस पर लागू किया जाता है.

तरीका ब्यौरा

.addEventListener(eventType, listener, opt_listenerScope)

.addEventListener(eventType, listener, opt_listenerScope) बताए गए इवेंट टाइप के लिए, ट्रांसलिट्रेशन कंट्रोल में एक लिसनर जोड़ता है. जब किसी खास इवेंट टाइप को ट्रिगर किया जाता है, तो लिसनर को इवेंट ऑब्जेक्ट के साथ कॉल किया जाता है. इवेंट ऑब्जेक्ट की सामग्री इवेंट के प्रकार पर निर्भर करती है. इस तरीके के लिए पैरामीटर:

  • eventType वह इवेंट है जिसके लिए लिसनर को जोड़ा जाना है. यह तर्क eventType enum से वैल्यू लेता है (जैसे कि google.elements.transliteration.TransliterationControl. EventType.STATE_CHANGED).
  • listener, इवेंट के लिए लिसनर फ़ंक्शन उपलब्ध कराता है.
  • opt_listenerScope this के साथ लिसनर को opt_listenerScope में बताए गए ऑब्जेक्ट पर सेट करता है.

.addEventListener() के लिए, सामान लौटाने की कोई वैल्यू मौजूद नहीं है.

.disableTransliteration()

.disableTransliteration() ट्रांसलिट्रेशन कंट्रोल में ट्रांसलिट्रेशन बंद कर देता है. इस तरीके में कोई आर्ग्युमेंट और कोई रिटर्न वैल्यू नहीं है.

.enableTransliteration()

.enableTransliteration() ट्रांसलिट्रेशन कंट्रोल में ट्रांसलिट्रेशन चालू करती है. इस तरीके में कोई आर्ग्युमेंट और कोई रिटर्न वैल्यू नहीं है.

.isTransliterationEnabled()

.isTransliterationEnabled() में कोई आर्ग्युमेंट नहीं है और यह बूलियन बताता है कि ट्रांसलिट्रेशन कंट्रोल में ट्रांसलिट्रेशन चालू है या नहीं.

.makeTransliteratable(elementIds, opt_options)

.makeTransliteratable(elementIds, opt_options), दिए गए एचटीएमएल एलिमेंट पर ट्रांसलिट्रेशन चालू करता है. इस तरीके के लिए पैरामीटर:

  • elementIds एक ऐसी कैटगरी है जिसमें बदलाव करने लायक एलिमेंट आईडी या एलिमेंट की ऐसी स्ट्रिंग शामिल हैं जिनके लिए आप ट्रांसलिट्रेशन चालू करना चाहते हैं. एलिमेंट में बदलाव किया जा सकता है:

    • टेक्स्ट फ़ील्ड
    • टेक्स्ट एरिया
    • contentEditable="true" के साथ एक <div&gt
    • एक <iframe> designMode="on" के साथ
    • contentEditable="true" बॉडी के साथ एक iFrame. पक्का करें कि ट्रांसलिट्रेशन चालू करने से पहले, iFrame लोड हो गया हो.
  • opt_options एक वैकल्पिक आर्ग्युमेंट है, जो इन एलिमेंट पर लागू किए गए विकल्प देता है. इस आर्ग्युमेंट में ये फ़ील्ड हो सकते हैं:
    • adjustElementStyle एक वैकल्पिक बूलियन फ़ील्ड है. इसकी मदद से यह कंट्रोल किया जाता है कि एपीआई, टारगेट की गई भाषा के वर्णों के हिसाब से एलिमेंट और फ़ॉन्ट के साइज़ में अपने-आप बदलाव करेगा या नहीं. डिफ़ॉल्ट मान true है. यह विकल्प सिर्फ़ सादे लेख वाले एलिमेंट पर असर डालता है.
    • adjustElementDirection एक वैकल्पिक बूलियन फ़ील्ड है. यह destinationLanguage की दिशा के हिसाब से बदलाव किए जा सकने वाले एलिमेंट की दिशा को कंट्रोल करता है. डिफ़ॉल्ट मान true है.

अरबी जैसे दाएं से बाएं लेखन सिस्टम के लिए, एपीआई इनपुट एलिमेंट की दिशा को अपने-आप अडजस्ट कर देता है. ऐसा, लिखित स्क्रिप्ट की दिशा और इनपुट एलिमेंट के कॉन्टेंट के हिसाब से किया जाता है. direction के साथ एचटीएमएल और JavaScript का इस्तेमाल करके, इनपुट एलिमेंट में टेक्स्ट की दिशा सेट की जा सकती है. इसका मान 'ltr' (बाएं से दाएं) या 'rtl' (दाएं से बाएं) हो सकता है. इस तरीके का इस्तेमाल करने से इनपुट क्षेत्र में कर्सर और टेक्स्ट के अलाइनमेंट पर असर पड़ता है.

आप अरेबिक ट्रांसलिट्रेशन के उदाहरण में, दाएं से बाएं लिखी जाने वाली भाषाओं के लिए एपीआई और #39; सहायता के उदाहरण देख सकते हैं.

अगर कोई भी elementIds अमान्य है, तो यह तरीका अपवाद के तौर पर काम करता है.

.makeTransliteratable() के लिए, सामान लौटाने की कोई वैल्यू मौजूद नहीं है.

.removeEventListener(eventType, listener, opt_listenerScope)

.removeEventListener(eventType, listener, opt_listenerScope), इवेंट लिसनर को ट्रांसलिट्रेशन कंट्रोल से हटा देता है, जहां:

  • यह तर्क eventType enum (जैसे google.elements.transliteration.TransliterationControl. EventType.STATE_CHANGED).
  • listener उस इवेंट का फ़ंक्शन है जिसे हटाना है.
  • opt_listenerScope, वह स्कोप है जिसमें लिसनर को जोड़ते समय लिसनर को रजिस्टर किया गया था.

.removeEventListener() के लिए, सामान लौटाने की कोई वैल्यू मौजूद नहीं है.

.setLanguagePair(sourceLanguage, destinationLanguage)

.setLanguagePair(sourceLanguage, destinationLanguage) से आप ट्रांसलिट्रेशन कंट्रोल के लिए इस्तेमाल की जाने वाली भाषा की जोड़ी को डाइनैमिक तौर पर बदल सकते हैं, जहां:

  • sourceLanguage में, ट्रांसलिट्रेट की भाषा का टाइप उपलब्ध होता है. यह तर्क LanguageCode enum से वैल्यू लेता है (जैसे कि google.elements.transliteration.TransliterationControl. LanguageCode.ENGLISH).
  • डेस्टिनेशन लैंग्वेज, ट्रांसलिट्रेट किए गए टेक्स्ट के लिए भाषा टाइप की जानकारी देती है.

.setLanguagePair() से यह पता चलता है कि setLanguage कार्रवाई पूरी हुई या नहीं.

.showControl(divElement)

.showControl(divElement) बताए गए DIV में ट्रांसलिट्रेशन कंट्रोल दिखाता है, जहां divElement DIV का आईडी है. इस तरीके की कोई रिटर्न वैल्यू नहीं है.

.toggleTransliteration()

.toggleTransliteration() ट्रांसलिट्रेशन कंट्रोल में ट्रांसलिट्रेशन को चालू या बंद करता है. इस तरीके में कोई आर्ग्युमेंट और कोई रिटर्न वैल्यू नहीं है.

स्टैटिक तरीका

google.language नेमस्पेस पर, नीचे दिए गए स्टैटिक तरीके का इस्तेमाल किया जाता है.

स्टैटिक तरीका ब्यौरा

.setOnLoadCallback(callback)

.setOnLoadCallback(callback) एक स्टैटिक फ़ंक्शन है, जो बताए गए हैंडलर फ़ंक्शन को रजिस्टर करता है. यह फ़ंक्शन इस कॉल के पेज लोड होने के बाद, जहां callback शामिल होना ज़रूरी है. एपीआई में शामिल दस्तावेज़ लोड होने और एपीआई इस्तेमाल के लिए तैयार होने पर, यह ज़रूरी फ़ंक्शन होता है. जैसे कि onLoad के बाद, यह फ़ंक्शन google पर लागू किया जाता है. google.setOnLoadCallback(callback);)

.setOnLoadCallback() के लिए, सामान लौटाने की कोई वैल्यू मौजूद नहीं है.

ध्यान दें: पिछले दस्तावेज़ के लिए यह सुझाव दिया गया था कि आप बॉडी एलिमेंट ##load उससे जुड़े एट्रिब्यूट (<body onload="OnLoad()">) का इस्तेमाल करें. हालांकि, पेज का पूरा कंट्रोल और पेज पर लोड किए गए सभी कोड का इस्तेमाल करने से, इस समस्या को हल किया जा सकता है. हालांकि, इस तरीके की वजह से कुछ रनटाइम में समस्याएं आ सकती हैं जो आपके body.onload हैंडलर को खत्म कर देते हैं. setOnLoadCallback() में ये समस्याएं नहीं होती हैं. इसलिए, कॉलबैक को रजिस्टर करने का यह सुझाया गया तरीका है. आपके एपीआई के पूरी तरह से लोड होने और इस्तेमाल के लिए तैयार होने पर, यह आपके कोड को कॉल करता है.

google.elements.transliteration नेमस्पेस पर, नीचे दिए गए स्टैटिक तरीके का इस्तेमाल किया जाता है.

स्टैटिक तरीका ब्यौरा

.getDestinationLanguages(sourceLanguage)

.getDestinationLanguages(sourceLanguage) दुनिया भर में इस्तेमाल करने वाला ऐसा तरीका है जो उन डेस्टिनेशन भाषाओं के मैप दिखाता है जिनके लिए sourceLanguage दिया गया है. लौटाया गया मैप, स्वीकार की जाने वाली डेस्टिनेशन भाषाओं में शामिल है. इसमें, भाषा का नाम और वैल्यू ही भाषा कोड है. लौटाया गया मैप, LanguageCode enum में बताए गए मैप से मिलता-जुलता है.

एनम्स

EventType enum

google.elements.transliteration.TransliterationControl.EventType गिनती में ऐसे इवेंट की सूची होती है जो ट्रांसलिट्रेशन के दौरान संभव हो सकते हैं. आप अपने कोड में इन इवेंट के लिए, पसंद के मुताबिक हैंडलर उपलब्ध करा सकते हैं.

var google.elements.transliteration.TransliterationControl.EventType = {
   STATE_CHANGED : 'state_changed',
   LANGUAGE_CHANGED : 'language_changed',
   SERVER_REACHABLE : 'server_reachable',
   SERVER_UNREACHABLE : 'server_unreachable'
};
  • google.elements.transliteration.TransliterationControl.EventType.STATE_CHANGED: ऐसे नतीजे जब ट्रांसलिट्रेशन कंट्रोल में ट्रांसलिट्रेशन चालू या बंद होता है, तो:
    • शॉर्टकट कुंजी
    • enableTransliteration, disableTransliteration या toggleTransliteration तरीके
    • showControl तरीके से बनाए गए ट्रांसलिट्रेशन कंट्रोल पर माउस का क्लिक.
    सुनने वाले को भेजे गए इवेंट ऑब्जेक्ट में, transliterationEnabled फ़ील्ड होता है. अगर ट्रांसलिट्रेशन 'on' है, तो यह फ़ील्ड सही है, नहीं तो गलत है.
  • google.elements.transliteration.TransliterationControl.EventType.LANGUAGE_CHANGED: ऐसे नतीजे जब ट्रांसलिट्रेशन लैंग्वेज की जोड़ी को इन तरीकों से, ट्रांसलिट्रेशन कंट्रोल में बदला जाता है:
    • setLanguagePair तरीका
    • showControl तरीके से बनाया गया ट्रांसलिट्रेशन कंट्रोल
    लिसनर में पास किए जाने वाले इवेंट ऑब्जेक्ट में, sourceLanguage और destinationLanguage फ़ील्ड होते हैं.
  • google.elements.transliteration.TransliterationControl.EventType.SERVER_REACHABLE: नतीजे तब दिखते हैं, जब आप टेक्स्ट को ट्रांसलिट्रेट करने के लिए सर्वर से संपर्क करते हैं.
  • टेक्स्ट को ट्रांसलिट्रेट करने के लिए, सर्वर से संपर्क नहीं हो पाने की वजह से google.elements.transliteration.TransliterationControl.EventType.SERVER_UNREACHABLE नतीजे.

LanguageCode का enum

google.elements.transliteration.LanguageCode मैप, भाषा कोड के नाम को स्थिर रखता है, ताकि आप ट्रांसलिट्रेशन के तरीकों में स्रोत और डेस्टिनेशन की भाषा बताने के लिए इसका इस्तेमाल कर सकें.

var google.elements.transliteration.LanguageCode = {
    ENGLISH: 'en',
    AMHARIC: 'am',
    ARABIC: 'ar',
    BENGALI: 'bn',
    CHINESE: 'zh',
    GREEK: 'el',
    GUJARATI: 'gu',
    HINDI: 'hi',
    KANNADA: 'kn',
    MALAYALAM: 'ml',
    MARATHI: 'mr',
    NEPALI: 'ne',
    ORIYA: 'or',
    PERSIAN: 'fa',
    PUNJABI: 'pa',
    RUSSIAN: 'ru',
    SANSKRIT: 'sa',
    SINHALESE: 'si',
    SERBIAN: 'sr',
    TAMIL: 'ta',
    TELUGU: 'te',
    TIGRINYA: 'ti',
    URDU: 'ur'
};

यह काम करता हैDestinationLanguages enum

google.elements.transliteration.SupportedDestinationLanguages गणना मैप, भाषा कोड की श्रेणियों के लिए स्थिर नाम मैप करता है. इनका इस्तेमाल आप अनुवाद नियंत्रण में गंतव्य भाषाओं के समूह को बताने के लिए कर सकते हैं.

var google.elements.transliteration.SupportedDestinationLanguages = {
    // ALL includes all languages supported in the Transliterate API.
    // As support for more languages becomes available, this enum will be
    // automatically updated to include the new languages transparently.
    ALL: [
        google.elements.transliteration.LanguageCode.AMHARIC,
        google.elements.transliteration.LanguageCode.ARABIC,
        google.elements.transliteration.LanguageCode.BENGALI,
        google.elements.transliteration.LanguageCode.CHINESE,
        google.elements.transliteration.LanguageCode.GREEK,
        google.elements.transliteration.LanguageCode.GUJARATI,
        google.elements.transliteration.LanguageCode.HINDI,
        google.elements.transliteration.LanguageCode.KANNADA,
        google.elements.transliteration.LanguageCode.MALAYALAM,
        google.elements.transliteration.LanguageCode.MARATHI,
        google.elements.transliteration.LanguageCode.NEPALI,
        google.elements.transliteration.LanguageCode.ORIYA,
        google.elements.transliteration.LanguageCode.PERSIAN,
        google.elements.transliteration.LanguageCode.PUNJABI,
        google.elements.transliteration.LanguageCode.RUSSIAN,
        google.elements.transliteration.LanguageCode.SANSKRIT,
        google.elements.transliteration.LanguageCode.SERBIAN,
        google.elements.transliteration.LanguageCode.SINHALESE,
        google.elements.transliteration.LanguageCode.TAMIL,
        google.elements.transliteration.LanguageCode.TELUGU,
        google.elements.transliteration.LanguageCode.TIGRINYA,
        google.elements.transliteration.LanguageCode.URDU],
 
    // INDIC includes all Indic languages supported in the Transliterate API.
    // As support for more Indic languages becomes available, this enum will be
    // automatically updated to include the new languages transparently.
    INDIC: [
        google.elements.transliteration.LanguageCode.BENGALI,
        google.elements.transliteration.LanguageCode.GUJARATI,
        google.elements.transliteration.LanguageCode.HINDI,
        google.elements.transliteration.LanguageCode.KANNADA,
        google.elements.transliteration.LanguageCode.MALAYALAM,
        google.elements.transliteration.LanguageCode.MARATHI,
        google.elements.transliteration.LanguageCode.NEPALI,
        google.elements.transliteration.LanguageCode.ORIYA,
        google.elements.transliteration.LanguageCode.PUNJABI,
        google.elements.transliteration.LanguageCode.SANSKRIT,
        google.elements.transliteration.LanguageCode.SINHALESE,
        google.elements.transliteration.LanguageCode.TAMIL,
        google.elements.transliteration.LanguageCode.TELUGU,
        google.elements.transliteration.LanguageCode.URDU]
};

समस्याएं हल करना

अगर आपको समस्याएं आती हैं, तो:

  • टाइपिंग की गलतियां खोजें. याद रखें कि JavaScript केस-सेंसिटिव भाषा है.
  • JavaScript डीबगर का इस्तेमाल करें. Google Chrome में डेवलपर टूल का पूरा सेट होता है. Firefox में, JavaScript कंसोल या फ़ायरफ़ायर का इस्तेमाल किया जा सकता है. IE में, आप Microsoft Script डीबगर का इस्तेमाल कर सकते हैं.
  • चर्चा समूह खोजें. #