Transkrip API Referansı

Basit harf çevirisi

Aşağıdaki yöntem, JavaScript'i değiştirerek kullanıcı arayüzü olmadan basit harf çevirisi gerçekleştirmenizi sağlar.

Yöntem

Açıklama

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

google.language.transliterate(wordsArray, srcLang, destLang, callback), belirtilen metni kaynak dilden hedef dile metne dönüştüren global bir yöntemdir. API, sonucu eşzamansız olarak result nesnesi olarak callback işlevine döndürür. Bu yöntemin parametreleri şunlardır: wordsArray, harf çevirisi olarak dizideki metni sağlar. srcLang, kaynak dili dil kodu olarak sağlar. Örnekler için LanguageCode sıralamaya bakın. destLang, hedef dili dil kodu olarak sağlar. Örnekler için LanguageCode sıralamaya bakın. callback, result değerini alan geri çağırma işlevidir. google.language.transliterate() öğesinin iade değeri yok. Harf çevirisi için bu basitleştirilmiş yöntem, google.language.transliterate ad alanını kullanır (Harf Çevirme API'sındaki diğer tüm yöntemlerin ad alanı olan google.elements.transliteration değil). google.language.transliterate(), result nesnesini oluşturur. Sonuç nesneleri, sunucu isteklerinin JSON kodlaması kullanılarak oluşturulur. Bunun sonucunda, resmi JavaScript nesnelerini uygulamamayı seçtik ve bunun yerine result nesnelerini serileştirilmiş formlarından dinamik olarak oluşturduk. Nesnelerin resmi bir uygulaması olmasa da var olan bu nesneleri belgelendiriyoruz ve yardımcı bir JavaScript uygulaması varmış gibi belgeliyoruz. Tüm bunlar üzerindeki etki minimum düzeydedir. Bu, adlandırılmış bir oluşturucu olmadığı anlamına gelir. Her sonuç için, sistem yeni Object() öğesini çağırır ve ardından, bu nesnede resmi özellikleri ayarlar. Bu özellikler aşağıda verilmiştir. <sonuç> error? Harf çevirisinde hata varsa gösterilir. code HTTP stili bir hata kodu. message Hatanın kullanıcılar tarafından okunabilen bir dize açıklaması. transliterations wordsArray girişinin boyutuna eşit boyut dizisi. transliteratedWords wordsArray içinde karşılık gelen kelimenin harf çevirilerini içeren maksimum boyut 5'ten oluşan dizi.

Harf çevirisi kontrolü JavaScript referansı

Aşağıdaki oluşturucu ve yöntemler, API tarafından sağlanan kullanıcı arayüzünde harf çevirisi gerçekleştirmenize olanak tanır.

Marka - google.elements.transliteration.TransliterationControl(options)

Marka

Açıklama

google.elements.transliteration. TransliterationControl(options)

.TransliterationControl(options), bir dizi düzenlenebilir HTML DOM öğesinde harf çevirisi yapılmasını sağlar ve bu öğelerde harf çevirisini kontrol etmenize olanak tanıyan çeşitli yöntemler sağlar. options bağımsız değişkeni aşağıdaki alanları içerebilir: sourceLanguage, LanguageCode enum (google.elements.transliteration.ENGLISH biçiminde olduğu gibi) kullanarak kaynak dili belirten zorunlu dizedir. Şu anda desteklenen tek kaynak dil İngilizcedir. destinationLanguage, LanguageCode enum'u (ör. google.elements.transliteration.HINDI) kullanarak hedef dili belirten bir zorunlu dizidir. Kullanıcı arayüzünde, kullanılabilir hedef diller menüde varsayılan olarak seçilidir. Belirli bir kaynak dil için geçerli hedef diller hakkında daha fazla bilgiyi getDestinationLanguage bölümünde bulabilirsiniz. transliterationEnabled, harf çevirisinin varsayılan olarak etkinleştirilip etkinleştirilmeyeceğini belirten isteğe bağlı bir alandır. Varsayılan olarak harf çevirisini etkinleştirmek istiyorsanız bu alanı true değeriyle belirtin. Varsayılan değer false değeridir. shortcutKey, harf çevirisinin açık veya kapalı olmasını sağlayan bir kısayol anahtarı belirten isteğe bağlı bir dize alanıdır. Kısayol tuşunu belirtmek için 'Ctrl', 'Alt' veya 'Shift' gibi alfabetik bir harfle birlikte dize içeren bir dize belirtin. Örneğin, 'Ctrl+g' ve 'Ctrl+Shift+a' geçerli kısayol tuşu kombinasyonlarıdır. Not: Tek değiştirici olarak Üst Karakter kullanamazsınız, ancak Alt veya Control ile birlikte kullanabilirsiniz. Bu yöntem, aşağıdaki durumlarda istisna oluşturur: Geçersiz sourceLanguage veya destinationLanguage sourceLangauge ve destinationLanguage dil çiftlerinde desteklenmeyen diller kısayol kısayolu kombinasyonu geçersiz Aşağıdaki kod snippet'i, harf çevirisi kontrolü örneğinin nasıl oluşturulacağını gösterir: 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); }

