!9274 add restoreId to common

Merge pull request !9274 from Hu_zq/master

zh-cn/application-dev/reference/arkui-ts/Readme-CN.md

@@ -40,6 +40,7 @@
         - [多态样式](ts-universal-attributes-polymorphic-style.md)
         - [触摸测试控制](ts-universal-attributes-hit-test-behavior.md)
         - [背景模糊设置](ts-universal-attributes-backgroundBlurStyle.md)
+        - [分布式迁移标识](ts-universal-attributes-restoreId.md)
     - 手势处理
         - [绑定手势方法](ts-gesture-settings.md)
         - 基础手势

zh-cn/application-dev/reference/arkui-ts/ts-container-list.md

@@ -43,7 +43,6 @@ List(value:{space?: number | string, initialIndex?: number, scroller?: Scroller}
 | edgeEffect | [EdgeEffect](ts-appendix-enums.md#edgeeffect) | EdgeEffect.Spring | 滑动效果，目前支持的滑动效果参见EdgeEffect的枚举说明。 |
 | chainAnimation | boolean | false | 用于设置当前list是否启用链式联动动效，开启后列表滑动以及顶部和底部拖拽时会有链式联动的效果。链式联动效果：list内的list-item间隔一定距离，在基本的滑动交互行为下，主动对象驱动从动对象进行联动，驱动效果遵循弹簧物理动效。<br/>-&nbsp;false：不启用链式联动。<br/>-&nbsp;true：启用链式联动。 |
 | multiSelectable<sup>8+</sup> | boolean | false | 是否开启鼠标框选。<br/>-&nbsp;false：关闭框选。<br/>-&nbsp;true：开启框选。 |
-| restoreId<sup>8+</sup> | number | - | 组件迁移标识符，标识后的组件在应用迁移时，组件状态会被迁移到被拉起方的同标识组件。<br/>列表组件状态，包括起始位置显示的item序号。 |
 | lanes<sup>9+</sup> | number \|<br>{<br/>minLength: Length,<br/>maxLength: Length<br/>} | 1 | 以列模式为例（listDirection为Axis.Vertical）:<br/>lanes用于决定List组件在交叉轴方向按几列布局，规则如下：<br/>- lanes为指定的数量时，根据指定的数量与List组件的交叉轴宽度来决定每列的宽度；<br/>- lane设置了{minLength，maxLength}时，根据List组件的宽度自适应决定lanes数量（即列数），保证缩放过程中lane的宽度符合{minLength，maxLength}的限制。其中，minLength条件会被优先满足，即优先保证符合ListItem的宽度符合最小宽度限制。例如在列模式下，设置了{minLength: 40vp，maxLength: 60vp}，则当List组件宽度为70vp时，ListItem为一列，并且根据alignListItem属性做靠左、居中或者靠右布局；当List组件宽度变化至80vp时，符合两倍的minLength，则ListItem自适应为两列。 |
 | alignListItem<sup>9+</sup> | ListItemAlign | ListItemAlign.Center | List交叉轴方向宽度大于ListItem交叉轴宽度 * lanes时，ListItem在List交叉轴方向的布局方式，默认为居中。 |
 | sticky<sup>9+</sup> | StickyStyle | StickyStyle.None | 配合[ListItemGroup](ts-container-listitemgroup.md)组件使用，设置ListItemGroup中header和footer是否要吸顶或吸底，参见StickyStyle的枚举说明。|

zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-restoreId.md

+# 分布式迁移标识
+
+组件的分布式迁移标识，指明了该组件在分布式迁移场景下可以将特定状态恢复到对端设备。
+
+>  **说明：**
+>
+> 从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
+
+## 属性
+
+| 名称 | 参数类型 | 描述 |
+| -------- | -------- | -------- |
+| restoreId | number | 标记不同支持分布式迁移组件的Id，用于两端设备组件的配对。同一个应用中各个支持分布式迁移组件的Id需不同。 |
+
+## 支持的组件
+
+| 名称 | 起始版本 | 迁移状态 |
+| -------- | -------- | -------- |
+| List | 8 | 迁移当前设备显示在顶部item的序号，迁移后在对端设备上，将迁移item完整的置顶显示。 |
+| Grid | 9 | 迁移当前设备显示在顶部item的序号，迁移后在对端设备上，将迁移item完整的置顶显示。ScrollBar位置无法迁移。 |
+| Scroll | 9 | 迁移距顶部滚动的绝对距离。两端设备显示规格不同等原因导致布局不一致，会影响迁移效果。 |
+| TextArea | 9 | 迁移文本内容和首光标位置。 |
+| TextInput | 9 | 迁移文本内容和首光标位置。 |
+
+## 示例
+
+```ts
+// xxx.ets
+@Entry
+@Component
+struct RestoreIdExample {
+  private arr: number[] = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10]
+  build() {
+    Column() {
+      List({ space: 20 }) {
+        ForEach(this.arr, (item) => {
+          ListItem() {
+            Text('' + item)
+              .width('100%')
+              .height(100)
+              .fontSize(16)
+              .fontColor(0xFFFFFF)
+              .textAlign(TextAlign.Center)
+              .borderRadius(10)
+              .backgroundColor(Color.Pink)
+          }
+        }, item => item)
+      }
+      .restoreId(1)
+    }
+  }
+}
+```