HarmonyOS开发之LocalStorage

LocalStorage是页面级的UI状态存储,页面组件(组件树根节点)获取LocalStorage是通过@Entry装饰器接收的参数传入,子组件自动获取LocalStorage的访问权限,获取的也是通过@Entry传入的LocalStorage。页面内共享同一个LocalStorage实例。支持一个UIAbility内多个页面间共享一个LocalStorage。getShared仅能获取当前Stage通过UIAbility中windonStage.loadcontent传入的LocalStorage

不与自定义组件进行关联的使用场景:

LocalStorage若是想要跟自定义组件建立联系,需要使用装饰器:@LocalStorageProp和@LocalStorageLink

一、@LocalStorageProp:此装饰器装饰的变量与LocalStorage中key对应的属性建立单向同步关系

示例:@LocalStorageProp(key) name:string = ‘’;

装饰的变量需要初始化,因为此key(常量字符串)可能没值。另外不能通过父组件传值赋值,只能通过LocalStorage中的key初始化,若没有对应key,用默认值初始化,并将值存入LocalStorage中,注意:此时是存入,不是同步。

支持初始化子节点,可用于初始化子节点的@State 、@Prop、@Link、@Provide状态变量

只能在组件内访问,不支持在组件外部访问

同步类型:数据单向同步。

框架行为:

1、被@LocalStorageProp装饰的变量值改变时,不会同步会回LocalStorage中,但会驱动对应的UI组件刷新渲染.

2、若是LocalStorage(key)的值发生改变,那么所有@LocalStorageProp(key)装饰的变量都会发生改变,并且覆盖其本地的改变。

示例1:

示例1

示例1中:

1、点击name1,name1值改为‘value change’,驱动name1显示内容改变,不会同步给LocalStorage,所以name2显示内容不变。

2、点击name2,会改变LocalStorage中name对应的值,单向同步给name1。改为'keke'

二、@LocalStorageLink:此装饰器装饰的变量与LocalStorage中key对应的属性建立双向同步关系

示例:@LocalStorageLink(key)  age:number:= 11;

装饰的变量需要初始化,因为此key可能没值。同样不能通过父组件传值赋值,只能通过LocalStorage中的key初始化。若没有对应的key,用默认值初始化,并存入LocalStorage中。

支持初始化子节点,可用于初始化子节点的@State、@Prop、@Link、@Provide状态变量

同样只能在组件内访问,不支持在组件外部访问

@LocalStorageLink(key)和LocalStorage中key对应的值会建立数据双向同步。

本地变量age改变,会把值同步回LocalStorage中key对应的值,同样LocalStorage中key对应的值改变,也会把值同步到本地变量age。即:把age的新值同步回LocalStorage中key对应的值,同样LocalStorage中key对应的值发生改变,本地变量age的值也发生同步改变。

同步类型:双向同步。

框架行为:

当@LocalStorageLink(key)装饰的的变量发生改变时,会把修改的结果值同步回LocalStorage中key对应的属性值。

当LocalStorage中的key对应的属性值发生改变时,会把改变的结果值同步到所有key绑定的数据上面(包括LocalStorageLink(key)和LocalStorageProp装饰的变量。

当@LocalStorageLink(key)装饰的变量发生该改变时,在同步数据回LocalStorage中的同时,还会驱动与其绑定的UI组件进行刷新渲染

示例2:

示例2中:

1、点击name1,name1值改为‘value change’,驱动name1显示内容改变,同时会同步给LocalStorage,所以name2显示内容对应的不是状态变量,所以显示内容不会改变,但LocalStorage的值改变会同步给所有绑定了对应key的数据,所以name3也会改变,并驱动name3的UI刷新渲染。

2、点击name2,会改变LocalStorage中name对应的值,会同步给name1和name3。均改为'keke',同时驱动name1和name3组件UI重新渲染

示例代码3:若LocaStorage中没有对应的key,用默认值初始化,并将值存入LocalStorage中,下次通过key取的值是LocalStorage中的值,而不是新的默认值

下面示例3是针对初始值而言:

示例 3

示例3中,因为一开始LocalStorage中没有name键, value1在使用默认值123初始化的时候,也把值存到了存到LocalStorage中name对应的属性值上面,所以当value2是优先用LocalStorage中name对应的值来初始化的,所以还是123。用@LocalStorageLink('name')同样如此。


Ability内多个页面共享的示例如下:

1、在当前Ability中的windowStage.loadConent传入LocalStorage

来源

2、在组件入口处通过getShare获取,并通过@Entry传入

取值
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 215,294评论 6 497
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,780评论 3 391
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 161,001评论 0 351
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,593评论 1 289
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,687评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,679评论 1 294
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,667评论 3 415
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,426评论 0 270
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,872评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,180评论 2 331
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,346评论 1 345
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,019评论 5 340
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,658评论 3 323
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,268评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,495评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,275评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,207评论 2 352

推荐阅读更多精彩内容