1 Star 0 Fork 42

麦琪 / iPicker

forked from FeCoder / iPicker 
加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README
MIT

iPicker

地区选择组件  |  查看在线示例

iPicker 是一个轻量级的地区选择组件,可以简单快速的对 “省市区” 进行选择
专门针对桌面端的现代高级浏览器,提供了两种版本供开发者根据项目需求自由选择

jQuery 插件版  |  Vue 组件版

数据来源 area-data

jQuery 插件版

引入文件

<!-- 要求 jquery 1.9.0+ -->
<script src="jquery.min.js"></script>
<script src="ipicker.min.js"></script>

创建容器

<div id="container"></div>

调用插件

$( "#container" ).iPicker({
    data: "area.json",
    onSelect: function ( value, text, set ) {
        console.log( value );
        console.log( text );
        console.log( set );
    }
});

jQuery 插件版提供的方法

$( elem ).iPicker( {} );           // 设置组件
$( elem ).iPicker( "clear" );      // 清空选择的结果
$( elem ).iPicker( "reset" );      // 重置组件
$( elem ).iPicker( "destroy" );    // 销毁组件
$( elem ).iPicker( "enabled" );    // 启用设置了 disabled 的选择框
$( elem ).iPicker();               // 获取选中结果

Vue 组件版

安装

npm install vue-ipicker -S

使用

// main.js
import iPicker from "vue-ipicker";
Vue.use( iPicker );
<template>
    <div id="app">
        <iPicker :options="options" @onSelect="select"></iPicker>
    </div>
</template>

<script>

    // 假设 area.json 文件放在了 static 里
    import AreaJSON from "../static/area.json";

    export default {
        name: "app",
        data () {
            return {
                options: {
                    data: AreaJSON
                }
            }
        },
        methods: {
            select ( value, text, set ) {
                console.log( value );
                console.log( text );
                console.log( set );
            }
        }
    }
</script>

API 参数

参数 说明 类型 默认值
data 地区的 json 数据,可传入三种形式的数据:
1. 直接传入 json 数据
2. 传入 Promise ( 仅限 jQuery 插件版!自动执行 then 方法来得到数据 )
3. json 文件地址( 仅限 jQuery 插件版!当传入 json 文件的地址时,程序会自动调用 $.getJSON() 请求数据 )
Object / String {}
level 显示的层级,范围 1-3,对应:省-市-区 Number 3
defautValue 默认选中值 Array []
disabled 禁用指定的选择框,true 表示全部禁用,传入数组可禁用指定层级,如:[ 1,2 ] 表示禁用第 2,3 级选择框 Boolean / Array false
width 选择框宽度,单位:px Number 200
maxHeight 下拉列表的最大高度,单位:px Number 300
placeholder 选择框占位文字 Array ["省", "市", "区"]
onSelect 选中列表中某一项后执行的回调函数,回调参数有三个:
1. 所有选中项的 value
2. 所有选中项的 text
3. 所有选中项的 value 和 text 集合

以上参数均返回数组形式
Function 空函数

开源协议

MIT License


浏览器支持

Chrome Firefox Opera Edge Safari IE
60+ 60+ 60+ 17+ 12+ 11+
MIT License Copyright (c) 2020 ZG Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

简介

轻量级的地区选择组件 展开 收起
JavaScript
MIT
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
JavaScript
1
https://gitee.com/emaiqi/iPicker.git
git@gitee.com:emaiqi/iPicker.git
emaiqi
iPicker
iPicker
master

搜索帮助