已开启
docs: upgrade README to v0.4.2 template for br_rnoh0.77 #6
docs: upgrade README to v0.4.2 template for br_rnoh0.77 #6
已开启
fangzhen创建于 9月16日
fangzhen
fangzhen成员
9月16日

变更类型

请在对应类型(请勿多选)前打 √,仅可选择一项:

变更内容

  • 简要描述本次变更的具体内容、解决的问题;
  • 若为破坏性变更,请详细说明:
    • 影响范围(哪些 API/配置/功能被修改);
    • 用户适配方案(旧版→新版的替换步骤)

测试步骤

测试情况

合入前自检

likedislike
合并受阻
openharmony_ci
openharmony_ci成员
9月16日 评论:

感谢提交 Pull Requests!
Thanks for submitting a pull request.

likedislike
openharmony_ciopenharmony_ci成员
9月16日 添加了label:dco检查成功
fangzhenfangzhen成员
13 天前 推送  1 个提交:e2c69e5e-docs: fix scrollIndicatorInsets platform column and link issue#179
openharmony_ci
openharmony_ci成员
13 天前 评论:

感谢提交 Pull Requests!
Thanks for submitting a pull request.

likedislike
cpf-manager
cpf-manager13 天前进行代码检视1
README.md
@@ -14,0 +347,4 @@
347+ scrollIndicatorInsets={{ top: 1, left: 1, bottom: 1, right: 1 }}
348+ autoThrottle={100}
349+ autoThrottleDuration={500}
350+ areaOverlapRatio={0.5}
cpf-manager
cpf-manager13 天前评论:

【AI-Review】【一般】【基础代码问题】【代码逻辑错误】
● 问题: README.md 第350行示例代码使用 areaOverlapRatio={0.5},但同一文档第477行明确声明该属性"必须大于 0.5"。源码 lib/AnySizeDragSortableView.js:527 注释亦标注 areaOverlapRatio: 0.55, // Must be greater than 0.5,0.5 不满足"大于 0.5"的约束。

● 影响: 用户照搬示例代码会传入违反文档约束的值(0.5),与文档声明的"必须大于 0.5"产生矛盾,导致用户困惑。此外,areaOverlapRatio 作为拖拽结束判定区域重合比例的阈值(lib/AnySizeDragSortableView.js:304 if (overlapArea < minArea * areaOverlapRatio || !overlapArea) continue;),使用 0.5 临界值可能导致拖拽判定在边界处反复触发,影响交互稳定性。

● 建议: 将示例中的 areaOverlapRatio={0.5} 修改为默认值 0.55 或其他大于 0.5 的值,使示例与文档约束和源码默认值保持一致。

