郵便番号入力

使い方

郵便番号入力用の文字列入力欄と、住所検索用のボタンを設置します。

住所検索で得られたデータをセットする入力欄はこのアイテムにはありません。別途設置しておいてください。

ユーザーが検索ボタンをクリックするか、文字列入力欄で Enter キーを押すと、入力された郵便番号の住所を検索し、見つかった住所を指定の「都道府県」「住所1」～「住所4」アイテムにセットします。

設定するパラメーター

アイテム名を表示しない

アイテム名（ラベル）部分を表示しません。この場合、入力用の枠のみが表示されます。「必須項目にする」をオンにした場合の必須マークも表示されなくなります。ラベル要素自体が生成されませんので、後からページ内処理でラベルをセットすることもできなくなります。

編集不可にする

編集不可にすると、郵便番号文字列の入力ができない状態になります。

このパラメーターで編集不可にしても、「入力アイテムを有効化する」で後から編集可能状態にできます。

編集不可にしても「検索」ボタンは無効にならず、押すことができます。

必須項目にする

必須項目にすると、ラベル部分に必須マークがつき、「入力エラーをチェックする」時に必須チェックが行われるようになります。

「アイテム名」が空だったり「アイテム名を表示しない」がオンの場合は必須マークは表示されなくなりますが、「入力エラーをチェックする」のエラーチェックは行われます。

初期値

画面表示した時点で入っている値を設定します。

都道府県入力アイテム

検索結果で得た都道府県名をセットする先のアイテムを指定します。

入力タイプのアイテムのみ指定可能です。複数選択タイプのアイテムは指定できません。

このアイテムとして「都道府県選択プルダウン」を指定する場合、「都道府県選択プルダウン」の「値の種類」パラメーターは「都道府県名」にしてください。「都道府県コード」には対応していません。

住所(1)アイテム

住所(2)アイテム

住所(3)アイテム

住所(4)アイテム

市区町村名以降の住所をセットするアイテムを選択します。

入力タイプのアイテムのみ指定可能です。複数選択タイプのアイテムは指定できません。

通常、住所(1)が市区町村名、住所(2)は町域名になり、住所(3)(4)は予備になります。

都道府県、住所(1)～住所(4) のいくつかを同じアイテムにすることもできます。 その場合、それらの情報をつなげてそのアイテムにセットします。

日本郵便のCSVデータとの対応について

「郵便番号から住所を検索する」で元になっている住所データは日本郵便が公開している「住所の郵便番号」と「事業所の個別郵便番号」の CSV データです。 これらの CSV と「郵便番号から住所を検索する」でセットされる「住所1」～「住所4」の対応は以下のようになります。

幅

郵便番号入力欄の幅を指定します。

アイテム全体の幅ではなく、検索ボタンの幅は含みません。検索ボタンの幅は固定で、変更できません。

カスタマイズ対応状況

「入力エラーをチェックする」でチェックされる内容

• 必須チェック
• 郵便番号としての書式
  • 7桁の数値または3桁-4桁のハイフン区切り

制限事項

• 郵便番号入力アイテムをテーブル内に置いた場合は正常に動作しません。

• 郵便番号はデータとしてはかなり曖昧なので、必ず1対1で住所に変換するのは不可能であることを予めご了承ください。

• 日本郵便株式会社提供のデータを元にしていますが、必ず最新の状態が維持されていることを保証するものではありません。