From a6f6e475852a4f01287943f223b3f85fef9f4199 Mon Sep 17 00:00:00 2001 From: qu_weifan Date: Mon, 2 Mar 2026 13:46:43 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E4=BF=AE=E6=94=B9lottie-react-native?= =?UTF-8?q?=E7=9A=84=E4=B8=AD=E8=8B=B1=E6=96=87=E6=8C=87=E5=AF=BC=E6=96=87?= =?UTF-8?q?=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: qu_weifan --- en/lottie-react-native.md | 3 ++- zh-cn/lottie-react-native.md | 11 ++++++----- 2 files changed, 8 insertions(+), 6 deletions(-) diff --git a/en/lottie-react-native.md b/en/lottie-react-native.md index 6ef74919..2bb3128a 100644 --- a/en/lottie-react-native.md +++ b/en/lottie-react-native.md @@ -292,7 +292,7 @@ rawfile path: `entry/src/main/resources/rawfile` | autoPlay | A boolean flag indicating whether or not the animation should start automatically when mounted. This only affects the imperative API. | boolean | false | No | All | Yes | | resizeMode | Determines how to resize the animated view when the frame doesn't match the raw image dimensions. Supports cover, contain and center. | 'cover'\| 'contain' \| 'center' | contain | No | iOS, Android, Windows | Yes | | style | Style attributes for the view, as expected in a standard View, aside from border styling | StyleProp | None | No | iOS, Android, Windows | Yes | -| containerStyle | Style attributes for the outermost container view, as expected in a standard View. Useful for layout and positioning. | StyleProp | None | No | iOS, Android, VisionOS | Yes | +| containerStyle7.3.0+ | Style attributes for the outermost container view, as expected in a standard View. Useful for layout and positioning. | StyleProp | None | No | iOS, Android, VisionOS | Yes | | webStyle | Style attributes for the view, it uses CSSProperties. | CSSProperties | None | No | Web | No | | imageAssetsFolder | Needed for Android and HarmonyOS to work properly with assets, iOS will ignore it. | string | None | No | Android | Yes | | useNativeLooping | Only Windows. When enabled, uses platform-level looping to improve smoothness, but onAnimationLoop will not fire and changing the loop prop will reset playback rather than finishing gracefully. | boolean | false | No | Windows | No | @@ -324,6 +324,7 @@ rawfile path: `entry/src/main/resources/rawfile` ## 6. Known Issues - [ ] Some interfaces of the original library do not have corresponding properties and interface handling logic in HarmonyOS: [issue#18](https://github.com/react-native-oh-library/lottie-react-native/issues/18) +- [ ] There is no logic for handling the `isCancelled` parameter received by the `onAnimationFinish` callback function when calling the `play()` or `reset()` functions.: [issue#27](https://gitcode.com/openharmony-sig/rntpc_lottie-react-native/issues/27) ## 7. Others diff --git a/zh-cn/lottie-react-native.md b/zh-cn/lottie-react-native.md index 5693fbb4..059d01bc 100644 --- a/zh-cn/lottie-react-native.md +++ b/zh-cn/lottie-react-native.md @@ -251,10 +251,10 @@ ohpm install 本文档内容基于以下版本验证通过： -1.RNOH: 0.72.96; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.858; ROM: 6.0.0.112; -2.RNOH: 0.72.33; SDK: HarmonyOS NEXT B1; IDE: DevEco Studio: 5.0.3.900; ROM: Next.0.0.71; -3.RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.858; ROM: 6.0.0.112; -4.RNOH: 0.82.1; SDK: HarmonyOS 6.0.1 Release SDK; IDE: DevEco Studio 6.0.1 Release; ROM:6.0.0.120 SP7 +1. RNOH: 0.72.96; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.858; ROM: 6.0.0.112; +2. RNOH: 0.72.33; SDK: HarmonyOS NEXT B1; IDE: DevEco Studio: 5.0.3.900; ROM: Next.0.0.71; +3. RNOH: 0.77.18; SDK: HarmonyOS 6.0.0 Release SDK; IDE: DevEco Studio 6.0.0.858; ROM: 6.0.0.112; +4. RNOH: 0.82.1; SDK: HarmonyOS 6.0.1 Release SDK; IDE: DevEco Studio 6.0.1 Release; ROM:6.0.0.120 SP7; ### 3.2. 权限要求 @@ -290,7 +290,7 @@ rawfile 路径：`entry/src/main/resources/rawfile` | autoPlay | A boolean flag indicating whether or not the animation should start automatically when mounted. This only affects the imperative API. | boolean | false | No | All | Yes | | resizeMode | Determines how to resize the animated view when the frame doesn't match the raw image dimensions. Supports cover, contain and center. | 'cover'\| 'contain' \| 'center' | contain | No | iOS, Android, Windows | Yes | | style | Style attributes for the view, as expected in a standard View, aside from border styling | StyleProp | None | No | iOS, Android, Windows | Yes | -| containerStyle | Style attributes for the outermost container view, as expected in a standard View. Useful for layout and positioning. | StyleProp | None | No | iOS, Android, VisionOS | Yes | +| containerStyle7.3.0+ | Style attributes for the outermost container view, as expected in a standard View. Useful for layout and positioning. | StyleProp | None | No | iOS, Android, VisionOS | Yes | | webStyle | Style attributes for the view, it uses CSSProperties. | CSSProperties | None | No | Web | No | | imageAssetsFolder | Needed for Android and HarmonyOS to work properly with assets, iOS will ignore it. | string | None | No | Android | Yes | | useNativeLooping | Only Windows. When enabled, uses platform-level looping to improve smoothness, but onAnimationLoop will not fire and changing the loop prop will reset playback rather than finishing gracefully. | boolean | false | No | Windows | No | @@ -322,6 +322,7 @@ rawfile 路径：`entry/src/main/resources/rawfile` ## 6. 遗留问题 - [ ] 原库部分接口在 HarmonyOS 中没有对应属性及接口处理相关逻辑，问题: [issue#18](https://github.com/react-native-oh-library/lottie-react-native/issues/18) +- [ ] 调用 play() 或 reset() 函数时没有对onAnimationFinish回调函数接收参数isCancelled处理相关逻辑，问题: [issue#27](https://gitcode.com/openharmony-sig/rntpc_lottie-react-native/issues/27) ## 7. 其他 -- Gitee