插件描述:cxSelect 是基于 jQuery 的多级联动菜单插件,适用于省市、商品分类等联动菜单。 列表数据通过 AJAX 获取(需要在服务器环境运行),也可以使用变量自定义,数据内容使用 JSON 格式。
载入 JavaScript 文件
1 <script src="jquery.js"></script>
2 <script src="jquery.cxselect.js"></script>
HTML代码
1 <!--
2 select 必须放在元素 id="element_id" 的内部,不限层级
3 select 的 class 任意取值,也可以附加多个 class,如 class="province otherclass",在调用时只需要输入其中一个即可,但是不能重复
4 如需设置 select 默认值,加上 data-value 属性,例:<select class="province" data-value="浙江省"></select>
5 -->
6 <div id="element_id">
7 <select class="province"></select>
8 <select class="city"></select>
9 <select class="area"></select>
10 </div>
调用 cxSelect
1 // selects 为数组形式,请注意顺序
2 $('#element_id').cxSelect({
3 url: 'cityData.min.json' // 提示:如果服务器不支持 .json 类型文件,请将文件改为 .js 文件
4 selects: ['province', 'city', 'area'],
5 nodata: 'none'
6 });
可设置全局默认值
1 // 需在引入 <script src="jquery.cxselect.js"></script> 之后,调用之前设置
2 $.cxSelect.defaults.url = 'cityData.min.json';
3 $.cxSelect.defaults.nodata = 'none';
参数说明
selects | [] | 下拉选框组。输入 select 的 className |
url | null | 列表数据文件路径(URL) | 对象(值为 JSON 的结构,参照自定义数据结构) |
nodata | null | 子集无数据时 select 的状态。可设置为:"none"(display:none), "hidden"(visibility:hidden) |
required | false | 是否为必选。设为 flase 时,会在列表头部添加 <option value="0">请选择</option> 选项。 |
firstTitle | '请选择' | 选框第一个项目的标题。如果要定义每个选框的第一个项目标题,可以通过 <select> 的 data-first-title 属性来设置。(仅在 required 为 false 时有效) |
firstValue | '0' | 选框第一个项目的值。如果要定义每个选框的第一个项目值,可以通过 <select> 的 data-first-value 属性来设置。(仅在 required 为 false 时有效) |
data 属性参数
在父元素上的 data- 属性
1 <div id="element_id" data-url="cityData.min.json" data-required="true"></select>
data-url | 列表数据文件路径(此处只能设置路径,自定义需要在参数中设置) |
data-nodata | 子集无数据时 select 的状态。 |
data-required | 是否为必选。 |
data-first-title | 所有下拉框的第一个项目的标题 |
data-first-value | 所有下拉框的第一个项目的值 |
在<select>元素上的 data- 属性
1 <select class="province" data-value="浙江省" data-first-title="选择省"></select>
data-value | 默认值 |
data-first-title | 第一个项目的标题 |
data-first-value | 第一个项目的值 |
数据 JSON 结构
v | string | number | 设置 option 的值(可选项,未设置则使用 n) |
n | string | 设置 option 的文本 |
s | array | 当前选项的子集 |
自定义数据结构
1 /* 使用 JSON 格式
2 * v: 设置 option 的值(可选项,未设置则使用 n)
3 * n: 设置 option 的文本
4 * s: 当前选项的子集
5 */
6 [
7 {'v': '1', 'n': 'A'},
8 {'v': '2', 'n': 'B', 's': [
9 {'v': '3', 'n': 'Banana'},
10 {'v': '4', 'n': 'Blue'},
11 {'v': '5', 'n': 'Bus'}
12 ]},
13 {'v': '6', 'n': 'C'},
14 {'v': '7', 'n': 'D', 's': [
15 {'v': '8', 'n': 'day'},
16 {'v': '9', 'n': 'del'}
17 ]}
18 ]