Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
694a0e3c
D
Docs
项目概览
OpenHarmony
/
Docs
1 年多 前同步成功
通知
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看板
提交
694a0e3c
编写于
3月 30, 2023
作者:
Y
yamila
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
Specification synchronization5
Signed-off-by:
N
yamila
<
tianyu55@huawei.com
>
上级
736478cb
变更
18
隐藏空白更改
内联
并排
Showing
18 changed file
with
148 addition
and
98 deletion
+148
-98
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-blank.md
...ation-dev/reference/arkui-ts/ts-basic-components-blank.md
+6
-2
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-divider.md
...ion-dev/reference/arkui-ts/ts-basic-components-divider.md
+2
-2
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-navdestination.md
.../reference/arkui-ts/ts-basic-components-navdestination.md
+12
-5
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-navigation.md
...-dev/reference/arkui-ts/ts-basic-components-navigation.md
+8
-8
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-navrouter.md
...n-dev/reference/arkui-ts/ts-basic-components-navrouter.md
+11
-3
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-plugincomponent.md
...reference/arkui-ts/ts-basic-components-plugincomponent.md
+7
-0
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-progress.md
...on-dev/reference/arkui-ts/ts-basic-components-progress.md
+7
-2
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-select.md
...tion-dev/reference/arkui-ts/ts-basic-components-select.md
+13
-11
zh-cn/application-dev/reference/arkui-ts/ts-container-alphabet-indexer.md
...n-dev/reference/arkui-ts/ts-container-alphabet-indexer.md
+2
-2
zh-cn/application-dev/reference/arkui-ts/ts-container-badge.md
.../application-dev/reference/arkui-ts/ts-container-badge.md
+27
-15
zh-cn/application-dev/reference/arkui-ts/ts-container-grid.md
...n/application-dev/reference/arkui-ts/ts-container-grid.md
+1
-1
zh-cn/application-dev/reference/arkui-ts/ts-container-list.md
...n/application-dev/reference/arkui-ts/ts-container-list.md
+1
-1
zh-cn/application-dev/reference/arkui-ts/ts-container-panel.md
.../application-dev/reference/arkui-ts/ts-container-panel.md
+13
-7
zh-cn/application-dev/reference/arkui-ts/ts-container-refresh.md
...pplication-dev/reference/arkui-ts/ts-container-refresh.md
+4
-0
zh-cn/application-dev/reference/arkui-ts/ts-container-sidebarcontainer.md
...n-dev/reference/arkui-ts/ts-container-sidebarcontainer.md
+1
-1
zh-cn/application-dev/reference/arkui-ts/ts-container-swiper.md
...application-dev/reference/arkui-ts/ts-container-swiper.md
+28
-33
zh-cn/application-dev/reference/arkui-ts/ts-container-tabcontent.md
...ication-dev/reference/arkui-ts/ts-container-tabcontent.md
+1
-1
zh-cn/application-dev/reference/arkui-ts/ts-page-transition-animation.md
...on-dev/reference/arkui-ts/ts-page-transition-animation.md
+4
-4
未找到文件。
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-blank.md
浏览文件 @
694a0e3c
...
...
@@ -22,7 +22,7 @@ Blank(min?: number | string)
| 参数名 | 参数类型 | 必填 | 参数描述 |
| -------- | -------- | -------- | -------- |
| min | number
\|
string | 否 | 空白填充组件在容器主轴上的最小大小。
<br/>
默认值:0 |
| min | number
\|
string | 否 | 空白填充组件在容器主轴上的最小大小。
<br/>
默认值:0
<br/>
**说明:**
<br/>
不支持设置百分比。负值使用默认值。当最小值大于容器可用空间时,使用最小值作为自身大小并超出容器。
|
## 属性
...
...
@@ -30,10 +30,14 @@ Blank(min?: number | string)
| 名称 | 参数类型 | 描述 |
| -------- | -------- | -------- |
| color |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 设置空白填充的填充颜色。
<br/>
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
| color |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 设置空白填充的填充颜色。
<br/>
<br/>
默认值:Color.Transparent
<br/>
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
## 事件
支持
[
通用事件
](
ts-universal-events-click.md
)
。
## 示例
### 示例1
Blank组件在横竖屏占满空余空间效果。
```
ts
...
...
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-divider.md
浏览文件 @
694a0e3c
...
...
@@ -25,8 +25,8 @@ Divider()
| 名称 | 参数类型 | 描述 |
| ----------- | ---------- | ------------------ |
| vertical | boolean | 使用水平分割线还是垂直分割线。false:水平分割线;true:垂直分割线。
<br/>
默认值:false
<br/>
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
| color |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 分割线颜色。
<br/>
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
| strokeWidth | number
\|
string | 分割线宽度。
<br/>
默认值:1
<br/>
从API version 9开始,该接口支持在ArkTS卡片中使用。
<br/>
**说明:**
<br>
分割线的宽度不支持百分比设置
。 |
| color |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 分割线颜色。
<br/>
默认值:'
\#
33182431'
<br/>
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
| strokeWidth | number
\|
string | 分割线宽度。
<br/>
默认值:1
<br/>
单位:vp
<br/>
从API version 9开始,该接口支持在ArkTS卡片中使用。
<br/>
**说明:**
<br>
分割线的宽度不支持百分比设置。优先级低于
[
通用属性height
](
ts-universal-attributes-size.md
)
,超过通用属性设置大小时,按照通用属性进行裁切
。 |
| lineCap |
[
LineCapStyle
](
ts-appendix-enums.md#linecapstyle
)
| 分割线的端点样式。
<br/>
默认值:LineCapStyle.Butt
<br/>
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
...
...
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-navdestination.md
浏览文件 @
694a0e3c
...
...
@@ -9,7 +9,10 @@
## 子组件
可以包含子组件。
> **说明:**
>
> - 子组件类型:系统组件和自定义组件,支持渲染控制类型([if/else](../../quick-start/arkts-rendering-control.md#条件渲染)、[ForEach](../../quick-start/arkts-rendering-control.md#循环渲染)和[LazyForEach](../../quick-start/arkts-rendering-control.md#数据懒加载))。
> - 子组件个数:多个。
## 接口
...
...
@@ -21,7 +24,11 @@ NavDestination()
仅支持
[
backgroundColor
](
ts-universal-attributes-background.md
)
通用属性。
| 名称 | 参数类型 | 描述 |
| -------------- | ---------------------------------------- | ---------------------------------------- |
| title | string
\|
[CustomBuilder](ts-types.md#custombuilder8)
\|
[NavigationCommonTitle](ts-basic-components-navigation.md#navigationcommontitle类型说明)
\|
[
NavigationCustomTitle
](
ts-basic-components-navigation.md##navigationcustomtitle类型说明
)
| 页面标题。 |
| hideTitleBar | boolean | 是否显示标题栏。
<br/>
默认值:false
<br/>
true:
隐藏标题栏。
<br/>
false:
显示标题栏。 |
\ No newline at end of file
| 名称 | 参数类型 | 描述 |
| ------------ | ------------------------------------------------------------ | ------------------------------------------------------------ |
| title | string
\|
[CustomBuilder](ts-types.md#custombuilder8)
\|
[NavigationCommonTitle](ts-basic-components-navigation.md#navigationcommontitle类型说明)
\|
[
NavigationCustomTitle
](
ts-basic-components-navigation.md##navigationcustomtitle类型说明
)
| 页面标题。
<br/>
**说明:**
<br/>
使用NavigationCustomTitle类型设置height高度时,titleMode属性不会生效。
<br/>
字符串超长时,如果不设置副标题,先缩小再换行2行后以...截断。如果设置副标题,先缩小后以...截断。 |
| hideTitleBar | boolean | 是否显示标题栏。
<br/>
默认值:false
<br/>
true:
隐藏标题栏。
<br/>
false:
显示标题栏。 |
## 事件
支持
[
通用事件
](
ts-universal-events-click.md
)
。
\ No newline at end of file
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-navigation.md
浏览文件 @
694a0e3c
...
...
@@ -23,17 +23,17 @@ Navigation()
| 名称 | 参数类型 | 描述 |
| -------------- | ---------------------------------------- | ---------------------------------------- |
| title |
[
ResourceStr
](
ts-types.md#resourcestr
)
<sup>
10+
</sup>
\|
[CustomBuilder](ts-types.md#custombuilder8)
<sup>
8+
</sup>
\|
[NavigationCommonTitle](#navigationcommontitle类型说明)
<sup>
9+
</sup>
\|
[
NavigationCustomTitle
](
#navigationcustomtitle类型说明
)
<sup>
9+
</sup>
| 页面标题。
|
| subTitle
<sup>
deprecated
</sup>
| string | 页面副标题。
从API Version 9开始废弃,建议使用title代替。
|
| menus | Array
<
[
NavigationMenuItem
](
#navigationmenuitem类型说明
)&
gt
;&
nbsp
;\|&
nbsp
;[
CustomBuilder
](
ts-types.md#custombuilder8
)<
sup
>
8+
</sup>
| 页面右上角菜单。
使用Array<
[
NavigationMenuItem
](
#navigationmenuitem类型说明
)
>
写法时,竖屏最多支持显示3个图标,横屏最多支持显示5个图标,多余的图标会被放入自动生成的更多图标。
|
| title |
[
ResourceStr
](
ts-types.md#resourcestr
)
<sup>
10+
</sup>
\|
[CustomBuilder](ts-types.md#custombuilder8)
<sup>
8+
</sup>
\|
[NavigationCommonTitle](#navigationcommontitle类型说明)
<sup>
9+
</sup>
\|
[
NavigationCustomTitle
](
#navigationcustomtitle类型说明
)
<sup>
9+
</sup>
| 页面标题。
<br/>
**说明:**
<br/>
使用NavigationCustomTitle类型设置height高度时,titleMode属性不会生效。
<br/>
字符串超长时,如果不设置副标题,先缩小再换行(2行)最后...截断。如果设置副标题,先缩小最后...截断。
|
| subTitle
<sup>
deprecated
</sup>
| string | 页面副标题。
不设置时不显示副标题。从API Version 9开始废弃,建议使用title代替。
|
| menus | Array
<
[
NavigationMenuItem
](
#navigationmenuitem类型说明
)&
gt
;&
nbsp
;\|&
nbsp
;[
CustomBuilder
](
ts-types.md#custombuilder8
)<
sup
>
8+
</sup>
| 页面右上角菜单。
不设置时不显示菜单项。使用Array<
[
NavigationMenuItem
](
#navigationmenuitem类型说明
)
>
写法时,竖屏最多支持显示3个图标,横屏最多支持显示5个图标,多余的图标会被放入自动生成的更多图标。
|
| titleMode |
[
NavigationTitleMode
](
#navigationtitlemode枚举说明
)
| 页面标题栏显示模式。
<br/>
默认值:NavigationTitleMode.Free |
| toolBar |
[
object
](
#object类型说明
)
\|
[
CustomBuilder
](
ts-types.md#custombuilder8
)
<sup>
8+
</sup>
| 设置工具栏内容。
<br/>
items:
工具栏所有项。
|
| toolBar |
[
object
](
#object类型说明
)
\|
[
CustomBuilder
](
ts-types.md#custombuilder8
)
<sup>
8+
</sup>
| 设置工具栏内容。
不设置时不显示工具栏。
<br/>
items:
工具栏所有项。
<br/>
**说明:**
<br/>
items均分底部工具栏,在每个均分内容区布局文本和图标,文本超长时,逐级缩小,缩小之后换行,最后...截断。
|
| hideToolBar | boolean | 隐藏工具栏。
<br/>
默认值:false
<br/>
true:
隐藏工具栏。
<br/>
false:
显示工具栏。 |
| hideTitleBar | boolean | 隐藏标题栏。
<br/>
默认值:false
<br/>
true:
隐藏标题栏。
<br/>
false:
显示标题栏。 |
| hideBackButton | boolean | 隐藏返回键。
<br/>
默认值:false
<br/>
true:
隐藏返回键。
<br/>
false:
显示返回键。
<br>
不支持隐藏NavDestination组件标题栏中的返回图标。|
| navBarWidth
<sup>
9+
</sup>
|
[
Length
](
ts-types.md#length
)
| 导航栏宽度。
<br/>
默认值:200
vp
|
| navBarPosition
<sup>
9+
</sup>
|
[
NavBarPosition
](
#navbarposition枚举说明
)
| 导航栏位置。
<br/>
默认值:NavBarPosition.Start |
| mode
<sup>
9+
</sup>
|
[
NavigationMode
](
#navigationmode枚举说明
)
| 导航栏的显示模式。
<br/>
默认值:NavigationMode.Auto |
| hideBackButton | boolean | 隐藏返回键。
<br/>
默认值:false
<br/>
true:
隐藏返回键。
<br/>
false:
显示返回键。
<br>
不支持隐藏NavDestination组件标题栏中的返回图标。
<br/>
**说明:**
<br/>
返回键键仅针对titleMode为NavigationTitleMode.Mini时才生效。
|
| navBarWidth
<sup>
9+
</sup>
|
[
Length
](
ts-types.md#length
)
| 导航栏宽度。
<br/>
默认值:200
<br/>
单位:vp
<br/>
**说明:**
<br/>
仅在Navigation组件分栏时生效。
|
| navBarPosition
<sup>
9+
</sup>
|
[
NavBarPosition
](
#navbarposition枚举说明
)
| 导航栏位置。
<br/>
默认值:NavBarPosition.Start
<br/>
**说明:**
<br/>
仅在Navigation组件分栏时生效。
|
| mode
<sup>
9+
</sup>
|
[
NavigationMode
](
#navigationmode枚举说明
)
| 导航栏的显示模式。
<br/>
默认值:NavigationMode.Auto
<br/>
自适应:基于组件宽度自适应单栏和双栏。
|
| backButtonIcon
<sup>
9+
</sup>
| string
\|
[PixelMap](../apis/js-apis-image.md#pixelmap7)
\|
[
Resource
](
ts-types.md#resource
)
| 设置导航栏返回图标。不支持隐藏NavDestination组件标题栏中的返回图标。|
| hideNavBar
<sup>
9+
</sup>
| boolean | 是否显示导航栏(仅在mode为NavigationMode.Split时生效)。 |
...
...
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-navrouter.md
浏览文件 @
694a0e3c
...
...
@@ -10,6 +10,14 @@
必须包含两个子组件,其中第二个子组件必须为
[
NavDestination
](
ts-basic-components-navdestination.md
)
。
> **说明:**
>
> 子组件个数异常时:
> 1. 有且仅有1个时,触发路由到NavDestination的能力失效。
> 2. 有且仅有1个时,且使用NavDestination场景下,不进行路由。
> 3. 大于2个时,后续的子组件不显示。
> 4. 第二个子组件不为NavDestination时,触发路由功能失效。
## 接口
NavRouter()
...
...
@@ -17,9 +25,9 @@ NavRouter()
## 事件
| 名称
| 功能描述
|
| ----------------------------------------
|
---------------------------------------- |
| onStateChange(callback: (isActivated: boolean) => void) | 组件激活状态切换时触发该回调。返回值isActivated为true时表示激活,为false时表示未激活。
<
/br>
**说明:**
用户点击NavRouter,激活NavRouter,加载对应的NavDestination子组件时,回调onStateChange(true);NavRouter对应的NavDestination子组件不再显示时,回调onStateChange(false)。
|
| 名称
| 功能描述
|
| ----------------------------------------
--------------- | --------------------
---------------------------------------- |
| onStateChange(callback: (isActivated: boolean) => void) | 组件激活状态切换时触发该回调。返回值isActivated为true时表示激活,为false时表示未激活。
<
br/>
**说明:**
<br/>
开发者点击激活NavRouter,加载对应的NavDestination子组件时,回调onStateChange(true)。NavRouter对应的NavDestination子组件不再显示时,回调onStateChange(false)。
|
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-plugincomponent.md
浏览文件 @
694a0e3c
...
...
@@ -31,9 +31,16 @@ PluginComponent(value: { template: PluginComponentTemplate, data: KVObject})
| source | string | 组件模板名。 |
| bundleName | string | 提供者Ability的bundleName。 |
## 属性
除支持
[
通用属性size
](
ts-universal-attributes-size.md
)
,且必须设置size。
## 事件
仅支持
[
手势事件
](
ts-gesture-settings.md
)
分发给提供方页面,并在提供方页面内部处理。
除支持
[
通用事件
](
ts-universal-events-click.md
)
,还支持以下事件:
| 名称 | 功能描述 |
| ------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------- |
| onComplete(callback:
()
=
>
void) | 组件加载完成回调。 |
...
...
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-progress.md
浏览文件 @
694a0e3c
...
...
@@ -55,13 +55,18 @@ Progress(options: {value: number, total?: number, type?: ProgressType})
## 属性
除支持
[
通用属性
](
ts-universal-attributes-size.md
)
外,还支持以下属性:
| 名称 | 参数类型 | 描述 |
| -------- | -------- | -------- |
| value | number | 设置当前进度值。设置小于0的数值时置为0,设置大于total的数值时置为total。非法数值不生效。
<br/>
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
| color |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 设置进度条前景色。
<br/>
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
| backgroundColor |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 设置进度条底色。
<br/>
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
| color |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 设置进度条前景色。
<br/>
默认值:'
\#
ff007dff'
<br/>
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
| backgroundColor |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 设置进度条底色。
<br/>
默认值:'
\#
19182431'
<br/><br/>
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
| style
<sup>
8+
</sup>
| {
<br/>
strokeWidth?:
[Length](ts-types.md#length),
<br/>
scaleCount?:
number,
<br/>
scaleWidth?:
[
Length
](
ts-types.md#length
)
<br/>
} | 定义组件的样式。
<br/>
-
strokeWidth:
设置进度条宽度(不支持百分比设置)。从API version9开始,环形进度条设置宽度大于等于半径时,默认修改宽度至半径值的二分之一。
<br/>
默认值:4.0Vp
<br/>
-
scaleCount:
设置环形进度条总刻度数。
<br>
默认值:120
<br/>
-
scaleWidth:
设置环形进度条刻度粗细(不支持百分比设置),刻度粗细大于进度条宽度时,为系统默认粗细。
<br>
默认值:2.0Vp
<br/>
从API version 9开始,该接口支持在ArkTS卡片中使用。 |
## 事件
支持
[
通用事件
](
ts-universal-events-click.md
)
。
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-select.md
浏览文件 @
694a0e3c
...
...
@@ -23,20 +23,22 @@ Select(options: Array\<[SelectOption](#selectoption对象说明)\>)
## 属性
除支持
[
通用属性
](
ts-universal-attributes-size.md
)
外,还支持以下属性:
| 名称 | 参数类型 | 描述 |
| ----------------------- | ------------------------------------- | --------------------------------------------- |
| selected | number | 设置下拉菜单初始选项的索引,第一项的索引为0。
<br>
当不设置selected属性时,默认选择值为-1,菜单项不选中。 |
| value | string | 设置下拉按钮本身的文本内容。
|
| font |
[
Font
](
ts-types.md#font
)
| 设置下拉按钮本身的文本样式。
|
| fontColor |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 设置下拉按钮本身的文本颜色。
|
| selectedOptionBgColor |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 设置下拉菜单选中项的背景色。
|
| selectedOptionFont |
[
Font
](
ts-types.md#font
)
| 设置下拉菜单选中项的文本样式。
|
| selectedOptionFontColor |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 设置下拉菜单选中项的文本颜色。
|
| optionBgColor |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 设置下拉菜单项的背景色。
|
| optionFont |
[
Font
](
ts-types.md#font
)
| 设置下拉菜单项的文本样式。
|
| optionFontColor |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 设置下拉菜单项的文本颜色。
|
| space
<sup>
10+
</sup>
|
[
Length
](
ts-types.md#length
)
| 设置下拉菜单项的文本与箭头之间的间距。
|
| arrowPosition
<sup>
10+
</sup>
|
[
ArrowPosition
](
#arrowposition10枚举说明
)
| 设置下拉菜单项的文本与箭头之间的对齐方式。
|
| value | string | 设置下拉按钮本身的文本内容。
当菜单选中时默认会替换为菜单项文本内容。
|
| font |
[
Font
](
ts-types.md#font
)
| 设置下拉按钮本身的文本样式。
<br/>
默认值:
<br/>
{
<br/>
size:
'16fp',
<br/>
weight:
FontWeight.Medium
<br/>
}
|
| fontColor |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 设置下拉按钮本身的文本颜色。
<br/>
默认值:'
\#
E6FFFFFF'
|
| selectedOptionBgColor |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 设置下拉菜单选中项的背景色。
<br/>
默认值:'
\#
33007DFF'
|
| selectedOptionFont |
[
Font
](
ts-types.md#font
)
| 设置下拉菜单选中项的文本样式。
<br/>
默认值:
<br/>
{
<br/>
size:
'16fp',
<br/>
weight:
FontWeight.Regular
<br/>
}
|
| selectedOptionFontColor |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 设置下拉菜单选中项的文本颜色。
<br/>
默认值:'
\#
ff007dff'
|
| optionBgColor |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 设置下拉菜单项的背景色。
<br/>
默认值:'
\#
ffffffff'
|
| optionFont |
[
Font
](
ts-types.md#font
)
| 设置下拉菜单项的文本样式。
<br/>
默认值:
<br/>
{
<br/>
size:
'16fp',
<br/>
weight:
FontWeight.Regular
<br/>
}
|
| optionFontColor |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 设置下拉菜单项的文本颜色。
<br/>
默认值:'
\#
ff182431'
|
| space
<sup>
10+
</sup>
|
[
Length
](
ts-types.md#length
)
| 设置下拉菜单项的文本与箭头之间的间距。
<br/>
**说明:**
<br/>
不支持设置百分比。
|
| arrowPosition
<sup>
10+
</sup>
|
[
ArrowPosition
](
#arrowposition10枚举说明
)
| 设置下拉菜单项的文本与箭头之间的对齐方式。
<br/>
默认值:ArrowPosition.END
|
## ArrowPosition<sup>10+</sup>枚举说明
...
...
zh-cn/application-dev/reference/arkui-ts/ts-container-alphabet-indexer.md
浏览文件 @
694a0e3c
...
...
@@ -38,7 +38,7 @@ AlphabetIndexer(value: {arrayValue: Array<string>, selected: number})
| selectedFont |
[
Font
](
ts-types.md#font
)
| 设置选中项文字样式。
<br/>
默认值:
<br/>
{
<br/>
size:10,
<br/>
style:FontStyle.Normal,
<br/>
weight:FontWeight.Normal,
<br/>
family:'HarmonyOS Sans'
<br/>
} |
| popupFont |
[
Font
](
ts-types.md#font
)
| 设置提示弹窗字体样式。
<br/>
默认值:
<br/>
{
<br/>
size:10,
<br/>
style:FontStyle.Normal,
<br/>
weight:FontWeight.Normal,
<br/>
family:'HarmonyOS Sans'
<br/>
} |
| font |
[
Font
](
ts-types.md#font
)
| 设置字母索引条默认字体样式。
<br/>
默认值:
<br/>
{
<br/>
size:10,
<br/>
style:FontStyle.Normal,
<br/>
weight:FontWeight.Normal,
<br/>
family:'HarmonyOS Sans'
<br/>
} |
| itemSize | string
\|
number | 设置字母索引条字母区域大小,字母区域为正方形,即正方形边长。不支持设置为百分比。
<br/>
默认值:24.0
。
|
| itemSize | string
\|
number | 设置字母索引条字母区域大小,字母区域为正方形,即正方形边长。不支持设置为百分比。
<br/>
默认值:24.0
<br/>
单位:vp
|
| alignStyle | value:
[
IndexerAlign
](
#indexeralign枚举说明
)
,
<br/>
offset
<sup>
10+
</sup>
?:
[
Length
](
ts-types.md#length
)
| value:设置字母索引条弹框的对齐样式,支持弹窗显示在索引条右侧和左侧。
<br/>
默认值: IndexerAlign.Right。
<br/>
offset:设置提示弹窗与索引条之间间距,大于等于0为有效值,在不设置或设置为小于0的情况下间距与popupPosition.x相同。 |
| selected | number | 设置选中项索引值。
<br/>
默认值:0。 |
| popupPosition |
[
Position
](
ts-types.md#position8
)
| 设置弹出窗口相对于索引器条上边框中点的位置。
<br/>
默认值:{x:96.0, y:48.0}。 |
...
...
@@ -56,7 +56,7 @@ AlphabetIndexer(value: {arrayValue: Array<string>, selected: number})
## 事件
仅
支持以下事件:
除支持
[
通用事件
](
ts-universal-events-click.md
)
外,还
支持以下事件:
| 名称 | 功能描述 |
| -------- | -------- |
...
...
zh-cn/application-dev/reference/arkui-ts/ts-container-badge.md
浏览文件 @
694a0e3c
...
...
@@ -11,6 +11,10 @@
支持单个子组件。
> **说明:**
>
> 子组件类型:系统组件和自定义组件,支持渲染控制类型([if/else](../../quick-start/arkts-rendering-control.md#条件渲染)、[ForEach](../../quick-start/arkts-rendering-control.md#循环渲染)和[LazyForEach](../../quick-start/arkts-rendering-control.md#数据懒加载))。
## 接口
...
...
@@ -22,12 +26,12 @@
**参数:**
| 参数名 | 参数类型 | 必填 |
默认值 |
参数描述 |
| -------- | -------- | -------- | -------- |
-------- |
| count | number | 是 |
- | 设置提醒消息数
。 |
| position |
[
BadgePosition
](
#badgeposition枚举说明
)
| 否 |
BadgePosition.RightTop | 设置提示点显示位置。
|
| maxCount | number | 否 |
99 | 最大消息数,超过最大消息时仅显示maxCount+。
|
| style |
[
BadgeStyle
](
#badgestyle对象说明
)
| 是 |
- |
Badge组件可设置样式,支持设置文本颜色、尺寸、圆点颜色和尺寸。 |
| 参数名 | 参数类型 | 必填 | 参数描述 |
| -------- | -------- | -------- | -------- |
| count | number | 是 |
设置提醒消息数。
<br/>
**说明:**
<br/>
小于等于0时不显示信息标记
。 |
| position |
[
BadgePosition
](
#badgeposition枚举说明
)
| 否 |
设置提示点显示位置。
<br/>
默认值:BadgePosition.RightTop
|
| maxCount | number | 否 |
最大消息数,超过最大消息时仅显示maxCount+。
<br/>
默认值:99
|
| style |
[
BadgeStyle
](
#badgestyle对象说明
)
| 是 | Badge组件可设置样式,支持设置文本颜色、尺寸、圆点颜色和尺寸。 |
**方法2:**
Badge(value: {value: string, position?: BadgePosition, style: BadgeStyle})
...
...
@@ -57,15 +61,23 @@
从API version 9开始,该接口支持在ArkTS卡片中使用。
| 名称 | 类型 | 必填 | 默认值 | 描述 |
| ------------------------- | ------------------------------------------------------------ | ---- | ----------------- | ------------------------------------------------------------ |
| color |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 否 | Color.White | 文本颜色。 |
| fontSize | number
\|
string | 否 | 10 | 文本大小,单位vp。 |
| badgeSize | number
\|
string | 否 | 16 | Badge的大小,单位vp。不支持百分比形式设置。当设置为非法值时,按照默认值处理。 |
| badgeColor |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 否 | Color.Red | Badge的颜色。 |
| fontWeight
<sup>
10+
</sup>
| number
\|
[
FontWeight
](
ts-appendix-enums.md#fontweight
)
\|
string | 否 | FontWeight.Normal | 设置文本的字体粗细。 |
| borderColor
<sup>
10+
</sup>
|
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 否 | Color.Red | 底板描边颜色。 |
| borderWidth
<sup>
10+
</sup>
|
[
Length
](
ts-types.md#length
)
| 否 | 1.0vp | 底板描边粗细。 |
| 名称 | 类型 | 必填 | 描述 |
| ------------------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| color |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 否 | 文本颜色。
<br/>
默认值:Color.White |
| fontSize | number
\|
string | 否 | 文本大小。
<br/>
默认值:10
<br/>
单位:vp
<br/>
**说明:**
<br/>
不支持设置百分比。 |
| badgeSize | number
\|
string | 否 | Badge的大小。
<br/>
默认值:16
<br/>
单位:vp
<br/>
**说明:**
<br/>
不支持设置百分比。当设置为非法值时,按照默认值处理。 |
| badgeColor |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 否 | Badge的颜色。
<br/>
默认值:Color.Red |
| fontWeight
<sup>
10+
</sup>
| number
\|
[
FontWeight
](
ts-appendix-enums.md#fontweight
)
\|
string | 否 | 设置文本的字体粗细。
<br/>
默认值:FontWeight.Normal
<br/>
**说明:**
<br/>
不支持设置百分比。 |
| borderColor
<sup>
10+
</sup>
|
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 否 | 底板描边颜色。 |
| borderWidth
<sup>
10+
</sup>
|
[
Length
](
ts-types.md#length
)
| 否 | 底板描边粗细。
<br/>
默认值:1
<br/>
单位:vp
<br/>
**说明:**
<br/>
不支持设置百分比。 |
## 属性
支持
[
通用属性
](
ts-universal-attributes-size.md
)
。
## 事件
支持
[
通用事件
](
ts-universal-events-click.md
)
。
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-container-grid.md
浏览文件 @
694a0e3c
...
...
@@ -21,7 +21,7 @@
>
> ForEach/LazyForEach语句中,会计算展开所有子节点索引值。
>
>
if/else/ForEach/LazyForEach
发生变化以后,会更新子节点索引值。
>
[if/else](../../quick-start/arkts-rendering-control.md#条件渲染)、[ForEach](../../quick-start/arkts-rendering-control.md#循环渲染)和[LazyForEach](../../quick-start/arkts-rendering-control.md#数据懒加载)
发生变化以后,会更新子节点索引值。
>
> Grid子组件的visibility属性设置为Hidden或None时依然会计算索引值。
...
...
zh-cn/application-dev/reference/arkui-ts/ts-container-list.md
浏览文件 @
694a0e3c
...
...
@@ -22,7 +22,7 @@
>
> ForEach/LazyForEach语句中,会计算展开所有子节点索引值。
>
>
if/else/ForEach/LazyForEach
发生变化以后,会更新子节点索引值。
>
[if/else](../../quick-start/arkts-rendering-control.md#条件渲染)、[ForEach](../../quick-start/arkts-rendering-control.md#循环渲染)和[LazyForEach](../../quick-start/arkts-rendering-control.md#数据懒加载)
发生变化以后,会更新子节点索引值。
>
> ListItemGroup作为一个整体计算一个索引值,ListItemGroup内部的ListItem不计算索引值。
>
...
...
zh-cn/application-dev/reference/arkui-ts/ts-container-panel.md
浏览文件 @
694a0e3c
...
...
@@ -11,6 +11,10 @@
可以包含子组件。
> **说明:**
>
> 子组件类型:系统组件和自定义组件,支持渲染控制类型([if/else](../../quick-start/arkts-rendering-control.md#条件渲染)、[ForEach](../../quick-start/arkts-rendering-control.md#循环渲染)和[LazyForEach](../../quick-start/arkts-rendering-control.md#数据懒加载))。
## 接口
...
...
@@ -20,19 +24,20 @@ Panel(show: boolean)
| 参数名 | 参数类型 | 必填 | 参数描述 |
| -------- | -------- | -------- | -------- |
| show | boolean | 是 | 控制Panel显示或隐藏。 |
| show | boolean | 是 | 控制Panel显示或隐藏。
<br/>
**说明:**
<br/>
如果设置为false时,则不占位隐藏。
[
Visible.None
](
ts-universal-attributes-visibility.md
)
或者show之间有一个生效时,都会生效不占位隐藏。 |
## 属性
除支持
[
通用属性
](
ts-universal-attributes-size.md
)
外,还支持以下属性:
| 名称 | 参数类型 | 描述 |
| -------- | -------- | -------- |
| type |
[
PanelType
](
#paneltype枚举说明
)
| 设置可滑动面板的类型。
<br/>
默认值:PanelType.Foldable |
| mode |
[
PanelMode
](
#panelmode枚举说明
)
| 设置可滑动面板的初始状态。 |
| mode |
[
PanelMode
](
#panelmode枚举说明
)
| 设置可滑动面板的初始状态。
<br/>
默认值:PanelMode.Half
|
| dragBar | boolean | 设置是否存在dragbar,true表示存在,false表示不存在。
<br/>
默认值:true |
| fullHeight | string
\|
number | 指定PanelMode.Full状态下的高度。 |
| halfHeight | string
\|
number | 指定PanelMode.Half状态下的高度
,默认为屏幕尺寸的一半
。 |
| miniHeight | string
\|
number | 指定PanelMode.Mini状态下的高度。 |
| fullHeight | string
\|
number | 指定PanelMode.Full状态下的高度。
<br/>
默认值:当前组件主轴大小减去8vp空白区
<br/>
**说明:**
<br/>
不支持设置百分比。
|
| halfHeight | string
\|
number | 指定PanelMode.Half状态下的高度
。
<br/>
默认值:当前组件主轴大小的一半。
<br/>
**说明:**
<br/>
不支持设置百分比
。 |
| miniHeight | string
\|
number | 指定PanelMode.Mini状态下的高度。
<br/>
默认值:48
<br/>
单位:vp
<br/>
**说明:**
<br/>
不支持设置百分比。
|
| show | boolean | 当滑动面板弹出时调用。 |
| backgroundMask
<sup>
9+
</sup>
|
[
ResourceColor
](
ts-types.md#resourcecolor
)
|指定Panel的背景蒙层。|
...
...
@@ -52,9 +57,10 @@ Panel(show: boolean)
| Half | 类型为foldable和temporary时,为类半屏状态;类型为minibar,则不生效。 |
| Full | 类全屏状态。 |
## 事件
除支持
[
通用事件
](
ts-universal-events-click.md
)
外,还支持以下事件:
| 名称 | 功能描述 |
| -------- | -------- |
| onChange(event:
(width:
number,
height:
number,
mode:
PanelMode)
=
>
void) | 当可滑动面板发生状态变化时触发,
返回的height值为内容区高度值,当dragbar属性为true时,panel本身的高度值为dragbar高度加上内容区高度。 |
...
...
zh-cn/application-dev/reference/arkui-ts/ts-container-refresh.md
浏览文件 @
694a0e3c
...
...
@@ -25,10 +25,14 @@ Refresh\(value: \{ refreshing: boolean, offset?: number | string , fr
| friction | number
\|
string | 否 | 下拉摩擦系数,取值范围为0到100。
<br/>
默认值:62
<br/>
-
0表示下拉刷新容器不跟随手势下拉而下拉。
<br/>
-
100表示下拉刷新容器紧紧跟随手势下拉而下拉。
<br/>
-
数值越大,下拉刷新容器跟随手势下拉的反应越灵敏。 |
| builder |
[
CustomBuilder
](
ts-types.md#custombuilder8
)
<sup>
10+
</sup>
| 否 | 下拉时,自定义刷新样式的组件。 |
## 属性
支持
[
通用属性
](
ts-universal-attributes-size.md
)
。
## 事件
除支持
[
通用事件
](
ts-universal-events-click.md
)
外,还支持以下事件:
| 名称 | 描述 |
| -------- | -------- |
...
...
zh-cn/application-dev/reference/arkui-ts/ts-container-sidebarcontainer.md
浏览文件 @
694a0e3c
...
...
@@ -13,7 +13,7 @@
> **说明:**
>
> - 子组件类型:系统组件和自定义组件,不支持渲染控制类型([if/else](../../quick-start/arkts-rendering-control.md#条件渲染)、[ForEach](
quick-start/arkts-rendering-control.md#循环渲染)和[LazyForEach](
quick-start/arkts-rendering-control.md#数据懒加载))。
> - 子组件类型:系统组件和自定义组件,不支持渲染控制类型([if/else](../../quick-start/arkts-rendering-control.md#条件渲染)、[ForEach](
../../quick-start/arkts-rendering-control.md#循环渲染)和[LazyForEach](../../
quick-start/arkts-rendering-control.md#数据懒加载))。
> - 子组件个数:必须且仅包含2个子组件。
> - 子组件个数异常时:3个或以上子组件,显示第一个和第二个。1个子组件,显示侧边栏,内容区为空白。
...
...
zh-cn/application-dev/reference/arkui-ts/ts-container-swiper.md
浏览文件 @
694a0e3c
...
...
@@ -11,6 +11,10 @@
可以包含子组件。
> **说明:**
>
> 子组件类型:系统组件和自定义组件,支持渲染控制类型([if/else](../../quick-start/arkts-rendering-control.md#条件渲染)、[ForEach](../../quick-start/arkts-rendering-control.md#循环渲染)和[LazyForEach](../../quick-start/arkts-rendering-control.md#数据懒加载))。
## 接口
...
...
@@ -29,21 +33,21 @@ Swiper(controller?: SwiperController)
| 名称 | 参数类型 | 描述 |
| --------------------------- | ---------------------------------------- | ---------------------------------------- |
| index | number | 设置当前在容器中显示的子组件的索引值。
<br/>
默认值:0
|
| autoPlay | boolean | 子组件是否自动播放。
<br/>
默认值:false
|
| index | number | 设置当前在容器中显示的子组件的索引值。
<br/>
默认值:0
<br/>
**说明:**
<br/>
设置小于0或大于等于子组件数量时,按照默认值0处理。
|
| autoPlay | boolean | 子组件是否自动播放。
<br/>
默认值:false
<br/>
**说明:**
<br/>
loop为false时,自动轮播到最后一页时停止轮播。手势切换后不是最后一页时继续播放。
|
| interval | number | 使用自动播放时播放的时间间隔,单位为毫秒。
<br/>
默认值:3000 |
| indicator
<sup>
10+
</sup>
|
[
DotIndicator
](
#dotindicator
)
\|
[
DigitIndicator
](
#digitindicator
)
\|
boolean | 设置可选导航点指示器样式。
<br/>
\-
DotIndicator:圆点指示器样式。
<br/>
\-
DigitIndicator:数字指示器样式。
<br/>
\-
boolean:是否启用导航点指示器。
<br/>
默认值:true
<br/>
默认类型:DotIndicator |
| loop | boolean | 是否开启循环。
<br>
设置为true时表示开启循环,在LazyForEach懒循环加载模式下,加载的组件数量建议大于5个。
<br/>
默认值:true |
| duration | number | 子组件切换的动画时长,单位为毫秒。
<br/>
默认值:400 |
| vertical | boolean | 是否为纵向滑动。
<br/>
默认值:false |
| itemSpace | number
\|
string | 设置子组件与子组件之间间隙。
<br/>
默认值:0
|
| itemSpace | number
\|
string | 设置子组件与子组件之间间隙。
<br/>
默认值:0
<br/>
**说明:**
<br/>
不支持设置百分比。
|
| displayMode | SwiperDisplayMode | 主轴方向上元素排列的模式,优先以displayCount设置的个数显示,displayCount未设置时本属性生效。
<br/>
默认值:SwiperDisplayMode.Stretch |
| cachedCount
<sup>
8+
</sup>
| number | 设置预加载子组件个数。
<br/>
默认值:1 |
| disableSwipe
<sup>
8+
</sup>
| boolean | 禁用组件滑动切换功能。
<br/>
默认值:false |
| curve
<sup>
8+
</sup>
|
[
Curve
](
ts-appendix-enums.md#curve
)
\|
string | 设置Swiper的动画曲线,默认为淡入淡出曲线,常用曲线参考
[
Curve枚举说明
](
ts-appendix-enums.md#curve
)
,也可以通过
[
插值计算
](
../apis/js-apis-curve.md
)
模块提供的接口创建自定义的插值曲线对象。
<br/>
默认值:Curve.Ease |
| indicatorStyle
<sup>
8+
</sup>
| {
<br/>
left?:
[Length](ts-types.md#length),
<br/>
top?:
[Length](ts-types.md#length),
<br/>
right?:
[Length](ts-types.md#length),
<br/>
bottom?:
[Length](ts-types.md#length),
<br/>
size?:
[Length](ts-types.md#length),
<br/>
mask?:
boolean,
<br/>
color?:
[ResourceColor](ts-types.md),
<br/>
selectedColor?:
[
ResourceColor
](
ts-types.md
)
<br/>
} | 设置导航点样式:
<br/>
\-
left: 设置导航点距离Swiper组件左边的距离。
<br/>
\-
top: 设置导航点距离Swiper组件顶部的距离。
<br/>
\-
right: 设置导航点距离Swiper组件右边的距离。
<br/>
\-
bottom: 设置导航点距离Swiper组件底部的距离。
<br/>
\-
size: 设置导航点的直径。
<br/>
\-
mask: 设置是否显示导航点蒙层样式。
<br/>
\-
color: 设置导航点的颜色。
<br/>
\-
selectedColor: 设置选中的导航点的颜色。 |
| displayCount
<sup>
8+
</sup>
| number
\|
string | 设置一页内元素显示个数。
<br/>
默认值:1
|
| effectMode
<sup>
8+
</sup>
|
[
EdgeEffect
](
ts-appendix-enums.md#edgeeffect
)
| 滑动效果,目前支持的滑动效果参见EdgeEffect的枚举说明。
<br/>
默认值:EdgeEffect.Spring |
| displayCount
<sup>
8+
</sup>
| number
\|
string | 设置一页内元素显示个数。
<br/>
默认值:1
<br/>
**说明:**
<br/>
字符串类型仅支持设置为'auto',显示效果同SwiperDisplayMode.AutoLinear。
<br/>
使用number类型时,子组件按照主轴均分Swiper宽度(减去displayCount-1的itemSpace)的方式进行主轴拉伸(收缩)布局。
|
| effectMode
<sup>
8+
</sup>
|
[
EdgeEffect
](
ts-appendix-enums.md#edgeeffect
)
| 滑动效果,目前支持的滑动效果参见EdgeEffect的枚举说明。
<br/>
默认值:EdgeEffect.Spring
<br/>
**说明:**
<br/>
控制器接口调用时不生效回弹。
|
## SwiperDisplayMode枚举说明
...
...
@@ -60,13 +64,13 @@ Swiper容器组件的控制器,可以将此对象绑定至Swiper组件,然
showNext(): void
翻至下一页。
翻至下一页。
翻页带动效切换过程,时长通过duration指定。
### showPrevious
showPrevious(): void
翻至上一页。
翻至上一页。
翻页带动效切换过程,时长通过duration指定。
### finishAnimation
...
...
@@ -97,13 +101,13 @@ finishAnimation(callback?: () => void): void
| 参数名 | 参数类型 | 必填项 | 参数描述 |
| ------------------ | ------------- | ------ | ------------------------------------------------------ |
| itemWidth |
[
Length
](
ts-types.md#length
)
| 否 | 设置Swiper组件圆点导航指示器的宽。
|
| itemHeight |
[
Length
](
ts-types.md#length
)
| 否 | 设置Swiper组件圆点导航指示器的高。
|
| selectedItemWidth |
[
Length
](
ts-types.md#length
)
| 否 | 设置选中Swiper组件圆点导航指示器的宽。
|
| selectedItemHeight |
[
Length
](
ts-types.md#length
)
| 否 | 设置选中Swiper组件圆点导航指示器的高。
|
| mask | boolean | 否 | 设置是否显示Swiper组件圆点导航指示器的蒙版样式。 |
| color |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 否 | 设置Swiper组件圆点导航指示器的颜色。
|
| selectedColor |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 否 | 设置选中Swiper组件圆点导航指示器的颜色。
|
| itemWidth |
[
Length
](
ts-types.md#length
)
| 否 | 设置Swiper组件圆点导航指示器的宽。
<br/>
默认值:6
<br/>
单位:vp
|
| itemHeight |
[
Length
](
ts-types.md#length
)
| 否 | 设置Swiper组件圆点导航指示器的高。
<br/>
默认值:6
<br/>
单位:vp
|
| selectedItemWidth |
[
Length
](
ts-types.md#length
)
| 否 | 设置选中Swiper组件圆点导航指示器的宽。
<br/>
默认值:6
<br/>
单位:vp
|
| selectedItemHeight |
[
Length
](
ts-types.md#length
)
| 否 | 设置选中Swiper组件圆点导航指示器的高。
<br/>
默认值:6
<br/>
单位:vp
|
| mask | boolean | 否 | 设置是否显示Swiper组件圆点导航指示器的蒙版样式。
<br/>
默认值:false
|
| color |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 否 | 设置Swiper组件圆点导航指示器的颜色。
<br/>
默认值:'
\#
007DFF'
|
| selectedColor |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 否 | 设置选中Swiper组件圆点导航指示器的颜色。
<br/>
默认值:'
\#
182431'(10%透明度)
|
### DigitIndicator
...
...
@@ -111,29 +115,20 @@ finishAnimation(callback?: () => void): void
| 参数名 | 参数类型 | 必填项 | 参数描述 |
| ----------------- | ------------------------------------------------------------ | ------ | ------------------------------------------------------------ |
| fontColor |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 否 | 设置Swiper组件数字导航点的字体颜色。 |
| selectedFontColor |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 否 | 设置选中Swiper组件数字导航点的字体颜色。 |
| digitFont | {
<br/>
size?:
[
Length
](
ts-types.md#length
)
<br/>
weight?:number
\|
[
FontWeight
](
ts-appendix-enums.md#fontweight
)
\|
string
<br/>
} | 否 | 设置Swiper组件数字导航点的字体样式:
<br/>
\-
size:数字导航点指示器的字体大小。
<br/>
\-
weight:数字导航点指示器的字重。 |
| selectedDigitFont | {
<br/>
size?:
[
Length
](
ts-types.md#length
)
<br/>
weight?:number
\|
[
FontWeight
](
ts-appendix-enums.md#fontweight
)
\|
string
<br/>
} | 否 | 设置选中Swiper组件数字导航点的字体样式:
<br/>
\-
size:数字导航点选中指示器的字体大小。
<br/>
\-
weight:数字导航点选中指示器的字重。 |
| fontColor |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 否 | 设置Swiper组件数字导航点的字体颜色。
<br/>
默认值:'
\#
ff182431' |
| selectedFontColor |
[
ResourceColor
](
ts-types.md#resourcecolor
)
| 否 | 设置选中Swiper组件数字导航点的字体颜色。
<br/>
默认值:'
\#
ff182431' |
| digitFont | {
<br/>
size?:
[
Length
](
ts-types.md#length
)
<br/>
weight?:number
\|
[
FontWeight
](
ts-appendix-enums.md#fontweight
)
\|
string
<br/>
} | 否 | 设置Swiper组件数字导航点的字体样式:
<br/>
\-
size:数字导航点指示器的字体大小。
<br/>
默认值:14vp
<br/>
\-
weight:数字导航点指示器的字重。 |
| selectedDigitFont | {
<br/>
size?:
[
Length
](
ts-types.md#length
)
<br/>
weight?:number
\|
[
FontWeight
](
ts-appendix-enums.md#fontweight
)
\|
string
<br/>
} | 否 | 设置选中Swiper组件数字导航点的字体样式:
<br/>
\-
size:数字导航点选中指示器的字体大小。
<br/>
默认值:14vp
<br/>
\-
weight:数字导航点选中指示器的字重。 |
## 事件
### onChange
onChange(event: (index: number) => void)
当前显示的子组件索引变化时触发该事件,返回值为当前显示的子组件的索引值。
**说明**
:Swiper组件结合LazyForEach使用时,不能在onChange事件里触发子页面UI的刷新。
**返回值:**
| 名称 | 类型 | 参数描述 |
| --------- | ---------- | -------- |
| index | number | 当前显示元素的索引。 |
除支持
[
通用事件
](
ts-universal-events-click.md
)
外,还支持以下事件:
| 名称 | 功能描述 |
| ------------------------------------------------------------ | ------------------------------------------------------------ |
| onChange(event: (index: number) => void) | 当前显示的子组件索引变化时触发该事件,返回值为当前显示的子组件的索引值。
<br/>
-
index:当前显示元素的索引。
<br/>
**说明:**
<br>
Swiper组件结合LazyForEach使用时,不能在onChange事件里触发子页面UI的刷新。 |
| onAnimationStart
<sup>
9+
</sup>
(event: (index: number) => void) | 切换动画开始时触发该回调。
<br/>
-
index:当前显示元素的索引。
<br/>
**说明:**
<br/>
参数为动画开始前的index值(不是最终结束动画的index值),多列Swiper时,index为最左侧组件的索引。 |
| onAnimationEnd
<sup>
9+
</sup>
(event: (index: number) => void) | 切换动画结束时触发该回调。
<br/>
-
index:当前显示元素的索引。
<br/>
**说明:**
<br/>
当Swiper切换动效结束时触发,包括动画过程中手势中断,通过SwiperController调用finishAnimatio。参数为动画结束后的index值,多列Swiper时,index为最左侧组件的索引。 |
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-container-tabcontent.md
浏览文件 @
694a0e3c
...
...
@@ -13,7 +13,7 @@
> **说明:**
>
> 可内置系统组件和自定义组件,支持渲染控制类型([if/else](../../quick-start/arkts-rendering-control.md#条件渲染)、[ForEach](
quick-start/arkts-rendering-control.md#循环渲染)和[LazyForEach](
quick-start/arkts-rendering-control.md#数据懒加载))。
> 可内置系统组件和自定义组件,支持渲染控制类型([if/else](../../quick-start/arkts-rendering-control.md#条件渲染)、[ForEach](
../../quick-start/arkts-rendering-control.md#循环渲染)和[LazyForEach](../../
quick-start/arkts-rendering-control.md#数据懒加载))。
## 接口
...
...
zh-cn/application-dev/reference/arkui-ts/ts-page-transition-animation.md
浏览文件 @
694a0e3c
...
...
@@ -8,10 +8,10 @@
>
| 名称 | 参数 | 参数描述 |
| ------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| PageTransitionEnter | {
<br/>
type?: RouteType,
<br/>
duration?: number,
<br/>
curve?:
[
Curve
](
ts-appendix-enums.md#curve
)
\|
string,
<br>
delay?: number
<br/>
} | 设置当前页面的自定义入场动效。
<br/>
-
type:页面转场效果生效的路由类型。
<br/>
默认值:RouteType.None。
<br/>
**说明:**
<br/>
没有匹配时使用系统默认的页面转场效果(根据设备可能会有差异),如需禁用系统默认页面转场效果,可以指定duration为0。
<br/>
-
duration:动画的时长
<br/>
单位:毫秒
<br/>
-
curve:动画曲线。string类型的取值支持"ease"、"ease-in"、"ease-out"、"ease-in-out"、"extreme-deceleration"、"fast-out-linear-in"、"fast-out-slow-in"、"friction"、"linear"、"linear-out-slow-in"、"rhythm"、"sharp"、"smooth"。
<br/>
默认值:Curve.Linear
<br/>
-
delay:动画延迟时长。
<br/>
默认值:0
<br/>
单位:毫秒 |
| PageTransitionExit | {
<br/>
type?: RouteType,
<br/>
duration?: number,
<br/>
curve?:
[
Curve
](
ts-appendix-enums.md#curve
)
\|
string,
<br/>
delay?: number
<br/>
} | 设置当前页面的自定义退场动效。
<br/>
-
type:页面转场效果生效的路由类型。
<br/>
默认值:RouteType.None。
<br/>
**说明:**
<br/>
没有匹配时使用系统默认的页面转场效果(根据设备可能会有差异),如需禁用系统默认页面转场效果,可以指定duration为0。
<br/>
-
duration:动画的时长,单位为毫秒。
<br/>
-
curve:动画曲线,string类型取值与PageTransitionEnter相同。
<br/>
默认值:Curve.Linear
<br/>
-
delay:动画延迟时长。
<br/>
默认值:0
<br/>
单位:毫秒 |
| 名称 | 参数 |
必填 |
参数描述 |
| ------------------- | ------------------------------------------------------------ | ----
| ----
-------------------------------------------------------- |
| PageTransitionEnter | {
<br/>
type?: RouteType,
<br/>
duration?: number,
<br/>
curve?:
[
Curve
](
ts-appendix-enums.md#curve
)
\|
string,
<br>
delay?: number
<br/>
} |
否 |
设置当前页面的自定义入场动效。
<br/>
-
type:页面转场效果生效的路由类型。
<br/>
默认值:RouteType.None。
<br/>
**说明:**
<br/>
没有匹配时使用系统默认的页面转场效果(根据设备可能会有差异),如需禁用系统默认页面转场效果,可以指定duration为0。
<br/>
-
duration:动画的时长
<br/>
单位:毫秒
<br/>
-
curve:动画曲线。string类型的取值支持"ease"、"ease-in"、"ease-out"、"ease-in-out"、"extreme-deceleration"、"fast-out-linear-in"、"fast-out-slow-in"、"friction"、"linear"、"linear-out-slow-in"、"rhythm"、"sharp"、"smooth"。
<br/>
默认值:Curve.Linear
<br/>
-
delay:动画延迟时长。
<br/>
默认值:0
<br/>
单位:毫秒 |
| PageTransitionExit | {
<br/>
type?: RouteType,
<br/>
duration?: number,
<br/>
curve?:
[
Curve
](
ts-appendix-enums.md#curve
)
\|
string,
<br/>
delay?: number
<br/>
} |
否 |
设置当前页面的自定义退场动效。
<br/>
-
type:页面转场效果生效的路由类型。
<br/>
默认值:RouteType.None。
<br/>
**说明:**
<br/>
没有匹配时使用系统默认的页面转场效果(根据设备可能会有差异),如需禁用系统默认页面转场效果,可以指定duration为0。
<br/>
-
duration:动画的时长,单位为毫秒。
<br/>
-
curve:动画曲线,string类型取值与PageTransitionEnter相同。
<br/>
默认值:Curve.Linear
<br/>
-
delay:动画延迟时长。
<br/>
默认值:0
<br/>
单位:毫秒 |
## RouteType枚举说明
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录