PullPicker.md

PullPicker{} 上拉选择器

PullPicker 为上拉选择器静态类, 一般用于触发显示一个数据列表供用户选择, 表现形式为从屏幕下方拖出抽屉。
PullPicker 基于 Overlay{} 实现。

Static Methods

Method	Params	Returns	Notes
Overlay methods			PullPicker 继承 Overlay 的全部静态方法。
show	title, items, selectedIndex, onSelected, options	key	显示一个上拉选择器, 重写 Overlay{} 中的同名函数, 输入参数 title 为列表标题, items 为可选项列表, selectedIndex 为已选项编号, onSelected 为选择某项时的回调函数, options(可空)为 PullPicker.PullPickerView 其它属性, 参数类型参见 PullPickerView。 返回唯一的浮层 key 值。

Static Props

Prop	Type	Default	Note
PullPickerView	class		PullPicker 内容显示组件。

<PullPicker.PullPickerView /> Props

Prop	Type	Default	Note
Overlay.PullView props...			PullPicker.PullPickerView 组件继承 Overlay.PullView 组件的全部属性。
title	string		列表标题。
items	array		可选项列表, 数组元素可以是任何类型。
selectedIndex	number		当前已选择项编号。
getItemText	func		取 items 数组元素的显示文本, 传入参数为(item, index), item = items[index], 默认直接使用 item

<PullPicker.PullPickerView /> Events

Event Name	Returns	Notes
Overlay.PullView events...		PullPicker.PullPickerView 组件继承 Overlay.PullView 组件的全部事件。
onSelected	item, index	当选择器选择 items 数组某项时调用, item = items[index]。

<PullPicker.PullPickerView /> Static Props

Prop	Type	Default	Note
Item	class		PullPicker 可选项显示组件。

<PullPicker.PullPickerView.Item /> Props

Prop	Type	Default	Note
ListRow props...			PullPicker.PullPickerView.Item 组件继承 ListRow 组件的全部属性。
selected	bool		是否已选中。

Example

简单用法

let items = [
  'Apple',
  'Banana',
  'Cherry',
  'Durian',
  'Filbert',
  'Grape',
  'Hickory',
  'Lemon',
  'Mango',
];
PullPicker.show(
  'Select item',
  items,
  this.state.selectedIndex,
  (item, index) => this.setState({selectedIndex: index})
);

Screenshots