Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
c6438ec8
D
Docs
项目概览
OpenHarmony
/
Docs
接近 2 年 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
提交
c6438ec8
编写于
9月 06, 2022
作者:
T
tianyu
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
third
Signed-off-by:
N
tianyu
<
tianyu55@h-partners.com
>
上级
e73dc8a0
变更
14
隐藏空白更改
内联
并排
Showing
14 changed file
with
294 addition
and
340 deletion
+294
-340
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-progress.md
...on-dev/reference/arkui-ts/ts-basic-components-progress.md
+36
-30
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-rating.md
...tion-dev/reference/arkui-ts/ts-basic-components-rating.md
+14
-17
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-scrollbar.md
...n-dev/reference/arkui-ts/ts-basic-components-scrollbar.md
+22
-25
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-select.md
...tion-dev/reference/arkui-ts/ts-basic-components-select.md
+19
-21
zh-cn/application-dev/reference/arkui-ts/ts-container-navigator.md
...lication-dev/reference/arkui-ts/ts-container-navigator.md
+19
-24
zh-cn/application-dev/reference/arkui-ts/ts-container-panel.md
.../application-dev/reference/arkui-ts/ts-container-panel.md
+38
-39
zh-cn/application-dev/reference/arkui-ts/ts-container-refresh.md
...pplication-dev/reference/arkui-ts/ts-container-refresh.md
+18
-21
zh-cn/application-dev/reference/arkui-ts/ts-container-row.md
zh-cn/application-dev/reference/arkui-ts/ts-container-row.md
+13
-17
zh-cn/application-dev/reference/arkui-ts/ts-container-sidebarcontainer.md
...n-dev/reference/arkui-ts/ts-container-sidebarcontainer.md
+42
-43
zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-polygon.md
...n-dev/reference/arkui-ts/ts-drawing-components-polygon.md
+14
-23
zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-polyline.md
...-dev/reference/arkui-ts/ts-drawing-components-polyline.md
+14
-23
zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-rect.md
...tion-dev/reference/arkui-ts/ts-drawing-components-rect.md
+19
-28
zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-shape.md
...ion-dev/reference/arkui-ts/ts-drawing-components-shape.md
+24
-27
zh-cn/application-dev/reference/arkui-ts/ts-explicit-animation.md
...plication-dev/reference/arkui-ts/ts-explicit-animation.md
+2
-2
未找到文件。
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-progress.md
浏览文件 @
c6438ec8
# Progress
# Progress
> **说明:**
进度条组件,用于显示内容加载或操作处理等进度。
> 该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
进度条,用于显示内容加载或操作处理进度。
> **说明:**
## 权限列表
>
> 该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
无
## 子组件
## 子组件
...
@@ -23,31 +18,42 @@ Progress(options: {value: number, total?: number, type?: ProgressType})
...
@@ -23,31 +18,42 @@ Progress(options: {value: number, total?: number, type?: ProgressType})
创建进度组件,用于显示内容加载或操作处理进度。
创建进度组件,用于显示内容加载或操作处理进度。
-
参数
**参数:**
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| -------- | -------- | -------- | -------- | -------- |
| value | number | 是 | - | 指定当前进度值。 |
| total | number | 否 | 100 | 指定进度总长。 |
| type | ProgressType | 否 | ProgressType.Linear | 指定进度条样式。 |
-
ProgressType枚举说明
| 名称 | 描述 |
| -------- | -------- |
| Linear
<sup>
8+
</sup>
| 线性样式。 |
| Ring
<sup>
8+
</sup>
| 环形无刻度样式,环形圆环逐渐填充完成过程。 |
| Eclipse
<sup>
8+
</sup>
| 圆形样式,展现类似月圆月缺的进度展示效果,从月牙逐渐到满月的这个过程代表了下载的进度。 |
| ScaleRing
<sup>
8+
</sup>
| 环形有刻度样式,类似时钟刻度形式加载进度。 |
| Capsule
<sup>
8+
</sup>
| 胶囊样式,头尾两端处,进度条由弧形变成直线和直线变成弧形的过程;中段处,进度条正常往右走的过程。 |
| 参数名 | 参数类型 | 必填 | 参数描述 |
| -------- | -------- | -------- | -------- |
| value | number | 是 | 指定当前进度值。 |
| total | number | 否 | 指定进度总长。
<br/>
默认值:100 |
| type
<sup>
8+
</sup>
| ProgressType | 否 | 指定进度条样式。
<br/>
默认值:ProgressType.Linear |
| style
<sup>
deprecated
</sup>
| ProgressStyle | 否 | 指定进度条类型。
<br/>
该参数从API Version8开始废弃,建议使用type替代。
<br/>
默认值:ProgressStyle.Linear |
## ProgressType枚举说明
| 名称 | 描述 |
| -------- | -------- |
| Linear | 线性样式。 |
| Ring
<sup>
8+
</sup>
| 环形无刻度样式,环形圆环逐渐显示至完全填充效果。 |
| Eclipse
<sup>
8+
</sup>
| 圆形样式,显示类似月圆月缺的进度展示效果,从月牙逐渐变化至满月。 |
| ScaleRing
<sup>
8+
</sup>
| 环形有刻度样式,显示类似时钟刻度形式的进度展示效果。 |
| Capsule
<sup>
8+
</sup>
| 胶囊样式,头尾两端圆弧处的进度展示效果与Eclipse相同;中段处的进度展示效果与Linear相同。 |
## ProgressStyle枚举说明
| 名称 | 描述 |
| --------- | ------------------------------------------------------------ |
| Linear | 线性样式。 |
| Ring | 环形无刻度样式,环形圆环逐渐显示至完全填充效果。 |
| Eclipse | 圆形样式,显示类似月圆月缺的进度展示效果,从月牙逐渐变化至满月。 |
| ScaleRing | 环形有刻度样式,显示类似时钟刻度形式的进度展示效果。 |
| Capsule | 胶囊样式,头尾两端圆弧处的进度展示效果与Eclipse相同;中段处的进度展示效果与Linear相同。 |
## 属性
## 属性
| 名称 | 参数类型 |
默认值 |
描述 |
| 名称 | 参数类型 | 描述 |
| -------- | -------- | -------- |
-------- |
| -------- | -------- | -------- |
| value | number |
- |
设置当前进度值。 |
| value | number | 设置当前进度值。 |
| color |
[
ResourceColor
](
../../ui/ts-types.md
)
|
- |
设置进度条前景色。 |
| color |
[
ResourceColor
](
../../ui/ts-types.md
)
| 设置进度条前景色。 |
| style
<sup>
8+
</sup>
| {
<br/>
strokeWidth?:
Length,
<br/>
scaleCount?:
number,
<br/>
scaleWidth?:
Length
<br/>
} | - | 定义组件的样式。
<br/>
strokeWidth:
设置进度条宽度。
<br/>
scaleCount:
设置环形进度条总刻度数。
<br/>
scaleWidth:
设置环形进度条刻度粗细。
<br/>
刻度粗细大于进度条宽度时,刻度粗细
为系统默认粗细。 |
| style
<sup>
8+
</sup>
| {
<br/>
strokeWidth?:
[Length](../../ui/ts-types.md#length),
<br/>
scaleCount?:
number,
<br/>
scaleWidth?:
[
Length
](
../../ui/ts-types.md#length
)
<br/>
} | 定义组件的样式。
<br/>
-
strokeWidth:
设置进度条宽度。
<br/>
-
scaleCount:
设置环形进度条总刻度数。
<br/>
-
scaleWidth:
设置环形进度条刻度粗细,刻度粗细大于进度条宽度时,
为系统默认粗细。 |
## 示例
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-rating.md
浏览文件 @
c6438ec8
...
@@ -3,12 +3,8 @@
...
@@ -3,12 +3,8 @@
提供在给定范围内选择评分的组件。
提供在给定范围内选择评分的组件。
> **说明:**
> **说明:**
> 该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
>
> 该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 权限列表
无
## 子组件
## 子组件
...
@@ -16,24 +12,25 @@
...
@@ -16,24 +12,25 @@
无
无
## 接口
说明
## 接口
Rating(options?: { rating: number, indicator?: boolean })
Rating(options?: { rating: number, indicator?: boolean })
-
参数
**参数:**
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| -------- | -------- | -------- | -------- | -------- |
| 参数名 | 参数类型 | 必填 | 参数描述 |
| rating | number | 是 | 0 | 设置并接收评分值。 |
| -------- | -------- | -------- | -------- |
| indicator | boolean | 否 | false | 仅作为指示器使用,不可操作。 |
| rating | number | 是 | 设置并接收评分值。
<br/>
默认值:0 |
| indicator | boolean | 否 | 仅作为指示器使用,不可操作。
<br/>
默认值:false |
## 属性
## 属性
| 名称 | 参数类型 |
默认值 |
描述 |
| 名称 | 参数类型 | 描述 |
| -------- | -------- | -------- |
-------- |
| -------- | -------- | -------- |
| stars | number |
5 | 设置评星总数。
|
| stars | number |
设置评星总数。
<br/>
默认值:5
|
| stepSize | number |
0.5 | 操作评级的步长。
|
| stepSize | number |
操作评级的步长。
<br/>
默认值:0.5
|
| starStyle | {
<br/>
backgroundUri:
string,
<br/>
foregroundUri:
string,
<br/>
secondaryUri?:
string
<br/>
} |
- | backgroundSrc:未选中的星级的图片链接,可由用户自定义或使用系统默认图片,仅支持本地。
<br/>
foregroundSrc:选中的星级的图片路径,可由用户自定义或使用系统默认图片,仅支持本地。
<br/>
secondarySrc:部分选中的星级的图片路径,可由用户自定义或使用系统默认图片,仅支持本地
。 |
| starStyle | {
<br/>
backgroundUri:
string,
<br/>
foregroundUri:
string,
<br/>
secondaryUri?:
string
<br/>
} |
backgroundUri:未选中的星级的图片链接,可由用户自定义或使用系统默认图片,仅支持本地图片。
<br/>
foregroundUri:选中的星级的图片路径,可由用户自定义或使用系统默认图片,仅支持本地图片。
<br/>
secondaryUir:部分选中的星级的图片路径,可由用户自定义或使用系统默认图片,仅支持本地图片
。 |
## 事件
## 事件
...
...
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-scrollbar.md
浏览文件 @
c6438ec8
# ScrollBar
# ScrollBar
> **说明:**
> 该组件从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
滚动条组件ScrollBar,用于配合可滚动组件使用,如List、Grid、Scroll。
滚动条组件ScrollBar,用于配合可滚动组件使用,如List、Grid、Scroll。
> **说明:**
## 权限列表
>
> 该组件从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
无
## 子组件
## 子组件
...
@@ -21,23 +16,25 @@
...
@@ -21,23 +16,25 @@
ScrollBar(value: { scroller: Scroller, direction?: ScrollBarDirection, state?: BarState })
ScrollBar(value: { scroller: Scroller, direction?: ScrollBarDirection, state?: BarState })
-
ScrollBarOptions的参数描述
**参数:**
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| -------- | -------- | -------- | -------- | -------- |
| 参数名 | 参数类型 | 必填 | 参数描述 |
| scroller |
[
Scroller
](
ts-container-scroll.md#scroller
)
| 是 | - | 可滚动组件的控制器。用于与可滚动组件进行绑定。 |
| -------- | -------- | -------- | -------- |
| direction | ScrollBarDirection | 否 | ScrollBarDirection.Vertical | 滚动条的方向,控制可滚动组件对应方向的滚动。 |
| scroller |
[
Scroller
](
ts-container-scroll.md#scroller
)
| 是 | 可滚动组件的控制器。用于与可滚动组件进行绑定。 |
| state |
[
BarState
](
ts-appendix-enums.md#barstate
)
| 否 | BarState.Auto | 滚动条状态。 |
| direction | ScrollBarDirection | 否 | 滚动条的方向,控制可滚动组件对应方向的滚动。
<br/>
默认值:ScrollBarDirection.Vertical |
| state |
[
BarState
](
ts-appendix-enums.md#barstate
)
| 否 | 滚动条状态。
<br/>
默认值:BarState.Auto |
> **说明:**
> ScrollBar组件负责定义可滚动区域的行为样式,ScrollBar的子节点负责定义滚动条的行为样式。
> **说明:**
>
> ScrollBar组件负责定义可滚动区域的行为样式,ScrollBar的子节点负责定义滚动条的行为样式。
> 滚动条组件与可滚动组件通过Scroller进行绑定,且只有当两者方向相同时,才能联动,ScrollBar与可滚动组件仅支持一对一绑定。
>
> 滚动条组件与可滚动组件通过Scroller进行绑定,且只有当两者方向相同时,才能联动,ScrollBar与可滚动组件仅支持一对一绑定。
-
ScrollBarDirection枚举说明
| 名称 | 描述 |
## ScrollBarDirection枚举说明
| -------- | -------- |
| Vertical | 纵向滚动条。 |
| 名称 | 描述 |
| Horizontal | 横向滚动条。 |
| -------- | -------- |
| Vertical | 纵向滚动条。 |
| Horizontal | 横向滚动条。 |
## 示例
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-select.md
浏览文件 @
c6438ec8
# Select
# Select
> **说明:** 该组件从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
提供下拉选择菜单,可以让用户在多个选项之间选择。
提供下拉选择菜单,可以让用户在多个选项之间选择。
## 权限列表
> **说明:**
>
无
> 该组件从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 子组件
## 子组件
...
@@ -18,25 +16,25 @@ Select(options: Array\<SelectOption\>)
...
@@ -18,25 +16,25 @@ Select(options: Array\<SelectOption\>)
**SelectOption对象说明:**
**SelectOption对象说明:**
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述
|
| 参数名 | 参数类型 | 必填 | 参数描述
|
| ----- | ----------------------------------- | ---- | ---- |
------- |
| ------ | ----------------------------------- | ---- | -------
------- |
| value |
[
ResourceStr
](
../../ui/ts-types.md
)
| 是 | -
| 下拉选项内容。 |
| value |
[
ResourceStr
](
../../ui/ts-types.md
)
| 是
| 下拉选项内容。 |
| icon |
[
ResourceStr
](
../../ui/ts-types.md
)
| 否 | -
| 下拉选项图片。 |
| icon |
[
ResourceStr
](
../../ui/ts-types.md
)
| 否
| 下拉选项图片。 |
## 属性
## 属性
| 名称
| 参数类型 | 默认值 | 描述
|
| 名称
| 参数类型 | 描述
|
| ----------------------- | ------------------------------------- | ----
|
------------------------ |
| ----------------------- | ------------------------------------- | ----
-----------------
------------------------ |
| selected | number |
- | 设置下拉菜单初始选择
项的索引,第一项的索引为0。 |
| selected | number |
设置下拉菜单初始选
项的索引,第一项的索引为0。 |
| value | string |
- | 设置下拉按钮本身的文本显示。
|
| value | string |
设置下拉按钮本身的文本显示。
|
| font |
[
Font
](
../../ui/ts-types.md
)
|
- | 设置下拉按钮本身的文本样式:
|
| font |
[
Font
](
../../ui/ts-types.md
)
|
设置下拉按钮本身的文本样式。
|
| fontColor |
[
ResourceColor
](
../../ui/ts-types.md
)
|
- | 设置下拉按钮本身的文本颜色。
|
| fontColor |
[
ResourceColor
](
../../ui/ts-types.md
)
|
设置下拉按钮本身的文本颜色。
|
| selectedOptionBgColor |
[
ResourceColor
](
../../ui/ts-types.md
)
|
- | 设置下拉菜单选中项的背景色。
|
| selectedOptionBgColor |
[
ResourceColor
](
../../ui/ts-types.md
)
|
设置下拉菜单选中项的背景色。
|
| selectedOptionFont |
[
Font
](
../../ui/ts-types.md
)
|
- | 设置下拉菜单选中项的文本样式:
|
| selectedOptionFont |
[
Font
](
../../ui/ts-types.md
)
|
设置下拉菜单选中项的文本样式。
|
| selectedOptionFontColor |
[
ResourceColor
](
../../ui/ts-types.md
)
|
- | 设置下拉菜单选中项的文本颜色。
|
| selectedOptionFontColor |
[
ResourceColor
](
../../ui/ts-types.md
)
|
设置下拉菜单选中项的文本颜色。
|
| optionBgColor |
[
ResourceColor
](
../../ui/ts-types.md
)
|
- | 设置下拉菜单项的背景色。
|
| optionBgColor |
[
ResourceColor
](
../../ui/ts-types.md
)
|
设置下拉菜单项的背景色。
|
| optionFont |
[
Font
](
../../ui/ts-types.md
)
|
- | 设置下拉菜单项的文本样式:
|
| optionFont |
[
Font
](
../../ui/ts-types.md
)
|
设置下拉菜单项的文本样式。
|
| optionFontColor |
[
ResourceColor
](
../../ui/ts-types.md
)
|
- | 设置下拉菜单项的文本颜色。
|
| optionFontColor |
[
ResourceColor
](
../../ui/ts-types.md
)
|
设置下拉菜单项的文本颜色。
|
## 事件
## 事件
...
...
zh-cn/application-dev/reference/arkui-ts/ts-container-navigator.md
浏览文件 @
c6438ec8
# Navigator
# Navigator
> **说明:**
> 该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
路由容器组件,提供路由跳转能力。
路由容器组件,提供路由跳转能力。
> **说明:**
## 权限列表
>
> 该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
无
## 子组件
## 子组件
...
@@ -21,28 +16,28 @@
...
@@ -21,28 +16,28 @@
Navigator(value?: {target: string, type?: NavigationType})
Navigator(value?: {target: string, type?: NavigationType})
创建路由组件。
**参数:**
| 参数名 | 参数类型 | 必填 | 参数描述 |
| ------ | -------------- | ---- | ---------------------------------------------- |
| target | string | 是 | 指定跳转目标页面的路径。 |
| type | NavigationType | 否 | 指定路由方式。
<br/>
默认值:NavigationType.Push |
-
参数
## NavigationType枚举说明
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| ------ | -------------- | ---- | ------------------- | ------------ |
| target | string | 是 | - | 指定跳转目标页面的路径。 |
| type | NavigationType | 否 | NavigationType.Push | 指定路由方式。 |
-
NavigationType枚举说明
| 名称 | 描述 |
| 名称 | 描述 |
| ------- | -------------------------- |
| ------- | -------------------------- |
| Push | 跳转到应用内的指定页面。 |
| Push | 跳转到应用内的指定页面。 |
| Replace | 用应用内的某个页面替换当前页面,并销毁被替换的页面。 |
| Replace | 用应用内的某个页面替换当前页面,并销毁被替换的页面。 |
| Back | 返回上一页面或指定的页面。 |
| Back | 返回上一页面或指定的页面。 |
## 属性
## 属性
| 名称
| 参数 | 默认值 | 描述
|
| 名称
| 参数 | 描述
|
| ------ | ------- | ---------
|
---------------------------------------- |
| ------ | ------- | ---------
-----------
---------------------------------------- |
| active | boolean |
- | 当前路由组件是否处于激活状态,处于激活状态时,会生效相应的路由操作。
|
| active | boolean |
当前路由组件是否处于激活状态,处于激活状态时,会生效相应的路由操作。
|
| params | Object |
undefined |
跳转时要同时传递到目标页面的数据,可在目标页面使用router.getParams()获得。 |
| params | Object | 跳转时要同时传递到目标页面的数据,可在目标页面使用router.getParams()获得。 |
## 示例
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-container-panel.md
浏览文件 @
c6438ec8
# Panel
# Panel
> **说明:**
> 该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
可滑动面板,提供一种轻量的内容展示窗口,方便在不同尺寸中切换。
可滑动面板,提供一种轻量的内容展示窗口,方便在不同尺寸中切换。
> **说明:**
## 权限列表
>
> 该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
无
## 子组件
## 子组件
...
@@ -19,47 +14,51 @@
...
@@ -19,47 +14,51 @@
## 接口
## 接口
Panel(
value:{show:boolean}
)
Panel(
show:boolean
)
-
参数
**参数:**
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| -------- | -------- | -------- | -------- | -------- |
| 参数名 | 参数类型 | 必填 | 参数描述 |
| show | boolean | 是 | - | 控制Panel显示或隐藏。 |
| -------- | -------- | -------- | -------- |
| show | boolean | 是 | 控制Panel显示或隐藏。 |
## 属性
## 属性
| 名称 | 参数类型 | 默认值 | 描述 |
| 名称 | 参数类型 | 描述 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- |
| type | PanelType | PanelType.Foldable | 设置可滑动面板的类型。 |
| type | PanelType | 设置可滑动面板的类型。
<br/>
默认值:PanelType.Foldable |
| mode | PanelMode | - | 设置可滑动面板的初始状态。 |
| mode | PanelMode | 设置可滑动面板的初始状态。 |
| dragBar | boolean | true | 设置是否存在dragbar,true表示存在,false表示不存在。 |
| dragBar | boolean | 设置是否存在dragbar,true表示存在,false表示不存在。
<br/>
默认值:true |
| fullHeight | Length | - | 指定PanelMode.Full状态下的高度。 |
| fullHeight | string
\|
number | 指定PanelMode.Full状态下的高度。 |
| halfHeight | Length | - | 指定PanelMode.Half状态下的高度,默认为屏幕尺寸的一半。 |
| halfHeight | string
\|
number | 指定PanelMode.Half状态下的高度,默认为屏幕尺寸的一半。 |
| miniHeight | Length | - | 指定PanelMode.Mini状态下的高度。 |
| miniHeight | string
\|
number | 指定PanelMode.Mini状态下的高度。 |
| backgroundMask
<sup>
9+
</sup>
|(color: ResourceColor)| - |指定Panel的背景蒙层。|
| show | boolean | 当滑动面板弹出时调用。 |
| backgroundMask
<sup>
9+
</sup>
|
[
ResourceColor
](
../../ui/ts-types.md#resourcecolor8
)
|指定Panel的背景蒙层。|
-
PanelType枚举说明
| 名称 | 描述 |
## PanelType枚举说明
| -------- | -------- |
| Minibar | 提供minibar和类全屏展示切换效果。 |
| 名称 | 描述 |
| Foldable | 内容永久展示类,提供大(类全屏)、中(类半屏)、小三种尺寸展示切换效果。 |
| -------- | -------- |
| Temporary | 内容临时展示区,提供大(类全屏)、中(类半屏)两种尺寸展示切换效果。 |
| Minibar | 提供minibar和类全屏展示切换效果。 |
| Foldable | 内容永久展示类,提供大(类全屏)、中(类半屏)、小三种尺寸展示切换效果。 |
-
PanelMode枚举说明
| Temporary | 内容临时展示区,提供大(类全屏)、中(类半屏)两种尺寸展示切换效果。 |
| 名称 | 描述 |
| -------- | -------- |
## PanelMode枚举说明
| Mini | 类型为minibar和foldable时,为最小状态;类型为temporary,则不生效。 |
| Half | 类型为foldable和temporary时,为类半屏状态;类型为minibar,则不生效。 |
| 名称 | 描述 |
| Full | 类全屏状态。 |
| -------- | -------- |
| Mini | 类型为minibar和foldable时,为最小状态;类型为temporary,则不生效。 |
| Half | 类型为foldable和temporary时,为类半屏状态;类型为minibar,则不生效。 |
| Full | 类全屏状态。 |
## 事件
## 事件
| 名称 | 功能描述 |
| 名称 | 功能描述 |
| -------- | -------- |
| -------- | -------- |
| onChange(
callback:
(width:
number,
height:
number,
mode:
PanelMode)
=
>
void) | 当可滑动面板发生状态变化时触发,
返回的height值为内容区高度值,当dragbar属性为true时,panel本身的高度值为dragbar高度加上内容区高度。 |
| onChange(
event:
(width:
number,
height:
number,
mode:
PanelMode)
=
>
void) | 当可滑动面板发生状态变化时触发,
返回的height值为内容区高度值,当dragbar属性为true时,panel本身的高度值为dragbar高度加上内容区高度。 |
| onHeightChange(callback: (value: number) => void)
<sup>
9+
</sup>
|当可滑动面板发生高度变化时触发,返回的height值为内容区高度值,当dragbar属性为true时,panel本身的高度值为dragbar高度加上内容区高度。因用户体验设计原因,panel最高只能滑到 fullHeight-8vp |
| onHeightChange(callback: (value: number) => void)
<sup>
9+
</sup>
|当可滑动面板发生高度变化时触发,返回的height值为内容区高度值,当dragbar属性为true时,panel本身的高度值为dragbar高度加上内容区高度。因用户体验设计原因,panel最高只能滑到 fullHeight-8vp
。
|
## 示例
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-container-refresh.md
浏览文件 @
c6438ec8
...
@@ -3,11 +3,8 @@
...
@@ -3,11 +3,8 @@
可以进行页面下拉操作并显示刷新动效的容器组件。
可以进行页面下拉操作并显示刷新动效的容器组件。
> **说明:**
> **说明:**
> 该组件从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
>
> 该组件从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
## 权限列表
无
## 子组件
## 子组件
...
@@ -15,15 +12,15 @@
...
@@ -15,15 +12,15 @@
## 接口
## 接口
Refresh
\(
value:
\{
refreshing: boolean, offset?:
Length
, friction?: number | string
\}\)
Refresh
\(
value:
\{
refreshing: boolean, offset?:
number
|
string
, friction?: number | string
\}\)
-
参数
**参数:**
| 参数 | 参数名 | 必填 | 默认值
| 参数描述 |
| 参数 | 参数名 | 必填
| 参数描述 |
| --------
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| refreshing | boolean | 是 | -
| 当前组件是否正在刷新。
<br/>
该参数支持
[
$$
](
../../ui/ts-syntactic-sugar.md
)
双向绑定变量。 |
| refreshing | boolean | 是
| 当前组件是否正在刷新。
<br/>
该参数支持
[
$$
](
../../ui/ts-syntactic-sugar.md
)
双向绑定变量。 |
| offset | Length | 否 | 16 | 刷新组件静止时距离父组件顶部的距离。
|
| offset | string
\|
number | 否 | 刷新组件静止时距离父组件顶部的距离。
<br/>
默认值:16,单位vp
|
| friction | number
\|
string | 否 | 62 | 下拉摩擦系数,取值范围为0到100。
<br/>
-
0表示下拉刷新容器不跟随手势下拉而下拉。
<br/>
-
100表示下拉刷新容器紧紧跟随手势下拉而下拉。
<br/>
-
数值越大,下拉刷新容器跟随手势下拉的反应越灵敏。 |
| friction | number
\|
string | 否 | 下拉摩擦系数,取值范围为0到100。
<br/>
默认值:62
<br/>
-
0表示下拉刷新容器不跟随手势下拉而下拉。
<br/>
-
100表示下拉刷新容器紧紧跟随手势下拉而下拉。
<br/>
-
数值越大,下拉刷新容器跟随手势下拉的反应越灵敏。 |
...
@@ -32,18 +29,18 @@ Refresh\(value: \{ refreshing: boolean, offset?: Length, friction?: number | str
...
@@ -32,18 +29,18 @@ Refresh\(value: \{ refreshing: boolean, offset?: Length, friction?: number | str
| 名称 | 描述 |
| 名称 | 描述 |
| -------- | -------- |
| -------- | -------- |
| onStateChange(callback: (state: RefreshStatus) => void)| 当前刷新状态变更时,触发回调。
<br/>
state:刷新状态。 |
| onStateChange(callback: (state: RefreshStatus) => void)| 当前刷新状态变更时,触发回调。
<br/>
-
state:刷新状态。 |
| onRefreshing(callback: () => void)| 进入刷新状态时触发回调。 |
| onRefreshing(callback: () => void)| 进入刷新状态时触发回调。 |
-
RefreshStatus枚举说明
##
RefreshStatus枚举说明
| 名称 | 描述 |
| 名称 | 描述 |
| -------- | -------- |
| -------- | -------- |
| Inactive | 默认未下拉状态。 |
| Inactive | 默认未下拉状态。 |
| Drag | 下拉中,下拉距离小于刷新距离。 |
| Drag | 下拉中,下拉距离小于刷新距离。 |
| OverDrag | 下拉中,下拉距离超过刷新距离。 |
| OverDrag | 下拉中,下拉距离超过刷新距离。 |
| Refresh | 下拉结束,回弹至刷新距离,进入刷新状态。 |
| Refresh | 下拉结束,回弹至刷新距离,进入刷新状态。 |
| Done | 刷新结束,返回初始状态(顶部)。 |
| Done | 刷新结束,返回初始状态(顶部)。 |
## 示例
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-container-row.md
浏览文件 @
c6438ec8
# Row
# Row
> **说明:**
> 该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
沿水平方向布局容器。
沿水平方向布局容器。
> **说明:**
## 权限列表
>
> 该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
无
## 子组件
## 子组件
...
@@ -19,20 +14,21 @@
...
@@ -19,20 +14,21 @@
## 接口
## 接口
Row(value?:{space?: Length})
Row(value?:{space?: number
|
string })
**参数:**
-
参数
| 参数名 | 参数类型 | 必填 | 参数描述 |
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- | -------- |
| space | string
\|
number | 否 | 横向布局元素间距。
<br/>
默认值:0 |
| space | Length | 否 | 0 | 横向布局元素间距。 |
## 属性
## 属性
| 名称 | 参数类型 |
默认值 |
描述 |
| 名称 | 参数类型 | 描述 |
| -------- | -------- | -------- |
-------- |
| -------- | -------- | -------- |
| alignItems |
[
VerticalAlign
](
ts-appendix-enums.md#verticalalign
)
|
VerticalAlign.Center | 在垂直方向上子组件的对齐格式。
|
| alignItems |
[
VerticalAlign
](
ts-appendix-enums.md#verticalalign
)
|
设置子组件在垂直方向上的对齐格式。
<br/>
默认值:VerticalAlign.Center
|
| justifyContent
<sup>
8+
</sup>
|
[
FlexAlign
](
ts-appendix-enums.md#flexalign
)
|
FlexAlign.Start | 设置子组件在水平方向上的对齐格式。
|
| justifyContent
<sup>
8+
</sup>
|
[
FlexAlign
](
ts-appendix-enums.md#flexalign
)
|
设置子组件在水平方向上的对齐格式。
<br/>
FlexAlign.Start
|
## 示例
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-container-sidebarcontainer.md
浏览文件 @
c6438ec8
# SideBarContainer
# SideBarContainer
> **说明:**
> 该组件从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
提供侧边栏可以显示和隐藏的侧边栏容器,通过子组件定义侧边栏和内容区,第一个子组件表示侧边栏,第二个子组件表示内容区。
提供侧边栏可以显示和隐藏的侧边栏容器,通过子组件定义侧边栏和内容区,第一个子组件表示侧边栏,第二个子组件表示内容区。
> **说明:**
## 权限列表
>
> 该组件从API Version 8开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
无
## 子组件
## 子组件
...
@@ -21,52 +16,56 @@
...
@@ -21,52 +16,56 @@
SideBarContainer( type?: SideBarContainerType )
SideBarContainer( type?: SideBarContainerType )
-
参数
**参数:**
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| -------- | -------- | -------- | -------- | -------- |
| 参数名 | 参数类型 | 必填 | 参数描述 |
| type | SideBarContainerType | 否 | SideBarContainerType.Embed | 设置侧边栏的显示类型。 |
| -------- | -------- | -------- | -------- |
| type | SideBarContainerType | 否 | 设置侧边栏的显示类型。
<br/>
默认值:SideBarContainerType.Embed |
-
SideBarContainerType枚举说明
## SideBarContainerType枚举说明
| 名称 | 描述 |
| -------- | -------- |
| 名称 | 描述 |
| Embed | 侧边栏嵌入到组件内,侧边栏和内容区并列显示。 |
| -------- | -------- |
| Overlay | 侧边栏浮在内容区上面。 |
| Embed | 侧边栏嵌入到组件内,和内容区并列显示。 |
| Overlay | 侧边栏浮在内容区上面。 |
## 属性
## 属性
| 名称 | 参数类型 | 默认值 | 描述 |
| 名称 | 参数类型 | 描述 |
| -------- | -------- | -------- |
| showSideBar | boolean | 设置是否显示侧边栏。
<br/>
默认值:true |
| controlButton | ButtonStyle | 设置侧边栏控制按钮的属性。 |
| showControlButton | boolean | 设置是否显示控制按钮。
<br/>
默认值:true |
| sideBarWidth | number | 设置侧边栏的宽度。
<br/>
默认值:200,单位vp |
| minSideBarWidth | number | 设置侧边栏最小宽度。
<br/>
默认值:200,单位vp |
| maxSideBarWidth | number | 设置侧边栏最大宽度。
<br/>
默认值:280,单位vp |
| autoHide
<sup>
9+
</sup>
| boolean | 设置当侧边栏拖拽到小于最小宽度后,是否自动隐藏。
<br/>
默认值:true |
| sideBarPosition
<sup>
9+
</sup>
| SideBarPosition | 设置侧边栏显示位置。
<br/>
默认值:SideBarPosition.Start |
## ButtonStyle对象说明
| 名称 | 参数类型 | 必填 | 描述 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| showSideBar | boolean | true | 设置是否显示侧边栏。 |
| left | number | 否 | 设置侧边栏控制按钮距离容器左界限的间距。
<br/>
默认值:16,单位vp |
| controlButton | ButtonStyle | - | 设置侧边栏控制按钮的属性。 |
| top | number | 否 | 设置侧边栏控制按钮距离容器上界限的间距。
<br/>
默认值:48,单位vp |
| showControlButton | boolean | true | 设置是否显示控制按钮。 |
| width | number | 否 | 设置侧边栏控制按钮的宽度。
<br/>
默认值:32,单位vp |
| sideBarWidth | number
\|
[
Length<sup>9+</sup>
](
../../ui/ts-types.md#长度类型
)
| 200 | 设置侧边栏的宽度。 |
| height | number | 否 | 设置侧边栏控制按钮的高度。
<br/>
默认值:32,单位vp |
| minSideBarWidth | number
\|
[
Length<sup>9+</sup>
](
../../ui/ts-types.md#长度类型
)
| 200 | 设置侧边栏最小宽度。 |
| icons | {
<br/>
shown:
string
\|
PixelMap
\|
[
Resource
](
../../ui/ts-types.md
)
,
<br/>
hidden:
string
\|
PixelMap
\|
[
Resource
](
../../ui/ts-types.md
)
,
<br/>
switching?:
string
\|
PixelMap
\|
[
Resource
](
../../ui/ts-types.md
)
<br/>
} | 否 | 设置侧边栏控制按钮的图标:
<br/>
</p>
- shown: 设置侧边栏显示时控制按钮的图标。
<br>
- hidden: 设置侧边栏隐藏时控制按钮的图标。
<br>
- switching:设置侧边栏显示和隐藏状态切换时控制按钮的图标。 |
| maxSideBarWidth | number
\|
[
Length<sup>9+</sup>
](
../../ui/ts-types.md#长度类型
)
| 280 | 设置侧边栏最大宽度。 |
| autoHide
<sup>
9+
</sup>
| boolean | true | 设置当侧边栏拖拽到小于最小宽度后,是否自动隐藏。 |
## SideBarPosition<sup>9+</sup>枚举说明
| sideBarPosition
<sup>
9+
</sup>
| SideBarPosition | SideBarPosition.Start | 设置侧边栏显示位置。 |
| 名称 | 描述 |
-
ButtonStyle对象说明
| -------- | -------- |
| 名称 | 参数类型 | 必填 | 默认值 | 描述 |
| Start | 侧边栏位于容器左侧。 |
| -------- | -------- | -------- | -------- | -------- |
| End | 侧边栏位于容器右侧。 |
| left | number | 否 | 16 | 设置侧边栏控制按钮距离容器左界限的间距。 |
| top | number | 否 | 48 | 设置侧边栏控制按钮距离容器上界限的间距。 |
| width | number | 否 | 32 | 设置侧边栏控制按钮的宽度。 |
| height | number | 否 | 32 | 设置侧边栏控制按钮的高度。 |
| icons | {
<br/>
shown:
string
\|
PixelMap
\|
[
Resource
](
../../ui/ts-types.md
)
,
<br/>
hidden:
string
\|
PixelMap
\|
[
Resource
](
../../ui/ts-types.md
)
,
<br/>
switching?:
string
\|
PixelMap
\|
[
Resource
](
../../ui/ts-types.md
)
<br/>
} | 否 | - | 设置侧边栏控制按钮的图标:
<br/>
</p>
- shown: 设置侧边栏显示时控制按钮的图标。
<br>
- hidden: 设置侧边栏隐藏时控制按钮的图标。
<br>
- switching:设置侧边栏显示和隐藏状态切换时控制按钮的图标。 |
-
SideBarPosition
<sup>
9+
</sup>
枚举说明
| 名称 | 描述 |
| -------- | -------- |
| Start | 侧边栏位于容器左侧。 |
| End | 侧边栏位于容器右侧。 |
## 事件
## 事件
| 名称 | 功能描述 |
| 名称 | 功能描述 |
| -------- | -------- |
| -------- | -------- |
| onChange(callback: (value: boolean) =
>
void) | 当侧边栏的状态在显示和隐藏之间切换时触发回调。
<p>
value的true表示显示,false表示隐藏。|
| onChange(callback: (value: boolean) =
>
void) | 当侧边栏的状态在显示和隐藏之间切换时触发回调。
<p>
true表示显示,false表示隐藏。 |
## 示例
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-polygon.md
浏览文件 @
c6438ec8
# Polygon
# Polygon
> **说明:**
> 该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
多边形绘制组件。
多边形绘制组件。
> **说明:**
## 权限列表
>
> 该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
无
## 子组件
## 子组件
...
@@ -19,27 +14,23 @@
...
@@ -19,27 +14,23 @@
## 接口
## 接口
Polygon(value
:{options?: {width: Length, height: Length}
})
Polygon(value
?: {width: number
|
string , height: number
|
string
})
-
参数
**参数:**
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| -------- | -------- | -------- | -------- | -------- |
| options | Object | 否 | - | 见options参数说明。 |
-
options参数说明
| 参数名 | 参数类型 | 必填 | 参数描述 |
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- | -------- |
| width | string
\|
number | 是 | 宽度。 |
| width | Length | 是 | - | 宽度。 |
| height | string
\|
number | 是 | 高度。 |
| height | Length | 是 | - | 高度。 |
## 属性
## 属性
| 参数名称 | 参数类型 |
默认值 | 必填 | 参数描述 |
| 参数名称 | 参数类型 |
必填 | 参数描述 |
| -------- | -------- | -------- | -------- |
-------- |
| -------- | -------- | -------- | -------- |
| width |
Length | 0 | 否 | 多边形所在矩形的宽度。 |
| width |
string
\|
number | 否 | 多边形所在矩形的宽度。 |
| height |
Length | 0 | 否 | 多边形所在矩形的高度。 |
| height |
string
\|
number | 否 | 多边形所在矩形的高度。 |
| points | Array
<
Point
>
| - | 是 | 多边形的顶点坐标列表。 |
| points | Array
<
any
>
| 是 | 多边形的顶点坐标列表。 |
## 示例
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-polyline.md
浏览文件 @
c6438ec8
# Polyline
# Polyline
> **说明:**
> 该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
折线绘制组件。
折线绘制组件。
> **说明:**
## 权限列表
>
> 该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
无
## 子组件
## 子组件
...
@@ -19,27 +14,23 @@
...
@@ -19,27 +14,23 @@
## 接口
## 接口
Polyline(
options?: {width: Length, height: Length
})
Polyline(
value?: {width: number
|
string , height: number
|
string
})
-
参数
**参数:**
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| -------- | -------- | -------- | -------- | -------- |
| options | Object | 否 | - | 见options参数说明。 |
-
options参数说明
| 参数名 | 参数类型 | 必填 | 参数描述 |
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- | -------- |
| width | string
\|
number | 是 | 宽度。 |
| width | Length | 是 | - | 宽度。 |
| height | string
\|
number | 是 | 高度。 |
| height | Length | 是 | - | 高度。 |
## 属性
## 属性
| 参数名称 | 参数类型 |
默认值 | 必填 | 参数描述 |
| 参数名称 | 参数类型 |
必填 | 参数描述 |
| -------- | -------- | -------- | -------- |
-------- |
| -------- | -------- | -------- | -------- |
| width |
Length | 0 | 否 | 折线所在矩形的宽度。 |
| width |
[
Length
](
../../ui/ts-types.md#length
)
| 否 | 折线所在矩形的宽度。 |
| height |
Length | 0 | 否 | 折线所在矩形的高度。 |
| height |
[
Length
](
../../ui/ts-types.md#length
)
| 否 | 折线所在矩形的高度。 |
| points | Array
<
Point
>
|
- | 是 | 折线经过坐标点列表。 |
| points | Array
<
Point
>
|
是 | 折线经过坐标点列表。 |
## 示例
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-rect.md
浏览文件 @
c6438ec8
# Rect
# Rect
> **说明:**
> 该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
矩形绘制组件。
矩形绘制组件。
> **说明:**
## 权限列表
>
> 该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
无
## 子组件
## 子组件
...
@@ -19,32 +14,28 @@
...
@@ -19,32 +14,28 @@
## 接口
## 接口
Rect(value:{options?: {width:
Length,height: Length,radius?: Length | Array
<
Length
>
} | {width: Length,height: Length,radiusWidth?: Length,radiusHeight?: Length
}})
Rect(value:{options?: {width:
number
|
string ,height: number
|
string ,radius?: number
|
string | Array
<
Length
>
} | {width: number
|
string ,height: number
|
string ,radiusWidth?: number
|
string ,radiusHeight?: number
|
string
}})
-
参数
**参数:**
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| -------- | -------- | -------- | -------- | -------- |
| options | Object | 否 | - | 见options参数说明。 |
-
options参数说明
| 参数名 | 参数类型 | 必填 | 参数描述 |
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- | -------- |
| width | string
\|
number | 是 | 宽度。 |
| width | Length | 是 | - | 宽度。 |
| height | string
\|
number | 是 | 高度。 |
| height | Length | 是 | - | 高度。 |
| radius | string
\|
number
\|
Array
<
Length
>
| 否 | 圆角半径,支持分别设置四个角的圆角度数。 |
| radius | Length
\|
Array
<
Length
>
| 否 | 0 | 圆角半径,支持分别设置四个角的圆角度数。 |
| radiusWidth | string
\|
number | 否 | 圆角宽度。 |
| radiusWidth | Length | 否 | 0 | 圆角宽度。 |
| radiusHeight | string
\|
number | 否 | 圆角高度。 |
| radiusHeight | Length | 否 | 0 | 圆角高度。 |
## 属性
## 属性
| 参数名称 | 参数类型 |
默认值 | 必填 | 参数描述 |
| 参数名称 | 参数类型 |
必填 | 参数描述 |
| -------- | -------- | -------- | -------- |
-------- |
| -------- | -------- | -------- | -------- |
| width |
Length | 0 | 否 | 宽度。 |
| width |
[
Length
](
../../ui/ts-types.md#length
)
| 否 | 宽度。 |
| height |
Length | 0 | 否 | 高度。 |
| height |
[
Length
](
../../ui/ts-types.md#length
)
| 否 | 高度。 |
| radiusWidth |
Length | 0 | 否 | 圆角的宽度,仅设置宽时宽高一致。 |
| radiusWidth |
[
Length
](
../../ui/ts-types.md#length
)
| 否 | 圆角的宽度,仅设置宽时宽高一致。 |
| radiusHeight |
Length | 0 | 否 | 圆角的高度,仅设置高时宽高一致。 |
| radiusHeight |
[
Length
](
../../ui/ts-types.md#length
)
| 否 | 圆角的高度,仅设置高时宽高一致。 |
| radius |
Length
\|
Array
<
Length
>
| 0 | 否 | 圆角大小。 |
| radius |
[
Length
](
../../ui/ts-types.md#length
)
\|
Array
<
[Length](../../ui/ts-types.md#length)
>
| 否 | 圆角大小。 |
## 示例
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-drawing-components-shape.md
浏览文件 @
c6438ec8
# Shape
# Shape
> **说明:**
> 该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
绘制组件的父组件,父组件中会描述所有绘制组件均支持的通用属性。
绘制组件的父组件,父组件中会描述所有绘制组件均支持的通用属性。
1、绘制组件使用Shape作为父组件,实现类似SVG的效果。
1、绘制组件使用Shape作为父组件,实现类似SVG的效果。
2、绘制组件单独使用,用于在页面上绘制指定的图形。
2、绘制组件单独使用,用于在页面上绘制指定的图形。
> **说明:**
## 权限列表
>
> 该组件从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
无
## 子组件
## 子组件
...
@@ -25,29 +19,32 @@
...
@@ -25,29 +19,32 @@
## 接口
## 接口
Shape(value:{target?: PixelMap})
Shape(value?: PixelMap)
**参数:**
-
参数
| 参数名 | 参数类型 | 必填 | 参数描述 |
| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 |
| -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- | -------- |
| value | PixelMap | 否 | 绘制目标,可将图形绘制在指定的PixelMap对象中,若未设置,则在当前绘制目标中进行绘制。 |
| target | PixelMap | 否 | null | 绘制目标,可将图形绘制在指定的PixelMap对象中,若未设置,则在当前绘制目标中进行绘制。 |
## 属性
## 属性
| 参数名称 | 参数类型 | 默认值 | 必填 | 参数描述 |
| 参数名称 | 参数类型 | 必填 | 参数描述 |
| -------- | -------- | -------- | -------- | -------- |
| -------- | -------- | -------- | -------- |
| viewPort | {
<br/>
x:
Length,
<br/>
y:
Length,
<br/>
width:
Length,
<br/>
height:
Length
<br/>
} | - | 是 | 形状的视口。 |
| viewPort | {
<br/>
x:
string
\|
number,
<br/>
y:
string
\|
number,
<br/>
width:
string
\|
number,
<br/>
height:
string
\|
number
<br/>
} | 是 | 形状的视口。 |
| fill |
[
ResourceColor
](
../../ui/ts-types.md
)
| Black | 否 | 填充颜色。 |
| fill |
[
ResourceColor
](
../../ui/ts-types.md
)
| 否 | 填充颜色。
<br/>
默认值:Color.Black |
| stroke |
[
ResourceColor
](
../../ui/ts-types.md
)
| - | 否 | 边框颜色。 |
| fillOpacity | string
\|
number
\|
[
Resource
](
../../ui/ts-types.md#resource类型
)
| | |
| strokeDashArray | Array
<
Length
>
| [] | 否 | 设置边框的间隙。 |
| stroke |
[
ResourceColor
](
../../ui/ts-types.md
)
| 否 | 边框颜色。 |
| strokeDashOffset | Length | 0 | 否 | 边框绘制起点的偏移量。 |
| strokeDashArray | Array
<
Length
>
| 否 | 设置边框的间隙。 |
| strokeLineCap |
[
LineCapStyle
](
ts-appendix-enums.md#linecapstyle
)
| LineCapStyle.Butt | 否 | 路径端点绘制样式。 |
| strokeDashOffset | Length | 否 | 边框绘制起点的偏移量。 |
| strokeLineJoin |
[
LineJoinStyle
](
ts-appendix-enums.md#linejoinstyle
)
| LineJoinStyle.Miter | 否 | 边框拐角绘制样式。 |
| strokeLineCap |
[
LineCapStyle
](
ts-appendix-enums.md#linecapstyle
)
| 否 | 路径端点绘制样式。
<br/>
默认值:LineCapStyle.Butt |
| strokeMiterLimit | number
\|
string | 4 | 否 | 锐角绘制成斜角的极限值。 |
| strokeLineJoin |
[
LineJoinStyle
](
ts-appendix-enums.md#linejoinstyle
)
| 否 | 边框拐角绘制样式。
<br/>
默认值:LineJoinStyle.Miter |
| strokeOpacity | number
\|
string
\|
[
Resource
](
../../ui/ts-types.md#resource类型
)
| 1 | 否 | 设置边框的不透明度。 |
| strokeMiterLimit | number
\|
string | 否 | 锐角绘制成斜角的极限值。
<br/>
默认值:4 |
| strokeWidth | Length | 1 | 否 | 设置边框的宽度。 |
| strokeOpacity | number
\|
string
\|
[
Resource
](
../../ui/ts-types.md#resource类型
)
| 否 | 设置边框的不透明度。
<br/>
默认值:1 |
| antiAlias | boolean | true | 否 | 是否开启抗锯齿。 |
| strokeWidth | Length | 否 | 设置边框的宽度。
<br/>
默认值:1 |
| antiAlias | boolean | 否 | 是否开启抗锯齿。
<br/>
默认值:true |
| mesh
<sup>
8+
</sup>
| Array
<
number
>
,number,number | 否 | 设置mesh效果。第一个参数为长度(column+1)
*(row+1)*
2的数组,它记录了扭曲后的位图和各个顶点位置,第二个参数为mesh矩阵列数column,第三个参数为mesh矩阵行数row。 |
## 示例
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-explicit-animation.md
浏览文件 @
c6438ec8
...
@@ -8,10 +8,10 @@
...
@@ -8,10 +8,10 @@
| 接口名称 | 功能描述 |
| 接口名称 | 功能描述 |
| ------------------------------------------------------------ | ------------------------------------------------------------ |
| ------------------------------------------------------------ | ------------------------------------------------------------ |
| animateTo(value:
[Animat
ionOptions](#animationoptions
对象说明),
event:
()=
>
void)
:
void | 提供全局animateTo显式动画接口来指定由于闭包代码导致的状态变化插入过渡动效。
<br/>
event指定显示动效的闭包函数,在闭包函数中导致的状态变化系统会自动插入过渡动画。 |
| animateTo(value:
[Animat
eParam](#animateparam
对象说明),
event:
()=
>
void)
:
void | 提供全局animateTo显式动画接口来指定由于闭包代码导致的状态变化插入过渡动效。
<br/>
event指定显示动效的闭包函数,在闭包函数中导致的状态变化系统会自动插入过渡动画。 |
## Animat
ionOptions
对象说明
## Animat
eParam
对象说明
-
属性
-
属性
| 属性名称 | 属性类型 | 默认值 | 描述 |
| 属性名称 | 属性类型 | 默认值 | 描述 |
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录