From e449356d92155e002131fb58a7b8064b73b12e39 Mon Sep 17 00:00:00 2001 From: 2301_79171201 <2957970070@qq.com> Date: Thu, 18 Dec 2025 15:23:19 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20[Issues:=20#IDDU9R]=E4=BF=AE=E6=94=B9re?= =?UTF-8?q?act-native-swiper=E4=B8=AD=E8=8B=B1=E6=96=87=E6=96=87=E6=A1=A3?= =?UTF-8?q?=E9=85=8D=E5=A5=97=E7=89=88=E6=9C=AC=E4=BF=A1=E6=81=AF?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- en/react-native-swiper.md | 47 ++++++++++++++++++++++++++---------- zh-cn/react-native-swiper.md | 42 +++++++++++++++++++++++++------- 2 files changed, 67 insertions(+), 22 deletions(-) diff --git a/en/react-native-swiper.md b/en/react-native-swiper.md index 61747d938..1b62cab69 100644 --- a/en/react-native-swiper.md +++ b/en/react-native-swiper.md @@ -1,4 +1,13 @@ -> Template version: v0.2.2 +Please check the version information matching the Release at the corresponding Releases page of the third-party library: + +| Third-party library version | Release information | Supported RN version | +| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------- | ---------------------- | +| 1.6.1 | [@react-native-oh-tpl/react-native-swiper Releases](https://github.com/react-native-oh-library/react-native-swiper/releases) | 0.72 | +| 1.6.1 | [@react-native-ohos/react-native-swiper]() | 0.77 | + +For older versions not published to npm, please refer to the [Installation Guide](https://zh-cn/tgz-usage.md) to install the tgz package. + +Navigate to your project directory and enter the following command:> Template version: v0.2.2

@react-native-oh-tpl/react-native-swiper

@@ -12,7 +21,6 @@

- > [!TIP] [Github address](https://github.com/react-native-oh-library/react-native-swiper) ## Installation and Usage @@ -22,13 +30,21 @@ #### **npm** ```bash +# V1.6.1 npm i @react-native-oh-tpl/react-native-swiper --save + +# V1.6.1 +npm i @react-native-ohos/react-native-swiper --save ``` #### **yarn** ```bash -yarn add @react-native-oh-tpl/react-native-swiper +# V1.6.1 +npm i @react-native-oh-tpl/react-native-swiper --save + +# V1.6.1 +npm i @react-native-ohos/react-native-swiper --save ``` @@ -93,10 +109,14 @@ AppRegistry.registerComponent("myproject", () => SwiperComponent); ### Compatibility -This document is verified based on the following versions: +Please check the version information matching the Release at the corresponding Releases page of the third-party library: -1. RNOH: 0.72.13; SDK: HarmonyOS NEXT Developer Preview1; IDE: DevEco Studio 4.1.3.500; ROM: 2.0.0.58; -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; +| Third-party library version | Release information | Supported RN version | +| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------- | ---------------------- | +| 1.6.1 | [@react-native-oh-tpl/react-native-swiper Releases](https://github.com/react-native-oh-library/react-native-swiper/releases) | 0.72 | +| 1.6.1 | [@react-native-ohos/react-native-swiper]() | 0.77 | + +For older versions not published to npm, please refer to the [Installation Guide](https://zh-cn/tgz-usage.md) to install the tgz package. ## Properties @@ -125,7 +145,7 @@ This document is verified based on the following versions: | containerStyle | See default container style in source. | `style` | {...} | All | YES | | loadMinimal | Only load current index slide, `loadMinimalSize` slides before and after. | `bool` | false | All | YES | | loadMinimalSize | see `loadMinimal` | `number` | 1 | All | YES | -| loadMinimalLoader | Custom loader to display when slides aren't loaded | `element` | `` | All | YES | +| loadMinimalLoader | Custom loader to display when slides aren't loaded | `element` | `` | All | YES | #### Pagination @@ -134,8 +154,8 @@ This document is verified based on the following versions: | showsPagination | Set to `true` make pagination visible. | `bool` | true | All | YES | | paginationStyle | Custom styles will merge with the default styles. | `style` | {...} | All | YES | | renderPagination | Complete control how to render pagination with three params (`index`, `total`, `context`) ref to `this.state.index` / `this.state.total` / `this`, For example: show numbers instead of dots. | `function` | - | All | YES | -| dot | Allow custom the dot element. | `element` | `` | All | YES | -| activeDot | Allow custom the active-dot element. | `element` | `` | All | YES | +| dot | Allow custom the dot element. | `element` | `` | All | YES | +| activeDot | Allow custom the active-dot element. | `element` | `` | All | YES | | dotStyle | Allow custom the dot element. | `object` | - | All | YES | | dotColor | Allow custom the dot element. | `string` | - | All | YES | | activeDotColor | Allow custom the active-dot element. | `string` | - | All | YES | @@ -155,15 +175,15 @@ This document is verified based on the following versions: | :----------------- | :----------------------------------------------------------: | :-------: | :------------------------------------------ | -------- | ----------------- | ------ | | showsButtons | true | `bool` | Set to `true` make control buttons visible. | All | YES | -- | | buttonWrapperStyle | `{backgroundColor: 'transparent', flexDirection: 'row', position: 'absolute', top: 0, left: 0, flex: 1, paddingHorizontal: 10, paddingVertical: 10, justifyContent: 'space-between', alignItems: 'center'}` | `style` | Custom styles. | All | YES | -- | -| nextButton | `›` | `element` | Allow custom the next button. | All | YES | -- | -| prevButton | `‹` | `element` | Allow custom the prev button. | All | YES | -- | +| nextButton | `›` | `element` | Allow custom the next button. | All | YES | -- | +| prevButton | `‹` | `element` | Allow custom the prev button. | All | YES | -- | #### Props of Children | Name | Description | Type | Default | platform | HarmonyOS Support | | :---- | :----------------------------------------------------------- | :-------: | :----------------------------------: | -------- | ----------------- | | style | Custom styles will merge with the default styles. | `style` | {...} | All | YES | -| title | If this parameter is not specified, will not render the title. | `element` | {...} | All | YES | +| title | If this parameter is not specified, will not render the title. | `element` | {...} | All | YES | #### Basic props of `` @@ -230,4 +250,5 @@ var swiper = React.createClass({ ### License -This project is licensed under [The MIT License (MIT)](https://github.com/leecade/react-native-swiper/blob/master/LICENSE). \ No newline at end of file +This project is licensed under [The MIT License (MIT)](https://github.com/leecade/react-native-swiper/blob/master/LICENSE). + diff --git a/zh-cn/react-native-swiper.md b/zh-cn/react-native-swiper.md index a1efaa524..050b59f1b 100644 --- a/zh-cn/react-native-swiper.md +++ b/zh-cn/react-native-swiper.md @@ -14,6 +14,17 @@ > [!TIP] [Github 地址](https://github.com/react-native-oh-library/react-native-swiper) +请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息： + +| 三方库版本 | 发布信息 | 支持RN版本 | +| ---------- | ------------------------------------------------------------ | ---------- | +| 1.6.1 | [@react-native-oh-tpl/react-native-swiper Releases](https://github.com/react-native-oh-library/react-native-swiper/releases) | 0.72 | +| 1.6.1 | [@react-native-ohos/react-native-swiper]() | 0.77 | + +对于未发布到npm的旧版本，请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 + +进入到工程目录并输入以下命令： + ## 安装与使用 @@ -21,13 +32,21 @@ #### **npm** ```bash +# V1.6.1 npm i @react-native-oh-tpl/react-native-swiper --save + +# V1.6.1 +npm i @react-native-ohos/react-native-swiper --save ``` #### **yarn** ```bash +# V1.6.1 yarn add @react-native-oh-tpl/react-native-swiper + +# V1.6.1 +yarn add @react-native-ohos/react-native-swiper ``` @@ -92,10 +111,14 @@ AppRegistry.registerComponent("myproject", () => SwiperComponent); ### 兼容性 -在以下版本验证通过 +请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息： -1. RNOH：0.72.13; SDK：HarmonyOS NEXT Developer Preview1; IDE：DevEco Studio 4.1.3.500; ROM：2.0.0.58; -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; +| 三方库版本 | 发布信息 | 支持RN版本 | +| ---------- | ------------------------------------------------------------ | ---------- | +| 1.6.1 | [@react-native-oh-tpl/react-native-swiper Releases](https://github.com/react-native-oh-library/react-native-swiper/releases) | 0.72 | +| 1.6.1 | [@react-native-ohos/react-native-swiper]() | 0.77 | + +对于未发布到npm的旧版本，请参考[安装指南](/zh-cn/tgz-usage.md)安装tgz包。 ## 属性 @@ -124,7 +147,7 @@ AppRegistry.registerComponent("myproject", () => SwiperComponent); | containerStyle | See default container style in source. | `style` | {...} | All | YES | | loadMinimal | Only load current index slide , `loadMinimalSize` slides before and after. | `bool` | false | All | YES | | loadMinimalSize | see `loadMinimal` | `number` | 1 | All | YES | -| loadMinimalLoader | Custom loader to display when slides aren't loaded | `element` | `` | All | YES | +| loadMinimalLoader | Custom loader to display when slides aren't loaded | `element` | `` | All | YES | #### Pagination @@ -133,8 +156,8 @@ AppRegistry.registerComponent("myproject", () => SwiperComponent); | showsPagination | Set to `true` make pagination visible. | `bool` | true | All | YES | | paginationStyle | Custom styles will merge with the default styles. | `style` | {...} | All | YES | | renderPagination | Complete control how to render pagination with three params (`index`, `total`, `context`) ref to `this.state.index` / `this.state.total` / `this`, For example: show numbers instead of dots. | `function` | - | All | YES | -| dot | Allow custom the dot element. | `element` | `` | All | YES | -| activeDot | Allow custom the active-dot element. | `element` | `` | All | YES | +| dot | Allow custom the dot element. | `element` | `` | All | YES | +| activeDot | Allow custom the active-dot element. | `element` | `` | All | YES | | dotStyle | Allow custom the dot element. | `object` | - | All | YES | | dotColor | Allow custom the dot element. | `string` | - | All | YES | | activeDotColor | Allow custom the active-dot element. | `string` | - | All | YES | @@ -154,15 +177,15 @@ AppRegistry.registerComponent("myproject", () => SwiperComponent); | :----------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------: | :------------------------------------------ | -------- | ----------------- | ------ | | showsButtons | true | `bool` | Set to `true` make control buttons visible. | All | YES | -- | | buttonWrapperStyle | `{backgroundColor: 'transparent', flexDirection: 'row', position: 'absolute', top: 0, left: 0, flex: 1, paddingHorizontal: 10, paddingVertical: 10, justifyContent: 'space-between', alignItems: 'center'}` | `style` | Custom styles. | All | YES | -- | -| nextButton | `›` | `element` | Allow custom the next button. | All | YES | -- | -| prevButton | `‹` | `element` | Allow custom the prev button. | All | YES | -- | +| nextButton | `›` | `element` | Allow custom the next button. | All | YES | -- | +| prevButton | `‹` | `element` | Allow custom the prev button. | All | YES | -- | #### Props of Children | Name | Description | Type | Default | platform | HarmonyOS Support | | :---- | :----------------------------------------------------------- | :-------: | :----------------------------------: | -------- | ----------------- | | style | Custom styles will merge with the default styles. | `style` | {...} | All | YES | -| title | If this parameter is not specified, will not render the title. | `element` | {...} | All | YES | +| title | If this parameter is not specified, will not render the title. | `element` | {...} | All | YES | #### Basic props of `` @@ -230,3 +253,4 @@ var swiper = React.createClass({ ### 开源协议 本项目基于 [The MIT License (MIT)](https://github.com/leecade/react-native-swiper/blob/master/LICENSE) ，请自由地享受和参与开源。 + -- Gitee