{"_id":"jquery-twzipcode","_rev":"9-c5624e59157317f234d3092e0473bea8","name":"jquery-twzipcode","description":"建立三碼臺灣郵遞區號下拉清單的 jQuery Plugin - 讀取快速、不需資料庫。","dist-tags":{"latest":"1.7.15-rc1"},"versions":{"1.7.13":{"name":"jquery-twzipcode","title":"jQuery TWzipcode","description":"建立三碼臺灣郵遞區號下拉清單的 jQuery Plugin - 讀取快速、不需資料庫。","version":"1.7.13","keywords":["jquery-plugin"],"repository":{"type":"git","url":"git://github.com/essoduke/jquery-twzipcode.git"},"author":{"name":"Essoduke Chang","url":"https://essoduke.org"},"licenses":"MIT","files":["jquery.twzipcode.min.js","LICENSE.md","README.md"],"main":"jquery.twzipcode.js","bugs":{"url":"https://github.com/essoduke/jQuery-TWzipcode/issues"},"homepage":"https://code.essoduke.org/twzipcode/","dependencies":{"jquery":">=1.6"},"scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"license":"MIT","_id":"jquery-twzipcode@1.7.13","_shasum":"f6e0c8ad48e69c6c4ad139f76e05d7818550bb24","_from":".","_npmVersion":"4.5.0","_nodeVersion":"6.10.3","_npmUser":{"name":"essoduke","email":"essoduke@gmail.com"},"dist":{"shasum":"f6e0c8ad48e69c6c4ad139f76e05d7818550bb24","tarball":"https://registry.npmjs.org/jquery-twzipcode/-/jquery-twzipcode-1.7.13.tgz","integrity":"sha512-+i/LLaJBX2KFnOqd1LS9CDVnmB2AduC8y4cIfmdG8Ds3OWVBXIbRER+ud1R7bQ6jTeVeYirNV49T68l/+XURQA==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIAgpLoamAmJVDSyxQ7GrLI07ADggQu9ns52t0nAixKQcAiBpBihTG2oZ4w4pLU2nPRhxj9bexKFX8+LgZHvaLSb2Hw=="}]},"maintainers":[{"name":"essoduke","email":"essoduke@gmail.com"}],"_npmOperationalInternal":{"host":"packages-12-west.internal.npmjs.com","tmp":"tmp/jquery-twzipcode-1.7.13.tgz_1494326350665_0.9460425695870072"},"directories":{}},"1.7.12":{"name":"jquery-twzipcode","title":"jQuery TWzipcode","description":"建立三碼臺灣郵遞區號下拉清單的 jQuery Plugin - 讀取快速、不需資料庫。","version":"1.7.12","keywords":["jquery-plugin"],"repository":{"type":"git","url":"git://github.com/essoduke/jquery-twzipcode.git"},"author":{"name":"Essoduke Chang","url":"https://essoduke.org"},"licenses":"MIT","files":["jquery.twzipcode.min.js","LICENSE.md","README.md"],"main":"jquery.twzipcode.js","bugs":{"url":"https://github.com/essoduke/jQuery-TWzipcode/issues"},"homepage":"https://code.essoduke.org/twzipcode/","dependencies":{"jquery":">=1.6"},"scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"license":"MIT","_id":"jquery-twzipcode@1.7.12","_shasum":"54a4877f29ebdc8089fbacd350d92ec065751e7f","_from":".","_npmVersion":"4.5.0","_nodeVersion":"6.10.3","_npmUser":{"name":"essoduke","email":"essoduke@gmail.com"},"dist":{"shasum":"54a4877f29ebdc8089fbacd350d92ec065751e7f","tarball":"https://registry.npmjs.org/jquery-twzipcode/-/jquery-twzipcode-1.7.12.tgz","integrity":"sha512-aP66tCobDwjOhapjNS+MRvIUGLRNGbEa7dMUArvn69Sz8t/vm3+gL1EJaPsy1iyNMPDgohy3L7vOAsAovh4GiQ==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEYCIQCvnIptZVIGtBl8DKDX3Ia/N/Dct++nrS69NDmG4IXo9QIhALis2Ruwh2J+7dsBlUrllXyle7Y5GV+982R19Z1DkIJS"}]},"maintainers":[{"name":"essoduke","email":"essoduke@gmail.com"}],"_npmOperationalInternal":{"host":"packages-18-east.internal.npmjs.com","tmp":"tmp/jquery-twzipcode-1.7.12.tgz_1494326748274_0.19740531709976494"},"directories":{}},"1.7.14":{"name":"jquery-twzipcode","title":"jQuery TWzipcode","description":"建立三碼臺灣郵遞區號下拉清單的 jQuery Plugin - 讀取快速、不需資料庫。","version":"1.7.14","keywords":["jquery-plugin"],"repository":{"type":"git","url":"git://github.com/essoduke/jquery-twzipcode.git"},"author":{"name":"Essoduke Chang","url":"https://essoduke.org"},"licenses":"MIT","files":["jquery.twzipcode.min.js","LICENSE.md","README.md"],"main":"jquery.twzipcode.js","bugs":{"url":"https://github.com/essoduke/jQuery-TWzipcode/issues"},"homepage":"https://code.essoduke.org/twzipcode/","dependencies":{"jquery":">=1.6"},"scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"license":"MIT","_id":"jquery-twzipcode@1.7.14","_shasum":"57e389c6a452a9d88578231282d5651596043d7d","_from":".","_npmVersion":"4.5.0","_nodeVersion":"6.10.3","_npmUser":{"name":"essoduke","email":"essoduke@gmail.com"},"dist":{"shasum":"57e389c6a452a9d88578231282d5651596043d7d","tarball":"https://registry.npmjs.org/jquery-twzipcode/-/jquery-twzipcode-1.7.14.tgz","integrity":"sha512-aYGQHEFuaKkR9o0kPH2k3XFcwRva7AjuXjuiAu8h47yzKWky3DFfwSbsrb6iFJGkQfSpoAYQ/M3s6E2paiNYPw==","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIQCJQFebsJc9u24pOHdZddwUa/l4ZQzhNEmNu54lwOB6+wIgeHuOJk49xXJW2Zg91r1qKGwoXUfVowpaRIiQaTO76hI="}]},"maintainers":[{"name":"essoduke","email":"essoduke@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/jquery-twzipcode-1.7.14.tgz_1498468248082_0.7121518913190812"},"directories":{},"deprecated":"wrong version number"},"1.7.1-4.1":{"name":"jquery-twzipcode","title":"jQuery TWzipcode","description":"建立三碼臺灣郵遞區號下拉清單的 jQuery Plugin - 讀取快速、不需資料庫。","version":"1.7.1-4.1","keywords":["jquery-plugin"],"repository":{"type":"git","url":"git://github.com/essoduke/jquery-twzipcode.git"},"author":{"name":"Essoduke Chang","url":"https://essoduke.org"},"licenses":"MIT","files":["jquery.twzipcode.min.js","LICENSE.md","README.md"],"main":"jquery.twzipcode.js","bugs":{"url":"https://github.com/essoduke/jQuery-TWzipcode/issues"},"homepage":"https://code.essoduke.org/twzipcode/","dependencies":{"jquery":">=1.6"},"scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"license":"MIT","_id":"jquery-twzipcode@1.7.1-4.1","_npmVersion":"5.0.3","_nodeVersion":"6.10.3","_npmUser":{"name":"essoduke","email":"essoduke@gmail.com"},"dist":{"integrity":"sha512-2vDuxoijDY612L4DV6ToeucQ526aGap7TxOelrQ4vzDAoIHEcnLsgXTww4iWPmFyQgOikzRCsPP3x3T/ZN3njA==","shasum":"bffe3f1a4e9e807cb608d03d57b41f3a9fad8135","tarball":"https://registry.npmjs.org/jquery-twzipcode/-/jquery-twzipcode-1.7.1-4.1.tgz","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEUCIEeaud7vm3NNCmbheVOqEbVrjZDnbh4d7lgaZGVec122AiEAttiOo9vN8nYLCkeu6+FO2LgoQ61ZfpcHsxeDgs97r6w="}]},"maintainers":[{"name":"essoduke","email":"essoduke@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/jquery-twzipcode-1.7.1-4.1.tgz_1498468348529_0.0516319926828146"},"directories":{},"deprecated":"wrong version number"},"1.7.15-rc1":{"name":"jquery-twzipcode","title":"jQuery TWzipcode","description":"建立三碼臺灣郵遞區號下拉清單的 jQuery Plugin - 讀取快速、不需資料庫。","version":"1.7.15-rc1","keywords":["jquery-plugin"],"repository":{"type":"git","url":"git://github.com/essoduke/jquery-twzipcode.git"},"author":{"name":"Essoduke Chang","url":"https://essoduke.org"},"licenses":"MIT","files":["jquery.twzipcode.min.js","LICENSE.md","README.md"],"main":"jquery.twzipcode.js","bugs":{"url":"https://github.com/essoduke/jQuery-TWzipcode/issues"},"homepage":"https://code.essoduke.org/twzipcode/","dependencies":{"jquery":">=1.6"},"scripts":{"test":"echo \"Error: no test specified\" && exit 1"},"license":"MIT","_id":"jquery-twzipcode@1.7.15-rc1","_npmVersion":"6.1.0","_nodeVersion":"6.10.3","_npmUser":{"name":"essoduke","email":"essoduke@gmail.com"},"dist":{"integrity":"sha512-TRtLJZbgGvTR9pq0ySTVE/q23dj0zJZu2iBS4Kz9EiPXmLGPX0esEXBhwEa8UxOdHsn/+pBUaIYKjZ8sydEFWA==","shasum":"5ad8b3783dc0f50e656a9e6f9d5219334621fdfc","tarball":"https://registry.npmjs.org/jquery-twzipcode/-/jquery-twzipcode-1.7.15-rc1.tgz","fileCount":5,"unpackedSize":52974,"npm-signature":"-----BEGIN PGP SIGNATURE-----\r\nVersion: OpenPGP.js v3.0.4\r\nComment: https://openpgpjs.org\r\n\r\nwsFcBAEBCAAQBQJbMcHGCRA9TVsSAnZWagAASacQAI+STKobcX38odWu72XT\nmPjCeBElpRMMuMgkJkAYH6ptCumqYm7IMK+526zF18f4++nWvenCvACtiRjL\nKWX4FqVBFL2FxlU2wZwq1UT2l8v+ijy7Y/hOceHL3ncfU77rn4He+jHcAGCx\nI4V2lULCmd6KpF8i++scKLDC1yfOxwNUpPg+SohFpmyzkDEb8QA6wPiT787v\nD4ruiN8Wla/QdAc59ReCb+6cbJvJwBMUxaCK8dgTasffYRhP0X5ACDmza0n3\n14ou2L4yrANJsirsV23r0F8iX26ZMHeQ3CBZ7/qlN7XaoezdGDLvssKwJbzY\njuDrO4szB1QiMXBOr81qg4xeq8hwdo/ESFzWk19Z6A8dtRqRvgs31KEoVf9w\nrxeIOfTTzIz8llj+MI1CxY1t+8Gd3ZApHXz/Aom5LRU63tnYcxdOlvFYtZX+\nK6RgLmAVnicqZ4jRp7+dOuIWjCr0CzK2VTkRmt0AW7J79NFMeDGsjyAKrmIE\nGe99DZ67WTF1Tb1QY/VOAFIuCBardn3QBXEZ6FQzMxJUc0xtHlHu3vxbpLwY\nDWYIFAAnLy5lopts6zzK31/9gyP33F64hAxleJ5yBm92cAkdH9hX29FKFS/h\npm5PzAlAD8U1r2CuI+GWSgo41/mufak7wkdNkCKe0c7HOBoOsPerNCoMFaBm\naQaL\r\n=mm//\r\n-----END PGP SIGNATURE-----\r\n","signatures":[{"keyid":"SHA256:jl3bwswu80PjjokCgh0o2w5c2U4LhQAE57gj9cz1kzA","sig":"MEQCIC+CwxRPB/LGxOfxQ2xVUuYqbNjfsE0ay6Mkmfiz5xVgAiBOEZssO8yxnWnC6LI9EImXKdcUXnGISXUQNXFdO76VxQ=="}]},"maintainers":[{"name":"essoduke","email":"essoduke@gmail.com"}],"directories":{},"_npmOperationalInternal":{"host":"s3://npm-registry-packages","tmp":"tmp/jquery-twzipcode_1.7.15-rc1_1529987526758_0.8277422665866603"},"_hasShrinkwrap":false}},"readme":"# jQuery-TWzipcode\r\n\r\n在網頁建立多組 3 碼臺灣郵遞區號表單元素的 jQuery Plugin ─ 讀取快速、不需使用資料庫。\r\n\r\n[範例展示 Live Demo](https://code.essoduke.org/twzipcode/)\r\n\r\n\r\n\\* **jQuery-TWzipcode v1.5 以後版本需 jQuery v1.6（支援 2.0）**\r\n\r\n\r\n## 多國語言 i18n\r\n\r\nDownload: [branch v1.6.1](https://github.com/essoduke/jQuery-TWzipcode/tree/i18n)\r\n\r\n新增參數\r\n\r\n```javascript\r\nlanguage: 'language file path' //預設自動判斷\r\n```\r\n\r\nExample\r\n```javascript\r\n$(selector).twzipcode({\r\n  language: 'lang/zh-tw' //不需加上 .js\r\n});\r\n```\r\n## 安裝 Install\r\n### bower\r\n```\r\n$bower install jquery-TWzipcode\r\n```\r\n\r\n## 使用 Usage\r\n\r\nHTML\r\n```html\r\n...\r\n<script src=\"//ajax.googleapis.com/ajax/libs/jquery/1.11.1/jquery.min.js\"></script>\r\n<script src=\"jquery.twzipcode.min.js\"></script>\r\n\r\n<!-- Normal -->\r\n<div id=\"twzipcode\"></div>\r\n\r\n<!-- OR HTML5 data-* (Version 1.5+) -->\r\n\r\n<div id=\"twzipcode\">\r\n  <div data-role=\"county\" data-style=\"Style Name\" data-value=\"110\"></div>\r\n  <div data-role=\"district\" data-style=\"Style Name\" data-value=\"臺北市\"></div>\r\n  <div data-role=\"zipcode\" data-style=\"Style Name\" data-value=\"信義區\"></div>\r\n</div>\r\n```\r\n\r\nJavascript\r\n```javascript\r\n$('#twzipcode').twzipcode();\r\n```\r\n\r\n## 選項 Options\r\n\r\n### css (Array)\r\n設置元素的樣式名稱，依序為 `['縣市清單', '鄉鎮市區清單', '郵遞區號輸入框']`\r\n\r\n### googleMapsKey (string)\r\n`v1.6.9` Google Maps Geolocation API 金鑰。若您達到 Geocoder 的每日限制用量，可透過購買來提高用量，同時需設置金鑰。\r\n_預設值: ''_\r\n\r\n### detect  (boolean|Function)\r\n`v1.6.7` 是否自動偵測用戶位置。不需引入 Google Maps API。\r\n_預設值: false_\r\n\r\n### countyName (string)\r\n指定縣市下拉清單元素的表單名稱。\r\n_預設值: county_\r\n\r\n### countySel (string)\r\n縣市清單的預設值\r\n\r\n### districtName (string)\r\n鄉鎮市區下拉清單的表單名稱。\r\n_預設值: district_\r\n\r\n### districtSel (string)\r\n鄉鎮市區的預設值\r\n\r\n### zipcodeName (string)\r\n郵遞區號輸入框的表單名稱。\r\n_預設值: zipcode_\r\n\r\n### zipcodeSel (string)\r\n郵遞區號輸入框的預設值（此選項優先於 countySel, districtSel）\r\n\r\n### zipcodeIntoDistrict (bool)\r\n`v1.6.6` 是否隱藏郵遞區號輸入框並顯示於鄉鎮市區清單內？\r\n_預設值: false_\r\n\r\n### onCountySelect (function)\r\n`v1.5` 綁定縣市選單 Change 事件。\r\n\r\n### onDistrictSelect (function)\r\n`v1.5` 綁定鄉鎮市區選單 Change 事件。\r\n\r\n### onZipcodeKeyUp (function)\r\n`v1.5` 綁定郵遞區號輸入框 keyUp 事件（readonly 必須為 false）。\r\n\r\n### readonly (boolean)\r\n郵遞區號輸入框是否唯讀？\r\n_預設值: true_\r\n\r\n### hideCounty (array)\r\n`v1.7.9` 要隱藏的縣市名稱，例如 ['臺北市', '宜蘭縣'...]\r\n_預設值: []_\r\n\r\n### hideDistrict (array)\r\n`v1.7.9` 要隱藏的鄉鎮市區，可以是名稱或三碼郵遞區號例如 ['大安區', '110'...]\r\n_預設值: []_\r\n\r\n\r\n## 方法 Methods\r\n\r\n### data\r\n取得已選取縣市的郵遞區號資料\r\n```javascript\r\nvar data = $(selector).twzipcode('data');\r\nconsole.log(data);\r\n```\r\n\r\n### destroy\r\n從指定的元素移除 Plugin\r\n```javascript\r\n$(selector).twzipcode('destroy');\r\n```\r\n\r\n### get\r\n```javascript\r\n// 取得縣市 county（返回字串）\r\nvar county = $(selector).twzipcode('get', 'county');\r\n\r\n// 取得縣市 county 以及鄉鎮市區 district（返回陣列）\r\nvar result = $(selector).twzipcode('get', 'county,district'); // 以 , 字串傳入\r\nvar result = $(selector).twzipcode('get', ['county', 'district']);  // 以陣列傳入\r\n\r\n// Callback\r\n$(selector).twzipcode('get', function (county, district, zipcode) {\r\n    console.log(county);   // 縣市\r\n    console.log(district); // 鄉鎮市區\r\n    console.log(zipcode);  // 郵遞區號\r\n});\r\n```\r\n\r\n### set\r\n```javascript\r\n// 直接設置郵遞區號\r\n$(selector).twzipcode('set', 110);\r\n// 傳入縣市、鄉鎮市區\r\n$(selector).twzipcode('set', {\r\n    'county': '臺北市',\r\n    'district': '信義區',\r\n    'zipcode': 110\r\n});\r\n```\r\n\r\n### reset\r\n將指定的元素恢復未選狀態\r\n```javascript\r\n$(selector).twzipcode('reset');\r\n```\r\n\r\n### serialize\r\n將指定的元素輸出為 URL QueryString。\r\n```javascript\r\nvar qs = $(selector).twzipcode('serialize');\r\nconsole.log(qs);\r\n// output:\r\n// county=AAA&district=BBB&zipcode=999\r\n```\r\n\r\n## 範例\r\n### 加入郵遞區號預設值，並可輸入郵遞區號取得縣市名稱\r\n```javascript\r\n$('selector').twzipcode({\r\n    'zipcodeSel': 110,\r\n    'readonly': false\r\n});\r\n```\r\n### 加入縣市預設值\r\n```javascript\r\n$('selector').twzipcode({\r\n    'countySel': '高雄市',\r\n    'districtSel': '那瑪夏區'\r\n});\r\n```\r\n\r\n### 指定 CSS 樣式名稱\r\n```css\r\n.addr-county{background:#4169E1;color:#fff}\r\n.addr-district{background:#008000;color:#fff}\r\n.addr-zip{background:#c00;color:#fff;border:1px solid #666}\r\n```\r\n```javascript\r\n$('#container').twzipcode({\r\n    'css': [\r\n        'addr-county', //縣市\r\n        'addr-distrcit',  // 鄉鎮市區\r\n        'addr-zip' // 郵遞區號\r\n    ]\r\n});\r\n```\r\n\r\n或是直接使用 HTML5 data-* 套用樣式\r\n\r\n```html\r\n<div id=\"twzipcode\">\r\n  <div data-role=\"zipcode\" data-style=\"addr-zip\" data-name=\"元素名稱\" data-value=\"預設值\"></div>\r\n  <div data-role=\"county\" data-style=\"addr-county\" data-name=\"元素名稱\" data-value=\"預設值\"></div>\r\n  <div data-role=\"district\" data-style=\"addr-district\" data-name=\"元素名稱\" data-value=\"預設值\"></div>\r\n</div>\r\n```\r\n## 支援\r\n\r\n請拜訪 https://code.essoduke.org/twzipcode/ 取得支援。\r\n\r\n## 授權\r\n\r\nv1.6.2 開始採用 [MIT License](http://opensource.org/licenses/MIT)\r\nv1.6.1 及更早版本採用 [創用 CC 姓名標示-相同方式分享 3.0  台灣授權條款](http://creativecommons.org/licenses/by-sa/3.0/deed.zh_TW)。\r\n","maintainers":[{"name":"essoduke","email":"essoduke@gmail.com"}],"time":{"modified":"2022-06-19T05:14:53.146Z","created":"2017-05-09T10:39:10.885Z","1.7.13":"2017-05-09T10:39:10.885Z","1.7.12":"2017-05-09T10:45:50.666Z","1.7.14":"2017-06-26T09:10:48.192Z","1.7.1-4.1":"2017-06-26T09:12:28.800Z","1.7.15-rc1":"2018-06-26T04:32:06.851Z"},"homepage":"https://code.essoduke.org/twzipcode/","keywords":["jquery-plugin"],"repository":{"type":"git","url":"git://github.com/essoduke/jquery-twzipcode.git"},"author":{"name":"Essoduke Chang","url":"https://essoduke.org"},"bugs":{"url":"https://github.com/essoduke/jQuery-TWzipcode/issues"},"license":"MIT","readmeFilename":"README.md"}