# @wines/picker-view-multi

> The picker-view-multi @wines

Latest version **2.0.0** (published 2025-04-01) · MIT license · 0 weekly downloads

## Install

```sh
npm install @wines/picker-view-multi
pnpm add @wines/picker-view-multi
yarn add @wines/picker-view-multi
bun add @wines/picker-view-multi
```

## Health

**Score 30/100 (F)** — status: maintenance-mode.

Positive: esm support; no vulnerabilities.

Warnings: low downloads; no types.

Negative: stale; low maintenance score.

## Facts

| | |
|---|---|
| Version | 2.0.0 |
| Published | 2025-04-01 |
| First published | 2021-04-25 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM |
| Node | >=16.0.0 |
| Dependencies | 6 |
| Unpacked size | 21 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Maintainers | tianyingchun |

## Links

- npm: https://www.npmjs.com/package/@wines/picker-view-multi
- Repository: https://gitlab.itcjf.com/wines/picker-view-multi
- npm.io page: https://npm.io/package/@wines/picker-view-multi

## Dependencies (6)

- [@dimjs/lang](https://npm.io/package/@dimjs/lang.md) ^2.1.1
- [@wines/core](https://npm.io/package/@wines/core.md) 2.0.0
- [@wines/spin](https://npm.io/package/@wines/spin.md) 2.0.0
- [@wines/styles](https://npm.io/package/@wines/styles.md) 2.0.0
- [@wines/picker-view](https://npm.io/package/@wines/picker-view.md) 2.0.0
- [@wines/picker-helpers](https://npm.io/package/@wines/picker-helpers.md) 2.0.0

## Recent versions

- 2.0.0 (latest) — 2025-04-01
- 2.0.0-next.7 (next) — 2025-04-01
- 2.0.0-next.6 — 2025-03-06
- 2.0.0-next.5 — 2025-03-05
- 2.0.0-next.4 — 2025-03-05
- 2.0.0-next.3 — 2025-03-04
- 2.0.0-next.2 — 2025-02-28
- 2.0.0-next.1 — 2025-02-27
- 2.0.0-next.0 — 2025-02-27
- 1.5.1 — 2023-03-07
- 1.5.0 — 2022-11-22
- 1.4.0 — 2022-02-23
- 1.3.5 — 2021-12-03
- 1.3.4 — 2021-09-26
- 1.3.2 — 2021-09-24
- … 2 more at https://npm.io/package/@wines/picker-view-multi/versions

## README

# `@wines/picker-view-multi`

# PickerViewMulti 多列选择器

嵌入页面的滚动选择器。

## 使用指南

### 在 page.json 中引入组件

```json
{
  "navigationBarTitleText": "PickerViewMulti",
  "usingComponents": {
    "wux-picker-view-multi": "@wines/picker-view-multi"
  }
}
```

### 示例

```xml
<view class="page">
	<view class="page__hd">
		<view class="page__title">PickerViewMulti</view>
		<view class="page__desc">多列选择器</view>
	</view>
	<view class="page__bd">
		<view class="sub-title">Multiple</view>
		<wux-picker-view-multi value="{{ value }}" options="{{ options }}" bind:valueChange="onValueChange" />
		<view class="sub-title">Single</view>
		<wux-picker-view-multi value="{{ value }}" options="{{ options[0] }}" bind:valueChange="onValueChange" />
		<view class="sub-title">Loading</view>
		<wux-picker-view-multi options="{{ options }}" loading />
	</view>
</view>

```

```ts
import './index.less';
import { PickerViewMultiGetValue } from '@wines/picker-view-multi';
const seasons = [
  ['王', '马', '蔡'],
  // 云效不支持特殊emojj
  ['撕葱', '粑粑', 'X'],
];
Page({
  data: {
    // 云效不支持特殊emojj
    value: ['蔡', 'X'],
    options: seasons,
  },
  onValueChange(e) {
    const detail = e.detail as PickerViewMultiGetValue;
    this.setData({ value: detail.value });
    console.log('onValueChange', e.detail);
  },
});
```

## API

### PickerViewMulti props

| 参数               | 类型            | 描述                                            | 默认值                                                   |
| ------------------ | --------------- | ----------------------------------------------- | -------------------------------------------------------- |
| prefixCls          | `string`        | 自定义类名前缀                                  | wux-popup-picker                                         |
| pickerPrefixCls    | `string`        | picker 自定义类名前缀                           | wux-picker-col                                           |
| value              | `array`         | 当前值                                          | []                                                       |
| 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`      | 滚动数据选择变化后的回调函数                    | -                                                        |

---
_Source: https://npm.io/package/@wines/picker-view-multi · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
