From 35b12a32fb89ff53678a8c3ed410906e34e99650 Mon Sep 17 00:00:00 2001 From: 17792399693 Date: Mon, 1 Dec 2025 16:05:38 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B012=E4=B8=AA=E5=BA=93?= =?UTF-8?q?=E7=9A=84=E4=B8=AD=E8=8B=B1=E6=96=87=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: 17792399693 --- en/react-native-communications.md | 24 +++-- en/react-native-confetti-cannon.md | 21 ++-- en/react-native-easy-grid.md | 22 +++-- en/react-native-flash-message.md | 23 +++-- en/react-native-htmlview.md | 25 ++--- en/react-native-multiple-select.md | 20 ++-- en/react-native-offline.md | 19 ++-- en/react-native-root-siblings.md | 27 +++--- en/react-native-switch-selector.md | 23 +++-- en/react-native-transitiongroup.md | 36 ++++--- en/react-native-typing-animation.md | 27 +++--- en/remobile-react-native-toast.md | 41 +++----- zh-cn/react-native-communications.md | 28 +++--- zh-cn/react-native-confetti-cannon.md | 53 ++++++----- zh-cn/react-native-easy-grid.md | 22 ++--- zh-cn/react-native-flash-message.md | 71 +++++++------- zh-cn/react-native-htmlview.md | 40 ++++---- zh-cn/react-native-multiple-select.md | 127 +++++++++++++------------ zh-cn/react-native-offline.md | 65 ++++++------- zh-cn/react-native-root-siblings.md | 29 +++--- zh-cn/react-native-switch-selector.md | 97 ++++++++++--------- zh-cn/react-native-transitiongroup.md | 36 ++++--- zh-cn/react-native-typing-animation.md | 47 +++++---- zh-cn/remobile-react-native-toast.md | 58 ++++------- 24 files changed, 493 insertions(+), 488 deletions(-) diff --git a/en/react-native-communications.md b/en/react-native-communications.md index 7d888334..d06b3340 100644 --- a/en/react-native-communications.md +++ b/en/react-native-communications.md @@ -1,19 +1,20 @@ -> Template version: v0.2.2 +> Template version: v0.3.0

react-native-communications

-

- - Supported platforms - - - License - -

