globalization.getPreferredLanguage

獲取用戶端的當前語言的字串識別碼。

navigator.globalization.getPreferredLanguage(successCallback, errorCallback);

說明

返回到的語言識別項字串 successCallback 與 properties 物件作為參數。 物件應具有 value 屬性與 String 的值。

如果有出錯的語言，然後 errorCallback 執行與 [GlobalizationError](GlobalizationError/globalizationerror.html) 物件作為參數。 錯誤的期望的代碼[GlobalizationError](GlobalizationError/globalizationerror.html).UNKNOWN\_ERROR.

支援的平臺

  • Android 系統
  • 黑莓手機 WebWorks （OS 5.0 和更高）
  • iOS
  • Windows Phone 8

快速的示例

當瀏覽器設置為 en\_US 的地區設定，此時應顯示彈出式功能表對話方塊的文本與 language: English ：

navigator.globalization.getPreferredLanguage(
    function (language) {alert('language: ' + language.value + '\n');},
    function () {alert('Error getting language\n');}
);

完整的示例

<!DOCTYPE HTML>
<html>
  <head>
    <title>getPreferredLanguage Example</title>
    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    function checkLanguage() {
      navigator.globalization.getPreferredLanguage(
        function (language) {alert('language: ' + language.value + '\n');},
        function () {alert('Error getting language\n');}
      );
    }
    </script>
  </head>
  <body>
    <button onclick="checkLanguage()">Click for language</button>
  </body>
</html>

Windows Phone 8 怪癖

  • 返回當前語言的 ISO 639-1 兩個字母代碼。