diff options
Diffstat (limited to 'files/zh-tw/web/api/window/localstorage/index.html')
-rw-r--r-- | files/zh-tw/web/api/window/localstorage/index.html | 82 |
1 files changed, 82 insertions, 0 deletions
diff --git a/files/zh-tw/web/api/window/localstorage/index.html b/files/zh-tw/web/api/window/localstorage/index.html new file mode 100644 index 0000000000..1733a325bd --- /dev/null +++ b/files/zh-tw/web/api/window/localstorage/index.html @@ -0,0 +1,82 @@ +--- +title: Window.localStorage +slug: Web/API/Window/localStorage +translation_of: Web/API/Window/localStorage +--- +<p>{{APIRef("Web Storage API")}}</p> + +<p><span class="seoSummary"><strong><code>localStorage</code></strong> 為一唯讀屬性, 此屬性允許您存取目前文件({{DOMxRef("Document")}})隸屬網域來源的 {{DOMxRef("Storage")}} 物件; 與 sessionStorage 不同的是其儲存資料的可存取範圍為跨瀏覽頁狀態(Browser Sessions).</span> <code>localStorage</code> 的應用與 {{DOMxRef("Window.sessionStorage", "sessionStorage")}} 相似, 除了 <code>localStorage</code> 的儲存資料並無到期的限制, 而 <code>sessionStorage</code> 的儲存資料於目前瀏覽頁狀態結束的同時將一併被清除 — 也就是目前瀏覽器頁面被關閉的同時.</p> + +<p>值得注意的是不論 <code>localStorage</code> 或者 <code>sessionStorage</code> <strong>皆為專屬於目前瀏覽器頁面的通訊協定(Protocol)</strong>.</p> + +<p>鍵值名稱和值皆為<strong>字串型式</strong>(請留意, 當其為物件, 整數等將自動轉換為字串型式).</p> + +<h2 id="Syntax">Syntax</h2> + +<pre class="syntaxbox"><em>myStorage</em> = <em>window</em>.localStorage;</pre> + +<h3 id="Value">Value</h3> + +<p>{{DOMxRef("Storage")}} 物件 which can be used to access the current origin's local storage space.</p> + +<h3 id="Exceptions">Exceptions</h3> + +<dl> + <dt><code>SecurityError</code></dt> + <dd>The request violates a policy decision, or the origin is not <a href="/en-US/docs/Web/Security/Same-origin_policy#Definition_of_an_origin">a valid scheme/host/port tuple</a> (this can happen if the origin uses the <code>file:</code> or <code>data:</code> scheme, for example). 舉例來說,使用者 may have their browser configured to deny permission to persist data for the specified origin.</dd> +</dl> + +<h2 id="Example">Example</h2> + +<p>下列的程式碼片段讀取了目前域名內的 local {{DOMxRef("Storage")}} 物件 ,並用{{DOMxRef("Storage.setItem()")}},增加一個資料物件 item 到其中</p> + +<pre class="brush: js">localStorage.setItem('myCat', 'Tom');</pre> + +<p>讀取 <code>localStorage</code> 內物件的語法如下:</p> + +<pre class="brush: js">var cat = localStorage.getItem('myCat');</pre> + +<p>移除 <code>localStorage</code> 內物件的語法如下:</p> + +<pre class="brush: js">localStorage.removeItem('myCat');</pre> + +<p>刪除 <code>localStorage</code> 內所有物件的語法如下:</p> + +<pre class="brush: js">// Clear all items +localStorage.clear(); +</pre> + +<div class="note"> +<p><strong>Note</strong>: Please refer to the <a href="/en-US/docs/Web/API/Web_Storage_API/Using_the_Web_Storage_API">Using the Web Storage API</a> article for a full example.</p> +</div> + +<h2 id="Specifications">Specifications</h2> + +<table class="standard-table"> + <tbody> + <tr> + <th scope="col">Specification</th> + <th scope="col">Status</th> + <th scope="col">Comment</th> + </tr> + <tr> + <td>{{SpecName("HTML WHATWG", "webstorage.html#dom-localstorage", "localStorage")}}</td> + <td>{{Spec2("HTML WHATWG")}}</td> + <td></td> + </tr> + </tbody> +</table> + +<h2 id="瀏覽器相容性">瀏覽器相容性</h2> + + + +<p>{{Compat("api.Window.localStorage")}}</p> + +<h2 id="See_also">See also</h2> + +<ul> + <li><a href="/en-US/docs/Web/API/Web_Storage_API/Using_the_Web_Storage_API">Using the Web Storage API</a></li> + <li><a href="/en-US/docs/Web/API/Web_Storage_API/Local_storage">Local storage with Window.localStorage</a></li> + <li><span>{{DOMxRef("Window.sessionStorage")}}</span></li> +</ul> |