diff --git a/en/react-native-credit-card-input.md b/en/react-native-credit-card-input.md index a14b33eaadfa10305154cdfdf5b08ec506c7fb05..2ea28d40891abc0781193e3ffdc2415826aa3e21 100644 --- a/en/react-native-credit-card-input.md +++ b/en/react-native-credit-card-input.md @@ -12,28 +12,37 @@

-> [!TIP] [GitHub address](https://github.com/react-native-oh-library/react-native-credit-card-input) -## Installation and Usage - -Find the matching version information in the release address of a third-party library：[@react-native-oh-tpl/react-native-credit-card-input Releases](https://github.com/react-native-oh-library/react-native-credit-card-input/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. +This project is based on [react-native-credit-card-input](https://github.com/sbycrosz/react-native-credit-card-input). -Go to the project directory and execute the following instruction: +Please visit the Release release address of the third-party library to view the corresponding version information： +| Version | Package Name | Repository | Release |Support RN version| +| ------------------------- | ------------------------------------------------- | ------------------ | -------------------------- |-------------------| +| 0.4.1 | @react-native-oh-tpl/react-native-credit-card-input | [Github](https://github.com/react-native-oh-library/react-native-credit-card-input) | [Github Releases](https://github.com/react-native-oh-library/react-native-credit-card-input/releases) |0.72 | +| 1.0.1 | @react-native-ohos/react-native-credit-card-input | [Github](https://github.com/react-native-oh-library/react-native-credit-card-input/tree/br_rnoh0.77) | [Github Releases](https://github.com/react-native-oh-library/react-native-credit-card-input/tree/br_rnoh0.77) |0.77 | - - +## Installation and Usage #### **npm** ```bash + +# 0.72 npm install @react-native-oh-tpl/react-native-credit-card-input + +# 0.77 +npm install @react-native-ohos/react-native-credit-card-input ``` #### **yarn** ```bash -yarn add @react-native-oh-tpl/react-native-credit-card-input +# 0.72 +yarn install @react-native-oh-tpl/react-native-credit-card-input + +# 0.77 +yarn install @react-native-ohos/react-native-credit-card-input ``` @@ -123,7 +132,8 @@ export default class Example extends Component { 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 5.1.1 Release SDK; IDE: DevEco Studio 5.1.1 Release; ROM: 5.0.1.120; +2. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.858; ROM: 6.0.0.112; ## Properties diff --git a/en/react-native-ezswiper.md b/en/react-native-ezswiper.md index 9d7d215eb057de622048a07ca4dee1761fd8e273..3e21663c12ce8faf7df707be34cdc8c42c61a8f6 100644 --- a/en/react-native-ezswiper.md +++ b/en/react-native-ezswiper.md @@ -14,6 +14,10 @@ > [!Tip] [GitHub address](https://github.com/easyui/react-native-ezswiper) +| Version | Support RN version | +| ------------ | ---------- | +| 1.3.0 | 0.72/0.77 | + ## Installation and Usage Go to the project directory and execute the following instruction: @@ -325,8 +329,9 @@ const styles = StyleSheet.create({ This document is verified based on the following versions: - 1.RNOH: 0.72.29; SDK：OpenHarmony-5.0.0.65; IDE：DevEco Studio 5.0.3.706; ROM：NEXT.0.0.65; - 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.29; SDK：OpenHarmony-5.0.0.65; IDE：DevEco Studio 5.0.3.706; ROM：NEXT.0.0.65; + 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 5.1.1 Release; IDE: DevEco Studio 5.1.1.830; ROM：NEXT 5.1.0.150; ## Properties diff --git a/en/react-native-redash.md b/en/react-native-redash.md index 777bec52195c336fd2e6639ffe9b48c98f6ff92c..c54c88171098eceb68bb98fa0997fb939ba42d4d 100644 --- a/en/react-native-redash.md +++ b/en/react-native-redash.md @@ -14,6 +14,10 @@ > [!TIP] [GitHub address](https://github.com/wcandillon/react-native-redash/tree/v18.1.3) +| Version | Support RN version | +| ------------ | ---------- | +| 18.1.3 | 0.72/0.77 | + ## Installation and Usage Go to the project directory and execute the following instruction: @@ -580,6 +584,7 @@ If it is not included, follow the guide provided in [@react-native-oh-tpl/react- This document is verified based on the following versions: 1. RNOH：0.72.28; SDK：HarmonyOS NEXT Developer Beta6 SDK 5.0.0.61; IDE：DevEco Studio 5.0.3.706; ROM：3.0.0.61; +2. RNOH：0.77.18; SDK：HarmonyOS 5.1.1 Release; IDE: DevEco Studio 5.1.1.830; ROM：NEXT 5.1.0.150; ## Static Methods diff --git a/en/rn-tourguide.md b/en/rn-tourguide.md index 5728e7c4729f5dd348b630750b4a26c8d42c1d8c..d63415ab27ff20c8467f9af5e9be0188ff876119 100644 --- a/en/rn-tourguide.md +++ b/en/rn-tourguide.md @@ -14,28 +14,39 @@

-> [!TIP] [GitHub address](https://github.com/react-native-oh-library/rn-tourguide) -## Installation and Usage - -Find the matching version information in the release address of a third-party library：[https://github.com/react-native-oh-library/rn-tourguide Releases](https://github.com/react-native-oh-library/rn-tourguide/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. +This project is based on [rn-tourguide](https://github.com/react-native-oh-library/rn-tourguide). -Go to the project directory and execute the following instruction: +This third-party library has been migrated to Gitee and is now available for direct download from npm, the new package name is:`@react-native-ohos/rn-tourguide`, The version correspondence details are as follows: +| Version | Package Name | Repository | Release |Support RN version| +| ------------------------- | ------------------------------------------------- | ------------------ | -------------------------- |-------------------| +| 3.3.0 | @react-native-oh-tpl/rn-tourguide | [Github](https://github.com/react-native-oh-library/rn-tourguide) | [Github Releases](https://github.com/react-native-oh-library/rn-tourguide/releases) |0.72 | +| 3.4.0 | @react-native-ohos/rn-tourguide | [GitCode](https://gitcode.com/openharmony-sig/rntpc_rn-tourguide) | [GitCode Releases]() |0.77 | +## Installation and Usage #### **npm** ```bash + +# 0.72 npm install @react-native-oh-tpl/rn-tourguide + +# 0.77 +npm install @react-native-ohos/rn-tourguide ``` #### **yarn** ```bash +# 0.72 yarn add @react-native-oh-tpl/rn-tourguide + +# 0.77 +yarn add @react-native-ohos/rn-tourguide ``` @@ -210,8 +221,8 @@ If it is not included, follow the guide provided in [@react-native-oh-tpl/react- 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. -Check the release version information in the release address of the third-party library: [@react-native-oh-tpl/rn-tourguide Releases](https://github.com/react-native-oh-library/rn-tourguide/releases) - +1. RNOH: 0.72.27; SDK: HarmonyOS 5.1.1 Release SDK; IDE: DevEco Studio 5.1.1 Release; ROM: 5.0.1.120; +2. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.858; ROM: 6.0.0.112; ## Properties 详情见[rn-tourguide](https://github.com/xcarpentier/rn-tourguide) diff --git a/zh-cn/react-native-credit-card-input.md b/zh-cn/react-native-credit-card-input.md index dc3a70f51b95c542cc652d75229e2c83f4e2546f..cf94e81fe1806d34ad891837d236b532f5cedae5 100644 --- a/zh-cn/react-native-credit-card-input.md +++ b/zh-cn/react-native-credit-card-input.md @@ -12,42 +12,39 @@

-> [!TIP] [Github 地址](https://github.com/react-native-oh-library/react-native-credit-card-input) +本项目基于 [react-native-credit-card-input](https://github.com/sbycrosz/react-native-credit-card-input). -## 安装与使用 +请访问第三方库的 Release 发布地址查看对应的版本信息： -请到三方库的 Releases 发布地址查看配套的版本信息： +| Version | Package Name | Repository | Release |Support RN version| +| ------------------------- | ------------------------------------------------- | ------------------ | -------------------------- |-------------------| +| 0.4.1 | @react-native-oh-tpl/react-native-credit-card-input | [Github](https://github.com/react-native-oh-library/react-native-credit-card-input) | [Github Releases](https://github.com/react-native-oh-library/react-native-credit-card-input/releases) |0.72 | +| 1.0.1 | @react-native-ohos/react-native-credit-card-input | [Github](https://github.com/react-native-oh-library/react-native-credit-card-input/tree/br_rnoh0.77) | [Github Releases](https://github.com/react-native-oh-library/react-native-credit-card-input/tree/br_rnoh0.77) |0.77 | -| 三方库版本 | 发布信息 | 支持RN版本 | -| ---------- | ------------------------------------------------------------ | ---------- | -| 0.4.1 | [@react-native-oh-tpl/react-native-credit-card-input Releases](https://github.com/react-native-oh-library/react-native-credit-card-input/releases) | 0.72 | -| 1.0.1 | [@react-native-ohos/react-native-credit-card-input Releases]() | 0.77 | -对于未发布到npm的旧版本，请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 +## 安装与使用 进入到工程目录并输入以下命令： - - - #### **npm** ```bash -# V0.4.1 + +# 0.72 npm install @react-native-oh-tpl/react-native-credit-card-input -# V1.0.1 +# 0.77 npm install @react-native-ohos/react-native-credit-card-input ``` #### **yarn** ```bash -# V0.4.1 -yarn add @react-native-oh-tpl/react-native-credit-card-input +# 0.72 +yarn install @react-native-oh-tpl/react-native-credit-card-input -# V1.0.1 -yarn add @react-native-ohos/react-native-credit-card-input +# 0.77 +yarn install @react-native-ohos/react-native-credit-card-input ``` @@ -124,7 +121,8 @@ const style = 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; +1. RNOH: 0.72.27; SDK: HarmonyOS 5.1.1 Release SDK; IDE: DevEco Studio 5.1.1 Release; ROM: 5.0.1.120; +2. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.858; ROM: 6.0.0.112; ## 属性 @@ -138,66 +136,66 @@ const style = StyleSheet.create({ | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| autoFocus | Automatically focus Card Number field on render | PropTypes.bool | no | Android/iOS | yes | -| onChange | Receives a formData object every time the form changes | PropTypes.func | no | Android/iOS | yes | -| onFocusdeprecated from 1.0.1 | Receives the name of currently focused field| PropTypes.func | no | Android/iOS | yes | -| placeholders | Defaults to\{ number: "1234 5678 1234 5678", expiry: "MM/YY", cvc: "CVC" \} | string | no | Android/iOS | yes | -| inputStyle| Style for credit-card form's textInput | Text.propTypes.style | no | Android/iOS | yes | -| validColordeprecated from 1.0.1 | Color that will be applied for valid text input. Defaults to: "\{inputStyle.color\}" | PropTypes.string | no | Android/iOS | yes | -| invalidColordeprecated from 1.0.1 | Color that will be applied for invalid text input. Defaults to: "red" | PropTypes.string | no | Android/iOS | yes | -| placeholderColor| Color that will be applied for text input placeholder. Defaults to: "gray" | PropTypes.string | no | Android/iOS | yes | -| additionalInputsPropsdeprecated from 1.0.1 | An object with Each key of the object corresponding to the name of the field. Allows you to change all props documented in RN TextInput. | PropTypes.objectOf(TextInput.propTypes) | no | Android/iOS | yes | -| onFocusField1.0.1+ | Callback function called when a field gains focus. | PropTypes.func | no | Android/iOS | yes | -| style1.0.1+ | Custom style for the component's container. | PropTypes.style | no | Android/iOS | yes | +| autoFocus | 渲染时自动聚焦卡号输入框 | PropTypes.bool | no | Android/iOS | yes | +| onChange | 每次表单变化时接收一个 formData 对象 | PropTypes.func | no | Android/iOS | yes | +| onFocusdeprecated from 1.0.1 | 接收当前聚焦字段的名称 | PropTypes.func | no | Android/iOS | yes | +| placeholders | 默认为 {number: "1234 5678 1234 5678", expiry: "MM/YY", cvc: "CVC"} | string | no | Android/iOS | yes | +| inputStyle| 信用卡表单文本输入框的样式 | Text.propTypes.style | no | Android/iOS | yes | +| validColordeprecated from 1.0.1 | 应用于有效文本输入的颜色。默认为："{inputStyle.color}" | PropTypes.string | no | Android/iOS | yes | +| invalidColordeprecated from 1.0.1 | 应用于无效文本输入的颜色。默认为："red" | PropTypes.string | no | Android/iOS | yes | +| placeholderColor| 应用于文本输入框占位符的颜色。默认为："gray" | PropTypes.string | no | Android/iOS | yes | +| additionalInputsPropsdeprecated from 1.0.1 | 一个对象，该对象的每个键对应字段的名称。允许你更改 RN TextInput 中记录的所有属性。 | PropTypes.objectOf(TextInput.propTypes) | no | Android/iOS | yes | +| onFocusField1.0.1+ | 当字段获得焦点时调用的回调函数。 | PropTypes.func | no | Android/iOS | yes | +| style1.0.1+ | 组件容器的自定义样式。 | PropTypes.style | no | Android/iOS | yes | ### CreditCardInput | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| autoFocus | Automatically focus Card Number field on render | PropTypes.bool | no | Android/iOS | yes | -| onChange | Receives a formData object every time the form changes | PropTypes.func | no | Android/iOS | yes | -| onFocusdeprecated from 1.0.1 | Receives the name of currently focused field | PropTypes.func | no | Android/iOS | yes | -| labels | Defaults to\{ number: "CARD NUMBER", expiry: "EXPIRY", cvc: "CVC/CCV" \}| PropTypes.object | no | Android/iOS | yes | -| placeholders | Defaults to\{ number: "1234 5678 1234 5678", expiry: "MM/YY", cvc: "CVC" \} | PropTypes.object | no | Android/iOS | yes | -| cardScaledeprecated from 1.0.1 | Scales the credit-card view.Defaults to 1, which translates to \{ width: 300, height: 190 \} | PropTypes.number | no | Android/iOS | yes | -| cardFontFamilydeprecated from 1.0.1 | Font family for the CreditCardView, works best with monospace fonts. Defaults to Courier (iOS) or monospace (android) | PropTypes.string | no | Android/iOS | yes | -| cardImageFrontdeprecated from 1.0.1 | Image for the credit-card view e.g. require("./card.png") | PropTypes.number | no | Android/iOS | yes | -| cardImageBackdeprecated from 1.0.1 | Image for the credit-card view e.g. require("./card.png") | PropTypes.number | no | Android/iOS | yes | -| labelStyle | Style for credit-card form's labels | Text.propTypes.style | no | Android/iOS | yes | -| inputStyle | Style for credit-card form's textInput | Text.propTypes.style | no | Android/iOS | yes | -| inputContainerStyledeprecated from 1.0.1 | Style for textInput's containerDefaults to: \{ borderBottomWidth: 1, borderBottomColor:"black" \} | ViewPropTypes.style | no | Android/iOS | yes | -| validColordeprecated from 1.0.1 | Color that will be applied for valid text input. Defaults to: "\{inputStyle.color\}" | PropTypes.string | no | Android/iOS | yes | -| invalidColordeprecated from 1.0.1 | Color that will be applied for invalid text input. Defaults to: "red" | PropTypes.string | no | Android/iOS | yes | -| placeholderColor | Color that will be applied for text input placeholder. Defaults to: "gray" | PropTypes.string | no | Android/iOS | yes | -| requiresNamedeprecated from 1.0.1 | Shows cardholder's name field Default to false | PropTypes.bool | no | Android/iOS | yes | -| requiresCVCdeprecated from 1.0.1 | Shows CVC field Default to true | PropTypes.bool | no | Android/iOS | yes | -| requiresPostalCodedeprecated from 1.0.1 | Shows postalCode field Default to false | PropTypes.string | no | Android/iOS | yes | -| validatePostalCodedeprecated from 1.0.1 | Function to validate postalCode, expects incomplete, valid, or invalid as return values | PropTypes.func | no | Android/iOS | yes | -| allowScrolldeprecated from 1.0.1 | enables horizontal scrolling on CreditCardInput Defaults to false | PropTypes.bool | no | Android/iOS | yes | -| cardBrandIconsdeprecated from 1.0.1 | brand icons for CardView. see ./src/Icons.js for details | PropTypes.object | no | Android/iOS | yes | -| additionalInputsPropsdeprecated from 1.0.1 | An object with Each key of the object corresponding to the name of the field. Allows you to change all props documented in RN TextInput. | PropTypes.objectOf(TextInput.propTypes) | no | Android/iOS | yes | -| onFocusField1.0.1+ | Callback function called when a field gains focus. | PropTypes.func | no | Android/iOS | yes | -| style1.0.1+ | Custom style for the component's container. | PropTypes.style | no | Android/iOS | yes | +| autoFocus | 渲染时自动聚焦卡号输入框 | PropTypes.bool | no | Android/iOS | yes | +| onChange | 每次表单变化时接收一个 formData 对象 | PropTypes.func | no | Android/iOS | yes | +| onFocusdeprecated from 1.0.1 | 接收当前聚焦字段的名称 | PropTypes.func | no | Android/iOS | yes | +| labels | 默认为 {number: "CARD NUMBER", expiry: "EXPIRY", cvc: "CVC/CCV"} | PropTypes.object | no | Android/iOS | yes | +| placeholders | 默认为 {number: "1234 5678 1234 5678", expiry: "MM/YY", cvc: "CVC"} | PropTypes.object | no | Android/iOS | yes | +| cardScaledeprecated from 1.0.1 | 缩放信用卡视图。默认为 1，对应 {width: 300, height: 190} | PropTypes.number | no | Android/iOS | yes | +| cardFontFamilydeprecated from 1.0.1 | 信用卡视图的字体系列，使用等宽字体效果最佳。默认为 Courier（iOS）或 monospace（android） | PropTypes.string | no | Android/iOS | yes | +| cardImageFrontdeprecated from 1.0.1 | 信用卡视图的正面图片，例如 require ("./card.png") | PropTypes.number | no | Android/iOS | yes | +| cardImageBackdeprecated from 1.0.1 | 信用卡视图的背面图片，例如 require ("./card.png") | PropTypes.number | no | Android/iOS | yes | +| labelStyle | 信用卡表单标签的样式 | Text.propTypes.style | no | Android/iOS | yes | +| inputStyle | 信用卡表单文本输入框的样式 | Text.propTypes.style | no | Android/iOS | yes | +| inputContainerStyledeprecated from 1.0.1 | 文本输入框容器的样式，默认为：{borderBottomWidth: 1, borderBottomColor:"black"} | ViewPropTypes.style | no | Android/iOS | yes | +| validColordeprecated from 1.0.1 | 应用于有效文本输入的颜色。默认为："{inputStyle.color}" | PropTypes.string | no | Android/iOS | yes | +| invalidColordeprecated from 1.0.1 | 应用于无效文本输入的颜色。默认为："red" | PropTypes.string | no | Android/iOS | yes | +| placeholderColor | 应用于文本输入框占位符的颜色。默认为："gray" | PropTypes.string | no | Android/iOS | yes | +| requiresNamedeprecated from 1.0.1 | 显示持卡人姓名字段，默认为 false | PropTypes.bool | no | Android/iOS | yes | +| requiresCVCdeprecated from 1.0.1 | 显示 CVC 字段，默认为 true | PropTypes.bool | no | Android/iOS | yes | +| requiresPostalCodedeprecated from 1.0.1 | 显示邮政编码字段，默认为 false | PropTypes.string | no | Android/iOS | yes | +| validatePostalCodedeprecated from 1.0.1 | 验证邮政编码的函数，期望返回 incomplete、valid 或 invalid | PropTypes.func | no | Android/iOS | yes | +| allowScrolldeprecated from 1.0.1 | 启用 CreditCardInput 上的水平滚动，默认为 false | PropTypes.bool | no | Android/iOS | yes | +| cardBrandIconsdeprecated from 1.0.1 | 卡片视图的品牌图标。详见./src/Icons.js | PropTypes.object | no | Android/iOS | yes | +| additionalInputsPropsdeprecated from 1.0.1 | 一个对象，该对象的每个键对应字段的名称。允许你更改 RN TextInput 中记录的所有属性。 | PropTypes.objectOf(TextInput.propTypes) | no | Android/iOS | yes | +| onFocusField1.0.1+ | 当字段获得焦点时调用的回调函数。 | PropTypes.func | no | Android/iOS | yes | +| style1.0.1+ | 组件容器的自定义样式。 | PropTypes.style | no | Android/iOS | yes | ### CreditCardView | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| focuseddeprecated from 1.0.1 | Determines the front face of the card | PropTypes.string | no | Android/iOS | yes | -| branddeprecated from 1.0.1 | Brand of the credit card | PropTypes.string | no | Android/iOS | yes | -| name | Cardholder's name (Use empty string if you need to hide the placeholder) | PropTypes.string | no | Android/iOS | yes | -| number | Credit card number (you'll need to the formatting yourself) | PropTypes.string | no | Android/iOS | yes | -| expiry | Credit card expiry (should be in MM/YY format) | PropTypes.string | no | Android/iOS | yes | -| cvc | Credit card CVC | PropTypes.string | no | Android/iOS | yes | -| placeholder | Placeholder texts | PropTypes.object | no | Android/iOS | yes | -| scaledeprecated from 1.0.1 | Scales the card | PropTypes.number | no | Android/iOS | yes | -| fontFamily | Defaults to Courier and monospace in iOS and Android respectively | PropTypes.string | no | Android/iOS | yes | -| imageFront | Image for the credit-card | PropTypes.number | no | Android/iOS | yes | -| imageBack | Image for the credit-card | PropTypes.number | no | Android/iOS | yes | -| customIconsdeprecated from 1.0.1 | brand icons for CardView. see ./src/Icons.js for details | PropTypes.object | no | Android/iOS | yes | -| focusedField1.0.1+ | Specifies which field is currently focused | 'name' \| 'number' \| 'expiry' \| | no | Android/iOS | yes | -| type1.0.1+ | Specifies the type of the credit card issuer | 'visa' \| 'mastercard' \| 'american-express' \| 'diners-club' \| 'discover' \| 'jcb' | no | Android/iOS | yes | -| style1.0.1+ | Custom style for the component's container. | PropTypes.style | no | Android/iOS | yes | +| focuseddeprecated from 1.0.1 | 确定卡片的正面 | PropTypes.string | no | Android/iOS | yes | +| branddeprecated from 1.0.1 | 信用卡的品牌 | PropTypes.string | no | Android/iOS | yes | +| name | 持卡人姓名（如果需要隐藏占位符，请使用空字符串） | PropTypes.string | no | Android/iOS | yes | +| number | 信用卡号码（你需要自己进行格式化） | PropTypes.string | no | Android/iOS | yes | +| expiry | 信用卡有效期（应为 MM/YY 格式） | PropTypes.string | no | Android/iOS | yes | +| cvc | 信用卡 CVC 码 | PropTypes.string | no | Android/iOS | yes | +| placeholder | 占位符文本 | PropTypes.object | no | Android/iOS | yes | +| scaledeprecated from 1.0.1 | 缩放卡片 | PropTypes.number | no | Android/iOS | yes | +| fontFamily | 默认为 iOS 中的 Courier 和 Android 中的 monospace | PropTypes.string | no | Android/iOS | yes | +| imageFront | 信用卡正面图片 | PropTypes.number | no | Android/iOS | yes | +| imageBack | 信用卡背面图片 | PropTypes.number | no | Android/iOS | yes | +| customIconsdeprecated from 1.0.1 | 卡片视图的品牌图标。详见./src/Icons.js | PropTypes.object | no | Android/iOS | yes | +| focusedField1.0.1+ | 指定当前聚焦的字段 | 'name' \| 'number' \| 'expiry' \| | no | Android/iOS | yes | +| type1.0.1+ | 指定信用卡发卡机构的类型 | 'visa' \| 'mastercard' \| 'american-express' \| 'diners-club' \| 'discover' \| 'jcb' | no | Android/iOS | yes | +| style1.0.1+ | 组件容器的自定义样式。 | PropTypes.style | no | Android/iOS | yes | ## 遗留问题 diff --git a/zh-cn/react-native-ezswiper.md b/zh-cn/react-native-ezswiper.md index 3b24a22a6a50c3203b3212d4e818195466f979ed..334c314dfd617cfc75bd0ec167fff8e9c875ebf4 100644 --- a/zh-cn/react-native-ezswiper.md +++ b/zh-cn/react-native-ezswiper.md @@ -14,6 +14,10 @@ > [!Tip] [Github 地址](https://github.com/easyui/react-native-ezswiper) +| Version | Support RN version | +| ------------ | ---------- | +| 1.3.0 | 0.72/0.77 | + ## 安装与使用 进入到工程目录并输入以下命令： @@ -325,8 +329,9 @@ const styles = StyleSheet.create({ 本文档内容基于以下版本验证通过： - 1.RNOH: 0.72.29; SDK：OpenHarmony-5.0.0.65; IDE：DevEco Studio 5.0.3.706; ROM：NEXT.0.0.65; - 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.29; SDK：OpenHarmony-5.0.0.65; IDE：DevEco Studio 5.0.3.706; ROM：NEXT.0.0.65; + 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 5.1.1 Release; IDE: DevEco Studio 5.1.1.830; ROM：NEXT 5.1.0.150; ## 属性 @@ -336,20 +341,20 @@ const styles = StyleSheet.create({ | Name | Description | Type | default | Required | Platform | HarmonyOS Support | | --------------------- | ------------------------------------------------------------------------------------------------------ | -------- | -------- | -------- | ----------------- | ----------------- | -| `width` | swiper width | number | | Yes | All | yes | -| `height` | swiper height | number | | Yes | All | yes | -| `index` | initial index bar. | number | 0 | No | All | yes | -| `offset` | initial left and right or up and down offsets view. | number | 0 | No | All | yes | -| `horizontal` | swiper derection is horizontal | boolean | true | No | All | yes | -| `loop` | swiper is loop | boolean | true | No | All | yes | -| `autoplayTimeout` | auto play mode (in second) | number | 5 | No | All | yes | -| `autoplayDirection` | cycle direction control | boolean | true | No | All | yes | -| `ratio` | scaling ratio | number | 1 | No | All | yes | -| `cardParams` | swiper card advanced object | object | {} | No | All | yes | -| `renderRow` | render card view | function | | Yes | All | yes | -| `onPress` | card is clicked action | function | | No | All | yes | -| `onWillChange` | next card will show | function | | No | All | yes | -| `onDidChange` | next card showed | function | | No | All | yes | +| `width` | 轮播组件宽度 | number | | Yes | All | yes | +| `height` | 轮播组件高度 | number | | Yes | All | yes | +| `index` | 初始索引。 | number | 0 | No | All | yes | +| `offset` | 初始的左右或上下偏移视图。 | number | 0 | No | All | yes | +| `horizontal` | 轮播方向是否为水平方向 | boolean | true | No | All | yes | +| `loop` | 轮播是否循环 | boolean | true | No | All | yes | +| `autoplayTimeout` | 自动播放模式（以秒为单位） | number | 5 | No | All | yes | +| `autoplayDirection` | 循环方向控制 | boolean | true | No | All | yes | +| `ratio` | 缩放比例 | number | 1 | No | All | yes | +| `cardParams` | 轮播卡片高级配置对象 | object | {} | No | All | yes | +| `renderRow` | 渲染卡片视图 | function | | Yes | All | yes | +| `onPress` | 卡片被点击时的动作 | function | | No | All | yes | +| `onWillChange` | 下一张卡片即将显示时 | function | | No | All | yes | +| `onDidChange` | 下一张卡片已显示时 | function | | No | All | yes | cardParams is object：{cardSide,cardSmallSide,cardSpace} @@ -360,9 +365,9 @@ cardParams is object：{cardSide,cardSmallSide,cardSpace} > [!Tip] "HarmonyOS Support"列为 yes 表示 HarmonyOS 平台支持该属性；no 则表示不支持；partially 表示部分支持。使用方法跨平台一致，效果对标 iOS 或 Android 的效果。 -| Name | Description | Type | Required | Platform | HarmonyOS Support | -| --------------------- | ------------------------------------------------------------------------------------------------------ | -------- | -------- | -------- | ----------------- | -| `scrollTo(index, animated = true)` | scroll to position | function | No | All | yes | +| Name | Description | Type | Required | Platform | HarmonyOS Support | +| ---------------------------------- | -------------- | -------- | -------- | -------- | ----------------- | +| `scrollTo(index, animated = true)` | 滚动到指定位置 | function | No | All | yes | ## 遗留问题 diff --git a/zh-cn/react-native-redash.md b/zh-cn/react-native-redash.md index e2737acd6273ef121bcde60a3ae716e91be5fac4..f392de59fa2ea16a6ca4a1665937d2d9bf5793e9 100644 --- a/zh-cn/react-native-redash.md +++ b/zh-cn/react-native-redash.md @@ -12,7 +12,11 @@

-> [!TIP] [Github 地址](https://github.com/wcandillon/react-native-redash/tree/v18.1.3) +> [!TIP] [GitHub address](https://github.com/wcandillon/react-native-redash/tree/v18.1.3) + +| Version | Support RN version | +| ------------ | ---------- | +| 18.1.3 | 0.72/0.77 | ## 安装与使用 @@ -576,6 +580,7 @@ export default function RadashDemo() { 本文档内容基于以下版本验证通过: 1. RNOH：0.72.28; SDK：HarmonyOS NEXT Developer Beta6 SDK 5.0.0.61; IDE：DevEco Studio 5.0.3.706; ROM：3.0.0.61; +2. RNOH：0.77.18; SDK：HarmonyOS 5.1.1 Release; IDE: DevEco Studio 5.1.1.830; ROM：NEXT 5.1.0.150; ## 静态方法 > [!TIP] "Platform"列表示该属性在原三方库上支持的平台。 @@ -587,60 +592,60 @@ export default function RadashDemo() { ### **Animations** | Name | Description | Type | Required | Platform | HarmonyOS Support | |:-----------------------:| :-----------------------------------------------: | :------------------------------------------------------: | :------: | :---------: | :---------------: | -| withPause() | Make an animation pausable. The state of the animation (paused or not) is controlled by a boolean shared value. | function | No | iOS/Android | yes | -| withBouncing() | Add a bouncing behavior to a physics-based animation. An animation is defined as being physics-based if it contains a velocity in its state. | function | No | iOS/Android | yes | +| withPause() | 使动画可暂停。动画的状态（暂停或未暂停）由布尔共享值控制。 | function | No | iOS/Android | yes | +| withBouncing() | 为基于物理的动画添加弹跳行为。如果动画在其状态中包含速度，则该动画被定义为基于物理的动画。 | function | No | iOS/Android | yes | ### **Coordinates** | Name | Description | Type | Required | Platform | HarmonyOS Support | |:-----------------------:| :-----------------------------------------------: | :------------------------------------------------------: | :------: | :---------: | :---------------: | -| canvas2Cartesian() | Convert plane coordinate system to Cadir coordinate system | function | No | iOS/Android | yes | -| cartesian2Canvas() | Convert Cadir coordinate system to plane coordinate system | function | No | iOS/Android | yes | -| cartesian2Polar() | Conversion from Cadir coordinate system to polar coordinate system | function | No | iOS/Android | yes | -| polar2Cartesian() | Convert polar coordinate system to Cadir coordinate system | function | No | iOS/Android | yes | -| polar2Canvas() | Convert polar coordinate system to plane coordinate system | function | No | iOS/Android | yes | -| canvas2Polar() | Convert plane coordinate system to polar coordinate system | function | No | iOS/Android | yes | +| canvas2Cartesian() | 将平面坐标系转换为笛卡尔坐标系 | function | No | iOS/Android | yes | +| cartesian2Canvas() | 将笛卡尔坐标系转换为平面坐标系 | function | No | iOS/Android | yes | +| cartesian2Polar() | 笛卡尔坐标系转换为极坐标系 | function | No | iOS/Android | yes | +| polar2Cartesian() | 将极坐标系转换为笛卡尔坐标系 | function | No | iOS/Android | yes | +| polar2Canvas() | 将极坐标系转换为平面坐标系 | function | No | iOS/Android | yes | +| canvas2Polar() | 将平面坐标系转换为极坐标系 | function | No | iOS/Android | yes | ### **Strings** | Name | Description | Type | Required | Platform | HarmonyOS Support | |:-----------------------:| :-----------------------------------------------: | :------------------------------------------------------: | :------: | :---------: | :---------------: | -| ReText | This component is like but accepts a string animation node as property. Behind the scene, is using with some default styling. Therefore there might be some slight inconsistencies with . | function | No | iOS/Android | yes | +| ReText | 该组件类似于 ``，但接受字符串动画节点作为属性。在幕后，`` 使用带有一些默认样式的 ``。因此，与 `` 可能存在一些细微的不一致。 | function | No | iOS/Android | yes | ### **Math** | Name | Description | Type | Required | Platform | HarmonyOS Support | |:-----------------------:| :-----------------------------------------------: | :------------------------------------------------------: | :------: | :---------: | :---------------: | -| mix() | mix performs a linear interpolation between x and y using a to weight between them. The return value is computed as x _ (1 - value) + y _ value | function | No | iOS/Android | yes | -| bin() | Convert a boolean value into a number. This can be useful in reanimated since 0 and 1 are used for conditional statements. | function | No | iOS/Android | yes | -| toRad() | Transforms an angle from degrees to radians| function | No | iOS/Android | yes | -| toDeg() | Transforms an angle from radians to degrees| function | No | iOS/Android | yes | -| clamp() | Clamps a node with a lower and upper bound | function | No | iOS/Android | yes | -| avg() | Returns the average value of an array | function | No | iOS/Android | yes | -| between() | Returns true if node is within lowerBound and upperBound| function | No | iOS/Android | yes | -| round() | Computes animation node rounded to precision | function | No | iOS/Android | yes | -| cubicBezier() | Returns the coordinate of a cubic bezier curve. t is the length of the curve from 0 to 1. cubicBezier(0, p0, p1, p2, p3) equals p0 and cubicBezier(1, p0, p1, p2, p3) equals p3. p0 and p3 are respectively the starting and ending point of the curve. p1 and p2 are the control points. | function | No | iOS/Android | yes | -| cubicBezierYForX() | Given a cubic Bèzier curve, return the y value for x | function | No | iOS/Android | yes | +| mix() | mix 使用权重在 x 和 y 之间执行线性插值。返回值计算为 x * (1 - value) + y * value | function | No | iOS/Android | yes | +| bin() | 将布尔值转换为数字。这在 reanimated 中可能很有用，因为 0 和 1 用于条件语句。 | function | No | iOS/Android | yes | +| toRad() | 将角度从度转换为弧度 | function | No | iOS/Android | yes | +| toDeg() | 将角度从弧度转换为度 | function | No | iOS/Android | yes | +| clamp() | 将节点限制在上下边界内 | function | No | iOS/Android | yes | +| avg() | 返回数组的平均值 | function | No | iOS/Android | yes | +| between() | 如果节点在 lowerBound 和 upperBound 范围内，则返回 true | function | No | iOS/Android | yes | +| round() | 计算动画节点四舍五入到指定精度 | function | No | iOS/Android | yes | +| cubicBezier() | 返回三次贝塞尔曲线的坐标。t 是从 0 到 1 的曲线长度。cubicBezier (0, p0, p1, p2, p3) 等于 p0，cubicBezier (1, p0, p1, p2, p3) 等于 p3。p0 和 p3 分别是曲线的起点和终点。p1 和 p2 是控制点。 | function | No | iOS/Android | yes | +| cubicBezierYForX() | 给定一条三次贝塞尔曲线，返回 x 对应的 y 值 | function | No | iOS/Android | yes | ### **Transitions** | Name | Description | Type | Required | Platform | HarmonyOS Support | |:-----------------------:| :-----------------------------------------------: | :------------------------------------------------------: | :------: | :---------: | :---------------: | -| useTiming() | Transitions can attach an animation value to a change of React state. | function | No | iOS/Android | yes | -| useSpring() | Transitions can attach an animation value to a change of React state. | function | No | iOS/Android | yes | +| useTiming() | 过渡可以将动画值附加到 React 状态的变化上。 | function | No | iOS/Android | yes | +| useSpring() | 过渡可以将动画值附加到 React 状态的变化上。 | function | No | iOS/Android | yes | ### **Vectors** | Name | Description | Type | Required | Platform | HarmonyOS Support | |:-----------------------:| :-----------------------------------------------: | :------------------------------------------------------: | :------: | :---------: | :---------------: | -| useVector() | Returns a vector of shared values. | function | No | iOS/Android | yes | +| useVector() | 返回共享值的向量。 | function | No | iOS/Android | yes | ### **Paths** | Name | Description | Type | Required | Platform | HarmonyOS Support | |:-----------------------:| :-----------------------------------------------: | :------------------------------------------------------: | :------: | :---------: | :---------------: | -| createPath(path, {x, y}) | Create a new path | function | No | iOS/Android | yes | -| addCurve(path, {c1: {x, y}, c2: {x, y}, to: {x, y}}) | Add a Bèzier curve command to a path | function | No | iOS/Android | yes | -| close(path) | Add a close command to a path | function | No | iOS/Android | yes | -| parse(path) | Parse an SVG path into a sequence of Bèzier curves. The SVG is normalized to have absolute values and to be approximated to a sequence of Bèzier curves. | function | No | iOS/Android | yes | -| serialize(path) | Serialize a path into an SVG path string | function | No | iOS/Android | yes | -| interpolatePath() | Interpolate between paths | function | No | iOS/Android | yes | +| createPath(path, {x, y}) | 创建一个新路径 | function | No | iOS/Android | yes | +| addCurve(path, {c1: {x, y}, c2: {x, y}, to: {x, y}}) | 向路径添加贝塞尔曲线命令 | function | No | iOS/Android | yes | +| close(path) | 向路径添加闭合命令 | function | No | iOS/Android | yes | +| parse(path) | 将 SVG 路径解析为一系列贝塞尔曲线。SVG 被规范化为具有绝对值，并近似为一系列贝塞尔曲线。 | function | No | iOS/Android | yes | +| serialize(path) | 将路径序列化为 SVG 路径字符串 | function | No | iOS/Android | yes | +| interpolatePath() | 在路径之间进行插值 | function | No | iOS/Android | yes | ### **Physics** | Name | Description | Type | Required | Platform | HarmonyOS Support | |:-----------------------:| :-----------------------------------------------: | :------------------------------------------------------: | :------: | :---------: | :---------------: | -| snapPoint() | Select a point where the animation should snap to given the value of the gesture and it's velocity. | function | No | iOS/Android | yes | +| snapPoint() | 给定手势的值及其速度，选择动画应该吸附到的点。 | function | No | iOS/Android | yes | ### **Colors** | Name | Description | Type | Required | Platform | HarmonyOS Support | |:-----------------------:| :-----------------------------------------------: | :------------------------------------------------------: | :------: | :---------: | :---------------: | -| mixColor() | Identical to interpolateColor() but with an animation value that goes from 0 to 1. | function | No | iOS/Android | yes | +| mixColor() | 与 interpolateColor () 相同，但动画值从 0 到 1。 | function | No | iOS/Android | yes | ## 遗留问题 diff --git a/zh-cn/rn-tourguide.md b/zh-cn/rn-tourguide.md index c62d9c79afebd728d65fdf3134fe46c694e36dbe..812c329e597ee4e5cb9502c7a37fc0fd214464d1 100644 --- a/zh-cn/rn-tourguide.md +++ b/zh-cn/rn-tourguide.md @@ -14,11 +14,18 @@

-> [!TIP] [Github 地址](https://github.com/react-native-oh-library/rn-tourguide) -## 安装与使用 +本项目基于[rn-tourguide](https://github.com/react-native-oh-library/rn-tourguide). + +该第三方库的仓库已迁移至 Gitcode，且支持直接从 npm 下载，新的包名为：`@react-native-ohos/rn-tourguide`。具体版本所属关系如下： + +| Version | Package Name | Repository | Release |Support RN version| +| ------------------------- | ------------------------------------------------- | ------------------ | -------------------------- |-------------------| +| 3.3.0 | @react-native-oh-tpl/rn-tourguide | [Github](https://github.com/react-native-oh-library/rn-tourguide) | [Github Releases](https://github.com/react-native-oh-library/rn-tourguide/releases) |0.72 | +| 3.4.0 | @react-native-ohos/rn-tourguide | [GitCode](https://gitcode.com/openharmony-sig/rntpc_rn-tourguide) | [GitCode Releases]() |0.77 | + -请到三方库的 Releases 发布地址查看配套的版本信息：[https://github.com/react-native-oh-library/rn-tourguide Releases](https://github.com/react-native-oh-library/rn-tourguide/releases) 。对于未发布到npm的旧版本，请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 +## 安装与使用 进入到工程目录并输入以下命令： @@ -27,13 +34,22 @@ #### **npm** ```bash + +# 0.72 npm install @react-native-oh-tpl/rn-tourguide + +# 0.77 +npm install @react-native-ohos/rn-tourguide ``` #### **yarn** ```bash +# 0.72 yarn add @react-native-oh-tpl/rn-tourguide + +# 0.77 +yarn add @react-native-ohos/rn-tourguide ``` @@ -208,7 +224,8 @@ const styles = StyleSheet.create({ 要使用此库，需要使用正确的 React-Native 和 RNOH 版本。另外，还需要使用配套的 DevEco Studio 和 手机 ROM。 -请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息：[@react-native-oh-tpl/rn-tourguide Releases](https://github.com/react-native-oh-library/rn-tourguide/releases) +1. RNOH: 0.72.27; SDK: HarmonyOS 5.1.1 Release SDK; IDE: DevEco Studio 5.1.1 Release; ROM: 5.0.1.120; +2. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.858; ROM: 6.0.0.112; ## 属性 @@ -221,77 +238,77 @@ const styles = StyleSheet.create({ ### TourGuideProvider | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| tooltipComponent | tooltip component | React.ComponentType | NO | ALL | YES | -| tooltipStyle | tooltip style | StyleProp | NO | ALL | YES | -| labels | Button text display in tooltip(skip、previous、next、finish) | Labels | NO | ALL | YES | +| tooltipComponent | 提示框组件 | React.ComponentType | NO | ALL | YES | +| tooltipStyle | 提示框样式 | StyleProp | NO | ALL | YES | +| labels | 提示框中显示的按钮文本（跳过、上一步、下一步、完成） | Labels | NO | ALL | YES | | startAtMount | | boolean/string | NO | ALL | YES | -| androidStatusBarVisible | android status bar visible | boolean | NO | Android | NO | -| backdropColor | background color | string | NO | ALL | YES | -| verticalOffset | vertical offset | number | NO | ALL | YES | -| wrapperStyle | wrap style | StyleProp | NO | ALL | YES | -| maskOffset | offset around zone | number | NO | ALL | YES | -| borderRadius | round corner when rectangle | number | NO | ALL | YES | -| animationDuration | Animation duration | number | NO | ALL | YES | -| children | React.ReactNode components | React.ReactNode | YES | ALL | YES | -| dismissOnPress | whether to display touchable | boolean | NO | ALL | YES | -| preventOutsideInteraction | Block default events | boolean | NO | ALL | YES | +| androidStatusBarVisible | 安卓状态栏是否显示安卓状态栏 | boolean | NO | Android | NO | +| backdropColor | 背景颜色 | string | NO | ALL | YES | +| verticalOffset | 垂直偏移量 | number | NO | ALL | YES | +| wrapperStyle | 包裹器样式 | StyleProp | NO | ALL | YES | +| maskOffset | 区域周围的偏移量 | number | NO | ALL | YES | +| borderRadius | 矩形时的圆角 | number | NO | ALL | YES | +| animationDuration | 动画持续时间 | number | NO | ALL | YES | +| children | React.ReactNode 组件 | React.ReactNode | YES | ALL | YES | +| dismissOnPress | 是否显示可点击区域 | boolean | NO | ALL | YES | +| preventOutsideInteraction | 阻止默认事件 | boolean | NO | ALL | YES | ### TourGuideZone | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| zone | A positive number indicating the order of the step in the entire walkthrough. | number | YES | ALL | YES | +| zone | 一个正数，表示整个引导流程中步骤的顺序 | number | YES | ALL | YES | | tourKey | | string | NO | ALL | YES | -| isTourGuide | return children without wrapping id false | boolean | NO | ALL | YES | -| text | text in tooltip | string | NO | ALL | YES | -| shape | which shape | Shape | NO | ALL | YES | -| maskOffset | offset around zone | number | NO | ALL | YES | -| borderRadius | round corner when rectangle | number | NO | ALL | YES | -| children | React.ReactNode components | React.ReactNode | NO | ALL | YES | +| isTourGuide | 如果为 false，则返回子组件而不进行包裹 | boolean | NO | ALL | YES | +| text | 提示框中的文本 | string | NO | ALL | YES | +| shape | 形状 | Shape | NO | ALL | YES | +| maskOffset | 区域周围的偏移量 | number | NO | ALL | YES | +| borderRadius | 矩形时的圆角 | number | NO | ALL | YES | +| children | React.ReactNode 组件 | React.ReactNode | NO | ALL | YES | | style | | StyleProp | NO | ALL | YES | -| keepTooltipPosition | tooltip positioning | boolean | NO | ALL | YES | -| tooltipBottomOffset | The distance between the tooltip and the bottom of the container | number | NO | ALL | YES | -| borderRadiusObject | Mask layer highlight area rounded corner settings | BorderRadiusObject | NO | ALL | YES | +| keepTooltipPosition | 提示框定位 | boolean | NO | ALL | YES | +| tooltipBottomOffset | 提示框与容器底部的距离 | number | NO | ALL | YES | +| borderRadiusObject | 遮罩层高亮区域的圆角设置 | BorderRadiusObject | NO | ALL | YES | ### Tooltip | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| isFirstStep | Is it the first step | boolean | NO | ALL | YES | -| isLastStep | Is it the last step | boolean | NO | ALL | YES | -| currentStep | current step | IStep | YES | ALL | YES | -| labels | Button text display in tooltip(skip、previous、next、finish) | Labels | NO | ALL | YES | -| handleNext | A function that handle next step | Function | NO | ALL | YES -| handlePrev | A function that handle prev step | Function | NO | ALL | YES -| handleStop | A function that handle stop | Function | NO | ALL | YES +| isFirstStep | 是否为第一步 | boolean | NO | ALL | YES | +| isLastStep | 是否为最后一步 | boolean | NO | ALL | YES | +| currentStep | 当前步骤 | IStep | YES | ALL | YES | +| labels | 提示框中显示的按钮文本（跳过、上一步、下一步、完成） | Labels | NO | ALL | YES | +| handleNext | 处理下一步的函数 | Function | NO | ALL | YES| +| handlePrev | 处理上一步的函数 | Function | NO | ALL | YES| +| handleStop | 处理停止的函数 | Function | NO | ALL | YES| ### TourGuideZoneByPosition | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | | zone | | number | YES | ALL | YES | | tourKey | | string | NO | ALL | YES | -| isTourGuide | return children without wrapping id false | boolean | NO | ALL | YES | -| top | tour guide zone distance from top | number/string | NO | ALL | YES | -| left | tour guide zone distance from left | number/string | NO | ALL | YES | -| right | tour guide zone distance from right | number/string | NO | ALL | YES | -| bottom | tour guide zone distance from bottom | number/string | NO | ALL | YES | -| width | The width of the highlight area of ​​the mask layer | number/string | NO | ALL | YES | -| height | The height of the highlight area of ​​the mask layer | number/string | NO | ALL | YES | -| shape | which shape | Shape | NO | ALL | YES | -| borderRadiusObject | Mask layer highlight area rounded corner settings | BorderRadiusObject | NO | ALL | YES | -| containerStyle | Mask layer wrapping layer style | StyleProp | NO | ALL | YES | -| keepTooltipPosition | tooltip positioning | boolean | NO | ALL | YES | -| tooltipBottomOffset | The distance between the tooltip and the bottom of the container | number | NO | ALL | YES | -| text | text in tooltip | string | NO | ALL | YES | +| isTourGuide | 如果为 false，则返回子组件而不进行包裹 | boolean | NO | ALL | YES | +| top | 引导区域距离顶部的距离 | number/string | NO | ALL | YES | +| left | 引导区域距离左侧的距离 | number/string | NO | ALL | YES | +| right | 引导区域距离右侧的距离 | number/string | NO | ALL | YES | +| bottom | 引导区域距离底部的距离 | number/string | NO | ALL | YES | +| width | 遮罩层高亮区域的宽度 | number/string | NO | ALL | YES | +| height | 遮罩层高亮区域的高度 | number/string | NO | ALL | YES | +| shape | 形状 | Shape | NO | ALL | YES | +| borderRadiusObject | 遮罩层高亮区域的圆角设置 | BorderRadiusObject | NO | ALL | YES | +| containerStyle | 遮罩层包裹层样式 | StyleProp | NO | ALL | YES | +| keepTooltipPosition | 提示框定位 | boolean | NO | ALL | YES | +| tooltipBottomOffset | 提示框与容器底部的距离 | number | NO | ALL | YES | +| text | 提示框中的文本 | string | NO | ALL | YES | ### useTourGuideController | Name | Description | Type | Required | Platform | HarmonyOS Support | | ---- | ----------- | ---- | -------- | -------- | ------------------ | -| start | start tour guide | Funtion | YES | ALL | YES | -| eventEmitter | event emitter | Funtion/undefined | YES | ALL | YES | -| getCurrentStep | Get the mask layer pop-up component | Funtion/undefined | YES | ALL | YES | -| canStart | whether to support tour guide | boolean/undefined | YES | ALL | YES | -| tourKey | tour guide key | string | YES | ALL | YES | -| TourGuideZone | boot area | Funtion | YES | ALL | YES | -| TourGuideZoneByPosition | tourGuide area location | Funtion | YES | ALL | YES | +| start | 开始引导 | Funtion | YES | ALL | YES | +| eventEmitter | 事件发射器 | Funtion/undefined | YES | ALL | YES | +| getCurrentStep | 获取遮罩层弹出组件 | Funtion/undefined | YES | ALL | YES | +| canStart | 是否支持引导 | boolean/undefined | YES | ALL | YES | +| tourKey | 引导键 | string | YES | ALL | YES | +| TourGuideZone | 引导区域 | Funtion | YES | ALL | YES | +| TourGuideZoneByPosition | 引导区域位置 | Funtion | YES | ALL | YES | ## 遗留问题