diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textpicker.md b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textpicker.md old mode 100644 new mode 100755 index 715cce8ba604110c0f608ccb8be9027d4061fb3a..2bbed5719a9e4c7cd2a1793bbd0614270bf16c67 --- a/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textpicker.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-basic-components-textpicker.md @@ -14,7 +14,7 @@ ## 接口 -TextPicker(options?: {range: string[]|Resource|TextPickerRangeContent[], selected?: number, value?: string}) +TextPicker(options?: {range: string[] | string[][] | Resource | TextPickerRangeContent[] | TextCascadePickerRangeContent[], selected?: number, value?: string}) 根据range指定的选择范围创建文本选择器。 @@ -22,9 +22,9 @@ TextPicker(options?: {range: string[]|Resource|TextPickerRangeContent[], selecte | 参数名 | 参数类型 | 必填 | 参数描述 | | -------- | -------- | -------- | -------- | -| range | string[] \| [Resource](ts-types.md#resource类型)\|[TextPickerRangeContent](#textpickerrangecontent10类型说明)[]10+ | 是 | 选择器的数据选择列表。不可设置为空数组,若设置为空数组,则不显示;若动态变化为空数组,则保持当前正常值显示。 | -| selected | number | 否 | 设置默认选中项在数组中的索引值。
默认值:0
从API version 10开始,该参数支持[$$](../../quick-start/arkts-two-way-sync.md)双向绑定变量。 | -| value | string | 否 | 设置默认选中项的值,优先级低于selected。
默认值:第一个元素值
**说明**:只有显示文本列表时该值有效。显示图片或图片加文本的列表时,该值无效。
从API version 10开始,该参数支持[$$](../../quick-start/arkts-two-way-sync.md)双向绑定变量。 | +| range | string[] \| string[][]10+ \| [Resource](ts-types.md#resource类型) \|
[TextPickerRangeContent](#textpickerrangecontent10类型说明)[]10+ \| [TextCascadePickerRangeContent](#textcascadepickerrangecontent10类型说明)[]10+ | 是 | 选择器的数据选择列表。不可设置为空数组,若设置为空数组,则不显示;若动态变化为空数组,则保持当前正常值显示。
**说明**:单列数据选择器使用string[],Resource,TextPickerRangeContent[]类型。
多列数据选择器使用string[][]类型。
多列联动数据选择器使用TextCascadePickerRangeContent[]类型。| +| selected | number \| number[]10+ | 否 | 设置默认选中项在数组中的索引值。
默认值:0
**说明**:单列数据选择器使用number类型。
多列、多列联动数据选择器使用number[]类型。
从API version 10开始,该参数支持[$$](../../quick-start/arkts-two-way-sync.md)双向绑定变量。| +| value | string \| string[]10+ | 否 | 设置默认选中项的值,优先级低于selected。
默认值:第一个元素值
**说明**:只有显示文本列表时该值有效。显示图片或图片加文本的列表时,该值无效。
单列数据选择器使用string类型。
多列、多列联动数据选择器使用string[]类型。
从API version 10开始,该参数支持[$$](../../quick-start/arkts-two-way-sync.md)双向绑定变量。| ## TextPickerRangeContent10+类型说明 @@ -33,6 +33,13 @@ TextPicker(options?: {range: string[]|Resource|TextPickerRangeContent[], selecte | icon | string \| [Resource](ts-types.md#resource) | 是 | 图片资源。 | | text | string \| [Resource](ts-types.md#resource) | 否 | 文本信息。 | +## TextCascadePickerRangeContent10+类型说明 + +| 参数名 | 参数类型 | 必填 | 参数描述 | +| ------ | -------------------------------------------------------- | ---- | ---------- | +| text | string \| [Resource](ts-types.md#resource) | 是 | 文本信息。 | +| children | [TextCascadePickerRangeContent](#textcascadepickerrangecontent10类型说明)[] | 否 | 联动数据。 | + ## 属性 除支持[通用属性](ts-universal-attributes-size.md)外,还支持以下属性: @@ -43,6 +50,7 @@ TextPicker(options?: {range: string[]|Resource|TextPickerRangeContent[], selecte | disappearTextStyle10+ | [PickerTextStyle](ts-basic-components-datepicker.md#pickertextstyle10类型说明) | 设置所有选项中最上和最下两个选项的文本颜色、字号、字体粗细。 | | textStyle10+ | [PickerTextStyle](ts-basic-components-datepicker.md#pickertextstyle10类型说明) | 设置所有选项中除了最上、最下及选中项以外的文本颜色、字号、字体粗细。 | | selectedTextStyle10+ | [PickerTextStyle](ts-basic-components-datepicker.md#pickertextstyle10类型说明) | 设置选中项的文本颜色、字号、字体粗细。 | +| selectedIndex10+ | number \| number[] | 设置默认选中项在数组中的索引值,优先级高于options中的选中值。
**说明**:单列数据选择器使用number类型。多列、多列联动数据选择器使用number[]类型。 | ## 事件 @@ -52,7 +60,7 @@ TextPicker(options?: {range: string[]|Resource|TextPickerRangeContent[], selecte | -------- | -------- | | onAccept(callback: (value: string, index: number) => void) | 点击弹窗中的“确定”按钮时触发该回调。

- value: 当前选中项的文本。
- index: 当前选中项的索引值。
**说明:**
该事件仅在[文本滑动选择器弹窗](ts-methods-textpicker-dialog.md)中生效。 | | onCancel(callback: () => void) | 点击弹窗中的“取消”按钮时触发该回调。
**说明:**
该事件仅在[文本滑动选择器弹窗](ts-methods-textpicker-dialog.md)中生效。 | -| onChange(callback: (value: string, index: number) => void) | 滑动选中TextPicker文本内容后,触发该回调。
- value: 当前选中项的文本。
**说明**:当显示文本或图片加文本列表时,value值为选中项中的文本值,当显示图片列表时,value值为空。
- index: 当前选中项的索引值。 | +| onChange(callback: (value: string \| string[]10+, index: number \| number[]10+) => void) | 滑动选中TextPicker文本内容后,触发该回调。
- value: 当前选中项的文本。(多列的情况,value为数组类型。)
- index: 当前选中项的索引值。(多列的情况,index为数组类型。)
**说明**:当显示文本或图片加文本列表时,value值为选中项中的文本值,当显示图片列表时,value值为空。 | ## 示例 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-methods-textpicker-dialog.md b/zh-cn/application-dev/reference/arkui-ts/ts-methods-textpicker-dialog.md old mode 100644 new mode 100755 index ddcc46f2eb5f74f02de54e5d3d07c2f520e29609..10ce2972bc9f5c0fa650fa919602d66c323b7af6 --- a/zh-cn/application-dev/reference/arkui-ts/ts-methods-textpicker-dialog.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-methods-textpicker-dialog.md @@ -32,8 +32,8 @@ show(options?: TextPickerDialogOptions) | 名称 | 类型 | 描述 | | -------- | -------- | -------- | -| value | string | 选中项的文本内容。
**说明**:当显示文本或图片加文本列表时,value值为选中项中的文本值,
当显示图片列表时,value值为空。 | -| index | number | 选中项在选择范围数组中的索引值。 | +| value | string \| string []10+ | 选中项的文本内容。
**说明**:当显示文本或图片加文本列表时,value值为选中项中的文本值。(文本选择器显示多列时,value为数组类型。)
当显示图片列表时,value值为空。 | +| index | number \| number []10+ | 选中项在选择范围数组中的索引值。(文本选择器显示多列时,index为数组类型。) | ## 示例 @@ -42,7 +42,7 @@ show(options?: TextPickerDialogOptions) @Entry @Component struct TextPickerDialogExample { - @State select: number = 2 + private select: number | number[] = 2 private fruits: string[] = ['apple1', 'orange2', 'peach3', 'grape4', 'banana5'] build() {