Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

AutoCorrect files/zh-cn/web/api/history/ #5925

Merged
merged 5 commits into from
May 30, 2022
Merged

AutoCorrect files/zh-cn/web/api/history/ #5925

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
b995231
AutoCorrect files/zh-cn/web/api/history/
huacnlee May 28, 2022
a86afa4
Update files/zh-cn/web/api/history/scrollrestoration/index.html
huacnlee May 28, 2022
c2c98e6
Update files/zh-cn/web/api/history/pushstate/index.html
huacnlee May 28, 2022
3bba2ff
Update files/zh-cn/web/api/history/index.html
huacnlee May 28, 2022
41c0bbf
Update files/zh-cn/web/api/history/index.html
huacnlee May 28, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/history/forward/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,7 @@
- History
translation_of: Web/API/History/forward
---
<p>在会话历史中向前移动一页。它与使用<code>delta</code>参数为1时调用 <code>history.go(delta)</code>的效果相同。</p>
<p>在会话历史中向前移动一页。它与使用<code>delta</code>参数为 1 时调用 <code>history.go(delta)</code>的效果相同。</p>

<h2 id="语法">语法</h2>

Expand Down
4 changes: 2 additions & 2 deletions files/zh-cn/web/api/history/go/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -15,12 +15,12 @@ <h3 id="参数">参数</h3>

<dl>
<dt><code>delta</code> {{optional_inline}}</dt>
<dd>相对于当前页面你要去往历史页面的位置。负值表示向后移动，正值表示向前移动。因此，例如：<code>history.go(2)</code>向前移动两页，<code>history.go(-2)</code>则向后移动两页。如果未向该函数传参或<code>delta</code>相等于0，则该函数与调用<code>location.reload()</code>具有相同的效果。</dd>
<dd>相对于当前页面你要去往历史页面的位置。负值表示向后移动，正值表示向前移动。因此，例如：<code>history.go(2)</code>向前移动两页，<code>history.go(-2)</code>则向后移动两页。如果未向该函数传参或<code>delta</code>相等于 0，则该函数与调用<code>location.reload()</code>具有相同的效果。</dd>
<dt>
<div class="blockIndicator note">
<p>译者注：</p>

<p>相等于0是采用宽松相等进行比较的。另外，JavaScript值古怪的隐式转换在这里也是可用的。</p>
<p>相等于 0 是采用宽松相等进行比较的。另外，JavaScript 值古怪的隐式转换在这里也是可用的。</p>
</div>
</dt>
</dl>
Expand Down
28 changes: 14 additions & 14 deletions files/zh-cn/web/api/history/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,35 +13,35 @@ <h2 id="属性">属性</h2>

<dl>
<dt>{{domxref("History.length")}} {{readOnlyInline}}</dt>
<dd>返回一个整数，该整数表示会话历史中元素的数目，包括当前加载的页。例如，在一个新的选项卡加载的一个页面中，这个属性返回1。</dd>
<dd>返回一个整数，该整数表示会话历史中元素的数目，包括当前加载的页。例如，在一个新的选项卡加载的一个页面中，这个属性返回 1。</dd>
<dt>{{domxref("History.scrollRestoration")}} {{experimental_inline}}</dt>
<dd>允许Web应用程序在历史导航上显式地设置默认滚动恢复行为。此属性可以是自动的（auto）或者手动的（manual）。</dd>
<dd>允许 Web 应用程序在历史导航上显式地设置默认滚动恢复行为。此属性可以是自动的（auto）或者手动的（manual）。</dd>
<dt>{{domxref("History.state")}} {{readOnlyInline}}</dt>
<dd>返回一个表示历史堆栈顶部的状态的值。这是一种可以不必等待{{event("popstate")}} 事件而查看状态的方式。</dd>
</dl>

<h2 id="方法">方法</h2>

<p><em>History接口不继承任何方法。</em></p>
<p><em>History 接口不继承任何方法。</em></p>

