在模块化清晰、单向访问的场景,可以通过export将组件中创建的Storage实例导出,在其他组件用import导入,即可使其他组件直接访问Storage对象,并且可以通过应用逻辑方式修改数据,这种方法简单易用并且在性能上相比于使用@LocalStorageLink有一定优势,适用于工具箱之类的小型项目。
组件导出Storage:
let para: Record<string, number> = { 'propA': 47 }; const storage: LocalStorage = new LocalStorage(para); export { storage };
其他组件接收Storage实例,并通过应用逻辑方式修改数据。
import { storage } from './LocalStorageFatherOne'; @Entry @Component export struct LocalStorageChildOne { @State link1: SubscribedAbstractProperty<number> = storage.link('propA'); build() { Column() { Text('子组件linkChild:' + JSON.stringify(this.link1.get())) .onClick(() => { this.link1.set(this.link1.get() + 1); }); }.width('100%').height('100%').justifyContent(FlexAlign.Center); } }
可以使用LocalStorage装饰器@LocalStorageLink实现父子组件双向同步,子组件就能实现对LocalStorage实例的访问,能够将状态变量更新同步回LocalStorage中,可以参考官网@LocalStorageLink和LocalStorage双向同步的简单场景。
当父子组件之间需要频繁地交互LocalStorage中的数据时,就可以使用状态变量传递LocalStorage实例,此时子组件只需要接收父组件的实例,可以避免数据混淆,便于数据分类,适用于表单系统等场景。
父组件:
import { LocalStorageChildTwo } from './LocalStorageChildTwo'; // 创建新实例并使用给定对象初始化 let para: Record<string, number> = { 'propA': 47 }; let storage: LocalStorage = new LocalStorage(para); @Entry @Component struct LocalStorageFatherTwo { @State storageFather: LocalStorage = storage; build() { Column({ space: 15 }) { // @Component子组件自动获得对LocalStorage实例的访问权限。 LocalStorageChildTwo({ storageChild: this.storageFather }); }; } }
在需要获取LocalStorage实例的组件中,通过@Link装饰器将storageChild属性链接到父组件的LocalStorage实例,并且使用this.storageChild.link('propA')将link1状态链接到LocalStorage中名为propA的属性。为Text组件添加onClick事件处理程序,在每次点击时,都将更新link1的值,实现状态的共享和更新。
子组件:
@Component export struct LocalStorageChildTwo { @Link storageChild: LocalStorage; @State link1: SubscribedAbstractProperty<number> = this.storageChild.link('propA'); build() { Column() { Text('子组件linkChild:' + JSON.stringify(this.link1.get())) .onClick(() => { this.link1.set(this.link1.get() + 1); }); }.width('100%').height('100%').justifyContent(FlexAlign.Center); } }
Q:LocalStorage实例在文件根目录进行初始化,其生命周期会跟随页面的生命周期吗?
A:LocalStorage对象的生命周期由应用程序决定,当应用释放最后一个指向LocalStorage的引用时才会被JS Engine垃圾回收。
Q:子组件可以通过LocalStorage.getShared()方法获取LocalStorage实例吗?
A:未被@Entry装饰的组件不可被独立分配LocalStorage实例,只能接受父组件通过@Entry传递来的LocalStorage实例,子组件实例自动获得对该LocalStorage实例的访问权限。LocalStorage.getShared只能在父组件才能获取到数据。
Q:在主页面中调用loadContent传递LocalStorage实例,为什么在其他页面中通过LocalStorage.getShared()获取的值是undefined?
A:LocalStorage是页面级存储,getShared()接口仅能获取当前Stage通过windowStage.loadContent传入的LocalStorage实例,否则返回undefined,可以参考LocalStorage使用的限制条件和示例将LocalStorage实例从UIAbility共享到一个或多个页面。