Harf çevirisi kontrol yöntemleri

Aşağıdaki yöntemler google.elements.transliteration.TransliterationControl ad alanında uygulanır.

Yöntem	Açıklama
.addEventListener(eventType, listener, opt_listenerScope)	.addEventListener(eventType, listener, opt_listenerScope), belirtilen etkinlik türü için harf çevirisi kontrolüne bir dinleyici ekler. Belirli bir etkinlik türü tetiklendiğinde dinleyici, etkinlik nesnesiyle çağrılır. Etkinlik nesnesinin içeriği, etkinliğin türüne bağlıdır. Bu yöntemin parametreleri şunlardır: eventType, dinleyicinin ekleneceği etkinliktir. Bu bağımsız değişken, değerini eventType sıralamasından alır (google.elements.transliteration.TransliterationControl. EventType.STATE_CHANGED) gibi). listener, etkinlik için bir işleyici işlevi sağlar. opt_listenerScope, this öğesinde opt_listenerScope değerini belirtilen dinleyiciye ayarlanmış dinleyiciyi çağırır. .addEventListener() öğesinin iade değeri yok.
.disableTransliteration()	.disableTransliteration(), harf çevirisi denetiminde harf çevirisini devre dışı bırakır. Bu yöntemde bağımsız değişken ve dönüş değeri yoktur.
.enableTransliteration()	.enableTransliteration(), harf çevirisi denetiminde harf çevirisini etkinleştirir. Bu yöntemde bağımsız değişken ve dönüş değeri yoktur.
.isTransliterationEnabled()	.isTransliterationEnabled(), bağımsız değişkene sahip değildir ve harf çevirisi kontrolünün harf çevirisinin etkin olup olmadığını belirten bir boole değeri döndürür.
.makeTransliteratable(elementIds, opt_options)	.makeTransliteratable(elementIds, opt_options), sağlanan HTML öğelerinde harf çevirisinin gerçekleştirilmesini sağlar. Bu yöntemin parametreleri şunlardır: elementIds, harf çevirisini etkinleştirmek istediğiniz düzenlenebilir öğe kimlikleri veya öğe referanslarından oluşan dizeler içerir. Düzenlenebilir öğeler: Metin alanı Metin alanı contentEditable="true" ile &div; designMode="on" ile <iframe> contentEditable="true" gövdeli iFrame. Harf çevirisinin etkinleştirilmesinden önce iFrame'in yüklendiğinden emin olun. opt_options, bu öğelere uygulanan seçenekleri sağlayan isteğe bağlı bir bağımsız değişkendir. Bu bağımsız değişken aşağıdaki alanları içerebilir: adjustElementStyle, API'nin öğe ve yazı tipi boyutlarını, hedef dildeki karakterlere en uygun şekilde otomatik olarak ayarlayıp ayarlamayacağını kontrol eden isteğe bağlı bir boole alanıdır. Varsayılan değer true değeridir. Bu seçenek yalnızca düz metin öğelerini etkiler. adjustElementDirection, destinationLanguage öğesine bağlı olarak düzenlenebilir öğenin yönünü kontrol eden isteğe bağlı bir boole alanıdır. Varsayılan değer true değeridir. API, Arapça gibi sağdan sola yazma sistemleri için giriş öğesinin yönünü yazılı komut dosyasının yönüne ve giriş öğesinin içeriğine göre otomatik olarak ayarlar. Bir giriş öğesindeki metnin yönünü, HTML (JavaScript) kullanarak direction ile ayarlayabilirsiniz. Bu değerler 'ltr' (soldan sağa) veya 'rtl' (sağdan sola) olabilir. Bu yöntemin kullanılması, giriş alanındaki metnin imleci ve hizalamasını etkiler. Arapça harf çevirisi örneğinde, API'nin sağdan sola yazılan diller için destek örneğini görebilirsiniz. Belirtilen elementIds değerlerinden herhangi biri geçersizse bu yöntem istisna oluşturur. .makeTransliteratable() öğesinin iade değeri yok.
.removeEventListener(eventType, listener, opt_listenerScope)	.removeEventListener(eventType, listener, opt_listenerScope), etkinlik işleyiciyi harf çevirisi denetiminden kaldırır. Burada: Bu bağımsız değişken, değerini eventType sıralamasından alır (ör. google.elements.transliteration.TransliterationControl. EventType.STATE_CHANGED)). listener, kaldırılması gereken etkinliğin işlevidir. opt_listenerScope, dinleyiciyi eklerken dinleyicinin kaydedildiği kapsamdır. .removeEventListener() öğesinin iade değeri yok.
.setLanguagePair(sourceLanguage, destinationLanguage)	.setLanguagePair(sourceLanguage, destinationLanguage), harf çevirisi denetimi tarafından kullanılan dil çiftini dinamik bir şekilde değiştirmenize olanak sağlar: sourceLanguage, harf çevirisi yapılacak dil türünü sağlar. Bu bağımsız değişken, değerini LanguageCode sıralamasından alır (google.elements.transliteration.TransliterationControl. LanguageCode.ENGLISH) gibi). destinationLanguage, transkriptlenmiş metnin dil türünü sağlar. .setLanguagePair(), setLanguage işleminin başarılı olup olmadığını gösteren bir boole değeri döndürür.
.showControl(divElement)	.showControl(divElement), belirtilen DIV öğesinde harf çevirisi denetimini gösterir. Burada divElement, DIV öğesinin kimliğidir. Bu yöntemin dönüş değeri yoktur.
.toggleTransliteration()	.toggleTransliteration(), harf çevirisi denetiminde harf çevirisini açar veya kapatır. Bu yöntemde bağımsız değişken ve dönüş değeri yoktur.

