From e268540bfc9ae69193dde502319c3728a9e320b9 Mon Sep 17 00:00:00 2001 From: wang-yuanbai <603970629@qq.com> Date: Wed, 13 Dec 2023 20:14:34 +0800 Subject: [PATCH 1/7] =?UTF-8?q?[Issues:=20#I8MN0L]=20=E6=B7=BB=E5=8A=A0rea?= =?UTF-8?q?ct-navigation-elements=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- zh-cn/react-navigation-elements.md | 151 +++++++++++++++++++++++++++++ zh-cn/react-navigation.md | 33 +++++++ 2 files changed, 184 insertions(+) create mode 100644 zh-cn/react-navigation-elements.md create mode 100644 zh-cn/react-navigation.md diff --git a/zh-cn/react-navigation-elements.md b/zh-cn/react-navigation-elements.md new file mode 100644 index 00000000..f3bc65da --- /dev/null +++ b/zh-cn/react-navigation-elements.md @@ -0,0 +1,151 @@ +> 模板版本：v0.0.1 + +

+

@react-navigation/elements

+

+

+ + Supported platforms + + + License + +

+ +## 安装与使用 + +进入到工程目录并输入以下命令： + + + +<<<<<<< HEAD +**正在 npm 发布中，当前请先从仓库[Release](https://github.com/react-native-oh-library/react-navigation/releases?q=elements&expanded=true)中获取库 tgz，通过使用本地依赖来安装本库。** + +#### **yarn** + +```bash +yarn add xxx +======= +#### **yarn** + +```bash +yarn add @react-navigation/elements@npm:@react-native-oh-tpl/elements +>>>>>>> 9b13f3257598515583ce93032d79edd9a203aa00 +``` + +#### **npm** + +```bash +<<<<<<< HEAD +npm install xxx +======= +npm install @react-navigation/elements@npm:@react-native-oh-tpl/elements +>>>>>>> 9b13f3257598515583ce93032d79edd9a203aa00 +``` + + + +## 兼容性 + +要使用此库，需要使用正确的 React-Native 和 RNOH 版本。另外，还需要使用配套的 DevEco Studio 和 手机 ROM。 + +<<<<<<< HEAD +请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息：[@react-native-oh-tpl/react-navigation Releases](https://github.com/react-native-oh-library/react-navigation/releases?q=elements&expanded=true) +======= +请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息：[@react-native-oh-tpl/react-navigation Releases](https://github.com/react-native-oh-library/react-navigation/releases) +>>>>>>> 9b13f3257598515583ce93032d79edd9a203aa00 + +## 属性 + +详细请查看 [react-navigation/elements 的文档介绍](https://reactnavigation.org/docs/elements/#resourcesavingview) + + +**Header**：用作标头的组件 + +| 名称 | 说明 | 类型 | 是否必填 | 原库平台 | 鸿蒙支持 | +| :-----: | :------: | :-------------: | -------- | -------- | -------- | +| headerTitle | 场景标题，或者返回一个React元素用作标题 | string \| React.reactNode | No | All | 未验证 | +| headerTitleAlign | 标题对齐方式 | left \| center | No | All | 未验证 | +| headerTitleAllowFontScaling | 标题是否缩放 | boolean | No | All | 未验证 | +| headerLeft | 函数，返回一个React元素用在页眉左侧 | React.reactNode | No | All | 未验证 | +| headerRight | 函数，返回一个React元素用在页眉右侧 | React.reactNode | No | All | 未验证 | +| headerShadowVisible | 是否显示阴影 | boolean | No | All | 未验证 | +| headerStyle | 页眉样式 | ViewStyle | No | All | 未验证 | +| headerTitleStyle | 页眉标题颜色 | TextStyle | No | All | 未验证 | +| headerLeftContainerStyle | headerLeft容器的样式 | ViewStyle | No | All | 未验证 | +| headerRightContainerStyle | headerRight容器的样式 | ViewStyle | No | All | 未验证 | +| headerTitleContainerStyle | headerTitle容器的样式 | ViewStyle | No | All | 未验证 | +| headerBackgroundContainerStyle | headerBackground容器的样式 | ViewStyle | No | All | 未验证 | +| headerTintColor | 页眉颜色 | string | No | All | 未验证 | +| headerPressColor | 页眉按下颜色 | string | No | All | 未验证 | +| headerPressOpacity | 页眉按下不透明度 | number | No | All | 未验证 | +| headerTransparent | 页眉是否透明 | boolean | No | All | 未验证 | +| headerBackground | 函数，返回一个React元素对页眉背景渲染 | function | No | All | 未验证 | +| headerStatusBarHeight | 页眉状态栏高度 | number | No | All | 未验证 | + +**HeaderBackground**：可用于Header的headerBackground属性 + +**HeaderTitle**：可用于Header的headerTitle属性 + +**HeaderBackButton**：用于显示后退按钮标题的组件 + +| 名称 | 说明 | 类型 | 是否必填 | 原库平台 | 鸿蒙支持 | +| :-----: | :------: | :-------------: | -------- | -------- | -------- | +| disabled | 是否可用 | boolean | No | All | 未验证 | +| onPress | 点击事件 | function | No | All | 未验证 | +| pressColor | 点击时的颜色 | string | No | All | 未验证 | +| backImage | 函数，返回一个React元素用于后退按钮显示的图片 | React.reactNode | No | All | 未验证 | +| tintColor | 按钮颜色 | string | No | All | 未验证 | +| label | 按钮的文本 | string | No | All | 未验证 | +| truncatedLabel | 空间不足时显示的文本 | string | No | All | 未验证 | +| labelVisible | 文本是否可见 | boolean | No | All | 未验证 | +| labelStyle | 文本样式 | TextStyle | No | All | 未验证 | +| allowFontScaling | 文本是否根据字体缩放 | boolean | No | All | 未验证 | +| onLabelLayout | 标签大小更改时要触发的回调。 | function | No | All | 未验证 | +| screenLayout | 屏幕布局 | Layout | No | All | 未验证 | +| titleLayout | 标题中title元素的布局 | Layout | No | All | 未验证 | +| canGoBack | 能否导航回来 | boolean | No | All | 未验证 | +| accessibilityLabel | 屏幕阅读器按钮的辅助功能标签 | string | No | All | 未验证 | +| testID | ID | string | No | All | 未验证 | +| style | 按钮样式 | ViewStyle | No | All | 未验证 | + + +**MissingIcon**：渲染丢失的图标符号的组件。它可以用作图标的回退，以显示缺少图标 + +| 名称 | 说明 | 类型 | 是否必填 | 原库平台 | 鸿蒙支持 | +| :-----: | :------: | :-------------: | -------- | -------- | -------- | +| color | icon的颜色 | string | No | All | 未验证 | +| size | icon的大小 | number | No | All | 未验证 | +| style | icon的样式 | TextStyle | No | All | 未验证 | + +**PlatformPressable**：在[Pressable](https://reactnative.dev/docs/Pressable)之上提供抽象以处理平台差异的组件 +| 名称 | 说明 | 类型 | 是否必填 | 原库平台 | 鸿蒙支持 | +| :-----: | :------: | :-------------: | -------- | -------- | -------- | +| pressColor | 按压时的颜色 | string | No | All | 未验证 | +| pressOpacity | 按压时的不透明度 | number | No | All | 未验证 | + +**ResourceSavingView**：通过使用removeClippedSubviews来帮助提高非活动屏幕的性能的组件，它接受一个可见的道具来指示是否应该剪辑屏幕 + +**SafeAreaProviderCompat**：来自“react native safe-area context”的SafeAreaProvider组件的包装器 + +**HeaderBackContext**：React上下文，可用于获取父屏幕的后标题 + +**HeaderShownContext**：React上下文，可用于检查页眉在父屏幕中是否可见 + +**HeaderHeightContext**：React上下文，可用于获取父屏幕中最近的可见页眉的高度 + +## 方法 + +| 名称 | 说明 | 类型 | 是否必填 | 原库平台 | 鸿蒙支持 | +| ----------------------- | -------------------- | -------- | -------- | -------- | -------- | +| `useHeaderHeight` | 返回父屏幕中最近的可见页眉的高度 | function | no | All | 未验证 | +| `getDefaultHeaderHeight` | 返回默认页眉高度 | function | no | All | yes | +| `getHeaderTitle` | 返回页眉标题文本 | function | no | All | 未验证 | + +## 遗留问题 + +## 其他 + +## 开源协议 + +本项目基于 [The MIT License (MIT)](https://github.com/react-navigation/react-navigation/blob/6.x/packages/elements/LICENSE) ，请自由地享受和参与开源。 diff --git a/zh-cn/react-navigation.md b/zh-cn/react-navigation.md new file mode 100644 index 00000000..38c2531b --- /dev/null +++ b/zh-cn/react-navigation.md @@ -0,0 +1,33 @@ +> 模板版本：v0.0.1 + +

+

react-navigation

+

+

+ + Supported platforms + + + License + +

+ +## Package Versions +|Name | Latest Version | +| ---------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------: | +| [@react-navigation/bottom-tabs](./#) | [![badge](https://img.shields.io/npm/v/@react-navigation/bottom-tabs.svg)](https://www.npmjs.com/package/@react-navigation/bottom-tabs) | +| [@react-navigation/core](./#) | [![badge](https://img.shields.io/npm/v/@react-navigation/core.svg)](https://www.npmjs.com/package/@react-navigation/core) | +| [@react-navigation/devtools](./#) | [![badge](https://img.shields.io/npm/v/@react-navigation/devtools.svg)](https://www.npmjs.com/package/@react-navigation/devtools) | +| [@react-navigation/drawer](./#) | [![badge](https://img.shields.io/npm/v/@react-navigation/drawer.svg)](https://www.npmjs.com/package/@react-navigation/drawer) | +| [@react-navigation/elements](./react-navigation-elements.md) | [![badge](https://img.shields.io/npm/v/@react-navigation/elements.svg)](https://www.npmjs.com/package/@react-navigation/elements) | +| [@react-navigation/material-top-tabs](./#) |[![badge](https://img.shields.io/npm/v/@react-navigation/material-top-tabs.svg)](https://www.npmjs.com/package/@react-navigation/material-top-tabs) | +| [@react-navigation/native-stack](./#) | [![badge](https://img.shields.io/npm/v/@react-navigation/native-stack.svg)](https://www.npmjs.com/package/@react-navigation/native-stack) | +| [@react-navigation/native](./#) | [![badge](https://img.shields.io/npm/v/@react-navigation/native.svg)](https://www.npmjs.com/package/@react-navigation/native) | +| [@react-navigation/routers](./#) | [![badge](https://img.shields.io/npm/v/@react-navigation/routers.svg)](https://www.npmjs.com/package/@react-navigation/routers) | +| [@react-navigation/stack](./#) | [![badge](https://img.shields.io/npm/v/@react-navigation/stack.svg)](https://www.npmjs.com/package/@react-navigation/stack) | +| [react-native-tab-view](./#) | [![badge](https://img.shields.io/npm/v/react-native-tab-view.svg)](https://www.npmjs.com/package/react-native-tab-view) | + + +## 开源协议 + +本项目基于 [The MIT License (MIT)](https://github.com/a7ul/react-native-exception-handler/blob/master/LICENSE) ，请自由地享受和参与开源。 -- Gitee From 6934bf0a6e6b787bea865fbff9e447665c41df86 Mon Sep 17 00:00:00 2001 From: wang-yuanbai <603970629@qq.com> Date: Wed, 13 Dec 2023 20:18:10 +0800 Subject: [PATCH 2/7] =?UTF-8?q?[Issues:=20#I8MN0L]=20=E8=A7=A3=E5=86=B3?= =?UTF-8?q?=E5=86=B2=E7=AA=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- zh-cn/react-navigation-elements.md | 16 ---------------- 1 file changed, 16 deletions(-) diff --git a/zh-cn/react-navigation-elements.md b/zh-cn/react-navigation-elements.md index f3bc65da..eaf31f41 100644 --- a/zh-cn/react-navigation-elements.md +++ b/zh-cn/react-navigation-elements.md @@ -18,29 +18,17 @@ -<<<<<<< HEAD **正在 npm 发布中，当前请先从仓库[Release](https://github.com/react-native-oh-library/react-navigation/releases?q=elements&expanded=true)中获取库 tgz，通过使用本地依赖来安装本库。** - #### **yarn** ```bash yarn add xxx -======= -#### **yarn** - -```bash -yarn add @react-navigation/elements@npm:@react-native-oh-tpl/elements ->>>>>>> 9b13f3257598515583ce93032d79edd9a203aa00 ``` #### **npm** ```bash -<<<<<<< HEAD npm install xxx -======= -npm install @react-navigation/elements@npm:@react-native-oh-tpl/elements ->>>>>>> 9b13f3257598515583ce93032d79edd9a203aa00 ``` @@ -49,11 +37,7 @@ npm install @react-navigation/elements@npm:@react-native-oh-tpl/elements 要使用此库，需要使用正确的 React-Native 和 RNOH 版本。另外，还需要使用配套的 DevEco Studio 和 手机 ROM。 -<<<<<<< HEAD 请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息：[@react-native-oh-tpl/react-navigation Releases](https://github.com/react-native-oh-library/react-navigation/releases?q=elements&expanded=true) -======= -请到三方库相应的 Releases 发布地址查看 Release 配套的版本信息：[@react-native-oh-tpl/react-navigation Releases](https://github.com/react-native-oh-library/react-navigation/releases) ->>>>>>> 9b13f3257598515583ce93032d79edd9a203aa00 ## 属性 -- Gitee From 2d5425989af79143871f0e1552a301cdb1bbec36 Mon Sep 17 00:00:00 2001 From: wang-yuanbai <603970629@qq.com> Date: Sun, 24 Dec 2023 11:15:34 +0800 Subject: [PATCH 3/7] =?UTF-8?q?[Issues:=20#I8QULT]=20=E6=B7=BB=E5=8A=A0VMa?= =?UTF-8?q?ll=E7=89=88=E6=9C=ACreact-native-exception-handler=E6=96=87?= =?UTF-8?q?=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- zh-cn/react-native-exception-handler.md | 16 ++++++---------- 1 file changed, 6 insertions(+), 10 deletions(-) diff --git a/zh-cn/react-native-exception-handler.md b/zh-cn/react-native-exception-handler.md index 1260dc90..10370c01 100644 --- a/zh-cn/react-native-exception-handler.md +++ b/zh-cn/react-native-exception-handler.md @@ -1,4 +1,4 @@ -> 模板版本：v0.0.1 +> 模板版本：v0.1.1

react-native-exception-handler

@@ -18,18 +18,14 @@ -**正在 npm 发布中，当前请先从仓库[Release](https://github.com/react-native-oh-library/react-native-exception-handler/releases)中获取库 tgz，通过使用本地依赖来安装本库。** - -#### **yarn** - ```bash -yarn add xxx +yarn add @react-native-oh-tpl/react-native-exception-handler ``` #### **npm** ```bash -npm install xxx +npm install @react-native-oh-tpl/react-native-exception-handler ``` @@ -119,7 +115,7 @@ setNativeExceptionHandler( ```diff "dependencies": { "rnoh": "file:../rnoh", -+ "rnoh-exception-handler": "file:../../node_modules/react-native-exception-handler/harmony/exception_handler.har", ++ "rnoh-exception-handler": "file:../../node_modules/@react-native-oh-tpl/react-native-exception-handler/harmony/exception_handler.har", } ``` @@ -138,7 +134,7 @@ ohpm install ```diff "dependencies": { "rnoh": "file:../rnoh", -+ "rnoh-exception-handler": "file:../../node_modules/react-native-exception-handler/harmony/exception_handler" ++ "rnoh-exception-handler": "file:../../node_modules/@react-native-oh-tpl/react-native-exception-handler/harmony/exception_handler" } ``` @@ -219,7 +215,7 @@ export function createRNPackages(ctx: RNPackageContext): RNPackage[] { 在 `YourProject/entry/src/main/ets/pages` 目录下,新建文件`ExceptionView.ets` ```typescript -import { ExceptionComopnent } from 'rnoh-exception-handler'; +import { ExceptionComponent } from 'rnoh-exception-handler'; import router from '@ohos.router'; interface RouterParam { -- Gitee From 864a93791b1c7994e83ee776b6ed2cb2f6e8275e Mon Sep 17 00:00:00 2001 From: wang-yuanbai <603970629@qq.com> Date: Sun, 24 Dec 2023 11:33:36 +0800 Subject: [PATCH 4/7] =?UTF-8?q?[Issues:=20#I8QULT]=20=E6=B7=BB=E5=8A=A0VMa?= =?UTF-8?q?ll=E7=89=88=E6=9C=ACreact-navigation/elements=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- zh-cn/react-navigation-elements.md | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/zh-cn/react-navigation-elements.md b/zh-cn/react-navigation-elements.md index eaf31f41..a3e07e5e 100644 --- a/zh-cn/react-navigation-elements.md +++ b/zh-cn/react-navigation-elements.md @@ -18,17 +18,16 @@ -**正在 npm 发布中，当前请先从仓库[Release](https://github.com/react-native-oh-library/react-navigation/releases?q=elements&expanded=true)中获取库 tgz，通过使用本地依赖来安装本库。** #### **yarn** ```bash -yarn add xxx +yarn add @react-native-oh-tpl/elements ``` #### **npm** ```bash -npm install xxx +npm install @react-native-oh-tpl/elements ``` -- Gitee From 9518b0730f3fa38629e3f12967b6169154c2b226 Mon Sep 17 00:00:00 2001 From: wang-yuanbai <603970629@qq.com> Date: Sun, 24 Dec 2023 11:34:37 +0800 Subject: [PATCH 5/7] =?UTF-8?q?[Issues:=20#I8QULT]=20=E6=B7=BB=E5=8A=A0VMa?= =?UTF-8?q?ll=E7=89=88=E6=9C=ACreact-navigation/elements=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- zh-cn/react-navigation-elements.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-cn/react-navigation-elements.md b/zh-cn/react-navigation-elements.md index a3e07e5e..82395d36 100644 --- a/zh-cn/react-navigation-elements.md +++ b/zh-cn/react-navigation-elements.md @@ -1,4 +1,4 @@ -> 模板版本：v0.0.1 +> 模板版本：v0.1.1

@react-navigation/elements

-- Gitee From 025a3bc51029b52285a5da3d686eaad98f0f1c76 Mon Sep 17 00:00:00 2001 From: wang-yuanbai <603970629@qq.com> Date: Sun, 24 Dec 2023 11:35:46 +0800 Subject: [PATCH 6/7] =?UTF-8?q?[Issues:=20#I8QULT]=20=E6=B7=BB=E5=8A=A0VMa?= =?UTF-8?q?ll=E7=89=88=E6=9C=ACreact-native-exception-handler=E6=96=87?= =?UTF-8?q?=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- zh-cn/react-native-exception-handler.md | 1 + 1 file changed, 1 insertion(+) diff --git a/zh-cn/react-native-exception-handler.md b/zh-cn/react-native-exception-handler.md index 10370c01..771d8fab 100644 --- a/zh-cn/react-native-exception-handler.md +++ b/zh-cn/react-native-exception-handler.md @@ -17,6 +17,7 @@ 进入到工程目录并输入以下命令： +#### **yarn** ```bash yarn add @react-native-oh-tpl/react-native-exception-handler -- Gitee From 89b14354bcc19c76b58fa774bb66d98cdac4d9d6 Mon Sep 17 00:00:00 2001 From: wang-yuanbai <603970629@qq.com> Date: Sun, 24 Dec 2023 11:36:30 +0800 Subject: [PATCH 7/7] =?UTF-8?q?[Issues:=20#I8QULT]=20=E6=B7=BB=E5=8A=A0VMa?= =?UTF-8?q?ll=E7=89=88=E6=9C=ACreact-native-exception-handler=E6=96=87?= =?UTF-8?q?=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- zh-cn/react-native-exception-handler.md | 1 + 1 file changed, 1 insertion(+) diff --git a/zh-cn/react-native-exception-handler.md b/zh-cn/react-native-exception-handler.md index 771d8fab..e41e9fcc 100644 --- a/zh-cn/react-native-exception-handler.md +++ b/zh-cn/react-native-exception-handler.md @@ -17,6 +17,7 @@ 进入到工程目录并输入以下命令： + #### **yarn** ```bash -- Gitee