<dl>
<dt>{{domxref("History.back()")}}</dt>
<dd>在浏览器历史记录里前往上一页, 用户可点击浏览器左上角的返回(译者注：←)按钮模拟此方法. 等价于 <code>history.go(-1)</code>.
<dd>在浏览器历史记录里前往上一页，用户可点击浏览器左上角的返回 (译者注：←) 按钮模拟此方法。等价于 <code>history.go(-1)</code>.
<div class="note"><strong>Note:</strong> 当浏览器会话历史记录处于第一页时调用此方法没有效果，而且也不会报错。</div>
</dd>
<dt>{{domxref("History.forward()")}}</dt>
<dd>在浏览器历史记录里前往下一页，用户可点击浏览器左上角的前进(译者注：→)按钮模拟此方法. 等价于 <code>history.go(1)</code>.
<div class="note"><strong>Note:</strong> 当浏览器历史栈处于最顶端时( 当前页面处于最后一页时 )调用此方法没有效果也不报错。</div>
<dd>在浏览器历史记录里前往下一页，用户可点击浏览器左上角的前进 (译者注：→) 按钮模拟此方法。等价于 <code>history.go(1)</code>.
<div class="note"><strong>Note:</strong> 当浏览器历史栈处于最顶端时 ( 当前页面处于最后一页时 ) 调用此方法没有效果也不报错。</div>
</dd>
<dt>{{domxref("History.go()")}}</dt>
<dd>通过当前页面的相对位置从浏览器历史记录( 会话记录 )加载页面。比如：参数为-1的时候为上一页，参数为1的时候为下一页. 当整数参数超出界限时( 译者注:原文为When <code><em>integerDelta</em></code> is out of bounds )，例如: 如果当前页为第一页，前面已经没有页面了，我传参的值为-1，那么这个方法没有任何效果也不会报错。调用没有参数的 <code>go() </code>方法或者参数值为0时，重新载入当前页面。( 这点与支持字符串作为url参数的IE有点不同)。</dd>
<dd>通过当前页面的相对位置从浏览器历史记录 ( 会话记录 ) 加载页面。比如：参数为-1 的时候为上一页，参数为 1 的时候为下一页。当整数参数超出界限时 ( 译者注：原文为 When <code><em>integerDelta</em></code> is out of bounds )，例如：如果当前页为第一页，前面已经没有页面了，我传参的值为-1，那么这个方法没有任何效果也不会报错。调用没有参数的 <code>go() </code>方法或者参数值为 0 时，重新载入当前页面。( 这点与支持字符串作为 url 参数的 IE 有点不同)。</dd>
<dt>{{domxref("History.pushState()")}}</dt>
<dd>按指定的名称和URL（如果提供该参数）将数据push进会话历史栈，数据被DOM进行不透明处理；你可以指定任何可以被序列化的javascript对象。注意到Firefox现在忽略了这个title参数，更多的信息，请看<a href="/zh-CN/docs/Web/API/History_API" title="en/DOM/Manipulating the browser history">manipulating the browser history</a>。
<div class="note"><strong>Note:</strong> 在 Gecko 2.0 {{ geckoRelease("2.0") }} 到 Gecko 5.0 {{ geckoRelease("5.0") }}中， 被传递的对象使用JSON进行序列化. 从 Gecko 6.0 {{ geckoRelease("6.0") }}开始，使用<a href="/en/DOM/The_structured_clone_algorithm">结构化克隆算法</a>进行序列化。这样，就可以让更多类型的对象被安全地传输。</div>
<dd>按指定的名称和 URL（如果提供该参数）将数据 push 进会话历史栈，数据被 DOM 进行不透明处理；你可以指定任何可以被序列化的 javascript 对象。注意到 Firefox 现在忽略了这个 title 参数，更多的信息，请看<a href="/zh-CN/docs/Web/API/History_API" title="en/DOM/Manipulating the browser history">manipulating the browser history</a>。
<div class="note"><strong>Note:</strong> 在 Gecko 2.0 {{ geckoRelease("2.0") }} 到 Gecko 5.0 {{ geckoRelease("5.0") }}中， 被传递的对象使用 JSON 进行序列化。从 Gecko 6.0 {{ geckoRelease("6.0") }}开始，使用<a href="/en/DOM/The_structured_clone_algorithm">结构化克隆算法</a>进行序列化。这样，就可以让更多类型的对象被安全地传输。</div>
</dd>
<dt>{{domxref("History.replaceState()")}}</dt>
<dd>按指定的数据，名称和URL(如果提供该参数)，更新历史栈上最新的入口。这个数据被DOM 进行了不透明处理。你可以指定任何可以被序列化的javascript对象。注意到Firefox现在忽略了这个title参数，更多的信息，请看<a href="/zh-CN/docs/Web/API/History_API" title="en/DOM/Manipulating the browser history">manipulating the browser history</a>。
<div class="note"><strong>Note:</strong> 在 Gecko 2.0 {{ geckoRelease("2.0") }} 到 Gecko 5.0 {{ geckoRelease("5.0") }} 中, the passed object is serialized using JSON. Starting in Gecko 6.0 {{ geckoRelease("6.0") }}, the object is serialized using <a href="/en/DOM/The_structured_clone_algorithm" title="en/DOM/The structured clone algorithm">the structured clone algorithm</a>. This allows a wider variety of objects to be safely passed.</div>
<dd>按指定的数据，名称和 URL(如果提供该参数)，更新历史栈上最新的入口。这个数据被 DOM 进行了不透明处理。你可以指定任何可以被序列化的 javascript 对象。注意到 Firefox 现在忽略了这个 title 参数，更多的信息，请看<a href="/zh-CN/docs/Web/API/History_API" title="en/DOM/Manipulating the browser history">manipulating the browser history</a>。
<div class="note"><strong>Note:</strong> 在 Gecko 2.0 {{ geckoRelease("2.0") }} 到 Gecko 5.0 {{ geckoRelease("5.0") }} 中，the passed object is serialized using JSON. Starting in Gecko 6.0 {{ geckoRelease("6.0") }}, the object is serialized using <a href="/en/DOM/The_structured_clone_algorithm" title="en/DOM/The structured clone algorithm">the structured clone algorithm</a>. This allows a wider variety of objects to be safely passed.</div>
</dd>
</dl>

