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 @@ 浏览器兼容
其他
- - {{domxref("Window.history")}} 返回当前会话的history状态
+ - {{domxref("Window.history")}} 返回当前会话的 history 状态
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()
有以下优势:
- - 新的URL可以是任何和当前URL同源的URL。但是设置 {{domxref("window.location")}} 只会在你只设置锚的时候才会使当前的URL。
- - 非强制修改URL。相反,设置
window.location = "#foo";
仅仅会在锚的值不是#foo情况下创建一条新的历史记录。
+ - 新的 URL 可以是任何和当前 URL 同源的 URL。但是设置 {{domxref("window.location")}} 只会在你只设置锚的时候才会使当前的 URL。
+ - 非强制修改 URL。相反,设置
window.location = "#foo";
仅仅会在锚的值不是 #foo 情况下创建一条新的历史记录。
- 可以在新的历史记录中关联任何数据。
window.location = "#foo"
形式的操作,你只可以将所需数据写入锚的字符串中。
-注意: 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 应用程序在历史导航上显式地设置默认滚动恢复行为
语法