diff --git a/zh-cn/application-dev/reference/arkui-ts/figures/image-effect.png b/zh-cn/application-dev/reference/arkui-ts/figures/image-effect.png new file mode 100644 index 0000000000000000000000000000000000000000..5f716c12d97da21a4f523abcf29bda60401bde64 Binary files /dev/null and b/zh-cn/application-dev/reference/arkui-ts/figures/image-effect.png differ diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-select.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-select.md index b08b3470182ed4ba532e961be9fdb27ff434d769..3f476498d0dc7dc8b7dddbb54cc2bc817b88790e 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-select.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-select.md @@ -6,10 +6,6 @@ > > 该组件从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 -## 权限列表 - -无 - ## 子组件 无 @@ -19,25 +15,25 @@ Select(options: Array\) **SelectOption对象说明：** -| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | -| ----- | ----------------------------------- | ---- | ---- | ------- | -| value | [ResourceStr](ts-types.md#resourcestr8) | 是 | - | 下拉选项内容。 | -| icon | [ResourceStr](ts-types.md#resourcestr8) | 否 | - | 下拉选项图片。 | +| 参数名 | 参数类型 | 必填 | 参数描述 | +| ----- | ----------------------------------- | ---- | ------- | +| value | [ResourceStr](ts-types.md#resourcestr8) | 是 | 下拉选项内容。 | +| icon | [ResourceStr](ts-types.md#resourcestr8) | 否 | 下拉选项图片。 | ## 属性 -| 名称 | 参数类型 | 默认值 | 描述 | -| ----------------------- | ------------------------------------------- | ------ | ----------------------------------------------- | -| selected | number | - | 设置下拉菜单初始选择项的索引，第一项的索引为0。 | -| value | string | - | 设置下拉按钮本身的文本显示。 | -| font | [Font](ts-types.md#font) | - | 设置下拉按钮本身的文本样式： | -| fontColor | [ResourceColor](ts-types.md#resourcecolor8) | - | 设置下拉按钮本身的文本颜色。 | -| selectedOptionBgColor | [ResourceColor](ts-types.md#resourcecolor8) | - | 设置下拉菜单选中项的背景色。 | -| selectedOptionFont | [Font](ts-types.md#font) | - | 设置下拉菜单选中项的文本样式： | -| selectedOptionFontColor | [ResourceColor](ts-types.md#resourcecolor8) | - | 设置下拉菜单选中项的文本颜色。 | -| optionBgColor | [ResourceColor](ts-types.md#resourcecolor8) | - | 设置下拉菜单项的背景色。 | -| optionFont | [Font](../../ui/ts-types.md) | - | 设置下拉菜单项的文本样式： | -| optionFontColor | [ResourceColor](ts-types.md#resourcecolor8) | - | 设置下拉菜单项的文本颜色。 | +| 名称 | 参数类型 | 描述 | +| ----------------------- | ------------------------------------------- | --------------------------------------------- | +| selected | number | 设置下拉菜单初始选项的索引，第一项的索引为0。 | +| value | string | 设置下拉按钮本身的文本显示。 | +| font | [Font](ts-types.md#font) | 设置下拉按钮本身的文本样式。 | +| fontColor | [ResourceColor](ts-types.md#resourcecolor8) | 设置下拉按钮本身的文本颜色。 | +| selectedOptionBgColor | [ResourceColor](ts-types.md#resourcecolor8) | 设置下拉菜单选中项的背景色。 | +| selectedOptionFont | [Font](ts-types.md#font) | 设置下拉菜单选中项的文本样式。 | +| selectedOptionFontColor | [ResourceColor](ts-types.md#resourcecolor8) | 设置下拉菜单选中项的文本颜色。 | +| optionBgColor | [ResourceColor](ts-types.md#resourcecolor8) | 设置下拉菜单项的背景色。 | +| optionFont | [Font](../../ui/ts-types.md) | 设置下拉菜单项的文本样式。 | +| optionFontColor | [ResourceColor](ts-types.md#resourcecolor8) | 设置下拉菜单项的文本颜色。 | ## 事件 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-slider.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-slider.md index 7bc7c8ed33ffcb4dc33fdef88455af625dfb33c6..e9de0a7fa0698da2ff19fe10516192f7675896ae 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-slider.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-slider.md @@ -7,11 +7,6 @@ > 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 -## 权限列表 - -无 - - ## 子组件 无 @@ -23,15 +18,15 @@ Slider(options?:{value?: number, min?: number, max?: number, step?: number, styl **参数：** -| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | -| ---------------------- | ------------------------------------- | ---- | ------------------ | -------------------------------------- | -| value | number | 否 | 0 | 当前进度值。 | -| min | number | 否 | 0 | 设置最小值。 | -| max | number | 否 | 100 | 设置最大值。 | -| step | number | 否 | 1 | 设置Slider滑动跳动值，当设置相应的step时，Slider为间歇滑动。 | -| style | SliderStyle | 否 | SliderStyle.OutSet | 设置Slider的滑块样式。 | -| direction8+ | [Axis](ts-appendix-enums.md#axis枚举说明) | 否 | Axis.Horizontal | 设置滑动条滑动方向为水平或竖直方向。 | -| reverse8+ | boolean | 否 | false | 设置滑动条取值范围是否反向。 | +| 参数名 | 参数类型 | 必填 | 参数描述 | +| ---------------------- | --------------------------------- | ---- | ------------------------------------------------------------ | +| value | number | 否 | 当前进度值。
默认值：0 | +| min | number | 否 | 设置最小值。
默认值：0 | +| max | number | 否 | 设置最大值。
默认值：100 | +| step | number | 否 | 设置滑动条滑动步长。
默认值：1 | +| style | SliderStyle | 否 | 设置滑动条的滑块样式。
默认值：SliderStyle.OutSet | +| direction8+ | [Axis](ts-appendix-enums.md#axis) | 否 | 设置滑动条滑动方向为水平或竖直方向。
默认值：Axis.Horizontal | +| reverse8+ | boolean | 否 | 设置滑动条取值范围是否反向。
**说明：**设置为false时，水平方向滑动条为从左向右滑动，竖直方向滑动条从上向下滑动，设置为true时，水平方向滑动条为从右向左滑动，竖直方向滑动条从下向上滑动。
默认值：false | ## SliderStyle枚举说明 @@ -44,16 +39,16 @@ Slider(options?:{value?: number, min?: number, max?: number, step?: number, styl 不支持触摸热区设置。 -| 名称 | 参数类型 | 默认值 | 描述 | -| ------------- | ------- | ----- | ----------------- | -| blockColor | [ResourceColor](ts-types.md#resourcecolor8) | - | 设置滑块的颜色。 | -| trackColor | [ResourceColor](ts-types.md#resourcecolor8) | - | 设置滑轨的背景颜色。 | -| selectedColor | [ResourceColor](ts-types.md#resourcecolor8) | - | 设置滑轨的已滑动颜色。 | -| showSteps | boolean | false | 设置当前是否显示步长刻度值。 | -| showTips | boolean | false | 设置滑动时是否显示气泡提示百分比。 | -| trackThickness | [Length](ts-types.md#length) | - | 设置滑轨的粗细。 | -| maxLabel | string | - | 设置最大标号时使用。 | -| minLabel | string | - | 设置最小标号时使用。 | +| 名称 | 参数类型 | 描述 | +| ------------- | ------- | ----------------- | +| blockColor | [ResourceColor](ts-types.md#resourcecolor8) | 设置滑块的颜色。 | +| trackColor | [ResourceColor](ts-types.md#resourcecolor8) | 设置滑轨的背景颜色。 | +| selectedColor | [ResourceColor](ts-types.md#resourcecolor8) | 设置滑轨的已滑动颜色。 | +| showSteps | boolean | 设置当前是否显示步长刻度值。
默认值：false | +| showTips | boolean | 设置滑动时是否显示气泡提示百分比。
默认值：false | +| trackThickness | [Length](ts-types.md#length) | 设置滑轨的粗细。 | +| maxLabel | string | 设置最大标签。 | +| minLabel | string | 设置最小标签。 | ## 事件 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 1c2783baafe653a7112d6181477174ab8946340d..1312e57272f2f0dae13e24f018eea600f05067ad 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 @@ -1,16 +1,11 @@ # Scroll -可滚动的容器组件，当子组件的布局尺寸超过父组件的视口时，内容可以滚动。 +可滑动的容器组件，当子组件的布局尺寸超过父组件的视口时，内容可以滑动。 > **说明：** > > - 该组件从API version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 -> - 该组件回弹的前提是要有滚动。内容小于一屏时，没有回弹效果。 - - -## 权限列表 - -无 +> - 该组件回弹的前提是要有滑动。内容小于一屏时，没有回弹效果。 ## 子组件 @@ -25,13 +20,13 @@ Scroll(scroller?: Scroller) ## 属性 -| 名称 | 参数类型 | 默认值 | 描述 | -| -------------- | ---------------------------------------- | ------------------------ | --------- | -| scrollable | ScrollDirection | ScrollDirection.Vertical | 设置滚动方法。 | -| scrollBar | [BarState](ts-appendix-enums.md#barstate) | BarState.Off | 设置滚动条状态。 | -| scrollBarColor | string \| number \| Color | - | 设置滚动条的颜色。 | -| scrollBarWidth | string \| number | - | 设置滚动条的宽度。 | -| edgeEffect | [EdgeEffect](ts-appendix-enums.md#edgeeffect) | EdgeEffect.Spring | 设置滑动效果，目前支持的滑动效果参见EdgeEffect的枚举说明。 | +| 名称 | 参数类型 | 描述 | +| -------------- | ---------------------------------------- | --------- | +| scrollable | ScrollDirection | 设置滑动方法。
默认值：ScrollDirection.Vertical | +| scrollBar | [BarState](ts-appendix-enums.md#barstate) | 设置滑动条状态。
默认值：BarState.Off | +| scrollBarColor | string \| number \| Color | 设置滑动条的颜色。 | +| scrollBarWidth | string \| number | 设置滑动条的宽度。 | +| edgeEffect | [EdgeEffect](ts-appendix-enums.md#edgeeffect) | 设置滑动效果，目前支持的滑动效果参见EdgeEffect的枚举说明。
默认值：EdgeEffect.Spring | ## ScrollDirection枚举说明 @@ -52,7 +47,7 @@ Scroll(scroller?: Scroller) ## Scroller -可滚动容器组件的控制器，可以将此组件绑定至容器组件，然后通过它控制容器组件的滚动，目前支持绑定到List、Scroll、ScrollBar上。 +可滑动容器组件的控制器，可以将此组件绑定至容器组件，然后通过它控制容器组件的滑动，目前支持绑定到List、Scroll、ScrollBar上。 ### 导入对象 @@ -71,38 +66,38 @@ scrollTo(value: { xOffset: number | string, yOffset: number | string, animation? **参数：** -| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | -| --------- | ------------------------------------------------------------ | ---- | ------ | ------------------------------------------------------------ | -| xOffset | number \| string | 是 | - | 水平滑动偏移。 | -| yOffset | number \| string | 是 | - | 竖直滑动偏移。 | -| animation | {
duration: number,
curve: [Curve](ts-animatorproperty.md) 
} | 否 | | 动画配置：
- duration: 滚动时长设置。
- curve: 滚动曲线设置。 | +| 参数名 | 参数类型 | 必填 | 参数描述 | +| --------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | +| xOffset | number \| string | 是 | 水平滑动偏移。 | +| yOffset | number \| string | 是 | 竖直滑动偏移。 | +| animation | {
duration: number,
curve: [Curve](ts-animatorproperty.md) 
} | 否 | 动画配置：
- duration: 滑动时长设置。
- curve: 滑动曲线设置。 | ### scrollEdge scrollEdge(value: [Edge](ts-appendix-enums.md#edge)): void -滚动到容器边缘。 +滑动到容器边缘。 ### scrollPage scrollPage(value: { next: boolean, direction?: Axis }): void -滚动到下一页或者上一页。 +滑动到下一页或者上一页。 **参数：** -| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | -| --------- | --------------------------------- | ---- | ------ | --------------------------------------------------- | -| next | boolean | 是 | - | 是否向下翻页。true表示向下翻页，false表示向上翻页。 | -| direction | [Axis](ts-appendix-enums.md#axis) | 否 | - | 设置滚动方向为水平或竖直方向。 | +| 参数名 | 参数类型 | 必填 | 参数描述 | +| --------- | --------------------------------- | ---- | --------------------------------------------------- | +| next | boolean | 是 | 是否向下翻页。true表示向下翻页，false表示向上翻页。 | +| direction | [Axis](ts-appendix-enums.md#axis) | 否 | 设置滑动方向为水平或竖直方向。 | ### currentOffset currentOffset() -返回当前的滚动偏移量。 +返回当前的滑动偏移量。 ### scrollToIndex @@ -117,9 +112,9 @@ scrollToIndex(value: number): void **参数：** -| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | -| ----- | ------ | ---- | ---- | ----------------- | -| value | number | 是 | - | 要滑动到的列表项在列表中的索引值。 | +| 参数名 | 参数类型 | 必填 | 参数描述 | +| ------ | -------- | ---- | ---------------------------------- | +| value | number | 是 | 要滑动到的列表项在列表中的索引值。 | ## 示例 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-sidebarcontainer.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-sidebarcontainer.md index 8c55742c98609167f7ff9b4276486c86f739961c..a2ff2d7495dbac694cb59235913d8c346a633be8 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-container-sidebarcontainer.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-sidebarcontainer.md @@ -7,11 +7,6 @@ > 该组件从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 -## 权限列表 - -无 - - ## 子组件 可以包含子组件。 @@ -23,9 +18,9 @@ SideBarContainer( type?: SideBarContainerType ) **参数:** -| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | -| ---- | -------------------- | ---- | -------------------------- | ----------- | -| type | SideBarContainerType | 否 | SideBarContainerType.Embed | 设置侧边栏的显示类型。 | +| 参数名 | 参数类型 | 必填 | 参数描述 | +| ------ | -------------------- | ---- | ------------------------------------------------------------ | +| type | SideBarContainerType | 否 | 设置侧边栏的显示类型。
默认值：SideBarContainerType.Embed | ## SideBarContainerType枚举说明 @@ -36,32 +31,32 @@ SideBarContainer( type?: SideBarContainerType ) ## 属性 -| 名称 | 参数类型 | 默认值 | 描述 | -| ----------------- | ----------- | ---- | ------------- | -| showSideBar | boolean | true | 设置是否显示侧边栏。 | -| controlButton | ButtonStyle | - | 设置侧边栏控制按钮的属性。 | -| showControlButton | boolean | true | 设置是否显示控制按钮。 | -| sideBarWidth | number | 200 | 设置侧边栏的宽度。 | -| minSideBarWidth | number | 200 | 设置侧边栏最小宽度。 | -| maxSideBarWidth | number | 280 | 设置侧边栏最大宽度。 | +| 名称 | 参数类型 | 描述 | +| ----------------- | ----------- | -------------------------------------------- | +| showSideBar | boolean | 设置是否显示侧边栏。
默认值：true | +| controlButton | ButtonStyle | 设置侧边栏控制按钮的属性。 | +| showControlButton | boolean | 设置是否显示控制按钮。
默认值：true | +| sideBarWidth | number | 设置侧边栏的宽度。
默认值：200，单位vp | +| minSideBarWidth | number | 设置侧边栏最小宽度。
默认值：200，单位vp | +| maxSideBarWidth | number | 设置侧边栏最大宽度。
默认值：280，单位vp | ## ButtonStyle对象说明 -| 名称 | 参数类型 | 必填 | 默认值 | 描述 | -| ------ | ------------------------------------------------------------ | ---- | ------ | ------------------------------------------------------------ | -| left | number | 否 | 16 | 设置侧边栏控制按钮距离容器左界限的间距。 | -| top | number | 否 | 48 | 设置侧边栏控制按钮距离容器上界限的间距。 | -| width | number | 否 | 32 | 设置侧边栏控制按钮的宽度。 | -| height | number | 否 | 32 | 设置侧边栏控制按钮的高度。 | -| icons | {
shown: string \| PixelMap \| [Resource](arkui-ts/ts-types.md#resource) ,
hidden: string \| PixelMap \| [Resource](arkui-ts/ts-types.md#resource) ,
switching?: string \| PixelMap \| [Resource](arkui-ts/ts-types.md#resource)
} | 否 | - | 设置侧边栏控制按钮的图标：

- shown: 设置侧边栏显示时控制按钮的图标。
- hidden: 设置侧边栏隐藏时控制按钮的图标。
- switching:设置侧边栏显示和隐藏状态切换时控制按钮的图标。 | +| 名称 | 参数类型 | 必填 | 描述 | +| ------ | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | +| left | number | 否 | 设置侧边栏控制按钮距离容器左界限的间距。
默认值：16，单位vp | +| top | number | 否 | 设置侧边栏控制按钮距离容器上界限的间距。
默认值：48，单位vp | +| width | number | 否 | 设置侧边栏控制按钮的宽度。
默认值：32，单位vp | +| height | number | 否 | 设置侧边栏控制按钮的高度。
默认值：32，单位vp | +| icons | {
shown: string \| PixelMap \| [Resource](arkui-ts/ts-types.md#resource) ,
hidden: string \| PixelMap \| [Resource](arkui-ts/ts-types.md#resource) ,
switching?: string \| PixelMap \| [Resource](arkui-ts/ts-types.md#resource)
} | 否 | 设置侧边栏控制按钮的图标：

- shown: 设置侧边栏显示时控制按钮的图标。
- hidden: 设置侧边栏隐藏时控制按钮的图标。
- switching:设置侧边栏显示和隐藏状态切换时控制按钮的图标。 | ## 事件 -| 名称 | 功能描述 | -| ------------------------------------- | ------------------------------------------------------------ | -| onChange(callback: boolen) => void | 当侧边栏的状态在显示和隐藏之间切换时触发回调。

true表示显示，false表示隐藏。 | +| 名称 | 功能描述 | +| -------------------------------------- | ------------------------------------------------------------ | +| onChange(callback: boolean) => void | 当侧边栏的状态在显示和隐藏之间切换时触发回调。

true表示显示，false表示隐藏。 | ## 示例 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-stack.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-stack.md index d3c40fc07cca595697d3d7d1c484421351c96957..2c2434101dd7c77bd5581ac0931ce4b03a97dcff 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-container-stack.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-stack.md @@ -7,11 +7,6 @@ > 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 -## 权限列表 - -无 - - ## 子组件 可以包含子组件。 @@ -23,9 +18,9 @@ Stack(value?: {alignContent?: Alignment}) **参数：** -| 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | -| ------------ | ------------------------------------------- | ---- | ------ | ------------------------------ | -| alignContent | [Alignment](ts-appendix-enums.md#alignment) | 否 | Center | 设置子组件在容器内的对齐方式。 | +| 参数名 | 参数类型 | 必填 | 参数描述 | +| ------------ | ------------------------------------------- | ---- | ----------------------------------------------------------- | +| alignContent | [Alignment](ts-appendix-enums.md#alignment) | 否 | 设置子组件在容器内的对齐方式。
默认值：Alignment.Center | ## 示例 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-swiper.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-swiper.md index bfb324ba57c6cbf5154220413b05185dcacd4ef9..2fa380979b1014d4a9167b72cba5710d909e7401 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-container-swiper.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-swiper.md @@ -6,13 +6,6 @@ > 该组件从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 - - -## 权限列表 - -无 - - ## 子组件 可以包含子组件。 @@ -24,46 +17,46 @@ Swiper(value?:{controller?: SwiperController}) **参数：** - | 参数名 | 参数类型 | 必填 | 参数描述 | - | ---------- | ------------------------------------- | ---- | -------------------- | - | controller | [SwiperController](#swipercontroller) | 否 | 给组件绑定一个控制器，用来控制组件翻页。
默认值：null | +| 参数名 | 参数类型 | 必填 | 参数描述 | +| ---------- | ------------------------------------- | ---- | -------------------- | +| controller | [SwiperController](#swipercontroller) | 否 | 给组件绑定一个控制器，用来控制组件翻页。 | ## 属性 不支持[Menu控制](ts-universal-attributes-menu.md)。 -| 名称 | 参数类型 | 默认值 | 描述 | -| --------------------------- | ---------------------------------------- | ---------- | ---------------------------------------- | -| index | number | 0 | 设置当前在容器中显示的子组件的索引值。 | -| autoPlay | boolean | false | 子组件是否自动播放，自动播放状态下，导航点不可操作。 | -| interval | number | 3000 | 使用自动播放时播放的时间间隔，单位为毫秒。 | -| indicator | boolean | true | 是否启用导航点指示器。 | -| loop | boolean | true | 是否开启循环。
设置为true时表示开启循环，在LazyForEach懒循环加载模式下，加载的组件数量建议大于5个。 | -| duration | number | 400 | 子组件切换的动画时长，单位为毫秒。 | -| vertical | boolean | false | 是否为纵向滑动。 | -| itemSpace | number \| string | 0 | 设置子组件与子组件之间间隙。 | -| displayMode | SwiperDisplayMode | SwiperDisplayMode.Stretch | 设置子组件显示模式。 | -| cachedCount8+ | number | 1 | 设置预加载子组件个数。 | -| disableSwipe8+ | boolean | false | 禁用组件滑动切换功能。 | -| displayCount8+ | number \| string | 1 | 设置一页中显示子组件的个数，设置为“auto”时等同于SwiperDisplayMode.AutoLinear的显示效果。 | -| effectMode8+ | EdgeEffect | EdgeEffect.Spring | 设置滑动到边缘时的显示效果。 | -| curve8+ | [Curve](ts-appendix-enums.md#curve) \| string | Curve.Ease | 设置Swiper的动画曲线，默认为淡入淡出曲线，常用曲线参考[Curve枚举说明](ts-appendix-enums.md#curve)，也可以通过插值计算模块提供的接口创建自定义的Curves([插值曲线对象](ts-interpolation-calculation.md))。 | -| indicatorStyle8+ | {
left?: [Length](ts-types.md#length),
top?: [Length](ts-types.md#length),
right?: [Length](ts-types.md#length),
bottom?: [Length](ts-types.md#length),
size?: [Length](ts-types.md#length),
mask?: boolean,
color?: [ResourceColor](ts-types.md#resourcecolor8),
selectedColor?: [ResourceColor](ts-types.md#resourcecolor8)
} | - | 设置indicator样式：
- left: 设置导航点距离Swiper组件左边的距离。
- top: 设置导航点距离Swiper组件顶部的距离。
- right: 设置导航点距离Swiper组件右边的距离。
- bottom: 设置导航点距离Swiper组件底部的距离。
- size: 设置导航点的直径。
- mask: 设置是否显示导航点蒙层样式。
- color: 设置导航点的颜色。
- selectedColor: 设置选中的导航点的颜色。 | +| 名称 | 参数类型 | 描述 | +| --------------------------- | ------------------------------------------------------------ | ------------------------------------------------------------ | +| index | number | 设置当前在容器中显示的子组件的索引值。
默认值：0 | +| autoPlay | boolean | 子组件是否自动播放，自动播放状态下，导航点不可操作。
默认值：false | +| interval | number | 使用自动播放时播放的时间间隔，单位为毫秒。
默认值：3000 | +| indicator | boolean | 是否启用导航点指示器。
默认值：true | +| loop | boolean | 是否开启循环。
设置为true时表示开启循环，在LazyForEach懒循环加载模式下，加载的组件数量建议大于5个。
默认值：true | +| duration | number | 子组件切换的动画时长，单位为毫秒。
默认值：400 | +| vertical | boolean | 是否为纵向滑动。
默认值：false | +| itemSpace | number \| string | 设置子组件与子组件之间间隙。
默认值：0 | +| displayMode | SwiperDisplayMode | 设置子组件显示模式。
默认值：SwiperDisplayMode.Stretch | +| cachedCount8+ | number | 设置预加载子组件个数。
默认值：1 | +| disableSwipe8+ | boolean | 禁用组件滑动切换功能。
默认值：false | +| displayCount8+ | number \| string | 设置一页中显示子组件的个数，设置为“auto”时等同于SwiperDisplayMode.AutoLinear的显示效果。
默认值：1 | +| effectMode8+ | EdgeEffect | 设置滑动到边缘时的显示效果。
默认值：EdgeEffect.Spring | +| curve8+ | [Curve](ts-appendix-enums.md#curve) \| string | 设置Swiper的动画曲线，默认为淡入淡出曲线，常用曲线参考[Curve枚举说明](ts-appendix-enums.md#curve)，也可以通过插值计算模块提供的接口创建自定义的Curves([插值曲线对象](ts-interpolation-calculation.md))。
默认值：Curve.Ease | +| indicatorStyle8+ | {
left?: [Length](ts-types.md#length),
top?: [Length](ts-types.md#length),
right?: [Length](ts-types.md#length),
bottom?: [Length](ts-types.md#length),
size?: [Length](ts-types.md#length),
mask?: boolean,
color?: [ResourceColor](ts-types.md#resourcecolor8),
selectedColor?: [ResourceColor](ts-types.md#resourcecolor8)
} | 设置导航点样式：
- left: 设置导航点距离Swiper组件左边的距离。
- top: 设置导航点距离Swiper组件顶部的距离。
- right: 设置导航点距离Swiper组件右边的距离。
- bottom: 设置导航点距离Swiper组件底部的距离。
- size: 设置导航点的直径。
- mask: 设置是否显示导航点蒙层样式。
- color: 设置导航点的颜色。
- selectedColor: 设置选中的导航点的颜色。 | ## SwiperDisplayMode枚举说明 - - | 名称 | 描述 | - | ----------- | ------------------------------------------ | - | Stretch | Swiper滑动一页的宽度为Swiper组件自身的宽度。| - | AutoLinear | Swiper滑动一页的宽度为子组件宽度中的最大值。| + +| 名称 | 描述 | +| ----------- | ------------------------------------------ | +| Stretch | Swiper滑动一页的宽度为Swiper组件自身的宽度。| +| AutoLinear | Swiper滑动一页的宽度为子组件宽度中的最大值。| ## EdgeEffect枚举说明 - - | 名称 | 描述 | - | ------ | ------------------------------------------------------------------------- | - | Spring | 弹性物理动效，滑动到边缘后可以通过触摸事件继续滑动一段距离，松手后回弹。 | - | Fade | 滑动到边缘后，可以通过触摸事件继续滑动一段阴影，松手后阴影回弹。 | - | None | 滑动到边缘后无效果。 | + +| 名称 | 描述 | +| ------ | ------------------------------------------------------------------------- | +| Spring | 弹性物理动效，滑动到边缘后可以通过触摸事件继续滑动一段距离，松手后回弹。 | +| Fade | 滑动到边缘后，可以通过触摸事件继续滑动一段阴影，松手后阴影回弹。 | +| None | 滑动到边缘后无效果。 | ## SwiperController @@ -97,7 +90,7 @@ finishAnimation(callback?: () => void): void ### onChange -onChange( index: number) => void +onChange(event: (index: number) => void) 当前显示的组件索引变化时触发该事件。 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-transition-animation-shared-elements.md b/zh-cn/application-dev/reference/arkui-ts/ts-transition-animation-shared-elements.md index 06e889473736a080f28dc92523efcbea2d0f6099..d08ba2205cdcbd8378790655af4b9f2f5d153e23 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-transition-animation-shared-elements.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-transition-animation-shared-elements.md @@ -1,29 +1,22 @@ # 共享元素转场 -> **说明：** -> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 - + 设置页面间转场时共享元素的转场动效。 -共享元素转场支持页面间的转场，如当前页面的图片转场至下一页面中。 +> **说明：** +> +> 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 ## 属性 -| 名称 | 参数 | 默认值 | 参数描述 | -| -------- | -------- | -------- | -------- | -| sharedTransition | id: string,
options?: Object | - | 两个页面的组件配置为同一个id，则转场过程中会进行共享元素转场，配置为空字符串时不会有共享元素转场效果。 | - -- options参数说明 - | 参数名称 | 参数类型 | 默认值 | 必填 | 参数描述 | - | -------- | -------- | -------- | -------- | -------- | - | duration | number | 1000 | 否 | 单位为毫秒，默认动画时长为1000毫秒。 | - | curve | Curve \| Curves | Linear | 否 | 默认曲线为线性，有效值参见Curve说明。 | - | delay | number | 0 | 否 | 单位为毫秒，默认不延时播放。 | +| 名称 | 参数 | 参数描述 | +| -------- | -------- | -------- | +| sharedTransition | id: string,
{
duration?: number,
curve?: Curve \| string,
delay?: number,
motionPath?:
{
path: string,
form?: number,
to?: number,
rotatable?: boolean
},
zIndex?: number,
type?: [SharedTransitionEffectType](ts-appendix-enums.md#sharedtransitioneffecttype)
} | 两个页面中id值相同且不为空字符串的组件即为共享元素，在页面转场时可显示共享元素转场动效。
-  id：设置组件的id。
-  duration：单位为毫秒，默认动画时长为1000毫秒。
- curve：默认曲线为Linear，有效值参见[Curve](ts-animatorproperty.md) 说明。
- delay：单位为毫秒，默认不延时播放。
- motionPath：运动路径信息。
- path：设置路径。
- from：设置起始值。
- to：设置终止值。
- rotatable：是否旋转。
- zIndex：设置Z轴。
- type：动画类型。 | ## 示例 -示例功能为两个页面，共享元素转场页面图片点击后转场至页面B的图片。 +示例代码为点击图片跳转页面时，显示共享元素图片的自定义转场动效。 ```ts // xxx.ets diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-flex-layout.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-flex-layout.md index c8863b0ed9bb10d7415669307930dc3a16775973..e4392200aba5b7b71652061faffa46965eec73fc 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-flex-layout.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-flex-layout.md @@ -2,24 +2,18 @@ > **说明：** > - 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 -> -> - 仅当父组件是Flex组件时生效。 - - -## 权限列表 - -无 +> - 仅当父组件是 Flex、Column、Row 时生效。 ## 属性 -| 名称 | 参数说明 | 默认值 | 描述 | -| -------- | -------- | -------- | -------- | -| flexBasis | 'auto' \| Length | 'auto' | 此属性所在的组件在Flex容器中主轴方向上基准尺寸。 | -| flexGrow | number | 0 | Flex容器的剩余空间分配给此属性所在组件的比例。 | -| flexShrink | number | 1 | Flex容器压缩尺寸分配给此属性所在组件的比例。 | -| alignSelf | [ItemAlign](ts-appendix-enums.md#itemalign) | Auto | 覆盖Flex布局容器中alignItems默认配置。 | +| 名称 | 参数说明 | 描述 | +| -------- | -------- | -------- | +| flexBasis | string \| number | 设置组件在父容器主轴方向上的基准尺寸。
默认值：'auto'（表示组件在主轴方向上的基准尺寸为组件原本的大小） | +| flexGrow | number | 设置父容器的剩余空间分配给此属性所在组件的比例。
默认值：0 | +| flexShrink | number | 设置父容器压缩尺寸分配给此属性所在组件的比例。
默认值：1 | +| alignSelf | [ItemAlign](ts-appendix-enums.md#itemalign) | 子组件在父容器交叉轴的对齐格式，覆盖Flex布局容器中alignItems默认配置。
默认值：ItemAlign.Auto | ## 示例 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-image-effect.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-image-effect.md index 7e7546c1f80be69e9c2ea8db06d8ba2c19f7e5fc..860a42fcc3782ab8f1248a35dd6cd7b8ac8f6737 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-image-effect.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-image-effect.md @@ -4,27 +4,22 @@ > 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 -## 权限列表 - -无 - - ## 属性 -| 名称 | 参数类型 | 默认值 | 描述 | -| ----------------------------- | ---------------------------------------- | ------ | ---------------------------------------- | -| blur | number | - | 为当前组件添加内容模糊效果，入参为模糊半径，模糊半径越大越模糊，为0时不模糊。 | -| backdropBlur | number | - | 为当前组件添加背景模糊效果，入参为模糊半径，模糊半径越大越模糊，为0时不模糊。 | -| shadow | {
radius: number,
color?: Color,
offsetX?: number,
offsetY?: number
} | - | 为当前组件添加阴影效果，入参为模糊半径(必填)、阴影的颜色(可选，默认为灰色)、X轴的偏移量(可选，默认为0)，Y轴的偏移量(可选，默认为0)，偏移量单位为px。 | -| grayscale | number | 0.0 | 为当前组件添加灰度效果。值定义为灰度转换的比例，入参1.0则完全转为灰度图像，入参则0.0图像无变化，入参在0.0和1.0之间时，效果呈线性变化。（百分比) | -| brightness | number | 1.0 | 为当前组件添加高光效果，入参为高光比例，值为1时没有效果，小于1时亮度变暗，0为全黑；大于1时亮度增加，数值越大亮度越大。 | -| saturate | number | 1.0 | 为当前组件添加饱和度效果，饱和度为颜色中的含色成分和消色成分(灰)的比例，入参为1时，显示原图像，大于1时含色成分越大，饱和度越大；小于1时消色成分越大，饱和度越小。（百分比） | -| contrast | number | 1.0 | 为当前组件添加对比度效果，入参为对比度的值，值为1时，显示原图；大于1时，值越大对比度越高，图像越清晰醒目；小于1时，值越小对比度越低；当对比度为0时，图像变为全灰。（百分比） | -| invert | number | 0 | 反转输入的图像。入参为图像反转的比例。值为1时完全反转。值为0则图像无变化。（百分比） | -| colorBlend 8+ | Color | - | 为当前组件添加颜色叠加效果，入参为叠加的颜色。 | -| sepia | number | 0 | 将图像转换为深褐色。入参为图像反转的比例。值为1则完全是深褐色的，值为0图像无变化。 （百分比） | -| hueRotate | number \| string | '0deg' | 为当前组件添加色相旋转效果，入参为旋转的角度值，0deg时图像无变化。入参没有最大值，超过360deg时相当于又绕一圈，即，370deg和10deg的色相旋转效果相同。 | +| 名称 | 参数类型 | 默认值 | 描述 | +| ----------------------------- | ------------------------------------------------------------ | ------ | ------------------------------------------------------------ | +| blur | number | - | 为当前组件添加内容模糊效果，入参为模糊半径，模糊半径越大越模糊，为0时不模糊。 | +| backdropBlur | number | - | 为当前组件添加背景模糊效果，入参为模糊半径，模糊半径越大越模糊，为0时不模糊。 | +| shadow | {
radius: number \| [Resource](ts-types.md#resource),
color?: [Color](ts-appendix-enums.md#color) \| string \| [Resource](ts-types.md#resource),
offsetX?: number \| [Resource](ts-types.md#resource),
offsetY?: number \| [Resource](ts-types.md#resource)
} | - | 为当前组件添加阴影效果，入参为模糊半径(必填)、阴影的颜色(可选，默认为灰色)、X轴的偏移量(可选，默认为0)，Y轴的偏移量(可选，默认为0)，偏移量单位为px。 | +| grayscale | number | 0.0 | 为当前组件添加灰度效果。值定义为灰度转换的比例，入参1.0则完全转为灰度图像，入参则0.0图像无变化，入参在0.0和1.0之间时，效果呈线性变化。（百分比) | +| brightness | number | 1.0 | 为当前组件添加高光效果，入参为高光比例，值为1时没有效果，小于1时亮度变暗，0为全黑；大于1时亮度增加，数值越大亮度越大。 | +| saturate | number | 1.0 | 为当前组件添加饱和度效果，饱和度为颜色中的含色成分和消色成分(灰)的比例，入参为1时，显示原图像，大于1时含色成分越大，饱和度越大；小于1时消色成分越大，饱和度越小。（百分比） | +| contrast | number | 1.0 | 为当前组件添加对比度效果，入参为对比度的值，值为1时，显示原图；大于1时，值越大对比度越高，图像越清晰醒目；小于1时，值越小对比度越低；当对比度为0时，图像变为全灰。（百分比） | +| invert | number | 0 | 反转输入的图像。入参为图像反转的比例。值为1时完全反转。值为0则图像无变化。（百分比） | +| colorBlend 8+ | [Color](ts-appendix-enums.md#color) \| string \| [ResourceColor](ts-types.md#resourcecolor) | - | 为当前组件添加颜色叠加效果，入参为叠加的颜色。 | +| sepia | number | 0 | 将图像转换为深褐色。入参为图像反转的比例。值为1则完全是深褐色的，值为0图像无变化。 （百分比） | +| hueRotate | number \| string | '0deg' | 为当前组件添加色相旋转效果，入参为旋转的角度值，0deg时图像无变化。入参没有最大值，超过360deg时相当于又绕一圈，即，370deg和10deg的色相旋转效果相同。 | ## 示例 @@ -73,3 +68,5 @@ struct ImageEffectsExample { } } ``` + +image-effect \ No newline at end of file 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 81a520f6a1ab3a3863566d37b64628deedc1e56d..b3c1c170691fc31b48d5669824562275ac91a3e1 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 @@ -5,21 +5,16 @@ > 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 -## 权限列表 - -无 - - ## 属性 -| 名称 | 参数类型 | 默认值 | 描述 | -| ---------- | ---------------------------------------- | ------------------------------------ | ---------------------------------------- | -| 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
} | 相对布局完成位置坐标偏移量，设置该属性，不影响父容器布局，仅在绘制时进行位置调整。 | +| 名称 | 参数类型 | 描述 | +| ---------- | ------------------------------------------------------------ | ------------------------------------------------------------ | +| align | [Alignment](ts-appendix-enums.md#alignment) | 设置元素内容的对齐方式，只有当设置的width和height大小超过元素本身内容大小时生效。
默认值：Alignment.Center | +| direction | [Direction](ts-appendix-enums.md#direction) | 设置元素水平方向的布局。
默认值：Direction.Auto | +| position | {
x: [Length](ts-types.md#length),
y: [Length](ts-types.md#length)
} | 使用绝对定位，设置元素锚点相对于父容器顶部起点的偏移位置。在布局容器中，设置该属性不影响父容器布局，仅在绘制时进行位置调整。 | +| markAnchor | {
x: [Length](ts-types.md#length),
y: [Length](ts-types.md#length)
} | 设置元素在位置定位时的锚点，以元素顶部起点作为基准点进行偏移。
默认值：
{
x: 0,
y: 1
} | +| offset | {
x: [Length](ts-types.md#length),
y: [Length](ts-types.md#length)
} | 相对布局完成位置坐标偏移量，设置该属性，不影响父容器布局，仅在绘制时进行位置调整。
默认值：
{
x: 0,
y: 1
} | ## 示例 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-transformation.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-transformation.md index e0842b4ee862730faf66ccd8a4788708be2ee09f..f0a583916cc6ce38599978e68d7dd24d41f68de4 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-transformation.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-attributes-transformation.md @@ -5,20 +5,15 @@ > 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 -## 权限列表 - -无 - - ## 属性 -| 名称 | 参数类型 | 默认值 | 描述 | -| --------- | ---------------------------------------- | ---------------------------------------- | ---------------------------------------- | -| rotate | {
x?: number,
y?: number,
z?: number,
angle?: Angle,
centerX?: Length,
centerY?: Length
} | {
x: 0,
y: 0,
z: 0,
angle: 0,
centerX: '50%',
centerY: '50%'
} | (x, y, z)指定一个矢量，表示旋转轴，正角度为顺时针转动，负角度为逆时针转动，默认值为0，同时可以通过centerX和centerY设置旋转的中心点。 | -| translate | {
x?: Length,
y?: Length,
z? : Length
} | {
x: 0,
y: 0,
z: 0
} | 可以分别设置X轴、Y轴、Z轴的平移距离，距离的正负控制平移的方向，默认值为0。 | -| scale | {
x?: number,
y?: number,
z?: number,
centerX?: Length,
centerY?: Length
} | {
x: 1,
y: 1,
z: 1,
centerX:'50%',
centerY:'50%'
} | 可以分别设置X轴、Y轴、Z轴的缩放比例，默认值为1，同时可以通过centerX和centerY设置缩放的中心点。 | -| transform | matrix: Matrix4 | - | 设置当前组件的变换矩阵。 | +| 名称 | 参数类型 | 描述 | +| --------- | ------------------------------------------------------------ | ------------------------------------------------------------ | +| rotate | {
x?: number,
y?: number,
z?: number,
angle?: number \| string,
centerX?: number \| string,
centerY?: number \| string
} | (x, y, z)指定一个矢量，表示旋转轴，正角度为顺时针转动，负角度为逆时针转动，默认值为0，同时可以通过centerX和centerY设置旋转的中心点。
默认值：
{
x: 0,
y: 0,
z: 0,
angle: 0,
centerX: '50%',
centerY: '50%'
} | +| translate | {
x?: number \| string,
y?: number \| string,
z? : number \| string
} | 可以分别设置X轴、Y轴、Z轴的平移距离，距离的正负控制平移的方向，默认值为0。
默认值：
{
x: 0,
y: 0,
z: 0
} | +| scale | {
x?: number,
y?: number,
z?: number,
centerX?: number \| string,
centerY?: number \| string
} | 可以分别设置X轴、Y轴、Z轴的缩放比例，默认值为1，同时可以通过centerX和centerY设置缩放的中心点。
默认值：
{
x: 1,
y: 1,
z: 1,
centerX:'50%',
centerY:'50%'
} | +| transform | matrix: Matrix4 | 设置当前组件的变换矩阵。 | ## 示例 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-show-hide.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-show-hide.md index 18b4258e5bddea469a77c278d41cfe8087bb34ff..d24ad3483e12f365489cef5580dc4dbea6a18e87 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-show-hide.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-events-show-hide.md @@ -5,17 +5,12 @@ > 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 -## 权限列表 - -无 - - ## 事件 -| 名称 | 支持冒泡 | 功能描述 | -| ---------------------------------------- | ---- | ------------- | -| onAppear(callback: () => void) | 否 | 组件挂载显示时触发此回调。 | -| onDisappear(callback: () => void) | 否 | 组件卸载消失时触发此回调。 | +| 名称 | 支持冒泡 | 功能描述 | +| ------------------------------------------------ | -------- | -------------------------- | +| onAppear(event: () => void) | 否 | 组件挂载显示时触发此回调。 | +| onDisappear(event: () => void) | 否 | 组件卸载消失时触发此回调。 | ## 示例 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-universal-focus-event.md b/zh-cn/application-dev/reference/arkui-ts/ts-universal-focus-event.md index d2628f18a01ef13f539c61cdf5dfaf8519731edc..89f94afe40060dbd6185556ad1ad780d478b19e4 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-universal-focus-event.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-universal-focus-event.md @@ -5,17 +5,12 @@ > 从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 -## 权限列表 - -无 - - ## 事件 -| **名称** | **支持冒泡** | **功能描述** | -| ---------------------------------------- | -------- | --------------- | -| onFocus(callback: () => void) | 否 | 当前组件获取焦点时触发的回调。 | -| onBlur(callback:() => void) | 否 | 当前组件失去焦点时触发的回调。 | +| **名称** | **支持冒泡** | **功能描述** | +| -------------------------------------------- | ------------ | ------------------------------ | +| onFocus(event: () => void) | 否 | 当前组件获取焦点时触发的回调。 | +| onBlur(event:() => void) | 否 | 当前组件失去焦点时触发的回调。 | > **说明：** > 支持焦点事件的组件：Button、Text、Image、List、Grid。