1# TextPicker 2 3滑动选择文本内容的组件。 4 5> **说明：** 6> 7> 该组件从API Version 8开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。 8 9 10## 子组件 11 12无 13 14 15## 接口 16 17TextPicker(options?: {range: string[]|Resource, selected?: number, value?: string}) 18 19根据range指定的选择范围创建文本选择器。 20 21**参数：** 22 23| 参数名 | 参数类型 | 必填 | 参数描述 | 24| -------- | -------- | -------- | -------- | 25| range | string[] \| [Resource](ts-types.md#resource类型) | 是 | 选择器的数据选择列表。不可设置为空数组，若设置为空数组，则不显示；若动态变化为空数组，则保持当前正常值显示。 | 26| selected | number | 否 | 设置默认选中项在数组中的索引值。<br/>默认值：0 | 27| value | string | 否 | 设置默认选中项的值，优先级低于selected。<br/>默认值：第一个元素值 | 28 29## 属性 30 31除支持[通用属性](ts-universal-attributes-size.md)外，还支持以下属性： 32 33| 名称 | 参数类型 | 描述 | 34| -------- | -------- | -------- | 35| defaultPickerItemHeight | number \| string | 设置Picker各选择项的高度。 | 36 37## 事件 38 39除支持[通用事件](ts-universal-events-click.md)外，还支持以下事件： 40 41| 名称 | 描述 | 42| -------- | -------- | 43| onChange(callback: (value: string, index: number) => void) | 滑动选中TextPicker文本内容后，触发该回调。<br/>- value: 当前选中项的文本。<br/>- index: 当前选中项的索引值。 | 44 45 46## 示例 47 48```ts 49// xxx.ets 50@Entry 51@Component 52struct TextPickerExample { 53 private select: number = 1 54 private fruits: string[] = ['apple1', 'orange2', 'peach3', 'grape4'] 55 56 build() { 57 Column() { 58 TextPicker({ range: this.fruits, selected: this.select }) 59 .onChange((value: string, index: number) => { 60 console.info('Picker item changed, value: ' + value + ', index: ' + index) 61 }) 62 } 63 } 64} 65``` 66 67 68
