@expo-harmony/expo-linear-gradient 55.0.14-harmony.2 → 55.0.14-harmony.3

package/README.md

@@ -1,8 +1,8 @@
 # @expo-harmony/expo-linear-gradient
 
-[**GitHub 仓库**](https://github.com/renbaoshuo/expo-harmony/tree/master/packages/expo-linear-gradient)
+[**GitHub 仓库**](https://github.com/renbaoshuo/expo-harmony/tree/master/packages/expo-linear-gradient) | [官方文档](https://docs.expo.dev/versions/v55.0.0/sdk/linear-gradient/)
 
-为 HarmonyOS 上的 React Native 应用提供 Expo LinearGradient 的原生实现，与官方同版本的 `expo-linear-gradient` 配套使用。支持多色线性渐变、自定义颜色位置和渐变起止点、圆角裁剪，以及在渐变背景上叠加子组件。
+为 HarmonyOS 上的 React Native 应用提供 Expo LinearGradient 的原生实现，与官方同版本的 `expo-linear-gradient` 配套使用。
 
 ## 安装
 
@@ -10,11 +10,61 @@
 npm install @expo-harmony/expo-linear-gradient expo-linear-gradient@55.0.14
 ```
 
-渐变由 ArkUI Canvas 绘制，`dither` 属性在 HarmonyOS 上不生效。
+## API 对照表
+
+### Component
+
+#### `LinearGradient`
+
+线性渐变视图组件。渐变铺满视图，子组件叠加在渐变之上。渐变层不接收触摸事件，触摸会落到子组件上。
+
+`style` 上的 `borderRadius` 和各角圆角属性用于裁剪渐变。
+
+#### `colors`
+
+类型：`readonly [ColorValue, ColorValue, ...ColorValue[]]`
+
+渐变的颜色序列，按顺序参与渲染。至少需要两个颜色，少于两个时忽略该次更新。
+
+#### `locations`
+
+类型：`readonly [number, number, ...number[]] | null`，默认 `null`
+
+每个颜色在渐变轴上的位置，取值 0 到 1，数量与 `colors` 一致。不传时颜色均匀分布。位置必须从小到大排列，取相同值可以得到硬过渡。数量对不上、取值越界或顺序不对时，忽略该次更新，保留上一次的渐变。
+
+#### `start`
+
+类型：`LinearGradientPoint | null`，默认 `{ x: 0.5, y: 0 }`
+
+渐变起点，`x`、`y` 是相对视图宽高的比例，可以写成 `{ x, y }` 或 `[x, y]`。取值可以超出 0 到 1，渐变轴延伸到视图之外。
+
+#### `end`
+
+类型：`LinearGradientPoint | null`，默认 `{ x: 0.5, y: 1 }`
+
+渐变终点，写法与 `start` 相同。
+
+> **未实现的内容**
+>
+> - `dither`：Android 专属属性，用于控制渐变渲染的抖动，HarmonyOS 上不生效。
+
+### Types
+
+#### `LinearGradientPoint`
+
+渐变端点，`{ x: number; y: number }` 或 `[x: number, y: number]`。
+
+#### `NativeLinearGradientPoint`
+
+渐变端点的数组形式，`[x: number, y: number]`。
+
+#### `LinearGradientProps`
+
+`LinearGradient` 的属性类型，在 `ViewProps` 之上增加 `colors`、`locations`、`start`、`end` 和 Android 专属的 `dither`。
 
 ## Author
 
 **expo-harmony** © [Baoshuo](https://github.com/renbaoshuo), Released under the MIT License.<br>
 Authored and maintained by Baoshuo with help from [contributors](https://github.com/renbaoshuo/expo-harmony/contributors).
 
-> [Personal Website](https://baoshuo.ren) · [Blog](https://blog.baoshuo.ren) · GitHub [@renbaoshuo](https://github.com/renbaoshuo) · Twitter [@baoshuo](https://twitter.com/baoshuo)
+> [Personal Website](https://baoshuo.ren) · [Blog](https://blog.baoshuo.ren) · GitHub [@renbaoshuo](https://github.com/renbaoshuo) · Twitter [@renbaoshuo](https://twitter.com/renbaoshuo)

package/harmony/library/oh-package.json5

@@ -1,6 +1,6 @@
 {
   "name": "@expo-harmony/expo-linear-gradient",
-  "version": "55.0.14-harmony.2",
+  "version": "55.0.14-harmony.3",
   "description": "HarmonyOS port of expo-linear-gradient",
   "keywords": [
     "react-native",
@@ -18,6 +18,6 @@
   "main": "Index.ets",
   "license": "MIT",
   "dependencies": {
-    "@expo-harmony/expo-modules-core": "55.0.25-harmony.2"
+    "@expo-harmony/expo-modules-core": "55.0.25-harmony.3"
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@expo-harmony/expo-linear-gradient",
-  "version": "55.0.14-harmony.2",
+  "version": "55.0.14-harmony.3",
   "description": "HarmonyOS port of expo-linear-gradient",
   "keywords": [
     "react-native",
@@ -27,12 +27,12 @@
     "typecheck": "tsc --noEmit -p tsconfig.json"
   },
   "peerDependencies": {
-    "@expo-harmony/expo-modules-core": "55.0.25-harmony.2",
+    "@expo-harmony/expo-modules-core": "55.0.25-harmony.3",
     "expo-linear-gradient": "55.0.14"
   },
   "devDependencies": {
-    "@expo-harmony/expo-module-scripts": "55.0.0-harmony.2",
-    "@expo-harmony/expo-modules-core": "55.0.25-harmony.2",
+    "@expo-harmony/expo-module-scripts": "55.0.0-harmony.3",
+    "@expo-harmony/expo-modules-core": "55.0.25-harmony.3",
     "@react-native-oh/react-native-harmony": "0.84.1",
     "@types/react": "19.2.2",
     "expo": "55.0.26",