From 24f4cc9c1965fc2f21e776f8a37d466fd303c58b Mon Sep 17 00:00:00 2001 From: kangchongtao Date: Wed, 17 Aug 2022 20:09:41 +0800 Subject: [PATCH] =?UTF-8?q?3.1=E6=96=87=E6=A1=A3=E6=9E=9A=E4=B8=BE?= =?UTF-8?q?=E6=95=B4=E6=94=B9?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: kangchongtao --- .../figures/zh-cn_image_0000001174104404.png | Bin 0 -> 117 bytes .../figures/zh-cn_image_0000001174264376.png | Bin 0 -> 117 bytes .../figures/zh-cn_image_0000001174422914.png | Bin 0 -> 117 bytes .../figures/zh-cn_image_0000001174582864.png | Bin 0 -> 117 bytes .../figures/zh-cn_image_0000001174582866.png | Bin 0 -> 117 bytes .../figures/zh-cn_image_0000001219662661.png | Bin 0 -> 118 bytes .../figures/zh-cn_image_0000001219662663.png | Bin 0 -> 120 bytes .../figures/zh-cn_image_0000001219662665.png | Bin 0 -> 117 bytes .../figures/zh-cn_image_0000001219744201.png | Bin 0 -> 119 bytes .../figures/zh-cn_image_0000001219864153.png | Bin 0 -> 117 bytes .../reference/arkui-ts/ts-animatorproperty.md | 22 +- .../reference/arkui-ts/ts-appendix-enums.md | 439 +++++++++++++++--- .../arkui-ts/ts-basic-components-image.md | 12 +- .../ts-basic-components-imageanimator.md | 20 +- .../arkui-ts/ts-basic-components-scrollbar.md | 9 +- .../arkui-ts/ts-basic-components-text.md | 40 +- .../arkui-ts/ts-basic-components-textarea.md | 10 +- .../reference/arkui-ts/ts-container-column.md | 10 +- .../reference/arkui-ts/ts-container-flex.md | 39 +- .../reference/arkui-ts/ts-container-list.md | 13 +- .../reference/arkui-ts/ts-container-row.md | 12 +- .../reference/arkui-ts/ts-container-scroll.md | 2 +- .../arkui-ts/ts-drawing-components-shape.md | 11 +- .../arkui-ts/ts-explicit-animation.md | 2 +- .../ts-transition-animation-component.md | 9 +- .../ts-universal-attributes-background.md | 14 +- .../ts-universal-attributes-border.md | 11 +- .../ts-universal-attributes-gradient-color.md | 18 +- .../ts-universal-attributes-hover-effect.md | 10 +- .../ts-universal-attributes-location.md | 11 +- .../arkui-ts/ts-universal-attributes-menu.md | 8 +- .../arkui-ts/ts-universal-attributes-popup.md | 14 +- .../ts-universal-attributes-text-style.md | 21 +- .../ts-universal-attributes-visibility.md | 9 +- .../arkui-ts/ts-universal-events-key.md | 19 +- .../arkui-ts/ts-universal-events-touch.md | 14 +- .../arkui-ts/ts-universal-mouse-key.md | 23 +- zh-cn/application-dev/ui/ts-types.md | 20 +- 38 files changed, 423 insertions(+), 419 deletions(-) create mode 100644 zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001174104404.png create mode 100644 zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001174264376.png create mode 100644 zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001174422914.png create mode 100644 zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001174582864.png create mode 100644 zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001174582866.png create mode 100644 zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001219662661.png create mode 100644 zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001219662663.png create mode 100644 zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001219662665.png create mode 100644 zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001219744201.png create mode 100644 zh-cn/application-dev/reference/arkui-ts/figures/zh-cn_image_0000001219864153.png 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 GIT binary patch literal 117 zcmeAS@N?(olHy`uVBq!ia0vp^8bB<gvsPR8!~yHTkoK@5o7VyVoRVo44$rjF6*2U FngHorA+!Jh literal 0 HcmV?d00001 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 GIT binary patch literal 117 zcmeAS@N?(olHy`uVBq!ia0vp^8bB<znU;IpzS(VeoYIb6Mw< G&;$T_vnG}R literal 0 HcmV?d00001 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 GIT binary patch literal 117 zcmeAS@N?(olHy`uVBq!ia0vp^8bB<lpXXwBtxATYpD%i(h#GWlWe119+&{zqB2i1h-^VeoYIb6Mw< G&;$Tv?cI7kO^ED_DCa>HTpY}WlS!{%~b=L$KdJe=d#Wz Gp$Pz^FePjN literal 0 HcmV?d00001 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 GIT binary patch literal 120 zcmeAS@N?(olHy`uVBq!ia0vp^8bB<1j~ai3u2?}nI3!M24zF0m(Cb2%Ld2yoPL_?(AKe%Skf>0X-K$$wf|vOuF4JYD@< J);T3K0RYF*ChPzJ literal 0 HcmV?d00001 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 GIT binary patch literal 117 zcmeAS@N?(olHy`uVBq!ia0vp^8bB<lE#LB1gM-o8k#!}*+1<$G!S7AnW?|~3+v>cI0Zn4?boFyt I=akR{0Lu*~%K!iX literal 0 HcmV?d00001 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 GIT binary patch literal 117 zcmeAS@N?(olHy`uVBq!ia0vp^8bB<WH8`4?2!6@ z;cUe(oUT8m58Y(8;k*B3L5{j3r$-ZK6yxmtW@Pd{x8AjhB8(27w%7yBVeoYIb6Mw< G&;$TYL?ibA literal 0 HcmV?d00001 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 354b8ab55c..057e4fc2fa 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-animatorproperty.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-animatorproperty.md @@ -10,28 +10,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 a63bdad329..2063402304 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,92 +1,401 @@ # 文档中涉及到的内置枚举值 -## 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) | +## 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后消失)。 | +| 名称 | 描述 | +| -------- | -------------------- | +| Unknown | 输入设备类型未知。 | +| Keyboard | 输入设备类型为键盘。 | + +## 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 | 气泡提示位于组件上侧。 | +| TopRight | 气泡提示位于组件上侧。 | +| BottomLeft | 气泡提示位于组件下侧。 | +| BottomRight | 气泡提示位于组件下侧。 | \ No newline at end of file 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 94f7bdd957..c077431a66 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 @@ -42,23 +42,13 @@ Image(src: string | PixelMap | Resource) | 名称 | 参数类型 | 默认值 | 描述 | | --------------------- | ------------------------------------------------------- | -------- | ------------------------------------------------------------ | | alt | string \| [Resource](../../ui/ts-types.md#resource类型) | - | 加载时显示的占位图。支持本地图片和网络路径。 | -| objectFit | ImageFit | Cover | 设置图片的缩放类型。 | +| objectFit | [ImageFit](ts-appendix-enums.md#imagefit) | Cover | 设置图片的缩放类型。 | | objectRepeat | [ImageRepeat](ts-appendix-enums.md#imagerepeat枚举说明) | NoRepeat | 设置图片的重复样式。
>  **说明：**
> - svg类型图源不支持该属性。 | | interpolation | ImageInterpolation | None | 设置图片的插值效果，即减轻低清晰度图片在放大显示的时候出现的锯齿问题，仅针对图片放大插值。
>  **说明：**
> - svg类型图源不支持该属性。
> - PixelMap资源不支持该属性。 | | renderMode | ImageRenderMode | Original | 设置图片渲染的模式。
>  **说明：**
> - svg类型图源不支持该属性。 | | sourceSize | {
width: number,
height: number
} | - | 设置图片解码尺寸，将原始图片解码成指定尺寸的图片，number类型单位为px。
>  **说明：**
> - PixelMap资源不支持该属性。 | | syncLoad8+ | boolean | false | 设置是否同步加载图片，默认是异步加载。同步加载时阻塞UI线程，不会显示占位图。 | -## ImageFit枚举说明 - -| 名称 | 描述 | -| --------- | -------------------------------- | -| Cover | 保持宽高比进行缩小或者放大，使得图片两边都大于或等于显示边界。 | -| Contain | 保持宽高比进行缩小或者放大，使得图片完全显示在显示边界内。 | -| Fill | 不保持宽高比进行放大缩小，使得图片填充满显示边界。 | -| None | 保持原有尺寸显示。通常配合objectRepeat属性一起使用。 | -| ScaleDown | 保持宽高比显示，图片缩小或者保持不变。 | - ## ImageInterpolation枚举说明 | 名称 | 描述 | 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 f3494f5afb..2599fc7c4f 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,30 +27,14 @@ ImageAnimator() | 参数名称 | 参数类型 | 默认值 | 必填 | 参数描述 | | ---------- | ---------------------------------------- | -------- | ---- | ---------------------------------------- | | images | Array<{
src:string,
width?:Length,
height?:Length,
top?:Length,
left?:Length,
duration?:number
}> | [] | 是 | 设置图片帧信息集合。每一帧的帧信息包含图片路径、图片大小、图片位置和图片播放时长信息。详细说明如下：
src：图片路径，图片格式为svg，png和jpg。
width：图片宽度。
height：图片高度。
top：图片相对于组件左上角的纵向坐标。
left：图片相对于组件左上角的横向坐标。
duration：每一帧图片的播放时长，单位毫秒。 | -| 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时表示无限次播放。 | -## 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 b3d84efe6d..abdbb7717e 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 @@ -27,7 +27,7 @@ ScrollBar(value: { scroller: Scroller, direction?: ScrollBarDirection, state?: B | --------- | ---------------------------------------- | ---- | --------------------------- | ----------------------- | | 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的子节点负责定义滚动条的行为样式。 @@ -41,13 +41,6 @@ ScrollBar(value: { scroller: Scroller, direction?: ScrollBarDirection, state?: B | Vertical | 纵向滚动条。 | | Horizontal | 横向滚动条。 | -## BarState枚举说明 - -| 名称 | 描述 | -| ---- | --------------------- | -| On | 常驻显示。 | -| Off | 不显示。 | -| Auto | 按需显示(触摸时显示，无操作2s后消失)。 | ## 示例 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 9f1316e30d..c0df5f73ec 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 @@ -31,46 +31,14 @@ Text(content?: ResourceStr) | 名称 | 参数类型 | 默认值 | 描述 | | -------------- | ---------------------------------------- | ---------------------------------------- | ---------------------------------------- | -| textAlign | TextAlign | TextAlign.Start | 设置多行文本的文本对齐方式。 | -| textOverflow | {overflow: TextOverflow} | {overflow: TextOverflow.Clip} | 设置文本超长时的显示方式。
**说明：**
文本截断是按字截断。例如，英文以单词为最小单位进行截断，若需要以字母为单位进行截断，可在字母间添加零宽空格：\u200B。 | +| textAlign | [TextAlign](ts-appendix-enums.md#textalign) | TextAlign.Start | 设置多行文本的文本对齐方式。 | +| textOverflow | {overflow: [TextOverflow](ts-appendix-enums.md#textoverflow)} | {overflow: TextOverflow.Clip} | 设置文本超长时的显示方式。
**说明：**
文本截断是按字截断。例如，英文以单词为最小单位进行截断，若需要以字母为单位进行截断，可在字母间添加零宽空格：\u200B。 | | maxLines | number | Infinity | 设置文本的最大行数。 | | lineHeight | string \| number \| [Resource](../../ui/ts-types.md) | - | 设置文本的文本行高，设置值不大于0时，不限制文本行高，自适应字体大小，Length为number类型时单位为fp。 | -| decoration | {
type: TextDecorationType,
color?: [ResourceColor](../../ui/ts-types.md)
} | {
type: TextDecorationType.None,
color：Color.Black
} | 设置文本装饰线样式及其颜色。 | +| decoration | {
type: [TextDecorationType](ts-appendix-enums.md#textdecorationtype),
color?: [ResourceColor](../../ui/ts-types.md)
} | {
type: TextDecorationType.None,
color：Color.Black
} | 设置文本装饰线样式及其颜色。 | | baselineOffset | [Length](../../ui/ts-types.md) | - | 设置文本基线的偏移量。 | -| textCase | TextCase | TextCase.Normal | 设置文本大小写。 | +| textCase | [TextCase](ts-appendix-enums.md#textcase) | TextCase.Normal | 设置文本大小写。 | -## TextAlign枚举说明 - -| 名称 | 描述 | -| ------ | -------------- | -| Center | 文本居中对齐。 | -| Start | 根据文字书写相同的方向对齐。 | -| End | 根据文字书写相反的方向对齐。 | - -## TextOverflow枚举说明 - -| 名称 | 描述 | -| -------- | ------------------- | -| Clip | 文本超长时进行裁剪显示。 | -| Ellipsis | 文本超长时显示不下的文本用省略号代替。 | -| None | 文本超长时不进行裁剪。 | - -## TextDecorationType枚举说明 - -| 名称 | 描述 | -| ----------- | --------- | -| Underline | 文字下划线修饰。 | -| LineThrough | 穿过文本的修饰线。 | -| Overline | 文字上划线修饰。 | -| None | 不使用文本装饰线。 | - -## TextCase枚举说明 - -| 名称 | 描述 | -| --------- | ---------- | -| Normal | 保持文本原有大小写。 | -| LowerCase | 文本采用全小写。 | -| UpperCase | 文本采用全大写。 | > **说明：** > 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 994fee4e62..93e8e6b9fe 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 @@ -37,18 +37,10 @@ TextArea(value?:{placeholder?: ResourceStr, text?: ResourceStr, controller?: Tex | ------------------------ | ---------------------------------------- | ----- | ---------------------------------------- | | placeholderColor | [ResourceColor](../../ui/ts-types.md) | - | 设置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 | [ResourceColor](../../ui/ts-types.md) | - | 设置输入框光标颜色。 | | inputFilter8+ | {
value: [ResourceStr](../../ui/ts-types.md)8+,
error?: (value: string) => void
} | - | 通过正则表达式设置输入过滤器。满足表达式的输入允许显示，不满足的输入被忽略。仅支持单个字符匹配，不支持字符串匹配。例如：^(?=.\*\d)(?=.\*[a-z])(?=.\*[A-Z]).{8,10}$，不支持过滤8到10位的强密码。
- value：设置正则表达式。
- error：正则匹配失败时，返回被忽略的内容。 | -## 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 0301e44a26..74c3addbc6 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 @@ -31,17 +31,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 4804b66653..569882254a 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 @@ -27,39 +27,12 @@ Flex(value?: { direction?: FlexDirection, wrap?: FlexWrap, justifyContent?: Fle | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | | -------------- | ---------------------------------------- | ---- | ----------------- | ---------------------------------------- | -| 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 031a072143..e75f8b8415 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?:[ResourceColor](../../ui/ts-types.md),
startMargin?: Length,
endMargin?: Length
} | - | 用于设置ListItem分割线样式，默认无分割线。
strokeWidth: 分割线的线宽。
color: 分割线的颜色。
startMargin： 分割线距离列表侧边起始端的距离。
endMargin: 分割线距离列表侧边结束端的距离。 | -| scrollBar | [BarState](ts-appendix-enums.md#barstate枚举说明) | BarState.Off | 设置滚动条状态。 | +| scrollBar | [BarState](ts-appendix-enums.md#barstate) | BarState.Off | 设置滚动条状态。 | | cachedCount | number | 1 | 设置预加载的ListItem的数量。 | | 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序号。 | -## EdgeEffect枚举说明 - -| 名称 | 描述 | -| ------ | ---------------------------------------- | -| Spring | 弹性物理动效，滑动到边缘后可以根据初始速度或通过触摸事件继续滑动一段距离，松手后回弹。 | -| Fade | 阴影效果，滑动到边缘后会有圆弧状的阴影。 | -| None | 滑动到边缘后无效果。 | ## 事件 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 a188391e2e..00ef773191 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,16 +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 74e72f3b11..ea61fa6b56 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 @@ -28,7 +28,7 @@ Scroll(scroller?: Scroller) | 名称 | 参数类型 | 默认值 | 描述 | | -------------- | ---------------------------------------- | ------------------------ | --------- | | scrollable | ScrollDirection | ScrollDirection.Vertical | 设置滚动方法。 | -| scrollBar | [BarState](ts-appendix-enums.md#barstate枚举说明) | BarState.Off | 设置滚动条状态。 | +| scrollBar | [BarState](ts-appendix-enums.md#barstate) | BarState.Off | 设置滚动条状态。 | | scrollBarColor | string \| number \| Color | - | 设置滚动条的颜色。 | | scrollBarWidth | Length | - | 设置滚动条的宽度。 | | edgeEffect | EdgeEffect | EdgeEffect.Spring | 设置滑动效果，目前支持的滑动效果参见EdgeEffect的枚举说明。 | 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 4a56238b30..20e292bc8f 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 @@ -40,20 +40,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 | 使用圆角连接路径段。 | ## 示例 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 8c1d10aed8..97795b8086 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 6dcdb52d16..f1443f46d8 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 123824d1a5..869a5aa656 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 @@ -18,17 +18,9 @@ | 名称 | 参数类型 | 默认值 | 描述 | | -------- | -------- | -------- | -------- | | backgroundColor | Color | - | 设置组件的背景色。 | -| backgroundImage | src: string,
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: string,
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 d5a4caf318..3a50b531df 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 @@ -17,20 +17,13 @@ | 名称 | 参数类型 | 默认值 | 描述 | | -------- | -------- | -------- | -------- | -| border | {
width?: Length,
color?: Color,
radius?: Length,
style?: BorderStyle
} | - | 统一边框样式设置接口。 | -| borderStyle | BorderStyle |  BorderStyle.Solid | 设置元素的边框样式。 | +| border | {
width?: Length,
color?: Color,
radius?: Length,
style?: [BorderStyle](ts-appendix-enums.md#borderstyle)
} | - | 统一边框样式设置接口。 | +| borderStyle | [BorderStyle](ts-appendix-enums.md#borderstyle) |  BorderStyle.Solid | 设置元素的边框样式。 | | borderWidth | Length | 0 | 设置元素的边框宽度。 | | borderColor | Color | - | 设置元素的边框颜色。 | | borderRadius | Length | 0 | 设置元素的边框圆角半径。 | -- BorderStyle枚举说明 - | 名称 | 描述 | - | -------- | -------- | - | Dotted | 显示为一系列圆点，圆点半径为borderWidth的一半。 | - | Dashed | 显示为一系列短的方形虚线。 | - | 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 e71af0022d..b841ccdf7b 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 @@ -14,27 +14,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 5ff1536cc7..5d5e67163c 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 @@ -13,15 +13,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 34af6dbbc7..81a520f6a1 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 @@ -15,19 +15,12 @@ | 名称 | 参数类型 | 默认值 | 描述 | | ---------- | ---------------------------------------- | ------------------------------------ | ---------------------------------------- | -| 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 | 使用系统默认布局方向。 | ## 示例 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 18e7c2a42e..5d30ddaf91 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 @@ -16,7 +16,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 @@ -25,12 +25,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 1cadac8e50..7948a22fbf 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 @@ -32,25 +32,13 @@ | 名称 | 类型 | 必填 | 默认值 | 描述 | | ------------- | ---------------------------------------- | ---- | ---------------- | ------------------------------ | | builder | () => any | 是 | - | 提示气泡内容的构造器。 | -| placement | Placement | 否 | Placement.Bottom | 气泡组件优先显示的位置，当前位置显示不下时，会自动调整位置。 | +| placement | [Placement](ts-appendix-enums.md#placement8) | 否 | Placement.Bottom | 气泡组件优先显示的位置，当前位置显示不下时，会自动调整位置。 | | maskColor | [Color](../../ui/ts-types.md#颜色类型) | 否 | - | 提示气泡遮障层的颜色。 | | popupColor | [Color](../../ui/ts-types.md#颜色类型) | 否 | - | 提示气泡的颜色。 | | enableArrow | boolean | 否 | true | 是否显示箭头，只有上、下方向的气泡会显示箭头。 | | autoCancel | boolean | 否 | true | 页面有操作时，是否自动关闭气泡 | | onStateChange | (isVisible: boolean) => void | 否 | - | 弹窗状态变化事件回调，参数为弹窗当前的显示状态。 | -## Placement8+枚举说明 - -| 名称 | 描述 | -| ----------- | ------------ | -| Left | 气泡提示位于组件左侧。 | -| Right | 气泡提示位于组件右侧。 | -| Top | 气泡提示位于组件上侧。 | -| Bottom | 气泡提示位于组件下侧。 | -| TopLeft | 气泡提示位于组件左上角。 | -| TopRight | 气泡提示位于组件右上角。 | -| BottomLeft | 气泡提示位于组件左下角。 | -| BottomRight | 气泡提示位于组件右下角。 | ## 示例 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 be06da3598..6179351068 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,27 +20,10 @@ | ---------- | ------------------------ | --------------------------- | ---------------------------------------- | | fontColor | Color | - | 设置文本颜色。 | | fontSize | Length | - | 设置文本尺寸，Length为number类型时，使用fp单位。 | -| fontStyle | FontStyle | FontStyle.Normal | 设置文本的字体样式。 | -| fontWeight | number \|FontWeight | 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) | FontWeight.FontWeightNormal | 设置文本的字体粗细，number类型取值[100, 900]，取值间隔为100，默认为400，取值越大，字体越粗。
提供常用枚举值，参考：FontWeight枚举说明。 | | fontFamily | string | - | 设置文本的字体列表。使用多个字体，使用','进行分割，优先级按顺序生效。例如：'Arial, sans-serif'。 | -## FontStyle枚举说明 - -| 名称 | 描述 | -| ------ | -------- | -| Normal | 标准的字体样式。 | -| Italic | 斜体的字体样式。 | - -## FontWeight枚举说明 - -| 名称 | 描述 | -| ------- | ------- | -| Lighter | 字体较细。 | -| Normal | 字体粗细正常。 | -| Regular | 字体粗细正常。 | -| Medium | 字体粗细适中。 | -| Bold | 字体较粗。 | -| Bolder | 字体非常粗。 | ## 示例 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 382b62cd00..ba0cbbb206 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 @@ -15,15 +15,8 @@ | 名称 | 参数类型 | 默认值 | 描述 | | ---------- | ---------- | ------------------ | ------------ | -| visibility | Visibility | Visibility.Visible | 控制当前组件显示或隐藏。 | +| visibility | [Visibility](ts-appendix-enums.md#visibility) | Visibility.Visible | 控制当前组件显示或隐藏。 | -## Visibility枚举说明 - -| 名称 | 描述 | -| ------- | ---------------- | -| Hidden | 隐藏，但参与布局进行占位。 | -| Visible | 显示。 | -| None | 隐藏，但不参与布局，不进行占位。 | ## 示例 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 13a48a0c80..09498cc8ea 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 @@ -25,10 +25,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 | 按键发生时的时间戳。 | @@ -39,21 +39,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 50001dd6a2..1797ffa5e4 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 @@ -23,7 +23,7 @@ | 属性名称 | 类型 | 描述 | | ------------------- | ------------------------------------------------------------ | ---------------------------------- | -| type | TouchType | 触摸事件的类型。 | +| type | [TouchType](ts-appendix-enums.md#touchtype) | 触摸事件的类型。 | | touches | Array<[TouchObject](#touchobject对象说明)> | 全部手指信息。 | | changedTouches | Array<[TouchObject](#touchobject对象说明)> | 当前发生变化的手指信息。 | | timestamp | number | 距离开机时间的时间戳，单位为毫秒。 | @@ -38,23 +38,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 158bafe419..1735b4af8a 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 @@ -26,27 +26,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 665108d5c1..380a8d4376 100644 --- a/zh-cn/application-dev/ui/ts-types.md +++ b/zh-cn/application-dev/ui/ts-types.md @@ -27,25 +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类型 -- GitLab