1.1.1 • Published 5 years ago

bovine-city-selector v1.1.1

Weekly downloads
2
License
ISC
Repository
github
Last release
5 years ago

bovine-city-selector

城市选择器插件

优点

  1. 体积小,更轻量(最终打包生成的文件 12KB,再加上依赖的城市 JSON 文件一共 62KB);
  2. 兼容性好,兼容目前市面上所有有兼容必要的浏览器,包括移动端;
  3. 配置项多,更个性化;

安装

  1. npm 安装:
npm install bovine-city-selector --save-dev
  1. 引入方式
全局变量:
window.CitySelector
commonjs:
const CitySelector = require("bovine-city-selector")
es6:
import CitySelector from "bovine-city-selector";
  1. 引入官方 css 样式
<link rel="stylesheet" href="引入路径/bovine-city-selector/dist/city-selector.css" />

用法

基本用法:

html:

<div class="city-selector-container">
	<input type="text" data-type="city-selector" class="city-selector-input" placeholder="请选择所在城市" />
</div>

js:

var citySelectorContainer = document.querySelector(".city-selector-container")
var citySel = new CitySelector(citySelectorContainer)
简易展示数据:

html (input 添加自定义属性 data-simple="true")

<div class="city-selector-container">
	<input
		type="text"
		data-type="city-selector"
		data-simple="true"
		class="city-selector-input"
		placeholder="请选择所在城市"
	/>
</div>
强制获取地址:

html (input 添加自定义属性 data-force="true")

<div class="city-selector-container">
	<input
		type="text"
		data-type="city-selector"
		data-force="true"
		class="city-selector-input"
		placeholder="请选择所在城市"
	/>
</div>

参数:

参数名类型默认值备注
defaultDataObjectprovince(省份),city(城市),district(地区)默认城市
actionNameObjecttitle(选择器名称),cancelBtn(取消按钮),confirmBtn(确认按钮)自定义信息
tabsArraytab 栏标签
errorTipsObjectnoPro(未选省份),noCity(未选城市),noDis(未选区域)错误提示

API:

confirm():参数:data。点击确定后返回用户选择的城市对象,以供作自定义处理。

cancel():用户点击取消按钮后响应的事件。