フォームに表示されるバリデーションメッセージを変更したいですか?バリデーションメッセージのカスタマイズは、フォームを別の言語に翻訳したい場合や、単に文言を変更したい場合に特に便利です。
このチュートリアルでは、検証メッセージの例とその変更方法を紹介します。
バリデーション・メッセージとは何か？
フォームのいくつかのフィールドには特定のルールがあります。例えば、必須フィールドが空の場合、ユーザーはフォームを送信できません。また、適切なEメールアドレスでないテキストを含むEメールフィールドや、ウェブアドレスを含まないURLフィールドを送信することもできません。
WPFormsはバリデーションと呼ばれるプロセスを使って、各入力項目がフォームのルールに従っているかどうかをチェックします。ユーザーがフィールドに正しく入力していない場合、送信を完了する前に問題を修正する方法を伝えるメッセージが表示されます。
例えば、必須フィールドが空の場合に表示されるバリデーションメッセージには、「このフィールドは必須です」と書かれています。
バリデーション・メッセージのカスタマイズ
WPFormsはプラグインの設定でサイト全体のバリデーションメッセージを管理します。
既存のフォームのバリデーションメッセージの一覧を表示するには、WPForms"SettingsでValidationタブを開いてください。
ここで利用可能な特定のメッセージは、ライセンスレベルとインストールされているアドオンによって異なります。これらのメッセージをカスタマイズするには、デフォルトのテキストをユーザーに表示したいメッセージに置き換えるだけです。
以下に、現在カスタマイズ可能なすべてのバリデーションメッセージとそのデフォルト値を示します：
- 必須このフィールドは必須です。
- ウェブサイトのURL有効なURLを入力してください。
- Eメール有効なメールアドレスを入力してください。
- Email Suggestion: Did you mean {suggestion}?
- メールが制限されています：このメールアドレスは使用できません。
- 番号有効な番号を入力してください。
- 正の数を入力してください：有効な正の数を入力してください。
- 値を確認する：フィールド値が一致しません。
- 入力マスクが不完全です：必須項目を入力してください。
- Checkbox Selection Limit: You have exceeded the number of allowed selections: {#}.
- Character Limit: Limit is {limit} characters. Characters remaining: {remaining}.
- Word Limit: Limit is {limit} words. Words remaining: {remaining}.
- 電話番号有効な電話番号を入力してください。
- ファイル拡張子：ファイルの種類は許可されていません。
- ファイルサイズ：ファイルが許容最大サイズを超えています。ファイルがアップロードされませんでした。
- 時間（12時間）：12時間のAM/PMフォーマットで時間を入力してください（例：AM8:45）。
- 時間（24時間）：時間を24時間形式で入力してください（例：22:45）。
- お支払いが必要です：お支払いが必要です。
- クレジットカード有効なクレジットカード番号を入力してください。
- Field Upload Total Size: The total size of the selected files {totalSize} Mb exceeds the allowed limit {maxSize} Mb.
- パスワードの強度：より強力なパスワードが必要です。大文字、小文字、数字、記号の使用を検討してください。
- ユニークな答え：値は一意でなければならない。
- クーポンエラー： これは有効なクーポンではありません。
デフォルトのメッセージには、中かっこで囲まれたプレースホルダーが含まれていることに注意してください。これらは、あなたのサイトの他の領域から値を取得し、バリデーションメッセージに表示します。
注：バリデーションメッセージを翻訳する際は、プレースホルダーを必ず英語で残してください。詳しくは下記のFAQをご覧ください。
利用可能なプレースホルダーは以下の通り：
- {suggestion}: Inserts a suggested correction if a user enters a common email address (e.g., @gmail.com, @yahoo.com) with a typo.
- {#}: Shows the maximum number of selections allowed by a Checkboxes field, as determined in its field options.
- {limit}: Shows the word or character limit for a Single Line Text or Paragraph Text field, as set in its field options.
- {remaining}: Displays the remaining available words or characters until the user reaches the limit for a Single Line Text or Paragraph field, as set in its field options.
- {totalSize}: Inserts the size of a file a user has attempted to upload using the File Upload field.
- {maxSize}: Displays the maximum file size allowed by the File Upload field.
変更が完了したら、必ず画面下部のSave Settings をクリックしてください。あなたのサイトのすべてのWPFormsは、これらの検証メッセージを使用します。
注：視覚的な合図を維持したまま、検証エラーメッセージのテキストとアイコンを無効にしたい場合は、開発者向けドキュメントを参照してください。
よくある質問
WPFormsのバリデーションメッセージのカスタマイズについて、よくいただくご質問です。
バリデーションメッセージを翻訳したら、プレースホルダーが機能しなくなりました。どうしたらいいですか？
バリデーション・メッセージを翻訳するときは、プレースホルダーを英語のままにしてください。
For example, if you were to translate the default email suggestion validation message, you would enter “Did you mean” in your target language, but leave “{suggestion}” in English, like so:
WPFormsで失敗したフォーム送信のエラーテキストを変更するには？
PHPスニペットを使用することで、WPFormsで送信に失敗した場合に表示されるエラーテキストを変更することができます。これによって、あなたのウェブサイトのニーズに合わせてメッセージをカスタマイズしたり、ユーザーにより具体的な指示を提供したりすることができます。
このスニペットの実装方法の詳細については、失敗した投稿のエラーテキストの変更に関する開発者向けドキュメントを参照してください。
以上です！これでフォームのバリデーションメッセージをカスタマイズできるようになりました。
次に、バリデーションメッセージの外観をカスタマイズしたり、フォームの他の部分をスタイリングしたいと思いませんか?まずはCSSの初心者ガイドをご覧ください。