aboutsummaryrefslogtreecommitdiff
path: root/files/zh-cn/web/api/navigatorlanguage
diff options
context:
space:
mode:
authorPeter Bengtsson <mail@peterbe.com>2020-12-08 14:40:17 -0500
committerPeter Bengtsson <mail@peterbe.com>2020-12-08 14:40:17 -0500
commit33058f2b292b3a581333bdfb21b8f671898c5060 (patch)
tree51c3e392513ec574331b2d3f85c394445ea803c6 /files/zh-cn/web/api/navigatorlanguage
parent8b66d724f7caf0157093fb09cfec8fbd0c6ad50a (diff)
downloadtranslated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.gz
translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.bz2
translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.zip
initial commit
Diffstat (limited to 'files/zh-cn/web/api/navigatorlanguage')
-rw-r--r--files/zh-cn/web/api/navigatorlanguage/index.html68
-rw-r--r--files/zh-cn/web/api/navigatorlanguage/language/index.html64
-rw-r--r--files/zh-cn/web/api/navigatorlanguage/languages/index.html64
3 files changed, 196 insertions, 0 deletions
diff --git a/files/zh-cn/web/api/navigatorlanguage/index.html b/files/zh-cn/web/api/navigatorlanguage/index.html
new file mode 100644
index 0000000000..c2bbe44db0
--- /dev/null
+++ b/files/zh-cn/web/api/navigatorlanguage/index.html
@@ -0,0 +1,68 @@
+---
+title: NavigatorLanguage
+slug: Web/API/NavigatorLanguage
+tags:
+ - API
+ - HTML-DOM
+ - NeedsTranslation
+ - No Interface
+ - Reference
+ - TopicStub
+translation_of: Web/API/NavigatorLanguage
+---
+<p>{{APIRef("HTML DOM")}}</p>
+
+<p><code><strong>NavigatorLanguage</strong></code> 包含涉及导航(<code><strong>Navigator</strong></code>)的语言特性的方法和属性。</p>
+
+<p>其实 <code>NavigatorLanguage</code> 这个对象并不存在,但是,一些其它的接口,如 {{domxref("Navigator")}} 或 {{domxref("WorkerNavigator")}},实现了它。</p>
+
+<h2 id="属性">属性</h2>
+
+<p><em><code>NavigatorLanguage</code></em><em> 接口不继承任何属性。</em></p>
+
+<dl>
+ <dt>{{domxref("NavigatorLanguage.language")}} {{readonlyInline}}</dt>
+ <dd>返回一个 {{domxref("DOMString")}} 代表用户的首选语言,通常是浏览器 UI 的语言。若返回 <code>null</code> 值,则代表语言未知。</dd>
+ <dt>{{domxref("NavigatorLanguage.languages")}} {{readonlyInline}}</dt>
+ <dd>返回一个 {{domxref("DOMString")}} 数组,代表用户已知的语言,不同语言按照谁更佳排序。</dd>
+</dl>
+
+<h2 id="方法">方法</h2>
+
+<p><em><code>NavigatorLanguage</code></em><em> 接口不依赖任何接口和方法。</em></p>
+
+<h2 id="标准">标准</h2>
+
+<table class="standard-table">
+ <thead>
+ <tr>
+ <th scope="col">标准</th>
+ <th scope="col">状态</th>
+ <th scope="col">备注</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>{{SpecName('HTML WHATWG', '#navigatorlanguage', 'NavigatorLanguage')}}</td>
+ <td>{{Spec2('HTML WHATWG')}}</td>
+ <td>从 {{SpecName('HTML5 W3C')}} 出现开始,<code>languages</code> 属性已经被添加。</td>
+ </tr>
+ <tr>
+ <td>{{SpecName('HTML5 W3C', '#navigatorlanguage', 'NavigatorLanguage')}}</td>
+ <td>{{Spec2('HTML5 W3C')}}</td>
+ <td>初始标准;出现在 {{SpecName('HTML WHATWG')}} 的早期版本。</td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="浏览器兼容性">浏览器兼容性</h2>
+
+
+
+<p>{{Compat("api.NavigatorLanguage")}}</p>
+
+<h2 id="参见">参见</h2>
+
+<ul>
+ <li>实现本对象的 {{domxref("Navigator")}} 接口。</li>
+</ul>
diff --git a/files/zh-cn/web/api/navigatorlanguage/language/index.html b/files/zh-cn/web/api/navigatorlanguage/language/index.html
new file mode 100644
index 0000000000..24602dea56
--- /dev/null
+++ b/files/zh-cn/web/api/navigatorlanguage/language/index.html
@@ -0,0 +1,64 @@
+---
+title: NavigatorLanguage.language
+slug: Web/API/NavigatorLanguage/language
+tags:
+ - API
+ - NavigatorLanguage
+ - 参考
+ - 只读
+ - 多语言
+ - 属性
+ - 语言
+translation_of: Web/API/NavigatorLanguage/language
+---
+<div>{{APIRef("HTML DOM")}}</div>
+
+<p><strong><code>NavigatorLanguage.language</code></strong> 只读属性返回一个表示用户偏好语言的字符串,通常指浏览器 UI 的语言。</p>
+
+<h2 id="语法">语法</h2>
+
+<pre class="brush: js"><em>let lang</em> = navigator.language;
+</pre>
+
+<h3 id="值">值</h3>
+
+<p>一个 {{domxref("DOMString")}}。<code>lang</code> 存储一个表示语言版本(在 <a href="http://www.ietf.org/rfc/bcp/bcp47.txt">BCP 47</a> 中定义)的字符串。合法的语言版本有 "zh-CN"、"en"、"en-US"、"fr"、"es-ES" 等。</p>
+
+<p>注意 macOS 和 iOS 平台上的 Safari(10.2 之前版本),国家代码为小写:"zh-cn"、"en-us"、"fr-fr" 等。</p>
+
+<h2 id="示例">示例</h2>
+
+<pre class="brush: js">if ( window.navigator.language != 'zh-CN' ) {
+ doLangSelect(window.navigator.language);
+}
+</pre>
+
+<h2 id="标准">标准</h2>
+
+<table class="standard-table">
+ <thead>
+ <tr>
+ <th scope="col">标准</th>
+ <th scope="col">状态</th>
+ <th scope="col">备注</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr>
+ <td>{{SpecName('HTML WHATWG', '#dom-navigator-language', 'NavigatorLanguage: language')}}</td>
+ <td>{{Spec2('HTML WHATWG')}}</td>
+ <td>初次定义</td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="浏览器兼容性">浏览器兼容性</h2>
+
+<p>{{Compat("api.NavigatorLanguage.language")}}</p>
+
+<h2 id="另请参阅">另请参阅</h2>
+
+<ul>
+ <li>{{domxref("NavigatorLanguage.languages", "navigator.languages")}}</li>
+ <li>{{domxref("navigator")}}</li>
+</ul>
diff --git a/files/zh-cn/web/api/navigatorlanguage/languages/index.html b/files/zh-cn/web/api/navigatorlanguage/languages/index.html
new file mode 100644
index 0000000000..7378d105fa
--- /dev/null
+++ b/files/zh-cn/web/api/navigatorlanguage/languages/index.html
@@ -0,0 +1,64 @@
+---
+title: NavigatorLanguage.languages
+slug: Web/API/NavigatorLanguage/languages
+tags:
+ - API
+ - languages
+ - 只读
+ - 实验性
+ - 属性
+translation_of: Web/API/NavigatorLanguage/languages
+---
+<p>{{APIRef("HTML DOM")}}{{SeeCompatTable}}</p>
+
+<p><code><strong>NavigatorLanguage.languages </strong></code>只读属性 ,返回一个 {{domxref("DOMString")}} 的数组,数组内容表示网站访客所使用的语言。 使用 <a href="http://tools.ietf.org/html/bcp47">BCP 47</a> 语言标签来描述不同的语言。 在返回的数组中,最适合当前用户的语言将会被排到数组的首位。</p>
+
+<p>{{domxref("NavigatorLanguage.language","navigator.language")}} 的值是该属性返回数组的第一个元素 [3]。(但它基于系统语言设置。)</p>
+
+<p>当该值发生改变,即最适合用户的语言被改变, 事件{{event("languagechange")}} 将会在 {{domxref("Window")}} 对象下触发。</p>
+
+<p>在每一个HTTP请求上的来自用户浏览器的HTTP协议头 <code>Accept-Language</code> 使用相同的来自 <code>navigator.languages</code> 属性的语言值,除了特殊的 <code>qvalues</code> (权重值) 字段 (如:<code>en-US;q=0.8)。</code></p>
+
+<h2 id="语法">语法</h2>
+
+<pre class="syntaxbox notranslate"><em>preferredLanguages</em> = <em>globalObj</em>.navigator.languages
+</pre>
+
+<h2 id="例子">例子</h2>
+
+<pre class="brush: js notranslate">navigator.language //"en-US"
+navigator.languages //["en-US", "zh-CN", "ja-JP"]
+</pre>
+
+<h2 id="标准">标准</h2>
+
+<table class="standard-table">
+ <tbody>
+ <tr>
+ <th scope="col">标准</th>
+ <th scope="col">状态</th>
+ <th scope="col">备注</th>
+ </tr>
+ <tr>
+ <td>{{ SpecName('HTML5.1', '#dom-navigator-languages', 'NavigatorLanguage.languages') }}</td>
+ <td>{{ Spec2('HTML5.1') }}</td>
+ <td>
+ <p>初始化定义</p>
+ </td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="浏览器兼容性">浏览器兼容性</h2>
+
+
+
+<p>{{Compat("api.NavigatorLanguage.languages")}}</p>
+
+<h2 id="参见">参见</h2>
+
+<ul>
+ <li>{{domxref("NavigatorLanguage.language","navigator.language")}}</li>
+ <li>{{domxref("Navigator")}}</li>
+ <li>{{domxref("Window.onlanguagechange")}}</li>
+</ul>