diff --git a/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001174104404.png b/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001174104404.png new file mode 100644 index 0000000000000000000000000000000000000000..e370a44cf043fc34bd8891f57faad2cd2ca05707 Binary files /dev/null and b/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001174104404.png differ diff --git a/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001174264376.png b/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001174264376.png new file mode 100644 index 0000000000000000000000000000000000000000..dfcb0c5e259b3f8d7375c21712249c1e847edd67 Binary files /dev/null and b/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001174264376.png differ diff --git a/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001174422914.png b/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001174422914.png new file mode 100644 index 0000000000000000000000000000000000000000..bc28f5056c679e189543c8ad6fba67fb56db7655 Binary files /dev/null and b/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001174422914.png differ diff --git a/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001174582864.png b/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001174582864.png new file mode 100644 index 0000000000000000000000000000000000000000..b54dbc2391d1a8f16312dd02dc3d65a35ea2626f Binary files /dev/null and b/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001174582864.png differ diff --git a/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001174582866.png b/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001174582866.png new file mode 100644 index 0000000000000000000000000000000000000000..56d32d4cd371c5374b133cb81c9c077aaf7b110d Binary files /dev/null and b/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001174582866.png differ diff --git a/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001219662661.png b/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001219662661.png new file mode 100644 index 0000000000000000000000000000000000000000..9c43caf5fdfd466eafc37b793f509a6bde2b885d Binary files /dev/null and b/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001219662661.png differ diff --git a/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001219662663.png b/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001219662663.png new file mode 100644 index 0000000000000000000000000000000000000000..5c5e360f249a2002ba68ad9b94bd7f66f5d6aab1 Binary files /dev/null and b/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001219662663.png differ diff --git a/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001219662665.png b/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001219662665.png new file mode 100644 index 0000000000000000000000000000000000000000..309d1c46f8bc396df5eaed381a5ffa2f0389d602 Binary files /dev/null and b/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001219662665.png differ diff --git a/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001219744201.png b/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001219744201.png new file mode 100644 index 0000000000000000000000000000000000000000..0d22570503febc7a7dcba0d1e870f49f32fe489a Binary files /dev/null and b/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001219744201.png differ diff --git a/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001219864153.png b/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001219864153.png new file mode 100644 index 0000000000000000000000000000000000000000..58293d5e874f2aa36ecaf7282ca9e4736318092f Binary files /dev/null and b/zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001219864153.png differ diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-animatorproperty.md b/zh-cn/application-dev/reference/arkui-ts/ts-animatorproperty.md index a26ae2ca83d8601aebda814956a77c08e3b11cad..2372325ad9b0c0631aec9b003d353f14d749b6e7 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-animatorproperty.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-animatorproperty.md @@ -17,28 +17,10 @@ | 名称 | 参数类型 | 默认值 | 描述 | | ---------- | ---------------------------------------- | --------------- | ----------------------- | | duration | number | 1000 | 单位为毫秒，默认动画时长为1000毫秒。 | -| curve | Curve | Curve.Linear | 默认曲线为线性。 | +| curve | [Curve](ts-appendix-enums.md#curve) | Curve.Linear | 默认曲线为线性。 | | delay | number | 0 | 单位为毫秒，默认不延时播放。 | | iterations | number | 1 | 默认播放一次，设置为-1时表示无限次播放。 | -| playMode | [PlayMode](ts-appendix-enums.md#playmode枚举值说明) | PlayMode.Normal | 设置动画播放模式，默认播放完成后重头开始播放。 | - - -- Curve枚举说明 - | 名称 | 描述 | - | ------------------- | ---------------------------------------- | - | Linear | 表示动画从头到尾的速度都是相同的。 | - | Ease | 表示动画以低速开始，然后加快，在结束前变慢，CubicBezier(0.25, 0.1, 0.25, 1.0)。 | - | EaseIn | 表示动画以低速开始，CubicBezier(0.42, 0.0, 1.0, 1.0)。 | - | EaseOut | 表示动画以低速结束，CubicBezier(0.0, 0.0, 0.58, 1.0)。 | - | EaseInOut | 表示动画以低速开始和结束，CubicBezier(0.42, 0.0, 0.58, 1.0)。 | - | FastOutSlowIn | 标准曲线，cubic-bezier(0.4, 0.0, 0.2, 1.0)。 | - | LinearOutSlowIn | 减速曲线，cubic-bezier(0.0, 0.0, 0.2, 1.0)。 | - | FastOutLinearIn | 加速曲线，cubic-bezier(0.4, 0.0, 1.0, 1.0)。 | - | ExtremeDeceleration | 急缓曲线，cubic-bezier(0.0, 0.0, 0.0, 1.0)。 | - | Sharp | 锐利曲线，cubic-bezier(0.33, 0.0, 0.67, 1.0)。 | - | Rhythm | 节奏曲线，cubic-bezier(0.7, 0.0, 0.2, 1.0)。 | - | Smooth | 平滑曲线，cubic-bezier(0.4, 0.0, 0.4, 1.0)。 | - | Friction | 阻尼曲线，CubicBezier(0.2, 0.0, 0.2, 1.0)。 | +| playMode | [PlayMode](ts-appendix-enums.md#playmode) | PlayMode.Normal | 设置动画播放模式，默认播放完成后重头开始播放。 | ## 示例 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-appendix-enums.md b/zh-cn/application-dev/reference/arkui-ts/ts-appendix-enums.md index 597427749af2c3b2e81f4a0981b067b036ca72ce..edb8e2f69b526540d0e6a95be7981eda7071161f 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-appendix-enums.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-appendix-enums.md @@ -1,100 +1,424 @@ # 文档中涉及到的内置枚举值 -## Alignment枚举说明 +## Color -| 名称 | 描述 | -| -------- | -------- | -| TopStart | 顶部起始端。 | -| Top | 顶部横向居中。 | -| TopEnd | 顶部尾端。 | -| Start | 起始端纵向居中。 | -| Center | 横向和纵向居中。 | -| End | 尾端纵向居中。 | -| BottomStart | 底部起始端。 | -| Bottom | 底部横向居中。 | -| BottomEnd | 底部尾端。 | +| 颜色名称 | 颜色值 | 颜色示意 | +| ------------------------ | -------- | ------------------------------------------------------------ | +| 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) | +| Gray | 0x808080 | ![zh-cn_image_0000001174264376](figures/zh-cn_image_0000001174264376.png) | +| Green | 0x008000 | ![zh-cn_image_0000001174422914](figures/zh-cn_image_0000001174422914.png) | +| Orange | 0xffa500 | ![zh-cn_image_0000001219662661](figures/zh-cn_image_0000001219662661.png) | +| Pink | 0xffc0cb | ![zh-cn_image_0000001219662663](figures/zh-cn_image_0000001219662663.png) | +| Red | 0xff0000 | ![zh-cn_image_0000001219662665](figures/zh-cn_image_0000001219662665.png) | +| White | 0xffffff | ![zh-cn_image_0000001174582866](figures/zh-cn_image_0000001174582866.png) | +| Yellow | 0xffff00 | ![zh-cn_image_0000001174582864](figures/zh-cn_image_0000001174582864.png) | +| Transparent9+ | rgba(0,0,0,0) | 透明色 | +## ImageFit -## Axis枚举说明 +| 名称 | 描述 | +| --------- | ------------------------------------------------------------ | +| Contain | 保持宽高比进行缩小或者放大，使得图片完全显示在显示边界内。 | +| Cover | 保持宽高比进行缩小或者放大，使得图片两边都大于或等于显示边界。 | +| Auto | 自适应显示 | +| Fill | 不保持宽高比进行放大缩小，使得图片充满显示边界。 | +| ScaleDown | 保持宽高比显示，图片缩小或者保持不变。 | +| None | 保持原有尺寸显示。 | -| 名称 | 描述 | -| -------- | -------- | -| Vertical | 方向为纵向。 | -| Horizontal | 方向为横向。 | +## BorderStyle +| 名称 | 描述 | +| ------ | ----------------------------------------------- | +| Dotted | 显示为一系列圆点，圆点半径为borderWidth的一半。 | +| Dashed | 显示为一系列短的方形虚线。 | +| Solid | 显示为一条实线。 | -## ItemAlign枚举说明 +## LineJoinStyle -| 名称 | 描述 | -| -------- | -------- | -| Auto | 使用Flex容器中默认配置。 | -| Start | 元素在Flex容器中，交叉轴方向首部对齐。 | -| Center | 元素在Flex容器中，交叉轴方向居中对齐。 | -| End | 元素在Flex容器中，交叉轴方向底部对齐。 | -| Stretch | 元素在Flex容器中，交叉轴方向拉伸填充，在未设置尺寸时，拉伸到容器尺寸。 | -| Baseline | 元素在Flex容器中，交叉轴方向文本基线对齐。 | +| 名称 | 描述 | +| ----- | -------------------- | +| Bevel | 使用斜角连接路径段。 | +| Miter | 使用尖角连接路径段。 | +| Round | 使用圆角连接路径段。 | +## TouchType -## LineCapStyle枚举说明 +| 名称 | 描述 | +| ------ | ------------------------------ | +| Down | 手指按下时触发。 | +| Up | 手指抬起时触发。 | +| Move | 手指按压态在屏幕上移动时触发。 | +| Cancel | 触摸事件取消时触发。 | -| 名称 | 描述 | -| -------- | -------- | -| Butt | 分割线两端为平行线。 | -| Round | 分割线两端为半圆。 | -| Square | 分割线两端为平行线。 | +## MouseButton +| 名称 | 描述 | +| ------- | ---------------- | +| Left | 鼠标左键。 | +| Right | 鼠标右键。 | +| Middle | 鼠标中键。 | +| Back | 鼠标左侧后退键。 | +| Forward | 鼠标左侧前进键。 | +| None | 无按键。 | -## PlayMode枚举值说明 +## MouseAction -| 名称 | 描述 | -| -------- | -------- | -| Normal | 动画按正常播放。 | -| Reverse | 动画反向播放。 | -| Alternate | 动画在奇数次（1、3、5...）正向播放，在偶数次（2、4、6...）反向播放。 | -| AlternateReverse | 动画在奇数次（1、3、5...）反向播放，在偶数次（2、4、6...）正向播放。 | +| 名称 | 描述 | +| ------- | -------------- | +| Press | 鼠标按键按下。 | +| Release | 鼠标按键松开。 | +| Move | 鼠标移动。 | +## Curve -## ImageRepeat枚举说明 +| 名称 | 描述 | +| ------------------- | ------------------------------------------------------------ | +| Linear | 表示动画从头到尾的速度都是相同的。 | +| Ease | 表示动画以低速开始，然后加快，在结束前变慢，CubicBezier(0.25, 0.1, 0.25, 1.0)。 | +| EaseIn | 表示动画以低速开始，CubicBezier(0.42, 0.0, 1.0, 1.0)。 | +| EaseOut | 表示动画以低速结束，CubicBezier(0.0, 0.0, 0.58, 1.0)。 | +| EaseInOut | 表示动画以低速开始和结束，CubicBezier(0.42, 0.0, 0.58, 1.0)。 | +| FastOutSlowIn | 标准曲线，cubic-bezier(0.4, 0.0, 0.2, 1.0)。 | +| LinearOutSlowIn | 减速曲线，cubic-bezier(0.0, 0.0, 0.2, 1.0)。 | +| FastOutLinearIn | 加速曲线，cubic-bezier(0.4, 0.0, 1.0, 1.0)。 | +| ExtremeDeceleration | 急缓曲线，cubic-bezier(0.0, 0.0, 0.0, 1.0)。 | +| Sharp | 锐利曲线，cubic-bezier(0.33, 0.0, 0.67, 1.0)。 | +| Rhythm | 节奏曲线，cubic-bezier(0.7, 0.0, 0.2, 1.0)。 | +| Smooth | 平滑曲线，cubic-bezier(0.4, 0.0, 0.4, 1.0)。 | +| Friction | 阻尼曲线，CubicBezier(0.2, 0.0, 0.2, 1.0)。 | -| 名称 | 描述 | -| -------- | -------- | -| X | 只在水平轴上重复绘制图片。 | -| Y | 只在竖直轴上重复绘制图片。 | -| XY | 在两个轴上重复绘制图片。 | -| NoRepeat | 不重复绘制图片。 | +## AnimationStatus +| 名称 | 描述 | +| ------- | ------------------ | +| Initial | 动画初始状态。 | +| Running | 动画处于播放状态。 | +| Paused | 动画处于暂停状态。 | +| Stopped | 动画处于停止状态。 | -## TextDecorationType枚举说明 +## FillMode -| 名称 | 描述 | -| -------- | -------- | -| Underline | 文字下划线修饰。 | -| LineThrough | 穿过文本的修饰线。 | -| Overline | 文字上划线修饰。 | -| None | 不使用文本装饰线。 | +| 名称 | 描述 | +| -------- | -------------------------------- | +| None | 播放完成后恢复初始状态。 | +| Forwards | 播放完成后保持动画结束时的状态。 | +## PlayMode -## TextCase枚举说明 +| 名称 | 描述 | +| ---------------- | ------------------------------------------------------------ | +| Normal | 动画按正常播放。 | +| Reverse | 动画反向播放。 | +| Alternate | 动画在奇数次（1、3、5...）正向播放，在偶数次（2、4、6...）反向播放。 | +| AlternateReverse | 动画在奇数次（1、3、5...）反向播放，在偶数次（2、4、6...）正向播放。 | -| 名称 | 描述 | -| -------- | -------- | -| Normal | 保持文本原有大小写。 | -| LowerCase | 文本采用全小写。 | -| UpperCase | 文本采用全大写。 | +## KeyType +| 名称 | 描述 | +| ---- | ---------- | +| Down | 按键按下。 | +| Up | 按键松开。 | -## BarState枚举说明 +## KeySource -| 名称 | 描述 | -| -------- | -------- | -| Off | 不显示。 | -| On | 常驻显示。 | -| Auto | 按需显示(触摸时显示，2s后消失)。 | -## LayoutDirection枚举说明 +| 名称 | 描述 | +| -------- | -------------------- | +| Unknown | 输入设备类型未知。 | +| Keyboard | 输入设备类型为键盘。 | -| 名称 | 描述 | -| -------- | -------- | -| Row | 主轴与行方向一致作为布局模式。 | -| Column | 主轴与列方向一致作为布局模式。 | -| RowReverse | 与Row相反方向进行布局。 | -| ColumnReverse | 与Column相反方向进行布局。 | \ No newline at end of file +## Edge + +| 名称 | 描述 | +| -------- | ---------------------- | +| Top | 竖直方向上边缘 | +| Center | 竖直方向居中位置 | +| Bottom | 竖直方向下边缘 | +| Baseline | 交叉轴方向文本基线位置 | +| Start | 水平方向起始位置 | +| Middle | 水平方向居中位置 | +| End | 水平方向末尾位置 | + +## Week + +| 名称 | 描述 | +| -------- | ---------------------- | +| Mon | 星期一 | +| Tue | 星期二 | +| Wed | 星期三 | +| Thur | 星期四 | +| Fri | 星期五 | +| Sat | 星期六 | +| Sun | 星期日 | + +## Direction + +| 名称 | 描述 | +| ---- | ---------------------- | +| Ltr | 元素从左到右布局。 | +| Rtl | 元素从右到左布局。 | +| Auto | 使用系统默认布局方向。 | + +## BarState + +| 名称 | 描述 | +| ---- | -------------------------------- | +| Off | 不显示。 | +| On | 常驻显示。 | +| Auto | 按需显示(触摸时显示，2s后消失)。 | + +## EdgeEffect + +| 名称 | 描述 | +| ------ | ------------------------------------------------------------ | +| Spring | 弹性物理动效，滑动到边缘后可以根据初始速度或通过触摸事件继续滑动一段距离，松手后回弹。 | +| Fade | 阴影效果，滑动到边缘后会有圆弧状的阴影。 | +| None | 滑动到边缘后无效果。 | + +## Alignment + +| 名称 | 描述 | +| ----------- | ---------------- | +| TopStart | 顶部起始端。 | +| Top | 顶部横向居中。 | +| TopEnd | 顶部尾端。 | +| Start | 起始端纵向居中。 | +| Center | 横向和纵向居中。 | +| End | 尾端纵向居中。 | +| BottomStart | 底部起始端。 | +| Bottom | 底部横向居中。 | +| BottomEnd | 底部尾端。 | + +## TransitionType + +| 名称 | 描述 | +| ------ | -------------------------------------------------- | +| All | 指定当前的Transition动效生效在组件的所有变化场景。 | +| Insert | 指定当前的Transition动效生效在组件的插入场景。 | +| Delete | 指定当前的Transition动效生效在组件的删除场景。 | + +## RelateType + +| 名称 | 描述 | +| ------ | ------------------------------- | +| FILL | 缩放当前子组件以填充满父组件 | +| FIT | 缩放当前子组件以自适应父组件 | + +## Visibility + +| 名称 | 描述 | +| ------- | -------------------------------- | +| Hidden | 隐藏，但参与布局进行占位。 | +| Visible | 显示。 | +| None | 隐藏，但不参与布局，不进行占位。 | + +## LineCapStyle + +| 名称 | 描述 | +| ------ | -------------------- | +| Butt | 分割线两端为平行线。 | +| Round | 分割线两端为半圆。 | +| Square | 分割线两端为平行线。 | + +## Axis + +| 名称 | 描述 | +| ---------- | ------------ | +| Vertical | 方向为纵向。 | +| Horizontal | 方向为横向。 | + +## HorizontalAlign + +| 名称 | 描述 | +| ------ | ------------------------ | +| Start | 按照语言方向起始端对齐。 | +| Center | 居中对齐，默认对齐方式。 | +| End | 按照语言方向末端对齐。 | + +## FlexAlign + +| 名称 | 描述 | +| ------------ | ------------------------------------------------------------ | +| Start | 元素在主轴方向首端对齐，第一个元素与行首对齐，同时后续的元素与前一个对齐。 | +| Center | 元素在主轴方向中心对齐，第一个元素与行首的距离与最后一个元素与行尾距离相同。 | +| End | 元素在主轴方向尾部对齐，最后一个元素与行尾对齐，其他元素与后一个对齐。 | +| SpaceBetween | Flex主轴方向均匀分配弹性元素，相邻元素之间距离相同。第一个元素与行首对齐，最后一个元素与行尾对齐。 | +| SpaceAround | Flex主轴方向均匀分配弹性元素，相邻元素之间距离相同。第一个元素到行首的距离和最后一个元素到行尾的距离是相邻元素之间距离的一半。 | +| SpaceEvenly | 距、第一个元素与行首的间距、最后一个元素到行尾的间距都完全一样。 | + +## ItemAlign + +| 名称 | 描述 | +| -------- | ------------------------------------------------------------ | +| Auto | 使用Flex容器中默认配置。 | +| Start | 元素在Flex容器中，交叉轴方向首部对齐。 | +| Center | 元素在Flex容器中，交叉轴方向居中对齐。 | +| End | 元素在Flex容器中，交叉轴方向底部对齐。 | +| Stretch | 元素在Flex容器中，交叉轴方向拉伸填充，在未设置尺寸时，拉伸到容器尺寸。 | +| Baseline | 元素在Flex容器中，交叉轴方向文本基线对齐。 | + +## FlexDirection + +| 名称 | 描述 | +| ------------- | ------------------------------ | +| Row | 主轴与行方向一致作为布局模式。 | +| RowReverse | 与Row方向相反方向进行布局。 | +| Column | 主轴与列方向一致作为布局模式。 | +| ColumnReverse | 与Column相反方向进行布局。 | + +## FlexWrap + +| 名称 | 描述 | +| ----------- | ------------------------------------------------- | +| NoWrap | Flex容器的元素单行/列布局，子项不允许超出容器。 | +| Wrap | Flex容器的元素多行/列排布，子项允许超出容器。 | +| WrapReverse | Flex容器的元素反向多行/列排布，子项允许超出容器。 | + +## VerticalAlign + +| 名称 | 描述 | +| ------ | ------------------------ | +| Top | 顶部对齐。 | +| Center | 居中对齐，默认对齐方式。 | +| Bottom | 底部对齐。 | + +## ImageRepeat + +| 名称 | 描述 | +| -------- | -------------------------- | +| X | 只在水平轴上重复绘制图片。 | +| Y | 只在竖直轴上重复绘制图片。 | +| XY | 在两个轴上重复绘制图片。 | +| NoRepeat | 不重复绘制图片。 | + +## ImageSize + +| 类型 | 描述 | +| ------- | ------------------------------------------------------------ | +| Cover | 默认值，保持宽高比进行缩小或者放大，使得图片两边都大于或等于显示边界。 | +| Contain | 保持宽高比进行缩小或者放大，使得图片完全显示在显示边界内。 | +| Auto | 保持原图的比例不变。 | + +## GradientDirection + +| 名称 | 描述 | +| ----------- | ---------- | +| Left | 从右向左。 | +| Top | 从下向上。 | +| Right | 从左向右。 | +| Bottom | 从上向下。 | +| LeftTop | 左上。 | +| LeftBottom | 左下。 | +| RightTop | 右上。 | +| RightBottom | 右下。 | +| None | 无。 | + +## SharedTransitionEffectType + +| 名称 | 描述 | +| ----------- | ---------- | +| Static | 目标页面元素的位置保持不变，可以配置透明度动画。目前，只有为重定向到目标页面而配置的静态效果才会生效。 | +| Exchange | 将源页面元素移动到目标页面元素位置并适当缩放。 | + +## FontStyle + +| 名称 | 描述 | +| ------ | ---------------- | +| Normal | 标准的字体样式。 | +| Italic | 斜体的字体样式。 | + +## FontWeight + +| 名称 | 描述 | +| ------- | -------------- | +| Lighter | 字体较细。 | +| Normal | 字体粗细正常。 | +| Regular | 字体粗细正常。 | +| Medium | 字体粗细适中。 | +| Bold | 字体较粗。 | +| Bolder | 字体非常粗。 | + +## TextAlign + +| 名称 | 描述 | +| ------ | -------------- | +| Start | 水平对齐首部。 | +| Center | 水平居中对齐。 | +| End | 水平对齐尾部。 | + +## TextOverflow + +| 名称 | 描述 | +| -------- | -------------------------------------- | +| Clip | 文本超长时进行裁剪显示。 | +| Ellipsis | 文本超长时显示不下的文本用省略号代替。 | +| None | 文本超长时不进行裁剪。 | + +## TextDecorationType + +| 名称 | 描述 | +| ----------- | ------------------ | +| Underline | 文字下划线修饰。 | +| LineThrough | 穿过文本的修饰线。 | +| Overline | 文字上划线修饰。 | +| None | 不使用文本装饰线。 | + +## TextCase + +| 名称 | 描述 | +| --------- | -------------------- | +| Normal | 保持文本原有大小写。 | +| LowerCase | 文本采用全小写。 | +| UpperCase | 文本采用全大写。 | + +## ResponseType8+ + +| 名称 | 描述 | +| ---------- | -------------------------- | +| LongPress | 通过长按触发菜单弹出。 | +| RightClick | 通过鼠标右键触发菜单弹出。 | + +## HoverEffect8+ + +| 名称 | 描述 | +| --------- | ---------------------------- | +| Auto | 使用组件的系统默认悬浮效果。 | +| Scale | 放大缩小效果。 | +| Highlight | 背景淡入淡出的强调效果。 | +| None | 不设置效果。 | + +## Placement8+ + +| 名称 | 描述 | +| ------------- | ------------------------------------------------------------ | +| Left | 气泡提示位于组件左侧，与组件左侧中心对齐。 | +| Right | 气泡提示位于组件右侧，与组件右侧中心对齐。 | +| Top | 气泡提示位于组件上侧，与组件上侧中心对齐。 | +| Bottom | 气泡提示位于组件下侧，与组件下侧中心对齐。 | +| TopLeft | 气泡提示位于组件上侧，从API Version 9开始，与组件左侧边缘对齐。 | +| TopRight | 气泡提示位于组件上侧，从API Version 9开始，与组件右侧边缘对齐。 | +| BottomLeft | 气泡提示位于组件下侧，从API Version 9开始，与组件左侧边缘对齐。 | +| BottomRight | 气泡提示位于组件下侧，从API Version 9开始，与组件右侧边缘对齐。 | +| LeftTop9+ | 气泡提示位于组件左侧，与组件上侧边缘对齐。 | +| LeftBottom9+ | 气泡提示位于组件左侧，与组件下侧边缘对齐。 | +| RightTop9+ | 气泡提示位于组件右侧，与组件上侧边缘对齐。 | +| RightBottom9+ | 气泡提示位于组件右侧，与组件下侧边缘对齐。 | + +## CopyOptions9+ + +| 名称 | 描述 | +| ----------- | -------------------- | +| None | 不支持复制粘贴。 | +| InApp | 支持应用内复制粘贴。 | +| LocalDevice | 支持设备内复制粘贴。 | +| CrossDevice | 支持跨设备复制粘贴。 | + +## HitTestMode9+ + +| 名称 | 描述 | +| ----------- | -------------------- | +| Default | 自身节点和子节点都响应触摸事件的命中测试，但会阻止被该节点屏蔽的其他节点的命中测试。 | +| Block | 自身节点响应触摸事件的命中测试，但阻止被该节点屏蔽的子节点和其他节点的命中测试。 | +| Transparent | 自身节点和子节点响应触摸事件的命中测试，并允许对被该节点屏蔽的其他节点进行命中测试。 | +| None | 自身节点不会响应触摸事件的命中测试，但子节点会对触摸事件进行命中测试。 | diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-image.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-image.md index 716cbd5594504b2c28128932591def28157c084f..e944bf0850fc0920fb6261a680e848adeb52ebfa 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-image.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-image.md @@ -45,23 +45,13 @@ Image(src: string | PixelMap | Resource) | 名称 | 参数类型 | 默认值 | 描述 | | --------------------- | ------------------------------------------------------- | ------------------------ | ------------------------------------------------------------ | | alt | string \| [Resource](../../ui/ts-types.md#resource类型) | - | 加载时显示的占位图，支持本地图片和网络图片。 | -| objectFit | ImageFit | ImageFit.Cover | 设置图片的缩放类型。 | +| objectFit | [ImageFit](ts-appendix-enums.md#imagefit) | ImageFit.Cover | 设置图片的缩放类型。 | | objectRepeat | [ImageRepeat](ts-appendix-enums.md#imagerepeat) | NoRepeat | 设置图片的重复样式。
> **说明：**
> - svg类型图源不支持该属性。 | | interpolation | [ImageInterpolation](#imageinterpolation) | ImageInterpolation.None | 设置图片的插值效果，即减轻低清晰度图片在放大显示的时候出现的锯齿问题，仅针对图片放大插值。
> **说明：**
> - svg类型图源不支持该属性。
> - PixelMap资源不支持该属性。 | | renderMode | [ImageRenderMode](#imagerendermode) | ImageRenderMode.Original | 设置图片渲染的模式。
> **说明：**
> - svg类型图源不支持该属性。 | | sourceSize | {
width: number,
height: number
} | - | 设置图片裁剪尺寸，将原始图片解码成pixelMap，指定尺寸的图片，单位为px。
> **说明：**
> PixelMap资源不支持该属性。 | | syncLoad8+ | boolean | false | 设置是否同步加载图片，默认是异步加载。同步加载时阻塞UI线程，不会显示占位图。 | -| copyOption9+ | [CopyOptions](#copyoptions) | CopyOptions.None | 设置图片是否可复制（SVG图片不支持复制）。 | - -### ImageFit - -| 名称 | 描述 | -| --------- | ------------------------------------------------------------ | -| Cover | 保持宽高比进行缩小或者放大，使得图片两边都大于或等于显示边界。 | -| Contain | 保持宽高比进行缩小或者放大，使得图片完全显示在显示边界内。 | -| Fill | 不保持宽高比进行放大缩小，使得图片充满显示边界。 | -| None | 保持原有尺寸显示。 | -| ScaleDown | 保持宽高比显示，图片缩小或者保持不变。 | +| copyOption9+ | [CopyOptions](ts-appendix-enums.md#copyoptions9) | CopyOptions.None | 设置图片是否可复制（SVG图片不支持复制）。 | ### ImageInterpolation @@ -79,14 +69,6 @@ Image(src: string | PixelMap | Resource) | Original | 按照原图进行渲染，包括颜色。 | | Template | 将图片渲染为模板图片，忽略图片的颜色信息。 | -### CopyOptions9+ - - | 名称 | 描述 | - | -------- | -------- | - | None | 不支持复制粘贴。 | - | InApp | 支持应用内复制粘贴。 | - | LocalDevice | 支持设备内复制粘贴。 | - | CrossDevice | 支持跨设备复制粘贴。 | ## 事件 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-imageanimator.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-imageanimator.md index 2ffdfd684cc62b2fac3587f0cba53e98f137001b..992a91c73ebc5ad4c4058c374ca731d50a6fda97 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-imageanimator.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-imageanimator.md @@ -27,12 +27,12 @@ ImageAnimator() | 参数名称 | 参数类型 | 默认值 | 必填 | 参数描述 | | -------- | -------- | -------- | -------- | -------- | | images | Array<ImageFrameInfo> | [] | 是 | 设置图片帧信息集合。每一帧的帧信息(ImageFrameInfo)包含图片路径、图片大小、图片位置和图片播放时长信息，详见ImageFrameInfo属性说明。 | -| state | AnimationStatus | Initial | 否 | 默认为初始状态，用于控制播放状态。 | +| state | [AnimationStatus](ts-appendix-enums.md#animationstatus) | Initial | 否 | 默认为初始状态，用于控制播放状态。 | | duration | number | 1000 | 否 | 单位为毫秒，默认时长为1000ms；duration为0时，不播放图片；值的改变只会在下一次循环开始时生效；当images中任意一帧图片设置了单独的duration后，该属性设置无效。 | | reverse | boolean | false | 否 | 设置播放顺序。false表示从第1张图片播放到最后1张图片； true表示从最后1张图片播放到第1张图片。 | | fixedSize | boolean | true | 否 | 设置图片大小是否固定为组件大小。 true表示图片大小与组件大小一致，此时设置图片的width 、height 、top 和left属性是无效的。false表示每一张图片的width 、height 、top和left属性都要单独设置。 | | preDecode | number | 0 | 否 | 是否启用预解码，默认值为0，即不启用预解码，如该值设为2，则播放当前页时会提前加载后面两张图片至缓存以提升性能。 | -| fillMode | FillMode | Forwards | 否 | 设置动画开始前和结束后的状态，可选值参见FillMode说明。 | +| fillMode | [FillMode](ts-appendix-enums.md#fillmode) | Forwards | 否 | 设置动画开始前和结束后的状态，可选值参见FillMode说明。 | | iterations | number | 1 | 否 | 默认播放一次，设置为-1时表示无限次播放。 | - ImageFrameInfo属性说明 @@ -45,20 +45,6 @@ ImageAnimator() | left | [Length](../../ui/ts-types.md#长度类型) | 0 | 否 | 图片相对于组件左上角的横向坐标 | | duration | number | 0 | 否 | 每一帧图片的播放时长，单位毫秒 | -- AnimationStatus枚举说明 - | 名称 | 描述 | - | -------- | -------- | - | Initial | 动画初始状态。 | - | Running | 动画处于播放状态。 | - | Paused | 动画处于暂停状态。 | - | Stopped | 动画处于停止状态。 | - -- FillMode枚举值说明 - | 名称 | 描述 | - | -------- | -------- | - | None | 播放完成后恢复初始状态。 | - | Forwards | 播放完成后保持动画结束时的状态。 | - ## 事件 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-scrollbar.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-scrollbar.md index ed84c4fa91492933c5ce29f02d8e77fe02e699f7..7f389c6b596969ee99aa45d999e15de7d7732e17 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-scrollbar.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-scrollbar.md @@ -26,7 +26,7 @@ ScrollBar(value: ScrollBarOptions) | -------- | -------- | -------- | -------- | -------- | | scroller | [Scroller](ts-container-scroll.md#scroller) | 是 | - | 可滚动组件的控制器。用于与可滚动组件进行绑定。 | | direction | ScrollBarDirection | 否 | ScrollBarDirection.Vertical | 滚动条的方向，控制可滚动组件对应方向的滚动。 | - | state | BarState | 否 | BarState.Auto | 滚动条状态。 | + | state | [BarState](ts-appendix-enums.md#barstate) | 否 | BarState.Auto | 滚动条状态。 | > **说明：** > ScrollBar组件负责定义可滚动区域的行为样式，ScrollBar的子节点负责定义滚动条的行为样式。 @@ -37,14 +37,7 @@ ScrollBar(value: ScrollBarOptions) | 名称 | 描述 | | -------- | -------- | | Vertical | 纵向滚动条。 | - | Horizontal | 横向滚动条。 | - -- BarState枚举说明 - | 名称 | 描述 | - | -------- | -------- | - | On | 常驻显示。 | - | Off | 不显示。 | - | Auto | 按需显示(触摸时显示，无操作2s后消失)。 | + | Horizontal | 横向滚动条。 | ## 示例 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-text.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-text.md index c916b4f8af89ae9baa5885fbdfa59983438fa2dd..d16a8db00031db071f89da3223ea6cb757db0277 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-text.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-text.md @@ -30,54 +30,15 @@ Text(content?: string) | 名称 | 参数类型 | 默认值 | 描述 | | -------- | -------- | -------- | -------- | -| textAlign | TextAlign | TextAlign.Start | 设置多行文本的文本对齐方式。 | -| textOverflow | {overflow: TextOverflow} | {overflow: TextOverflow.Clip} | 设置文本超长时的显示方式。
**说明：**
文本截断是按字截断。例如，英文以单词为最小单位进行截断，若需要以字母为单位进行截断，可在字母间添加零宽空格：\u200B。
需配合`maxLines`使用，单独设置不生效。 | +| textAlign | [TextAlign](ts-appendix-enums.md#textalign) | TextAlign.Start | 设置多行文本的文本对齐方式。 | +| textOverflow | {overflow: [TextOverflow](ts-appendix-enums.md#textoverflow)} | {overflow: TextOverflow.Clip} | 设置文本超长时的显示方式。
**说明：**
文本截断是按字截断。例如，英文以单词为最小单位进行截断，若需要以字母为单位进行截断，可在字母间添加零宽空格：\u200B。
需配合`maxLines`使用，单独设置不生效。 | | maxLines | number | Infinity | 设置文本的最大行数。
**说明：**
默认情况下，文本是自动折行的，如果指定此参数，则文本最多不会超过指定的行。如果有多余的文本，可以通过 `textOverflow`来指定截断方式。 | | lineHeight | Length | - | 设置文本的文本行高，设置值不大于0时，不限制文本行高，自适应字体大小，Length为number类型时单位为fp。 | -| decoration | {
type: TextDecorationType,
color?: Color
} | {
type: TextDecorationType.None,
color: Color.Black
} | 设置文本装饰线样式及其颜色。 | +| decoration | {
type: [TextDecorationType](ts-appendix-enums.md#textdecorationtype),
color?: Color
} | {
type: TextDecorationType.None,
color: Color.Black
} | 设置文本装饰线样式及其颜色。 | | baselineOffset | Length | - | 设置文本基线的偏移量。 | -| textCase | TextCase | TextCase.Normal | 设置文本大小写。 | -| copyOption9+ | CopyOptions | CopyOptions.None | 组件支持设置文本是否可复制粘贴。 | - -- TextAlign枚举说明 - | 名称 | 描述 | - | -------- | -------- | - | Center | 文本居中对齐。 | - | Start | 根据文字书写相同的方向对齐。 | - | End | 根据文字书写相反的方向对齐。 | - -- TextOverflow枚举说明 - | 名称 | 描述 | - | -------- | -------- | - | Clip | 文本超长时进行裁剪显示。 | - | Ellipsis | 文本超长时显示不下的文本用省略号代替。 | - | None | 文本超长时不进行裁剪。 | - -- TextDecorationType枚举说明 - | 名称 | 描述 | - | -------- | -------- | - | Underline | 文字下划线修饰。 | - | LineThrough | 穿过文本的修饰线。 | - | Overline | 文字上划线修饰。 | - | None | 不使用文本装饰线。 | - -- TextCase枚举说明 +| textCase | [TextCase](ts-appendix-enums.md#textcase) | TextCase.Normal | 设置文本大小写。 | +| copyOption9+ | [CopyOptions](ts-appendix-enums.md#copyoptions9) | CopyOptions.None | 组件支持设置文本是否可复制粘贴。 | - | 名称 | 描述 | - | --------- | -------------------- | - | Normal | 保持文本原有大小写。 | - | LowerCase | 文本采用全小写。 | - | UpperCase | 文本采用全大写。 | - -- CopyOptions9+枚举说明 - - | 名称 | 描述 | - | -------- | -------- | - | None | 不支持复制粘贴。 | - | InApp | 支持应用内复制粘贴。 | - | LocalDevice | 支持设备内复制粘贴。 | - | CrossDevice | 支持跨设备复制粘贴。 | - > **说明：** > 不支持Text内同时存在文本内容和Span子组件。如果同时存在，只显示Span内的内容。 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textarea.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textarea.md index 28ea0cc9288f91c9ae26a6d54a595c7c69d84634..31b4d591397ecdb675ed1b4773e7a4afe7b81a10 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textarea.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textarea.md @@ -36,18 +36,11 @@ TextArea(value?:{placeholder?: string| Resource, text?: string| Resource, contro | ------------------------ | ---------------------------------------- | ----- | ---------------------------------------- | | placeholderColor | Color | - | 设置placeholder文本颜色。 | | placeholderFont | {
size?: number,
weight?:number \| [FontWeight](ts-universal-attributes-text-style.md)，
family?: string,
style?: [FontStyle](ts-universal-attributes-text-style.md)
} | - | 设置placeholder文本样式：
- size: 设置文本尺寸，Length为number类型时，使用fp单位。
- weight: 设置文本的字体粗细，number类型取值[100, 900]，取值间隔为100，默认为400，取值越大，字体越粗。
- family: 设置文本的字体列表。使用多个字体，使用','进行分割，优先级按顺序生效，例如：'Arial, sans-serif'。
- style: 设置文本的字体样式。 | -| textAlign | TextAlign | Start | 设置文本水平对齐方式。 | +| textAlign | [TextAlign](ts-appendix-enums.md#textalign) | Start | 设置文本水平对齐式。 | | caretColor | Color | - | 设置输入框光标颜色。 | | inputFilter8+ | {
value: [ResourceStr](../../ui/ts-types.md)8+,
error?: (value: string)
} | - | 通过正则表达式设置输入过滤器。满足表达式的输入允许显示，不满足的输入被忽略。仅支持单个字符匹配，不支持字符串匹配。例如：^(?=.\*\d)(?=.\*[a-z])(?=.\*[A-Z]).{8,10}$，不支持过滤8到10位的强密码。
- value：设置正则表达式。
- error：正则匹配失败时，返回被忽略的内容。 | | copyOption9+ | [CopyOptions](ts-basic-components-text.md) | CopyOptions.CrossDevice | 设置文本是否可复制。 | -- TextAlign枚举说明 - | 名称 | 描述 | - | ------ | ------- | - | Start | 水平对齐首部。 | - | Center | 水平居中对齐。 | - | End | 水平对齐尾部。 | - ## 事件 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-column.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-column.md index e618bdb2db9974a8686548e96a2bea53202ec68b..73899d2a5952044b515c76642749e3b37c0862cb 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-container-column.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-column.md @@ -32,16 +32,9 @@ Column(value:{space?: Length}) | 名称 | 参数类型 | 默认值 | 描述 | | -------- | -------- | -------- | -------- | -| alignItems | HorizontalAlign | HorizontalAlign.Center | 设置子组件在水平方向上的对齐格式。 | +| alignItems | [HorizontalAlign](ts-appendix-enums.md#horizontalalign) | HorizontalAlign.Center | 设置子组件在水平方向上的对齐格式。 | | justifyContent8+ | [FlexAlign](ts-container-flex.md) | FlexAlign.Start | 设置子组件在垂直方向上的对齐格式。 | -- HorizontalAlign枚举说明 - | 名称 | 描述 | - | -------- | -------- | - | Start | 按照语言方向起始端对齐。 | - | Center | 居中对齐，默认对齐方式。 | - | End | 按照语言方向末端对齐。 | - ## 示例 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-flex.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-flex.md index 354136dd9454b0c5734f556e75d4f778d1a2ae33..d9379dc6f1b6b0fa4693f374bedce67f36643d1d 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-container-flex.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-flex.md @@ -26,36 +26,11 @@ Flex(options?: { direction?: FlexDirection, wrap?: FlexWrap, justifyContent?: F - 参数 | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | | -------------- | ---------------------------------------- | ---- | ----------------- | ---------------------------------------- | - | direction | FlexDirection | 否 | FlexDirection.Row | 子组件在Flex容器上排列的方向，即主轴的方向。 | - | wrap | FlexWrap | 否 | FlexWrap.NoWrap | Flex容器是单行/列还是多行/列排列。 | - | justifyContent | FlexAlign | 否 | FlexAlign.Start | 子组件在Flex容器主轴上的对齐格式。 | - | alignItems | [ItemAlign](ts-appendix-enums.md#itemalign枚举说明) | 否 | ItemAlign.Stretch | 子组件在Flex容器交叉轴上的对齐格式。 | - | alignContent | FlexAlign | 否 | FlexAlign.Start | 交叉轴中有额外的空间时，多行内容的对齐方式。仅在wrap为Wrap或WrapReverse下生效。 | - -- FlexDirection枚举说明 - | 名称 | 描述 | - | ------------- | ---------------- | - | Row | 主轴与行方向一致作为布局模式。 | - | RowReverse | 与Row方向相反方向进行布局。 | - | Column | 主轴与列方向一致作为布局模式。 | - | ColumnReverse | 与Column相反方向进行布局。 | - -- FlexWrap枚举说明 - | 名称 | 描述 | - | ----------- | ------------------------------------------------- | - | NoWrap | Flex容器的元素单行/列布局，子项不允许超出容器。 | - | Wrap | Flex容器的元素多行/列排布，子项允许超出容器。 | - | WrapReverse | Flex容器的元素反向多行/列排布，子项允许超出容器。 | - -- FlexAlign枚举说明 - | 名称 | 描述 | - | ------------ | ------------------------------------------------------------ | - | Start | 元素在主轴方向首端对齐，第一个元素与行首对齐，同时后续的元素与前一个对齐。 | - | Center | 元素在主轴方向中心对齐，第一个元素与行首的距离与最后一个元素与行尾距离相同。 | - | End | 元素在主轴方向尾部对齐，最后一个元素与行尾对齐，其他元素与后一个对齐。 | - | SpaceBetween | Flex主轴方向均匀分配弹性元素，相邻元素之间距离相同。第一个元素与行首对齐，最后一个元素与行尾对齐。 | - | SpaceAround | Flex主轴方向均匀分配弹性元素，相邻元素之间距离相同。第一个元素到行首的距离和最后一个元素到行尾的距离是相邻元素之间距离的一半。 | - | SpaceEvenly | Flex主轴方向元素等间距布局，相邻元素之间的间距、第一个元素与行首的间距、最后一个元素到行尾的间距都完全一样。 | + | direction | [FlexDirection](ts-appendix-enums.md#flexdirection) | 否 | FlexDirection.Row | 子组件在Flex容器上排列的方向，即主轴的方向。 | + | wrap | [FlexWrap](ts-appendix-enums.md#flexwrap) | 否 | FlexWrap.NoWrap | Flex容器是单行/列还是多行/列排列。 | + | justifyContent | [FlexAlign](ts-appendix-enums.md#flexalign) | 否 | FlexAlign.Start | 子组件在Flex容器主轴上的对齐格式。 | + | alignItems | [ItemAlign](ts-appendix-enums.md#itemalign) | 否 | ItemAlign.Stretch | 子组件在Flex容器交叉轴上的对齐格式。 | + | alignContent | [FlexAlign](ts-appendix-enums.md#flexalign) | 否 | FlexAlign.Start | 交叉轴中有额外的空间时，多行内容的对齐方式。仅在wrap为Wrap或WrapReverse下生效。 | ## 示例 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-list.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-list.md index 34102de39f2434a91437ac29a5f120119a4187aa..8e56157a7504fe5f600fcaa049e0b0685e42c44b 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-container-list.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-list.md @@ -35,23 +35,16 @@ List(value:{space?: number | string, initialIndex?: number, scroller?: Scroller} | 名称 | 参数类型 | 默认值 | 描述 | | -------- | -------- | -------- | -------- | -| listDirection | [Axis](ts-appendix-enums.md#axis枚举说明) | Vertical | 设置List组件排列方向参照Axis枚举说明。 | +| listDirection | [Axis](ts-appendix-enums.md#axis) | Vertical | 设置List组件排列方向参照Axis枚举说明。 | | divider | {
strokeWidth: Length,
color?:Color,
startMargin?: Length,
endMargin?: Length
} | - | 用于设置ListItem分割线样式，默认无分割线。
strokeWidth: 分割线的线宽。
color: 分割线的颜色。
startMargin： 分割线距离列表侧边起始端的距离。
endMargin: 分割线距离列表侧边结束端的距离。 | | editMode | boolean | false | 声明当前List组件是否处于可编辑模式。 | -| edgeEffect | EdgeEffect | EdgeEffect.Spring | 滑动效果，目前支持的滑动效果参见EdgeEffect的枚举说明。 | +| edgeEffect | [EdgeEffect](ts-appendix-enums.md#edgeeffect) | EdgeEffect.Spring | 滑动效果，目前支持的滑动效果参见EdgeEffect的枚举说明。 | | chainAnimation | boolean | false | 用于设置当前list是否启用链式联动动效，开启后列表滑动以及顶部和底部拖拽时会有链式联动的效果。链式联动效果：list内的list-item间隔一定距离，在基本的滑动交互行为下，主动对象驱动从动对象进行联动，驱动效果遵循弹簧物理动效。
- false：不启用链式联动。
- true：启用链式联动。 | | multiSelectable8+ | boolean | false | 是否开启鼠标框选。
- false：关闭框选。
- true：开启框选。 | | restoreId8+ | number | - | 组件迁移标识符，标识后的组件在应用迁移时，组件状态会被迁移到被拉起方的同标识组件。
列表组件状态，包括起始位置显示的item序号。 | | lanes9+ | number \|
{
minLength: Length,
maxLength: Length
} | 1 | 以列模式为例（listDirection为Axis.Vertical）:
lanes用于决定List组件在交叉轴方向按几列布局，规则如下：
- lanes为指定的数量时，根据指定的数量与List组件的交叉轴宽度来决定每列的宽度；
- lane设置了{minLength，maxLength}时，根据List组件的宽度自适应决定lanes数量（即列数），保证缩放过程中lane的宽度符合{minLength，maxLength}的限制。其中，minLength条件会被优先满足，即优先保证符合ListItem的宽度符合最小宽度限制。例如在列模式下，设置了{minLength: 40vp，maxLength: 60vp}，则当List组件宽度为70vp时，ListItem为一列，并且根据alignListItem属性做靠左、居中或者靠右布局；当List组件宽度变化至80vp时，符合两倍的minLength，则ListItem自适应为两列。 | | alignListItem9+ | ListItemAlign | ListItemAlign.Center | List交叉轴方向宽度大于ListItem交叉轴宽度 * lanes时，ListItem在List交叉轴方向的布局方式，默认为居中。 | -- EdgeEffect枚举说明 - - | 名称 | 描述 | - | ------ | ------------------------------------------------------------ | - | Spring | 弹性物理动效，滑动到边缘后可以根据初始速度或通过触摸事件继续滑动一段距离，松手后回弹。 | - | None | 滑动到边缘后无效果。 | - - ListItemAlign枚举说明 | 名称 | 描述 | diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-row.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-row.md index 3e68e2a4d7cc369722144d2115470d39bbfd0292..a28a7e0277fe9bf309dfac23e4242c6e5aed90a5 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-container-row.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-row.md @@ -31,15 +31,8 @@ Row(value:{space?: Length}) | 名称 | 参数类型 | 默认值 | 描述 | | -------- | -------- | -------- | -------- | -| alignItems | VerticalAlign | VerticalAlign.Center | 在垂直方向上子组件的对齐格式。 | -| justifyContent8+ | [FlexAlign](ts-container-flex.md) | FlexAlign.Start | 设置子组件在水平方向上的对齐格式。 | - -- VerticalAlign枚举说明 - | 名称 | 描述 | - | -------- | -------- | - | Top | 顶部对齐。 | - | Center | 居中对齐，默认对齐方式。 | - | Bottom | 底部对齐。 | +| alignItems | [VerticalAlign](ts-appendix-enums.md#verticalalign) | VerticalAlign.Center | 在垂直方向上子组件的对齐格式。 | +| justifyContent8+ | [FlexAlign](ts-appendix-enums.md#flexalign) | FlexAlign.Start | 设置子组件在水平方向上的对齐格式。 | ## 示例 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-scroll.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-scroll.md index 72792ad454d0aed28fa9b4a6ae51c8fd54c48a5b..1573f14f9bd3518557156d71e6cd43921934689b 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-container-scroll.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-scroll.md @@ -29,7 +29,7 @@ Scroll(scroller?: Scroller) | 名称 | 参数类型 | 默认值 | 描述 | | -------------- | ---------------------------------------- | ------------------------ | --------- | | scrollable | ScrollDirection | ScrollDirection.Vertical | 设置滚动方法。 | -| scrollBar | [BarState](ts-appendix-enums.md#barstate枚举说明) | ScrollDirection.Auto | 设置滚动条状态。 | +| scrollBar | [BarState](ts-appendix-enums.md#barstate) | ScrollDirection.Auto | 设置滚动条状态。 | | scrollBarColor | Color | - | 设置滚动条的颜色。 | | scrollBarWidth | Length | - | 设置滚动条的宽度。 | diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-shape.md b/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-shape.md index 50612a62b7e45725830b144f874740bb4f727c30..095ac835bafe618e2d71ca6d5f9bf33d8fd1bbc1 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-shape.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-shape.md @@ -42,21 +42,13 @@ Shape(value:{target?: PixelMap}) | stroke | Color | - | 否 | 边框颜色。 | | strokeDashArray | Array<Length> | [] | 否 | 设置边框的间隙。 | | strokeDashOffset | Length | 0 | 否 | 边框绘制起点的偏移量。 | -| strokeLineCap | [LineCapStyle](ts-appendix-enums.md#LineCapStyle枚举说明) | LineCapStyle.Butt | 否 | 路径端点绘制样式。 | -| strokeLineJoin | LineJoinStyle | LineJoinStyle.Miter | 否 | 边框拐角绘制样式。 | +| strokeLineCap | [LineCapStyle](ts-appendix-enums.md#linecapstyle) | LineCapStyle.Butt | 否 | 路径端点绘制样式。 | +| strokeLineJoin | [LineJoinStyle](ts-appendix-enums.md#linejoinstyle) | LineJoinStyle.Miter | 否 | 边框拐角绘制样式。 | | strokeMiterLimit | number | 4 | 否 | 锐角绘制成斜角的极限值。 | | strokeOpacity | number | 1 | 否 | 设置边框的不透明度。 | | strokeWidth | Length | 1 | 否 | 设置边框的宽度。 | | antiAlias | boolean | true | 否 | 是否开启抗锯齿。 | -- LineJoinStyle枚举说明 - | 名称 | 描述 | - | -------- | -------- | - | Bevel | 使用斜角连接路径段。 | - | Miter | 使用尖角连接路径段。 | - | Round | 使用圆角连接路径段。 | - - ## 示例 ```ts diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-explicit-animation.md b/zh-cn/application-dev/reference/arkui-ts/ts-explicit-animation.md index a29438b26c85c635e234f188e04c77de2b13cbfc..4a59a33dd391fbe053a231537fccef3a244170fa 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-explicit-animation.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-explicit-animation.md @@ -21,7 +21,7 @@ | curve | Curve \| Curves | Linear | 动画曲线。 | | delay | number | 0 | 单位为ms(毫秒)，默认不延时播放。 | | iterations | number | 1 | 默认播放一次，设置为-1时表示无限次播放。 | - | playMode | PlayMode | Normal | 设置动画播放模式，默认播放完成后重头开始播放。 | + | playMode | [PlayMode](ts-appendix-enums.md#playmode) | Normal | 设置动画播放模式，默认播放完成后重头开始播放。 | - 接口 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-transition-animation-component.md b/zh-cn/application-dev/reference/arkui-ts/ts-transition-animation-component.md index 86e7de2eb0b24c94d3dd3ea4ec723f605ba338ce..bdf4908a230e330b5d16601befbe061925ae43b9 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-transition-animation-component.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-transition-animation-component.md @@ -16,19 +16,12 @@ - transition入参说明 | 参数名称 | 参数类型 | 默认值 | 必填 | 参数描述 | | -------- | -------- | -------- | -------- | -------- | - | type | TransitionType | TransitionType.All | 否 | 默认包括组件新增和删除。
>  **说明：**
> 不指定Type时说明插入删除使用同一种效果。 | + | type | [TransitionType](ts-appendix-enums.md#transitiontype) | TransitionType.All | 否 | 默认包括组件新增和删除。
>  **说明：**
> 不指定Type时说明插入删除使用同一种效果。 | | opacity | number | 1 | 否 | 设置组件转场时的透明度效果，为插入时起点和删除时终点的值。 | | translate | {
x? : number,
y? : number,
z? : number
} | - | 否 | 设置组件转场时的平移效果，为插入时起点和删除时终点的值。
**说明：**
> x、y、z分别是横向、纵向、竖向的平移距离 | | scale | {
x? : number,
y? : number,
z? : number,
centerX? : number,
centerY? : number
} | - | 否 | 设置组件转场时的缩放效果，为插入时起点和删除时终点的值。
**说明：**
> x、y、z分别是横向、纵向、竖向放大倍数（或缩小到原来的多少）
> centerX、centerY缩放中心点
> 中心点为0时，默认的是组件的左上角
| | rotate | {
x?: number,
y?: number,
z?: number,
angle?: Angle,
centerX?: Length,
centerY?: Length
} | - | 否 | 设置组件转场时的旋转效果，为插入时起点和删除时终点的值。
**说明：**
> x、y、z分别是横向、纵向、竖向的旋转向量
> centerX,centerY指旋转中心点
> 中心点为0时，默认的是组件的左上角 | -- TransitionType枚举说明 - | 名称 | 描述 | - | -------- | -------- | - | All | 指定当前的Transition动效生效在组件的所有变化场景。 | - | Insert | 指定当前的Transition动效生效在组件的插入场景。 | - | Delete | 指定当前的Transition动效生效在组件的删除场景。 | - ## 示例 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-background.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-background.md index c0348500d73326566f6814ea31dfc20df6e79f5d..bc6dbe171b151d5fa70693139f12fac733cb9ac8 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-background.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-background.md @@ -17,17 +17,9 @@ | 名称 | 参数类型 | 默认值 | 描述 | | -------- | -------- | -------- | -------- | | backgroundColor | [ResourceColor](../../ui/ts-types.md) | - | 设置组件的背景色。 | -| backgroundImage | src: [ResourceStr](../../ui/ts-types.md),
repeat?: [ImageRepeat](ts-appendix-enums.md#imagerepeat枚举说明) | - | src参数：图片地址，支持网络图片资源和本地图片资源地址(不支持svg类型的图片)。
repeat参数：设置背景图片的重复样式，默认不重复。 | -| backgroundImageSize | {
width?: Length,
height?: Length
} \| ImageSize | Auto | 设置背景图像的高度和宽度。当输入为{width: Length, height: Length}对象时，如果只设置一个属性，则第二个属性保持图片原始宽高比进行调整。默认保持原图的比例不变。 | -| backgroundImagePosition | {
x?: Length,
y?: Length
} \| [Alignment](ts-appendix-enums.md#alignment枚举说明) | {
x: 0,
y: 0
} | 设置背景图在组件中显示位置。 | - - -- ImageSize枚举说明 - | 类型 | 描述 | - | -------- | -------- | - | Cover | 默认值，保持宽高比进行缩小或者放大，使得图片两边都大于或等于显示边界。 | - | Contain | 保持宽高比进行缩小或者放大，使得图片完全显示在显示边界内。 | - | Auto | 保持原图的比例不变。 | +| backgroundImage | src: [ResourceStr](../../ui/ts-types.md),
repeat?: [ImageRepeat](ts-appendix-enums.md#imagerepeat) | - | src参数：图片地址，支持网络图片资源和本地图片资源地址(不支持svg类型的图片)。
repeat参数：设置背景图片的重复样式，默认不重复。 | +| backgroundImageSize | {
width?: Length,
height?: Length
} \| [ImageSize](ts-appendix-enums.md#imagesize) | Auto | 设置背景图像的高度和宽度。当输入为{width: Length, height: Length}对象时，如果只设置一个属性，则第二个属性保持图片原始宽高比进行调整。默认保持原图的比例不变。 | +| backgroundImagePosition | {
x?: Length,
y?: Length
} \| [Alignment](ts-appendix-enums.md#alignment) | {
x: 0,
y: 0
} | 设置背景图在组件中显示位置。 | ## 示例 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-border.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-border.md index 155ba67a955f6785c010963c7df1df9f3888c0a6..b68b34b6ee28fdc00b4a4fc4d7b47214fc12df19 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-border.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-border.md @@ -20,7 +20,7 @@ | 名称 | 参数类型 | 默认值 | 描述 | | ------------ | ------------- | ----------------------- | ------------------------ | | border | BorderOptions | - | 统一边框样式设置接口。 | -| borderStyle | BorderStyle |  BorderStyle.Solid | 设置元素的边框样式。 | +| borderStyle | [BorderStyle](ts-appendix-enums.md#borderstyle) |  BorderStyle.Solid | 设置元素的边框样式。 | | borderWidth | Length | 0 | 设置元素的边框宽度。 | | borderColor | [ResourceColor](../../ui/ts-types.md) | - | 设置元素的边框颜色。 | | borderRadius | Length \| BorderRadiuses9+ | 0 | 设置元素的边框圆角半径。 | @@ -32,7 +32,7 @@ | width | [Length](../../ui/ts-types.md#长度类型) \| EdgeWidth9+ | 0 | 否 | 边框宽度。 | | color | [ResourceColor](../../ui/ts-types.md) \| EdgeColor9+ | 'Black' | 否 | 边框颜色。 | | radius | [Length](../../ui/ts-types.md#长度类型) \| BorderRadiuses9+ | 0 | 否 | 边框角度。 | - | style | BorderStyle \| EdgeStyle9+ | BorderStyle.Solid | 否 | 边框样式。 | + | style | [BorderStyle](ts-appendix-enums.md#borderstyle) \| EdgeStyle9+ | BorderStyle.Solid | 否 | 边框样式。 | - EdgeWidth9+对象说明 @@ -74,19 +74,10 @@ | 名称 | 参数类型 | 必填 | 默认值 | 描述 | | ------ | ----------- | ---- | ----------------- | -------------- | - | left | BorderStyle | 否 | BorderStyle.Solid | 左侧边框样式。 | - | right | BorderStyle | 否 | BorderStyle.Solid | 右侧边框样式。 | - | top | BorderStyle | 否 | BorderStyle.Solid | 上侧边框样式。 | - | bottom | BorderStyle | 否 | BorderStyle.Solid | 下侧边框样式。 | - -- BorderStyle枚举说明 - - | 名称 | 描述 | - | ------ | ----------------------------------------------- | - | Dotted | 显示为一系列圆点，圆点半径为borderWidth的一半。 | - | Dashed | 显示为一系列短的方形虚线。 | - | Solid | 显示为一条实线。 | - + | left | [BorderStyle](ts-appendix-enums.md#borderstyle) | 否 | BorderStyle.Solid | 左侧边框样式。 | + | right | [BorderStyle](ts-appendix-enums.md#borderstyle) | 否 | BorderStyle.Solid | 右侧边框样式。 | + | top | [BorderStyle](ts-appendix-enums.md#borderstyle) | 否 | BorderStyle.Solid | 上侧边框样式。 | + | bottom | [BorderStyle](ts-appendix-enums.md#borderstyle) | 否 | BorderStyle.Solid | 下侧边框样式。 | ## 示例 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-gradient-color.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-gradient-color.md index 453cb642e4494a6d0c7ab79f6fe813423306a361..7bb5c61e3019194b71102aca1d997bd03b079763 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-gradient-color.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-gradient-color.md @@ -17,27 +17,11 @@ | 名称 | 参数类型 | 默认值 | 描述 | | -------- | -------- | -------- | -------- | -| linearGradient | {
angle?: [Angle](../../ui/ts-types.md),
direction?: GradientDirection,
colors: Array<[ColorStop](../../ui/ts-types.md)>
repeating?: boolean
} | - | 线性渐变。
angle: 线性渐变的角度。
direction: 线性渐变的方向，设置angle后不生效。
colors: 为渐变的颜色描述。
repeating: 为渐变的颜色重复着色。 | +| linearGradient | {
angle?: [Angle](../../ui/ts-types.md),
direction?: [GradientDirection](ts-appendix-enums.md#gradientdirection),
colors: Array<[ColorStop](../../ui/ts-types.md)>
repeating?: boolean
} | - | 线性渐变。
angle: 线性渐变的角度。
direction: 线性渐变的方向，设置angle后不生效。
colors: 为渐变的颜色描述。
repeating: 为渐变的颜色重复着色。 | | sweepGradient | {
center: Point,
start?: angle,
end?: angle,
colors: Array<[ColorStop](../../ui/ts-types.md)>
repeating?: boolean
} | - | 角度渐变。
center：为角度渐变的中心点。
start：角度渐变的起点。
end：角度渐变的终点。
colors: 为渐变的颜色描述。
repeating: 为渐变的颜色重复着色。 | | radialGradient | {
center: Point,
radius: Length,
colors: Array<[ColorStop](../../ui/ts-types.md)>
repeating: boolean
} | - | 径向渐变。
center：径向渐变的中心点。
radius：径向渐变的半径。
colors: 为渐变的颜色描述。
repeating: 为渐变的颜色重复着色。 | -- GradientDirection枚举说明
- GradientDirection用于描述渐变方向。 - - | 名称 | 描述 | - | -------- | -------- | - | Left | 从右向左。 | - | Top | 从下向上。 | - | Right | 从左向右。 | - | Bottom | 从上向下。 | - | LeftTop | 左上。 | - | LeftBottom | 左下。 | - | RightTop | 右上。 | - | RightBottom | 右下。 | - | None | 无。 | - - ## 示例 ```ts diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-hover-effect.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-hover-effect.md index ba2fd891c3258f400766f0d51864d1d213f7a83d..e9c817aa0d974577a3964200085dbf0d72b9e4f4 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-hover-effect.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-hover-effect.md @@ -15,15 +15,7 @@ | 名称 | 参数类型 | 默认值 | 描述 | | -------- | -------- | -------- | -------- | -| hoverEffect | HoverEffect | HoverEffect.Auto | 设置当前组件悬停态下的悬浮效果。 | - -- HoverEffect 枚举说明 - | 名称 | 描述 | - | -------- | -------- | - | Auto | 使用组件的系统默认悬浮效果。 | - | Scale | 放大缩小效果。 | - | Highlight | 背景淡入淡出的强调效果。 | - | None | 不设置效果。 | +| hoverEffect | [HoverEffect](ts-appendix-enums.md#hovereffect8) | HoverEffect.Auto | 设置当前组件悬停态下的悬浮效果。 | ## 示例 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-location.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-location.md index c6182fe332d009a5fb4d77424a5f59e6873826c4..2420c855d9ca1cc6c00ff298d718b1ec69e2f18b 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-location.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-location.md @@ -16,21 +16,13 @@ | 名称 | 参数类型 | 默认值 | 描述 | | -------- | -------- | -------- | -------- | -| align | [Alignment](ts-appendix-enums.md#alignment枚举说明) | Center | 设置元素内容的对齐方式，只有当设置的width和height大小超过元素本身内容大小时生效。 | -| direction | Direction | Auto | 设置元素水平方向的布局，可选值参照Direction枚举说明。 | +| align | [Alignment](ts-appendix-enums.md#alignment) | Center | 设置元素内容的对齐方式，只有当设置的width和height大小超过元素本身内容大小时生效。 | +| direction | [Direction](ts-appendix-enums.md#direction) | Auto | 设置元素水平方向的布局，可选值参照Direction枚举说明。 | | position | {
x: Length,
y: Length
} | - | 使用绝对定位，设置元素锚点相对于父容器顶部起点偏移位置。在布局容器中，设置该属性不影响父容器布局，仅在绘制时进行位置调整。 | | markAnchor | {
x: Length,
y: Length
} | {
x: 0,
y: 0
} | 设置元素在位置定位时的锚点，以元素顶部起点作为基准点进行偏移。 | | offset | {
x: Length,
y: Length
} | {
x: 0,
y: 0
} | 相对布局完成位置坐标偏移量，设置该属性，不影响父容器布局，仅在绘制时进行位置调整。 | -- Direction枚举说明 - | 名称 | 描述 | - | -------- | -------- | - | Ltr | 元素从左到右布局。 | - | Rtl | 元素从右到左布局。 | - | Auto | 使用系统默认布局方向。 | - - ## 示例 ```ts diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-menu.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-menu.md index 0328140bc146ee0e61fd6226c162fae6cbac7c4a..a5261c90b6ca33c821d856efd398b5d8311fd334 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-menu.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-menu.md @@ -17,7 +17,7 @@ | 名称 | 参数类型 | 默认值 | 描述 | | ---------------------------- | ---------------------------------------- | ---- | ---------------------------------- | | bindMenu | Array8+ | - | 给组件绑定菜单，点击后弹出菜单。弹出菜单项支持文本和自定义两种功能。 | -| bindContextMenu8+ | content: [CustomBuilder](../../ui/ts-types.md),
responseType: ResponseType | - | 给组件绑定菜单，触发方式为长按或者右键点击，弹出菜单项需要自定义。 | +| bindContextMenu8+ | content: [CustomBuilder](../../ui/ts-types.md),
responseType: [ResponseType](ts-appendix-enums.md#responsetype8) | - | 给组件绑定菜单，触发方式为长按或者右键点击，弹出菜单项需要自定义。 | - MenuItem @@ -26,11 +26,6 @@ | value | string | 菜单项文本。 | | action | () => void | 点击菜单项的事件回调。 | -- ResponseType8+ - | 参数值 | 描述 | - | ---------- | ------------- | - | LongPress | 通过长按触发菜单弹出。 | - | RightClick | 通过鼠标右键触发菜单弹出。 | ## 示例 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-popup.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-popup.md index e24a9061abb61bba245a09e10b5d9853995ead8b..1d4e2cd67a266c57d8af58ed2a347b977b8a1d33 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-popup.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-popup.md @@ -33,7 +33,7 @@ | 名称 | 类型 | 必填 | 默认值 | 描述 | | -------- | -------- | -------- | -------- | -------- | | builder | () => any | 是 | - | 提示气泡内容的构造器。 | - | placement | Placement | 否 | Placement.Bottom | 气泡组件优先显示的位置，当前位置显示不下时，会自动调整位置。 | + | placement | [Placement](ts-appendix-enums.md#placement8) | 否 | Placement.Bottom | 气泡组件优先显示的位置，当前位置显示不下时，会自动调整位置。 | | arrowOffset9+ | Length | 否 | - | popup箭头在弹窗处的偏移。箭头在气泡上下方时，默认居左；箭头在气泡左右侧，默认居上。 | | maskColor | [ResourceColor](../../ui/ts-types.md) | 否 | - | 提示气泡遮障层的颜色。 | | popupColor | [ResourceColor](../../ui/ts-types.md) | 否 | - | 提示气泡的颜色。 | @@ -41,22 +41,6 @@ | autoCancel | boolean | 否 | true | 页面有操作时，是否自动关闭气泡 | | onStateChange | (isVisible: boolean) => void | 否 | - | 弹窗状态变化事件回调，参数为弹窗当前的显示状态。 | -- Placement8+枚举说明 - | 名称 | 描述 | - | -------- | -------- | - | Left | 气泡提示位于组件左侧，与组件左侧中心对齐。 | - | Right | 气泡提示位于组件右侧，与组件右侧中心对齐。 | - | Top | 气泡提示位于组件上侧，与组件上侧中心对齐。 | - | Bottom | 气泡提示位于组件下侧，与组件下侧中心对齐。 | - | TopLeft | 气泡提示位于组件上侧，从API Version 9开始，与组件左侧边缘对齐。 | - | TopRight | 气泡提示位于组件上侧，从API Version 9开始，与组件右侧边缘对齐。 | - | BottomLeft | 气泡提示位于组件下侧，从API Version 9开始，与组件左侧边缘对齐。 | - | BottomRight | 气泡提示位于组件下侧，从API Version 9开始，与组件右侧边缘对齐。 | - | LeftTop9+ | 气泡提示位于组件左侧，与组件上侧边缘对齐。 | - | LeftBottom9+ | 气泡提示位于组件左侧，与组件下侧边缘对齐。 | - | RightTop9+ | 气泡提示位于组件右侧，与组件上侧边缘对齐。 | - | RightBottom9+ | 气泡提示位于组件右侧，与组件下侧边缘对齐。 | - ## 示例 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-text-style.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-text-style.md index 940dcc2f820dd3c9ad35e862dbe1a3004a289bf2..900ed973ab009749201d7b351eef5e4c58a04008 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-text-style.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-text-style.md @@ -20,29 +20,11 @@ | -------- | -------- | -------- | -------- | | fontColor | [ResourceColor](../../ui/ts-types.md) | - | 设置文本颜色。 | | fontSize | Length \| [Resource](../../ui/ts-types.md#resource类型) | - | 设置文本尺寸，Length为number类型时，使用fp单位。 | -| fontStyle | FontStyle | FontStyle.Normal | 设置文本的字体样式。 | -| fontWeight | number \| FontWeight \| string | FontWeight.FontWeightNormal | 设置文本的字体粗细，number类型取值[100, 900]，取值间隔为100，默认为400，取值越大，字体越粗。
提供常用枚举值，参考：FontWeight枚举说明。 | +| fontStyle | [FontStyle](ts-appendix-enums.md#fontstyle) | FontStyle.Normal | 设置文本的字体样式。 | +| fontWeight | number \| [FontWeight](ts-appendix-enums.md#fontweight) \| string | FontWeight.FontWeightNormal | 设置文本的字体粗细，number类型取值[100, 900]，取值间隔为100，默认为400，取值越大，字体越粗。
提供常用枚举值，参考：FontWeight枚举说明。 | | fontFamily | string \| [Resource](../../ui/ts-types.md#resource类型) | - | 设置文本的字体列表。使用多个字体，使用','进行分割，优先级按顺序生效。例如：'Arial, sans-serif'。 | -- FontStyle枚举说明 - | 名称 | 描述 | - | -------- | -------- | - | Normal | 标准的字体样式。 | - | Italic | 斜体的字体样式。 | - - -- FontWeight枚举说明 - | 名称 | 描述 | - | -------- | -------- | - | Lighter | 字体较细。 | - | Normal | 字体粗细正常。 | - | Regular | 字体粗细正常。 | - | Medium | 字体粗细适中。 | - | Bold | 字体较粗。 | - | Bolder | 字体非常粗。 | - - ## 示例 ```ts diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-visibility.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-visibility.md index 5f476bd46fe9c34d2b7dea57f89372690b374938..b0abcabf9ed01aad3ccd2a3c55b3bb92d89d2540 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-visibility.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-visibility.md @@ -16,15 +16,7 @@ | 名称 | 参数类型 | 默认值 | 描述 | | -------- | -------- | -------- | -------- | -| visibility | Visibility | Visibility.Visible | 控制当前组件显示或隐藏。注意，即使组件处于隐藏状态，在页面刷新时仍存在重新创建过程，因此当对性能有严格要求时建议使用[条件渲染](../../ui/ts-rending-control-syntax-if-else.md)代替。| - - -- Visibility枚举说明 - | 名称 | 描述 | - | -------- | -------- | - | Hidden | 隐藏，但参与布局进行占位。 | - | Visible | 显示。 | - | None | 隐藏，但不参与布局，不进行占位。 | +| visibility | [Visibility](ts-appendix-enums.md#visibility) | Visibility.Visible | 控制当前组件显示或隐藏。注意，即使组件处于隐藏状态，在页面刷新时仍存在重新创建过程，因此当对性能有严格要求时建议使用[条件渲染](../../ui/ts-rending-control-syntax-if-else.md)代替。| ## 示例 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-key.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-key.md index cdcabb4b2d4b75a11d0c284074475e447be47ece..9648704c60c849956fa2d48d9ecee3f0186ecf14 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-key.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-key.md @@ -23,10 +23,10 @@ - 属性 | 属性名称 | 类型 | 描述 | | ------------------------------------- | --------------------------- | -------------------------- | - | type | [KeyType](#keytype枚举说明) | 按键的类型。 | + | type | [KeyType](ts-appendix-enums.md#keytype) | 按键的类型。 | | [keyCode](../apis/js-apis-keycode.md) | number | 按键的键码。 | | keyText | string | 按键的键值。 | - | keySource | [KeySource](#keysource枚举说明) | 触发当前按键的输入设备类型。 | + | keySource | [KeySource](ts-appendix-enums.md#keysource) | 触发当前按键的输入设备类型。 | | deviceId | number | 触发当前按键的输入设备ID。 | | metaKey | number | 按键发生时元键的状态，1表示按压态，0表示未按压态。 | | timestamp | number | 按键发生时的时间戳。 | @@ -37,21 +37,6 @@ | ---------------------------- | --------- | | stopPropagation(): void | 阻塞事件冒泡传递。 | -## KeyType枚举说明 -| 名称 | 描述 | -| ---- | ----- | -| Down | 按键按下。 | -| Up | 按键松开。 | - - -## KeySource枚举说明 -| 名称 | 描述 | -| -------- | ---------- | -| Unknown | 输入设备类型未知。 | -| Keyboard | 输入设备类型为键盘。 | - - - ## 示例 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-touch.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-touch.md index 8df552afb72eb04fed908ba2d827804731a76e14..50a5e1a01227f057b2b74ef1baa4491e9fb08d85 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-touch.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-touch.md @@ -21,13 +21,13 @@ ## TouchEvent对象说明 - 属性 - | 属性名称 | 类型 | 描述 | - | ------------------- | ------------------------------------------------------------ | ---------------------------------- | - | type | TouchType | 触摸事件的类型。 | - | touches | Array<[TouchObject](#touchobject对象说明)> | 全部手指信息。 | - | changedTouches | Array<[TouchObject](#touchobject对象说明)> | 当前发生变化的手指信息。 | - | timestamp | number | 距离开机时间的时间戳，单位为毫秒。 | - | target8+ | [EventTarget](ts-universal-events-click.md#eventtarget8对象说明) | 被触摸元素对象。 | + | 属性名称 | 类型 | 描述 | + | ------------------- | ---------------------------------------- | ------------ | + | type | [TouchType](ts-appendix-enums.md#touchtype) | 触摸事件的类型。 | + | touches | Array<[TouchObject](#touchobject对象说明)> | 全部手指信息。 | + | changedTouches | Array<[TouchObject](#touchobject对象说明)> | 当前发生变化的手指信息。 | + | timestamp | number | 距离开机时间的时间戳，单位为毫秒。 | + | target8+ | [EventTarget](ts-universal-events-click.md#eventtarget8对象说明) | 被触摸元素对象。 | - 接口 @@ -39,23 +39,13 @@ ## TouchObject对象说明 | 属性名称 | 类型 | 描述 | | ------- | --------------------------- | ------------------- | -| type | [TouchType](#touchtype枚举说明) | 触摸事件的类型。 | +| type | [TouchType](ts-appendix-enums.md#touchtype) | 触摸事件的类型。 | | id | number | 手指唯一标识符。 | | screenX | number | 触摸点相对于设备屏幕左边沿的X坐标。 | | screenY | number | 触摸点相对于设备屏幕上边沿的Y坐标。 | | x | number | 触摸点相对于被触摸元素左边沿的X坐标。 | | y | number | 触摸点相对于被触摸元素上边沿的Y坐标。 | - -## TouchType枚举说明 -| 名称 | 描述 | -| ------ | ---------------------------------- | -| Down | 手指按下时触发。 | -| Up | 手指抬起时触发。 | -| Move | 手指按压态在屏幕上移动时触发。 | -| Cancel | 触摸交互过程中应用退到后台时触发。 | - - ## 示例 ```ts diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-mouse-key.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-mouse-key.md index 86299d7b4b1ee353c0b6fce533293a9f3af000b7..caa22dfdf12440230d217926f680cb6f66cbc2d9 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-mouse-key.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-mouse-key.md @@ -27,27 +27,8 @@ | screenY | number | 点击触点相对于屏幕左上角的y轴坐标。 | | x | number | 点击触点相对于当前组件左上角的x轴坐标。 | | y | number | 点击触点相对于当前组件左上角的y轴坐标。 | -| button | [MouseButton](#mousebutton类型说明) | 鼠标按键。 | -| action | [MouseAction](#mouseaction类型说明) | 事件动作。 | - - -## MouseButton类型说明 -| 属性名称 | 属性类型 | 描述 | -| ------- | ------ | -------- | -| Left | number | 鼠标左键。 | -| Right | number | 鼠标右键。 | -| Middle | number | 鼠标中键。 | -| Back | number | 鼠标左侧后退键。 | -| Forward | number | 鼠标左侧前进键。 | -| None | number | 无按键。 | - -## MouseAction类型说明 -| 属性名称 | 属性类型 | 描述 | -| ------- | ------ | ------- | -| Press | number | 鼠标按键按下。 | -| Release | number | 鼠标按键松开。 | -| Move | number | 鼠标移动。 | - +| button | [MouseButton](ts-appendix-enums.md#mousebutton) | 鼠标按键。 | +| action | [MouseAction](ts-appendix-enums.md#mouseaction) | 事件动作。 | ## 示例 diff --git a/zh-cn/application-dev/ui/ts-types.md b/zh-cn/application-dev/ui/ts-types.md index 7fe41c4e11547cc1fa02f4678f4c907518ba93ca..ea7b7683e5146cd2ff32c2eb30f6cdd8214a49fc 100644 --- a/zh-cn/application-dev/ui/ts-types.md +++ b/zh-cn/application-dev/ui/ts-types.md @@ -27,24 +27,7 @@ | 名称 | 类型定义 | 描述 | | ----- | ---------------------------------------- | ---------------------------------------- | -| Color | string \| number \| Color | 用于描述颜色信息，输入为string类型时，使用rgb或者rgba进行描述；输入为number类型是，使用HEX格式颜色；输入类型为Color枚举时，使用颜色枚举值。
- 'rgb(255, 255, 255)'。
- 'rgba(255, 255, 255, 1.0)'。
- HEX格式：0xrrggbb，0xaarrggbb，'\#FFFFFF'。
- 枚举格式：Color.Black，Color.White等。 | - - -当前支持的Color颜色枚举： - - -| 颜色名称 | 颜色值 | 颜色示意 | -| ------ | -------- | ---------------------------------------- | -| 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) | -| Gray | 0x808080 | ![zh-cn_image_0000001174264376](figures/zh-cn_image_0000001174264376.png) | -| Green | 0x008000 | ![zh-cn_image_0000001174422914](figures/zh-cn_image_0000001174422914.png) | -| Orange | 0xffa500 | ![zh-cn_image_0000001219662661](figures/zh-cn_image_0000001219662661.png) | -| Pink | 0xffc0cb | ![zh-cn_image_0000001219662663](figures/zh-cn_image_0000001219662663.png) | -| Red | 0xff0000 | ![zh-cn_image_0000001219662665](figures/zh-cn_image_0000001219662665.png) | -| White | 0xffffff | ![zh-cn_image_0000001174582866](figures/zh-cn_image_0000001174582866.png) | -| Yellow | 0xffff00 | ![zh-cn_image_0000001174582864](figures/zh-cn_image_0000001174582864.png) | +| Color | string \| number \| [Color](../reference/arkui-ts/ts-appendix-enums.md#color) | 用于描述颜色信息，输入为string类型时，使用rgb或者rgba进行描述；输入为number类型是，使用HEX格式颜色；输入类型为Color枚举时，使用颜色枚举值。
- 'rgb(255, 255, 255)'。
- 'rgba(255, 255, 255, 1.0)'。
- HEX格式：0xrrggbb，0xaarrggbb，'\#FFFFFF'。
- 枚举格式：Color.Black，Color.White等。 | ## ColorStop类型