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 2a2f6ead698080cf344651e191e66d926f9527d9..0e2329e73872e4c3153b341ed3841d03716ae47a 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 @@ -20,8 +20,8 @@ Select(options: Array) | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | | ------ | ----------------------------------------------- | ---- | ------ | -------------- | - | value | [ResourceStr](../../ui/ts-types.md#ResourceStr) | 是 | - | 下拉选项内容。 | - | icon | [ResourceStr](../../ui/ts-types.md#ResourceStr) | 否 | - | 下拉选项图片。 | + | value | [ResourceStr](../../ui/ts-types.md) | 是 | - | 下拉选项内容。 | + | icon | [ResourceStr](../../ui/ts-types.md) | 否 | - | 下拉选项图片。 | ## 属性 @@ -29,14 +29,14 @@ Select(options: Array) | ----------------------- | --------------------------------------------------- | ------ | ----------------------------------------------- | | selected | number | - | 设置下拉菜单初始选择项的索引，第一项的索引为0。 | | value | string | - | 设置下拉按钮本身的文本显示。 | -| font | [Font](../../ui/ts-types.md#Font类型) | - | 设置下拉按钮本身的文本样式： | -| fontColor | [ResourceColor](../../ui/ts-types.md#ResourceColor) | - | 设置下拉按钮本身的文本颜色。 | -| selectedOptionBgColor | [ResourceColor](../../ui/ts-types.md#ResourceColor) | - | 设置下拉菜单选中项的背景色。 | -| selectedOptionFont | [Font](../../ui/ts-types.md#Font类型) | - | 设置下拉菜单选中项的文本样式： | -| selectedOptionFontColor | [ResourceColor](../../ui/ts-types.md#ResourceColor) | - | 设置下拉菜单选中项的文本颜色。 | -| optionBgColor | [ResourceColor](../../ui/ts-types.md#ResourceColor) | - | 设置下拉菜单项的背景色。 | -| optionFont | [Font](../../ui/ts-types.md#Font类型) | - | 设置下拉菜单项的文本样式： | -| optionFontColor | [ResourceColor](../../ui/ts-types.md#ResourceColor) | - | 设置下拉菜单项的文本颜色。 | +| font | [Font](../../ui/ts-types.md) | - | 设置下拉按钮本身的文本样式： | +| fontColor | [ResourceColor](../../ui/ts-types.md) | - | 设置下拉按钮本身的文本颜色。 | +| selectedOptionBgColor | [ResourceColor](../../ui/ts-types.md) | - | 设置下拉菜单选中项的背景色。 | +| selectedOptionFont | [Font](../../ui/ts-types.md) | - | 设置下拉菜单选中项的文本样式： | +| selectedOptionFontColor | [ResourceColor](../../ui/ts-types.md) | - | 设置下拉菜单选中项的文本颜色。 | +| optionBgColor | [ResourceColor](../../ui/ts-types.md) | - | 设置下拉菜单项的背景色。 | +| optionFont | [Font](../../ui/ts-types.md) | - | 设置下拉菜单项的文本样式： | +| optionFontColor | [ResourceColor](../../ui/ts-types.md) | - | 设置下拉菜单项的文本颜色。 | ## 事件 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textarea.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textarea.md index 4fec679e9e1f4146b99ffe3b45482e9fcc8eaad6..a4dcc8c383b8a9148ce2609f5246f74579bd4990 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textarea.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textarea.md @@ -48,15 +48,6 @@ TextArea(value?:{placeholder?: string controller?: TextAreaController}) | End | 水平对齐尾部。 | -### TextAreaController8+ - -TextArea组件的控制器，通过它操作TextArea组件。 - -| 接口名称 | 功能描述 | -| -------- | -------- | -| caretPosition(value: number): void | 设置输入光标的位置。
value：从字符串开始到光标所在位置的字符长度。 | - - ## 事件 | 名称 | 功能描述 | @@ -66,6 +57,28 @@ TextArea组件的控制器，通过它操作TextArea组件。 | onCut8+(callback:(value: string) => void) | 长按输入框内部区域弹出剪贴板后，点击剪切板剪切按钮，触发回调。
value：剪切的文本内容。 | | onPaste8+(callback:(value: string) => void) | 长按输入框内部区域弹出剪贴板后，点击剪切板粘贴按钮，触发回调。
value：粘贴的文本内容。 | +## TextAreaController8+ + +TextArea组件的控制器，通过它操作TextArea组件。 + +### 导入对象 + +``` +controller: TextAreaController = new TextAreaController() + +``` + +### caretPosition8+ + +caretPosition(value: number): void + +设置输入光标的位置。 + +- 参数 + | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | + | -------- | -------- | -------- | -------- | -------- | + | value | number | 是 | - | 从字符串开始到光标所在位置的字符长度。 | + ## 示例 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textclock.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textclock.md index 59ae3d50279805ec4e8e3a10c5e33cf79ce6ea51..bc07a54dc0468749fceea7586b6ad2bd02c4e264 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textclock.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textclock.md @@ -29,21 +29,35 @@ TextClock(options?: {timeZoneOffset?: number, contorller?: TextClockController}) | ------ | -------- | -------- | ------------------------------------------------------------ | | format | string | 'hhmmss' | 设置显示时间格式，如“yyyy/mm/dd”、“yyyy-mm-dd”等。支持的时间格式化字符串： | +## 事件 + +| 名称 | 功能描述 | +| -------------------------------------------- | ------------------------------------------------------------ | +| onDateChange(event: (value: number) => void) | 提供时间变化回调,该事件最小回调间隔为秒。
value: Unix Time Stamp，即自1970年1月1日（UTC）起经过的毫秒数。 | + ## TextClockController TextClock容器组件的控制器，可以将此对象绑定至TextClock组件，然后通过它控制文本时钟状态的启动与停止。 -| 接口名称 | 功能描述 | -| -------------------------------------------- | ------------------------------------------------------------ | -| start() | 启动文本时钟。 | -| stop() | 停止文本时钟。 | +### 导入对象 +``` +controller: TextClockController = new TextClockController() -## 事件 +``` + +### start + +start() + +启动文本时钟。 + +### stop + +stop() + +停止文本时钟。 -| 名称 | 功能描述 | -| -------------------------------------------- | ------------------------------------------------------------ | -| onDateChange(event: (value: number) => void) | 提供时间变化回调,该事件最小回调间隔为秒。
value: Unix Time Stamp，即自1970年1月1日（UTC）起经过的毫秒数。 | ## 示例 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-texttimer.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-texttimer.md index deff42598e71c13673bc15a99f880ef6b97d03fb..5d9ff611b08a83c496de270ca38ec0786dbb41bd 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-texttimer.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-texttimer.md @@ -28,18 +28,6 @@ TextTimer(options: { isCountDown?: boolean, count?: number, controller?: TextTim | count | number | 否 | 60000 | 倒计时时间（isCountDown为true时生效），单位为毫秒。
- count<=0时，使用默认值为倒计时初始值。
- count>0时，count值为倒计时初始值。 | | controller | [TextTimerController](#texttimercontroller) | 否 | null | TextTimer控制器。 | - -### TextTimerController - -TextTimer组件的控制器，用于控制文本计时器。 - -| 接口名称 | 功能描述 | -| -------- | -------- | -| start() | 计时开始。 | -| pause() | 计时暂停。 | -| reset() | 重置计时器。 | - - ## 属性 | 名称 | 参数类型 | 默认值 | 描述 | @@ -54,18 +42,48 @@ TextTimer组件的控制器，用于控制文本计时器。 | onTimer(callback: (utc: number, elapsedTime: number) => void) | 时间文本发生变化时触发。
utc：当前显示的时间，单位为毫秒。
elapsedTime：计时器经过的时间，单位为毫秒。 | +## TextTimerController + +TextTimer组件的控制器，用于控制文本计时器。 + +### 导入对象 + +``` +textTimerController: TextTimerController = new TextTimerController() + +``` + +### start + +start() + +计时开始。 + +### pause + +pause() + +计时暂停。 + +### reset + +reset() + +重置计时器。 + + ## 示例 ``` @Entry @Component struct TextTimerExample { - myTimerController: TextTimerController = new TextTimerController() + textTimerController: TextTimerController = new TextTimerController() @State format: string = 'hh:mm:ss.ms' build() { Column() { - TextTimer({controller: this.myTimerController}) + TextTimer({controller: this.textTimerController}) .format(this.format) .fontColor(Color.Black) .fontSize(50) @@ -74,13 +92,13 @@ struct TextTimerExample { }) Row() { Button("start").onClick(() => { - this.myTimerController.start(); + this.textTimerController.start(); }); Button("pause").onClick(() => { - this.myTimerController.pause(); + this.textTimerController.pause(); }); Button("reset").onClick(() => { - this.myTimerController.reset(); + this.textTimerController.reset(); }); } } diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md index 8de0f521c69a603c96b6a3c3f50591dac5aea3c1..b16902ae6b62f6b57bb046bbb5bb542636cc96bf 100755 --- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-web.md @@ -127,10 +127,10 @@ Web组件返回的请求/响应头对象。 - 参数 - | 参数名称 | 参数描述 | - | ----------- | ---------------------- | - | headerKey: string |

请求/响应头的key。

| - | headerValue: string |

请求/响应头的value。

| + | 参数名称 | 参数类型 |参数描述 | + | ----------- | ----------- |---------------------- | + | headerKey | string |请求/响应头的key。 | + | headerValue | string |请求/响应头的value。| ### WebResourceResponse对象说明 @@ -180,6 +180,12 @@ accessStep(step: number): boolean | ---- | ------ | ---- | ---- | --------------------- | | step | number | 是 | - | 要跳转的步数，正数代表前进，负数代表后退。 | +- 返回值 + + | 参数类型 | 说明 | + | ---- | ------ | + | boolean | 页面是否前进或后退 | + ### backward backward(): void diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-tabs.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-tabs.md index 0901e89cc92cb9e9aa7a812626f7c572024b7d95..dc4ebb5e6880bf743b284ffdbb644f36a7d1f1f3 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-container-tabs.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-tabs.md @@ -35,15 +35,6 @@ Tabs(value: {barPosition?: BarPosition, index?: number, controller?: [TabsContro | End | vertical属性方法设置为true时，页签位于容器右侧；vertical属性方法设置为false时，页签位于容器底部。 | -### TabsController - -Tabs组件的控制器，用于控制Tabs组件进行页签切换。 - -| 接口名称 | 功能描述 | -| -------- | -------- | -| changeIndex(value: number): void | 控制Tabs切换到指定页签，index: 页签在Tabs里的索引值，索引值从0开始。 | - - ## 属性 不支持触摸热区设置。 @@ -70,6 +61,28 @@ Tabs组件的控制器，用于控制Tabs组件进行页签切换。 | -------- | -------- | | onChange(callback: (index: number) => void) | Tab页签切换后触发的事件。 | +## TabsController + +Tabs组件的控制器，用于控制Tabs组件进行页签切换。 + +### 导入对象 + +``` +controller: TabsController = new TabsController() + +``` + +### changeIndex + +changeIndex(value: number): void + +控制Tabs切换到指定页签。 + +- 参数 + | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | + | -------- | -------- | -------- | -------- | -------- | + | value | number | 是 | - | 页签在Tabs里的索引值，索引值从0开始。 | + ## 示例 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-media-components-video.md b/zh-cn/application-dev/reference/arkui-ts/ts-media-components-video.md index 0fe5b3d9d85515eafc9daf6d28ac5173f92b0dc5..bd6ad396e3050b5bddf50f30ca2192c14ecbd45e 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-media-components-video.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-media-components-video.md @@ -60,18 +60,75 @@ Video(value: VideoOptions) | onUpdate(event?: { time: number }) => void | 播放进度变化时触发该事件，单位为s，更新时间间隔为250ms。 | -### VideoController +## VideoController -> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明：** -> 一个VideoController对象可以控制一个或多个video。 +一个VideoController对象可以控制一个或多个video。 -| 接口名称 | 描述 | -| -------- | -------- | -| start() : void | 开始播放。 | -| pause() : void | 暂停播放。 | -| stop() : void | 停止播放。 | -| setCurrentTime(value: number) | 指定视频播放的进度位置。 | -| setCurrentTime(value: number, seekMode: SeekMode | 指定视频播放的进度位置，并指定跳转模式。 | + +### 导入对象 + +``` +controller: VideoController = new VideoController(); +``` + + +### start + +start(): void + +开始播放。 + +### pause + +pause(): void + +暂停播放。 + +### stop + +stop(): void + +停止播放。 + +### setCurrentTime + +setCurrentTime(value: number) + +指定视频播放的进度位置。 + +- 参数 + | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | + | -------- | -------- | -------- | -------- | -------- | + | value | number | 是 | - | 视频播放进度位置。 | + +### requestFullscreen + +requestFullscreen(value: boolean) + +请求全屏播放。 + +- 参数 + | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | + | -------- | -------- | -------- | -------- | -------- | + | value | number | 是 | false | 是否全屏播放。 | + +### exitFullscreen + +exitFullscreen() + +退出全屏播放。 + +### setCurrentTime8+ + +setCurrentTime(value: number, seekMode: SeekMode) + +指定视频播放的进度位置，并指定跳转模式。 + +- 参数 + | 参数名 | 参数类型 | 必填 | 默认值 | 参数描述 | + | -------- | -------- | -------- | -------- | -------- | + | value | number | 是 | - | 视频播放进度位置。 | + | seekMode | SeekMode | 是 | - | 跳转模式。 | - SeekMode8+类型接口说明 | 名称 | 描述 | @@ -82,6 +139,7 @@ Video(value: VideoOptions) | Accurate | 精准跳转，不论是否为关键帧。 | + ## 示例 ``` @@ -93,7 +151,7 @@ struct VideoCreateComponent { @State currentProgressRates: number = 1; @State autoPlays: boolean = false; @State controlsss: boolean = true; - myVideoController: VideoController = new VideoController(); + controller: VideoController = new VideoController(); @State startStaus: boolean = true; build() { Column() { @@ -101,7 +159,7 @@ struct VideoCreateComponent { src: this.srcs, previewUri: this.previewUris, currentProgressRate: this.currentProgressRates, - controller: this.myVideoController + controller: this.controller }).width(700).height(500) .autoPlay(this.autoPlays) .controls(this.controlsss) @@ -151,19 +209,19 @@ struct VideoCreateComponent { Row() { Button("start").onClick(() => { - this.myVideoController.start(); + this.controller.start(); }); Button("pause").onClick(() => { - this.myVideoController.pause(); + this.controller.pause(); }); Button("stop").onClick(() => { - this.myVideoController.stop(); + this.controller.stop(); }); } Row() { Button("setCurrentTime").onClick(() => { - this.myVideoController.setCurrentTime(9, SeekMode.Accurate); + this.controller.setCurrentTime(9, SeekMode.Accurate); }); } }