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

2024-01-22 17:30 更新

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

說明

該組件從API Version 8開始支持。后續(xù)版本如有新增內(nèi)容，則采用上角標(biāo)單獨(dú)標(biāo)記該內(nèi)容的起始版本。

子組件

無

接口

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

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

參數(shù)：

參數(shù)名

參數(shù)類型

必填

參數(shù)描述

range

string[] | Resource

是

選擇器的數(shù)據(jù)選擇列表。

selected

number

否

設(shè)置默認(rèn)選中項(xiàng)在數(shù)組中的索引值。

默認(rèn)值：0

value

string

否

設(shè)置默認(rèn)選中項(xiàng)的值，優(yōu)先級(jí)低于selected。

默認(rèn)值：第一個(gè)元素值

屬性

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

名稱

參數(shù)類型

描述

defaultPickerItemHeight

number | string

設(shè)置Picker各選擇項(xiàng)的高度。

事件

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

名稱

描述

onAccept(callback: (value: string, index: number) => void)

點(diǎn)擊彈窗中的“確定”按鈕時(shí)觸發(fā)該回調(diào)。

- value: 當(dāng)前選中項(xiàng)的文本。

- index: 當(dāng)前選中項(xiàng)的索引值。

說明：

該事件僅在文本滑動(dòng)選擇器彈窗中生效。

onCancel(callback: () => void)

點(diǎn)擊彈窗中的“取消”按鈕時(shí)觸發(fā)該回調(diào)。

說明：

該事件僅在文本滑動(dòng)選擇器彈窗中生效。

onChange(callback: (value: string, index: number) => void)

滑動(dòng)選中TextPicker文本內(nèi)容后，觸發(fā)該回調(diào)。

- value: 當(dāng)前選中項(xiàng)的文本。

- index: 當(dāng)前選中項(xiàng)的索引值。

示例

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

  8.   build() {
  9.     Column() {
  10.       TextPicker({ range: this.fruits, selected: this.select })
  11.         .onChange((value: string, index: number) => {
  12.           console.info('Picker item changed, value: ' + value + ', index: ' + index)
  13.         })
  14.     }
  15.   }
  16. }

以上內(nèi)容是否對(duì)您有幫助：
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)