提交 30f9af46 编写于 作者: H HelloCrease

update docs

Signed-off-by: NHelloCrease <lian15@huawei.com>
上级 44937334
# 枚举说明
>**说明:**
>
>本模块首批接口从API version 7开始支持,后续版本的新增接口,采用上角标单独标记接口的起始版本。
## Color
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 颜色名称 | 颜色值 | 颜色示意 |
| ------------------------ | -------- | ------------------------------------------------------------ |
| ------------------------ | ------------- | ---------------------------------------- |
| Black | 0x000000 | ![zh-cn_image_0000001219864153](figures/zh-cn_image_0000001219864153.png) |
| Blue | 0x0000ff | ![zh-cn_image_0000001174104404](figures/zh-cn_image_0000001174104404.png) |
| Brown | 0xa52a2a | ![zh-cn_image_0000001219744201](figures/zh-cn_image_0000001219744201.png) |
......@@ -24,7 +28,7 @@
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| --------- | ------------------------------------------------------------ |
| --------- | ------------------------------- |
| Contain | 保持宽高比进行缩小或者放大,使得图片完全显示在显示边界内。 |
| Cover | 保持宽高比进行缩小或者放大,使得图片两边都大于或等于显示边界。 |
| Auto | 自适应显示 |
......@@ -37,7 +41,7 @@
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| ------ | ----------------------------------------------- |
| ------ | ----------------------------- |
| Dotted | 显示为一系列圆点,圆点半径为borderWidth的一半。 |
| Dashed | 显示为一系列短的方形虚线。 |
| Solid | 显示为一条实线。 |
......@@ -47,7 +51,7 @@
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| ----- | -------------------- |
| ----- | ---------- |
| Bevel | 使用斜角连接路径段。 |
| Miter | 使用尖角连接路径段。 |
| Round | 使用圆角连接路径段。 |
......@@ -55,7 +59,7 @@
## TouchType
| 名称 | 描述 |
| ------ | ------------------------------ |
| ------ | --------------- |
| Down | 手指按下时触发。 |
| Up | 手指抬起时触发。 |
| Move | 手指按压态在屏幕上移动时触发。 |
......@@ -64,7 +68,7 @@
## MouseButton
| 名称 | 描述 |
| ------- | ---------------- |
| ------- | -------- |
| Left | 鼠标左键。 |
| Right | 鼠标右键。 |
| Middle | 鼠标中键。 |
......@@ -75,7 +79,7 @@
## MouseAction
| 名称 | 描述 |
| ------- | -------------- |
| ------- | ------- |
| Press | 鼠标按键按下。 |
| Release | 鼠标按键松开。 |
| Move | 鼠标移动。 |
......@@ -86,7 +90,7 @@
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| ------------------- | ------------------------------------------------------------ |
| ------------------- | ---------------------------------------- |
| Linear | 表示动画从头到尾的速度都是相同的。 |
| Ease | 表示动画以低速开始,然后加快,在结束前变慢,CubicBezier(0.25, 0.1, 0.25, 1.0)。 |
| EaseIn | 表示动画以低速开始,CubicBezier(0.42, 0.0, 1.0, 1.0)。 |
......@@ -106,7 +110,7 @@
从API version 10开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| ------- | ------------------ |
| ------- | --------- |
| Initial | 动画初始状态。 |
| Running | 动画处于播放状态。 |
| Paused | 动画处于暂停状态。 |
......@@ -117,7 +121,7 @@
从API version 10开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| --------- | ------------------------------------------------------------ |
| --------- | ---------------------------------------- |
| None | 动画未执行时不会将任何样式应用于目标,动画播放完成之后恢复初始默认状态。 |
| Forwards | 目标将保留动画执行期间最后一个关键帧的状态。 |
| Backwards | 动画将在应用于目标时立即应用第一个关键帧中定义的值,并在delay期间保留此值。第一个关键帧取决于playMode,playMode为Normal或Alternate时为from的状态,playMode为Reverse或AlternateReverse时为to的状态。 |
......@@ -128,7 +132,7 @@
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| ---------------- | ------------------------------------------------------------ |
| ---------------- | ---------------------------------------- |
| Normal | 动画按正常播放。 |
| Reverse | 动画反向播放。 |
| Alternate | 动画在奇数次(1、3、5...)正向播放,在偶数次(2、4、6...)反向播放。 |
......@@ -137,21 +141,21 @@
## KeyType
| 名称 | 描述 |
| ---- | ---------- |
| ---- | ----- |
| Down | 按键按下。 |
| Up | 按键松开。 |
## KeySource
| 名称 | 描述 |
| -------- | -------------------- |
| -------- | ---------- |
| Unknown | 输入设备类型未知。 |
| Keyboard | 输入设备类型为键盘。 |
## Edge
| 名称 | 描述 |
| -------- | ---------------------- |
| -------------------------------- | ---------------------------------------- |
| Top | 竖直方向上边缘<br/>从API version 9开始,该接口支持在ArkTS卡片中使用。 |
| Center<sup>(deprecated) </sup> | 竖直方向居中位置<br/> 从API version 9开始废弃 |
| Bottom | 竖直方向下边缘<br/>从API version 9开始,该接口支持在ArkTS卡片中使用。 |
......@@ -163,7 +167,7 @@
## Week
| 名称 | 描述 |
| -------- | ---------------------- |
| ---- | ---- |
| Mon | 星期一 |
| Tue | 星期二 |
| Wed | 星期三 |
......@@ -177,7 +181,7 @@
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| ---- | ---------------------- |
| ---- | ----------- |
| Ltr | 元素从左到右布局。 |
| Rtl | 元素从右到左布局。 |
| Auto | 使用系统默认布局方向。 |
......@@ -187,7 +191,7 @@
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| ---- | -------------------------------- |
| ---- | ------------------ |
| Off | 不显示。 |
| On | 常驻显示。 |
| Auto | 按需显示(触摸时显示,2s后消失)。 |
......@@ -197,7 +201,7 @@
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| ------ | ------------------------------------------------------------ |
| ------ | ---------------------------------------- |
| Spring | 弹性物理动效,滑动到边缘后可以根据初始速度或通过触摸事件继续滑动一段距离,松手后回弹。 |
| Fade | 阴影效果,滑动到边缘后会有圆弧状的阴影。 |
| None | 滑动到边缘后无效果。 |
......@@ -207,7 +211,7 @@
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| ----------- | ---------------- |
| ----------- | -------- |
| TopStart | 顶部起始端。 |
| Top | 顶部横向居中。 |
| TopEnd | 顶部尾端。 |
......@@ -223,7 +227,7 @@
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| ------ | -------------------------------------------------- |
| ------ | ------------------------------ |
| All | 指定当前的Transition动效生效在组件的所有变化场景。 |
| Insert | 指定当前的Transition动效生效在组件的插入显示场景。 |
| Delete | 指定当前的Transition动效生效在组件的删除隐藏场景。 |
......@@ -231,7 +235,7 @@
## RelateType
| 名称 | 描述 |
| ------ | ------------------------------- |
| ---- | -------------- |
| FILL | 缩放当前子组件以填充满父组件 |
| FIT | 缩放当前子组件以自适应父组件 |
......@@ -240,7 +244,7 @@
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| ------- | -------------------------------- |
| ------- | ---------------- |
| Hidden | 隐藏,但参与布局进行占位。 |
| Visible | 显示。 |
| None | 隐藏,但不参与布局,不进行占位。 |
......@@ -250,7 +254,7 @@
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| ------ | -------------------- |
| ------ | ----------------------------- |
| Butt | 线条两端为平行线,不额外扩展。 |
| Round | 在线条两端延伸半个圆,直径等于线宽。 |
| Square | 在线条两端延伸一个矩形,宽度等于线宽的一半,高度等于线宽。 |
......@@ -260,7 +264,7 @@
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| ---------- | ------------ |
| ---------- | ------ |
| Vertical | 方向为纵向。 |
| Horizontal | 方向为横向。 |
......@@ -269,7 +273,7 @@
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| ------ | ------------------------ |
| ------ | ------------ |
| Start | 按照语言方向起始端对齐。 |
| Center | 居中对齐,默认对齐方式。 |
| End | 按照语言方向末端对齐。 |
......@@ -279,7 +283,7 @@
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| ------------ | ------------------------------------------------------------ |
| ------------ | ---------------------------------------- |
| Start | 元素在主轴方向首端对齐,第一个元素与行首对齐,同时后续的元素与前一个对齐。 |
| Center | 元素在主轴方向中心对齐,第一个元素与行首的距离与最后一个元素与行尾距离相同。 |
| End | 元素在主轴方向尾部对齐,最后一个元素与行尾对齐,其他元素与后一个对齐。 |
......@@ -292,7 +296,7 @@
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| -------- | ------------------------------------------------------------ |
| -------- | ---------------------------------------- |
| Auto | 使用Flex容器中默认配置。 |
| Start | 元素在Flex容器中,交叉轴方向首部对齐。 |
| Center | 元素在Flex容器中,交叉轴方向居中对齐。 |
......@@ -305,7 +309,7 @@
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| ------------- | ------------------------------ |
| ------------- | ---------------- |
| Row | 主轴与行方向一致作为布局模式。 |
| RowReverse | 与Row方向相反方向进行布局。 |
| Column | 主轴与列方向一致作为布局模式。 |
......@@ -316,7 +320,7 @@
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| ----------- | ------------------------------------------------- |
| ----------- | --------------------------- |
| NoWrap | Flex容器的元素单行/列布局,子项不允许超出容器。 |
| Wrap | Flex容器的元素多行/列排布,子项允许超出容器。 |
| WrapReverse | Flex容器的元素反向多行/列排布,子项允许超出容器。 |
......@@ -326,7 +330,7 @@
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| ------ | ------------------------ |
| ------ | ------------ |
| Top | 顶部对齐。 |
| Center | 居中对齐,默认对齐方式。 |
| Bottom | 底部对齐。 |
......@@ -336,7 +340,7 @@
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| -------- | -------------------------- |
| -------- | ------------- |
| X | 只在水平轴上重复绘制图片。 |
| Y | 只在竖直轴上重复绘制图片。 |
| XY | 在两个轴上重复绘制图片。 |
......@@ -347,7 +351,7 @@
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 类型 | 描述 |
| ------- | ------------------------------------------------------------ |
| ------- | ----------------------------------- |
| Cover | 默认值,保持宽高比进行缩小或者放大,使得图片两边都大于或等于显示边界。 |
| Contain | 保持宽高比进行缩小或者放大,使得图片完全显示在显示边界内。 |
| Auto | 保持原图的比例不变。 |
......@@ -357,7 +361,7 @@
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| ----------- | ---------- |
| ----------- | ----- |
| Left | 从右向左。 |
| Top | 从下向上。 |
| Right | 从左向右。 |
......@@ -371,7 +375,7 @@
## SharedTransitionEffectType
| 名称 | 描述 |
| ----------- | ---------- |
| -------- | ---------------------------------------- |
| Static | 目标页面元素的位置保持不变,可以配置透明度动画。目前,只有为重定向到目标页面而配置的静态效果才会生效。 |
| Exchange | 将源页面元素移动到目标页面元素位置并适当缩放。 |
......@@ -380,7 +384,7 @@
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| ------ | ---------------- |
| ------ | -------- |
| Normal | 标准的字体样式。 |
| Italic | 斜体的字体样式。 |
......@@ -389,7 +393,7 @@
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| ------- | -------------- |
| ------- | ------- |
| Lighter | 字体较细。 |
| Normal | 字体粗细正常。 |
| Regular | 字体粗细正常。 |
......@@ -402,7 +406,7 @@
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| --------------------- | -------------- |
| --------------------- | ------- |
| Start | 水平对齐首部。 |
| Center | 水平居中对齐。 |
| End | 水平对齐尾部。 |
......@@ -413,7 +417,7 @@
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| --------------------- | -------------------------------------- |
| --------------------- | ------------------- |
| None | 文本超长时裁剪显示。 |
| Clip | 文本超长时进行裁剪显示。 |
| Ellipsis | 文本超长时显示不下的文本用省略号代替。 |
......@@ -424,7 +428,7 @@
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| ----------- | ------------------ |
| ----------- | --------- |
| Underline | 文字下划线修饰。 |
| LineThrough | 穿过文本的修饰线。 |
| Overline | 文字上划线修饰。 |
......@@ -435,7 +439,7 @@
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| --------- | -------------------- |
| --------- | ---------- |
| Normal | 保持文本原有大小写。 |
| LowerCase | 文本采用全小写。 |
| UpperCase | 文本采用全大写。 |
......@@ -443,14 +447,14 @@
## ResponseType<sup>8+</sup>
| 名称 | 描述 |
| ---------- | -------------------------- |
| ---------- | ------------- |
| LongPress | 通过长按触发菜单弹出。 |
| RightClick | 通过鼠标右键触发菜单弹出。 |
## HoverEffect<sup>8+</sup>
| 名称 | 描述 |
| --------- | ---------------------------- |
| --------- | -------------- |
| Auto | 使用组件的系统默认悬浮效果。 |
| Scale | 放大缩小效果。 |
| Highlight | 背景淡入淡出的强调效果。 |
......@@ -459,7 +463,7 @@
## Placement<sup>8+</sup>
| 名称 | 描述 |
| ------------- | ------------------------------------------------------------ |
| ------------- | -------------------------------------- |
| Left | 气泡提示位于组件左侧,与组件左侧中心对齐。 |
| Right | 气泡提示位于组件右侧,与组件右侧中心对齐。 |
| Top | 气泡提示位于组件上侧,与组件上侧中心对齐。 |
......@@ -478,7 +482,7 @@
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| ----------- | -------------------- |
| ----------- | -------- |
| None | 不支持复制。 |
| InApp | 支持应用内复制。 |
| LocalDevice | 支持设备内复制。 |
......@@ -486,7 +490,7 @@
## HitTestMode<sup>9+</sup>
| 名称 | 描述 |
| ----------- | -------------------- |
| ----------- | ---------------------------------------- |
| Default | 自身节点和子节点都响应触摸事件的命中测试,但会阻止被该节点屏蔽的其他节点的命中测试。 |
| Block | 自身节点响应触摸事件的命中测试,但阻止被该节点屏蔽的子节点和其他节点的命中测试。 |
| Transparent | 自身节点和子节点响应触摸事件的命中测试,并允许对被该节点屏蔽的其他节点进行命中测试。 |
......@@ -497,7 +501,7 @@
该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| ------- | ---------- |
| -------------------- | --------- |
| Thin | 轻薄材质模糊。 |
| Regular | 普通厚度材质模糊。 |
| Thick | 厚材质模糊。 |
......@@ -509,7 +513,7 @@
## ThemeColorMode<sup>10+</sup>
| 名称 | 描述 |
| ------- | ---------- |
| ------ | ---------- |
| System | 跟随系统深浅色模式。 |
| Light | 固定使用浅色模式。 |
| Dark | 固定使用深色模式。 |
......@@ -517,21 +521,21 @@
## AdaptiveColor<sup>10+</sup>
| 名称 | 描述 |
| ------- | ----------- |
| ------- | ------------------------- |
| Default | 不使用取色模糊。使用默认的颜色作为蒙版颜色。 |
| Average | 使用取色模糊。将取色区域的颜色平均值作为蒙版颜色。 |
## TextHeightAdaptivePolicy<sup>10+</sup>
| 名称 | 描述 |
| ----------------------- | ------------------------------------------------ |
| ----------------------- | ------------------------ |
| MAX_LINES_FIRST | 设置文本高度自适应方式为以MaxLines优先。 |
| MIN_FONT_SIZE_FIRST | 设置文本高度自适应方式为以缩小字体优先。 |
| LAYOUT_CONSTRAINT_FIRST | 设置文本高度自适应方式为以布局约束(高度)优先。 |
## TransitionEdge<sup>10+<sup>
| 名称 | 描述 |
| -------- | -------- |
| ------ | ------ |
| TOP | 窗口的上边缘 |
| BOTTOM | 窗口的下边缘 |
| START | 窗口的左边缘 |
......
......@@ -4,7 +4,7 @@
> **说明:**
>
> 该组件从API version7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
> 该组件从API version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 子组件
......@@ -23,7 +23,7 @@ Progress(options: {value: number, total?: number, type?: ProgressType})
**参数:**
| 参数名 | 参数类型 | 必填 | 参数描述 |
| -------- | -------- | -------- | -------- |
| -------------------------- | ----------------------------------- | ---- | ---------------------------------------- |
| value | number | 是 | 指定当前进度值。设置小于0的数值时置为0,设置大于total的数值时置为total。<br/>从API version 9开始,该接口支持在ArkTS卡片中使用。 |
| total | number | 否 | 指定进度总长。<br/>默认值:100<br/>从API version 9开始,该接口支持在ArkTS卡片中使用。 |
| type<sup>8+</sup> | [ProgressType](#progresstype枚举说明) | 否 | 指定进度条类型。<br/>默认值:ProgressType.Linear<br/>从API version 9开始,该接口支持在ArkTS卡片中使用。 |
......@@ -34,11 +34,11 @@ Progress(options: {value: number, total?: number, type?: ProgressType})
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| -------- | -------- |
| ---------------------- | ---------------------------------------- |
| Linear | 线性样式。从API version9开始,高度大于宽度的时候自适应垂直显示。 |
| Ring<sup>8+</sup> | 环形无刻度样式,环形圆环逐渐显示至完全填充效果。 |
| Eclipse<sup>8+</sup> | 圆形样式,显示类似月圆月缺的进度展示效果,从月牙逐渐变化至满月。|
| ScaleRing<sup>8+</sup> | 环形有刻度样式,显示类似时钟刻度形式的进度展示效果。从API version9开始,刻度外圈出现重叠的时候自动转换为环形无刻度进度条。|
| Eclipse<sup>8+</sup> | 圆形样式,显示类似月圆月缺的进度展示效果,从月牙逐渐变化至满月。 |
| ScaleRing<sup>8+</sup> | 环形有刻度样式,显示类似时钟刻度形式的进度展示效果。从API version9开始,刻度外圈出现重叠的时候自动转换为环形无刻度进度条。 |
| Capsule<sup>8+</sup> | 胶囊样式,头尾两端圆弧处的进度展示效果与Eclipse相同;中段处的进度展示效果与Linear相同。高度大于宽度的时候自适应垂直显示。 |
## ProgressStyle枚举说明
......@@ -46,11 +46,11 @@ Progress(options: {value: number, total?: number, type?: ProgressType})
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 描述 |
| --------- | ------------------------------------------------------------ |
| --------- | ---------------------------------------- |
| Linear | 线性样式。 |
| Ring | 环形无刻度样式,环形圆环逐渐显示至完全填充效果。 |
| Eclipse | 圆形样式,显示类似月圆月缺的进度展示效果,从月牙逐渐变化至满月。|
| ScaleRing | 环形有刻度样式,显示类似时钟刻度形式的进度展示效果。|
| Eclipse | 圆形样式,显示类似月圆月缺的进度展示效果,从月牙逐渐变化至满月。 |
| ScaleRing | 环形有刻度样式,显示类似时钟刻度形式的进度展示效果。 |
| Capsule | 胶囊样式,头尾两端圆弧处的进度展示效果与Eclipse相同;中段处的进度展示效果与Linear相同。高度大于宽度的时候自适应垂直显示。 |
## 属性
......@@ -58,7 +58,7 @@ Progress(options: {value: number, total?: number, type?: ProgressType})
除支持[通用属性](ts-universal-attributes-size.md)外,还支持以下属性:
| 名称 | 参数类型 | 描述 |
| -------- | -------- | -------- |
| ------------------ | ---------------------------------------- | ---------------------------------------- |
| value | number | 设置当前进度值。设置小于0的数值时置为0,设置大于total的数值时置为total。非法数值不生效。<br/>从API version 9开始,该接口支持在ArkTS卡片中使用。 |
| color | [ResourceColor](ts-types.md#resourcecolor) | 设置进度条前景色。<br/>默认值:'\#ff007dff'<br/>从API version 9开始,该接口支持在ArkTS卡片中使用。 |
| backgroundColor | [ResourceColor](ts-types.md#resourcecolor) | 设置进度条底色。<br/>默认值:'\#19182431'<br/><br/>从API version 9开始,该接口支持在ArkTS卡片中使用。 |
......@@ -128,4 +128,4 @@ struct ProgressExample {
}
```
![progress](figures/progress.png)
![progress](figures/arkts-progress.png)
......@@ -4,7 +4,7 @@
> **说明:**
>
> 该组件从API&nbsp;Version&nbsp;9开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
> 该组件从API Version&nbsp;9开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
>
> 本组件为系统接口。
......@@ -30,7 +30,7 @@ AbilityComponent(want: Want)
**参数:**
| 参数名 | 参数类型 | 必填 | 参数描述 |
| -------- | -------- | -------- | -------- |
| ---- | ---------------------------------------- | ---- | --------------- |
| want | [Want](../apis/js-apis-app-ability-want.md) | 是 | 默认加载的Ability描述。 |
......
# 自定义组件的生命周期
自定义组件的生命周期回调函数用于通知用户该自定义组件的生命周期,这些回调函数是私有的,在运行时由开发框架在特定的时间进行调用,不能从应用程序中手动调用这些回调函数。
>**说明:**
>
>允许在生命周期函数中使用Promise和异步回调函数,比如网络资源获取,定时器设置等;
>- 本模块首批接口从API version 7开始支持,后续版本的新增接口,采用上角标单独标记接口的起始版本。
>- 允许在生命周期函数中使用Promise和异步回调函数,比如网络资源获取,定时器设置等。
## aboutToAppear
......@@ -124,7 +123,7 @@ onRecycle?(params: { [key: string]: unknown }): void
**参数:**
| 参数名 | 类型 | 说明 |
| ------ | -------------------------- | -------------------- |
| ------ | -------------------------- | ---------- |
| params | { [key: string]: unknown } | 自定义组件的构造参数 |
......
# 像素单位
为开发者提供4种像素单位,框架采用vp为基准数据单位。
ArkUI为开发者提供4种像素单位,框架采用vp为基准数据单位。
>**说明:**
>
>本模块首批接口从API version 7开始支持,后续版本的新增接口,采用上角标单独标记接口的起始版本。
| 名称 | 描述 |
| ---- | ------------------------------------------------------------ |
| ---- | ---------------------------------------- |
| px | 屏幕物理像素单位。 |
| vp | 屏幕密度相关像素,根据屏幕像素密度转换为屏幕物理像素,当数值不带单位时,默认单位vp。在实际宽度为1440物理像素的屏幕上,1vp约等于3px。 |
| fp | 字体像素,与vp类似适用屏幕密度变化,随系统字体大小设置变化。 |
......@@ -16,7 +20,7 @@
提供其他单位与px单位互相转换的方法。
| 接口 | 描述 |
| --------------------------------------------------- | ------------------------------------------------------------ |
| ---------------------------------------- | ---------------------------------------- |
| vp2px(value&nbsp;:&nbsp;number)&nbsp;:&nbsp;number | 将vp单位的数值转换为以px为单位的数值。<br/>从API version 9开始,该接口支持在ArkTS卡片中使用。 |
| px2vp(value&nbsp;:&nbsp;number)&nbsp;:&nbsp;number | 将px单位的数值转换为以vp为单位的数值。<br/>从API version 9开始,该接口支持在ArkTS卡片中使用。 |
| fp2px(value&nbsp;:&nbsp;number)&nbsp;:&nbsp;number | 将fp单位的数值转换为以px为单位的数值。<br/>从API version 9开始,该接口支持在ArkTS卡片中使用。 |
......
# 类型定义
>**说明:**
>
>本模块首批接口从API version 7开始支持,后续版本的新增接口,采用上角标单独标记接口的起始版本。
## Resource
资源引用类型,用于设置组件属性的值。
......@@ -25,7 +29,7 @@
长度类型,用于描述尺寸单位。
| 类型 | 说明 |
| -------- | -------------------------------------- |
| --------------------- | -------------------------------------- |
| string | 需要显式指定像素单位,如'10px',也可设置百分比字符串,如'100%'。 |
| number | 默认单位vp。 |
| [Resource](#resource) | 资源引用类型,引入系统资源或者应用资源中的尺寸。 |
......@@ -35,7 +39,7 @@
字符串类型,用于描述字符串入参可以使用的类型。
| 类型 | 说明 |
| -------- | ---------------------------- |
| --------------------- | ------------------------- |
| string | 字符串类型。 |
| [Resource](#resource) | 资源引用类型,引入系统资源或者应用资源中的字符串。 |
......@@ -44,7 +48,7 @@
内边距类型,用于描述组件不同方向的内边距。
| 名称 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | --------------- |
| ------ | ----------------- | ---- | -------------------- |
| top | [Length](#length) | 否 | 上内边距,组件内元素距组件顶部的尺寸。 |
| right | [Length](#length) | 否 | 右内边距,组件内元素距组件右边界的尺寸。 |
| bottom | [Length](#length) | 否 | 下内边距,组件内元素距组件底部的尺寸。 |
......@@ -55,7 +59,7 @@
外边距类型,用于描述组件不同方向的外边距。
| 名称 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | --------------- |
| ------ | ----------------- | ---- | -------------------- |
| top | [Length](#length) | 否 | 上外边距,组件顶部距组件外元素的尺寸。 |
| right | [Length](#length) | 否 | 右外边距,组件右边界距组件外元素的尺寸。 |
| bottom | [Length](#length) | 否 | 下外边距,组件底部距组件外元素的尺寸。 |
......@@ -66,7 +70,7 @@
边框宽度类型,用于描述组件边框不同方向的宽度。
| 名称 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | -------- |
| ------ | ----------------- | ---- | -------- |
| top | [Length](#length) | 否 | 组件上边框宽度。 |
| right | [Length](#length) | 否 | 组件右边框宽度。 |
| bottom | [Length](#length) | 否 | 组件下边框宽度。 |
......@@ -77,7 +81,7 @@
圆角类型,用于描述组件边框圆角半径。
| 名称 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | ---------- |
| ----------- | ----------------- | ---- | ---------- |
| topLeft | [Length](#length) | 否 | 组件左上角圆角半径。 |
| topRight | [Length](#length) | 否 | 组件右上角圆角半径。 |
| bottomLeft | [Length](#length) | 否 | 组件左下角圆角半径。 |
......@@ -88,7 +92,7 @@
边框颜色,用于描述组件边框四条边的颜色。
| 名称 | 类型 | 必填 | 说明 |
| ------ | ------------- | ---- | -------- |
| ------ | ------------------------------- | ---- | -------- |
| top | [ResourceColor](#resourcecolor) | 否 | 组件上边框颜色。 |
| right | [ResourceColor](#resourcecolor) | 否 | 组件右边框颜色。 |
| bottom | [ResourceColor](#resourcecolor) | 否 | 组件下边框颜色。 |
......@@ -99,7 +103,7 @@
边框样式,用于描述组件边框四条边的样式。
| 名称 | 类型 | 必填 | 说明 |
| ------ | ----------- | ---- | -------- |
| ------ | ---------------------------------------- | ---- | -------- |
| top | [BorderStyle](ts-appendix-enums.md#borderstyle) | 否 | 组件上边框样式。 |
| right | [BorderStyle](ts-appendix-enums.md#borderstyle) | 否 | 组件右边框样式。 |
| bottom | [BorderStyle](ts-appendix-enums.md#borderstyle) | 否 | 组件下边框样式。 |
......@@ -111,7 +115,7 @@
相对布局完成位置坐标偏移量。
| 名称 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | -------- |
| ---- | ----------------- | ---- | -------- |
| dx | [Length](#length) | 是 | 水平方向偏移量。 |
| dy | [Length](#length) | 是 | 竖直方向偏移量。 |
......@@ -120,7 +124,7 @@
颜色类型,用于描述资源颜色类型。
| 类型 | 说明 |
| ---------------------------------------- | ------------------------------------------------- |
| ----------------------------------- | ---------------------------------------- |
| [Color](ts-appendix-enums.md#color) | 颜色枚举值。 |
| number | HEX格式颜色,支持rgb。示例:0xffffff。 |
| string | rgb或者argb格式颜色。示例:'#ffffff', '#ff000000', 'rgb(255, 100, 255)', 'rgba(255, 100, 255, 0.5)'。 |
......@@ -131,15 +135,15 @@
智能取色枚举类型,用于设置前景色。
| 名称 | 描述 |
| --------- | ------- |
| INVERT | 设置前景色为控件背景色的反色。|
| ------ | --------------- |
| INVERT | 设置前景色为控件背景色的反色。 |
## LengthConstrain
长度约束,用于对组件最大、最小长度做限制。
| 名称 | 类型 | 必填 | 说明 |
| --------- | ------ | ---- | ------- |
| --------- | ----------------- | ---- | ------- |
| minLength | [Length](#length) | 是 | 组件最小长度。 |
| maxLength | [Length](#length) | 是 | 组件最大长度。 |
......@@ -149,7 +153,7 @@
设置文本样式。
| 名称 | 类型 | 必填 | 说明 |
| ------ | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| ------ | ---------------------------------------- | ---- | ---------------------------------------- |
| size | [Length](#length) | 否 | 设置文本尺寸,Length为number类型时,使用fp单位。不支持设置百分比字符串。 |
| weight | [FontWeight](ts-appendix-enums.md#fontweight) \| number \| string | 否 | 设置文本的字体粗细,number类型取值[100, 900],取值间隔为100,默认为400,取值越大,字体越粗。 |
| family | string \| [Resource](#resource) | 否 | 设置文本的字体列表。使用多个字体,使用','进行分割,优先级按顺序生效。例如:'Arial, sans-serif'。当前只支持'sans-serif'字体。 |
......@@ -171,7 +175,7 @@
位置类型,用于表示一个坐标点。
| 名称 | 类型 | 必填 | 说明 |
| ---- | ------ | ---- | --------------------------- |
| ---- | ----------------- | ---- | --------------------------- |
| x | [Length](#length) | 否 | x轴坐标,作为返回值时,类型为number,单位vp。 |
| y | [Length](#length) | 否 | y轴坐标,作为返回值时,类型为number,单位vp。 |
......@@ -180,7 +184,7 @@
设置约束尺寸,组件布局时,进行尺寸范围限制。
| 名称 | 类型 | 必填 | 说明 |
| --------- | ------ | ---- | ------- |
| --------- | ----------------- | ---- | ------- |
| minWidth | [Length](#length) | 否 | 元素最小宽度。 |
| maxWidth | [Length](#length) | 否 | 元素最大宽度。 |
| minHeight | [Length](#length) | 否 | 元素最小高度。 |
......@@ -191,7 +195,7 @@
设置宽高尺寸。
| 名称 | 类型 | 必填 | 说明 |
| ------ | ------ | ---- | ----- |
| ------ | ----------------- | ---- | ----- |
| width | [Length](#length) | 否 | 元素宽度。 |
| height | [Length](#length) | 否 | 元素高度。 |
......@@ -229,7 +233,7 @@
像素扩展属性集合,用于描述像素扩展的信息。
| 名称 | 类型 | 必填 | 说明 |
| ----------- | ------ | ---- | ---------- |
| ------ | ----------------- | ---- | -------------- |
| left | [Length](#length) | 否 | 组件图像左边沿扩展距离。 |
| right | [Length](#length) | 否 | 组件图像右边沿像素扩展距离。 |
| top | [Length](#length) | 否 | 组件图像上边沿像素扩展距离。 |
......@@ -240,7 +244,7 @@
全屏模态转场方式枚举类型,用于设置全屏模态转场类型。
| 名称 | 描述 |
| --------- | ------- |
| ------- | ------------ |
| None | 全屏模态无转场动画。 |
| Default | 全屏模态上下切换动画。 |
| Alpha | 全屏模态透明度渐变动画。 |
\ No newline at end of file
Markdown is supported
0% .
You are about to add 0 people to the discussion. Proceed with caution.
先完成此消息的编辑!
想要评论请 注册