Skip to content

Commit

Permalink
Update Demo
Browse files Browse the repository at this point in the history
更新示例
增加全球主要城市数据
  • Loading branch information
ciaoca committed Sep 1, 2014
1 parent beb22ba commit 2c244d7
Show file tree
Hide file tree
Showing 6 changed files with 2,229 additions and 167 deletions.
118 changes: 60 additions & 58 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,17 +4,53 @@ cxSelect 是基于 jQuery 的多级联动菜单插件,适用于省市、商品

列表数据通过 AJAX 获取(需要在服务器环境运行),也可以使用变量自定义,数据内容使用 JSON 格式。

提供国内省市县数据(数据来源:<a href="https://github.com/basecss/cityData" target="_blank">basecss/cityData</a> Date: 2014.03.31)
国内省市县数据来源:<a href="https://github.com/basecss/cityData" target="_blank">basecss/cityData</a> Date: 2014.03.31

全球主要城市数据来源:整理国内常用网站和软件 Date: 2014.07.29

**版本:**
* jQuery v1.7+
* jQuery cxSelect v1.3
* jQuery cxSelect v1.3.2

文档:http://code.ciaoca.com/jquery/cxselect/

示例:http://code.ciaoca.com/jquery/cxselect/demo/

##【options 参数说明】
##使用方法
###载入 JavaScript 文件
```html
<script src="jquery.js"></script>
<script src="jquery.cxselect.js"></script>
```

###DOM 结构
```html
<!--
select 必须放在元素 id="element_id" 的内部,不限层级
select 的 class 任意取值,也可以附加多个 class,如 class="province otherclass",在调用时只需要输入其中一个即可,但是不能重复
如需设置 select 默认值,加上 data-value 属性,例:<select class="province" data-value="浙江省"></select>
-->
<div id="element_id">
<select class="province"></select>
<select class="city"></select>
<select class="area"></select>
</div>
```

###调用 cxSelect
``` javascript
// selects 为数组形式,请注意顺序
$('#element_id').cxSelect({
selects: ['province', 'city', 'area'],
nodata: 'none'
});

// 设置全局默认值,需在引入 <script src="jquery.cxselect.js"></script> 之后,调用之前设置
$.cxSelect.defaults.url = 'cityData.min.json'; // 提示:如果服务器不支持 .json 类型文件,请将文件改为 .js 文件
$.cxSelect.defaults.nodata = 'none';
```

##参数说明
<table>
<tr>
<th width="120">名称</th>
Expand All @@ -29,7 +65,7 @@ cxSelect 是基于 jQuery 的多级联动菜单插件,适用于省市、商品
<tr>
<td>url</td>
<td>null</td>
<td>列表数据文件路径(URL) | 变量(值为 JSON 的结构)</td>
<td>列表数据文件路径(URL) | 变量(值为 JSON 的结构,参照自定义数据结构)</td>
</tr>
<tr>
<td>nodata</td>
Expand All @@ -39,21 +75,21 @@ cxSelect 是基于 jQuery 的多级联动菜单插件,适用于省市、商品
<tr>
<td>required</td>
<td>false</td>
<td>是否为必选。设为 flase 时,会在列表头部添加 &lt;option value="0"&gt;请选择&lt;/option&gt。</td>
<td>是否为必选。设为 flase 时,会在列表头部添加 <option value="0">请选择</option> 选项。</td>
</tr>
<tr>
<td>firstTitle</td>
<td>"请选择"</td>
<td>'请选择'</td>
<td>选框首选项的标题。如果要定义每个选框的首选项标题,可以通过属性 data-first-title 来设置。(仅在参数 required 为 false 时有效)</td>
</tr>
<tr>
<td>firstValue</td>
<td>"0"</td>
<td>'0'</td>
<td>选框首选项的值。如果要定义每个选框的首选项值,可以通过属性 data-first-value 来设置。(仅在参数 required 为 false 时有效)</td>
</tr>
</table>

##data 属性参数
##data 属性参数
<table>
<tr>
<th width="160">名称</th>
Expand All @@ -73,12 +109,12 @@ cxSelect 是基于 jQuery 的多级联动菜单插件,适用于省市、商品
</tr>
</table>

##数据 JSON 结构
##数据 JSON 结构
<table>
<thead>
<tr>
<th width="120">名称</th>
<th width="180">类型</th>
<th width="100">名称</th>
<th width="150">类型</th>
<th>说明</th>
</tr>
</thead>
Expand All @@ -99,59 +135,25 @@ cxSelect 是基于 jQuery 的多级联动菜单插件,适用于省市、商品
</tr>
</table>

##【使用方法】
###载入 JavaScript 文件
```html
<script src="jquery.js"></script>
<script src="jquery.cxselect.js"></script>
```

###DOM 结构
```html
<!--
select 必须放在元素 id="element_id" 的内部,不限层级
select 的 class 任意取值,也可以附加多个 class,如 class="province otherclass",在调用时只需要输入其中一个即可,但是不能重复
如需设置 select 默认值,加上 data-value 属性,例:<select class="province" data-value="浙江省"></select>
-->
<div id="element_id">
<select class="province"></select>
<select class="city"></select>
<select class="area"></select>
</div>
```

###调用 cxSelect
``` javascript
// selects 为数组形式,请注意顺序
$("#element_id").cxSelect({
selects : ["province", "city", "area"],
nodata : "none"
});

// 设置全局默认值,需在引入 <script src="jquery.cxselect.js"></script> 之后,调用之前设置
$.cxSelect.defaults.url = "cityData.min.json"; // 提示:如果服务器不支持 .json 类型文件,请将文件改为 .js 文件
$.cxSelect.defaults.nodata = "none";
```


##自定义数据结构
##自定义数据结构
``` javascript
/* 使用 JSON 格式
* v : 设置 option 的值(可选项,未设置则使用 n)
* n : 设置 option 的文本
* s : 当前选项的子集
* v: 设置 option 的值(可选项,未设置则使用 n)
* n: 设置 option 的文本
* s: 当前选项的子集
*/
[
{"v" : "1", "n" : "A"},
{"v" : "2", "n" : "B", "s" : [
{"v" : "3", "n" : "Banana"},
{"v" : "4", "n" : "Blue"},
{"v" : "5", "n" : "Bus"}
{"v": "1", "n": "A"},
{"v": "2", "n": "B", "s": [
{"v": "3", "n": "Banana"},
{"v": "4", "n": "Blue"},
{"v": "5", "n": "Bus"}
]},
{"v" : "6", "n" : "C"},
{"v" : "7", "n" : "D", "s" : [
{"v": "8", "n" : "day"},
{"v": "9", "n" : "del"}
{"v": "6", "n": "C"},
{"v": "7", "n": "D", "s": [
{"v": "8", "n": "day"},
{"v": "9", "n": "del"}
]}
]
```
12 changes: 0 additions & 12 deletions getcity.php

This file was deleted.

Loading

0 comments on commit 2c244d7

Please sign in to comment.