tw_zipcode 1.5.2 → 1.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 3f2d3c5b0dca99be1caa90c9beb13c24daec5558
-  data.tar.gz: 616631312d51fc60590389ab160d38999f486882
+  metadata.gz: 120b31cbf691e25de425e9293523730ff423bec2
+  data.tar.gz: 04a4cb0d4238fcfc7963597f3efa91ccdd0daaaf
 SHA512:
-  metadata.gz: 51937762d1ec61ad926bd9280ca8e2264bcc70ca26006e93d1b0e63a8fbd75bf5345ffaa8badff4bab46368736650c88ef4ae94e8291f1a8b3e0bebfc3d8cf21
-  data.tar.gz: d38d91f4af32cf21950218cd3b9d430873942267fd24f689d915c505523ae8f47298d93f6e6f60baa6aeaa0011b4657980cc991ddf0c7771471c5ff7418ab451
+  metadata.gz: 8e119e60542ea816c64e7fbac51168ffa3f0806cf3d93d6909ca42238c68b3e3509633cc63447796bb2de3a2fbf56bdbb588699acb9cfc04021d8044f22bef9c
+  data.tar.gz: f9099c3bd0aaeaaf5be405354ad53bed5d0821081d31ae4ef7934a26da6d0b7b74cb5a3f54f749b14d8a69dd5df97f24b963b0f35a39ef163ff4e5a3f094033e

data/README.md

@@ -22,67 +22,76 @@
 
 把以下這行加入到`application.js`:
 
-```
+``` js
 //= require tw_zipcode
 ```
 ### Example
 
-預設樣式：
+預設：
 
-```
+``` html
+<!-- HTML -->
 <div id="twzipcode"></div>
 ```
 
-自訂樣式：
-
-```
-<div id="twzipcode">
-  <div data-role="county" data-style="county"></div>
-  <!--自訂縣市選單容器，以及套用 .county 樣式-->
-  <div data-role="district" data-style="district"></div>
-  <!--自訂鄉鎮市區選單容器，以及套用 .district 樣式-->
-  <div data-role="zipcode" data-style="zipcode"></div>
-  <!--自訂郵遞區號容器，以及套用 .zipcode 樣式-->
-</div>
+``` js
+/* Javascript */
+$('#twzipcode').twzipcode();
 ```
 
-javascripts:
+自訂樣式：
 
+``` css
+/* CSS */
+.zipcode {
+    background-color: #c00;
+    color: #fff;
+}
+.county {
+    background-color: #4169E1;
+    color: #fff;
+}
+.district {
+    background-color: #008000;
+    color: #fff;
+}
 ```
-$(function () {
-  $('#twzipcode').twzipcode({
-    countyName: 'address[city]',
-    districtName: 'address[district]',
-    zipcodeName: 'address[zip_code]',
-  });
+
+``` javascript
+/* Javascript */
+$('#twzipcode').twzipcode({
+    // 依序套用至縣市、鄉鎮市區及郵遞區號框
+    'css': ['county', 'district', 'zipcode']
 });
 ```
 裡面設定countyName, districtName, zipcodeName 可以配合自己的 model 跟 form_for helper。有時間看能不能把這些 javascripts 的設定改成用 helper 來使用。
 
 ## 參數
 
-名稱 | 類型 | 說明
---- | --- | ---
-detect | Boolean | 是否偵測用戶位置 **預設 false, 此功能提供的數據並非絕對正確，僅供參考**
-countyName | String | 指定縣市下拉清單的表單名稱 **預設 county**
-districtName | String | 指定鄉鎮市區下拉清單的表單名稱 **預設 district**
-zipcodeName | String | 指定郵遞區號輸入框的表單名稱 **預設 zipcode**
-countySel | String | 縣市預設值
-districtSel | String | 鄉鎮市區預設值
-zipcodeSel | String | 郵遞區號預設值
-onCountySelect | Function | 綁定縣市選單 Change 事件。 **version 1.5**
-onDistrictSelect | Function | 綁定鄉鎮市區選單 Change 事件。 **version 1.5**
-onZipcodeKeyUp | Function | 綁定郵遞區號輸入框 keyUp 事件（readonly 必須為 false）。 **version 1.5**
-readonly | Boolean | 郵遞區號輸入框是否唯讀？ **預設 true**
-css | Array | 表單元件樣式名稱 **格式: ['縣市', '鄉鎮市區', '郵遞區號']**
+名稱 | 類型 | 預設 | 說明
+--- | --- | --- | ---
+countyName | string | county | 指定縣市下拉清單的表單名稱。
+countySel | string | | 縣市預設值
+css | Array | | 表單元件樣式名稱。格式: ['縣市', '鄉鎮市區', '郵遞區號']
+detect | boolean | false | 是否偵測用戶位置（此功能提供的數據僅供參考）
+districtName | string | district | 指定鄉鎮市區下拉清單的表單名稱。
+districtSel | string | | 鄉鎮市區預設值
+onCountySelect | Function | |綁定縣市選單 Change 事件。
+onDistrictSelect | Function | |綁定鄉鎮市區選單 Change 事件。
+onZipcodeKeyUp | Function | |綁定郵遞區號輸入框 keyUp 事件（readonly 必須為 false）。
+readonly | boolean | true | 郵遞區號輸入框是否唯讀？
+zipcodeName | string | zipcode | 指定郵遞區號輸入框的表單名稱。
+zipcodeSel | string | | 郵遞區號預設值
+zipcodeIntoDistrict | boolean | false | 隱藏郵遞區號輸入框，並顯示於鄉鎮市區清單內。
 
 ## 方法
 
-方法 | 說明
+名稱 | 說明
 --- | ---
-destory | 從指定的元素移除 Plugin: **$(selector).twzipcode('destory');**
-reset | 將指定的元素恢復未選狀態: **$(selector).twzipcode('reset');**
-serialize | 將指定的元素輸出為 URL Query: **$(selector).twzipcode('serialize');**
+var foo = $(selector).twzipcode('data'); | 取得已選取縣市的郵遞區號 JSON 物件。
+var foo = $(selector).twzipcode('serialize'); | 取得 Query String。
+$(selector).twzipcode('reset'); | 重置清單。
+$(selector).twzipcode('destroy'); | 移除 TWzipcode plugin。
 
 ## Contributing
 
@@ -94,4 +103,4 @@ serialize | 將指定的元素輸出為 URL Query: **$(selector).twzipcode('seri
 
 ## Contact
 
-[@garylai1990](http://www.twitter.com/garylai1990)
+[@imgarylai](http://www.twitter.com/imgarylai)

data/lib/tw_zipcode/version.rb

@@ -1,3 +1,3 @@
 module TwZipcode
-  VERSION = "1.5.2"
+  VERSION = "1.7.1"
 end

data/tw_zipcode.gemspec

@@ -10,7 +10,7 @@ Gem::Specification.new do |spec|
   spec.email         = ["garylai1990@gmail.com"]
   spec.description   = %q{Provide taiwan's zipcode selector}
   spec.summary       = %q{This is a jquery plugin for Taiwan's zipcode selector}
-  spec.homepage      = "https://github.com/garylai1990/tw_zipcode"
+  spec.homepage      = "https://github.com/imgarylai/tw_zipcode"
   spec.license       = "MIT"
 
   spec.files         = `git ls-files`.split($/)