HOWTO · JavaScript

JavaScript を使用したプラグインなしの入力テキスト マスキング

プラグインなしで、ブラウザー側の JavaScript 入力マスクを使い、クレジット カード、郵便番号、電話番号の入力を入力中に整形します。

このページの内容

JavaScript では、input イベントハンドラーでフィールドの値を整形すれば、プラグインを使わずに入力マスクを作成できます。以下の例は短い JavaScript 関数を使うため、ライブラリファイルをダウンロードする必要はありません。クレジットカード番号の数字、例としての英数字の郵便番号、北米の電話番号をそれぞれ整形し、最後に別のフィールド向けに整形処理を変更する方法を紹介します。

例を試すには、対応する入力要素の後にある HTML の <script> 要素へスクリプトを記述するか、defer を指定して読み込みます。入力要素には、スクリプトで使う id を設定してください。各コード例は、対象フィールド用の JavaScript プログラムとして完結しています。ここではブラウザー上でスニペットを実行していないため、実行結果は示していません。

書式設定は、入力中に画面へ表示される値を変えるものです。値が有効だと判定したり、決済カードを識別したり、サーバー側のチェックを置き換えたりするものではありません。HTML の pattern はフォーム送信時に入力済みの値を確認する助けになりますが、入力中に空白や句読点を挿入するものではありません。

JavaScriptでクレジットカード番号を入力マスクで整形する

この例では数字だけを残し、4桁ごとに空白を挿入します。最大19桁まで表示するため、すべてのカード番号が同じ長さだと仮定せず、一般的なカード番号の長さに対応できます。コードでは type="text" と数値入力用のヒントを使い、数字の文字列に対してブラウザーが数値フィールドの動作を適用しないようにしています。

function formatCardNumber(value) {
  const digits = value.replace(/\D/g, "").slice(0, 19);
  return digits.replace(/(.{4})/g, "$1 ").trim();
}

if (typeof document !== "undefined") {
  const cardField = document.querySelector("#card-number");
  if (cardField) {
    cardField.addEventListener("input", () => {
      cardField.value = formatCardNumber(cardField.value);
    });
  }
}

<input id="card-number" type="text" inputmode="numeric" autocomplete="cc-number" placeholder="1234 5678 9012 3456"> のような入力要素と組み合わせます。空白を入れずに数字を入力すると、ハンドラーがグループごとに空白を追加します。この単純なハンドラーは、末尾に文字を入力するときに最も使いやすいものです。キー入力のたびに値を整形すると、途中を編集したときにキャレットが移動することがあります。そのため、本番の決済フォームでは、キャレット位置に対応した十分にテスト済みの整形処理を使ってください。整形後の値は表示用の入力として扱い、別途検証します。

JavaScriptで郵便番号を入力マスクで整形する

郵便番号の形式は国によって異なり、文字、空白、ハイフンを含むものもあります。この例は、文字と数字が交互に並ぶ6文字のパターンを示すもので、あらゆる郵便番号に適用できる規則ではありません。英字を大文字にし、それ以外の文字を取り除き、3文字目の後に空白を表示します。

function formatPostalCode(value) {
  const characters = value.toUpperCase().replace(/[^A-Z0-9]/g, "").slice(0, 6);
  return characters.length > 3
    ? `${characters.slice(0, 3)} ${characters.slice(3)}`
    : characters;
}

if (typeof document !== "undefined") {
  const postalField = document.querySelector("#postal-code");
  if (postalField) {
    postalField.addEventListener("input", () => {
      postalField.value = formatPostalCode(postalField.value);
    });
  }
}

<input id="postal-code" type="text" autocomplete="postal-code" placeholder="A1B 2C3"> と組み合わせます。この整形処理は、どの位置でも英字と数字を受け付けます。プレースホルダーは形式の一例を示しますが、関数が行うのは文字の整形だけです。フォームで扱う国や住所データに合わせて、文字の規則、区切り位置、文字数を調整してください。この例示形式を使って、ほかの地域の郵便番号を拒否しないでください。

JavaScriptで括弧付きの電話番号を入力マスクで整形する

次の整形処理は、北米の国内電話番号を10桁と想定し、(212) 555-0123 の形式で表示します。数字を受け付け、余分な数字は破棄し、入力されたグループに応じて句読点を追加します。国番号、内線番号、ほかの国の番号体系には対応していません。

function formatNorthAmericanPhone(value) {
  const digits = value.replace(/\D/g, "").slice(0, 10);
  if (digits.length === 0) return "";
  if (digits.length < 4) return `(${digits}`;
  if (digits.length < 7) return `(${digits.slice(0, 3)}) ${digits.slice(3)}`;
  return `(${digits.slice(0, 3)}) ${digits.slice(3, 6)}-${digits.slice(6)}`;
}

if (typeof document !== "undefined") {
  const phoneField = document.querySelector("#phone-number");
  if (phoneField) {
    phoneField.addEventListener("input", () => {
      phoneField.value = formatNorthAmericanPhone(phoneField.value);
    });
  }
}

スクリプトは <input id="phone-number" type="tel" autocomplete="tel-national" placeholder="(212) 555-0123"> と組み合わせます。誰かがテキストを貼り付けたときにも input イベントが実行され、整形処理は数字だけを残します。国際向けのフォームでは、ユーザーが選択した国に応じた形式を選ぶか、番号体系とキャレット移動に対応した電話番号ライブラリを使ってください。この固定形式の例は、一般的な電話番号用の入力マスクではありません。

JavaScriptでさまざまなフィールドの入力マスクをカスタマイズする

入力マスクを変更するときは、整形規則とフィールドのプレースホルダーを両方変更し、同じ形式を示すようにします。この例では4桁の部署コードの後にハイフンと2桁を続ける形式に整形します。整形処理は数字だけを受け付け、最初のグループの入力が終わるとハイフンを追加します。

function formatDepartmentCode(value) {
  const digits = value.replace(/\D/g, "").slice(0, 6);
  return digits.length > 4
    ? `${digits.slice(0, 4)}-${digits.slice(4)}`
    : digits;
}

if (typeof document !== "undefined") {
  const departmentField = document.querySelector("#department-code");
  if (departmentField) {
    departmentField.addEventListener("input", () => {
      departmentField.value = formatDepartmentCode(departmentField.value);
    });
  }
}

この規則には <input id="department-code" type="text" inputmode="numeric" placeholder="1234-56"> を使います。別のフィールドに合わせる場合は、残す文字、表示する文字数、区切り文字の位置を決め、その形式に合わせてプレースホルダーも更新してください。プレースホルダーは見た目のヒントであり、書式設定の規則ではありません。同様に、HTML の pattern は送信された文字列が式に一致するかを確認しますが、入力中に文字を挿入するものではありません。書式設定の処理と検証の処理を分け、フォームの実際の要件に沿って入力済みの値を検証してください。