diff --git a/en/react-native-material-menu.md b/en/react-native-material-menu.md
index c8448e3b2768b66901faba4a6f06b3003f99744e..5036d9829930eae44fafd97f58663484aa732435 100644
--- a/en/react-native-material-menu.md
+++ b/en/react-native-material-menu.md
@@ -17,6 +17,12 @@ Template version: v0.2.2
> [!TIP] [ GitHub address](https://github.com/mxck/react-native-material-menu)
+Please visit the Release release address of the third-party library to view the corresponding version information:
+
+| Version | Support RN version |
+| ------------------------- | -------------------------- |
+| 0.2.2 | 0.72/0.77 |
+
## Installation and Usage
@@ -78,7 +84,9 @@ export default function App() {
This document is verified based on the following versions:
-RNOH：0.72.27; SDK：HarmonyOS-Next-DB1 5.0.0.29(SP1); IDE：DevEco Studio 5.0.3.400SP7; ROM：3.0.0.25;
+1. RNOH：0.72.27; SDK：HarmonyOS-Next-DB1 5.0.0.29(SP1); IDE：DevEco Studio 5.0.3.400SP7; ROM：3.0.0.25;
+2. RNOH：0.72.33; SDK：OpenHarmony 5.0.0.71(API Version 12 Release); IDE：DevEco Studio 5.0.3.900; ROM：NEXT.0.0.71;
+3. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.858; ROM: 6.0.0.112;
## Properties
diff --git a/en/react-native-switch.md b/en/react-native-switch.md
index b7313f9c1a277a7ea2d3f500891cc98099355fc4..793acf91530224356c6aa67ce5e37df17cd4aa7e 100644
--- a/en/react-native-switch.md
+++ b/en/react-native-switch.md
@@ -14,6 +14,12 @@
> [!TIP] [ GitHub address](https://github.com/shahen94/react-native-switch)
+Please visit the Release release address of the third-party library to view the corresponding version information:
+
+| Version | Support RN version |
+| ------------------------- | -------------------------- |
+| 1.5.1 | 0.72/0.77 |
+
## Installation and Usage
@@ -111,6 +117,7 @@ This document is verified based on the following versions:
1. RNOH: 0.72.27; SDK: HarmonyOS-NEXT-DB1; IDE: DevEco Studio 5.0.3.400SP7; ROM: 3.0.0.29;
2. RNOH: 0.72.33; SDK：OpenHarmony 5.0.0.71(API Version 12 Release); IDE：DevEco Studio 5.0.3.900; ROM：NEXT.0.0.71;
+3. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.858; ROM: 6.0.0.112;
## Properties
diff --git a/en/shopify-flash-list.md b/en/shopify-flash-list.md
index f421d69e4bcac6cbfb370d142033fb198458cf78..150fa31fa339cbfeffe771e93941cb2ad26d7176 100644
--- a/en/shopify-flash-list.md
+++ b/en/shopify-flash-list.md
@@ -14,24 +14,35 @@
> [!TIP] [Github address](https://github.com/react-native-oh-library/flash-list)
-## Installation and Usage
-
-Find the matching version information in the release address of a third-party library: [@react-native-oh-tpl/flash-list Releases](https://github.com/react-native-oh-library/flash-list/releases).For older versions that are not published to npm, please refer to the [installation guide](/en/tgz-usage-en.md) to install the tgz package.
+Please visit the Release release address of the third-party library to view the corresponding version information:
-Go to the project directory and execute the following instruction:
+| Version | Releases info | Support RN version |
+| ------------------------- | ------------------------------------------------- | -------------------------- |
+| 1.6.3 | [@react-native-oh-tpl/flash-list Releases](https://github.com/react-native-oh-library/flash-list/releases) | 0.72 |
+| 1.8.3 | [@react-native-ohos/flash-list Releases]() | 0.77 |
+## Installation and Usage
+Go to the project directory and execute the following instruction:
#### **npm**
```bash
+# 0.72
npm install @react-native-oh-tpl/flash-list
+
+# 0.77
+npm install @react-native-ohos/flash-list
```
#### **yarn**
```bash
+# 0.72
yarn add @react-native-oh-tpl/flash-list
+
+# 0.77
+yarn add @react-native-ohos/flash-list
```
The following code shows the basic use scenario of the repository:
@@ -71,11 +82,26 @@ Open the `harmony` directory of the HarmonyOS project in DevEco Studio.
### 1. Adding the overrides Field to oh-package.json5 File in the Root Directory of the Project
+- 0.72
+
+```json
+{
+ "overrides": {
+ "@rnoh/react-native-openharmony": "^0.72.38" // ohpm version
+ // "@rnoh/react-native-openharmony" : "./react_native_openharmony.har" // a locally available HAR package
+ // "@rnoh/react-native-openharmony" : "./react_native_openharmony" // source code directory
+ }
+}
+```
+
+- 0.77
+
```json
{
- ...
"overrides": {
- "@rnoh/react-native-openharmony" : "./react_native_openharmony"
+ "@rnoh/react-native-openharmony": "^0.77.86" // ohpm version
+ // "@rnoh/react-native-openharmony" : "./react_native_openharmony.har" // a locally available HAR package
+ // "@rnoh/react-native-openharmony" : "./react_native_openharmony" // source code directory
}
}
```
@@ -91,13 +117,22 @@ Method 1 (recommended): Use the HAR file.
Open `entry/oh-package.json5` file and add the following dependencies:
+- 0.72
+
```json
"dependencies": {
- "@rnoh/react-native-openharmony": "file:../react_native_openharmony",
"@react-native-oh-tpl/flash-list": "file:../../node_modules/@react-native-oh-tpl/flash-list/harmony/flash_list.har"
}
```
+- 0.77
+
+```json
+"dependencies": {
+ "@react-native-ohos/flash-list": "file:../../node_modules/@react-native-ohos/flash-list/harmony/flash_list.har"
+ }
+```
+
Click the `sync` button in the upper right corner.
Alternatively, run the following instruction on the terminal:
@@ -133,7 +168,11 @@ add_subdirectory("${RNOH_CPP_DIR}" ./rn)
# RNOH_BEGIN: manual_package_linking_1
add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package)
-+ add_subdirectory("${OH_MODULES}/@react-native-oh-tpl/flash-list/src/main/cpp" ./flah-list)
+# 0.72
++ add_subdirectory("${OH_MODULES}/@react-native-oh-tpl/flash-list/src/main/cpp" ./flash-list)
+
+# 0.77
++ add_subdirectory("${OH_MODULES}/@react-native-ohos/flash-list/src/main/cpp" ./flash-list)
# RNOH_END: manual_package_linking_1
file(GLOB GENERATED_CPP_FILES "./generated/*.cpp")
@@ -187,9 +226,11 @@ Then build and run the code.
### Compatibility
-To use this repository, you need to use the correct React-Native and RNOH versions. In addition, you need to use DevEco Studio and the ROM on your phone.
+This document is verified based on the following versions:
-Check the release version information in the release address of the third-party library: [@react-native-oh-tpl/flash-list Releases](https://github.com/react-native-oh-library/flash-list/releases)
+1. RNOH: 0.72.27; SDK: HarmonyOS-NEXT-DB1; IDE: DevEco Studio 5.0.3.400SP7; ROM: 3.0.0.29;
+2. RNOH: 0.72.33; SDK：OpenHarmony 5.0.0.71(API Version 12 Release); IDE：DevEco Studio 5.0.3.900; ROM：NEXT.0.0.71;
+3. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.858; ROM: 6.0.0.112;
## Properties
@@ -252,6 +293,7 @@ Check the release version information in the release address of the third-party
| scrollToIndex | Scroll to a given index. | function | No | All | Yes |
| scrollToItem | Scroll to a given item. | function | No | All | Yes |
| scrollToOffset | Scroll to a specific content pixel offset in the list. | function | No | All | Yes |
+| recomputeViewableItems1.8.2 | Retriggers viewability calculations. Useful to imperatively trigger viewability calculations. | function | No | All | Yes |
## Known Issues
diff --git a/zh-cn/react-native-material-menu.md b/zh-cn/react-native-material-menu.md
index 3ff5b395c1d7b03f4ca87d547ddee9bd5fc38295..b6fef450426d5ed501a775c7789b00aae6ee6429 100644
--- a/zh-cn/react-native-material-menu.md
+++ b/zh-cn/react-native-material-menu.md
@@ -18,6 +18,11 @@
> [!TIP] [Github 地址](https://github.com/mxck/react-native-material-menu)
+请到三方库的 Releases 发布地址查看配套的版本信息：
+
+| 三方库版本 | 支持RN版本 |
+| ------------------------- | -------------------------- |
+| 0.2.2 | 0.72/0.77 |
## 安装与使用
@@ -83,6 +88,7 @@ export default function App() {
1. RNOH：0.72.27; SDK：HarmonyOS-Next-DB1 5.0.0.29(SP1); IDE：DevEco Studio 5.0.3.400SP7; ROM：3.0.0.25;
2. RNOH：0.72.33; SDK：OpenHarmony 5.0.0.71(API Version 12 Release); IDE：DevEco Studio 5.0.3.900; ROM：NEXT.0.0.71;
+3. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.858; ROM: 6.0.0.112;
## 属性
@@ -95,32 +101,32 @@ export default function App() {
| Name | Description | Type | Required | Platform | HarmonyOS Support |
| ---- | ----------- | ---- | -------- | ---- | ------------ |
-| children | Components rendered in menu (required) | ReactNode | yes | all | yes|
-| anchor | Button component (required) | ReactNode | yes | all | yes|
-| visible | Whether the Menu is currently visible | Boolean | no | all | yes|
-| style | Menu style. | [ViewStyle](https://reactnative.dev/docs/view-style-props) | no | all | yes|
-| onRequestClose | Callback when menu has become hidden | () => void | no | all | yes|
-| animationDuration | Changes show/hide animation duration. default is 300 | Number | no | all | yes|
+| children | 菜单中渲染的组件（必填） | ReactNode | yes | all | yes|
+| anchor | 触发菜单的按钮组件（必填） | ReactNode | yes | all | yes|
+| visible | 当前菜单是否显示 | Boolean | no | all | yes|
+| style | 菜单容器样式 | [ViewStyle](https://reactnative.dev/docs/view-style-props) | no | all | yes|
+| onRequestClose | 菜单隐藏时的回调函数 | () => void | no | all | yes|
+| animationDuration | 显示/隐藏动画时长，默认300毫秒 | Number | no | all | yes|
### MenuItem
| Name | Description | Type | Required | Platform | HarmonyOS Support |
| ---- | ----------- | ---- | -------- | ---- | ------------ |
-| children | Rendered children (required) | ReactNode | yes | all | yes|
-| disabled | Disabled flag. default is false. | Boolean | no | all | yes|
-| disabledTextColor | Disabled text color. default is #bdbdbd. | String | no | all | yes|
-| onPress | Called function on press | ()=>void | no | all | yes|
-| style | Container style | [ViewStyle](https://reactnative.dev/docs/view-style-props) | no | all | yes|
-| textStyle | Text style | [TextStyle](https://reactnative.dev/docs/text-style-props) | no | all | yes|
-| pressColor | Pressed color. default is #e0e0e0. | String | no | all | yes|
+| children | 菜单项内渲染的内容（必填） | ReactNode | yes | all | yes|
+| disabled | 是否禁用，默认false | Boolean | no | all | yes|
+| disabledTextColor | 禁用状态下的文字颜色，默认#bdbdbd | String | no | all | yes|
+| onPress | 点击菜单项时触发的回调函数 | ()=>void | no | all | yes|
+| style | 菜单项容器样式 | [ViewStyle](https://reactnative.dev/docs/view-style-props) | no | all | yes|
+| textStyle | 文字样式 | [TextStyle](https://reactnative.dev/docs/text-style-props) | no | all | yes|
+| pressColor | 按压状态的颜色，默认#e0e0e0 | String | no | all | yes|
### MenuDivider
| Name | Description | Type | Required | Platform | HarmonyOS Support |
| ---- | ----------- | ---- | -------- | ---- | ------------ |
-| color | Line color. default is 'rgba(0,0,0,0.12)' | String | no | all | yes|
+| color | 分隔线颜色，默认'rgba(0,0,0,0.12)'（半透明黑色） | String | no | all | yes|
## 遗留问题
diff --git a/zh-cn/react-native-switch.md b/zh-cn/react-native-switch.md
index bab6f9cbe9c29a0ccd814a0a03d934bc5004e725..acfdf9456ab79b732b65fff65036c979d09cf3de 100644
--- a/zh-cn/react-native-switch.md
+++ b/zh-cn/react-native-switch.md
@@ -15,6 +15,12 @@
> [!TIP] [Github 地址](https://github.com/shahen94/react-native-switch)
+请到三方库的 Releases 发布地址查看配套的版本信息：
+
+| 三方库版本 | 支持RN版本 |
+| ------------------------- | -------------------------- |
+| 1.5.1 | 0.72/0.77 |
+
## 安装与使用
@@ -99,6 +105,7 @@ export function SwitchDemo(){
1. RNOH: 0.72.27; SDK: HarmonyOS-NEXT-DB1; IDE: DevEco Studio 5.0.3.400SP7; ROM: 3.0.0.29;
2. RNOH: 0.72.33; SDK：OpenHarmony 5.0.0.71(API Version 12 Release); IDE：DevEco Studio 5.0.3.900; ROM：NEXT.0.0.71;
+3. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.858; ROM: 6.0.0.112;
## 属性
@@ -108,34 +115,34 @@ export function SwitchDemo(){
| Name | Description | Type | Required | Platform | HarmonyOS Support |
| :----------------: | :----------------------------------------------------------: | :-----------------: | :------: | :---------: | :---------------: |
-| onValueChange | when to change value(value: `boolean`) | function | No | Android/IOS | Yes |
-| disabled | Display or not | boolean | No | Android/IOS | Yes |
-| activeText | active text | string | No | Android/IOS | Yes |
-| inActiveText | in Active Text | string | No | Android/IOS | Yes |
-| backgroundActive | background active | string | No | Android/IOS | Yes |
-| backgroundInactive | background in active | string | No | Android/IOS | Yes |
-| value | swtich value | boolean | No | Android/IOS | Yes |
-| circleActiveColor | circle active color | string | No | Android/IOS | Yes |
-| circleInActiveColor | circle in active color | string | No | Android/IOS | Yes |
-| circleSize | circle Size| number | No | Android/IOS | Yes |
-| circleBorderWidth | circle Border Width | number | No | Android/IOS | Yes |
-| circleBorderActiveColor | circle Border Active Color| string | No | Android/IOS | Yes |
-| circleBorderInactiveColor |circle Border Inactive Color | string | No | Android/IOS | Yes |
-| activeTextStyle |active Text Style | StyleProp` ` | No | Android/IOS | Yes |
-| inactiveTextStyle |in Active Text Style | StyleProp` ` | No | Android/IOS | Yes |
-| containerStyle |container Styl | StyleProp` ` | No | Android/IOS | Yes |
-| barHeight |Bar Height | number | No | Android/IOS | Yes |
-| renderInsideCircle |custom component to render inside the Switch circle | function | No | Android/IOS | Yes |
-| changeValueImmediately |if rendering inside circle, change state immediately or wait for animation to complete | boolean | No | Android/IOS | Yes |
-| innerCircleStyle |style for inner animated circle for what you (may) be rendering inside the circle | StyleProp` ` | No | Android/IOS | Yes |
-| outerCircleStyle |style for outer animated circle | StyleProp` ` | No | Android/IOS | Yes |
-| renderActiveText |render Active Text | boolean | No | Android/IOS | Yes |
-| renderInActiveText |render In Active Text | boolean | No | Android/IOS | Yes |
-| switchLeftPx |denominator for logic when sliding to TRUE position. Higher number = more space from RIGHT of the circle to END of the slider | number | No | Android/IOS | Yes |
-| switchRightPx |multiplied by the `circleSize` prop to calculate total width of the Switch | number | No | Android/IOS | Yes |
-| switchWidthMultiplier |multiplied by the `circleSize` prop to calculate total width of the Switch | number | No | Android/IOS | Yes |
-| switchBorderRadius |Sets the border Radius of the switch slider. If unset, it remains the circleSize | number | No | Android/IOS | Yes |
-| testID |swtich test ID | string | No | Android/IOS | Yes |
+| onValueChange | 值改变时回调 (value: `boolean`) | function | No | Android/IOS | Yes |
+| disabled | 是否禁用开关 | boolean | No | Android/IOS | Yes |
+| activeText | 开关打开时显示的文本 | string | No | Android/IOS | Yes |
+| inActiveText | 开关关闭时显示的文本 | string | No | Android/IOS | Yes |
+| backgroundActive | 开关打开时的背景色 | string | No | Android/IOS | Yes |
+| backgroundInactive | 开关关闭时的背景色 | string | No | Android/IOS | Yes |
+| value | 开关的当前值 | boolean | No | Android/IOS | Yes |
+| circleActiveColor | 开关打开时圆形滑块的颜色 | string | No | Android/IOS | Yes |
+| circleInActiveColor | 开关关闭时圆形滑块的颜色 | string | No | Android/IOS | Yes |
+| circleSize | 圆形滑块的尺寸 | number | No | Android/IOS | Yes |
+| circleBorderWidth | 圆形滑块的边框宽度 | number | No | Android/IOS | Yes |
+| circleBorderActiveColor | 开关打开时圆形滑块的边框颜色 | string | No | Android/IOS | Yes |
+| circleBorderInactiveColor | 开关关闭时圆形滑块的边框颜色 | string | No | Android/IOS | Yes |
+| activeTextStyle | 打开状态文本的样式 | StyleProp` ` | No | Android/IOS | Yes |
+| inactiveTextStyle | 关闭状态文本的样式 | StyleProp` ` | No | Android/IOS | Yes |
+| containerStyle | 开关容器的样式 | StyleProp` ` | No | Android/IOS | Yes |
+| barHeight | 开关滑槽的高度（不包含边框） | number | No | Android/IOS | Yes |
+| renderInsideCircle | 自定义渲染在圆形滑块内部的组件 | function | No | Android/IOS | Yes |
+| changeValueImmediately | 当在圆形滑块内渲染自定义内容时，是立即改变状态还是等待动画完成 | boolean | No | Android/IOS | Yes |
+| innerCircleStyle | 内部圆形动画视图的样式（用于您可能在圆形内部渲染的内容） | No | Android/IOS | Yes |
+| outerCircleStyle | 外部圆形动画视图的样式 | StyleProp`` | StyleProp` ` | No | Android/IOS | Yes |
+| renderActiveText | 是否显示打开状态的文本 | boolean | No | Android/IOS | Yes |
+| renderInActiveText | 是否显示关闭状态的文本 | boolean | No | Android/IOS | Yes |
+| switchLeftPx | 滑块滑动到打开(TRUE)位置时的逻辑分母。数值越大，圆形滑块右侧到滑槽末端的空间越大 | number | No | Android/IOS | Yes |
+| switchRightPx | 与 `circleSize` 相乘来计算开关总宽度的参数之一 | number | No | Android/IOS | Yes |
+| switchWidthMultiplier | 与 `circleSize` 相乘来计算开关总宽度的乘数 | number | No | Android/IOS | Yes |
+| switchBorderRadius | 设置开关滑槽的边框圆角半径。如果未设置，则保持与 `circleSize` 一致 | number | No | Android/IOS | Yes |
+| testID | 用于自动化测试的开关标识符 | string | No | Android/IOS | Yes |
## 遗留问题
## 其他
diff --git a/zh-cn/shopify-flash-list.md b/zh-cn/shopify-flash-list.md
index 57ba01b6c56d7b4aff9b10efe78820e16e11d5cc..7dc18b1a3634a931972e1c43bce8f2b8ac02ac83 100644
--- a/zh-cn/shopify-flash-list.md
+++ b/zh-cn/shopify-flash-list.md
@@ -14,22 +14,36 @@
> [!TIP] [Github 地址](https://github.com/react-native-oh-library/flash-list)
-## 安装与使用
+请到三方库的 Releases 发布地址查看配套的版本信息：
+
+| 三方库版本 | 发布信息 | 支持RN版本 |
+| ---------- | ------------------------------------------------------------ | ---------- |
+| 1.6.3 | [@react-native-oh-tpl/flash-list Releases](https://github.com/react-native-oh-library/flash-list/releases) | 0.72 |
+| 1.8.3 | [@react-native-ohos/flash-list Releases]() | 0.77 |
+
-请到三方库的 Releases 发布地址查看配套的版本信息：[@react-native-oh-tpl/flash-list Releases](https://github.com/react-native-oh-library/flash-list/releases) 。对于未发布到npm的旧版本，请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。
+## 安装与使用
进入到工程目录并输入以下命令：
#### **npm**
```bash
+# 0.72
npm install @react-native-oh-tpl/flash-list
+
+# 0.77
+npm install @react-native-ohos/flash-list
```
#### **yarn**
```bash
+# 0.72
yarn add @react-native-oh-tpl/flash-list
+
+# 0.77
+yarn add @react-native-ohos/flash-list
```
下面的代码展示了这个库的基本使用场景：
@@ -69,11 +83,28 @@ const MyList = () => {
### 1.在工程根目录的 `oh-package.json5` 添加 overrides 字段
+- 0.72
+
+```json
+{
+ ...
+ "overrides": {
+ "@rnoh/react-native-openharmony": "^0.72.38" // ohpm 在线版本
+ // "@rnoh/react-native-openharmony" : "./react_native_openharmony.har" // 指向本地 har 包的路径
+ // "@rnoh/react-native-openharmony" : "./react_native_openharmony" // 指向源码路径
+ }
+}
+```
+
+- 0.77
+
```json
{
...
"overrides": {
- "@rnoh/react-native-openharmony" : "./react_native_openharmony"
+ "@rnoh/react-native-openharmony": "^0.77.86" // ohpm 在线版本
+ // "@rnoh/react-native-openharmony" : "./react_native_openharmony.har" // 指向本地 har 包的路径
+ // "@rnoh/react-native-openharmony" : "./react_native_openharmony" // 指向源码路径
}
}
```
@@ -91,13 +122,22 @@ const MyList = () => {
打开 `entry/oh-package.json5`，添加以下依赖
+- 0.72
+
```json
"dependencies": {
- "@rnoh/react-native-openharmony": "file:../react_native_openharmony",
"@react-native-oh-tpl/flash-list": "file:../../node_modules/@react-native-oh-tpl/flash-list/harmony/flash_list.har"
}
```
+- 0.77
+
+```json
+"dependencies": {
+ "@react-native-ohos/flash-list": "file:../../node_modules/@react-native-ohos/flash-list/harmony/flash_list.har"
+ }
+```
+
点击右上角的 `sync` 按钮
或者在终端执行：
@@ -133,7 +173,11 @@ add_subdirectory("${RNOH_CPP_DIR}" ./rn)
# RNOH_BEGIN: manual_package_linking_1
add_subdirectory("../../../../sample_package/src/main/cpp" ./sample-package)
+# 0.72
+ add_subdirectory("${OH_MODULES}/@react-native-oh-tpl/flash-list/src/main/cpp" ./flash-list)
+
+# 0.77
++ add_subdirectory("${OH_MODULES}/@react-native-ohos/flash-list/src/main/cpp" ./flash-list)
# RNOH_END: manual_package_linking_1
file(GLOB GENERATED_CPP_FILES "./generated/*.cpp")
@@ -187,9 +231,11 @@ ohpm install
### 兼容性
-要使用此库，需要使用正确的 React-Native 和 RNOH 版本。另外，还需要使用配套的 DevEco Studio 和 手机 ROM。
+本文档内容基于以下版本验证通过：
-请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息：[@react-native-oh-tpl/flash-list Releases](https://github.com/react-native-oh-library/flash-list/releases)
+1. RNOH: 0.72.27; SDK: HarmonyOS-NEXT-DB1; IDE: DevEco Studio 5.0.3.400SP7; ROM: 3.0.0.29;
+2. RNOH: 0.72.33; SDK：OpenHarmony 5.0.0.71(API Version 12 Release); IDE：DevEco Studio 5.0.3.900; ROM：NEXT.0.0.71;
+3. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.858; ROM: 6.0.0.112;
## 属性
@@ -199,44 +245,44 @@ ohpm install
| Name | Description | Type | Required | Platform | HarmonyOS Support |
| ---- | ----------- | ---- | -------- | -------- | ------------------ |
-| contentContainerStyle | You can use contentContainerStyle to apply padding that will be applied to the whole content itself. | ContentStyle | No | All | Yes |
-| estimatedListSize | Estimated visible height and width of the list. It is not the scroll content size. Defining this prop will enable the list to be rendered immediately. Without it, the list first needs to measure its size, leading to a small delay during the first render. | object | No | All | Yes |
-| horizontal | If true, renders items next to each other horizontally instead of stacked vertically. Default is false. | boolean | No | All | Yes |
-| keyExtractor | Used to extract a unique key for a given item at the specified index. Key is used for optimizing performance. | function | No | All | Yes |
+| contentContainerStyle | 可通过 contentContainerStyle 为整个内容区域设置内边距。 | ContentStyle | No | All | Yes |
+| estimatedListSize | 列表的预估可见高度和宽度（非滚动内容尺寸）。定义该属性可让列表立即渲染，否则列表需先测量自身尺寸，导致首次渲染稍有延迟。 | object | No | All | Yes |
+| horizontal | 设置为 true 时，项目将水平并列排列而非垂直堆叠。默认为 false。 | boolean | No | All | Yes |
+| keyExtractor | 用于为指定索引位置的项生成唯一键值。键值用于优化性能。 | function | No | All | Yes |
| numColumns | Multiple columns can only be rendered with horizontal={false} and will zig-zag like a flexWrap layout. Items should all be the same height - masonry layouts are not supported. | number | No | All | Yes |
-| extraData | A marker property for telling the list to re-render (since it implements PureComponent) | any | No | All | Yes |
-| drawDistance | Draw distance for advanced rendering (in dp/px). | number | No | All | Yes |
-| estimatedItemSize | estimatedItemSize is a single numeric value that hints FlashList about the approximate size of the items before they're rendered. | number | No | All | Yes |
-| viewabilityConfig | viewabilityConfig is a default configuration for determining whether items are viewable. | object | No | All | Yes |
-| renderItem | Takes an item from data and renders it into the list. | function | Yes | All | Yes |
-| data | For simplicity, data is a plain array of items of a given type. | ItemT[] | Yes | All | Yes |
-| CellRendererComponent | Each cell is rendered using this element. Can be a React Component Class, or a render function | JXS Element | No | All | Yes |
-| ListFooterComponent | Rendered at the bottom of all the items | JXS Element | No | All | Yes |
-| ListHeaderComponent | Rendered at the top of all the items | JXS Element | No | All | Yes |
-| refreshControl | A custom refresh control element. | JXS Element | No | All | Yes |
-| renderScrollComponent | Rendered as the main scrollview. | JXS Element | No | All | Yes |
-| onEndReached | Called once when the scroll position gets within onEndReachedThreshold of the rendered content. | callback | No | All | Yes |
-| onEndReachedThreshold | How far from the end (in units of visible length of the list) the bottom edge of the list must be from the end of the content to trigger the onEndReached callback | number | No | All | Yes |
-| onViewableItemsChanged | Called when the viewability of rows changes, as defined by the viewabilityConfig prop. | callback | No | All | Yes |
-| getItemType | Allows developers to specify item types. | function | No | All | Yes |
-| overrideItemLayout | This method can be used to provide explicit size estimates or change column span of an item. | function | No | All | Yes |
-| ItemSeparatorComponent | Rendered in between each item, but not at the top or bottom. | JXS Element | No | All | Yes |
-| ListEmptyComponent | Rendered when the list is empty | JXS Element | No | All |Yes |
-| ListFooterComponentStyle | Styling for internal View for ListFooterComponent. | React.ComponentType | No | All | Yes |
-| ListHeaderComponentStyle | Styling for internal View for ListHeaderComponent. | StyleProp | No | All | Yes |
-| disableAutoLayout | FlashList applies some fixes to layouts of its children which can conflict with custom CellRendererComponent implementations. You can disable this behavior by setting this to true. | boolean | No | All | Yes |
-| disableHorizontalListHeightMeasurement | When set to true the list's rendered size needs to be deterministic (i.e., height and width greater than 0) as FlashList will skip rendering the extra item for measurement. Default value is false. | boolean | No | All | Yes |
-| estimatedFirstItemOffset | estimatedFirstItemOffset specifies how far the first item is drawn from start of the list window or offset of the first item of the list (not the header). | number | No | All | Yes |
-| initialScrollIndex | Instead of starting at the top with the first item, start at initialScrollIndex | number | No | All | Yes |
-| inverted | Reverses the direction of scroll. Uses scale transforms of -1. | boolean | No | All | Yes |
-| onBlankArea | FlashList computes blank space that is visible to the user during scrolling or the initial loading of the list. | callback | No | All | Yes |
-| onLoad | This event is raised once the list has drawn items on the screen. | callback | No | All | Yes |
-| onRefresh | If provided, a standard RefreshControl will be added for "Pull to Refresh" functionality. Make sure to also set the refreshing prop correctly. | callback | No | All | Yes |
-| onScroll | Fires at most once per frame during scrolling. Inherited from ScrollView. | callback | No | All | Yes |
-| overrideProps | We do not recommend using this prop for anything else than debugging. Internal props of the list will be overriden with the provided values. | object | No | All | Yes |
-| progressViewOffset | Set this when offset is needed for the loading indicator to show correctly. | number | No | All | Yes |
-| refreshing | Set this true while waiting for new data from a refresh. | boolean | No | All | Yes |
-| viewabilityConfigCallbackPairs | List of ViewabilityConfig/onViewableItemsChanged pairs. A specific onViewableItemsChanged will be called when its corresponding ViewabilityConfig's conditions are met. | object | No | All | Yes |
+| extraData | 用于指示列表重新渲染的标记属性（因列表实现为 PureComponent）。 | any | No | All | Yes |
+| drawDistance | 预渲染的绘制距离。 | number | No | All | Yes |
+| estimatedItemSize | 用于在项目渲染前向 FlashList 提示项目近似尺寸的单个数值。 | number | No | All | Yes |
+| viewabilityConfig | 用于判定项目可见性的默认配置。 | object | No | All | Yes |
+| renderItem | 从 data 中获取项目并渲染至列表 | function | Yes | All | Yes |
+| data | 数据源，为指定类型的简单项目数组。 | ItemT[] | Yes | All | Yes |
+| CellRendererComponent | 每个单元格的渲染元素。可以是 React 类组件或渲染函数。 | JXS Element | No | All | Yes |
+| ListFooterComponent | 在列表底部渲染的组件。 | JXS Element | No | All | Yes |
+| ListHeaderComponent | 在列表顶部渲染的组件。 | JXS Element | No | All | Yes |
+| refreshControl | 自定义下拉刷新控件元素。 | JXS Element | No | All | Yes |
+| renderScrollComponent | 作为主滚动视图渲染的组件。 | JXS Element | No | All | Yes |
+| onEndReached | 当滚动位置接近渲染内容末尾（距离阈值为 onEndReachedThreshold）时触发一次 。 | callback | No | All | Yes |
+| onEndReachedThreshold | 触发 onEndReached 回调时，列表底部边缘与内容末尾的距离阈值（以列表可见长度为单位。 | number | No | All | Yes |
+| onViewableItemsChanged | 当项目的可见性发生变化时触发（可见性由 viewabilityConfig 属性定义）。 | callback | No | All | Yes |
+| getItemType | 允许开发者指定项目类型。 | function | No | All | Yes |
+| overrideItemLayout | 用于显式指定项目尺寸估算值或更改项目列跨度。 | function | No | All | Yes |
+| ItemSeparatorComponent | 在每项之间（不包括顶部和底部）渲染的分隔组件。 | JXS Element | No | All | Yes |
+| ListEmptyComponent | 列表为空时渲染的组件。 | JXS Element | No | All |Yes |
+| ListFooterComponentStyle | 列表底部组件内部容器的样式。 | React.ComponentType | No | All | Yes |
+| ListHeaderComponentStyle | 列表顶部组件内部容器的样式。 | StyleProp | No | All | Yes |
+| disableAutoLayout | FlashList 会对子项布局应用某些修复，这可能与自定义 CellRendererComponent 实现冲突。设置为 true 可禁用此行为。 | boolean | No | All | Yes |
+| disableHorizontalListHeightMeasurement | 设置为 true 时，列表的渲染尺寸需确定（即高度和宽度大于0），FlashList 将跳过用于测量的额外项目渲染。默认值为 false。 | boolean | No | All | Yes |
+| estimatedFirstItemOffset | 指定列表窗口中首个项目的绘制偏移量（非列表头部偏移量）。 | number | No | All | Yes |
+| initialScrollIndex | 不从首项开始显示，而是从 initialScrollIndex 指定位置开始。 | number | No | All | Yes |
+| inverted | 反转滚动方向（使用 -1 缩放变换实现）。 | boolean | No | All | Yes |
+| onBlankArea | 滚动或列表初始加载时，FlashList 会计算用户可见的空白区域。 | callback | No | All | Yes |
+| onLoad | 当列表在屏幕上完成项目绘制后触发。 | callback | No | All | Yes |
+| onRefresh | 提供此回调可添加标准 RefreshControl 实现"下拉刷新"功能。需确保同时正确设置 refreshing 属性。 | callback | No | All | Yes |
+| onScroll | 滚动期间每帧最多触发一次（继承自 ScrollView）。 | callback | No | All | Yes |
+| overrideProps | 除调试外不建议使用此属性。列表的内部属性将被提供值覆盖。 | object | No | All | Yes |
+| progressViewOffset | 当加载指示器需要偏移量时才需设置此属性。 | number | No | All | Yes |
+| refreshing | 在等待刷新数据时设置为 true。 | boolean | No | All | Yes |
+| viewabilityConfigCallbackPairs | ViewabilityConfig/onViewableItemsChanged 配置对集合。当对应 ViewabilityConfig 的条件满足时，会触发特定的 onViewableItemsChanged 回调 。 | object | No | All | Yes |
## 静态方法
@@ -246,12 +292,13 @@ ohpm install
| Name | Description | Type | Required | Platform | HarmonyOS Support |
| ---- | ----------- | ---- | -------- | -------- | ------------------ |
-| prepareForLayoutAnimationRender | Run this method before running layout animations, such as when animating an element when deleting it. | function | No | All | Yes |
-| recordInteraction | Tells the list an interaction has occurred, which should trigger viewability calculations, e.g. if waitForInteractions is true and the user has not scrolled. | function | No | All | Yes |
-| scrollToEnd | Scrolls to the end of the content. | function | No | All | Yes |
-| scrollToIndex | Scroll to a given index. | function | No | All | Yes |
-| scrollToItem | Scroll to a given item. | function | No | All | Yes |
-| scrollToOffset | Scroll to a specific content pixel offset in the list. | function | No | All | Yes |
+| prepareForLayoutAnimationRender | 在执行布局动画前调用此方法，例如删除元素时为其添加动画效果。 | function | No | All | Yes |
+| recordInteraction | 通知列表已发生交互行为，这将触发可见性计算（例如当waitForInteractions为true且用户未滚动时）。 | function | No | All | Yes |
+| scrollToEnd | 滚动至内容末尾。 | function | No | All | Yes |
+| scrollToIndex | 滚动至指定索引位置。 | function | No | All | Yes |
+| scrollToItem | 滚动至指定项目。 | function | No | All | Yes |
+| scrollToOffset | 滚动至列表内特定的内容像素偏移量。 | function | No | All | Yes |
+| recomputeViewableItems1.8.3 | 重新触发可见性计算。适用于需要强制触发可见性计算的场景。 | function | No | All | Yes |
## 遗留问题