diff --git a/zh-cn/ant-design-react-native.md b/zh-cn/ant-design-react-native.md
index ec6549f193d28ab88f0764fb0fdf1aec204d955e..36d1a482552853b3561f7c32c8a78e350f760a70 100644
--- a/zh-cn/ant-design-react-native.md
+++ b/zh-cn/ant-design-react-native.md
@@ -346,18 +346,22 @@ V5.4.2
**Modal**:对话框组件,用作显示系统的重要信息,并请求用户进行操作反馈,eg:删除某个重要内容时,弹出 Modal 进行二次确认。
-| Name | Description | Type | Required | Platform | HarmonyOS Support |
-| :------------: | :--------------------------------------------------------------------------------------------------------------------------------------------------: | :---------------------: | :------: | :------: | :---------------: |
-| visible | 对话框是否可见 | Boolean | No | All | Yes |
-| closable | 是否显示关闭按钮 | Boolean | No | All | Yes |
-| maskClosable | 点击蒙层是否允许关闭 | Boolean | No | All | Yes |
-| onClose | 点击 x 或 mask 回调 | (): void | No | All | Yes |
-| transparent | 是否背景透明 | Boolean | No | All | Yes |
-| popup | 是否弹窗模式 | Boolean | No | All | Yes |
-| animationType | 可选: 'fade' / 'slide' | String | No | All | Yes |
-| title | 标题 | React.Element | No | All | Yes |
-| footer | 底部内容 | Array [{text, onPress}] | No | All | Yes |
-| onRequestClose | onRequestClose 回调会在用户按下 Android 设备上的后退按键或是 Apple TV 上的菜单键时触发。返回 true 时会在 modal 处于开启状态时阻止 BackHandler 事件。 | (): boolean | No | All | No |
+| Name | Description | Type | Required | Platform | HarmonyOS Support |
+| :--------------------------------: | :----------------------------------------------------------: | :----------------------------------------------------------: | :------: | :------: | :---------------: |
+| visible | 对话框是否可见 | Boolean | No | All | Yes |
+| closable | 是否显示关闭按钮 | Boolean | No | All | Yes |
+| maskClosable | 点击蒙层是否允许关闭 | Boolean | No | All | Yes |
+| onClose | 点击 x 或 mask 回调 | (): void | No | All | Yes |
+| transparent | 是否背景透明 | Boolean | No | All | Yes |
+| popup | 是否弹窗模式 | Boolean | No | All | Yes |
+| animationType | 可选: 'fade' / 'slide' | String | No | All | Yes |
+| animationDuration5.4.2+ | 动画持续时间,单位ms | Number | No | All | Yes |
+| modalType5.4.2+ | 弹窗的类型,为`'portal'`时则从``根节点插入(默认),为`'modal'`时则同[`react-native/Modal`](https://reactnative.dev/docs/modal)(用于获取当前context),为`'view'`时则同`react-native/View`(用于弹窗中嵌套弹窗) | 'portal'`| `'modal'` | `'view' | No | All | Yes |
+| title | 标题 | React.Element | No | All | Yes |
+| footer | 底部内容 | Array [{text, onPress}] | No | All | Yes |
+| onRequestClose | onRequestClose 回调会在用户按下 Android 设备上的后退按键或是 Apple TV 上的菜单键时触发。返回 true 时会在 modal 处于开启状态时阻止 BackHandler 事件。 | (): boolean | No | All | No |
+| style5.4.2+ | 样式,同`styles.innerContainer` | `ViewStyle` | No | All | Yes |
+| styles5.4.2+ | 语义化结构 style | [ModalStyle](https://github.com/ant-design/ant-design-mobile-rn/blob/5.4.2/components/modal/index.zh-CN.md#modalstyle-语义化样式) | No | All | Yes |
**Modal.alert(title, message, actions?, platform?)**:对话框组件。
@@ -463,19 +467,23 @@ V5.4.2
**Carousel**:走马灯组件。
-| Name | Description | Type | Required | Platform | HarmonyOS Support |
-| :--------------: | :--------------------: | :------------------------: | :------: | :------: | :---------------: |
-| selectedIndex | 手动设置当前显示的索引 | number | No | All | Yes |
-| dots | 是否显示面板指示点 | Boolean | No | All | Yes |
-| vertical | 垂直显示 | Boolean | No | All | Yes |
-| autoplay | 是否自动切换 | Boolean | No | All | Yes |
-| autoplayInterval | 自动切换的时间间隔 | Number | No | All | Yes |
-| infinite | 是否循环播放 | Boolean | No | All | Yes |
-| afterChange | 切换面板后的回调函数 | (current: number): void | No | All | Yes |
-| dotStyle | 指示点样式 | ViewStyle | No | All | Yes |
-| dotActiveStyle | 当前激活的指示点样式 | ViewStyle | No | All | Yes |
-| pageStyle | 轮播页样式 | ViewStyle | No | All | Yes |
-| pagination | 自定义 pagination | (props) => React.ReactNode | No | All | Yes |
+| Name | Description | Type | Required | Platform | HarmonyOS Support |
+| :------------------------------------: | :----------------------------------------------------------: | :------------------------------------: | :------: | :------: | :---------------: |
+| selectedIndex | 手动设置当前显示的索引 | number | No | All | Yes |
+| dots | 是否显示面板指示点 | Boolean | No | All | Yes |
+| vertical | 垂直显示 | Boolean | No | All | Yes |
+| autoplay | 是否自动切换 | Boolean | No | All | Yes |
+| autoplayInterval | 自动切换的时间间隔 | Number | No | All | Yes |
+| infinite | 是否循环播放 | Boolean | No | All | Yes |
+| afterChange | 切换面板后的回调函数 | (current: number): void | No | All | Yes |
+| dotStyle | 指示点样式 | ViewStyle | No | All | Yes |
+| dotActiveStyle | 当前激活的指示点样式 | ViewStyle | No | All | Yes |
+| pageStyle | 轮播页样式 | ViewStyle | No | All | Yes |
+| pagination | 自定义 pagination | (props) => React.ReactNode | No | All | Yes |
+| lazy5.4.2+ | 是否懒加载。支持布尔值或函数返回 | Boolean \| `(index:number) => boolean` | No | All | Yes |
+| renderLazyPlaceholder5.4.2+ | 返回自定义 React 元素以呈现尚未呈现的页面的回调。以`索引`作为参数的对象。需要启用 `lazy` 属性。 | `(index:number) => ReactNode` | No | All | Yes |
+| style5.4.2+ | 轮播容器样式 (建议设置,整体轮播大小由容器决定非页内决定) | ViewStyle | No | All | Yes |
+| onScrollAnimationEnd5.4.2+ | 当滚动动画结束时调用 | ()=>void | No | All | Yes |
**Carousel methods**
@@ -562,7 +570,7 @@ V5.4.2
| onChange | 选中后的回调 | `(value: PickerValue[], extend: PickerValueExtend) => void` | No | All | Yes |
| onPickerChange | 每列数据选择变化后的回调函数 | `(value: PickerValue[], index: number) => void` | No | All | Yes |
| onVisibleChange | 当显隐状态变化时回调函数 | `(visible: bool): void` | No | All | Yes |
-| renderLabel | 自定义渲染每列展示的内容 | `(item: PickerColumnItem, index: number) => ReactNode` 或 `(item) => item.label` | No | All | Yes |
+| renderLabel | 自定义渲染每列展示的内容 | `(item: PickerColumnItem, index: number) => ReactNode` 或 `(item) => item.label`5.1.0 `(item: PickerColumnItem, itemIndex: number,colIndex: number) => ReactNode` 或 `(item) => item.label`5.4.2+ | No | All | Yes |
| title | 大标题 | ReactNode | No | All | Yes |
| okText | 选中的文案 | String | No | All | Yes |
| dismissText | 取消选中的文案 | String | No | All | Yes |
@@ -615,7 +623,7 @@ V5.4.2
| cascade | 是否级联。子级来自`data`参数内的`children`属性 | Boolean | No | All | Yes |
| cols | 列数 | Number | No | All | Yes |
| onChange | 选中后的回调,可使用[rc-form](https://github.com/react-component/form) | `(value: PickerValue[], extend: PickerValueExtend) => void` | No | All | Yes |
-| renderLabel | 自定义渲染每列展示的内容 | `(item: PickerColumnItem, index: number) => ReactNode` 或 `(item) => item.label` | No | All | Yes |
+| renderLabel | 自定义渲染每列展示的内容 | `(item: PickerColumnItem, index: number) => ReactNode` 或 `(item) => item.label`5.1.0 `(item: PickerColumnItem, itemIndex: number,colIndex: number) => ReactNode` 或 `(item) => item.label`5.4.2+ | No | All | Yes |
| loading | 是否处于加载状态 | Boolean | No | All | Yes |
| loadingContent | 加载状态下展示的内容 | ReactNode | No | All | Yes |
| indicatorStyle | 默认 Indicator 的样式 | Object | No | All | No |
@@ -727,16 +735,17 @@ V5.4.2
**Switch**:滑动开关组件,在两个互斥对象进行选择,eg:选择开或关。
-| Name | Description | Type | Required | Platform | HarmonyOS Support |
-| :---------------: | :-----------------------------------------------------: | :-------------------------------------: | :------: | :------: | :---------------: |
-| checked | 是否默认选中 | Boolean | No | All | Yes |
-| defaultChecked | 初始是否打开 | Boolean | No | All | Yes |
-| disabled | 是否不可修改 | boolean | No | All | Yes |
-| loading | 加载中的开关 | Boolean | No | All | Yes |
-| onChange | 变化时的回调函数,当返回 Promise 时,会自动显示加载状态 | (val: boolean) => void 或 Promise | No | All | Yes |
-| color | 开关打开后的颜色 | String | No | All | Yes |
-| checkedChildren | 选中时的内容 | ReactNode | No | All | Yes |
-| unCheckedChildren | 非选中时的内容 | ReactNode | No | All | Yes |
+| Name | Description | Type | Required | Platform | HarmonyOS Support |
+| :---------------------: | :-----------------------------------------------------: | :----------------------------------------------------------: | :------: | :------: | :---------------: |
+| checked | 是否默认选中 | Boolean | No | All | Yes |
+| defaultChecked | 初始是否打开 | Boolean | No | All | Yes |
+| disabled | 是否不可修改 | boolean | No | All | Yes |
+| loading | 加载中的开关 | Boolean | No | All | Yes |
+| onChange | 变化时的回调函数,当返回 Promise 时,会自动显示加载状态 | (val: boolean) => void 或 Promise | No | All | Yes |
+| color | 开关打开后的颜色 | String | No | All | Yes |
+| checkedChildren | 选中时的内容 | ReactNode | No | All | Yes |
+| unCheckedChildren | 非选中时的内容 | ReactNode | No | All | Yes |
+| styles5.4.2+ | 语义化结构 style | [SwitchStyle](https://github.com/ant-design/ant-design-mobile-rn/blob/5.4.2/components/switch/index.zh-CN.md#switchStyle-语义化样式) | No | All | Yes |
**Tabs**:标签页组件,用于让用户在不同的视图中进行切换。
@@ -928,22 +937,28 @@ V5.4.2
**Slider**:滑动输入条组件,允许用户在一个区间中选择特定值,eg:控制屏幕的显示亮度。
-| Name | Description | Type | Required | Platform | HarmonyOS Support |
-| :-----------: | :----------------------------------------------------------------------------------------------------------------------------------------------: | :----------------------------------------------------------------------------------------------------------------------------------: | :------: | :------: | :---------------: |
-| min | 最小值 | Number | No | All | Yes |
-| max | 最大值 | Number | No | All | Yes |
-| step | 步长,取值必须大于 0,并且可被 (max - min) 整除。当 `marks` 不为空对象时,可以设置 `step` 为 `null`,此时 Slider 的可选值仅有 marks 标出来的部分 | Number or null | No | All | Yes |
-| ticks | 是否显示刻度 | `boolean` | No | All | Yes |
-| range | 是否为双滑块 | `boolean` | No | All | Yes |
-| icon | 滑块的图标 | `ReactNode` | No | All | Yes |
-| styles | 语义化结构 style | [SliderStyle](https://github.com/ant-design/ant-design-mobile-rn/blob/5.2.2/components/slider/index.zh-CN.md#sliderstyle-语义化样式) | No | All | Yes |
-| style | 最外层容器样式 | `StyleProp` | No | All | Yes |
-| marks | 刻度标记 | `{ [key: number]: React.ReactNode }` | No | All | Yes |
-| value | 设置当前取值。 | Number | No | All | Yes |
-| defaultValue | 设置初始取值。 | Number | No | All | Yes |
-| disabled | 滑块为禁用状态 | Boolean | No | All | Yes |
-| onChange | 当 Slider 的值发生改变时,会触发 onChange 事件,并把改变后的值作为参数传入 | Function | No | All | Yes |
-| onAfterChange | 与 `ontouchend` 触发时机一致,把当前值作为参数传入 | Function | No | All | Yes |
+| Name | Description | Type | Required | Platform | HarmonyOS Support |
+| :--------------------------------: | :----------------------------------------------------------: | :----------------------------------------------------------: | :------: | :------: | :---------------: |
+| min | 最小值 | Number | No | All | Yes |
+| max | 最大值 | Number | No | All | Yes |
+| step | 步长,取值必须大于 0,并且可被 (max - min) 整除。当 `marks` 不为空对象时,可以设置 `step` 为 `null`,此时 Slider 的可选值仅有 marks 标出来的部分 | Number or null | No | All | Yes |
+| ticks | 是否显示刻度 | `boolean` | No | All | Yes |
+| range | 是否为双滑块 | `boolean` | No | All | Yes |
+| icon | 滑块的图标 | `ReactNode` | No | All | Yes |
+| styles | 语义化结构 style | [SliderStyle](https://github.com/ant-design/ant-design-mobile-rn/blob/5.2.2/components/slider/index.zh-CN.md#sliderstyle-语义化样式) | No | All | Yes |
+| style | 最外层容器样式 | `StyleProp` | No | All | Yes |
+| marks | 刻度标记 | `{ [key: number]: React.ReactNode }` | No | All | Yes |
+| value | 设置当前取值。 | Number | No | All | Yes |
+| defaultValue | 设置初始取值。 | Number | No | All | Yes |
+| disabled | 滑块为禁用状态 | Boolean | No | All | Yes |
+| onChange | 当 Slider 的值发生改变时,会触发 onChange 事件,并把改变后的值作为参数传入 | Function | No | All | Yes |
+| onAfterChange | 与 `ontouchend` 触发时机一致,把当前值作为参数传入 | Function | No | All | Yes |
+| disabledStep5.4.2+ | 是否禁用步距;禁用后`onChange`将返回带有小数点的值 | `boolean` | No | All | Yes |
+| onSlidingStart5.4.2+ | 当用户拿起滑块时调用的回调。始值作为参数传递给回调处理程序。 | Function | No | All | Yes |
+| onSlidingComplete5.4.2+ | 当用户释放滑块时调用的回调,无论值是否已更改。当前值作为参数传递给回调处理程序。 | Function | No | All | Yes |
+| popover5.4.2+ | 是否在拖动时显示悬浮提示,支持传入函数自定义渲染内容 | `boolean` | No | All | Yes |
+| residentPopover5.4.2+ | `popover` 是否常驻显示,`popover` 存在时生效 | `boolean ` | No | All | Yes |
+| tapToSeek5.4.2+ | 允许点击轨道来设置 thumb icon 位置 | `boolean` | No | All | Yes |
**Popover**:气泡组件,在点击控件或者某个区域后,浮出一个气泡菜单来做更多的操作。 如果设置了遮罩层,建议通过点击遮罩层的任一位置,进行退出。
@@ -1038,10 +1053,10 @@ V5.4.2
同 `Input` 属性,外加:
-| Name | Description | Type | Required | Platform | HarmonyOS Support |
-| :------: | :-------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------: | :------: | :------: | :---------------: |
-| autoSize | 自适应内容高度,可设置为 `true` | `false` 或对象:`{ minRows: 2, maxRows: 6 }` | No | All | Yes |
-| rows | 固定显示几行,`autoSize` 优先级高 | number | No | All | Yes |
+| Name | Description | Type | Required | Platform | HarmonyOS Support |
+| :------: | :-------------------------------: | :----------------------------------------------------------: | :------: | :------: | :---------------: |
+| autoSize | 自适应内容高度,可设置为 `true` | `false` 或对象:`{ minRows: 2, maxRows: 6 }` | No | All | No |
+| rows | 固定显示几行,`autoSize` 优先级高 | number | No | All | No |
| styles | 语义化结构 style | [InputStyle](https://github.com/ant-design/ant-design-mobile-rn/blob/5.2.2/components/input/index.zh-CN.md#inputstyle-语义化样式) | No | All | Yes |
**Form**
@@ -1143,17 +1158,18 @@ V5.4.2
**Tooltip**:气泡组件,在点击控件或者某个区域后,浮出一个气泡菜单来做更多的操作。
-| Name | Description | Type | Required | Platform | HarmonyOS Support |
-| :-------------: | :--------------------------: | :-----------------------------------------------------------------------------------------------------: | :------: | :------: | :---------------: |
-| children | 触发 `Tooltip` 的元素 | `React.ReactElement` | Yes | All | Yes |
-| content | 弹出内容 | `React.ReactNode` | No | All | Yes |
-| defaultVisible | 默认是否显隐 | `boolean` | No | All | Yes |
-| mode | 设置亮色模式或者黑色模式 | `'light'` | No | All | Yes |
-| onVisibleChange | 显示隐藏的回调 | `(visible: boolean) => void` | No | All | Yes |
-| placement | 气泡框位置 | `'top'` | No | All | Yes |
-| styles | 语义化结构 style | [TooltipStyle](https://github.com/ant-design/ant-design-mobile-rn/blob/master/#tooltipstyle-语义化样式) | No | All | Yes |
-| trigger | 触发方式 | `'onPress'` | No | All | Yes |
-| visible | 受控模式下,是否展示弹出内容 | `boolean` | No | All | Yes |
+| Name | Description | Type | Required | Platform | HarmonyOS Support |
+| :--------------------------: | :----------------------------------------------------------: | :----------------------------------------------------------: | :------: | :------: | :---------------: |
+| children | 触发 `Tooltip` 的元素 | `React.ReactElement` | Yes | All | Yes |
+| content | 弹出内容 | `React.ReactNode` | No | All | Yes |
+| defaultVisible | 默认是否显隐 | `boolean` | No | All | Yes |
+| mode | 设置亮色模式或者黑色模式 | `'light'` | No | All | Yes |
+| onVisibleChange | 显示隐藏的回调 | `(visible: boolean) => void` | No | All | Yes |
+| placement | 气泡框位置 | `'top'` | No | All | Yes |
+| styles | 语义化结构 style | [TooltipStyle](https://github.com/ant-design/ant-design-mobile-rn/blob/master/#tooltipstyle-语义化样式) | No | All | Yes |
+| trigger | 触发方式 | `'onPress'` | No | All | Yes |
+| visible | 受控模式下,是否展示弹出内容 | `boolean` | No | All | Yes |
+| crossOffset5.4.2+ | 设置弹窗位置的偏移量;top: 沿元素和其触发元素之间的主轴应用的附加偏移。left: 沿元素和其触发元素之间的横轴应用的附加偏移。 | `{ top: number, left: number }` | No | All | Yes |
**Tooltip.Menu**
@@ -1180,6 +1196,12 @@ V5.4.2
## 其他
+- V5.4.2 三方库存在checkBox的bug(数据错乱,闪退)。源库开发者已修改,
+ https://github.com/ant-design/ant-design-mobile-rn/pull/1434
+- Carousel组件中的infinite为true没有循环播放(偶现),与 Android/IOS 一致[issue#1457](https://github.com/ant-design/ant-design-mobile-rn/issues/1457)。
+- Carousel组件窗口显示下面高亮按钮对应不上的问题(偶现),与 Android/IOS 一致[issue#1457](https://github.com/ant-design/ant-design-mobile-rn/issues/1457)。
+- Tabs组件onChange方法首次滑动不生效问题(偶现),与 Android/IOS 一致[issue#1457](https://github.com/ant-design/ant-design-mobile-rn/issues/1457)。
+
## 开源协议
本项目基于 [The MIT License (MIT)](https://github.com/ant-design/ant-design-mobile-rn/blob/master/LICENSE),请自由地享受和参与开源。
\ No newline at end of file
diff --git a/zh-cn/galio-framework.md b/zh-cn/galio-framework.md
index 3542ba05ffe722a4f036a1b582eadd5224036442..d95d97999d0a36ed8e0f6e57063d3054b1d83c99 100644
--- a/zh-cn/galio-framework.md
+++ b/zh-cn/galio-framework.md
@@ -19,18 +19,31 @@
## 安装与使用
+| 三方库版本 | 支持RN版本 |
+| ---------- | ---------- |
+| 0.8.0 | 0.72 |
+| 0.8.1 | 0.77 |
+
#### **npm**
```bash
+# V0.8.0
npm install galio-framework@0.8.0
+
+# V0.8.1
+npm install galio-framework@0.8.1
```
#### **yarn**
```bash
+# V0.8.0
yarn add galio-framework@0.8.0
+
+# V0.8.1
+yarn add galio-framework@0.8.1
```
diff --git a/zh-cn/react-native-canvas.md b/zh-cn/react-native-canvas.md
index f865170e78e2c8863fa9eca216593125fb1ded47..044d929c5bfc48c8459973149c9e7bde25a102fc 100644
--- a/zh-cn/react-native-canvas.md
+++ b/zh-cn/react-native-canvas.md
@@ -18,6 +18,11 @@
## 安装与使用
+| 三方库版本 | 支持RN版本 |
+| ---------- | ---------- |
+| 0.1.39 | 0.72 |
+| 0.1.40 | 0.77 |
+
进入到工程目录并输入以下命令:
diff --git a/zh-cn/react-native-dotenv.md b/zh-cn/react-native-dotenv.md
index 9352f90be353bdb90c121d39f50d5c459e6e4a37..a54f982a2b70cac57c169ea32e45575f9a08d55f 100644
--- a/zh-cn/react-native-dotenv.md
+++ b/zh-cn/react-native-dotenv.md
@@ -16,7 +16,10 @@
## 安装与使用
-
+| 三方库版本 | 支持RN版本 |
+| ---------- | ---------- |
+| 3.4.9 | 0.72 |
+| 3.4.11 | 0.77 |
进入到工程目录并输入以下命令:
@@ -25,13 +28,21 @@
#### **npm**
```bash
- npm install -D react-native-dotenv@3.4.9
+# V3.4.9
+npm install -D react-native-dotenv@3.4.9
+
+# V3.4.11
+npm install -D react-native-dotenv@3.4.11
```
#### **yarn**
```bash
+# V3.4.9
yarn add -D react-native-dotenv@3.4.9
+
+# V3.4.11
+yarn add -D react-native-dotenv@3.4.11
```
diff --git a/zh-cn/react-native-element-dropdown.md b/zh-cn/react-native-element-dropdown.md
index 2268b9094a04a12882456e93ede3efb6e602d4f8..0da58b67568efddfca192c8a7b23f171f22561e4 100644
--- a/zh-cn/react-native-element-dropdown.md
+++ b/zh-cn/react-native-element-dropdown.md
@@ -16,6 +16,11 @@
## 安装与使用
+| 三方库版本 | 支持RN版本 |
+| ---------- | ---------- |
+| 2.12.1 | 0.72 |
+| 2.12.4 | 0.77 |
+
进入到工程目录并输入以下命令:
@@ -23,13 +28,21 @@
#### **npm**
```bash
+# V2.12.1
npm install react-native-element-dropdown@2.12.1
+
+# V2.12.4
+npm install react-native-element-dropdown@2.12.4
```
#### **yarn**
```bash
+# V2.12.1
yarn add react-native-element-dropdown@2.12.1
+
+# V2.12.4
+yarn add react-native-element-dropdown@2.12.4
```
@@ -365,6 +378,7 @@ yarn add react-native-element-dropdown@2.12.1
| searchQuery | Callback used to filter the list of items | (keyword: string, labelValue: string) => Boolean| No | All | Yes |
| inputSearchStyle | Styling for input search | ViewStyle | No | All | Yes |
| searchPlaceholder | The string that will be rendered before text input has been entered | String | No | All | Yes |
+| searchPlaceholderTextColor2.12.4+ | The text color of the placeholder string | String | No | All | Yes |
| renderInputSearch | Customize TextInput search | (onSearch: (text:string) => void) => JSX.Element| No | All | Yes |
| disable | Specifies the disabled state of the Dropdown | Boolean | No | All | Yes |
| dropdownPosition | Dropdown list position. Default is 'auto' | 'auto' or 'top' or 'bottom' | No | All | Yes |
@@ -423,6 +437,7 @@ yarn add react-native-element-dropdown@2.12.1
| searchQuery | Callback used to filter the list of items | (keyword: string, labelValue: string) => Boolean | No | All | Yes |
| inputSearchStyle | Styling for input search | ViewStyle | No | All | Yes |
| searchPlaceholder | The string that will be rendered before text input has been entered | String | No | All | Yes |
+| searchPlaceholderTextColor2.12.4+ | The text color of the placeholder string | String | No | All | Yes |
| renderInputSearch | Customize TextInput search | (onSearch: (text:string) => void) => JSX.Element | No | All | Yes |
| disable | Specifies the disabled state of the Dropdown | Boolean | No | All | Yes |
| dropdownPosition | Dropdown list position. Default is 'auto' | 'auto' or 'top' or 'bottom' | No | All | Yes |
diff --git a/zh-cn/react-native-error-boundary.md b/zh-cn/react-native-error-boundary.md
index 720e7caa32906dbb8a95a0bf787c2518f0fe98dc..334335dea84559753e0591c0b12da97341337781 100644
--- a/zh-cn/react-native-error-boundary.md
+++ b/zh-cn/react-native-error-boundary.md
@@ -1,79 +1,49 @@
> 模板版本:v0.2.2
-
react-navigation-header-buttons
+ react-native-error-boundary
-
+
-
+
-> [!TIP] [Github 地址](https://github.com/vonovak/react-navigation-header-buttons)
+> [!TIP] [Github 地址](https://github.com/carloscuesta/react-native-error-boundary)
## 安装与使用
| 三方库版本 | 支持RN版本 |
| ---------- | ---------- |
-| 12.0.0 | 0.72 |
-| 13.0.0 | 0.77 |
+| 1.2.4 | 0.72 |
+| 1.2.9 | 0.77 |
-
+进入到工程目录并输入以下命令:
-进入到工程目录并输入以下命令:
#### **npm**
```bash
-# V12.0.0
-npm i react-navigation-header-buttons@12.0.0
+# 0.72
+npm i react-native-error-boundary@1.2.4
-# V13.0.0
-npm i react-navigation-header-buttons@13.0.0
+# 0.77
+npm i react-native-error-boundary@1.2.9
```
#### **yarn**
```bash
-# V12.0.0
-yarn add react-navigation-header-buttons@12.0.0
-
-# V13.0.0
-yarn add react-navigation-header-buttons@13.0.0
-```
-
-
-在tsconfig.json文件中添加如下代码:
-```json
-"compilerOptions": {
- ...
- "paths": {
- ...
- "react-navigation-header-buttons":[
- "./node_modules/react-navigation-header-buttons/lib/module/index.js"
- ]
- },
- }
-
-```
-在metro.config.js文件中添加如下代码:
-```js
-const config = {
-...
- resolver: {
- unstable_enablePackageExports: true,
- },
-};
-module.exports = mergeConfig(
- ...
- config,
-);
+# 0.72
+yarn add react-native-error-boundary@1.2.4
+# 0.77
+yarn add react-native-error-boundary@1.2.9
```
@@ -82,73 +52,43 @@ module.exports = mergeConfig(
> [!WARNING] 使用时 import 的库名不变。
-```js
-import * as React from 'react';
-import MaterialIcons from '@expo/vector-icons/MaterialIcons';
-import {
- HeaderButtons,
- Item,
- HiddenItem,
- OverflowMenu,
- Divider,
- ItemProps,
- HiddenItemProps,
- HeaderButtonProps,
- HeaderButton,
-} from 'react-navigation-header-buttons';
-import { Text } from 'react-native';
-
-const MaterialHeaderButton = (props: HeaderButtonProps) => (
-
-);
-
-const EditItem = ({ onPress }: Pick) => {
- return ;
+```ts
+import React, { PropsWithChildren, useState } from 'react';
+import { StyleSheet, Button } from 'react-native';
+import ErrorBoundary from 'react-native-error-boundary';
+
+export const ErrorBoundaryDefaultExample = () => {
+ const [shouldThrow, setShouldThrow] = useState(false);
+
+ return (
+
+
+ );
};
-const ReusableHiddenItem = ({ onPress }: Pick) => (
-
-);
-
-export function UsageWithIcons({ navigation }) {
- React.useLayoutEffect(() => {
- navigation.setOptions({
- title: 'Demo',
- headerRight: () => (
-
- - alert('search')}
- />
- alert('Edit')} />
- (
-
- )}
- >
- alert('hidden1')} />
-
- alert('hidden2')} />
-
-
- ),
- });
- }, [navigation]);
-
- return demo!;
+function MaybeThrows({ children }: PropsWithChildren) {
+ const valueToThrow = new Error("Throw a new exception");
+ throw valueToThrow;
}
-```
-
-## Link
-本库依赖以下三方库,请查看对应文档:
-
-- [@react-navigation/native](/zh-cn/react-navigation-native.md)
-- [@react-navigation/elements](/zh-cn/react-navigation-elements.md)
-- [react-native-safe-area-context](/zh-cn/react-native-safe-area-context.md)
-
-如已在鸿蒙工程中引入过该库,则无需再次引入,未引入请参照[@react-navigation/native 文档](/zh-cn/react-navigation-native.md)、[@react-navigation/elements 文档](/zh-cn/react-navigation-elements.md)、[react-native-safe-area-context 文档](/zh-cn/react-native-safe-area-context.md)进行引入
+const styles = StyleSheet.create({
+ buttonContainer: {
+ width: 80,
+ height: 80,
+ },
+ box: {
+ height: 100,
+ width: 50,
+ },
+});
+```
## 约束与限制
@@ -156,89 +96,42 @@ export function UsageWithIcons({ navigation }) {
本文档内容基于以下版本验证通过:
-1. RNOH: 0.72.26; SDK:HarmonyOS NEXT Developer Beta1 5.0.0.25; IDE:DevEco Studio 5.0.3.300SP2; ROM:3.0.0.24(Canary3);
-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.47 (API Version 20); IDE:DevEco Studio 6.0.0.858; ROM:6.0.0.107;
+1. RNOH: 0.72.27; SDK: HarmonyOS-NEXT-DB1 5.0.0.25; IDE: DevEco Studio 5.0.3.400; 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;
## 属性
-### HeaderButtons
-
> [!TIP] "Platform"列表示该属性在原三方库上支持的平台。
> [!TIP] "HarmonyOS Support"列为 yes 表示 HarmonyOS 平台支持该属性;no 则表示不支持;partially 表示部分支持。使用方法跨平台一致,效果对标 iOS 或 Android 的效果。
-| Name | Description | Type | Required | Platform | HarmonyOS Support |
-| :--- | :--- | :--- | :--- | :--- | :--- |
-| `HeaderButtonComponent` | 渲染按钮的组件,默认为 HeaderButton | `ComponentType` | no | iOS/Android | yes |
-| `children` | 你想要在内部渲染的任何内容 | `ReactNode` | yes | iOS/Android | yes |
-| `left` | 是否添加边距距离 | boolean | no | iOS/Android | yes |
-| `preset` | 标题通常在 Stack Navigator 中渲染,但你也可以在 Tab Navigator 标题中渲染它们。如果缺少按钮边距,请传递 'tabHeader'。 | `’tabHeader’/‘stackHeader’` | no | iOS/Android | yes |
+### ErrorBoundary
-### Item
-
-> [!TIP] "Platform"列表示该属性在原三方库上支持的平台。
-
-> [!TIP] "HarmonyOS Support"列为 yes 表示 HarmonyOS 平台支持该属性;no 则表示不支持;partially 表示部分支持。使用方法跨平台一致,效果对标 iOS 或 Android 的效果。
-
-| Name | Description | Type | Required | Platform | HarmonyOS Support |
-| :--- | :--- | :--- | :--- | :--- | :--- |
-| `title` | 按钮的标题,必填 | string | no | iOS/Android | yes |
-| `onPress` | 按下时调用的函数 | function | no | iOS/Android | yes |
-| `iconName` | 图标名称,与 IconComponent 属性一起使用 | string | no | iOS/Android | yes |
-| `style` | 应用于包裹按钮的可触摸元素的样式 | `ViewStyle` | no | iOS/Android | yes |
-| `buttonStyle` | 应用于文本/图标的样式 | `ViewStyle` | no | iOS/Android | yes |
-
-### OverflowMenu
-
-> [!TIP] "Platform"列表示该属性在原三方库上支持的平台。
-
-> [!TIP] "HarmonyOS Support"列为 yes 表示 HarmonyOS 平台支持该属性;no 则表示不支持;partially 表示部分支持。使用方法跨平台一致,效果对标 iOS 或 Android 的效果。
-
-| Name | Description | Type | Required | Platform | HarmonyOS Support |
-| :--- | :--- | :--- | :--- | :--- | :--- |
-| `OverflowIcon` | 溢出图标的 React 元素或组件 | `ReactElement / ComponentType` | no | iOS/Android | yes |
-| `style` | 溢出按钮的可选样式 | `ViewStyle` | no | iOS/Android | yes |
-| `onPress` | 当按下溢出菜单时调用的函数。 | function | no | iOS/Android | yes |
-| `left` | 是否添加边距距离 | boolean | no | iOS/Android | yes |
-| `children` | 溢出项 | `ReactNode` | yes | iOS/Android | yes |
-| `preset` | 标题通常在 Stack Navigator 中渲染,但你也可以在 Tab Navigator 标题中渲染它们。如果缺少按钮边距,请传递 'tabHeader'。 | ` 'tabHeader' / 'stackHeader'` | no | iOS/Android | yes |
-
-### HiddenItem
-
-> [!TIP] "Platform"列表示该属性在原三方库上支持的平台。
-
-> [!TIP] "HarmonyOS Support"列为 yes 表示 HarmonyOS 平台支持该属性;no 则表示不支持;partially 表示部分支持。使用方法跨平台一致,效果对标 iOS 或 Android 的效果。
-
-| Name | Description | Type | Required | Platform | HarmonyOS Support |
-| :--- | :--- | :--- | :--- | :--- | :--- |
-| `title` | 按钮的标题,必填 | string | no | iOS/Android | yes |
-| `style` | 应用于包裹文本的可触摸元素的样式 | `ViewStyle` | no | iOS/Android | yes |
-| `titleStyle` | 应用于文本的样式 | `TextStyle` | no | iOS/Android | yes |
-| `onPress` | 按下时调用的函数 | function | no | iOS/Android | yes |
-| `disabled` | 禁用的“项目”会变灰,且触摸时不会调用 onPress | boolean | no | iOS/Android | yes |
-
-
-### HeaderButton
-
-> [!TIP] "Platform"列表示该属性在原三方库上支持的平台。
-
-> [!TIP] "HarmonyOS Support"列为 yes 表示 HarmonyOS 平台支持该属性;no 则表示不支持;partially 表示部分支持。使用方法跨平台一致,效果对标 iOS 或 Android 的效果。
+| Name | Description | Type | Required | Platform | HarmonyOS Support |
+| ----------------- | ------------------------------- | -------------- | -------- | ----------- | ----------------- |
+| Children | Any children that can throw an error | React.Children | Yes | iOS/Android | Yes |
+| FallbackComponent | The fallback component that will be rendered after catching an error. By default the library comes with a built-in component. | React.Component | No | iOS/Android | Yes |
+| onError | A function to log the errors that happen in your application | Function | No | iOS/Android | Yes |
+#### FallbackComponent
+| Name | Description | Type | Required | Platform | HarmonyOS Support |
+| ----------------- | ------------------------------- | -------------- | -------- | ----------- | ----------------- |
+| error | The error object | Error | Yes | iOS/Android | Yes |
+| resetError | A function to reset the error state. You'll want to call this function to recover from the error state. | Function | Yes | iOS/Android | Yes |
+#### onError
+```js
+onError(error: Error, stackTrace: string): void
+```
+| Name | Description | Type | Required | Platform | HarmonyOS Support |
+| ----------------- | ------------------------------- | -------------- | -------- | ----------- | ----------------- |
+| error | The error catched by the component | Error | Yes | iOS/Android | Yes |
+| stackTrace | The stacktrace of the error | string | Yes | iOS/Android | Yes |
-| Name | Description | Type | Required | Platform | HarmonyOS Support |
-| :--- | :--- | :--- | :--- | :--- | :--- |
-| `title` | 按钮的标题,必填 | string | no | iOS/Android | yes |
-| `style` | 应用于包裹文本的可触摸元素的样式 | `ViewStyle` | no | iOS/Android | yes |
-| `onPress` | 按下时调用的函数 | function | no | iOS/Android | yes |
-| `renderButton` | 你可以使用 renderButton 完全自定义 PlatformPressable 内部渲染的内容 | ReactNode | no | iOS/Android | yes |
## 遗留问题
## 其他
-- left属性描述错误 [issue#248](https://github.com/vonovak/react-navigation-header-buttons/issues/248)
-
## 开源协议
-本项目基于 [The MIT License (MIT)](https://github.com/vonovak/react-navigation-header-buttons/blob/master/LICENSE) ,请自由地享受和参与开源。
\ No newline at end of file
+本项目基于 [The MIT License (MIT)](https://github.com/carloscuesta/react-native-error-boundary/blob/master/LICENSE) ,请自由地享受和参与开源。
diff --git a/zh-cn/react-native-paper.md b/zh-cn/react-native-paper.md
index ae3f5c6e01643a3493d60123cd847336dc352dde..352cce38dc8b62960239b620a562ff824588877b 100644
--- a/zh-cn/react-native-paper.md
+++ b/zh-cn/react-native-paper.md
@@ -18,17 +18,36 @@
## 安装与使用
+| 三方库版本 | 支持RN版本 |
+| ---------- | ---------- |
+| 5.12.3 | 0.72 |
+| 5.14.5 | 0.77 |
+
+进入到工程目录并输入以下命令:
+
#### **yarn**
```bash
+# V5.12.3
yarn add react-native-paper@5.12.3
```
+
+```bash
+# V5.14.5
+yarn add react-native-paper@5.14.5
+```
#### **npm**
```bash
+# V5.12.3
npm install react-native-paper@5.12.3
```
+```bash
+# V5.14.5
+npm install react-native-paper@5.14.5
+```
+
**下面的代码展示了这个库的基本使用场景:**
@@ -37,7 +56,7 @@ npm install react-native-paper@5.12.3
paper使用需要安装react-native-safe-area-context来处理安全区域。另外还需要依赖react-native-vector-icons库,具体来说,MaterialCommunityIcons图标包需要包含在项目中,因为有些组件在内部使用它。
-1.将根组件包装在PaperProvider中。如果您有一个原始的 React Native 项目,最好将其添加到传递给 的组件中AppRegistry.registerComponent。这通常在index.js文件中
+1.将根组件包装在PaperProvider中。如果您有一个原始的 React Native 项目,最好将其添加到传递给入口文件的AppRegistry.registerComponent。这通常在index.js文件中
```js
import { AppRegistry } from 'react-native';
@@ -553,6 +572,7 @@ export default function App() {
| theme | theme | ThemeProp | NO | All | Yes |
| touchableRef | Reference for the touchable | React.RefObject | NO | All | Yes |
| testID | string | testID to be used on tests. | NO | All | Yes |
+| hitSlop15.4.5+ | Sets additional distance outside of element in which a press can be detected. | TouchableRippleProps['hitSlop'] | NO | All | Yes |
**Card**:A card is a sheet of material that serves as an entry point to more detailed information.
| Name | Description | Type | Required | Platform | HarmonyOS Support |
@@ -567,7 +587,7 @@ export default function App() {
| disabled | TIf true, disable all interactions for this component. | boolean | NO | All | Yes |
| elevation | Changes Card shadow and background on iOS and Android. | Animated.Value | NO | All | Yes |
| contentStyle | Style of card's inner content. | StyleProp | NO | All | Yes |
-| style | style | StyleProp | NO | All | Yes |
+| style | style | Animated.WithAnimatedValue> | NO | All | Yes |
| theme | theme | ThemeProp | NO | All | Yes |
| testID | Pass down testID from card props to touchable | string | NO | All | Yes |
| accessible | Pass down accessible from card props to touchable | boolean | NO | All | Yes |
@@ -671,6 +691,7 @@ export default function App() {
| testID | string | ThemeProp | NO | All | Yes |
| position | Checkbox control position. | leading \| trailing | NO | All | Yes |
| mode | Whether or should be used. Left undefined will be used. | android \| ios | NO | All | Yes |
+| hitSlop15.4.5+ | Sets additional distance outside of element in which a press can be detected. | TouchableRippleProps['hitSlop'] | NO | All | Yes |
**Chip**:Chips are compact elements that can represent inputs, attributes, or actions
@@ -705,6 +726,7 @@ export default function App() {
| ellipsizeMode | Ellipsize Mode for the children text | EllipsizeProp | NO | All | Yes |
| maxFontSizeMultiplier | Specifies the largest possible scale a text font can reach. | number | NO | All | Yes |
| accessibilityRole | Default value: 'button' | string | NO | All | Yes |
+| hitSlop15.4.5+ | Sets additional distance outside of element in which a press can be detected. | TouchableRippleProps['hitSlop'] | NO | All | Yes |
**DataTable**:Data tables allow displaying sets of data.
@@ -865,6 +887,7 @@ export default function App() {
| rippleColor | Color of the ripple effect. | ColorValue | NO | All | Yes |
| style | style | StyleProp | NO | All | Yes |
| theme | theme | ThemeProp | NO | All | Yes |
+| hitSlop15.4.5+ | Sets additional distance outside of element in which a press can be detected. | TouchableRippleProps['hitSlop'] | NO | All | Yes |
**Drawer.Section**:A component to group content inside a navigation drawer.
| Name | Description | Type | Required | Platform | HarmonyOS Support |
@@ -929,6 +952,7 @@ export default function App() {
| style | style | StyleProp | NO | All | Yes |
| theme | theme | ThemeProp | NO | All | Yes |
| testID | TestID used for testing purposes | string | NO | All | Yes |
+| hitSlop15.4.5+ | Sets additional distance outside of element in which a press can be detected. | TouchableRippleProps['hitSlop'] | NO | All | Yes |
**FAB.Group**:A component to display a stack of FABs with related actions in a speed dial.
| Name | Description | Type | Required | Platform | HarmonyOS Support |
@@ -991,6 +1015,7 @@ export default function App() {
| theme | theme | ThemeProp | NO | All | Yes |
| testID | TestID used for testing purposes | string | NO | All | Yes |
| loading | Whether to show a loading indicator. | boolean | NO | All | Yes |
+| contentStyle15.4.5+ | Style of button's inner content. Use this prop to apply custom height and width or to set a custom padding`. | StyleProp | NO | All | Yes |
**List.Accordion**:A component used to display an expandable list item.
| Name | Description | Type | Required | Platform | HarmonyOS Support |
@@ -1017,6 +1042,9 @@ export default function App() {
| testID | TestID used for testing purposes | string | NO | All | Yes |
| accessibilityLabel | Accessibility label for the TouchableRipple. This is read by the screen reader when the user taps the touchable. | string | NO | All | Yes |
| pointerEvents | pointerEvents passed to the View container | ViewProps['pointerEvents'] | NO | Android | NO |
+| hitSlop15.4.5+ | Sets additional distance outside of element in which a press can be detected. | TouchableRippleProps['hitSlop'] | NO | All | Yes |
+| contentStyle15.4.5+ | Style of button's inner content. Use this prop to apply custom height and width or to set a custom padding`. | StyleProp | NO | All | Yes |
+| containerStyle15.4.5+ | Style that is passed to the outermost container that wraps the entire content, including left and right items and both title and description. | StyleProp | NO | All | Yes |
**List.AccordionGroup**:List.AccordionGroup allows to control a group of List Accordions.
| Name | Description | Type | Required | Platform | HarmonyOS Support |
@@ -1053,6 +1081,7 @@ export default function App() {
| descriptionMaxFontSizeMultiplier | Specifies the largest possible scale a description font can reach. | number | NO | All | Yes |
| descriptionEllipsizeMode | Ellipsize Mode for the Description. One of 'head', 'middle', 'tail', 'clip'. | 'head' 'middle' 'tail' 'clip' | NO | All | Yes |
| testID | TestID used for testing purposes | string | NO | All | Yes |
+| containerStyle15.4.5+ | Style that is passed to the outermost container that wraps the entire content, including left and right items and both title and description. | StyleProp | NO | All | Yes |
**List.Section**:A component used to group list items.
| Name | Description | Type | Required | Platform | HarmonyOS Support |
@@ -1082,7 +1111,7 @@ export default function App() {
| children (required) | Content of the Menu | React.ReactNode | Yes | All | Yes |
| style | style | StyleProp | NO | All | Yes |
| contentStyle | Style of menu's inner content. | Animated.WithAnimatedValue> | NO | All | Yes |
-| theme | theme | InternalTheme | NO | All | Yes |
+| theme | theme | ThemeProp | NO | All | Yes |
| keyboardShouldPersistTaps | Inner ScrollView prop | crollViewProps['keyboardShouldPersistTaps'] | NO | All | Yes |
| testID | testID to be used on tests. | string | NO | All | Yes |
@@ -1101,16 +1130,18 @@ export default function App() {
| contentStyle | contentStyle | StyleProp | NO | All | Yes |
| titleStyle | titleStyle | StyleProp | NO | All | Yes |
| rippleColor | titleStyle | ColorValue | NO | All | Yes |
-| theme | Color of the ripple effect. | InternalTheme | NO | All | Yes |
+| theme | Color of the ripple effect. | ThemeProp | NO | All | Yes |
| testID | TestID used for testing purposes| string | NO | All | Yes |
| accessibilityLabel | Accessibility label for the Touchable. | string | NO | All | Yes |
| accessibilityState | Accessibility state for the Touchable. | accessibilityState | NO | All | Yes |
+| hitSlop15.4.5+ | Sets additional distance outside of element in which a press can be detected. | TouchableRippleProps['hitSlop'] | NO | All | Yes |
+| containerStyle15.4.5+ | Style that is passed to the outermost container that wraps the entire content, including left and right items and both title and description. | StyleProp | NO | All | Yes |
**Modal**:The Modal component is a simple way to present content above an enclosing view.
| Name | Description | Type | Required | Platform | HarmonyOS Support |
| :-----: | :---------: | :-------------: | -------- | -------- | ----------------- |
| dismissable | Determines whether clicking outside the modal dismiss it. | boolean | NO | All | Yes |
-| dismissableBackButton | Determines whether clicking Android hardware back button dismiss dialog. | boolean | NO | All | Yes |
+| dismissableBackButton | Determines whether clicking Android hardware back button dismiss dialog. | boolean | NO | Android | No |
| onDismiss | Callback that is called when the user dismisses the modal.| () => void | NO | All | Yes |
| overlayAccessibilityLabel | Callback that is called when the user dismisses the modal.| () => void | NO | All | Yes |
| visible | Determines Whether the modal is visible. | boolean | NO | All | Yes |
@@ -1185,6 +1216,7 @@ export default function App() {
| testID | testID to be used on tests. | string | NO | All | Yes |
| mode | Whether or should be used. Left undefined will be used. | android \| ios | NO | All | Yes |
| position | Radio button control position. | leading \| trailing | NO | All | Yes |
+| hitSlop15.4.5+ | Sets additional distance outside of element in which a press can be detected. | TouchableRippleProps['hitSlop'] | NO | All | Yes |
**Searchbar**:Searchbar is a simple input box where users can type search queries.
| Name | Description | Type | Required | Platform | HarmonyOS Support |
@@ -1242,6 +1274,7 @@ export default function App() {
| theme | theme | string | NO | All | Yes |
| ref | ref | React.RefObject | NO | All | Yes |
| testID | string | TestID used for testing purposes | NO | All | Yes |
+| contentStyle15.4.5+ | Style for the content of the snackbar | StyleProp | NO | All | Yes |
**Surface**:Surface is a basic container that can give depth to an element with elevation shadow.
| Name | Description | Type | Required | Platform | HarmonyOS Support |
diff --git a/zh-cn/react-native-reanimated-carousel.md b/zh-cn/react-native-reanimated-carousel.md
index 0a2d1fc7710ad05e1e76b9f16783aeb971482fc6..9ed5cb44f76958006c46a1088f9fe7374abb0a96 100644
--- a/zh-cn/react-native-reanimated-carousel.md
+++ b/zh-cn/react-native-reanimated-carousel.md
@@ -235,7 +235,7 @@ const styles = StyleSheet.create({
| onScrollStart4.0.2+ | Callback fired when scroll start | no | | () => void | All | yes |
| onScrollEnd | Callback fired when scroll end | no | | (index: number) => void | All | yes |
| withAnimation | Specifies the scrolling animation effect | no | | {type: 'spring';config: WithSpringConfig;} \| {type: 'timing';config: WithTimingConfig;} | All | yes |
-| panGestureHandlerProps | PanGestureHandler props | no | {} | Omit,'onHandlerStateChange'> | All | yes |
+| panGestureHandlerPropsdeprecated from 4.0.2 | PanGestureHandler props | no | {} | Omit,'onHandlerStateChange'> | All | yes |
| windowSize | The maximum number of items that can respond to pan gesture events, `0` means all items will respond to pan gesture events | no | 0 | number | All | yes |
| onProgressChange | On progress change. `offsetProgress`:Total of offset distance (0 390 780 ...); `absoluteProgress`:Convert to index (0 1 2 ...) | no | | onProgressChange?: (offsetProgress: number,absoluteProgress: number) => void | All | yes |
| pagingEnabled | When true, the scroll view stops on multiples of the scroll view's size when scrolling | no | true | boolean | All | yes |
@@ -245,6 +245,9 @@ const styles = StyleSheet.create({
| customConfig | Custom carousel config | no | | () => {type?: 'negative' \| 'positive';viewCount?: number;} | All | yes |
| customAnimation | Custom animations | no | | (value: number) => Animated.AnimatedStyleProp | All | yes |
| maxScrollDistancePerSwipe | Maximum offset value for one scroll. If `props.vertical = true`, this will be `maxScrollDistancePerSwipeY`. If `props.vertical = false`, this will be `maxScrollDistancePerSwipeX`. | no | | number | All | yes |
+| fixedDirection4.0.2+ | If positive, the carousel will scroll to the positive direction and vice versa. | no | | 'positive' \| 'negative | All | yes |
+| onConfigurePanGesture4.0.2+ | PanGesture config | no | | onConfigurePanGesture?: (panGesture: PanGesture) => void | All | yes |
+| minScrollDistancePerSwipe4.0.2+ | Minimum offset value for once scroll. If the translation value is less than this value, the carousel will not scroll. | no | | number | All | yes |
### `modeConfig` Parallax
diff --git a/zh-cn/react-native-reanimated-table.md b/zh-cn/react-native-reanimated-table.md
index fdad8be87660bb39da8ebcd4cb3e966dfdecafaa..a03a0d200f40507b9555f0652501ba03db74693a 100644
--- a/zh-cn/react-native-reanimated-table.md
+++ b/zh-cn/react-native-reanimated-table.md
@@ -18,6 +18,11 @@
## 安装与使用
+| 三方库版本 | 支持RN版本 |
+| ------------- | ---------- |
+| 0.0.2 | 0.72 |
+| 0.2.0-alpha.1 | 0.77 |
+
进入到工程目录并输入以下命令:
@@ -25,13 +30,21 @@
#### npm
```bash
+# V0.0.2
npm install react-native-reanimated-table@0.0.2
+
+# V0.2.0-alpha.1
+npm install react-native-reanimated-table@0.2.0-alpha.1
```
#### yarn
```bash
+# V0.0.2
yarn add react-native-reanimated-table@0.0.2
+
+# V0.2.0-alpha.1
+yarn add react-native-reanimated-table@0.2.0-alpha.1
```
diff --git a/zh-cn/react-native-shadow-2.md b/zh-cn/react-native-shadow-2.md
index 070f15695e966d6549cce881e9553359380411e2..c6d69255543331a1926bf66330f6390d5b5c637e 100644
--- a/zh-cn/react-native-shadow-2.md
+++ b/zh-cn/react-native-shadow-2.md
@@ -210,10 +210,10 @@ const styles = StyleSheet.create({
| startColor | 阴影的起始渐变色。 | string | no | All | yes |
| endColor | 阴影的结束渐变色。 | string | no | All | yes |
| distance | 阴影的延伸距离。 | number | no | All | yes |
-| offset | 移动阴影。负x值使其向左/起点移动,负y值使其向上移动。接受 'x%' 格式的百分比值。设置此属性会将 `paintInside` 的默认值设为 true,因为这通常是期望的行为。 | [x: string \| number, y: string \| number] | no | All | yes |
-| paintInside | 将阴影应用于内容的下方/内部。`startColor` 将被用作无渐变的填充色。当使用 `offset` 属性或子组件包含透明区域时,此属性很有用。 | boolean | no | All | yes |
+| offset | 移动阴影。负x值使其向左/起点移动,负y值使其向上移动。接受 'x%' 格式的百分比值。设置此属性会将 `paintInside` 的默认值设为 true,因为这通常是期望的行为。 | [x: string \| number, y: string \| number] | no | All | no |
+| paintInside | 将阴影应用于内容的下方/内部。`startColor` 将被用作无渐变的填充色。当使用 `offset` 属性或子组件包含透明区域时,此属性很有用。 | boolean | no | All | no |
| sides | 指定将要绘制阴影的边。不包括角落。未定义的边将默认设为 true。 | Record<'start' \| 'end' \| 'top' \| 'bottom', boolean> | no | All | yes |
-| corners | 指定将要绘制阴影的角。未定义的角将默认设为 true。 | Record<'topStart' \| 'topEnd' \| 'bottomStart' \| 'bottomEnd', boolean> | no | Android | yes |
+| corners | 指定将要绘制阴影的角。未定义的角将默认设为 true。 | Record<'topStart' \| 'topEnd' \| 'bottomStart' \| 'bottomEnd', boolean> | no | Android | no |
| style | 包裹子组件的视图(View)的样式。 | StyleProp | no | All | yes |
| containerStyle | 包裹阴影和子组件的视图的样式。对于设置外边距(margins)很有用。 | StyleProp | no | All | yes |
| stretch | 使子组件占据所有可用的水平空间。 | boolean | no | All | yes |
diff --git a/zh-cn/react-native-testing-library.md b/zh-cn/react-native-testing-library.md
index 6bbaa1ba8924c0d1cda96396eefff05f91b78927..ddb79ea81d78ded468954774d0a2cdf482ba0dad 100644
--- a/zh-cn/react-native-testing-library.md
+++ b/zh-cn/react-native-testing-library.md
@@ -18,6 +18,11 @@
## 安装与使用
+| 三方库版本 | 支持RN版本 |
+| ---------- | ---------- |
+| 12.5.1 | 0.72 |
+| 13.0.1 | 0.77 |
+
本库需要和测试运行器一起使用,本文档以Jest测试框架作为示例演示。
进入到工程目录并输入以下命令:
@@ -28,20 +33,32 @@
```bash
npm install -D jest@29.7.0
+
+# V12.5.1
npm install -D @testing-library/react-native@12.5.1
+
+# V13.0.1
+npm install -D @testing-library/react-native@13.0.1
```
#### **yarn**
```bash
yarn add -D jest@29.7.0
+
+# V12.5.1
yarn add -D @testing-library/react-native@12.5.1
+
+# V13.0.1
+yarn add -D @testing-library/react-native@13.0.1
```
配置Jest匹配器,目前有两种配置方法:
+> [!TIP V12.5.1需要引入]
+
方法一:在jest-setup.ts中引入:
```js
@@ -50,6 +67,8 @@ import '@testing-library/react-native/extend-expect';
方法二:在jest.config.js中配置:
+> [!TIP V12.5.1需要引入]
+
```json
{
"preset": "react-native",
@@ -152,6 +171,15 @@ test('form submits two answers', async () => {
| act | action | function | no | All | yes |
| cleanup | Unmounts React trees that were mounted with `render` and clears `screen` variable that holds latest `render` output. | function | no | All | yes |
+### RenderOptions
+
+| name | Description | Type | Required | Platform | HarmonyOS Support |
+| ------------------------------------------ | ------------------------------------------------------------ | -------- | -------- | -------- | ----------------- |
+| wrapper | This option allows you to wrap the tested component, passed as the first option to the render() function, in an additional wrapper component. | function | no | All | yes |
+| concurrentRoot13.0.1+ | Set to `false` to disable concurrent rendering. Otherwise, `render` will default to using concurrent rendering used in the React Native New Architecture. | boolean | no | All | yes |
+| createNodeMock | This option allows you to pass `createNodeMock` option to `ReactTestRenderer.create()` method in order to allow for custom mock refs. | function | no | All | yes |
+| unstable_validateStringsRenderedWithinText | This experimental option allows you to replicate React Native behavior of throwing Invariant Violation | boolean | no | All | yes |
+
### screen
> [!TIP] "\*"号表示省略了变体或者谓词部;查询接口由两部分组成:变体和谓词,它们之间由单词by分隔,例如: getBy\*是查询变体,\*ByRole是谓词;变体和谓词之间可以任意组合。
diff --git a/zh-cn/reassure.md b/zh-cn/reassure.md
index be29237e17ff27fe8f59e7ac731668de08346312..939780f706833a40550d37cdd56e33414dfd363c 100644
--- a/zh-cn/reassure.md
+++ b/zh-cn/reassure.md
@@ -19,18 +19,31 @@
## 安装与使用
+| 三方库版本 | 支持RN版本 |
+| ---------- | ---------- |
+| 1.0.0 | 0.72 |
+| 1.4.0 | 0.77 |
+
#### **npm**
```bash
+# V1.0.0
npm install reassure@1.0.0
+
+# V1.4.0
+npm install reassure@1.4.0
```
#### **yarn**
```bash
+# V1.0.0
yarn add reassure@1.0.0
+
+# V1.4.0
+yarn add reassure@1.4.0
```
diff --git a/zh-cn/recyclerlistview.md b/zh-cn/recyclerlistview.md
index a2fc67cc069b65e426f68bb1a2df3c84d22a952d..4b77277abebba89c98cb7f48814fc992251e1117 100644
--- a/zh-cn/recyclerlistview.md
+++ b/zh-cn/recyclerlistview.md
@@ -16,6 +16,11 @@
## 安装与使用
+| 三方库版本 | 支持RN版本 |
+| ---------- | ---------- |
+| 4.2.0 | 0.72 |
+| 4.2.3 | 0.77 |
+
进入到工程目录并输入以下命令:
@@ -23,13 +28,21 @@
#### **npm**
```bash
+# V4.2.0
npm install recyclerlistview@4.2.0
+
+# V4.2.3
+npm install recyclerlistview@4.2.3
```
#### **yarn**
```bash
+# V4.2.0
yarn add recyclerlistview@4.2.0
+
+# V4.2.3
+yarn add recyclerlistview@4.2.3
```
@@ -210,6 +223,24 @@ const styles = {
| onItemLayout | A callback function that is executed
when an item of the recyclerListView
(at an index) has been layout. This can also be used as a proxy to itemsRendered kind of callbacks. | number | No | iOS Android | Yes |
| windowCorrectionConfig | Used to specify is window
correction config and whether
it should be applied to some
scroll events | object | No | iOS Android | Yes |
+## LayoutManager4.2.3+
+
+| Name | Description | Type | Required | Platform | HarmonyOS Support |
+| ------------------------------------------------------------ | ------------------------------------------------------------ | ------------ | ------------ | ------------ | ----------------- |
+| `public removeLayout(index: number): void` | when remove layout is called, it will remove the layout from the layouts array and if the layouts array is empty, it will reset the total height and total width to 0 | function | No | All | Yes |
+
+## ScrollComponent4.2.3+
+
+| Name | Description | Type | Required | Platform | HarmonyOS Support |
+| ------------------------------------------------------------ | ------------------------------------------------------------ | ------------ | ------------ | ------------ | ----------------- |
+| `public getNativeScrollRef(): ScrollView | null ` | Override and return ref to your custom scrollview. Useful if you need to use Animated Events on the new architecture. | function | No | All | Yes |
+
+## ComponentCompat4.2.3+
+
+| Name | Description | Type | Required | Platform | HarmonyOS Support |
+| ------------------------------------------------------------ | ------------------------------------------------------------ | ------------ | ------------ | ------------ | ----------------- |
+| `public getHasRenderedOnce(): boolean` | allow the extended component to access _hasRenderedOnce flag to ensure that the component has rendered at least once | function | No | All | Yes |
+
## 遗留问题
- [ ] 接口scrollThrottle不支持: [issue#785](https://github.com/Flipkart/recyclerlistview/issues/785)