Expand All @@ -58,7 +58,7 @@ <h2 id="说明">说明</h2>
<td>{{SpecName('HTML WHATWG', "browsers.html#the-history-interface", "History")}}</td>
<td>{{Spec2('HTML WHATWG')}}</td>
<td>
<p><code>添加scrollRestoration</code>  属性.</p>
<p><code>添加 scrollRestoration</code>  属性。</p>
huacnlee marked this conversation as resolved.
Show resolved Hide resolved
</td>
</tr>
<tr>
Expand All @@ -69,7 +69,7 @@ <h2 id="说明">说明</h2>
<tr>
<td>{{SpecName('Custom Scroll Restoration', '#web-idl', "History")}}</td>
<td>{{Spec2('Custom Scroll Restoration')}}</td>
<td><code>添加scrollRestoration</code>  属性.</td>
<td><code>添加 scrollRestoration</code>  属性。</td>
huacnlee marked this conversation as resolved.
Show resolved Hide resolved
</tr>
</tbody>
</table>
Expand All @@ -83,5 +83,5 @@ <h2 id="浏览器兼容">浏览器兼容</h2>
<h2 id="其他">其他</h2>

<ul>
<li>{{domxref("Window.history")}} 返回当前会话的history状态</li>
<li>{{domxref("Window.history")}} 返回当前会话的 history 状态</li>
</ul>
4 changes: 2 additions & 2 deletions files/zh-cn/web/api/history/length/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
---
<div>{{ APIRef("HTML DOM") }}</div>

<p>History.length是一个只读属性，返回当前session中的history个数，包含当前页面在内。举个例子，对于新开一个tab加载的页面当前属性返回值1。</p>
<p>History.length 是一个只读属性，返回当前 session 中的 history 个数，包含当前页面在内。举个例子，对于新开一个 tab 加载的页面当前属性返回值 1。</p>

<p> </p>

Expand All @@ -18,7 +18,7 @@ <h2 id="语法">语法</h2>

<h2 id="例子">例子</h2>

<pre class="brush: js">var result = window.history.length; // 返回当前session中的history个数</pre>
<pre class="brush: js">var result = window.history.length; // 返回当前 session 中的 history 个数</pre>

<h2 id="说明">说明</h2>

Expand Down
14 changes: 7 additions & 7 deletions files/zh-cn/web/api/history/pushstate/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,25 +24,25 @@ <h3 id="参数">参数</h3>

