diff --git a/files/zh-cn/web/api/history/forward/index.html b/files/zh-cn/web/api/history/forward/index.html index 9062336852e3bf..53b95b2aebd0e9 100644 --- a/files/zh-cn/web/api/history/forward/index.html +++ b/files/zh-cn/web/api/history/forward/index.html @@ -7,7 +7,7 @@ - History translation_of: Web/API/History/forward --- -

在会话历史中向前移动一页。它与使用delta参数为1时调用 history.go(delta)的效果相同。

+

在会话历史中向前移动一页。它与使用delta参数为 1 时调用 history.go(delta)的效果相同。

语法

diff --git a/files/zh-cn/web/api/history/go/index.html b/files/zh-cn/web/api/history/go/index.html index 6ceb25be8c67f6..bf8fa55338c0fb 100644 --- a/files/zh-cn/web/api/history/go/index.html +++ b/files/zh-cn/web/api/history/go/index.html @@ -15,12 +15,12 @@

参数

delta {{optional_inline}}
-
相对于当前页面你要去往历史页面的位置。负值表示向后移动,正值表示向前移动。因此,例如:history.go(2)向前移动两页,history.go(-2)则向后移动两页。如果未向该函数传参或delta相等于0,则该函数与调用location.reload()具有相同的效果。
+
相对于当前页面你要去往历史页面的位置。负值表示向后移动,正值表示向前移动。因此,例如:history.go(2)向前移动两页,history.go(-2)则向后移动两页。如果未向该函数传参或delta相等于 0,则该函数与调用location.reload()具有相同的效果。

译者注:

-

相等于0是采用宽松相等进行比较的。另外,JavaScript值古怪的隐式转换在这里也是可用的。

+

相等于 0 是采用宽松相等进行比较的。另外,JavaScript 值古怪的隐式转换在这里也是可用的。

diff --git a/files/zh-cn/web/api/history/index.html b/files/zh-cn/web/api/history/index.html index ff06201536171c..261a7e897f1dde 100644 --- a/files/zh-cn/web/api/history/index.html +++ b/files/zh-cn/web/api/history/index.html @@ -13,35 +13,35 @@

属性

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

方法

-

History接口不继承任何方法。

+

History 接口不继承任何方法。

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

说明

{{SpecName('HTML WHATWG', "browsers.html#the-history-interface", "History")}} {{Spec2('HTML WHATWG')}} -

添加scrollRestoration  属性.

+

添加 scrollRestoration 属性。

@@ -69,7 +69,7 @@

说明

{{SpecName('Custom Scroll Restoration', '#web-idl', "History")}} {{Spec2('Custom Scroll Restoration')}} - 添加scrollRestoration  属性. + 添加 scrollRestoration 属性。 @@ -83,5 +83,5 @@

浏览器兼容

其他

diff --git a/files/zh-cn/web/api/history/length/index.html b/files/zh-cn/web/api/history/length/index.html index bb713e6cb84549..7d7bbbbd6d4d39 100644 --- a/files/zh-cn/web/api/history/length/index.html +++ b/files/zh-cn/web/api/history/length/index.html @@ -5,7 +5,7 @@ ---
{{ APIRef("HTML DOM") }}
-

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

+

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

 

@@ -18,7 +18,7 @@

语法

例子

-
var result = window.history.length; // 返回当前session中的history个数
+
var result = window.history.length; // 返回当前 session 中的 history 个数

说明

diff --git a/files/zh-cn/web/api/history/pushstate/index.html b/files/zh-cn/web/api/history/pushstate/index.html index 7272f3d2ad1e65..66997d23f69ff3 100644 --- a/files/zh-cn/web/api/history/pushstate/index.html +++ b/files/zh-cn/web/api/history/pushstate/index.html @@ -24,25 +24,25 @@

参数

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

描述

-

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

+

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

-

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

+

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

示例

diff --git a/files/zh-cn/web/api/history/replacestate/index.html b/files/zh-cn/web/api/history/replacestate/index.html index 33b2914c7fc4b3..98dccdfed88a2d 100644 --- a/files/zh-cn/web/api/history/replacestate/index.html +++ b/files/zh-cn/web/api/history/replacestate/index.html @@ -5,7 +5,7 @@ ---

{{APIRef("DOM")}}

-

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

+

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

语法

@@ -15,27 +15,27 @@

参数

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

例子

-

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

+

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

var stateObj = { foo: "bar" };
 history.pushState(stateObj, "", "bar.html");
-

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

+

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

history.replaceState(stateObj, "", "bar2.html");
-

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

+

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

-

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

+

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

说明

diff --git a/files/zh-cn/web/api/history/scrollrestoration/index.html b/files/zh-cn/web/api/history/scrollrestoration/index.html index 922e1615c5ea85..92814e33ac82cb 100644 --- a/files/zh-cn/web/api/history/scrollrestoration/index.html +++ b/files/zh-cn/web/api/history/scrollrestoration/index.html @@ -14,7 +14,7 @@ -

{DOMxRef("History"))的接口——滚动恢复属性允许web应用程序在历史导航上显式地设置默认滚动恢复行为

+

{{DOMxRef("History")}} 的接口——滚动恢复属性允许 web 应用程序在历史导航上显式地设置默认滚动恢复行为

语法