UniApp 提供了一套简单易用的本地存储 API,用于在本地持久化地保存键值对数据。这些 API 包括 uni.setStorage、uni.getStorage、uni.removeStorage 和 uni.clearStorage 等,它们支持异步存取本地数据。
uni.setStorage
用于将数据异步保存到本地存储中。
语法:
uni.setStorage({
key: 'key',
data: 'value',
success: function () {
console.log('保存成功');
}
});
- key (String): 存储数据的键名。
- data (Object/String): 存储的数据。
- success (Function): 可选,调用成功的回调函数。
uni.getStorage
用于从本地存储异步获取指定 key 的内容。
语法:
uni.getStorage({
key: 'key',
success: function (res) {
console.log(res.data);
}
});
- key (String): 要获取的数据对应的键名。
- success (Function): 调用成功的回调函数,其参数 res 包含 key 对应的数据。
uni.removeStorage
从本地存储中异步移除指定 key 的数据。
语法:
uni.removeStorage({
key: 'key',
success: function () {
console.log('移除成功');
}
});
- key (String): 要移除的数据对应的键名。
- success (Function): 可选,调用成功的回调函数。
uni.clearStorage
清空所有本地存储的数据。
语法:
uni.clearStorage();
总结
UniApp 的 Storage API 提供了一个方便、轻量级的本地数据存储方案。通过异步的方式,可以有效地在小程序、H5、App等多个平台上使用,方便进行跨平台的数据存储和管理。
以上是 UniApp Storage API 的基本介绍,更多细节和高级用法请参考 UniApp 官方文档。