This version of the documentation is under development!
Click here for the latest released version.
localStorage
提供对 W3C Web 存储介面的访问
var permanentStorage = window.localStorage;
var tempStorage = window.sessionStorage;
方法
键: 返回在指定的位置的键的名称。
getItem: 返回由指定的键标识的项。
setItem: 分配一个键控的项值。
removeItem: 删除标识由指定键的项。
清除: 中移除所有键/值对。
详细资讯
window.localStorage
介面实现,W3C Web 存储介面。 应用程式可以使用它来保存永久资料使用键-值对。 window.sessionStorage
介面在每个方面,除了,所有资料都被都清除应用程式关闭每次的工作方式相同。 每个资料库提供了单独的命名空间。
支援的平台
- Android 系统
- 黑莓手机 WebWorks (OS 6.0 和更高)
- iOS
- Tizen
- Windows Phone 7 和 8
键快速示例
var keyName = window.localStorage.key(0);
设置的专案的快速示例
window.localStorage.setItem("key", "value");
获取专案的快速示例
var value = window.localStorage.getItem("key");
// value is now equal to "value"
删除专案快速示例
window.localStorage.removeItem("key");
清除快速示例
window.localStorage.clear();
完整的示例
<!DOCTYPE html>
<html>
<head>
<title>Storage Example</title>
<script type="text/javascript" charset="utf-8" src="cordova.js"></script>
<script type="text/javascript" charset="utf-8">
// Wait for device API libraries to load
//
document.addEventListener("deviceready", onDeviceReady, false);
// device APIs are available
//
function onDeviceReady() {
window.localStorage.setItem("key", "value");
var keyname = window.localStorage.key(i);
// keyname is now equal to "key"
var value = window.localStorage.getItem("key");
// value is now equal to "value"
window.localStorage.removeItem("key");
window.localStorage.setItem("key2", "value2");
window.localStorage.clear();
// localStorage is now empty
}
</script>
</head>
<body>
<h1>Example</h1>
<p>localStorage</p>
</body>
</html>
Windows Phone 7 的怪癖
点标记法是没有可用的 Windows Phone 7。 一定要使用 setItem
或 getItem
,而不是直接从存储物件,如便捷键window.localStorage.someKey
.