From 7f45f668db86b00f784aa2054076a7df2c546353 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=9D=9C=E5=BA=86=E6=B3=89?= Date: Sat, 28 Oct 2023 18:20:44 +0800 Subject: [PATCH] Update uts-component.md --- docs/plugin/uts-component.md | 23 +++++++++++++++++++++++ 1 file changed, 23 insertions(+) diff --git a/docs/plugin/uts-component.md b/docs/plugin/uts-component.md index 47ef84f71..d2bc4d5d0 100644 --- a/docs/plugin/uts-component.md +++ b/docs/plugin/uts-component.md @@ -1528,3 +1528,26 @@ Lottie动画示例,对应的源码实现:~/uni_modules/uts-animation-view ``` 如果不通过style 指定组件宽高,会导致组件不显示 + + +#### 2 UTS-Android 插件涉及的像素单位说明: rpx,px,dpx + +|单位|说明|使用场景| +|----|---|---| +|逻辑像素 px |逻辑像素 对应到 android中的 dp| 组件使用者 在页面css中使用 举例:`width:480px` | +|物理像素 px |真实的设备像素,与dp 直接的换算关系是 dp * 屏幕密度 = 物理像素 px| android 原生api 传入和返回的单位均为物理像素,比如 设置layoutParam 参数,获取View宽高等 | +|rpx |屏幕宽度固定750单位前提下的逻辑像素| 组件使用者 在页面css中使用 举例:`width:750rpx`,可以使用UTSAndroid.rpx2px() 函数进行rpx 和 逻辑像素 px的转换| + + + +为了让组件使用者的有更好的体验,UTS 插件 应该以 **逻辑像素 px** 作为标准的像素单位: + ++ 1 内置的UTS插件/组件,涉及对外交互时会自动进行单位转换,抹平相关差异。比如 `swiper`等组件监听滑动距离等场景 + ++ 2 建议 插件开发者的插件在设计对外像素单位时也进行单位的转换,以逻辑像素px 作为输出结果 + + + + + + -- GitLab