TextPicker

滑動(dòng)選擇文本內(nèi)容的組件。

說(shuō)明：
開發(fā)前請(qǐng)熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
該組件從API Version 8開始支持。后續(xù)版本如有新增內(nèi)容，則采用上角標(biāo)單獨(dú)標(biāo)記該內(nèi)容的起始版本。

子組件

無(wú)

接口

TextPicker(options?: {range: string[] | string[][] | Resource | TextPickerRangeContent[] | TextCascadePickerRangeContent[], selected?: number, value?: string})

根據(jù)range指定的選擇范圍創(chuàng)建文本選擇器。

參數(shù)：

TextPickerRangeContent10+類型說(shuō)明

TextCascadePickerRangeContent10+類型說(shuō)明

屬性

除支持[通用屬性]外，還支持以下屬性：

事件

除支持[通用事件]外，還支持以下事件：

示例

示例1

// xxx.ets
class bottom {
  bottom:number = 50
}
let bott:bottom = new bottom()
@Entry
@Component
struct TextPickerExample {
  private select: number = 1
  private apfruits: string[] = ['apple1', 'apple2', 'apple3', 'apple4']
  private orfruits: string[] = ['orange1', 'orange2', 'orange3', 'orange4']
  private pefruits: string[] = ['peach1', 'peach2', 'peach3', 'peach4']
  private multi: string[][] = [this.apfruits, this.orfruits, this.pefruits]
  private cascade: TextCascadePickerRangeContent[] = [
    {
      text: '遼寧省',
      children: [{ text: '沈陽(yáng)市', children: [{ text: '沈河區(qū)' }, { text: '和平區(qū)' }, { text: '渾南區(qū)' }] },
        { text: '大連市', children: [{ text: '中山區(qū)' }, { text: '金州區(qū)' }, { text: '長(zhǎng)海縣' }] }]
    },
    {
      text: '吉林省',
      children: [{ text: '長(zhǎng)春市', children: [{ text: '南關(guān)區(qū)' }, { text: '寬城區(qū)' }, { text: '朝陽(yáng)區(qū)' }] },
        { text: '四平市', children: [{ text: '鐵西區(qū)' }, { text: '鐵東區(qū)' }, { text: '梨樹縣' }] }]
    },
    {
      text: '黑龍江省',
      children: [{ text: '哈爾濱市', children: [{ text: '道里區(qū)' }, { text: '道外區(qū)' }, { text: '南崗區(qū)' }] },
        { text: '牡丹江市', children: [{ text: '東安區(qū)' }, { text: '西安區(qū)' }, { text: '愛(ài)民區(qū)' }] }]
    }
  ]

  build() {
    Column() {

      TextPicker({ range: this.apfruits, selected: this.select })
        .onChange((value: string | string[], index: number | number[]) = > {
          console.info('Picker item changed, value: ' + value + ', index: ' + index)
        }).margin(bott)

      TextPicker({ range: this.multi })
        .onChange((value: string | string[], index: number | number[]) = > {
          console.info('TextPicker 多列:onChange ' + JSON.stringify(value) + ', ' + 'index: ' + JSON.stringify(index))
        }).margin(bott)

      TextPicker({ range: this.cascade })
        .onChange((value: string | string[], index: number | number[]) = > {
          console.info('TextPicker 多列聯(lián)動(dòng):onChange ' + JSON.stringify(value) + ', ' + 'index: ' + JSON.stringify(index))
        })
    }
  }
}

示例2

// xxx.ets
@Entry
@Component
struct TextPickerExample {
  private select: number = 1
  private fruits: string[] = ['apple1', 'orange2', 'peach3', 'grape4']

  build() {
    Column() {
      TextPicker({ range: this.fruits, selected: this.select })
        .onChange((value: string | string[], index: number | number[]) = > {
          console.info('Picker item changed, value: ' + value + ', index: ' + index)
        })
        .disappearTextStyle({color: Color.Red, font: {size: 15, weight: FontWeight.Lighter}})
        .textStyle({color: Color.Black, font: {size: 20, weight: FontWeight.Normal}})
        .selectedTextStyle({color: Color.Blue, font: {size: 30, weight: FontWeight.Bolder}})
    }.width('100%').height('100%')
  }
}

審核編輯 黃宇