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.

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/storage*/ #5900

Merged
merged 1 commit into from
Jun 3, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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/storage/removeitem/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
---
<p>{{APIRef("Web Storage API")}}</p>

<p>{{domxref("Storage")}} 接口的 <code>removeItem()</code> 方法,接受一个键名作为参数,会从给定的Storage对象中删除该键名(如果存在)。 如果没有与该给定键名匹配的项,则此方法将不执行任何操作。</p>
<p>{{domxref("Storage")}} 接口的 <code>removeItem()</code> 方法,接受一个键名作为参数,会从给定的 Storage 对象中删除该键名(如果存在)。 如果没有与该给定键名匹配的项,则此方法将不执行任何操作。</p>

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

Expand Down
6 changes: 3 additions & 3 deletions files/zh-cn/web/api/storage_api/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@

<h2 id="站点存储单元">站点存储单元</h2>

<p>由存储标准描述并使用存储API进行交互的站点存储系统,由每个 {{Glossary("origin")}} 的单个<strong>站点存储单元</strong>(<strong>site storage unit</strong>)组成。实际上,每个Web站点或Web应用程序都有自己的存储单元,用于存储数据。下图显示了一个站点存储池,其中包含三个存储单元,显示了存储单元如何可以在其中存储不同的数据类型,并且可能具有不同的配额(最大存储限制)。</p>
<p>由存储标准描述并使用存储 API 进行交互的站点存储系统,由每个 {{Glossary("origin")}} 的单个<strong>站点存储单元</strong>(<strong>site storage unit</strong>)组成。实际上,每个 Web 站点或 Web 应用程序都有自己的存储单元,用于存储数据。下图显示了一个站点存储池,其中包含三个存储单元,显示了存储单元如何可以在其中存储不同的数据类型,并且可能具有不同的配额(最大存储限制)。</p>

<p><img alt="A diagram showing how the site storage pool consists of multiple storage units that contain data from various APIs as well as possible unused space left before the quota is reached." src="https://mdn.mozillademos.org/files/14379/StorageUnits.png" style="height: 412px; width: 600px;"></p>

Expand All @@ -59,13 +59,13 @@ <h2 id="存储模式">存储模式</h2>

<h2 id="数据持久性与清理">数据持久性与清理</h2>

<p>如果站点或应用程序具有 “<strong>永久存储(<code>persistent-storage</code>)</strong>” 功能权限,则可以使用 {{domxref("StorageManager.persist()")}} 方法来请求将其 box 设为持久的。由于使用特性或其他度量,用户代理还可以决定使站点的存储单元持久化。“持久存储”功能的与权限相关的标志、算法和类型都设置为权限的标准默认值,只是整个源位置的权限状态必须相同,并且如果未“授予”权限状态(无论出于何种原因,访问持久性存储功能被拒绝),源站点存储单元的box模式总是“尽力”。</p>
<p>如果站点或应用程序具有 “<strong>永久存储(<code>persistent-storage</code>)</strong>” 功能权限,则可以使用 {{domxref("StorageManager.persist()")}} 方法来请求将其 box 设为持久的。由于使用特性或其他度量,用户代理还可以决定使站点的存储单元持久化。“持久存储”功能的与权限相关的标志、算法和类型都设置为权限的标准默认值,只是整个源位置的权限状态必须相同,并且如果未“授予”权限状态(无论出于何种原因,访问持久性存储功能被拒绝),源站点存储单元的 box 模式总是“尽力”。</p>

<div class="note">
<p><strong>注意</strong>:请参考 <a href="/en-US/docs/Web/API/Permissions_API/Using_the_Permissions_API">使用 Permissions API</a> 以了解更多关于申请与管理权限的信息。</p>
</div>

<p>当清除站点存储单元时,源站的框被视为单个实体;如果用户代理需要清除它并且用户批准,则清除整个数据存储,而不是提供某种仅从单个api清除数据的方法。</p>
<p>当清除站点存储单元时,源站的框被视为单个实体;如果用户代理需要清除它并且用户批准,则清除整个数据存储,而不是提供某种仅从单个 api 清除数据的方法。</p>

<p><br>
如果一个框被标记为 “持久(<code>persistent</code>)” ,那么如果没有数据的源代码本身或用户明确地这样做,用户代理将不会清除内容。这包括用户选择“清除缓存”或“清除最近的历史记录”选项等场景。将特别要求用户具有删除永久性站点存储单元的权限。</p>
Expand Down
22 changes: 11 additions & 11 deletions files/zh-cn/web/api/storageevent/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -7,14 +7,14 @@
---
<p>{{APIRef("Web Storage API")}}</p>

<p>当前页面使用的storage被其他页面修改时会触发StorageEvent事件. </p>
<p>当前页面使用的 storage 被其他页面修改时会触发 StorageEvent 事件. </p>

