aboutsummaryrefslogtreecommitdiff
path: root/files/zh-cn/web/api/storageevent/index.html
diff options
context:
space:
mode:
authorPeter Bengtsson <mail@peterbe.com>2020-12-08 14:40:17 -0500
committerPeter Bengtsson <mail@peterbe.com>2020-12-08 14:40:17 -0500
commit33058f2b292b3a581333bdfb21b8f671898c5060 (patch)
tree51c3e392513ec574331b2d3f85c394445ea803c6 /files/zh-cn/web/api/storageevent/index.html
parent8b66d724f7caf0157093fb09cfec8fbd0c6ad50a (diff)
downloadtranslated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.gz
translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.bz2
translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.zip
initial commit
Diffstat (limited to 'files/zh-cn/web/api/storageevent/index.html')
-rw-r--r--files/zh-cn/web/api/storageevent/index.html114
1 files changed, 114 insertions, 0 deletions
diff --git a/files/zh-cn/web/api/storageevent/index.html b/files/zh-cn/web/api/storageevent/index.html
new file mode 100644
index 0000000000..eceb17bb94
--- /dev/null
+++ b/files/zh-cn/web/api/storageevent/index.html
@@ -0,0 +1,114 @@
+---
+title: StorageEvent
+slug: Web/API/StorageEvent
+tags:
+ - 本地存储
+translation_of: Web/API/StorageEvent
+---
+<p>{{APIRef("Web Storage API")}}</p>
+
+<p>当前页面使用的storage被其他页面修改时会触发StorageEvent事件. </p>
+
+<p>[译者:事件在同一个域下的不同页面之间触发,即在A页面注册了storge的监听处理,只有在跟A同域名下的B页面操作storage对象,A页面才会被触发storage事件] </p>
+
+<p>{{InheritanceDiagram}}</p>
+
+<div class="note">
+<p><strong>Note:</strong> 尽管这个事件已经早在 {{ Gecko("2.0") }}时就已存在,但是并不符合规范. 老的事件模型直到 {{ interface("nsIDOMStorageEventObsolete") }} 确定才被表现出来.</p>
+</div>
+
+<h2 id="方法描述">方法描述</h2>
+
+<pre><code>void initStorageEvent(
+ in DOMString typeArg,
+ in boolean canBubbleArg,
+ in boolean cancelableArg,
+ in DOMString keyArg,
+ in DOMString oldValueArg,
+ in DOMString newValueArg,
+ in DOMString urlArg,
+ in nsIDOMStorage storageAreaArg
+);</code>
+</pre>
+
+<h2 id="Method_overview" name="Method_overview">属性</h2>
+
+<table class="standard-table">
+ <tbody>
+ <tr>
+ <td class="header">属性名</td>
+ <td class="header">类型</td>
+ <td class="header">描述</td>
+ </tr>
+ <tr>
+ <td><code>key</code></td>
+ <td><code><a href="/en/DOMString" title="en/DOMString">DOMString</a></code></td>
+ <td>该属性代表被修改的键值。当被<font face="consolas, Liberation Mono, courier, monospace"><span style="background-color: rgba(220, 220, 220, 0.5);">clear()</span></font>方法清除之后该属性值为<font face="consolas, Liberation Mono, courier, monospace"><span style="background-color: rgba(220, 220, 220, 0.5);">null</span></font>。<strong>(只读)</strong></td>
+ </tr>
+ <tr>
+ <td><code>newValue</code></td>
+ <td><code><a href="/en/DOMString" title="en/DOMString">DOMString</a></code></td>
+ <td>该属性代表修改后的新值。当被<font face="consolas, Liberation Mono, courier, monospace"><span style="background-color: rgba(220, 220, 220, 0.5);">clear()</span></font>方法清理后或者该键值对被移除,<code>newValue</code> 的值为 <code>null</code> 。<strong>(只读)</strong></td>
+ </tr>
+ <tr>
+ <td><code>oldValue</code></td>
+ <td><code><a href="/en/DOMString" title="en/DOMString">DOMString</a></code></td>
+ <td>该属性代表修改前的原值。在设置新键值对时由于没有原始值,该属性值为 <code>null</code>。<strong>(只读)</strong></td>
+ </tr>
+ <tr>
+ <td><code>storageArea</code></td>
+ <td><code>{{ Interface("nsIDOMStorage") }}</code></td>
+ <td>被操作的storage对象。<strong>(只读)</strong></td>
+ </tr>
+ <tr>
+ <td><code>url</code></td>
+ <td><code><a href="/en/DOMString" title="en/DOMString">DOMString</a></code></td>
+ <td>
+ <p><font face="consolas, Liberation Mono, courier, monospace"><span style="background-color: rgba(220, 220, 220, 0.5);">key</span></font> 发生改变的对象所在文档的URL地址。<strong>(只读)</strong></p>
+ </td>
+ </tr>
+ </tbody>
+</table>
+
+<h2 id="Methods" name="Methods">方法</h2>
+
+<h3 id="initStorageEvent()" name="initStorageEvent()">initStorageEvent()</h3>
+
+<p>类似DOM中的初始化事件,即初始化新创建的Storage对象的属性。</p>
+
+<pre class="eval" dir="rtl">void initStorageEvent(
+ in DOMString typeArg,
+ in boolean canBubbleArg,
+ in boolean cancelableArg,
+ in DOMString keyArg,
+ in DOMString oldValueArg,
+ in DOMString newValueArg,
+ in DOMString urlArg,
+ in nsIDOMStorage storageAreaArg
+);</pre>
+
+<dl>
+ <dt>参数:</dt>
+ <dt><code>typeArg</code></dt>
+ <dd>事件名</dd>
+ <dt><code>canBubbleArg</code></dt>
+ <dd>布尔值,代表是否可以通过dom冒泡</dd>
+ <dt><code>cancelableArg</code></dt>
+ <dd>布尔值,代表是否可以注销事件</dd>
+ <dt><code>keyArg</code></dt>
+ <dd>事件结果时被改变的值对应的属性名称</dd>
+ <dt><code>oldValueArg</code></dt>
+ <dd>旧值</dd>
+ <dt><code>newValueArg</code></dt>
+ <dd>新值</dd>
+ <dt><code>urlArg</code></dt>
+ <dd>事件初始化时页面的url</dd>
+ <dt><code>storageAreaArg</code></dt>
+ <dd> 发生在哪个storage对象上</dd>
+</dl>
+
+<h2 id="See_also" name="See_also">参阅</h2>
+
+<ul>
+ <li> <a class="external" href="http://dev.w3.org/html5/webstorage/#the-storage-event" title="http://dev.w3.org/html5/webstorage/#the-storage-event">Specification</a></li>
+</ul>