1# 状态管理 2 3### 介绍 4 5本示例通过使用[页面级的状态变量](https://docs.openharmony.cn/pages/v5.0/zh-cn/application-dev/ui/state-management/arkts-localstorage.md) 6和[应用级的状态变量](https://docs.openharmony.cn/pages/v5.0/zh-cn/application-dev/ui/state-management/arkts-appstorage.md) 7来实现应用的状态管理。 8 9### 效果预览 10 11|主页|子组件同步父组件部分内容|爷孙组件之间状态同步|应用内全局数据与UI之间的状态同步| 12|--------------------------------|--------------------------------|--------------------------------|--------------------------------| 13||||| 14 15使用说明 16 171.点击首页中的基本类型进入对应页面，点击按钮可以更改圆形的颜色；点击查看源码可以展示基本类型功能效果的源码。 18 192.点击首页中的数组类型进入对应页面，点击新增元素可以添加数据；点击删除元素可以删除数据，当数据为空时，点击删除会弹出一个提示窗；点击更新数组中的某个元素，可以更改第一条数据的age属性，当数据为空时，同样会弹出一个提示窗；点击查看源码可以展示数组类型功能效果的源码。 20 213.点击首页中的类对象类型进入对应页面，点击更新对象可以更改对象属性和对象属性中的属性；点击更新对象属性，对象属性数据发生变化；点击更新属性中的属性，对象属性的属性数据发生变化；点击查看源码可以展示类对象类型功能效果的源码。 22 234.点击首页中的只更新所绑定的组件进入对应页面，点击修改标题和内容，标题和内容数据都发生变化，页面更新标题数据，内容数据不刷新；点击查看源码可以展示类对象类型功能效果的源码。 24 255.点击单、双向同步进入对应页面，点击设置为粉色按钮，父组件圆形颜色更新，两个子组件颜色同步更新；点击设置为蓝色按钮，子组件A圆形颜色更新，父组件和子组件B颜色不更新；点击设置为红色按钮，子组件B圆形颜色更新，父组件和子组件A圆形颜色同步更新，点击查看源码可以展示单、双向同步功能效果的源码。 26 276.点击子组件同步父组件的部分内容进入对应页面，点击父组件中的属性1修改数据，子组件中的属性1数据同步，点击子组件的属性1修改数据，父组件中的属性1数据同步，点击查看源码可以展示子组件同步父组件的部分内容功能效果的源码。 28 297.点击爷孙组件之间状态同步进入对应页面，点击爷组件下拉框组件选择颜色，下拉框文本和圆形颜色改变，孙组件下拉框文本和圆形颜色同步刷新；点击孙组件下拉框选择颜色，下拉框文本和圆形颜色改变，爷组件下拉框文本和圆形颜色同步刷新，点击查看源码可以展示爷孙组件之间状态同步功能效果的源码。 30 318.点击兄弟组件之间状态同步进入对应页面，点击兄弟A组件下拉框选择颜色，下拉框文本和圆形颜色改变，兄弟B组件下拉框文本和圆形颜色同步刷新，点击兄弟B组件下拉框选择颜色，下拉框文本和圆形颜色改变，兄弟A组件下拉框文本和圆形颜色同步刷新，点击查看源码可以展示爷孙组件之间状态同步功能效果的源码。 32 339.点击应用内全局数据与UI之间的状态同步进入对应页面，点击修改夜间模式状态和字体大小，当前夜间模式状态以及字体大小发生变化，进入Ability1和Ability2页面，夜间模式状态以及字体大小同步更新；在Ability1界面中改变夜间模式状态和字体大小，夜间模式状态和字体大小发生变化，进入到主页面和Ability2页面，夜间模式状态同步更新，字体大小不变；在Ability2界面中修改夜间模式状态，夜间模式状态发生改变，进入到主页面和Ability1页面，夜间模式状态同步，点击查看源码可以展示应用内全局数据与UI之间的状态同步功能效果的源码。 34 3510.点击Ability内全局数据与UI之间的状态同步进入对应页面，点击修改夜间模式状态和字体大小，当前夜间模式状态以及字体大小发生变化时，进入Page1和Page2以及跨Ability不同步页面，Page1和Page2夜间模式状态以及字体大小同步更新,跨Ability页面不同步更新；在Page1界面中改变夜间模式状态和字体大小，夜间模式状态和字体大小发生变化，进入到主页面、Page2和跨Ability不同步页面，主页面和Page2夜间模式状态同步更新，但是字体不发生变化，跨Ability页面夜间模式状态和字体都不同步更新；在Page2界面中修改夜间模式状态，夜间模式状态发生改变，进入到主页面、Page1页面和跨Ability不同步页面，主页和Page1夜间模式状态同步，跨Ability页面都不同步更新；在跨Ability界面中修改夜间模式状态，夜间模式状态发生改变，进入主页、Page1和Page2页面，夜间模式状态不同步，点击查看源码可以展示Ability内全局数据与UI之间的状态同步功能效果的源码。 36 37### 工程目录 38 39``` 40entry/src/main/ets/ 41|---commoncomponents 42| |---CodeView.ets // 代码展示组件 43| |---TitleBar.ets // 标题组件 44| |---TitleBarDark.ets // 夜间模式下标题组件 45| |---ViewCodeText.ets // 查看源码文本组件 46|---entryability 47| |---EntryAbility.ts 48|---outofsyncability 49| |---OutOfSyncAbility.ts 50|---MainAbility 51|---pages 52| |---applylevelstagemanagement // 应用级状态管理 53| | |---abilityglobaldatasync // Ability内全局数据与UI之间的状态同步 54| | | |---AbilityGlobalDataSync.ets 55| | | |---AbilityGlobalDataSyncCode.ets // Ability内全局数据与UI之间的状态同步主页 56| | | |---AbilityOutOfSyncPage.ets // 跨Ability页面 57| | | |---LocalStorageLinkPage.ets // 展示LocalStorageLink效果页面 58| | | |---LocalStoragePropPage.ets // 展示LocalStorageProp效果页面 59| | |---applyglobaldatasync // 应用内全局数据与UI之间的状态同步 60| | | |---ApplyGlobalDataSync.ets 61| | | |---ApplyGlobalDataSyncCode.ets // 应用内全局数据与UI之间的状态同步主页 62| | | |---StorageLinkAbilityPage.ets // 展示StorageLinkAbility页面 63| | | |---StoragePropAbilityPage.ets // 展示StoragePropAbility页面 64| | |---model 65| | | |---AbilityConfigType.ets // Ability参数类型 66| | | |---CommonMethods.ets // 公用函数启动Ability 67| |---home 68| | |---data 69| | | |---HomeData.ets // 首页数据 70| | |---model 71| | | |---CategoricalDataType.ets // 层级类型 72| | |---Home.ets // 首页 73| | |---TabContentNavigation.ets // Tab内容区组件 74| |---pagelevelstagemanagement // 页面级状态管理 75| | |---multicompomentssync // 自定义组件之间的状态同步 76| | | |---brothercomponentssync // 兄弟组件之间状态同步 77| | | | |---BrotherComponentSync.ets 78| | | | |---BrotherComponentSyncCode.ets // 兄弟组件之间状态同步首页 79| | | | |---ConsumeBrotherOneComponent.ets // @Consume状态变量组件 80| | | | |---ConsumeBrotherTwoComponent.ets // @Consume状态变量组件 81| | | | |---LinkBrotherOneComponent.ets // @Link状态变量组件 82| | | | |---LinkBrotherTwoComponent.ets // @Link状态变量组件 83| | | | |---ProvideAndConsumeSync.ets // @Privide状态变量组件 84| | | | |---StateAndLinkSync.ets // @State状态变量组件 85| | | |---data 86| | | | |---ColorData.ets // 颜色数据 87| | | |---deepnestcomponentssync // 爷孙组件嵌套 88| | | | |---ConsumeDescendentComponent.ets // @Consume孙组件 89| | | | |---DeepNestComponentsSync.ets 90| | | | |---DeepNestComponentsSyncCode.ets // 爷孙组件首页 91| | | | |---LinkDescendentComponent.ets // @Link孙组件 92| | | | |---ProvideAndConsumeSync.ets // @Provide爷组件 93| | | | |---StateAndLinkSync.ets // @State爷组件 94| | | |---model 95| | | | |---ColorType.ets // 颜色数据类型 96| | | |---parentchildcomponentsync // 父子组件之间状态同步 97| | | | |---parentchildpartialcontentsync // 子组件同步父组件部分内容 98| | | | | |---ObjectLinkComponent.ets // @ObjectLink子组件 99| | | | | |---ParentChildPartialContentSync.ets 100| | | | | |---ParentChildPartialContentSyncCode.ets // @Observer父组件 101| | | | |---uniandbidirectionsync // 单、双向同步 102| | | | | |---ComponentLink.ets // Link组件 103| | | | | |---ComponentProp.ets // Prop组件 104| | | | | |---UniAndBidirectionSync.ets 105| | | | | |---UniAndBidirectionSyncCode.ets // @State父组件 106| | |---singlecomponentstatevariables // 单组件的状态同步 107| | | |---decoratedobjecttype // 修饰的对象类型 108| | | | |---arraytype // 数组类型 109| | | | | |---ArrayType.ets 110| | | | | |---ArrayTypeCode.ets // 数组类型源码页 111| | | | |---basetype // 基本类型 112| | | | | |---BaseType.ets 113| | | | | |---BaseTypeCode.ets // 基本类型源码页 114| | | | |---classobjecttype // 对象类型 115| | | | | |---ClassObjectType.ets 116| | | | | |---ClassObjectTypeCode.ets // 对象类型源码页 117| | | |---updatetactics // 更新原理 118| | | | |---updateboundcomponent // 只更新所绑定的组件 119| | | | | |---UpdateBoundComponent.ets 120| | | | | |---UpdateBoundComponentCode.ets // 只更新所绑定的组件源码 121|---storagelinkability 122| |---StorageLinkAbility.ts 123|---storagepropability 124| |---StoragePropAbility.ts 125|---utils 126| |---Logger.ts // 日志文件 127| |---ResourceUtils.ts // 资源转换方法 128| |---StartAbilityUtils.ts // 启动Ability方法 129 130``` 131 132### 具体实现 133 134* 查看源码：通过private controller: webView.WebviewController = new webView.WebviewController()声明一个状态变量，使用this.controller.loadUrl(url)来打开web页面，查看对应的源码。 135* 基本类型：使用@State声明一个Resource类型的circleColor状态变量，然后通过点击事件根据circleColor的id来改变圆形颜色。 136* 数组类型：使用@State声明一个数组arrayTypeData状态变量，数据元素为new ArrayDataType()，通过arrayTypeData.push()方法来新增元素数据，arrayTypeData.splice()方法删除元素，更新指定new ArrayDataType()来实现更新某一个元素数据。 137* 类对象类型：使用@Observerd声明一个属性类ChildClass，然后声明一个对象类ParentClass，并将对象的其中一个属性类型设置为属性类，使用@State声明一个类对象数据状态变量classObjectData，更新对象可以通过new ParentClass()生成一个对象并赋值来实现，更新对象属性可以通过this.classOjectData.attribute++来实现，更新对象属性的属性可以通过@ObjectLink声明一个状态变量并更新此状态变量的对象属性来实现。 138* 只更新所绑定的组件：使用@State和Private声明一个titleName和content状态变量，通过点击事件修改这两个状态变量。 139* 单、双向同步：父组件使用@State声明一个状态变量circleColor并作为参数给子组件A和子组件B，子组件A通过@Prop接收，子组件B通过@Link来接收，通过点击事件中的this.circleColor = ColorData.PINK来更改颜色。 140* 子组件同步父组件部分内容：父组件中使用@State声明一个数组状态变量parentData，@Observed声明数组元素的类，父组件向子组件传递parentData的某一个元素数据，子组件通过@ObjectLink来接收，父组件通过this.childObject.attributeType = value来修改元素数据，子组件同步更新，子组件同样通过this.childObjectData.attributeType = value来修改子组件的数据，父组件同步更新。 141* 爷孙组件之间状态同步：爷组件通过@State声明一个控制圆形颜色的状态变量circleColor和控制当前Select组件Index的状态变量currentSelectIndex，逐层传递给子组件给孙组件，通过@Link接收，爷组件通过onSelect事件来修改circleColor和currentSelectIndex，孙组件同样通过onSelect事件来修改circleColor和currentSelectIndex，然后爷组件通过@Provide声明一个控制圆形颜色的状态变量consumeCircleColor和控制当前Select组件Index的状态变量currentSelectIndex，孙组件通过@Consume来接收，爷组件通过onSelect事件来修改circleColor和currentSelectIndex，孙组件同样通过onSelect事件来修改circleColor和currentSelectIndex。 142* 兄弟组件之间状态同步：父组件通过@State声明一个控制圆形颜色的状态变量circleColor和控制当前Select组件Index的状态变量currentSelectIndex，传递给子组件A和子组件B，两者通过@Link接收，子组件A通过onSelect事件来修改circleColor和currentSelectIndex，子组件B同样通过onSelect事件来修改circleColor和currentSelectIndex；然后父组件通过@Provide声明一个控制圆形颜色的状态变量consumeCircleColor和控制当前Select组件Index的状态变量currentSelectIndex，子组件A和子组件B通过@Consume来接收，子组件A通过onSelect事件来修改circleColor和currentSelectIndex，，子组件B同样通过onSelect事件来修改circleColor和currentSelectIndex。 143* 应用内全局数据与UI之间的状态同步：主页、Ability1页面和Ability2页面通过@StorageLink声明一个控制夜间模式的状态变量currentModelStatus，在主页面通过onChange事件中的AppStorage.SetOrCreate<boolean>('currentModelStatus', this.currentModelStatus)来更改夜间模式的状态，，在Ability1页面和Ability页面通过onClick事件中的this.currentModelStatus = !this.currentModelStatus，主页和Ability2页面通过@StorageLink声明一个控制字体大小的状态变量contentFontSize，Ability1页面通过@StorageProp声明一个控制字体大小的状态变量contentFontSize，主页使用onChange事件中的this.contentFontSize = value和AppStorage.SetOrCreate<number>('contentFontSize', this.contentFontSize)来更改内容字体的大小，Ability1通过onChange事件中的this.contentFontSize = value来修改内容字体大小。 144* Ability内全局数据与UI之间的状态同步：在Entry当中声明一个storage，并通过this.storage.setOrCreate<boolean>('currentModelStatus', true)和this.storage.setOrCreate<number>('contentFontSize', 18)来设置夜间模式状态变量currentModelStatus和字体大小状态变量contentFontSize，然后主页、Page1页面、Page2页面和跨Ability页面通过@LocalStorageLink声明一个控制夜间模式的状态变量currentModelStatus，在主页面通过onChange事件中的this.currentModelStatus = isOn来更改夜间模式的状态，Page1页面、Page2页面和跨Ability页面通过onClick事件中的this.currentModelStatus = !this.currentModelStatus来更改夜间模式的状态，主页、Page1页面和跨Ability页面通过@LocalStorageLink声明一个控制字体大小的状态变量contentFontSize，Page1页面通过@LocalStorageProp声明一个控制字体大小的状态变量contentFontSize，主页使用onChange事件中的this.contentFontSize = value和AppStorage.SetOrCreate<number>('contentFontSize', this.contentFontSize)来更改内容字体的大小，Page2通过onChange事件中的this.contentFontSize = value来修改内容字体大小。 145 146### 相关权限 147 148不涉及。 149 150### 依赖 151 152不涉及。 153 154### 约束与限制 155 1561.本示例仅支持标准系统上运行。 157 1582.本示例已适配API version 14版本SDK，版本号：5.0.2.123。 159 1603.本示例需要使用DevEco Studio 5.0.4 Releasse (Build Version: 5.0.11.100, built on March 28, 2025)才可编译运行。 161 162### 下载 163 164如需单独下载本工程，执行如下命令： 165 166``` 167git init 168git config core.sparsecheckout true 169echo code/UI/StateManagement/ > .git/info/sparse-checkout 170git remote add origin https://gitee.com/openharmony/applications_app_samples.git 171git pull origin master 172 173```