<p>[译者:事件在同一个域下的不同页面之间触发,即在A页面注册了storge的监听处理,只有在跟A同域名下的B页面操作storage对象,A页面才会被触发storage事件] </p>
<p>[译者:事件在同一个域下的不同页面之间触发,即在 A 页面注册了 storge 的监听处理,只有在跟 A 同域名下的 B 页面操作 storage 对象,A 页面才会被触发 storage 事件] </p>

<p>{{InheritanceDiagram}}</p>

<div class="note">
<p><strong>Note:</strong> 尽管这个事件已经早在 {{ Gecko("2.0") }}时就已存在,但是并不符合规范. 老的事件模型直到 <code>nsIDOMStorageEventObsolete</code> 确定才被表现出来.</p>
<p><strong>Note:</strong> 尽管这个事件已经早在 {{ Gecko("2.0") }}时就已存在但是并不符合规范老的事件模型直到 <code>nsIDOMStorageEventObsolete</code> 确定才被表现出来</p>
</div>

<h2 id="方法描述">方法描述</h2>
Expand Down Expand Up @@ -43,12 +43,12 @@ <h2 id="Method_overview" name="Method_overview">属性</h2>
<tr>
<td><code>key</code></td>
<td><code><a href="/en/DOMString" title="en/DOMString">DOMString</a></code></td>
<td>该属性代表被修改的键值。当被clear()方法清除之后该属性值为null。<strong>(只读)</strong></td>
<td>该属性代表被修改的键值。当被 clear() 方法清除之后该属性值为 null。<strong>(只读)</strong></td>
</tr>
<tr>
<td><code>newValue</code></td>
<td><code><a href="/en/DOMString" title="en/DOMString">DOMString</a></code></td>
<td>该属性代表修改后的新值。当被clear()方法清理后或者该键值对被移除,<code>newValue</code> 的值为 <code>null</code> 。<strong>(只读)</strong></td>
<td>该属性代表修改后的新值。当被 clear() 方法清理后或者该键值对被移除,<code>newValue</code> 的值为 <code>null</code> 。<strong>(只读)</strong></td>
</tr>
<tr>
<td><code>oldValue</code></td>
Expand All @@ -58,13 +58,13 @@ <h2 id="Method_overview" name="Method_overview">属性</h2>
<tr>
<td><code>storageArea</code></td>
<td><code>nsIDOMStorage</code></td>
<td>被操作的storage对象。<strong>(只读)</strong></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>key 发生改变的对象所在文档的URL地址。<strong>(只读)</strong></p>
<p>key 发生改变的对象所在文档的 URL 地址。<strong>(只读)</strong></p>
</td>
</tr>
</tbody>
Expand All @@ -74,7 +74,7 @@ <h2 id="Methods" name="Methods">方法</h2>

<h3 id="initStorageEvent()" name="initStorageEvent()">initStorageEvent()</h3>

<p>类似DOM中的初始化事件,即初始化新创建的Storage对象的属性。</p>
<p>类似 DOM 中的初始化事件,即初始化新创建的 Storage 对象的属性。</p>

