# mpvue-citypicker

> 基于 mpvue 框架的城市选择器，含 code

Latest version **1.0.6** (published 2019-06-24) · MIT license · 0 weekly downloads

## Install

```sh
npm install mpvue-citypicker
pnpm add mpvue-citypicker
yarn add mpvue-citypicker
bun add mpvue-citypicker
```

## Health

**Score 15/100 (F)** — status: abandoned.

Positive: no vulnerabilities.

Warnings: low downloads; no types; no esm support.

Negative: abandoned; low maintenance score.

## Facts

| | |
|---|---|
| Version | 1.0.6 |
| Published | 2019-06-24 |
| First published | 2018-08-30 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Node | >= 4.0.0 |
| Dependencies | 0 |
| Unpacked size | 265.9 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 37 |
| Author | KuangPF |
| Maintainers | kuangpengfei |

## Links

- npm: https://www.npmjs.com/package/mpvue-citypicker
- Repository: https://github.com/MPComponent/mpvue-citypicker
- Homepage: https://github.com/MPComponent/mpvue-citypicker#readme
- Issues: https://github.com/MPComponent/mpvue-citypicker/issues
- npm.io page: https://npm.io/package/mpvue-citypicker

## Recent versions

- 1.0.6 (latest) — 2019-06-24
- 1.0.5 — 2019-06-05
- 1.0.4 — 2019-05-22
- 1.0.3 — 2019-05-21
- 1.0.2 — 2018-08-30
- 1.0.1 — 2018-08-30

## README

# mpvue-citypicker

> 基于 mpvue 框架的城市选择器，含 code

数据来源于 [Administrative-divisions-of-China](https://github.com/modood/Administrative-divisions-of-China),用 nodejs 对其数据进行了重组。

![npm version](https://img.shields.io/npm/v/mpvue-citypicker.svg?style=flat)
![download](https://img.shields.io/npm/dm/mpvue-citypicker.svg?style=flat)
![license](https://img.shields.io/github/license/MPComponent/mpvue-citypicker.svg)

## 使用

* 安装
``` bash
npm install mpvue-citypicker --save
```

* 在页面中使用
``` vue
<template>
    <mpvue-city-picker ref="mpvueCityPicker" :pickerValueDefault="pickerValueDefault" @onChange="onChange" @onCancel="onCancel" @onConfirm="onConfirm"></mpvue-city-picker>
</template>

<script>
import mpvueCityPicker from 'mpvue-citypicker';
export default {
  data() {
    return {
      pickerValueDefault: [0, 0, 1]
    };
  },
  components: {
    mpvueCityPicker
  },
  methods: {
    showCityPicker() {
      this.$refs.mpvueCityPicker.show();
    },
    onChange(e) {
      console.log(e);
    },
    onCancel(e) {
      console.log(e);
    },
    onConfirm(e) {
      console.log(e);
    }
  }
};
</script>
```

* 初始化

在父组件中调用 ` mpvueCityPicker` 实例中的 `show` 方法即可

``` javascript
this.$refs.mpvueCityPicker.show();
```

## 效果
<div align="center">
  <img src="https://github.com/KuangPF/mpvue-citypicker/blob/master/data/img/mpvue-citypicker01.png" width="320px">
  <img src="https://github.com/KuangPF/mpvue-citypicker/blob/master/data/img/mpvue-citypicker02.png" width="320px">
</div>

## 参数说明

### pickerValueDefault
* 说明：citypicker 默认选中值
* 类型：Array
* 可选值：-
* 是否必填： 否
* 默认值：[0, 0, 0]

### themeColor
* 说明：主题色
* 类型：String
* 可选值：-
* 是否必填： 否
* 默认值：#1aad19

### onChange
* 说明：citypicker 组件滚动时回调，返回选中的返回 label , value 以及 code 的值
* 类型：EventHandle
* 可选值：-
* 是否必填： 否
* 默认值：-

### onConfirm
* 说明：citypicker 组件点击确定时回调，返回选中的返回 label , value 以及 code 的值
* 类型：EventHandle
* 可选值：-
* 是否必填： 否
* 默认值：-

### onCancel
* 说明：citypicker 组件点击取消时回调，返回选中的返回 label , value 以及 code 的值
* 类型：EventHandle
* 可选值：-
* 是否必填： 否
* 默认值：-


## 版本日志

[version logs](https://github.com/MPComponent/mpvue-citypicker/releases)

---
_Source: https://npm.io/package/mpvue-citypicker · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._