Statik yöntem

Aşağıdaki statik yöntem google.language ad alanında uygulanır.

Statik yöntem

Açıklama

.setOnLoadCallback(callback)

.setOnLoadCallback(callback), belirtilen işleyici işlevini kaydeden bu statik işlevdir.Bu çağrıyı içeren sayfa yüklendiğinde çağrılacak. Burada callback, içerdiği doküman yüklendiğinde ve API kullanıma hazır olduğunda (ör. onLoad tarihinden sonra) çağrılması gereken gerekli bir işlevdir.Bu işlev google ad alanında (ör. google.setOnLoadCallback(callback);) .setOnLoadCallback() öğesinin iade değeri yok. Not: Önceki dokümanlarda, gövde öğesi ons özelliğini (<body onload="OnLoad()">) kullanmanız önerilir. Bu yöntem, sayfanın ve sayfa tarafından yüklenen tüm kodların tam kontrolü sizde olduğunda iyi bir çözüm olsa da bu yaklaşım, body.onload işleyicinizi yok eden bazı çalışma zamanlarında sorunlara neden olabilir. setOnLoadCallback()'te bu sorunlar olmadığından, API tam olarak yüklendiğinde ve kullanıma hazır olduğunda kodunuzu çağıran geri arama kaydetme yöntemi önerilir.

