概要
kawa.netで提供されているAjaxZip 2.0 - Ajax郵便番号→住所自動入力フォーム(CGI不要版]を元に作成したjquery pluginです。 郵便番号から住所情報の取得をすることができます。
デモ
入力された郵便番号をもとに住所情報を取得するデモです。
デモ1
郵便番号を入力しボタンを押すと情報を取得します。
結果が表示されます。
デモ2
郵便番号をフォーカスアウトすると住所の自動入力が行われます。 普段のフォーム入力の要に郵便番号にフォーカスしてから先を入力しようとしてみてください。
How To Use
- jsonファイルを配置する。住所情報の入ったdataディレクトリをサーバに配置する。
- jqueryとjquery.ajaxzip.jsを読み込む
<script type="text/javascript" src="https://ajax.googleapis.com/ajax/libs/jquery/1.7.1/jquery.min.js"></script> <script type="text/javascript" src="jquery.ajaxzip.js"></script>
- 呼び出したいタイミングで$.ajaxzipを呼び出す。
デモのソースコードを参考にご覧ください。
オプション
$.ajaxzip("郵便番号" , オプション)を引数に与える事ができます。オプションは下記の通りです。
data_path | 住所情報の入ったjsonファイルを格納するディレクトリへのパスを指定してください。 |
---|---|
success(function) | 住所のデータを取得後に呼ばれるfunctionです。引数のdataに住所情報が取得されています。 |
error(function) | 住所が見つからなかった場合等に呼ばれるfunctionです。 |
呼び出し例
$.ajaxzip("170-0001", {
data_path: "../../data" ,
success: function(data){
alert("取得成功");
} ,
error: function(data){
alert("失敗");
}
});
レスポンス(success時)
住所情報の取得が正常に行われた場合、引数で与えられるdataには下記のような配列(json)データが入っています。
status | success |
---|---|
zip | 入力された郵便番号 |
zip1 | 郵便番号上3桁 |
zip2 | 郵便番号下4桁 |
pref | 都道府県 |
pref_id | 都道府県ID |
city | 市区 |
town | 町村 |
Support or Contact
readme on github