<pre class="eval" dir="rtl">void initStorageEvent(
in DOMString typeArg,
Expand All @@ -92,7 +92,7 @@ <h3 id="initStorageEvent()" name="initStorageEvent()">initStorageEvent()</h3>
<dt><code>typeArg</code></dt>
<dd>事件名</dd>
<dt><code>canBubbleArg</code></dt>
<dd>布尔值,代表是否可以通过dom冒泡</dd>
<dd>布尔值,代表是否可以通过 dom 冒泡</dd>
<dt><code>cancelableArg</code></dt>
<dd>布尔值,代表是否可以注销事件</dd>
<dt><code>keyArg</code></dt>
Expand All @@ -102,9 +102,9 @@ <h3 id="initStorageEvent()" name="initStorageEvent()">initStorageEvent()</h3>
<dt><code>newValueArg</code></dt>
<dd>新值</dd>
<dt><code>urlArg</code></dt>
<dd>事件初始化时页面的url</dd>
<dd>事件初始化时页面的 url</dd>
<dt><code>storageAreaArg</code></dt>
<dd> 发生在哪个storage对象上</dd>
<dd> 发生在哪个 storage 对象上</dd>
</dl>

<h2 id="See_also" name="See_also">参阅</h2>
Expand Down
6 changes: 3 additions & 3 deletions files/zh-cn/web/api/storagemanager/estimate/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
---
<p>{{securecontext_header}}{{APIRef("Storage")}}</p>

<p><strong><code>estimate()</code></strong>方法是{{domxref("StorageManager")}}的一个接口,用于估算某一个域名(或一个站点)下Storage Manager的总存储空间和已经使用了的存储空间。此方法为一个异步方法,如果此方法可用,那么其返回一个结果为resolved的{{jsxref("Promise")}}对象。resolved接收的参数是一个带有已使用数据存储空间和总可用总存储空间的{{domxref("StorageEstimate")}}对象。</p>
<p><strong><code>estimate()</code></strong>方法是{{domxref("StorageManager")}}的一个接口,用于估算某一个域名(或一个站点)下 Storage Manager 的总存储空间和已经使用了的存储空间。此方法为一个异步方法,如果此方法可用,那么其返回一个结果为 resolved 的{{jsxref("Promise")}}对象。resolved 接收的参数是一个带有已使用数据存储空间和总可用总存储空间的{{domxref("StorageEstimate")}}对象。</p>

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

Expand All @@ -17,7 +17,7 @@ <h3 id="参数">参数</h3>

<h3 id="返回值">返回值</h3>

<p>{{domxref('StorageEstimate')}}类型的状态为resolved的{{jsxref('Promise')}}</p>
<p>{{domxref('StorageEstimate')}}类型的状态为 resolved 的{{jsxref('Promise')}}</p>

<p>此数据包含了此应用(或域名)可用的存储空间({{domxref("StorageEstimate.quota")}})和目前已经使用了的存储空间({{domxref("StorageEstimate.usage")}})。</p>

Expand All @@ -27,7 +27,7 @@ <h3 id="返回值">返回值</h3>

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

<p>在这个示例中,我们使用estimate()得到目前所使用的存储空间占全部存储空间的百分比。</p>
<p>在这个示例中,我们使用 estimate() 得到目前所使用的存储空间占全部存储空间的百分比。</p>

<h3 id="HTML_内容">HTML 内容</h3>

Expand Down
4 changes: 2 additions & 2 deletions files/zh-cn/web/api/storagemanager/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -13,9 +13,9 @@ <h2 id="方法">方法</h2>
<dt>{{domxref("StorageManager.estimate()")}} {{securecontext_inline}}</dt>
<dd>返回一个{{domxref("StorageEstimate")}}对象,此对象包含为你的域名预留的存储空间总大小和你已经使用的存储空间大小。</dd>
<dt>{{domxref("StorageManager.persist()")}} {{securecontext_inline}}</dt>
<dd>如果您的user agent能够将你域名下的数据持久保存,那么将返回一个状态为resolve的{{jsxref('Promise')}}</dd>
<dd>如果您的 user agent 能够将你域名下的数据持久保存,那么将返回一个状态为 resolve 的{{jsxref('Promise')}}</dd>
<dt>{{domxref("StorageManager.persisted()")}} {{securecontext_inline}}</dt>
<dd>如果您的站点已经被授予可使用数据本地存储的权限,则返回一个状态为resolve的{{jsxref('Promise')}}</dd>
<dd>如果您的站点已经被授予可使用数据本地存储的权限,则返回一个状态为 resolve 的{{jsxref('Promise')}}</dd>
</dl>

<h2 id="规范">规范</h2>
Expand Down
4 changes: 2 additions & 2 deletions files/zh-cn/web/api/storagemanager/persist/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
---
<p>{{securecontext_header}}{{APIRef("Storage")}}{{SeeCompatTable}}</p>

<p><strong><code>persist()</code></strong>方法是{{domxref("StorageManager")}}的一个接口,用于请求本地数据存储的权限,如果被授予权限,则返回一个resolved状态值为<code>true</code>的{{jsxref('Promise')}}对象,否则返回<code>false</code>。</p>
<p><strong><code>persist()</code></strong>方法是{{domxref("StorageManager")}}的一个接口,用于请求本地数据存储的权限,如果被授予权限,则返回一个 resolved 状态值为<code>true</code>的{{jsxref('Promise')}}对象,否则返回<code>false</code>。</p>

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

Expand All @@ -17,7 +17,7 @@ <h3 id="参数">参数</h3>

<h3 id="返回值">返回值</h3>

<p>一个resolved状态,值为{{jsxref('Boolean')}}类型的{{jsxref('Promise')}}对象。</p>
<p>一个 resolved 状态,值为{{jsxref('Boolean')}}类型的{{jsxref('Promise')}}对象。</p>

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

Expand Down
4 changes: 2 additions & 2 deletions files/zh-cn/web/api/storagemanager/persisted/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
---
<p>{{securecontext_header}}{{APIRef("Storage")}}{{SeeCompatTable}}</p>

<p><strong><code>persisted()</code></strong>方法是{{domxref("StorageManager")}}的一个接口,如果盒存储模式(<strong>box mode</strong>)的值为 “<strong>persistent</strong>” 则返回一个resolved状态值为<code>true</code>的{{jsxref('Promise')}}。</p>
<p><strong><code>persisted()</code></strong>方法是{{domxref("StorageManager")}}的一个接口,如果盒存储模式(<strong>box mode</strong>)的值为 “<strong>persistent</strong>” 则返回一个 resolved 状态值为<code>true</code>的{{jsxref('Promise')}}。</p>

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

Expand All @@ -17,7 +17,7 @@ <h3 id="参数">参数</h3>

<h3 id="返回值">返回值</h3>

<p>一个状态为resolved,值为{{jsxref('Boolean')}}类型的{{jsxref('Promise')}}。</p>
<p>一个状态为 resolved,值为{{jsxref('Boolean')}}类型的{{jsxref('Promise')}}。</p>

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

Expand Down