tw_zipcode 1.5.2 → 1.7.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/README.md +49 -40
- data/lib/tw_zipcode/version.rb +1 -1
- data/tw_zipcode.gemspec +1 -1
- data/vendor/assets/javascripts/tw_zipcode.js +838 -350
- data/vendor/assets/javascripts/tw_zipcode.min.js +32 -1
- metadata +13 -13
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA1:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 120b31cbf691e25de425e9293523730ff423bec2
|
|
4
|
+
data.tar.gz: 04a4cb0d4238fcfc7963597f3efa91ccdd0daaaf
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 8e119e60542ea816c64e7fbac51168ffa3f0806cf3d93d6909ca42238c68b3e3509633cc63447796bb2de3a2fbf56bdbb588699acb9cfc04021d8044f22bef9c
|
|
7
|
+
data.tar.gz: f9099c3bd0aaeaaf5be405354ad53bed5d0821081d31ae4ef7934a26da6d0b7b74cb5a3f54f749b14d8a69dd5df97f24b963b0f35a39ef163ff4e5a3f094033e
|
data/README.md
CHANGED
|
@@ -22,67 +22,76 @@
|
|
|
22
22
|
|
|
23
23
|
把以下這行加入到`application.js`:
|
|
24
24
|
|
|
25
|
-
```
|
|
25
|
+
``` js
|
|
26
26
|
//= require tw_zipcode
|
|
27
27
|
```
|
|
28
28
|
### Example
|
|
29
29
|
|
|
30
|
-
|
|
30
|
+
預設：
|
|
31
31
|
|
|
32
|
-
```
|
|
32
|
+
``` html
|
|
33
|
+
<!-- HTML -->
|
|
33
34
|
<div id="twzipcode"></div>
|
|
34
35
|
```
|
|
35
36
|
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
<div id="twzipcode">
|
|
40
|
-
<div data-role="county" data-style="county"></div>
|
|
41
|
-
<!--自訂縣市選單容器，以及套用 .county 樣式-->
|
|
42
|
-
<div data-role="district" data-style="district"></div>
|
|
43
|
-
<!--自訂鄉鎮市區選單容器，以及套用 .district 樣式-->
|
|
44
|
-
<div data-role="zipcode" data-style="zipcode"></div>
|
|
45
|
-
<!--自訂郵遞區號容器，以及套用 .zipcode 樣式-->
|
|
46
|
-
</div>
|
|
37
|
+
``` js
|
|
38
|
+
/* Javascript */
|
|
39
|
+
$('#twzipcode').twzipcode();
|
|
47
40
|
```
|
|
48
41
|
|
|
49
|
-
|
|
42
|
+
自訂樣式：
|
|
50
43
|
|
|
44
|
+
``` css
|
|
45
|
+
/* CSS */
|
|
46
|
+
.zipcode {
|
|
47
|
+
background-color: #c00;
|
|
48
|
+
color: #fff;
|
|
49
|
+
}
|
|
50
|
+
.county {
|
|
51
|
+
background-color: #4169E1;
|
|
52
|
+
color: #fff;
|
|
53
|
+
}
|
|
54
|
+
.district {
|
|
55
|
+
background-color: #008000;
|
|
56
|
+
color: #fff;
|
|
57
|
+
}
|
|
51
58
|
```
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
59
|
+
|
|
60
|
+
``` javascript
|
|
61
|
+
/* Javascript */
|
|
62
|
+
$('#twzipcode').twzipcode({
|
|
63
|
+
// 依序套用至縣市、鄉鎮市區及郵遞區號框
|
|
64
|
+
'css': ['county', 'district', 'zipcode']
|
|
58
65
|
});
|
|
59
66
|
```
|
|
60
67
|
裡面設定countyName, districtName, zipcodeName 可以配合自己的 model 跟 form_for helper。有時間看能不能把這些 javascripts 的設定改成用 helper 來使用。
|
|
61
68
|
|
|
62
69
|
## 參數
|
|
63
70
|
|
|
64
|
-
名稱 | 類型 | 說明
|
|
65
|
-
--- | --- | ---
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
districtSel |
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
71
|
+
名稱 | 類型 | 預設 | 說明
|
|
72
|
+
--- | --- | --- | ---
|
|
73
|
+
countyName | string | county | 指定縣市下拉清單的表單名稱。
|
|
74
|
+
countySel | string | | 縣市預設值
|
|
75
|
+
css | Array | | 表單元件樣式名稱。格式: ['縣市', '鄉鎮市區', '郵遞區號']
|
|
76
|
+
detect | boolean | false | 是否偵測用戶位置（此功能提供的數據僅供參考）
|
|
77
|
+
districtName | string | district | 指定鄉鎮市區下拉清單的表單名稱。
|
|
78
|
+
districtSel | string | | 鄉鎮市區預設值
|
|
79
|
+
onCountySelect | Function | |綁定縣市選單 Change 事件。
|
|
80
|
+
onDistrictSelect | Function | |綁定鄉鎮市區選單 Change 事件。
|
|
81
|
+
onZipcodeKeyUp | Function | |綁定郵遞區號輸入框 keyUp 事件（readonly 必須為 false）。
|
|
82
|
+
readonly | boolean | true | 郵遞區號輸入框是否唯讀？
|
|
83
|
+
zipcodeName | string | zipcode | 指定郵遞區號輸入框的表單名稱。
|
|
84
|
+
zipcodeSel | string | | 郵遞區號預設值
|
|
85
|
+
zipcodeIntoDistrict | boolean | false | 隱藏郵遞區號輸入框，並顯示於鄉鎮市區清單內。
|
|
78
86
|
|
|
79
87
|
## 方法
|
|
80
88
|
|
|
81
|
-
|
|
89
|
+
名稱 | 說明
|
|
82
90
|
--- | ---
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
91
|
+
var foo = $(selector).twzipcode('data'); | 取得已選取縣市的郵遞區號 JSON 物件。
|
|
92
|
+
var foo = $(selector).twzipcode('serialize'); | 取得 Query String。
|
|
93
|
+
$(selector).twzipcode('reset'); | 重置清單。
|
|
94
|
+
$(selector).twzipcode('destroy'); | 移除 TWzipcode plugin。
|
|
86
95
|
|
|
87
96
|
## Contributing
|
|
88
97
|
|
|
@@ -94,4 +103,4 @@ serialize | 將指定的元素輸出為 URL Query: **$(selector).twzipcode('seri
|
|
|
94
103
|
|
|
95
104
|
## Contact
|
|
96
105
|
|
|
97
|
-
[@
|
|
106
|
+
[@imgarylai](http://www.twitter.com/imgarylai)
|
data/lib/tw_zipcode/version.rb
CHANGED
data/tw_zipcode.gemspec
CHANGED
|
@@ -10,7 +10,7 @@ Gem::Specification.new do |spec|
|
|
|
10
10
|
spec.email = ["garylai1990@gmail.com"]
|
|
11
11
|
spec.description = %q{Provide taiwan's zipcode selector}
|
|
12
12
|
spec.summary = %q{This is a jquery plugin for Taiwan's zipcode selector}
|
|
13
|
-
spec.homepage = "https://github.com/
|
|
13
|
+
spec.homepage = "https://github.com/imgarylai/tw_zipcode"
|
|
14
14
|
spec.license = "MIT"
|
|
15
15
|
|
|
16
16
|
spec.files = `git ls-files`.split($/)
|