npm.io
2.0.0 • Published 1 year ago

@wines/picker-view

Licence
MIT
Version
2.0.0
Deps
5
Size
47 kB
Vulns
0
Weekly
0

@wines/picker-view PickerView 单列选择器

PickerView 单列选择器

嵌入页面的滚动选择器。

使用指南

在 page.json 中引入组件

{
  "navigationBarTitleText": "PickerView",
  "usingComponents": {
    "wux-picker-view": "@wines/picker-view"
  }
}
示例
<view class="page">
	<view class="page__hd">
		<view class="page__title">PickerView</view>
		<view class="page__desc">单列选择器</view>
	</view>
	<view class="page__bd">
		<view class="sub-title">Default</view>
		<wux-picker-view options="{{ options[0] }}" />
		<view class="sub-title">Loading</view>
		<wux-picker-view options="{{ options[0] }}" loading />
		<view class="sub-title">Controlled</view>
		<wux-picker-view
		 value="{{ value }}"
		 controlled
		 options="{{ options[1] }}"
		 bind:valueChange="onValueChange"
		/>
	</view>
</view>
import { PickerViewGetValue } from '@wines/picker-view';
import './index.less';

const seasons = [
  ['王', '马', '蔡'],
  // 云效不支持特殊emojj
  ['撕葱', '粑粑', 'X'],
];

Page({
  data: {
    value: '粑粑',
    options: seasons,
  },
  onValueChange(e) {
    const detail = e.detail as PickerViewGetValue;
    this.setData({ value: detail.value });
    console.log('onValueChange', detail);
  },
});

API

PickerView props
参数 类型 描述 默认值
prefixCls string 自定义类名前缀 wux-picker-col
defaultValue string 默认值,当 controlledfalse 时才生效 -
value string 当前值,当 controlledtrue 时才生效 -
controlled boolean 是否受控 说明文档 false
itemHeight number 每列子元素的高度 34
itemStyle string,object 每列子元素的样式 -
indicatorStyle string,object 设置选择器中间选中框的样式 -
indicatorClass string 设置选择器中间选中框的类名 -
maskStyle string,object 设置蒙层的样式 -
maskClass string 设置蒙层的类名 -
labelAlign string 设置文本对齐方式,可选值为 right、center、left center
loading boolean 是否显示 loading 状态 false
defaultFieldNames object 自定义 options 中的 value、label、children 字段 { label: 'label', value: 'value', children: 'children' }
options array 可选项数据源 []
options[].value string 属性值 -
options[].label string 描述 -
options[].children array 子选项 []
options[].disabled boolean 是否禁用 false
bind:beforeChange function 当滚动选择开始时的回调函数 -
bind:valueChange function 每列数据选择变化后的回调函数 -
bind:scrollChange function 滚动数据选择变化后的回调函数 -
PickerView externalClasses
名称 描述
wux-class 根节点样式类
wux-mask-class 蒙层的类名
wux-indicator-class 选择器中间选中框的类名
wux-content-class 选择器主体内容的类名