Aşağıdaki statik yöntem google.elements.transliteration ad alanında uygulanır.

Statik yöntem	Açıklama
.getDestinationLanguages(sourceLanguage)	.getDestinationLanguages(sourceLanguage), belirli bir sourceLanguage için harf çevirisinin desteklendiği hedef dillerin haritasını döndüren genel bir yöntemdir. Döndürülen harita, desteklenen hedef dilleri içerir. Bu anahtarda dil adı ve değerde dil kodu kullanılmaktadır. Döndürülen harita, LanguageCode sıralamasında açıklanana benzer.

Sıralamalar

EventType enum'u

google.elements.transliteration.TransliterationControl.EventType numaralandırması, harf çevirisi sırasında mümkün olan etkinlikleri listeler. Kodunuzda bu etkinlikler için özel işleyiciler sağlayabilirsiniz.

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: Harf çevirisi denetiminde harf çevirisi etkinleştirildiğinde veya devre dışı bırakıldığında sonuçlar:
  • Kısayol tuşu
  • enableTransliteration, disableTransliteration veya toggleTransliteration yöntemleri
  • showControl yöntemiyle çizilen harf çevirisi denetiminin fare tıklaması.
  Dinleyiciye iletilen etkinlik nesnesi transliterationEnabled alanını içerir. Bu harf harf çevirisi &&33;on' ise yanlıştır. Bu alan yanlıştır.
• google.elements.transliteration.TransliterationControl.EventType.LANGUAGE_CHANGED: Harf çevirisi dil çiftinde harf çevirisi denetiminde değişiklik yapıldığında sonuçlar:
  • setLanguagePair yöntemi
  • showControl yöntemi tarafından çizilen harf çevirisi kontrolü
  İşleyiciye iletilen etkinlik nesnesi sourceLanguage ve destinationLanguage alanlarını içerir.
• google.elements.transliteration.TransliterationControl.EventType.SERVER_REACHABLE: Metni metne dönüştürmek için sunucuyla başarılı bir şekilde iletişime geçtiğinizde elde edilen sonuçlar.
• google.elements.transliteration.TransliterationControl.EventType.SERVER_UNREACHABLE Metni metne dönüştürmek için sunucuyla iletişim kurma girişiminin başarısız olmasıyla sonuçlanır.

LanguageCode sıralama

google.elements.transliteration.LanguageCode, ad sabitlerini harf çevirisi yöntemlerinde kaynak ve hedef dilleri belirtmek için kullanabileceğiniz dil kodlarıyla eşler.

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'
};

DestinationDestinationLanguage enum

google.elements.transliteration.SupportedDestinationLanguages numaralandırması, ad sabitlerini harf çevirisi kontrolünde hedef dil gruplarını belirtmek için kullanabileceğiniz dil kodu dizileriyle eşler.

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]
};

Sorun giderme

Sorunlarla karşılaşırsanız:

• Yazım hataları olup olmadığına bakın. JavaScript'in büyük/küçük harfe duyarlı bir dil olduğunu unutmayın.
• JavaScript hata ayıklayıcısı kullanın. Google Chrome'da tam bir geliştirici araçları seti bulunur. Firefox'ta, JavaScript konsolunu veya Firebug'ı kullanabilirsiniz. IE'de Microsoft Script Debugger'ı kullanabilirsiniz.
• Tartışma grubunda arama yapın. Sorunuzun yanıtını içeren bir yayın bulamazsanız sorunuzu gruba, sorunu gösteren bir web sayfasının bağlantısına da gönderin.