+ > [!TIP] [GitHub address](https://github.com/davebeehively/react-native-communications) +Please check the corresponding version information in the Releases section of the third-party library's repository: + +| Third-Party Library Version | Supported RN Version | +| ----------------------------| -------------------- | +| 2.2.1 | 0.72/0.77 | + +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. + ## Installation and Usage Go to the project directory and execute the following instruction: @@ -109,7 +110,10 @@ export default RNCommunications; This document is verified based on the following versions: -1.RNOH: 0.72.27; SDK: HarmonyOS-Next-DB1 5.0.0.25; IDE: DevEco Studio 5.0.3.400SP7; ROM: 3.0.0.25; +1. RNOH: 0.72.27; SDK: HarmonyOS-Next-DB1 5.0.0.25; 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.72.38; SDK: HarmonyOS-5.0.0(API12); ROM: 5.0.0.107; +4. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.868; ROM: 6.0.0.112; ## Static Methods diff --git a/en/react-native-confetti-cannon.md b/en/react-native-confetti-cannon.md index 51e549e0..16635e5c 100644 --- a/en/react-native-confetti-cannon.md +++ b/en/react-native-confetti-cannon.md @@ -1,20 +1,19 @@ -> Template version: v0.2.2 +> Template version: v0.3.0

react-native-confetti-cannon

-

- - Supported platforms - - - License - - -

> [!TIP] [ GitHub address](https://github.com/VincentCATILLON/react-native-confetti-cannon) +Please check the corresponding version information in the Releases section of the third-party library's repository: + +| Third-Party Library Version | Supported RN Version | +| ----------------------------| -------------------- | +| 1.5.2 | 0.72/0.77 | + +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. + ## Installation and Usage Go to the project directory and execute the following instruction: @@ -61,6 +60,8 @@ This document is verified based on the following versions: 1. RNOH: 0.72.27; OH 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; +3. RNOH: 0.72.38; SDK: HarmonyOS-5.0.0(API12); ROM: 5.0.0.107; +4. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.868; ROM: 6.0.0.112; ## Properties diff --git a/en/react-native-easy-grid.md b/en/react-native-easy-grid.md index 12f7e7d1..62e7753e 100644 --- a/en/react-native-easy-grid.md +++ b/en/react-native-easy-grid.md @@ -1,19 +1,20 @@ -> Template version: v0.2.2 +> Template version: v0.3.0

react-native-easy-grid

-

- - Supported platforms - - - License - -

> [!TIP] [GitHub address](https://github.com/GeekyAnts/react-native-easy-grid) +Please check the corresponding version information in the Releases section of the third-party library's repository: + +| Third-Party Library Version | Supported RN Version | +| ----------------------------| -------------------- | +| 0.2.2 | 0.72/0.77 | + +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. + + ## Installation and Usage Go to the project directory and execute the following instruction: @@ -67,7 +68,8 @@ export default App; This document is verified based on the following versions: -RNOH: 0.72.27; SDK: HarmonyOS-NEXT Developer Beta1 5.0.0.25 ; IDE: DevEco Studio 5.0.3.400SP7; ROM: 3.0.0.25; +1. RNOH: 0.72.27; SDK: HarmonyOS-NEXT Developer Beta1 5.0.0.25 ; IDE: DevEco Studio 5.0.3.400SP7; ROM: 3.0.0.25; +2. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.868; ROM: 6.0.0.112; ## Properties diff --git a/en/react-native-flash-message.md b/en/react-native-flash-message.md index dee67556..3b0056c5 100644 --- a/en/react-native-flash-message.md +++ b/en/react-native-flash-message.md @@ -1,19 +1,20 @@ -> Template version: v0.2.2 +> Template version: v0.3.0

react-native-flash-message

-

- - Supported platforms - - - License - -

> [!Tip] [GitHub address](https://github.com/lucasferreira/react-native-flash-message) +Please check the corresponding version information in the Releases section of the third-party library's repository: + +| Third-Party Library Version | Supported RN Version | +| ----------------------------| -------------------- | +| 0.4.2 | 0.72/0.77 | + +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. + + ## Installation and Usage Go to the project directory and execute the following instruction: @@ -106,7 +107,9 @@ const styles = StyleSheet.create({ This document is verified based on the following versions: -1.RNOH: 0.72.27; SDK: HarmonyOS-Next-DB1 5.0.0.25; IDE: DevEco Studio 5.0.3.400SP7; ROM: 3.0.0.25; +1. RNOH: 0.72.27; SDK: HarmonyOS-Next-DB1 5.0.0.25; 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.868; ROM: 6.0.0.112; ## Static Methods diff --git a/en/react-native-htmlview.md b/en/react-native-htmlview.md index d0ad55be..c0d1cdbf 100644 --- a/en/react-native-htmlview.md +++ b/en/react-native-htmlview.md @@ -1,20 +1,19 @@ -> Template version: v0.2.1 +> Template version: v0.3.0

react-native-htmlview

-

- - Supported platforms - - - License - - -

> [!TIP] [GitHub address](https://github.com/jsdf/react-native-htmlview) +Please check the corresponding version information in the Releases section of the third-party library's repository: + +| Third-Party Library Version | Supported RN Version | +| ----------------------------| -------------------- | +| 0.17.0 | 0.72/0.77 | + +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. + ## Installation and Usage Go to the project directory and execute the following instruction: @@ -91,7 +90,9 @@ export default HtmlViewExample; This document is verified based on the following versions: 1. RNOH: 0.72.20-CAPI; SDK: HarmonyOS NEXT Developer Preview2; IDE: DevEco Studio 4.1.3.700; ROM: 3.0.0.19; -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; +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.72.38; SDK: HarmonyOS-5.0.0(API12); ROM: 5.0.0.107; +4. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.868; ROM: 6.0.0.112; ## Properties @@ -111,7 +112,7 @@ This document is verified based on the following versions: | bullet | text which is rendered before every inside a ` li``ul ` | string | no | All | yes | | paragraphBreak | text which appears after every element`p` | string | no | All | yes | | lineBreak | text which appears after text elements which create a new line | string | no | All | yes | -| addLineBreaks | when explicitly , effectively sets | string | no | All | yes | +| addLineBreaks | when explicitly , effectively sets | boolean | no | All | yes | ## License diff --git a/en/react-native-multiple-select.md b/en/react-native-multiple-select.md index fe028c28..a6cf3b1d 100644 --- a/en/react-native-multiple-select.md +++ b/en/react-native-multiple-select.md @@ -1,19 +1,19 @@ -> Template version: v0.2.2 +> Template version: v0.3.0

react-native-multiple-select

-

- - Supported platforms - - - License - -

> [!TIP] [ GitHub address](https://github.com/toystars/react-native-multiple-select) +Please check the corresponding version information in the Releases section of the third-party library's repository: + +| Third-Party Library Version | Supported RN Version | +| ----------------------------| -------------------- | +| 0.5.12 | 0.72/0.77 | + +For older versions not published on npm, please refer to the [Installation Guide](/zh-cn/tgz-usage.md) to install the tgz package. + ## Installation and Usage Go to the project directory and execute the following instruction: @@ -151,6 +151,8 @@ This document is verified based on the following versions: 1. RNOH: 0.72.29; SDK: HarmonyOS NEXT Developer Beta6; IDE: DevEco Studio 5.0.3.706; ROM: 3.0.0.61; 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.72.38; SDK: HarmonyOS-5.0.0(API12); ROM: 5.0.0.107; +4. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.868; ROM: 6.0.0.112; ## Properties diff --git a/en/react-native-offline.md b/en/react-native-offline.md index 4e568d60..c9b91546 100644 --- a/en/react-native-offline.md +++ b/en/react-native-offline.md @@ -1,19 +1,19 @@ -> Template version: v0.2.2 +> Template version: v0.3.0

react-native-offline

-

- - Supported platforms - - - License - -

> [!TIP] [GitHub address](https://github.com/rgommezz/react-native-offline) +Please check the corresponding version information in the Releases section of the third-party library's repository: + +| Third-Party Library Version | Supported RN Version | +| ----------------------------| -------------------- | +| 6.0.2 | 0.72/0.77 | + +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. + ## Installation and Usage Go to the project directory and execute the following instruction: @@ -114,6 +114,7 @@ This document is verified based on the following versions: 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; +3. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.868; ROM: 6.0.0.112; ## Properties diff --git a/en/react-native-root-siblings.md b/en/react-native-root-siblings.md index c6e2512b..9c370e63 100644 --- a/en/react-native-root-siblings.md +++ b/en/react-native-root-siblings.md @@ -1,22 +1,23 @@ -> Template version: v0.2.2 +> Template version: v0.3.0

react-native-root-siblings

-

- - Supported platforms - - - License - - -

> [! TIP] [Github address](https://github.com/magicismight/react-native-root-siblings/tree/v5.0.1) +Please check the corresponding version information in the Releases section of the third-party library's repository: + +| Third-Party Library Version | Supported RN Version | +| ----------------------------| -------------------- | +| 5.0.1 | 0.72/0.77 | + +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. + ## Installation and Usage +Go to the project directory and execute the following instruction: + #### **npm** @@ -280,9 +281,9 @@ var styles = StyleSheet.create({ This document is verified based on the following versions: -RNOH: 0.72.23; SDK: HarmonyOS NEXT Developer Beta1; IDE: DevEco Studio: 5.0.3.27; ROM: 3.0.0.19; - -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; +1. RNOH: 0.72.23; SDK: HarmonyOS NEXT Developer Beta1; IDE: DevEco Studio: 5.0.3.27; ROM: 3.0.0.19; +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.868; ROM: 6.0.0.112; ## Static Methods diff --git a/en/react-native-switch-selector.md b/en/react-native-switch-selector.md index 7bb2d95d..50fb553e 100644 --- a/en/react-native-switch-selector.md +++ b/en/react-native-switch-selector.md @@ -1,21 +1,18 @@ -> Template version: v0.2.2 +> Template version: v0.3.0

react-native-switch-selector

-

- - Supported platforms - - - License - - -

+> [!TIP] [GitHub address](https://github.com/App2Sales/react-native-switch-selector) +Please check the corresponding version information in the Releases section of the third-party library's repository: -> [!TIP] [GitHub address](https://github.com/App2Sales/react-native-switch-selector) +| Third-Party Library Version | Supported RN Version | +| ----------------------------| -------------------- | +| 2.3.0 | 0.72/0.77 | + +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. ## Installation and Usage @@ -72,7 +69,9 @@ export default SwitchSelectorDemo; This document is verified based on the following versions: 1. RNOH：0.72.20; SDK：HarmonyOS NEXT Developer Beta1; IDE：DevEco Studio 5.0.3.200; ROM：3.0.0.18; -1. 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; +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.72.38; SDK: HarmonyOS-5.0.0(API12); ROM: 5.0.0.107; +4. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.868; ROM: 6.0.0.112; ## Properties diff --git a/en/react-native-transitiongroup.md b/en/react-native-transitiongroup.md index 92af9113..d980de60 100644 --- a/en/react-native-transitiongroup.md +++ b/en/react-native-transitiongroup.md @@ -1,23 +1,22 @@ -> Template version: v0.2.2 +> Template version: v0.3.0

react-native-transitiongroup

-

- - Supported platforms - - - Supported platforms - -

+This project is developed based on [react-native-transitiongroup@1.2.0](https://github.com/madsleejensen/react-native-transitiongroup). +Please check the corresponding version information in the Releases section of the third-party library's repository: -> [!TIP] [GitHub address](https://github.com/react-native-oh-library/react-native-transitiongroup) +| Version | Package Name | Repository | Release | RN Version | +| ------------------------------ | --------------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ | ---------- | +| 1.2.0 | @react-native-oh-tpl/react-native-transitiongroup | [GitHub](https://github.com/react-native-oh-library/react-native-transitiongroup) | [GitHub Releases](https://github.com/react-native-oh-library/react-native-transitiongroup/releases) +| 0.72 | +| 1.3.0 | @react-native-ohos/react-native-transitiongroup | [GitCode](https://gitcode.com/openharmony-sig/rntpc_react-native-transitiongroup) | [GitCode Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-transitiongroup/releases) | 0.77 | -## Installation and Usage +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. -Find the matching version information in the release address of a third-party library: [@react-native-oh-tpl/react-native-transitiongroup Releases](https://github.com/react-native-oh-library/react-native-transitiongroup/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. + +## Installation and Usage Go to the project directory and execute the following instruction: @@ -28,13 +27,21 @@ Go to the project directory and execute the following instruction: #### **npm** ```bash +#0.72 npm install @react-native-oh-tpl/react-native-transitiongroup + +#0.77 +npm install @react-native-ohos/react-native-transitiongroup ``` #### **yarn** ```bash +#0.72 yarn add @react-native-oh-tpl/react-native-transitiongroup + +#0.77 +yarn add @react-native-ohos/react-native-transitiongroup ``` @@ -146,9 +153,10 @@ const styles = StyleSheet.create({ ### 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/react-native-transitiongroup Releases](https://github.com/react-native-oh-library/react-native-transitiongroup/releases) +1. 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; +2. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.868; ROM: 6.0.0.112; ## APIs diff --git a/en/react-native-typing-animation.md b/en/react-native-typing-animation.md index a4f3fcbd..26fb1b15 100644 --- a/en/react-native-typing-animation.md +++ b/en/react-native-typing-animation.md @@ -1,21 +1,18 @@ -> Template version: v0.2.2 +> Template version: v0.3.0

react-native-typing-animation

-

- - Supported platforms - - - License - - -

+> [!TIP] [GitHub address](https://github.com/watadarkstar/react-native-typing-animation) + +Please check the corresponding version information in the Releases section of the third-party library's repository: +| Third-Party Library Version | Supported RN Version | +| ----------------------------| -------------------- | +| 0.1.7 | 0.72/0.77 | -> [!TIP] [GitHub address](https://github.com/watadarkstar/react-native-typing-animation) +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. ## Installation and Usage @@ -208,9 +205,10 @@ export default TypingAnimationDemos; This document is verified based on the following versions: -1.RNOH：0.72.20; SDK：HarmonyOS NEXT Developer Beta1; IDE：DevEco Studio 5.0.3.200; ROM：3.0.0.18; - -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; +1. RNOH：0.72.20; SDK：HarmonyOS NEXT Developer Beta1; IDE：DevEco Studio 5.0.3.200; ROM：3.0.0.18; +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.72.38; SDK: HarmonyOS-5.0.0(API12); ROM: 5.0.0.107; +4. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.868; ROM: 6.0.0.112; ## Properties @@ -229,7 +227,6 @@ This document is verified based on the following versions: | dotSpeed | Dot speed, the speed of the whole animation view; default is `0.15` | Integer | No | Android/ios | Yes | | dotY | Dot y, the starting y coordinate; default is 6 | Integer | No | Android/ios | Yes | | dotX | Dot x, the x coordinate of the center dot; default is `12` | Integer | No | Android/ios | Yes | -| show | Visibility, whether the whole animation view is displayed or not; default is true | Boolean | No | Android/ios | Yes | ## Known Issues diff --git a/en/remobile-react-native-toast.md b/en/remobile-react-native-toast.md index 4883e3b8..cc662500 100644 --- a/en/remobile-react-native-toast.md +++ b/en/remobile-react-native-toast.md @@ -1,32 +1,24 @@ -> Template version: v0.2.2 +> Template version: v0.3.0

@remobile/react-native-toast

-

- - Supported platforms - - - License - - -

-> [!TIP] [Github address](https://github.com/react-native-oh-library/react-native-toast) - -## Installation and Usage +This project is developed based on [react-native-toast@1.0.7](https://github.com/remobile/react-native-toast). -Please refer to the Releases page of the third-party library for the corresponding version information +Please refer to the Releases page of the third-party library for the corresponding version information: -| Third-party Library Version | Release Information | Supported RN Version | -| ---------- | ------------------------------------------------------------ | ---------- | -| 1.0.7@deprecated | [@react-native-oh-tpl/react-native-toast Releases(deprecated)](https://github.com/react-native-oh-library/react-native-toast/releases) | 0.72 | -| 1.0.8 | [@react-native-ohos/react-native-toast Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-toast/releases) | 0.72 | -| 1.1.0 | [@react-native-ohos/react-native-toast Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-toast/releases) | 0.77 | +| Version | Package Name | Repository | Release | RN Version | +| ------------------------------ | --------------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ | ---------- | +|1.0.7@deprecated | @react-native-oh-tpl/react-native-toast | [Github](https://github.com/react-native-oh-library/react-native-toast) | [Github Releases(deprecated)](https://github.com/react-native-oh-library/react-native-toast/releases) | 0.72 | +| 1.0.8 | @react-native-ohos/react-native-toast | [GitCode](https://gitcode.com/openharmony-sig/rntpc_react-native-toast) | [GitCode Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-toast/releases) | 0.72 | +| 1.1.0 | @react-native-ohos/react-native-toast | [GitCode](https://gitcode.com/openharmony-sig/rntpc_react-native-toast) | [GitCode Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-toast/releases) | 0.77 | For older versions not published on npm, please refer to the [Installation Guide](/zh-cn/tgz-usage.md) to install the tgz package. +## Installation and Usage + + Go to the project directory and execute the following instruction: @@ -257,15 +249,10 @@ 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. - -Please refer to the Releases page of the third-party library for the corresponding version information +This document content has been verified against the following environments: -| Third-party Library Version | Release Information | Supported RN Version | -| ---------- | ------------------------------------------------------------ | ---------- | -| 1.0.7@deprecated | [@react-native-oh-tpl/react-native-toast Releases(deprecated)](https://github.com/react-native-oh-library/react-native-toast/releases) | 0.72 | -| 1.0.8 | [@react-native-ohos/react-native-toast Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-toast/releases) | 0.72 | -| 1.1.0 | [@react-native-ohos/react-native-toast Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-toast/releases) | 0.77 | +1. 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; +2. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.868; ROM: 6.0.0.112; ## API diff --git a/zh-cn/react-native-communications.md b/zh-cn/react-native-communications.md index 78c6edf2..13961ca0 100644 --- a/zh-cn/react-native-communications.md +++ b/zh-cn/react-native-communications.md @@ -1,18 +1,19 @@ -> 模板版本：v0.2.2 +> 模板版本：v0.3.0

react-native-communications

-

- - Supported platforms - - - License - -

-> [!TIP] [Github 地址](https://github.com/davebeehively/react-native-communications) +> [!TIP] [GitHub address](https://github.com/davebeehively/react-native-communications) + +请到三方库的 Releases发布地址查看配套的版本信息： + +| 三方库版本 | 支持RN版本 | +| ----------| ---------- | +| 2.2.1 | 0.72/0.77 | + + +对于未发布到npm的旧版本，请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 ## 安装与使用 @@ -107,8 +108,11 @@ export default RNCommunications; 本文档内容基于以下版本验证通过： -1.RNOH: 0.72.27; SDK：HarmonyOS-Next-DB1 5.0.0.25; 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; +1. RNOH: 0.72.27; SDK：HarmonyOS-Next-DB1 5.0.0.25; 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.72.38; SDK: HarmonyOS-5.0.0(API12); ROM: 5.0.0.107; +4. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.868; ROM: 6.0.0.112; + ## 静态方法 > [!TIP] "Platform"列表示该属性在原三方库上支持的平台。 diff --git a/zh-cn/react-native-confetti-cannon.md b/zh-cn/react-native-confetti-cannon.md index 46c82e19..35846a34 100644 --- a/zh-cn/react-native-confetti-cannon.md +++ b/zh-cn/react-native-confetti-cannon.md @@ -1,19 +1,18 @@ -> 模板版本：v0.2.2 +> 模板版本：v0.3.0

react-native-confetti-cannon

-

- - Supported platforms - - - License - - -

-> [!TIP] [Github 地址](https://github.com/VincentCATILLON/react-native-confetti-cannon) +> [!TIP] [ GitHub address](https://github.com/VincentCATILLON/react-native-confetti-cannon) + +请到三方库的 Releases发布地址查看配套的版本信息： + +| 三方库版本 | 支持RN版本 | +| ----------| ---------- | +| 1.5.2 | 0.72/0.77 | + +对于未发布到npm的旧版本，请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 ## 安装与使用 @@ -65,6 +64,8 @@ export default function ConfettiCannonExample() { 1. RNOH: 0.72.27; OH 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; +3. RNOH: 0.72.38; SDK: HarmonyOS-5.0.0(API12); ROM: 5.0.0.107; +4. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.868; ROM: 6.0.0.112; ## 属性 @@ -74,14 +75,14 @@ export default function ConfettiCannonExample() { | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| count | items count to display | number | yes | iOS,Android,Web | yes | -| origin | animation position origin | {x: number, y: number} | yes | iOS,Android,Web | yes | -| explosionSpeed | explosion duration (ms) from origin to top | number | no | iOS,Android,Web | yes | -| fallSpeed | fall duration (ms) from top to bottom | number | no | iOS,Android,Web | yes | -| fadeOut | make the confettis disappear at the end | boolean | no | iOS,Android,Web | yes | -| colors | give your own colors to the confettis | string[] | no | iOS,Android,Web | yes | -| autoStart | auto start the animation | boolean | no | iOS,Android,Web | yes | -| autoStartDelay | delay to wait before triggering animation | number | no | iOS,Android,Web | yes | +| count | 要显示的项目数量 | number | yes | iOS,Android,Web | yes | +| origin | 动画位置起始点 | {x: number, y: number} | yes | iOS,Android,Web | yes | +| explosionSpeed | 从起始点到顶部的爆炸持续时间（毫秒） | number | no | iOS,Android,Web | yes | +| fallSpeed | 从顶部到底部的下降持续时间（毫秒） | number | no | iOS,Android,Web | yes | +| fadeOut | 使彩纸在结束时消失 | boolean | no | iOS,Android,Web | yes | +| colors | 为彩纸提供自定义颜色 | string[] | no | iOS,Android,Web | yes | +| autoStart | 自动开始动画 | boolean | no | iOS,Android,Web | yes | +| autoStartDelay | 触发动画前等待的延迟时间 | number | no | iOS,Android,Web | yes | ## 事件 @@ -92,10 +93,10 @@ export default function ConfettiCannonExample() { | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| onAnimationStart | callback triggered at animation start | Function | no | iOS,Android,Web | yes | -| onAnimationResume | callback triggered at animation resume | Function | no | iOS,Android,Web | yes | -| onAnimationStop | callback triggered at animation stop | Function | no | iOS,Android,Web | yes | -| onAnimationEnd | callback triggered at animation end | Function | no | iOS,Android,Web | yes | +| onAnimationStart | 动画开始时触发的回调函数 | Function | no | iOS,Android,Web | yes | +| onAnimationResume | 动画恢复时触发的回调函数 | Function | no | iOS,Android,Web | yes | +| onAnimationStop | 动画停止时触发的回调函数 | Function | no | iOS,Android,Web | yes | +| onAnimationEnd | 动画结束时触发的回调函数 | Function | no | iOS,Android,Web | yes | ## 静态方法 @@ -105,9 +106,9 @@ export default function ConfettiCannonExample() { | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| start | start the animation programmatically | Function | no | iOS,Android,Web | yes | -| resume | resume the animation programmatically | Function | no | iOS,Android,Web | yes | -| stop | stop the animation programmatically | Function | no | iOS,Android,Web | yes | +| start | 以编程方式启动动画 | Function | no | iOS,Android,Web | yes | +| resume | 以编程方式恢复动画 | Function | no | iOS,Android,Web | yes | +| stop | 以编程方式停止动画 | Function | no | iOS,Android,Web | yes | ## 遗留问题 diff --git a/zh-cn/react-native-easy-grid.md b/zh-cn/react-native-easy-grid.md index 6ad085d3..94eb8143 100644 --- a/zh-cn/react-native-easy-grid.md +++ b/zh-cn/react-native-easy-grid.md @@ -1,19 +1,18 @@ -> 模板版本：v0.2.2 +> 模板版本：v0.3.0

react-native-easy-grid

-

- - Supported platforms - - - License - -

-> [!TIP] [Github 地址](https://github.com/GeekyAnts/react-native-easy-grid) +> [!TIP] [GitHub address](https://github.com/GeekyAnts/react-native-easy-grid) + +请到三方库的 Releases发布地址查看配套的版本信息： + +| 三方库版本 | 支持RN版本 | +| ----------| ---------- | +| 0.2.2 | 0.72/0.77 | +对于未发布到npm的旧版本，请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 ## 安装与使用 @@ -73,7 +72,8 @@ export default App; 本文档内容基于以下版本验证通过： -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; +1. 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; +2. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.868; ROM: 6.0.0.112; ## 属性 diff --git a/zh-cn/react-native-flash-message.md b/zh-cn/react-native-flash-message.md index 5a0142f3..f1ad1ee2 100644 --- a/zh-cn/react-native-flash-message.md +++ b/zh-cn/react-native-flash-message.md @@ -1,18 +1,18 @@ -> 模板版本：v0.2.2 +> 模板版本：v0.3.0

react-native-flash-message

-

- - Supported platforms - - - License - -

-> [!Tip] [Github 地址](https://github.com/lucasferreira/react-native-flash-message) +> [!Tip] [GitHub address](https://github.com/lucasferreira/react-native-flash-message) + +请到三方库的 Releases发布地址查看配套的版本信息： + +| 三方库版本 | 支持RN版本 | +| ----------| ---------- | +| 0.4.2 | 0.72/0.77 | + +对于未发布到npm的旧版本，请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 ## 安装与使用 @@ -111,6 +111,7 @@ const styles = StyleSheet.create({ 1. RNOH: 0.72.27; SDK：HarmonyOS-Next-DB1 5.0.0.25; 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.868; ROM: 6.0.0.112; ## 方法 @@ -122,31 +123,31 @@ const styles = StyleSheet.create({ | Name | Description | Required | Platform | HarmonyOS Support | | ---------------------- | ----------- | -------- | ----------------- | ----------------- | -| hideOnPress | Controls if the flash message can be closed on press | NO | iOS/Android | YES | -| onPress | onPress callback for flash message press | NO | iOS/Android | YES | -| onLongPress | onLongPress callback for flash message press | NO | iOS/Android | YES | -| animated | Controls if the flash message will be shown with animation or not | NO | iOS/Android | YES | -| animationDuration | Animations duration/speed | NO | iOS/Android | YES | -| autoHide | Controls if the flash message can hide itself after some duration time | NO | iOS/Android | YES | -| duration | How many milliseconds the flash message will be shown if the autoHide it's true | NO | iOS/Android | YES | -| hideStatusBar | Controls if the flash message will auto hide the native status bar. Note: Works OK in iOS, not all Android versions support this. | NO | iOS/Android | YES | -| statusBarHeight | Use this prop to set a custom status bar height that will be add in flash message padding top calc | NO | iOS/Android | YES | -| floating | The floating prop unstick the message from the edges and applying some border radius to component | NO | iOS/Android | YES | -| position | The position prop set the position of a flash message. Expected options: "top" (default), "bottom", "center" or a custom object with { top, left, right, bottom } position | NO | iOS/Android | YES | -| icon | The icon prop could be a render function that return a new JSX Element to be placed in icon position OR a definition of the graphical icon of a flash message. Expected options: "none" (default), "auto" (guided by type), "success", "info", "warning", "danger", a custom icon (render function) or a custom object with icon type/name and position (left or right) attributes, e.g.: { icon: "success", position: "right" } | NO | iOS/Android | YES | -| style | Apply a custom style object in flash message container | NO | iOS/Android | YES | -| textStyle | Apply a custom style object in flash message descript/text text label | NO | iOS/Android | YES | -| titleStyle | Apply a custom style object in flash message title text label | NO | iOS/Android | YES | -| titleProps | Set a custom props object in flash message title text label | NO | iOS/Android | YES | -| textProps | Set a custom props object in flash message all text components | NO | iOS/Android | YES | -| iconProps | Set a custom props object to use inside the renderFlashMessageIcon method as third argument | NO | iOS/Android | YES | -| renderBeforeContent | Render custom JSX before title in flash message. | NO | iOS/Android | YES | -| renderCustomContent | Render custom JSX below title in flash message. | NO | iOS/Android | YES | -| renderAfterContent | Render custom JSX after the title (or description) of a flash message. | NO | iOS/Android | YES | -| renderFlashMessageIcon | Set a custom render function for inside message icons | NO | iOS/Android | YES | -| transitionConfig | Set the transition config function used in shown/hide anim interpolations | NO | iOS/Android | YES | -| canRegisterAsDefault | Use to handle if the instance can be registed as default/global instance | NO | iOS/Android | YES | -| MessageComponent | Set the default flash message render component used to show all the messages | NO | iOS/Android | YES | +| hideOnPress | 控制闪存消息是否可以通过按下关闭 | NO | iOS/Android | YES | +| onPress | 闪存消息按下的onPress回调 | NO | iOS/Android | YES | +| onLongPress | 闪存消息按下的onLongPress回调 | NO | iOS/Android | YES | +| animated | 控制闪存消息是否以动画形式显示 | NO | iOS/Android | YES | +| animationDuration | 动画持续时间/速度 | NO | iOS/Android | YES | +| autoHide | 控制闪存消息是否可以在一段时间后自动隐藏 | NO | iOS/Android | YES | +| duration | 如果autoHide为true，闪存消息将显示多少毫秒 | NO | iOS/Android | YES | +| hideStatusBar | 控制闪存消息是否会自动隐藏原生状态栏。注意：在iOS上工作正常，并非所有Android版本都支持此功能。 | NO | iOS/Android | YES | +| statusBarHeight | 使用此属性设置自定义状态栏高度，该高度将添加到闪存消息的顶部内边距计算中 | NO | iOS/Android | YES | +| floating | floating属性使消息从边缘分离，并对组件应用一些边框半径 | NO | iOS/Android | YES | +| position | position属性设置闪存消息的位置。预期选项："top"（默认）、"bottom"、"center"或带有{ top, left, right, bottom }位置的自定义对象 | NO | iOS/Android | YES | +| icon | icon属性可以是一个返回新JSX元素以放置在图标位置的渲染函数，或者是闪存消息的图形图标定义。预期选项："none"（默认）、"auto"（由类型引导）、"success"、"info"、"warning"、"danger"、自定义图标（渲染函数）或带有图标类型/名称和位置（左或右）属性的自定义对象，例如：{ icon: "success", position: "right" } | NO | iOS/Android | YES | +| style | 在闪存消息容器中应用自定义样式对象 | NO | iOS/Android | YES | +| textStyle | 在闪存消息描述/文本标签中应用自定义样式对象 | NO | iOS/Android | YES | +| titleStyle | 在闪存消息标题文本标签中应用自定义样式对象 | NO | iOS/Android | YES | +| titleProps | 在闪存消息标题文本标签中设置自定义props对象 | NO | iOS/Android | YES | +| textProps | 在闪存消息所有文本组件中设置自定义props对象 | NO | iOS/Android | YES | +| iconProps | 设置自定义props对象以在renderFlashMessageIcon方法中作为第三个参数使用 | NO | iOS/Android | YES | +| renderBeforeContent | 在闪存消息标题之前渲染自定义JSX。 | NO | iOS/Android | YES | +| renderCustomContent | 在闪存消息标题下方渲染自定义JSX。 | NO | iOS/Android | YES | +| renderAfterContent | 在闪存消息的标题（或描述）之后渲染自定义JSX。 | NO | iOS/Android | YES | +| renderFlashMessageIcon | 为内部消息图标设置自定义渲染函数 | NO | iOS/Android | YES | +| transitionConfig | 设置用于显示/隐藏动画插值的过渡配置函数 | NO | iOS/Android | YES | +| canRegisterAsDefault | 用于处理实例是否可以注册为默认/全局实例 | NO | iOS/Android | YES | +| MessageComponent | 设置用于显示所有消息的默认闪存消息渲染组件 | NO | iOS/Android | YES | ## 遗留问题 diff --git a/zh-cn/react-native-htmlview.md b/zh-cn/react-native-htmlview.md index 8bad1aa6..b0650d75 100644 --- a/zh-cn/react-native-htmlview.md +++ b/zh-cn/react-native-htmlview.md @@ -1,20 +1,18 @@ -> 模板版本：v0.2.2 +> 模板版本：v0.3.0

react-native-htmlview

-

- - Supported platforms - - - License - - -

+> [!TIP] [GitHub address](https://github.com/jsdf/react-native-htmlview) + +请到三方库的 Releases发布地址查看配套的版本信息： + +| 三方库版本 | 支持RN版本 | +| ----------| ---------- | +| 0.17.0 | 0.72/0.77 | -> [!TIP] [Github 地址](https://github.com/jsdf/react-native-htmlview) +对于未发布到npm的旧版本，请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 ## 安装与使用 @@ -93,6 +91,8 @@ export default HtmlViewExample; 1. RNOH: 0.72.20-CAPI; SDK: HarmonyOS NEXT Developer Preview2; IDE: DevEco Studio 4.1.3.700; ROM: 3.0.0.19; 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.72.38; SDK: HarmonyOS-5.0.0(API12); ROM: 5.0.0.107; +4. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.868; ROM: 6.0.0.112; ## 属性 @@ -104,15 +104,15 @@ export default HtmlViewExample; | Name | Description | Type | Required | Platform | HarmonyOS Support | | --------------- | ------------------------------------------------------------ | ------ | -------- | -------- | ----------------- | -| value | a string of HTML content to render | string | yes | All | yes | -| onLinkPress | a function which will be called with a url when a link is pressed. Passing this prop will override how links are handled | string | no | All | yes | -| onLinkLongPress | a function which will be called with a url when a link is long pressed. The default is | string | no | All | yes | -| stylesheet | a stylesheet object keyed by tag name, which will override the styles applied to those respective tags. | string | no | All | yes | -| renderNode | a custom function to render HTML nodes however you see fit. | string | no | All | yes | -| bullet | text which is rendered before every inside a `li``ul` | string | no | All | yes | -| paragraphBreak | text which appears after every element`p` | string | no | All | yes | -| lineBreak | text which appears after text elements which create a new line | string | no | All | yes | -| addLineBreaks | when explicitly , effectively sets | string | no | All | yes | +| value | 要渲染的HTML内容字符串 | string | yes | All | yes | +| onLinkPress | 当链接被点击时会调用此函数并传入URL。传递此属性将覆盖链接的处理方式 | string | no | All | yes | +| onLinkLongPress | 当链接被长按时会调用此函数并传入URL。默认行为是 | string | no | All | yes | +| stylesheet | 通过标签名称键控的样式表对象，将覆盖应用于这些相应标签的样式。 | string | no | All | yes | +| renderNode | 自定义函数，用于按您认为合适的方式渲染HTML节点。 | string | no | All | yes | +| bullet | 在`ul`内每个`li`元素前渲染的文本 | string | no | All | yes | +| paragraphBreak | 在每个`p`元素后出现的文本 | string | no | All | yes | +| lineBreak | 在创建新行的文本元素后出现的文本 | string | no | All | yes | +| addLineBreaks | 当明确设置时，有效设置为 | boolean | no | All | yes | ## 开源协议 diff --git a/zh-cn/react-native-multiple-select.md b/zh-cn/react-native-multiple-select.md index 8ea91e75..c9c9916f 100644 --- a/zh-cn/react-native-multiple-select.md +++ b/zh-cn/react-native-multiple-select.md @@ -1,19 +1,18 @@ -> 模板版本：v0.2.2 +> 模板版本：v0.3.0

react-native-multiple-select

-

- - Supported platforms - - - License - -

-> [!TIP] [Github 地址](https://github.com/toystars/react-native-multiple-select) +> [!TIP] [ GitHub address](https://github.com/toystars/react-native-multiple-select) + +请到三方库的 Releases发布地址查看配套的版本信息： + +| 三方库版本 | 支持RN版本 | +| ----------| ---------- | +| 0.5.12 | 0.72/0.77 | +对于未发布到npm的旧版本，请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 ## 安装与使用 @@ -150,6 +149,8 @@ RNApp({ 1. RNOH: 0.72.29; SDK: HarmonyOS NEXT Developer Beta6; IDE: DevEco Studio 5.0.3.706; ROM: 3.0.0.61; 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.72.38; SDK: HarmonyOS-5.0.0(API12); ROM: 5.0.0.107; +4. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.868; ROM: 6.0.0.112; ## 属性 @@ -159,59 +160,59 @@ RNApp({ | Prop | Description | Type | Required | Platform | HarmonyOS Support | | ----- | ----- | -------- | -------- | -------- | -------- | -| `altFontFamily` | Font family for searchInputPlaceholderText | String | no | All | yes | -| `canAddItems` | Defaults to "false". This allows a user to add items to the list of items provided. You need to handle adding the new items in the onAddItem function prop. Items may be added with the return key on the native keyboard| Boolean | no | All | yes | -| `displayKey` | Defaults to "name". This string will be used to select the key to display the objects in the items array| String | no | All | yes | -| `fixedHeight` | Defaults to false. Specifies if select dropdown take height of content or a fixed height with a scrollBar (There is an issue with this behavior when component is nested in a ScrollView in which scroll event will only be dispatched to parent ScrollView and select component won't be scrollable). See this issue for more info| Boolean | no | All | yes | -| `filterMethod` | Defaults to "partial". options: ["partial", "full"] Choose the logic on how the system filters items based on searchTerm. partial: checks all individual words and if at least one word matches will include that item. full: checks to ensure the item contains the full substring of searchterm in order minus any leading or trailing spaces| String | no | All | yes | -| `flatListProps` | Properties for the FlatList. Pass any property that is required on the FlatList of the dropdown menu| Object | no | All | yes | -| `fontFamily` | Custom font family to be used in component (affects all text except searchInputPlaceholderText described above)| String | no | All | yes | -| `fontSize` | Font size for selected item name displayed as label for multiselect.| Number | no | All | yes | -| `hideDropdown` | Defaults false. Hide dropdown menu with a cancel, and use arrow-back| Boolean | no | All | yes | -| `hideSubmitButton` | Defaults to false. Hide submit button from dropdown, and rather use arrow-button in search field| Boolean | no | All | yes | -| `hideTags` | Defaults to false. Hide tokenized selected items, in case selected items are to be shown somewhere else in view (check below for more info)| Boolean | no | All | yes | -| `searchIcon` | Element or functional component to change the Search Icon| Element, Object, boolean, Function | no | All | yes | -| `itemFontFamily` | Font family for each non-selected item in multi-select drop-down| String | no | All | yes | -| `itemFontSize` |Font size used for each item in the multi-select drop-down| Number | no | All | yes | -| `itemTextColor` | Text color for each non-selected item in multi-select drop-down| String | no | All | yes | -| `items` |List of items to display in the multi-select component. JavaScript Array of objects. Each object must contain a name and unique identifier (Check sample above)| Array, control prop | yes | All | yes | -| `noItemsText` | Text that replace default "no items to display"| String | no | All | yes | -| `onAddItem` | JavaScript function passed in as an argument. The function is called everytime a new item is added, and receives the entire list of items. Here you should ensure that the new items are added to your provided list of items in addition to any other consequences of new items being added| function | no | All | yes | -| `onChangeInput` | JavaScript function passed in as an argument. The function is called everytime TextInput is changed with the value| function | no | All | yes | -| `onClearSelector` | JavaScript function passeed in as an argument. The function is called everytime back button is pressed| function | no | All | yes | -| `onSelectedItemsChange` | JavaScript function passed in as an argument. The function is to be defined with an argument (selectedItems). Triggered when Submit button is clicked (for multi select) or item is clicked (for single select). (Check sample above)| function | yes | All | yes | -| `onToggleList` | JavaScript function passed in as an argument. The function is called everytime the multiselect component is pressed| function | no | All | yes | -| `searchInputPlaceholderText` | Placeholder text displayed in multi-select filter input| String | no | All | yes | -| `searchInputStyle` | Style object for multi-select input element| Object | no | All | yes | -| `selectText` | Text displayed in main component| String | no | All | yes | -| `selectedText` | Text displayed when an item is selected can be replaced by any string| String | no | All | yes | -| `selectedItemFontFamily` | Font family for each selected item in multi-select drop-down| String | no | All | yes | -| `selectedItemIconColor` | Color for selected check icon for each selected item in multi-select drop-down| String | no | All | yes | -| `selectedItemTextColor` |Text color for each selected item in multi-select drop-down| String | no | All | yes | -| `single` | Toggles select component between single option and multi option| Boolean | no | All | yes | -| `styleDropdownMenu` | Style the view of the dropdown menu| Style | no | All | yes | -| `styleDropdownMenuSubsection` |Style the inner view of the dropdown menu| Style | no | All | yes | -| `styleIndicator` | Style the Icon for indicator| Style | no | All | yes | -| `styleInputGroup` | Style the Container of the Text Input Group| Style | no | All | yes | -| `styleItemsContainer` |Style the Container of the items that are displayed in a list| Style | no | All | yes | -| `styleListContainer` | Style the Container of main list| Style | no | All | yes | -| `styleMainWrapper` | Style the Main Container of the MultiSelector| Style | no | All | yes | -| `styleRowList` | Style the Row that is displayed after you| Style | no | All | yes | -| `styleSelectorContainer` | Style the Container of the Selector when user clicks on the dropdown| Style | no | All | yes | -| `styleTextDropdown` | Style text of the Dropdown| Text Style | no | All | yes | -| `styleTextDropdownSelected` | Style text of the Dropdown selected| Text Style | no | All | yes | -| `styleTextTag` | Style text of the tag| Text Style | no | All | yes | -| `submitButtonColor` | Background color for submit button| String | no | All | yes | -| `submitButtonText` |Text displayed on submit button| String | no | All | yes | -| `tagBorderColor` | Border color for each selected item| String | no | All | yes | -| `tagContainerStyle` | Style the container of the tag view| Style | no | All | yes | -| `tagRemoveIconColor` | Color to be used for the remove icon in selected items list| String | no | All | yes | -| `tagTextColor` | Text color for selected items list| String | no | All | yes | -| `textColor` | Color for selected item name displayed as label for multiselect| String | no | All | yes | -| `textInputProps` | Properties for the Text Input. Pass any property that is required on the text input| Object | no | All | yes | -| `uniqueKey` | Unique identifier that is part of each item's properties. Used internally as means of identifying each item (Check sample below)| String | yes | All | yes | -| `selectedItems` | List of selected items keys . JavaScript Array of strings, that can be instantiated with the component| Array, control prop | no | All | yes | -| `removeSelected` | Filter selected items from list to be shown in List| Boolean | no | All | yes | +| `altFontFamily` | 搜索输入框占位符文本的字体族 | String | no | All | yes | +| `canAddItems` | 默认为"false"。这允许用户向提供的项目列表中添加项目。您需要在onAddItem函数属性中处理添加新项目。可以使用本机键盘上的回车键添加项目| Boolean | no | All | yes | +| `displayKey` | 默认为"name"。此字符串将用于选择在items数组中显示对象的键| String | no | All | yes | +| `fixedHeight` | 默认为false。指定选择下拉菜单是采用内容高度还是带滚动条的固定高度（当组件嵌套在ScrollView中时，此行为存在问题，滚动事件只会分派给父ScrollView，选择组件将不可滚动）。有关更多信息，请参见此问题| Boolean | no | All | yes | +| `filterMethod` | 默认为"partial"。选项：["partial", "full"] 选择系统根据搜索词过滤项目的逻辑。partial：检查所有单独的单词，如果至少有一个单词匹配，则包含该项目。full：检查以确保项目按顺序包含搜索词的完整子字符串，不包括任何前导或尾随空格| String | no | All | yes | +| `flatListProps` | FlatList的属性。传递下拉菜单FlatList所需的任何属性| Object | no | All | yes | +| `fontFamily` | 组件中使用的自定义字体族（影响除上述searchInputPlaceholderText之外的所有文本）| String | no | All | yes | +| `fontSize` | 多选中标记显示的选定项目名称的字体大小。| Number | no | All | yes | +| `hideDropdown` | 默认为false。隐藏带有取消按钮的下拉菜单，使用返回箭头| Boolean | no | All | yes | +| `hideSubmitButton` | 默认为false。从下拉菜单中隐藏提交按钮，而是在搜索字段中使用箭头按钮| Boolean | no | All | yes | +| `hideTags` | 默认为false。隐藏标记化的选定项目，以防选定项目在视图中的其他位置显示（请查看下面的更多信息）| Boolean | no | All | yes | +| `searchIcon` | 更改搜索图标的元素或功能组件| Element, Object, boolean, Function | no | All | yes | +| `itemFontFamily` | 多选下拉菜单中每个未选定项目的字体族| String | no | All | yes | +| `itemFontSize` | 多选下拉菜单中每个项目的字体大小| Number | no | All | yes | +| `itemTextColor` | 多选下拉菜单中每个未选定项目的文本颜色| String | no | All | yes | +| `items` | 在多选组件中显示的项目列表。JavaScript对象数组。每个对象必须包含名称和唯一标识符（请查看上面的示例）| Array, control prop | yes | All | yes | +| `noItemsText` | 替换默认"没有要显示的项目"的文本| String | no | All | yes | +| `onAddItem` | 作为参数传入的JavaScript函数。每次添加新项目时都会调用该函数，并接收整个项目列表。在这里，您应该确保将新项目添加到您提供的项目列表中，以及处理添加新项目的其他后果| function | no | All | yes | +| `onChangeInput` | 作为参数传入的JavaScript函数。每次TextInput更改时都会调用该函数，并传递值| function | no | All | yes | +| `onClearSelector` | 作为参数传入的JavaScript函数。每次按下返回按钮时都会调用该函数| function | no | All | yes | +| `onSelectedItemsChange` | 作为参数传入的JavaScript函数。该函数需要定义一个参数（selectedItems）。当点击提交按钮（多选）或点击项目（单选）时触发。（请查看上面的示例）| function | yes | All | yes | +| `onToggleList` | 作为参数传入的JavaScript函数。每次按下多选组件时都会调用该函数| function | no | All | yes | +| `searchInputPlaceholderText` | 多选过滤器输入框中显示的占位符文本| String | no | All | yes | +| `searchInputStyle` | 多选输入元素的样式对象| Object | no | All | yes | +| `selectText` | 主组件中显示的文本| String | no | All | yes | +| `selectedText` | 选择项目时显示的文本，可以替换为任何字符串| String | no | All | yes | +| `selectedItemFontFamily` | 多选下拉菜单中每个选定项目的字体族| String | no | All | yes | +| `selectedItemIconColor` | 多选下拉菜单中每个选定项目的选中复选图标的颜色| String | no | All | yes | +| `selectedItemTextColor` | 多选下拉菜单中每个选定项目的文本颜色| String | no | All | yes | +| `single` | 在单选和多选之间切换选择组件| Boolean | no | All | yes | +| `styleDropdownMenu` | 设置下拉菜单视图的样式| Style | no | All | yes | +| `styleDropdownMenuSubsection` | 设置下拉菜单内部视图的样式| Style | no | All | yes | +| `styleIndicator` | 设置指示器图标的样式| Style | no | All | yes | +| `styleInputGroup` | 设置文本输入组容器的样式| Style | no | All | yes | +| `styleItemsContainer` | 设置列表中显示的项目容器的样式| Style | no | All | yes | +| `styleListContainer` | 设置主列表容器的样式| Style | no | All | yes | +| `styleMainWrapper` | 设置多选器主容器的样式| Style | no | All | yes | +| `styleRowList` | 设置显示在您之后的行的样式| Style | no | All | yes | +| `styleSelectorContainer` | 设置用户点击下拉菜单时选择器容器的样式| Style | no | All | yes | +| `styleTextDropdown` | 设置下拉菜单文本的样式| Text Style | no | All | yes | +| `styleTextDropdownSelected` | 设置选定下拉菜单文本的样式| Text Style | no | All | yes | +| `styleTextTag` | 设置标签文本的样式| Text Style | no | All | yes | +| `submitButtonColor` | 提交按钮的背景颜色| String | no | All | yes | +| `submitButtonText` | 提交按钮上显示的文本| String | no | All | yes | +| `tagBorderColor` | 每个选定项目的边框颜色| String | no | All | yes | +| `tagContainerStyle` | 设置标签视图容器的样式| Style | no | All | yes | +| `tagRemoveIconColor` | 选定项目列表中用于移除图标的颜色| String | no | All | yes | +| `tagTextColor` | 选定项目列表的文本颜色| String | no | All | yes | +| `textColor` | 多选中标记显示的选定项目名称的颜色| String | no | All | yes | +| `textInputProps` | 文本输入的属性。传递文本输入所需的任何属性| Object | no | All | yes | +| `uniqueKey` | 每个项目属性中的唯一标识符。在内部用作识别每个项目的手段（请查看下面的示例）| String | yes | All | yes | +| `selectedItems` | 选定项目键的列表。JavaScript字符串数组，可以与组件一起实例化| Array, control prop | no | All | yes | +| `removeSelected` | 从列表中过滤选定的项目以在列表中显示| Boolean | no | All | yes | ## 遗留问题 diff --git a/zh-cn/react-native-offline.md b/zh-cn/react-native-offline.md index 7759c445..572f7c1b 100644 --- a/zh-cn/react-native-offline.md +++ b/zh-cn/react-native-offline.md @@ -1,18 +1,18 @@ -> 模板版本：v0.2.2 +> 模板版本：v0.3.0

react-native-offline

-

- - Supported platforms - - - License - -

-> [!TIP] [Github 地址](https://github.com/rgommezz/react-native-offline) +> [!TIP] [GitHub address](https://github.com/rgommezz/react-native-offline) + +请到三方库的 Releases发布地址查看配套的版本信息： + +| 三方库版本 | 支持RN版本 | +| ----------| ---------- | +| 6.0.2 | 0.72/0.77 | + +对于未发布到npm的旧版本，请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 ## 安装与使用 @@ -114,6 +114,7 @@ export const offlineDemoTest = () => { 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; +3. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.868; ROM: 6.0.0.112; ## 属性 @@ -123,21 +124,21 @@ export const offlineDemoTest = () => { | Name | Description | Type | Required | Platform | HarmonyOS Support | | --------------------- | ------------------------------------------------------------ | ----------- | -------- | --------------------- | ----------------- | -| children | a React Element. This is the only required prop. | React.Node | yes | Android、iOS、Windows | yes | -| pingTimeout | amount of time (in ms) that the component should wait for the ping response. Defaults to 10000 ms. If you want to use a different value, it's recommended to use a higher one. | number | no | Android、iOS、Windows | yes | -| pingServerUrl | remote server to ping to. Defaults to https://www.google.com/ since it's probably one the most stable servers out there, but you can provide your own if needed. Warning: www.google.com is a blocked domain in China, so if you need your app to be accessible from there, you MUST use another domain. | string | no | Android、iOS、Windows | yes | -| shouldPing | flag that denotes whether the extra ping check will be performed or not. Defaults to true. | boolean | no | Android、iOS、Windows | yes | -| pingInterval | the interval (in ms) you want to ping the server at. Defaults to 0, and that means it is not going to check connectivity regularly. If opted in, it's advised not to choose a very small value, because that may drain your battery. Choose wisely. Something around 30000 ms should be fine. | number | no | Android、iOS、Windows | yes | -| pingOnlyIfOffline | when set to true and pingInterval > 0, it will ping the remote server regularly only if offline. Defaults to false. | boolean | no | Android、iOS、Windows | yes | -| pingInBackground | whether or not to check connectivity when app isn't in the foreground. Defaults to false. | boolean | no | Android、iOS、Windows | yes | -| httpMethod | http method used to ping the server. Supports HEAD or OPTIONS. Defaults to HEAD. | HTTPMethod | no | Android、iOS、Windows | yes | -| customHeaders | optional custom headers to add for ping request. | HTTPHeaders | no | Android、iOS、Windows | yes | -| regexActionType | regular expression to indicate the action types to be intercepted in offline mode. By default it's configured to intercept actions for fetching data following the Redux convention. That means that it will intercept actions with types such as FETCH_USER_ID_REQUEST, FETCH_PRODUCTS_REQUEST etc. | RegExp | no | Android、iOS、Windows | yes | -| actionTypes | array with additional action types to intercept that don't fulfil the RegExp criteria. For instance, it's useful for actions that carry along refreshing data, such as REFRESH_LIST. | Arrays | no | Android、iOS、Windows | yes | -| queueReleaseThrottle | waiting time in ms between dispatches when flushing the offline queue. Useful to reduce the server pressure when coming back online. Defaults to 50ms. | number | no | Android、iOS、Windows | yes | -| shouldDequeueSelector | function that receives the redux application state and returns a boolean. It'll be executed every time an action is dispatched, before it reaches the reducer. This is useful to control if the queue should be released when the connection is regained and there were actions queued up. Returning true (the default behaviour) releases the queue, whereas returning false prevents queue release. For example, you may wanna perform some authentication checks, prior to releasing the queue. Note, if the result of shouldDequeueSelector changes while the queue is being released, the queue will not halt. If you want to halt the queue while is being released, please see relevant FAQ section. | boolean | no | Android、iOS、Windows | yes | -| url | remote server to ping to. Defaults to https://www.google.com/ since it's probably one the most stable servers out there, but you can provide your own if needed. Warning: www.google.com is a blocked domain in China, so if you need your app to be accessible from there, you MUST use another domain. | string | no | Android、iOS、Windows | yes | -| method | http method used to ping the server. Supports HEAD or OPTIONS. Defaults to HEAD. | HTTPMethod | no | Android、iOS、Windows | yes | +| children | 一个React元素。这是唯一必需的属性。 | React.Node | yes | Android、iOS、Windows | yes | +| pingTimeout | 组件应等待ping响应的时间（以毫秒为单位）。默认为10000毫秒。如果要使用不同的值，建议使用更高的值。 | number | no | Android、iOS、Windows | yes | +| pingServerUrl | 要ping的远程服务器。默认为https://www.google.com/，因为这可能是最稳定的服务器之一，但您可以根据需要提供自己的服务器。警告：www.google.com在中国是被屏蔽的域名，因此如果需要您的应用程序在那里可访问，您必须使用其他域名。 | string | no | Android、iOS、Windows | yes | +| shouldPing | 标志位，表示是否执行额外的ping检查。默认为true。 | boolean | no | Android、iOS、Windows | yes | +| pingInterval | 您想要ping服务器的时间间隔（以毫秒为单位）。默认为0，这意味着不会定期检查连接性。如果选择定期检查，建议不要选择很小的值，因为这可能会消耗电池。明智地选择。大约30000毫秒应该比较合适。 | number | no | Android、iOS、Windows | yes | +| pingOnlyIfOffline | 当设置为true且pingInterval > 0时，只有在离线时才会定期ping远程服务器。默认为false。 | boolean | no | Android、iOS、Windows | yes | +| pingInBackground | 当应用程序不在前台时是否检查连接性。默认为false。 | boolean | no | Android、iOS、Windows | yes | +| httpMethod | 用于ping服务器的http方法。支持HEAD或OPTIONS。默认为HEAD。 | HTTPMethod | no | Android、iOS、Windows | yes | +| customHeaders | 为ping请求添加的可选自定义标头。 | HTTPHeaders | no | Android、iOS、Windows | yes | +| regexActionType | 正则表达式，用于指示在离线模式下要拦截的操作类型。默认情况下，它被配置为拦截遵循Redux约定的数据获取操作。这意味着它将拦截类型如FETCH_USER_ID_REQUEST、FETCH_PRODUCTS_REQUEST等的操作。 | RegExp | no | Android、iOS、Windows | yes | +| actionTypes | 不满足正则表达式条件的其他操作类型的数组。例如，对于携带刷新数据的操作（如REFRESH_LIST）很有用。 | Arrays | no | Android、iOS、Windows | yes | +| queueReleaseThrottle | 刷新离线队列时分发操作之间的等待时间（以毫秒为单位）。当重新连接时，有助于减少服务器压力。默认为50毫秒。 | number | no | Android、iOS、Windows | yes | +| shouldDequeueSelector | 接收redux应用程序状态并返回布尔值的函数。每次分发操作时都会执行此函数，在操作到达reducer之前。这对于控制当重新连接且有操作排队时是否应释放队列很有用。返回true（默认行为）释放队列，而返回false则阻止队列释放。例如，您可能希望在释放队列之前执行一些身份验证检查。注意，如果shouldDequeueSelector的结果在队列释放过程中发生变化，队列不会停止。如果您希望在队列释放过程中停止队列，请参见相关的FAQ部分。 | boolean | no | Android、iOS、Windows | yes | +| url | 要ping的远程服务器。默认为https://www.google.com/，因为这可能是最稳定的服务器之一，但您可以根据需要提供自己的服务器。警告：www.google.com在中国是被屏蔽的域名，因此如果需要您的应用程序在那里可访问，您必须使用其他域名。 | string | no | Android、iOS、Windows | yes | +| method | 用于ping服务器的http方法。支持HEAD或OPTIONS。默认为HEAD。 | HTTPMethod | no | Android、iOS、Windows | yes | ## 静态方法 @@ -147,13 +148,13 @@ export const offlineDemoTest = () => { | Name | Description | Type | Required | Platform | HarmonyOS Support | | ----------------------- | ------------------------------------------------------------ | ---- | -------- | --------------------- | ----------------- | -| NetworkProvider | Provider component that injects the network state to children components via React Context. Only children prop is required, the rest are optional. It should be used on top of your components hierarchy, ideally in (or close to) the entry point. | func | no | Android、iOS、Windows | yes | -| NetworkConsumer | React component that subscribes to connectivity changes. It requires a function as a child. The function receives the current connectivity status and returns a React node. This component should be rendered within a NetworkProvider in order to work properly. | func | no | Android、iOS、Windows | yes | -| useIsConnected | Returns a boolean indicating whether you are connected to the network or not. | func | no | Android、iOS、Windows | yes | -| ReduxNetworkProvider | Uses a provider component mechanism. The same props as for `NetworkProvider` apply. Make sure your component is a descendant of the react-redux `` component, so that `ReduxNetworkProvider` has access to the store. | func | no | Android、iOS、Windows | yes | -| networkSaga | Just fork this saga from your root saga. It accepts the same config options as NetworkProvider and ReduxNetworkProvider. Recommended if you are using redux-saga, since it's a very elegant way to deal with global connectivity changes, without having to wrap your components with extra functionality. | func | no | Android、iOS、Windows | yes | -| createNetworkMiddleware | Function that returns a Redux middleware which listens to specific actions targeting API calls in online/offline mode. | func | no | Android、iOS、Windows | yes | -| OfflineQueue | A queue system to store actions that failed due to lack of connectivity. It works for both plain object actions and thunks. | func | no | Android、iOS、Windows | yes | +| NetworkProvider | 提供程序组件，通过React Context将网络状态注入到子组件中。只需要children属性，其余都是可选的。应该在组件层次结构的顶部使用，理想情况下在（或接近）入口点。 | func | no | Android、iOS、Windows | yes | +| NetworkConsumer | 订阅连接性变化的React组件。它需要一个函数作为子组件。该函数接收当前的连接状态并返回一个React节点。为了正常工作，此组件应在NetworkProvider内渲染。 | func | no | Android、iOS、Windows | yes | +| useIsConnected | 返回一个布尔值，指示您是否连接到网络。 | func | no | Android、iOS、Windows | yes | +| ReduxNetworkProvider | 使用提供程序组件机制。与`NetworkProvider`相同的属性适用。确保您的组件是react-redux ``组件的后代，以便`ReduxNetworkProvider`可以访问store。 | func | no | Android、iOS、Windows | yes | +| networkSaga | 只需从您的根saga中派生此saga。它接受与NetworkProvider和ReduxNetworkProvider相同的配置选项。如果您使用redux-saga，这是推荐的方式，因为它是一种非常优雅的处理全局连接性变化的方法，而无需用额外功能包装您的组件。 | func | no | Android、iOS、Windows | yes | +| createNetworkMiddleware | 返回一个Redux中间件的函数，该中间件监听针对在线/离线模式API调用的特定操作。 | func | no | Android、iOS、Windows | yes | +| OfflineQueue | 一个队列系统，用于存储由于缺乏连接性而失败的操作。它适用于普通对象操作和thunks。 | func | no | Android、iOS、Windows | yes | ## 遗留问题 diff --git a/zh-cn/react-native-root-siblings.md b/zh-cn/react-native-root-siblings.md index df4b2a7d..cd426da6 100644 --- a/zh-cn/react-native-root-siblings.md +++ b/zh-cn/react-native-root-siblings.md @@ -1,22 +1,23 @@ -> 模板版本：v0.2.2 +> 模板版本：v0.3.0

react-native-root-siblings

-

- - Supported platforms - - - License - - -

-> [! TIP] [Github 地址](https://github.com/magicismight/react-native-root-siblings/tree/v5.0.1) +> [! TIP] [Github address](https://github.com/magicismight/react-native-root-siblings/tree/v5.0.1) + +请到三方库的 Releases发布地址查看配套的版本信息： + +| 三方库版本 | 支持RN版本 | +| ----------| ---------- | +| 5.0.1 | 0.72/0.77 | + +对于未发布到npm的旧版本，请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 ## 安装与使用 +进入到工程目录并输入以下命令： + #### **npm** @@ -279,9 +280,9 @@ var styles = StyleSheet.create({ 本文档内容基于以下版本验证通过： -RNOH: 0.72.23; SDK: HarmonyOS NEXT Developer Beta1; IDE: DevEco Studio: 5.0.3.27; ROM: 3.0.0.19; - -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; +1. RNOH: 0.72.23; SDK: HarmonyOS NEXT Developer Beta1; IDE: DevEco Studio: 5.0.3.27; ROM: 3.0.0.19; +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.868; ROM: 6.0.0.112; ## 静态方法 diff --git a/zh-cn/react-native-switch-selector.md b/zh-cn/react-native-switch-selector.md index 10172407..e5d9893b 100644 --- a/zh-cn/react-native-switch-selector.md +++ b/zh-cn/react-native-switch-selector.md @@ -1,26 +1,23 @@ -> 模板版本：v0.2.2 +> 模板版本：v0.3.0

react-native-switch-selector

-

- - Supported platforms - - - License - - -

+> [!TIP] [GitHub address](https://github.com/App2Sales/react-native-switch-selector) +请到三方库的 Releases发布地址查看配套的版本信息： -> [!TIP] [Github 地址](https://github.com/App2Sales/react-native-switch-selector) +| 三方库版本 | 支持RN版本 | +| ----------| ---------- | +| 2.3.0 | 0.72/0.77 | -## 安装与使用 +对于未发布到npm的旧版本，请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 进入到工程目录并输入以下命令： +## 安装与使用 + #### **npm** @@ -72,7 +69,9 @@ export default SwitchSelectorDemo; 本文档内容基于以下版本验证通过： 1. RNOH：0.72.20; SDK：HarmonyOS NEXT Developer Beta1; IDE：DevEco Studio 5.0.3.200; ROM：3.0.0.18; -1. 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; +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.72.38; SDK: HarmonyOS-5.0.0(API12); ROM: 5.0.0.107; +4. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.868; ROM: 6.0.0.112; ## 属性 @@ -82,42 +81,42 @@ export default SwitchSelectorDemo; | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---------------------------- | ------------------------------------------------------------ | ------------------------ | -------- | ----------- | ----------------- | -| options | Items array to render. Each item has a label and a value and optionals icons | array | Yes | Android/IOS | Yes | -| options[].label | Label from each item | string | Yes | Android/IOS | Yes | -| options[].value | Value from each item | string | Yes | Android/IOS | Yes | -| options[].customIcon | Optional custom icon from each item | Jsx element ou Function | No | Android/IOS | Yes | -| options[].imageIcon | Source from a image icon form each item. Has the same color then label in render | string | No | Android/IOS | Yes | -| options[].activeColor | Color from each item when is selected | string | No | Android/IOS | Yes | -| options[].testID | Test ID for each item used for testing (e.g. with Appium) | string | No | Android/IOS | Yes | -| options[].accessibilityLabel | Accessibility Label for each item used for testing (e.g. with Appium) | string | No | Android/IOS | Yes | -| initial | Item selected in initial render | number | No | Android/IOS | Yes | -| value | The switch value (will call onPress) | number | No | Android/IOS | Yes | -| onPress | Callback function called after change value. | function | Yes | Android/IOS | Yes | -| disableValueChangeOnPress | Disables the onPress call when the value is manually changed | bool | No | Android/IOS | Yes | -| fontSize | Font size from labels. If null default fontSize of the app is used. | number | No | Android/IOS | Yes | -| selectedColor | Color text of the item selected | string | No | Android/IOS | Yes | -| buttonMargin | Margin of the item selected to component | number | No | Android/IOS | Yes | -| buttonColor | Color bg of the item selected | string | No | Android/IOS | Yes | -| textColor | Color text of the not selecteds items | string | No | Android/IOS | Yes | -| backgroundColor | Color bg of the component | string | No | Android/IOS | Yes | -| borderColor | Border Color of the component | string | No | Android/IOS | Yes | -| borderRadius | Border Radius of the component | number | No | Android/IOS | Yes | -| hasPadding | Indicate if item has padding | bool | No | Android/IOS | Yes | -| animationDuration | Duration of the animation | number | No | Android/IOS | Yes | -| valuePadding | Size of padding | number | No | Android/IOS | Yes | -| height | Height of component | number | No | Android/IOS | Yes | -| bold | Indicate if text has fontWeight bold | bool | No | Android/IOS | Yes | -| textStyle | Text style | object | No | Android/IOS | Yes | -| selectedTextStyle | Selected text style | object | No | Android/IOS | Yes | -| textContainerStyle | Style for text (and icon) container (TouchableOpacity) | object | No | Android/IOS | Yes | -| selectedTextContainerStyle | Style for selected text (and icon) container (TouchableOpacity) | object | No | Android/IOS | Yes | -| imageStyle | Image style | object | No | Android/IOS | Yes | -| style | Container style | object | No | Android/IOS | Yes | -| returnObject | Indicate if onPress function return an option instead of option.value | bool | No | Android/IOS | Yes | -| disabled | Disables the switch | bool | No | Android/IOS | Yes | -| borderWidth | Define border width | number | No | Android/IOS | Yes | -| testID | Test ID used for testing (e.g. with Appium) | string | No | Android/IOS | Yes | -| accessibilityLabel | Accessibility Label used for testing (e.g. with Appium) | string | No | Android/IOS | Yes | +| options | 要渲染的项目数组。每个项目都有标签和值，以及可选的图标 | array | Yes | Android/IOS | Yes | +| options[].label | 每个项目的标签 | string | Yes | Android/IOS | Yes | +| options[].value | 每个项目的值 | string | Yes | Android/IOS | Yes | +| options[].customIcon | 每个项目的可选自定义图标 | Jsx element ou Function | No | Android/IOS | Yes | +| options[].imageIcon | 每个项目图像图标的来源。在渲染时与标签具有相同的颜色 | string | No | Android/IOS | Yes | +| options[].activeColor | 选中时每个项目的颜色 | string | No | Android/IOS | Yes | +| options[].testID | 用于测试的每个项目的测试ID（例如与Appium一起使用） | string | No | Android/IOS | Yes | +| options[].accessibilityLabel | 用于测试的每个项目的可访问性标签（例如与Appium一起使用） | string | No | Android/IOS | Yes | +| initial | 初始渲染时选中的项目 | number | No | Android/IOS | Yes | +| value | 开关的值（将调用onPress） | number | No | Android/IOS | Yes | +| onPress | 更改值后调用的回调函数 | function | Yes | Android/IOS | Yes | +| disableValueChangeOnPress | 当值手动更改时禁用onPress调用 | bool | No | Android/IOS | Yes | +| fontSize | 标签的字体大小。如果为null，则使用应用程序的默认字体大小 | number | No | Android/IOS | Yes | +| selectedColor | 选中项目的文字颜色 | string | No | Android/IOS | Yes | +| buttonMargin | 选中项目到组件的边距 | number | No | Android/IOS | Yes | +| buttonColor | 选中项目的背景颜色 | string | No | Android/IOS | Yes | +| textColor | 未选中项目的文字颜色 | string | No | Android/IOS | Yes | +| backgroundColor | 组件的背景颜色 | string | No | Android/IOS | Yes | +| borderColor | 组件的边框颜色 | string | No | Android/IOS | Yes | +| borderRadius | 组件的边框半径 | number | No | Android/IOS | Yes | +| hasPadding | 指示项目是否有内边距 | bool | No | Android/IOS | Yes | +| animationDuration | 动画的持续时间 | number | No | Android/IOS | Yes | +| valuePadding | 内边距的大小 | number | No | Android/IOS | Yes | +| height | 组件的高度 | number | No | Android/IOS | Yes | +| bold | 指示文本是否具有fontWeight bold | bool | No | Android/IOS | Yes | +| textStyle | 文本样式 | object | No | Android/IOS | Yes | +| selectedTextStyle | 选中文本样式 | object | No | Android/IOS | Yes | +| textContainerStyle | 文本（和图标）容器的样式（TouchableOpacity） | object | No | Android/IOS | Yes | +| selectedTextContainerStyle | 选中文本（和图标）容器的样式（TouchableOpacity） | object | No | Android/IOS | Yes | +| imageStyle | 图像样式 | object | No | Android/IOS | Yes | +| style | 容器样式 | object | No | Android/IOS | Yes | +| returnObject | 指示onPress函数是否返回选项而不是option.value | bool | No | Android/IOS | Yes | +| disabled | 禁用开关 | bool | No | Android/IOS | Yes | +| borderWidth | 定义边框宽度 | number | No | Android/IOS | Yes | +| testID | 用于测试的测试ID（例如与Appium一起使用） | string | No | Android/IOS | Yes | +| accessibilityLabel | 用于测试的可访问性标签（例如与Appium一起使用） | string | No | Android/IOS | Yes | ## 遗留问题 diff --git a/zh-cn/react-native-transitiongroup.md b/zh-cn/react-native-transitiongroup.md index c3b65569..05247577 100644 --- a/zh-cn/react-native-transitiongroup.md +++ b/zh-cn/react-native-transitiongroup.md @@ -1,23 +1,22 @@ -> 模板版本：v0.2.2 +> 模板版本：v0.3.0

react-native-transitiongroup

-

- - Supported platforms - - - Supported platforms - -

+本项目基于 [react-native-transitiongroup@1.2.0](https://github.com/madsleejensen/react-native-transitiongroup) 开发。 -> [!Tip] [Github 地址](https://github.com/react-native-oh-library/react-native-transitiongroup) +请到三方库的 Releases发布地址查看配套的版本信息： -## 安装与使用 +| Version | Package Name | Repository | Release | RN Version | +| ------------------------------ | --------------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ | ---------- | +| 1.2.0 | @react-native-oh-tpl/react-native-transitiongroup | [GitHub](https://github.com/react-native-oh-library/react-native-transitiongroup) | [GitHub Releases](https://github.com/react-native-oh-library/react-native-transitiongroup/releases) +| 0.72 | +| 1.3.0 | @react-native-ohos/react-native-transitiongroup | [GitCode](https://gitcode.com/openharmony-sig/rntpc_react-native-transitiongroup) | [GitCode Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-transitiongroup/releases) | 0.77 | -请到三方库的 Releases 发布地址查看配套的版本信息：[@react-native-oh-tpl/react-native-transitiongroup Releases](https://github.com/react-native-oh-library/react-native-transitiongroup/releases) 。对于未发布到npm的旧版本，请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 +对于未发布到npm的旧版本，请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 + +## 安装与使用 进入到工程目录并输入以下命令： @@ -26,13 +25,21 @@ #### **npm** ```bash +# 0.72 npm install @react-native-oh-tpl/react-native-transitiongroup + +# 0.77 +npm install @react-native-ohos/react-native-transitiongroup ``` #### **yarn** ```bash +# 0.72 yarn add @react-native-oh-tpl/react-native-transitiongroup + +# 0.77 +yarn add @react-native-ohos/react-native-transitiongroup ``` @@ -144,9 +151,10 @@ const styles = StyleSheet.create({ ### 兼容性 -要使用此库，需要使用正确的 React-Native 和 RNOH 版本。另外，还需要使用配套的 DevEco Studio 和 手机 ROM。 +本文档内容基于以下版本验证通过： -请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息：[@react-native-oh-tpl/react-native-transitiongroup Releases](https://github.com/react-native-oh-library/react-native-transitiongroup/releases) +1. 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; +2. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.868; ROM: 6.0.0.112; ## API diff --git a/zh-cn/react-native-typing-animation.md b/zh-cn/react-native-typing-animation.md index 98bcf64e..1c4971d3 100644 --- a/zh-cn/react-native-typing-animation.md +++ b/zh-cn/react-native-typing-animation.md @@ -1,24 +1,23 @@ -> 模板版本：v0.2.2 +> 模板版本：v0.3.0

react-native-typing-animation

-

- - Supported platforms - - - License - - -

+> [!TIP] [GitHub address](https://github.com/watadarkstar/react-native-typing-animation) + +请到三方库的 Releases发布地址查看配套的版本信息： +| 三方库版本 | 支持RN版本 | +| ----------| ---------- | +| 0.1.7 | 0.72/0.77 | -> [!TIP] [Github 地址](https://github.com/watadarkstar/react-native-typing-animation) +对于未发布到npm的旧版本，请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 ## 安装与使用 +进入到工程目录并输入以下命令： + #### **npm** @@ -208,9 +207,10 @@ export default TypingAnimationDemos; 本文档内容基于以下版本验证通过： -1.RNOH：0.72.20; SDK：HarmonyOS NEXT Developer Beta1; IDE：DevEco Studio 5.0.3.200; ROM：3.0.0.18; - -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; +1. RNOH：0.72.20; SDK：HarmonyOS NEXT Developer Beta1; IDE：DevEco Studio 5.0.3.200; ROM：3.0.0.18; +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.72.38; SDK: HarmonyOS-5.0.0(API12); ROM: 5.0.0.107; +4. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.868; ROM: 6.0.0.112; ## 属性 @@ -220,16 +220,15 @@ export default TypingAnimationDemos; | Name | Description | Type | Required | Platform | HarmonyOS Support | | :----------: | :----------------------------------------------------------: | :-----: | :------: | :---------: | :---------------: | -| style | Container styles; default is `{}` | Object | No | Android/ios | Yes | -| dotColor | Dot color; default is `#000` (black) | String | No | Android/ios | Yes | -| dotStyles | Dot styles; default is `{}` | Object | No | Android | No | -| dotRadius | Dot radius; default is `2.5` | Integer | No | Android/ios | Yes | -| dotMargin | Dot margin, the space between dots; default is `3` | Integer | No | Android/ios | Yes | -| dotAmplitude | Dot amplitude; default is `3` | Integer | No | Android/ios | Yes | -| dotSpeed | Dot speed, the speed of the whole animation view; default is `0.15` | Integer | No | Android/ios | Yes | -| dotY | Dot y, the starting y coordinate; default is 6 | Integer | No | Android/ios | Yes | -| dotX | Dot x, the x coordinate of the center dot; default is `12` | Integer | No | Android/ios | Yes | -| show | Visibility, whether the whole animation view is displayed or not; default is true | Boolean | No | Android/ios | Yes | +| style | 容器样式；默认值为`{}` | Object | No | Android/ios | Yes | +| dotColor | 点颜色；默认值为`#000`（黑色） | String | No | Android/ios | Yes | +| dotStyles | 点样式；默认值为`{}` | Object | No | Android | No | +| dotRadius | 点半径；默认值为`2.5` | Integer | No | Android/ios | Yes | +| dotMargin | 点边距，点之间的间距；默认值为`3` | Integer | No | Android/ios | Yes | +| dotAmplitude | 点振幅；默认值为`3` | Integer | No | Android/ios | Yes | +| dotSpeed | 点速度，整个动画视图的速度；默认值为`0.15` | Integer | No | Android/ios | Yes | +| dotY | 点y坐标，起始y坐标；默认值为6 | Integer | No | Android/ios | Yes | +| dotX | 点x坐标，中心点的x坐标；默认值为`12` | Integer | No | Android/ios | Yes | ## 遗留问题 diff --git a/zh-cn/remobile-react-native-toast.md b/zh-cn/remobile-react-native-toast.md index e574cd92..69202f69 100644 --- a/zh-cn/remobile-react-native-toast.md +++ b/zh-cn/remobile-react-native-toast.md @@ -1,34 +1,24 @@ -> 模板版本：v0.2.2 +> 模板版本：v0.3.0

@remobile/react-native-toast

-

- - Supported platforms - - - License - - -

-> [!TIP] [Github 地址](https://github.com/react-native-oh-library/react-native-toast) - -## 安装与使用 +本项目基于 [react-native-toast@1.0.7](https://github.com/remobile/react-native-toast) 开发。 -请到三方库的 Releases -发布地址查看配套的版本信息： +请到三方库的 Releases发布地址查看配套的版本信息： -| 三方库版本 | 发布信息 | 支持RN版本 | -| ---------- | ------------------------------------------------------------ | ---------- | -| 1.0.7@deprecated | [@react-native-oh-tpl/react-native-toast Releases(deprecated)](https://github.com/react-native-oh-library/react-native-toast/releases) | 0.72 | -| 1.0.8 | [@react-native-ohos/react-native-toast Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-toast/releases) | 0.72 | -| 1.1.0 | [@react-native-ohos/react-native-toast Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-toast/releases) | 0.77 | +| Version | Package Name | Repository | Release | RN Version | +| ------------------------------ | --------------------------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ | ---------- | +|1.0.7@deprecated | @react-native-oh-tpl/react-native-toast | [Github](https://github.com/react-native-oh-library/react-native-toast) | [Github Releases(deprecated)](https://github.com/react-native-oh-library/react-native-toast/releases) | 0.72 | +| 1.0.8 | @react-native-ohos/react-native-toast | [GitCode](https://gitcode.com/openharmony-sig/rntpc_react-native-toast) | [GitCode Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-toast/releases) | 0.72 | +| 1.1.0 | @react-native-ohos/react-native-toast | [GitCode](https://gitcode.com/openharmony-sig/rntpc_react-native-toast) | [GitCode Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-toast/releases) | 0.77 | 对于未发布到npm的旧版本，请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 +## 安装与使用 + 进入到工程目录并输入以下命令： @@ -263,16 +253,10 @@ ohpm install ### 兼容性 -要使用此库，需要使用正确的 React-Native 和 RNOH 版本。另外，还需要使用配套的 DevEco Studio 和 手机 ROM。 - -请到三方库的 Releases 发布地址查看配套的版本信息： - -| 三方库版本 | 发布信息 | 支持RN版本 | -| ---------- | ------------------------------------------------------------ | ---------- | -| 1.0.7@deprecated | [@react-native-oh-tpl/react-native-toast Releases(deprecated)](https://github.com/react-native-oh-library/react-native-toast/releases) | 0.72 | -| 1.0.8 | [@react-native-ohos/react-native-toast Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-toast/releases) | 0.72 | -| 1.1.0 | [@react-native-ohos/react-native-toast Releases](https://gitcode.com/openharmony-sig/rntpc_react-native-toast/releases) | 0.77 | +本文档内容基于以下环境验证通过： +1. 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; +2. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.868; ROM: 6.0.0.112; ## API @@ -282,14 +266,14 @@ ohpm install | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- |---------| -------- | ------------------ | -| show() | Displays the location of the toast, its duration, the content of the message | function | no | android | yes | -| showShortTop() | Display the top Toast for a short time | function | no | android | yes | -| showShortCenter() | Display the center Toast for a short time | function | no | android | yes | -| showShortBottom() | Display the bottom Toast for a short time | function | no | android | yes | -| showLongTop() | Display the top Toast for a long time | function | no | android | yes | -| showLongCenter() | Display the center Toast for a long time | function | no | android | yes | -| showLongBottom() | Display the bottom Toast for a long time | function | no | android | yes | -| hide() | Hide the toast that is being displayed | function | no | android | no | +| show() | 显示Toast的位置、持续时间和消息内容 | function | no | android | yes | +| showShortTop() | 短时间显示顶部Toast | function | no | android | yes | +| showShortCenter() | 短时间显示居中Toast | function | no | android | yes | +| showShortBottom() | 短时间显示底部Toast | function | no | android | yes | +| showLongTop() | 长时间显示顶部Toast | function | no | android | yes | +| showLongCenter() | 长时间显示居中Toast | function | no | android | yes | +| showLongBottom() | 长时间显示底部Toast | function | no | android | yes | +| hide() | 隐藏正在显示的Toast | function | no | android | no | ## 遗留问题 -- Gitee