<dl>
<dt><code>state</code></dt>
<dd>状态对象是一个JavaScript对象，它与<code>pushState()</code>创建的新历史记录条目相关联。 每当用户导航到新状态时，都会触发{{event("popstate")}}事件，并且该事件的状态属性包含历史记录条目的状态对象的副本。</dd>
<dd>状态对象可以是任何可以序列化的对象。 因为Firefox将状态对象保存到用户的磁盘上，以便用户重新启动浏览器后可以将其还原，所以我们对状态对象的序列化表示施加了2MiB的大小限制。 如果将序列化表示形式大于此状态的状态对象传递给<code>pushState()</code>，则该方法将引发异常。 如果您需要更多空间，建议您使用 {{domxref("Window.sessionStorage", "sessionStorage")}}或者{{domxref("Window.localStorage", "localStorage")}}。</dd>
<dd>状态对象是一个 JavaScript 对象，它与<code>pushState()</code>创建的新历史记录条目相关联。 每当用户导航到新状态时，都会触发{{event("popstate")}}事件，并且该事件的状态属性包含历史记录条目的状态对象的副本。</dd>
<dd>状态对象可以是任何可以序列化的对象。 因为 Firefox 将状态对象保存到用户的磁盘上，以便用户重新启动浏览器后可以将其还原，所以我们对状态对象的序列化表示施加了 2MiB 的大小限制。 如果将序列化表示形式大于此状态的状态对象传递给<code>pushState()</code>，则该方法将引发异常。 如果您需要更多空间，建议您使用 {{domxref("Window.sessionStorage", "sessionStorage")}}或者{{domxref("Window.localStorage", "localStorage")}}。</dd>
<dt><code>title</code></dt>
<dd><a href="https://github.com/whatwg/html/issues/2174">当前大多数浏览器都忽略此参数</a>，尽管将来可能会使用它。 在此处传递空字符串应该可以防止将来对方法的更改。 或者，您可以为要移动的状态传递简短的标题。</dd>
<dt><code>url</code> {{optional_inline}}</dt>
<dd>新历史记录条目的URL由此参数指定。 请注意，浏览器不会在调用<code>pushState() </code>之后尝试加载此URL，但可能会稍后尝试加载URL，例如在用户重新启动浏览器之后。 新的URL不必是绝对的。 如果是相对的，则相对于当前URL进行解析。 新网址必须与当前网址相同 {{glossary("origin")}}； 否则，<code>pushState()</code>将引发异常。 如果未指定此参数，则将其设置为文档的当前URL。</dd>
<dd>新历史记录条目的 URL 由此参数指定。 请注意，浏览器不会在调用<code>pushState() </code>之后尝试加载此 URL，但可能会稍后尝试加载 URL，例如在用户重新启动浏览器之后。 新的 URL 不必是绝对的。 如果是相对的，则相对于当前 URL 进行解析。 新网址必须与当前网址相同 {{glossary("origin")}}； 否则，<code>pushState()</code>将引发异常。 如果未指定此参数，则将其设置为文档的当前 URL。</dd>
</dl>

<h2 id="描述">描述</h2>

<p>从某种程度来说, 调用 <code>pushState()</code> 和 <code>window.location = "#foo"</code>基本上一样, 他们都会在当前的document中创建和激活一个新的历史记录。但是 <code>pushState()</code> 有以下优势：</p>
<p>从某种程度来说，调用 <code>pushState()</code> 和 <code>window.location = "#foo"</code>基本上一样，他们都会在当前的 document 中创建和激活一个新的历史记录。但是 <code>pushState()</code> 有以下优势：</p>

<ul>
<li>新的URL可以是任何和当前URL同源的URL。但是设置 {{domxref("window.location")}} 只会在你只设置锚的时候才会使当前的URL。</li>
<li>非强制修改URL。相反，设置 <code>window.location = "#foo";</code> 仅仅会在锚的值不是#foo情况下创建一条新的历史记录。</li>
<li>新的 URL 可以是任何和当前 URL 同源的 URL。但是设置 {{domxref("window.location")}} 只会在你只设置锚的时候才会使当前的 URL。</li>
<li>非强制修改 URL。相反，设置 <code>window.location = "#foo";</code> 仅仅会在锚的值不是#foo 情况下创建一条新的历史记录。</li>
huacnlee marked this conversation as resolved.
Show resolved Hide resolved
<li>可以在新的历史记录中关联任何数据。<code>window.location = "#foo"</code>形式的操作，你只可以将所需数据写入锚的字符串中。</li>
</ul>

<p>注意： <code>pushState()</code> 不会造成 {{event("hashchange")}} 事件调用, 即使新的URL和之前的URL只是锚的数据不同。</p>
<p>注意： <code>pushState()</code> 不会造成 {{event("hashchange")}} 事件调用，即使新的 URL 和之前的 URL 只是锚的数据不同。</p>

<h2 id="示例">示例</h2>

Expand Down
16 changes: 8 additions & 8 deletions files/zh-cn/web/api/history/replacestate/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
---
<p>{{APIRef("DOM")}}</p>