likedislike
cpf-manager
cpf-manager13 天前进行代码检视1
README.md
@@ -9,1 +11,3 @@
9-- [English](https://gitcode.com/CPF-RN/usage-docs/blob/master/en/react-native-drag-sort.md)
11+| 三方库名称 | 三方库版本(npm地址) | 发布信息 | 支持RN版本 | Autolink | 编译API版本 | 社区基线版本 | 源码地址 |
12+| --- | --- | --- | --- | --- | --- | --- | --- |
13+| @react-native-ohos/react-native-drag-sort | [~2.5.1-beta.2(开发中)](https://www.npmjs.com/package/@react-native-ohos/react-native-drag-sort) | [GitCode Releases](https://gitcode.com/CPF-RN/react-native-drag-sort/releases) | 0.77.* | 否 | API12+ | 2.4.4 | [br_rnoh0.77](https://gitcode.com/CPF-RN/react-native-drag-sort/tree/br_rnoh0.77) |
cpf-manager
cpf-manager13 天前评论:

【AI-Review】【一般】【基础代码问题】【常量问题】
● 问题: README.md 第13行版本表声明三方库版本为 ~2.5.1-beta.2(开发中),但 lib/package.json 中 "version": "2.5.1-beta.3",两者版本号不一致(beta.2 vs beta.3)。

● 影响: 用户根据 README 获取的版本信息(beta.2)与实际安装的 package.json 版本(beta.3)不符,在版本对照、问题排查和依赖锁定时产生误导。

● 建议: 将 README 中的版本号更新为 2.5.1-beta.3(或 ~2.5.1-beta.3),与 lib/package.json 的实际 version 字段保持一致。

likedislike
cpf-manager
cpf-manager13 天前进行代码检视1
README.md
@@ -14,0 +407,4 @@
407+ 
408+| 名称 | 参数类型 | 必填 | 平台 | OpenHarmony平台支持 | 描述 |
409+| --- | --- | --- | --- | --- | --- |
410+| DragSortableView | [IProps](#iprops) | yes | iOS/Android | Yes | 子项宽高固定的拖拽排序组件,不支持滑动 |
cpf-manager
cpf-manager13 天前评论:

【AI-Review】【一般】【基础代码问题】【可读性问题】
● 问题: README.md 第410-412行组件表中使用锚点链接 [IProps](#iprops)、[AutoIProps](#autoiprops)、[AnySizeIProps](#anysizeiprops),但这些链接指向的目标(第416行"IProps(DragSortableView 属性)"、第445行"AutoIProps(AutoDragSortableView 属性,包含 IProps 的全部属性)"、第459行"AnySizeIProps(AnySizeDragSortableView 属性)")均为普通文本而非 Markdown 标题(缺少 #/##/### 前缀),无法生成对应锚点 #iprops/#autoiprops/#anysizeiprops。

● 影响: 用户点击组件表中的 IProps/AutoIProps/AnySizeIProps 链接时无法跳转到对应属性说明章节,影响文档导航体验。

● 建议: 将第416、445、459行的属性小节标题改为 Markdown 标题格式(如 ### IProps(DragSortableView 属性)),使锚点 #iprops、#autoiprops、#anysizeiprops 能正确生成并跳转。

likedislike
cpf-manager
cpf-manager13 天前进行代码检视1
README_en.md
@@ -0,0 +347,4 @@
347+ scrollIndicatorInsets={{ top: 1, left: 1, bottom: 1, right: 1 }}
348+ autoThrottle={100}
349+ autoThrottleDuration={500}
350+ areaOverlapRatio={0.5}
cpf-manager
cpf-manager13 天前评论:

【AI-Review】【一般】【基础代码问题】【代码逻辑错误】
● 问题: README_en.md 第350行示例代码使用 areaOverlapRatio={0.5},但同一文档第477行明确声明该属性"must be greater than 0.5"(必须大于 0.5)。源码 lib/AnySizeDragSortableView.js:527 注释亦标注 areaOverlapRatio: 0.55, // Must be greater than 0.5,0.5 不满足"大于 0.5"的约束。

● 影响: 用户照搬示例代码会传入违反文档约束的值(0.5),与文档声明的"must be greater than 0.5"产生矛盾。此外,areaOverlapRatio 作为拖拽结束判定区域重合比例的阈值(lib/AnySizeDragSortableView.js:304 if (overlapArea < minArea * areaOverlapRatio || !overlapArea) continue;),使用 0.5 临界值可能导致拖拽判定在边界处反复触发,影响交互稳定性。

● 建议: 将示例中的 areaOverlapRatio={0.5} 修改为默认值 0.55 或其他大于 0.5 的值,使示例与文档约束和源码默认值保持一致。

likedislike
cpf-manager
cpf-manager13 天前进行代码检视1
README_en.md
@@ -0,0 +10,4 @@
10+ 
11+| Name | Version(Npm Address) | Release Information | Supported RN Version | Supported Autolink | Compile API Version | Community Baseline Version | Source code address |
12+| --- | --- | --- | --- | --- | --- | --- | --- |
13+| @react-native-ohos/react-native-drag-sort | [~2.5.1-beta.2 (In development)](https://www.npmjs.com/package/@react-native-ohos/react-native-drag-sort) | [GitCode Releases](https://gitcode.com/CPF-RN/react-native-drag-sort/releases) | 0.77.* | No | API12+ | 2.4.4 | [br_rnoh0.77](https://gitcode.com/CPF-RN/react-native-drag-sort/tree/br_rnoh0.77) |
cpf-manager
cpf-manager13 天前评论:

【AI-Review】【一般】【基础代码问题】【常量问题】
● 问题: README_en.md 第13行版本表声明三方库版本为 ~2.5.1-beta.2 (In development),但 lib/package.json 中 "version": "2.5.1-beta.3",两者版本号不一致(beta.2 vs beta.3)。

● 影响: 用户根据 README 获取的版本信息(beta.2)与实际安装的 package.json 版本(beta.3)不符,在版本对照、问题排查和依赖锁定时产生误导。

● 建议: 将 README 中的版本号更新为 2.5.1-beta.3(或 ~2.5.1-beta.3),与 lib/package.json 的实际 version 字段保持一致。

likedislike
cpf-manager
cpf-manager13 天前进行代码检视1
README_en.md
@@ -0,0 +407,4 @@
407+ 
408+| Name | Parameter Type | Required | Platform | OpenHarmony Platform Support | Description |
409+| --- | --- | --- | --- | --- | --- |
410+| DragSortableView | [IProps](#iprops) | yes | iOS/Android | Yes | Drag and drop sorting component with fixed item width and height, without sliding |
cpf-manager
cpf-manager13 天前评论:

【AI-Review】【一般】【基础代码问题】【可读性问题】
● 问题: README_en.md 第410-412行组件表中使用锚点链接 [IProps](#iprops)、[AutoIProps](#autoiprops)、[AnySizeIProps](#anysizeiprops),但这些链接指向的目标(第416行"IProps (DragSortableView properties)"、第445行"AutoIProps (AutoDragSortableView properties, including all IProps properties)"、第459行"AnySizeIProps (AnySizeDragSortableView properties)")均为普通文本而非 Markdown 标题(缺少 #/##/### 前缀),无法生成对应锚点 #iprops/#autoiprops/#anysizeiprops。

● 影响: 用户点击组件表中的 IProps/AutoIProps/AnySizeIProps 链接时无法跳转到对应属性说明章节,影响文档导航体验。

● 建议: 将第416、445、459行的属性小节标题改为 Markdown 标题格式(如 ### IProps (DragSortableView properties)),使锚点 #iprops、#autoiprops、#anysizeiprops 能正确生成并跳转。

likedislike