代码拉取完成,页面将自动刷新
同步操作将从 FeCoder/iPicker 强制同步,此操作会覆盖自 Fork 仓库以来所做的任何修改,且无法恢复!!!
确定后同步将在后台操作,完成时将刷新页面,请耐心等待。
iPicker 是一个轻量级的地区选择组件,可以简单快速的对 “省市区” 进行选择
专门针对桌面端的现代高级浏览器,无任何第三方依赖完全使用原生 JavaScript 开发
<script src="ipicker.min.js"></script>
<script src="https://unpkg.com/new-ipicker"></script>
<script src="https://cdn.jsdelivr.net/npm/new-ipicker"></script>
npm i new-ipicker -S
const iPicker = require( "new-ipicker" );
iPicker
方法即可:<div id="target"></div>
<script>
// 此处以通过 jquery 库获取数据为例
$.getJSON( "area.json" ).then(function ( response ) {
iPicker("#target", {
data: response
});
})
</script>
<div id="target"></div>
<script>
// 此处以通过 jquery 库获取数据为例
iPicker("#target", {
data: $.getJSON( "area.json" )
});
</script>
$.getJSON( "area.json" ).then(function ( response ) {
iPicker("#target", {
data: response,
theme: "cascader"
});
})
$.getJSON( "area.json" ).then(function ( response ) {
iPicker("#target", {
data: response,
selected: [ "230000", "230100", "230103" ]
// 也可以是 name 形式
// selected: [ "黑龙江省", "哈尔滨市", "南岗区" ]
});
})
$.getJSON( "area.json" ).then(function ( response ) {
iPicker("#target", {
data: response,
onSelect: function ( code, name, all ) {
// 有三种返回值(均为数组形式)
console.log( code );
console.log( name );
console.log( all );
}
});
})
var picker = iPicker( "#target", { ... } );
// 获取选中结果(前两种等效)
iPicker.get( picker );
iPicker.get( picker, "code" );
iPicker.get( picker, "name" );
iPicker.get( picker, "all" );
// 清空选中结果
iPicker.clear( picker );
// 重置(恢复初始状态)
iPicker.reset( picker );
// 启用(全部)
iPicker.enabled( picker );
// 启用(指定层级,范围:0-2,仅限 select 主题模式下)
iPicker.enabled( picker, [ 0, 1 ] );
// 禁用(全部)
iPicker.disabled( picker );
// 禁用(指定层级,范围:0-2,仅限 select 主题模式下)
iPicker.disabled( picker, [ 0, 1 ] );
// 销毁(移除 iPicker 组件)
iPicker.destroy( picker );
参数 | 说明 | 类型 | 默认值 |
theme | 主题模式,可选值:select, cascader | String | select |
data | 地区的 json 数据(必填项),可直接传入数据或传入 Promise | Object | {} |
level | 数据的展示层级,范围:0-2(代表 1-3 级,省-市-区) | Number | 2 |
width | 展示框的宽度,单位:px,cascader 模式下建议适当的增加 | Number | 200 |
maxHeight | 数据列表的最大高度,单位:px | Number | 300 |
activeColor | 设置选中项的高亮颜色 | String | #00b8ff |
disabled | 默认禁用的展示框,设置为 true 时将禁用所有展示框; 在 select 模式下可传入数组形式,设置禁用指定层级的展示框,范围:0-2(代表 1-3 级,省-市-区) |
Boolean / Array | false |
selected | 默认选中项,可以是 name 或 code 形式 | Array | [] |
placeholder | 展示框的占位文字,select 模式下是数组形式,cascader 模式下是字符串形式 | String / Array | [ "省", "市", "区" ] |
onSelect | 选择项改变时执行的回调函数,有 3 个回调参数: 1. code 数组 2. name 数组 3. code 与 name 的数组集合 |
Function | 空函数 |
Chrome | Firefox | Opera | Edge | Safari | IE |
---|---|---|---|---|---|
60+ | 60+ | 60+ | 17+ | 12+ | 11+ |
此处可能存在不合适展示的内容,页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容,可点击提交进行申诉,我们将尽快为您处理。