diff options
author | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:40:17 -0500 |
---|---|---|
committer | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:40:17 -0500 |
commit | 33058f2b292b3a581333bdfb21b8f671898c5060 (patch) | |
tree | 51c3e392513ec574331b2d3f85c394445ea803c6 /files/zh-cn/web/api/navigatorlanguage | |
parent | 8b66d724f7caf0157093fb09cfec8fbd0c6ad50a (diff) | |
download | translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.gz translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.bz2 translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.zip |
initial commit
Diffstat (limited to 'files/zh-cn/web/api/navigatorlanguage')
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> |