Google Virtual Keyboard API
のドキュメントを翻訳してみます。APIの利用方法を説明する、
Getting Started(スタートガイド)
ページの続きです。
Calling the onLoad handler(onLoadハンドラの呼び出し)
.setOnLoadCallback(callback)は、この呼び出しを含むページをロードする時に一度だけ呼び出される、指定されたハンドラ関数を登録する静的な関数です。引数callbackは、この関数を含むドキュメントがロードされ、APIが(たとえばonLoadの後など)利用可能となる時に呼び出される、必須となる関数です。この関数は、googleネームスペースで実装されています(例として、google.setOnLoadCallback(callback)など)。
.setOnLoadCallback()は値を返しません。
Note:以前のドキュメントでは、body要素のonload属性(<body onload="OnLoad()">)を使うことを推奨していました。これはページを完全にコントロールする上でよい方法だからですが、このアプローチは、実行環境でbody.onloadハンドラを破壊する問題の原因となりえます。setOnLoadCallback()はこれらの問題を含まないので、APIが完全にロードされて使用可能になった時に呼び出すコールバックを登録する、推奨されるメソッドとなっています。
setOnLoadCallbackは、googleネームスペースで実装されています。呼び出し例:
google.setOnLoadCallback(function);
LayoutCode enum(レイアウトコードの列挙)
google.elements.keyboard.LayoutCode enumerationは、レイアウトコードの名前の定数をマップしています。単一の言語で多種のレイアウトや入力方法を使用可能とするために、レイアウトコードは言語コードとは同一でないことに注意してください。
var google.elements.keyboard.LayoutCode = {
'ALBANIAN': 'sq',
'ARABIC': 'ar',
'ARMENIAN_EASTERN': 'hy_east',
'ARMENIAN_WESTERN': 'hy_west',
'BASQUE': 'eu',
'BELARUSIAN': 'be',
'BENGALI_PHONETIC': 'bn_phone',
'BOSNIAN': 'bs',
'BRAZILIAN_PORTUGUESE': 'pt_br',
'BULGARIAN': 'bg',
'CATALAN': 'ca',
'CHEROKEE': 'chr',
'CROATIAN': 'hr',
'CZECH': 'cs',
'CZECH_QWERTZ': 'cs_qwertz',
'DANISH': 'da',
'DARI': 'prs',
'DUTCH': 'nl',
'DEVANAGARI_PHONETIC': 'deva_phone',
'ENGLISH': 'en',
'ESTONIAN': 'et',
'ETHIOPIC': 'ethi',
'FINNISH': 'fi',
'FRENCH': 'fr',
'GALICIAN': 'gl',
'GEORGIAN_QWERTY': 'ka_qwerty',
'GEORGIAN_TYPEWRITER': 'ka_typewriter',
'GERMAN': 'de',
'GREEK': 'el',
'GUJARATI_PHONETIC': 'gu_phone',
'GURMUKHI_PHONETIC': 'guru_phone',
'HEBREW': 'he',
'HINDI': 'hi',
'HUNGARIAN_101': 'hu_101',
'ICELANDIC': 'is',
'ITALIAN': 'it',
'KANNADA_PHONETIC': 'kn_phone',
'KAZAKH': 'kk',
'KHMER': 'km',
'KOREAN': 'ko',
'KYRGYZ': 'ky_cyrl',
'LAO': 'lo',
'LATVIAN': 'lv',
'LITHUANIAN': 'lt',
'MACEDONIAN': 'mk',
'MALAYALAM_PHONETIC': 'ml_phone',
'MALTESE': 'mt',
'MONGOLIAN_CYRILLIC': 'mn_cyrl',
'MONTENEGRIN': 'srp',
'NORWEGIAN': 'no',
'ORIYA_PHONETIC': 'or_phone',
'PAN_AFRICA_LATIN': 'latn_002',
'PASHTO': 'ps',
'PERSIAN': 'fa',
'POLISH': 'pl',
'PORTUGUESE': 'pt_pt',
'ROMANI': 'rom',
'ROMANIAN': 'ro',
'RUSSIAN': 'ru',
'SANSKRIT_PHONETIC': 'sa_phone',
'SERBIAN_CYRILLIC': 'sr_cyrl',
'SERBIAN_LATIN': 'sr_latn',
'SINHALA': 'si',
'SLOVAK': 'sk',
'SLOVAK_QWERTY': 'sk_qwerty',
'SLOVENIAN': 'sl',
'SOUTHERN_UZBEK': 'uzs',
'SPANISH': 'es_es',
'SWEDISH': 'sv',
'TAMIL_PHONETIC': 'ta_phone',
'TATAR': 'tt',
'TELUGU_PHONETIC': 'te_phone',
'THAI': 'th',
'TURKISH_F': 'tr_f',
'TURKISH_Q': 'tr_q',
'UIGHUR': 'ug',
'UKRAINIAN_101': 'uk_101',
'URDU': 'ur',
'UZBEK_LATIN': 'uz_latn',
'UZBEK_CYRILLIC_PHONETIC': 'uz_cyrl_phone',
'UZBEK_CYRILLIC_TYPEWRITTER': 'uz_cyrl_type',
'VIETNAMESE_TCVN': 'vi_tcvn',
'VIETNAMESE_TELEX': 'vi_telex',
'VIETNAMESE_VIQR': 'vi_viqr'
};
Troubleshooting(トラブルシューティング)
問題が発生した場合、
･APIキーが正当であるかどうか確認してください。
･タイピングが正しいかどうか確認してください。JavaScriptは大文字/小文字を区別する言語です。
･JavaScriptのデバッガを使用してください。Google Chromeはdeveloper toolsのフルセットを持ちます。FireFoxでは、Firebugか、JavaScriptコンソールが利用できます。IEでは、Microsoft Script Debuggerを利用できます。
･discussion groupを検索してみてください。あなたの質問への答えとなる投稿を見つけられない場合、問題が現れるウェブページへのリンクと共に、グループに質問を投稿してください。
次回は、API リファレンスです。
0 件のコメント:
コメントを投稿