initial commit

7 files changed, 383 insertions, 0 deletions

diff --git a/files/zh-cn/web/api/navigatorid/appcodename/index.html b/files/zh-cn/web/api/navigatorid/appcodename/index.html
new file mode 100644
index 0000000000..5f5f0e91da
--- /dev/null
+++ b/files/zh-cn/web/api/navigatorid/appcodename/index.html
@@ -0,0 +1,36 @@
+---
+title: NavigatorID.appCodeName
+slug: Web/API/NavigatorID/appCodeName
+translation_of: Web/API/NavigatorID/appCodeName
+---
+<p>{{ ApiRef() }}</p>
+
+<h3 id="Summary" name="Summary">概述</h3>
+
+<p>返回所使用浏览器的内部名称.</p>
+
+<h3 id="Syntax" name="Syntax">语法</h3>
+
+<pre class="eval">codeName = window.navigator.appCodeName
+</pre>
+
+<h3 id="Parameters" name="Parameters">参数</h3>
+
+<ul>
+ <li><code>codeName</code> 是一个字符串,表示浏览器内部名称.</li>
+</ul>
+
+<h3 id="Example" name="Example">例子</h3>
+
+<pre>dump(window.navigator.appCodeName);
+</pre>
+
+<h3 id="Notes" name="Notes">笔记</h3>
+
+<p>Mozilla, Netscape 6, 和 IE5 的内部名称都是 "Mozilla".</p>
+
+<h3 id="Specification" name="Specification">规范</h3>
+
+<p>{{ DOM0() }}</p>
+
+<p>{{ languages( { "en": "en/DOM/window.navigator.appCodeName","ja": "ja/DOM/window.navigator.appCodeName", "pl": "pl/DOM/window.navigator.appCodeName" } ) }}</p>
diff --git a/files/zh-cn/web/api/navigatorid/appname/index.html b/files/zh-cn/web/api/navigatorid/appname/index.html
new file mode 100644
index 0000000000..389e0b367b
--- /dev/null
+++ b/files/zh-cn/web/api/navigatorid/appname/index.html
@@ -0,0 +1,37 @@
+---
+title: NavigatorID.appName
+slug: Web/API/NavigatorID/appName
+translation_of: Web/API/NavigatorID/appName
+---
+<p>{{ ApiRef() }}</p>
+
+<h2 id="Summary" name="Summary">概述</h2>
+
+<p>返回所使用浏览器的名称。由于兼容性问题，HTML5 规范允许该属性返回 "Netscape" 。</p>
+
+<div class="note"><strong>注意：</strong>该属性并不一定能返回正确的浏览器名称。在基于 Gecko 的浏览器 （例如 Firefox）和基于 WebKit 的浏览器（例如 Chrome 和 Safari）中，返回的浏览器名称都是 "Netscape".</div>
+
+<h2 id="Syntax" name="Syntax">语法</h2>
+
+<pre class="eval">appName = window.navigator.appName
+</pre>
+
+<h3 id="Parameters" name="Parameters">返回值</h3>
+
+<ul>
+ <li><code>appName</code> 是一个字符串，表示浏览器名称</li>
+</ul>
+
+<h2 id="Example" name="Example">例子</h2>
+
+<pre class="brush: js">alert(window.navigator.appName);
+// 显示浏览器名称
+</pre>
+
+<h2 id="Specification" name="Specification">规范</h2>
+
+<ul>
+ <li><a class="external" href="http://www.w3.org/TR/html5/timers.html#navigator" title="http://www.w3.org/TR/html5/timers.html#navigator">HTML5: System state and capabilities: the Navigator object</a></li>
+</ul>
+
+<p>该属性起初属于 DOM Level 0 ，目前已经被添加到HTML5规范中。</p>
diff --git a/files/zh-cn/web/api/navigatorid/appversion/index.html b/files/zh-cn/web/api/navigatorid/appversion/index.html
new file mode 100644
index 0000000000..8fe576cecf
--- /dev/null
+++ b/files/zh-cn/web/api/navigatorid/appversion/index.html
@@ -0,0 +1,42 @@
+---
+title: NavigatorID.appVersion
+slug: Web/API/NavigatorID/appVersion
+translation_of: Web/API/NavigatorID/appVersion
+---
+<p>{{APIRef("HTML DOM")}}{{deprecated_header}}</p>
+
+<h2 id="Summary" name="Summary">概述</h2>
+
+<p>返回一个字符串，表示所使用浏览器的版本号。它可能只包含一个版本数字，如 "5.0"，还可能包含一些其他的相关信息。由于兼容性问题，HTML5规范允许该属性返回 "4.0"。</p>
+
+<div class="note"><strong>注意：</strong>该属性并不一定能返回正确的浏览器版本号。在基于 Gecko 的浏览器 （例如 Firefox）和基于 WebKit 的浏览器（例如 Chrome 和 Safari）中，返回的浏览器版本号都是 "5.0"，后跟一些操作系统与语言信息，比如 "5.0 (Windows; zh-CN)"。在Opera 10及以上版本，该属性的返回值也不是实际的浏览器版本号。</div>
+
+<h2 id="Syntax" name="Syntax">语法</h2>
+
+<pre class="eval">ver = window.navigator.appVersion
+</pre>
+
+<h3 id="Parameters" name="Parameters">返回值</h3>
+
+<ul>
+ <li><code>ver</code> 是一个字符串，表示浏览器版本号。</li>
+</ul>
+
+<h2 id="Example" name="Example">例子</h2>
+
+<pre class="brush: js">alert("你的浏览器版本为" + navigator.appVersion);
+</pre>
+
+<h2 id="Notes" name="Notes">备注</h2>
+
+<p><code>window.navigator.userAgent</code> 也包含一些浏览器的版本信息（比如："<code>Mozilla/5.0 (Windows; U; Win98; en-US; rv:0.9.2) Gecko/20010725 Netscape 6/6.1</code>"），但是你应该知道，修改浏览器的<code>userAgent字符串以及伪造它成为其他的浏览器、其他的操作系统等等是非常容易的。</code>而且，就算不伪造，浏览器提供商也不会保证这些数据就是准确的。</p>
+
+<p><code>window.navigator.appVersion</code>、<code>window.navigator.appName</code> 和 <code>window.navigator.userAgent </code>等属性都被用来编写一些"浏览器检测"的相关代码：脚本会尝试根据检测出的浏览器类型来相印的调整页面显示。种情况下，用户可以伪造相关的浏览器信息来查看一些本来不允许自己所使用的浏览器或平台查看的页面。</p>
+
+<h2 id="Specification" name="Specification">规范</h2>
+
+<ul>
+ <li><a class="external" href="http://www.w3.org/TR/html5/timers.html#navigator" title="http://www.w3.org/TR/html5/timers.html#navigator">HTML5: System state and capabilities: the Navigator object</a></li>
+</ul>
+
+<p>该属性最初属于 DOM Level 0，目前已经被添加到 HTML5 规范中。</p>
diff --git a/files/zh-cn/web/api/navigatorid/index.html b/files/zh-cn/web/api/navigatorid/index.html
new file mode 100644
index 0000000000..5fab09ada5
--- /dev/null
+++ b/files/zh-cn/web/api/navigatorid/index.html
@@ -0,0 +1,120 @@
+---
+title: NavigatorID
+slug: Web/API/NavigatorID
+translation_of: Web/API/NavigatorID
+---
+<p>{{APIRef("HTML DOM")}}</p>
+
+<p><code><strong>NavigatorID</strong></code> 接口包含浏览器识别相关的方法和属性。</p>
+
+<p>没有一个 <code>NavigatorID</code> 类型的对象，他是其他接口，如 {{domxref("Navigator")}} 或 {{domxref("WorkerNavigator")}} 实现了该接口。</p>
+
+<h2 id="属性">属性</h2>
+
+<p><em><code>NavigatorID</code></em><em> 接口没有继承任何属性。</em></p>
+
+<dl>
+ <dt>{{domxref("NavigatorID.appCodeName")}} {{readonlyInline}}{{experimental_inline}}</dt>
+ <dd>任何浏览器中，总是返回 <code>'Gecko'</code>。该属性仅仅是为了保持兼容性。</dd>
+ <dt>{{domxref("NavigatorID.appName")}} {{readonlyInline}}</dt>
+ <dd>返回浏览器的官方名称。不要指望该属性返回正确的值。</dd>
+ <dt>{{domxref("NavigatorID.appVersion")}} {{readonlyInline}}</dt>
+ <dd>返回一个字符串，表示浏览器的版本。不要指望该属性返回正确的值。</dd>
+ <dt>{{domxref("NavigatorID.platform")}} {{readonlyInline}}</dt>
+ <dd>返回一个字符串，表示浏览器的所在系统平台。</dd>
+ <dt>{{domxref("NavigatorID.product")}} {{readonlyInline}}</dt>
+ <dd>返回当前浏览器的产品名称（如，"Gecko"）。</dd>
+ <dt>{{domxref("NavigatorID.userAgent")}} {{readonlyInline}}</dt>
+ <dd>返回当前浏览器的用户代理字符串（user agent string）。</dd>
+</dl>
+
+<h2 id="方法">方法</h2>
+
+<p><em><code>NavigatorID</code></em><em> 接口没有继承任何方法。</em></p>
+
+<dl>
+ <dt>{{domxref("NavigatorID.taintEnabled()")}} {{deprecated_inline()}} {{experimental_inline}}</dt>
+ <dd>总是返回 <code>false</code>。JavaScript taint/untaint 函数在 JavaScript 1.2 中被移除了。该方法只是为了兼容性。</dd>
+</dl>
+
+<h2 id="规范">规范</h2>
+
+<table class="standard-table">
+ <thead>
+  <tr>
+   <th scope="col">Specification</th>
+   <th scope="col">Status</th>
+   <th scope="col">Comment</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>{{SpecName('HTML WHATWG', '#navigatorid', 'NavigatorID')}}</td>
+   <td>{{Spec2('HTML WHATWG')}}</td>
+   <td>Added the <code>appCodeName</code> property and the <code>taintEnabled()</code> method,  for compatibility purpose.</td>
+  </tr>
+  <tr>
+   <td>{{SpecName('HTML5 W3C', '#navigatorid', 'NavigatorID')}}</td>
+   <td>{{Spec2('HTML5 W3C')}}</td>
+   <td>Initial specification.</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="浏览器兼容性">浏览器兼容性</h2>
+
+<p>{{ CompatibilityTable() }}</p>
+
+<div id="compat-desktop">
+<table class="compat-table">
+ <tbody>
+  <tr>
+   <th>Feature</th>
+   <th>Chrome</th>
+   <th>Firefox (Gecko)</th>
+   <th>Internet Explorer</th>
+   <th>Opera</th>
+   <th>Safari</th>
+  </tr>
+  <tr>
+   <td>Basic support</td>
+   <td>{{CompatVersionUnknown}}</td>
+   <td>{{CompatVersionUnknown}}</td>
+   <td>{{CompatVersionUnknown}}</td>
+   <td>{{CompatVersionUnknown}}</td>
+   <td>{{CompatVersionUnknown}}</td>
+  </tr>
+ </tbody>
+</table>
+</div>
+
+<div id="compat-mobile">
+<table class="compat-table">
+ <tbody>
+  <tr>
+   <th>Feature</th>
+   <th>Android</th>
+   <th>Chrome for Android</th>
+   <th>Firefox Mobile (Gecko)</th>
+   <th>IE Mobile</th>
+   <th>Opera Mobile</th>
+   <th>Safari Mobile</th>
+  </tr>
+  <tr>
+   <td>Basic support</td>
+   <td>{{CompatVersionUnknown}}</td>
+   <td>{{CompatVersionUnknown}}</td>
+   <td>{{CompatVersionUnknown}}</td>
+   <td>{{CompatVersionUnknown}}</td>
+   <td>{{CompatVersionUnknown}}</td>
+   <td>{{CompatVersionUnknown}}</td>
+  </tr>
+ </tbody>
+</table>
+</div>
+
+<h2 id="相关链接">相关链接</h2>
+
+<ul>
+ <li>{{domxref("Navigator")}} 实现了该接口。</li>
+</ul>
diff --git a/files/zh-cn/web/api/navigatorid/platform/index.html b/files/zh-cn/web/api/navigatorid/platform/index.html
new file mode 100644
index 0000000000..a80d295ccb
--- /dev/null
+++ b/files/zh-cn/web/api/navigatorid/platform/index.html
@@ -0,0 +1,35 @@
+---
+title: NavigatorID.platform
+slug: Web/API/NavigatorID/platform
+translation_of: Web/API/NavigatorID/platform
+---
+<p>{{ ApiRef() }}</p>
+
+<h3 id="Summary" name="Summary">概述</h3>
+
+<p>返回一个字符串,表示浏览器所在的系统平台类型.</p>
+
+<h3 id="Syntax" name="Syntax">语法</h3>
+
+<pre class="eval"><em>platform</em> = <em>navigator</em>.platform
+</pre>
+
+<p><code>platform</code> 可能是: "Win32", "Linux i686", "MacPPC", "MacIntel", 等.</p>
+
+<h3 id="Example" name="Example">例子</h3>
+
+<pre class="brush: js">alert(navigator.platform);</pre>
+
+<h3 id="Notes" name="Notes">备注</h3>
+
+<p>在普通网页中,如果about:config中存在<code>general.platform.override</code><code>项,则</code>该属性的值会返回about:config中<code>general.platform.override项的值.</code> 在特权代码中 (chrome上下文或者拥有"UniversalBrowserRead"特权的网页中),返回的还是真实的平台类型.(译者注:语句:netscape.security.PrivilegeManager.enablePrivilege("UniversalBrowserRead ")用来激活所在网页的UniversalBrowserRead特权.)</p>
+
+<h3 id="Specification" name="Specification">规范</h3>
+
+<ul>
+ <li><a class="external" href="http://www.w3.org/TR/html5/timers.html#navigator" title="http://www.w3.org/TR/html5/timers.html#navigator">HTML5: System state and capabilities: the Navigator object</a></li>
+</ul>
+
+<p>该属性由DOM Level 0提出, 目前已经被添加到HTML5规范中.</p>
+
+<p>{{ languages( {"ja": "ja/DOM/window.navigator.platform", "en": "en/DOM/window.navigator.platform", "pl": "pl/DOM/window.navigator.platform" } ) }}</p>
diff --git a/files/zh-cn/web/api/navigatorid/product/index.html b/files/zh-cn/web/api/navigatorid/product/index.html
new file mode 100644
index 0000000000..0c660198d1
--- /dev/null
+++ b/files/zh-cn/web/api/navigatorid/product/index.html
@@ -0,0 +1,34 @@
+---
+title: NavigatorID.product
+slug: Web/API/NavigatorID/product
+translation_of: Web/API/NavigatorID/product
+---
+<div>
+ {{ApiRef}}</div>
+<h2 id="Summary" name="Summary">概述</h2>
+<p>该属性返回当前浏览器的产品名称。</p>
+<div class="note">
+ <strong>注意：</strong>该属性不一定返回一个真实的产品名称。Gecko 和 WebKit 浏览器返回 "Gecko" 作为该属性的值。</div>
+<h2 id="Syntax" name="Syntax">语法</h2>
+<pre class="syntaxbox"><i>productName</i> = window.navigator.product
+</pre>
+<ul>
+ <li><code>productName</code> 是一个字符串。</li>
+</ul>
+<h2 id="Example" name="Example">例子</h2>
+<pre class="brush: html">&lt;script&gt;
+function prod() {
+  dt = document.getElementById("d");
+  dt.innerHTML = window.navigator.product;
+}
+&lt;/script&gt;
+
+&lt;button onclick="prod();"&gt;product&lt;/button&gt;
+&lt;div id="d"&gt; &lt;/div&gt;
+&lt;!-- 返回 "Gecko" --&gt;
+</pre>
+<h2 id="Notes" name="Notes">备注</h2>
+<p>在基于 Gecko 的浏览器中，<code>product</code> 为完整的用户代理（user agent）字符串中紧跟着平台（platform）后的部分。例如，在 Netscape 6.1 的用户代理中，product 是 "<code>Gecko</code>"，完整的代理字符串是：<code>Mozilla/5.0 (Windows; U; Win98; en-US; rv:0.9.2) Gecko/20010725 Netscape6/6.1</code>。</p>
+<p>在基于 WebKit 的浏览器中，<code>product</code> 仍然返回 "<code>Gecko</code>"，即使完整用户代理字符串中平台（platform）后紧跟着：<code>(KHTML, like Gecko)</code>。</p>
+<h2 id="Specification" name="Specification">规范</h2>
+<p>{{dom0}}</p>
diff --git a/files/zh-cn/web/api/navigatorid/useragent/index.html b/files/zh-cn/web/api/navigatorid/useragent/index.html
new file mode 100644
index 0000000000..b5f2a23ab0
--- /dev/null
+++ b/files/zh-cn/web/api/navigatorid/useragent/index.html
@@ -0,0 +1,79 @@
+---
+title: NavigatorID.userAgent
+slug: Web/API/NavigatorID/userAgent
+translation_of: Web/API/NavigatorID/userAgent
+---
+<div>{{ApiRef("HTML DOM")}}</div>
+
+<p><code><strong>NavigatorID.userAgent</strong></code> 只读属性返回当前浏览器的 user agent 字符串。</p>
+
+<div class="note">
+<p>这一规范要求浏览器通过这一属性提供尽可能少的信息。不要假定同一浏览器的这一属性值会在未来的版本中保持不变。尽量不要使用这一属性，或者仅仅在现有和更早的版本中使用。较新的浏览器可能开始使用相同或近似的 UA，对于早期的浏览器而言：你不能确保该浏览器是其 <code><strong>NavigatorID.userAgent</strong></code> 属性所宣称的浏览器。</p>
+
+<p>另外要记住，用户可以修改浏览器的此属性(UA 欺骗).</p>
+</div>
+
+<p>基于 user agent 字符串来识别浏览器是<strong>不可靠</strong>的，<strong>不推荐使用</strong>，因为 user agent 字符串是用户可配置的。例如：</p>
+
+<ul>
+ <li>在 Firefox 浏览器中，你可以通过 <code>about:config</code> 页面的 <code>general.useragent.override</code> 字段修改 user agent。某些 FireFox 插件会更改此字段。 但这个字段只会影响到 http 请求的 header，不影响通过 Javascript 代码检测浏览器。</li>
+ <li>Opera 6+ 允许用户通过菜单设置浏览器辨识字符。</li>
+ <li>Microsoft Internet Explorer 通过修改 Windows 注册表修改 UA 。</li>
+ <li>Safari 和iCab 允许用户通过菜单选项将 UA 值修改为预设的Internet Explorer 或Netscape 浏览器 UA 。</li>
+</ul>
+
+<h2 id="Syntax" name="Syntax">语法</h2>
+
+<pre class="syntaxbox notranslate">var <var>ua</var> = navigator.userAgent;
+</pre>
+
+<h3 id="Value" name="Value">值</h3>
+
+<p>{{domxref("DOMString")}} 规定了浏览器提供给 {{Glossary("HTTP")}} headers 和其响应，以及其他与{{domxref("Navigator")}} 相关的方法的完整用户代理属性 。</p>
+
+<p>用户代理属性由几个信息段组成一个整齐的结构，每个信息段都取值于其他 {{domxref("Navigator")}} 属性，这些属性也可以是用户设置的。基于 Gecko 内核的浏览器的 UA 遵守下列通用结构规范。</p>
+
+<pre class="notranslate">userAgent = appCodeName/appVersion number (Platform; Security; OS-or-CPU;
+Localization; rv: revision-version-number) product/productSub
+Application-Name Application-Name-version
+</pre>
+
+<h2 id="Example" name="Example">例子</h2>
+
+<pre class="brush:js notranslate">alert(window.navigator.userAgent)
+// alerts "Mozilla/5.0 (Windows; U; Win98; en-US; rv:0.9.2) Gecko/20010725 Netscape6/6.1"
+</pre>
+
+<ul>
+</ul>
+
+<h2 id="规范">规范</h2>
+
+<table class="standard-table">
+ <thead>
+  <tr>
+   <th scope="col">Specification</th>
+   <th scope="col">Status</th>
+   <th scope="col">Comment</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>{{SpecName('HTML WHATWG', '#dom-navigator-useragent', 'NavigatorID.userAgent')}}</td>
+   <td>{{Spec2('HTML WHATWG')}}</td>
+   <td>Initial definition</td>
+  </tr>
+ </tbody>
+</table>
+
+<h2 id="浏览器兼容性">浏览器兼容性</h2>
+
+
+
+<p>{{Compat("api.NavigatorID.userAgent")}}</p>
+
+<h2 id="See_also" name="See_also">更多</h2>
+
+<ul>
+ <li>{{httpheader("User-Agent")}} HTTP header</li>
+</ul>