<p><code>replaceState()</code>方法使用<code>state objects</code>, <code>title</code>,和 <code>URL</code> 作为参数， 修改当前历史记录实体，如果你想更新当前的state对象或者当前历史实体的URL来响应用户的的动作的话这个方法将会非常有用。</p>
<p><code>replaceState()</code>方法使用<code>state objects</code>, <code>title</code>,和 <code>URL</code> 作为参数， 修改当前历史记录实体，如果你想更新当前的 state 对象或者当前历史实体的 URL 来响应用户的的动作的话这个方法将会非常有用。</p>

<h2 id="语法">语法</h2>

Expand All @@ -15,27 +15,27 @@ <h3 id="参数">参数</h3>

<dl>
<dt>stateObj</dt>
<dd>状态对象是一个JavaScript对象，它与传递给 <code>replaceState</code> 方法的历史记录实体相关联.</dd>
<dd>状态对象是一个 JavaScript 对象，它与传递给 <code>replaceState</code> 方法的历史记录实体相关联。</dd>
<dt>title</dt>
<dd><a href="https://github.com/whatwg/html/issues/2174">大部分浏览器忽略这个参数</a>, 将来可能有用. 在此处传递空字符串应该可以防止将来对方法的更改。或者，您可以为该状态传递简短标题</dd>
<dd><a href="https://github.com/whatwg/html/issues/2174">大部分浏览器忽略这个参数</a>, 将来可能有用。在此处传递空字符串应该可以防止将来对方法的更改。或者，您可以为该状态传递简短标题</dd>
<dt>url {{optional_inline}}</dt>
<dd>历史记录实体的URL. 新的URL跟当前的URL必须是同源; 否则 replaceState 抛出一个异常.</dd>
<dd>历史记录实体的 URL. 新的 URL 跟当前的 URL 必须是同源; 否则 replaceState 抛出一个异常。</dd>
</dl>

<h2 id="例子">例子</h2>

<p>假设 http://mozilla.org/foo.html 执行下面的 JavaScript 代码:</p>
<p>假设 http://mozilla.org/foo.html 执行下面的 JavaScript 代码：</p>

<pre class="brush: js line-numbers language-js"><code class="language-js">var stateObj = { foo: "bar" };
history.pushState(stateObj, "", "bar.html");</code></pre>

<p>上面这两行的解释可以在 "Example of pushState() method"这个章节找到。然后假设 http://mozilla.org/bar.html  执行下面的 JavaScript 代码:</p>
<p>上面这两行的解释可以在 "Example of pushState() method"这个章节找到。然后假设 http://mozilla.org/bar.html  执行下面的 JavaScript 代码：</p>

<pre class="brush: js line-numbers language-js"><code class="language-js">history.replaceState(stateObj, "", "bar2.html");</code></pre>

<p>这会让URL栏显示 http://mozilla.org/bar2.html, 但是不会加载 <code>bar2.html</code> 页面，甚至不会检查bar2.html 是否存在</p>
<p>这会让 URL 栏显示 http://mozilla.org/bar2.html，但是不会加载 <code>bar2.html</code> 页面，甚至不会检查 bar2.html 是否存在</p>

<p>假设用户跳转到 http://www.microsoft.com, 然后点击返回按钮.这时, URL 栏将会显示 http://mozilla.org/bar2.html 页面. 如果用户此时点击返回按钮, URL栏将会显示 http://mozilla.org/foo.html 页面, 最终绕过了 bar.html 页面.</p>
<p>假设用户跳转到 http://www.microsoft.com，然后点击返回按钮。这时，URL 栏将会显示 http://mozilla.org/bar2.html 页面。如果用户此时点击返回按钮，URL 栏将会显示 http://mozilla.org/foo.html 页面，最终绕过了 bar.html 页面。</p>

<h2 id="说明">说明</h2>

Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/history/scrollrestoration/index.html
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@



<p>{DOMxRef("History"))的接口——<strong><code>滚动恢复属性</code></strong>允许web应用程序在历史导航上显式地设置默认滚动恢复行为</p>
<p>{DOMxRef("History")) 的接口——<strong><code>滚动恢复属性</code></strong>允许 web 应用程序在历史导航上显式地设置默认滚动恢复行为</p>
huacnlee marked this conversation as resolved.
Show resolved Hide resolved

<h2 id="语法">语法</h2>

Expand Down