現在是倒數第四天
關於rails本身的介紹，實在是到了想不到梗的程度
於是乎我決定來介紹一下我認為實用的Gem
也算是造福台灣地區的工程師

相信很多台灣的專案可能都會有這樣的需求
需要做縣市地址的二階下拉選單
例如選擇台北市，第二個下拉選單依序出現：中正區、中山區、文山區等等...
這樣的需求還挺普遍的
基於不需要重複造輪的精神
已經有人將這個需求寫成了一個方便的Gem
供大家快速使用

github位置

Gemfile

gem 'taiwan_city'

app/assets/javascripts/application.js

//= require 'jquery'
//= require 'taiwan_city/jquery.taiwan_city'

實務上不一定要放在application.js
但是有使用到的頁面前，一定要載入
反之，如果需要的頁面沒有載入application.js
就需要在該頁面前的js階段載入這兩行

config/routes.rb

mount TaiwanCity::Engine => '/taiwan_city'

可以加在最下方
但避免有同名的taiwan_city路徑
如果放在上方可能會被覆蓋掉而失效

view (html)階段

如果上述都設定完成
跑完bundle就可以使用啦
以slim頁面為例：

.city-group
  select.city-select
    option --縣市--
    = options_for_select(TaiwanCity.list)
  select.city-select
    option --鄉鎮市區--

特別注意，外層需要用<div class="city-group"></div>所包圍
裡面兩個縣市與區域的selecter需要有class="city-select"
然後縣市的選項下載入gem所導入的helper方法：options_for_select(TaiwanCity.list)
如此就生效囉

存取時會存入五碼數字
前兩碼為專案定義的縣市代碼，後三碼為郵遞區號
例如台北市中正區為01100
其中01為台北市，100為中正區的郵遞區號
要從五碼轉為縣市或區域名稱字串方法如下：

> TaiwanCity.get('01100')
=> "中正區"
> TaiwanCity.get('01000')
=> "台北市"

認真要說的話
目前這個專案還有幾個需要注意的地方
首先是沒有支援語言包，這部分有點可惜
我有時間可能會送PR

另一部分是因為基於郵遞區號編碼
所以郵遞區號相同的部分沒有分別的選項
例如：
新竹市的東區、北區、香山區都是300
雖然這點對於工程師而言
結果都是正確的
但是使用者有可能會回報沒有正確的對應選項
在這專案當中會變成需要選擇
「新竹縣05000」->「新竹市05300」
沒有更細的選項了

原本嘉義市也有類似的問題
不過我已經修正了（送出PR被接受）
各為如果使用Gem有什麼改進建議
也可以嘗試送出PR，一起讓Gem更完善唷！
新年快樂！！！