メニュー操作を選択

ウェブ機能: :user-valid と :user-invalid

問題

必須のプルダウン（「国を選択」など）の場合、デフォルトのオプションの値が空であれば、標準の検証ですぐにフィールドが無効としてフラグが付けられます。これにより、視覚的なノイズが発生する可能性があります。エラーを表示するのは、ユーザーがメニューを開いてオプションを選択せずに閉じた場合、またはフォームを送信しようとした場合のみにします。

ソリューション

:user-invalid 疑似クラスは <select> 要素とシームレスに連携します。ユーザーの操作フローを尊重します。単にページを読み込んだり、変更を加えずにフォーカス / ぼかしを行ったりしても、操作とは見なされません。そのため、ユーザーが積極的に選択を試みるまで、フィールドはニュートラルなままです。

実装戦略

  1. HTML 制約: required で <select> を使用します。最初のオプションは value="" にする必要があります。また、有効な選択を強制するために、無効にするか非表示にすることをおすすめします。
  2. 視覚的なフィードバック: :user-invalid を使用して、選択ボックスの枠線のスタイルを設定します。
  3. タイミング: ユーザーがコントロールをぼかす前、またはフォームの送信時に値を変更した場合（デフォルトの無効な状態に戻した場合でも）、ブラウザはフィールドを「操作済み」とみなします。

実装ガイド

1. HTML 構造

ここで重要なのは「placeholder」オプションです。

<form>
  <div class="field">
    <label for="country">Country</label>
    <select
      id="country"
      name="country"
      required
      aria-errormessage="country-error"
    >
      <option value="" disabled selected>Select a country...</option>
      <option value="us">United States</option>
      <option value="ca">Canada</option>
      <option value="uk">United Kingdom</option>
    </select>
    <div id="country-error" class="error-msg">
      Please select a country.
    </div>
  </div>
</form>

2. CSS

.error-msg {
  display: none;
  color: #d93025;
  font-size: 0.875rem;
  margin-top: 0.25rem;
}

/*
  Only show error after the user visits the select menu.
*/
select:user-invalid {
  border-color: #d93025;
  background-color: #fce8e6;
}

select:user-invalid + .error-msg {
  display: block;
}

select:user-valid {
  border-color: #188038;
}

フォールバックとブラウザのサポート

:user-valid と :user-invalid のフォールバックとブラウザ サポート

代替広告の CSS

input:user-invalid,
input.user-invalid-fallback {
  border-color: #d93025;
  background-color: #fce8e6;
}

input:user-invalid + .error-msg,
input.user-invalid-fallback + .error-msg {
  display: block;
}

JavaScript フォールバック

WeakMap を使用してインタラクションの状態を追跡する、再利用可能なユーティリティを使用します。これにより、「ダーティ」なクラスやデータ属性で DOM が汚染されるのを防ぐことができます。

const UserInvalidFallback = (() => {
  const dirtyState = new WeakMap();

  const updateState = (input) => {
    const isValid = input.checkValidity();

    // Update both visual and ARIA state
    input.classList.toggle('user-invalid-fallback', !isValid);
    input.classList.toggle('user-valid-fallback', isValid);

    if (!isValid) {
      input.setAttribute('aria-invalid', 'true');
    } else {
      input.removeAttribute('aria-invalid');
    }
  };

  const handleEvent = (event) => {
    const input = event.target;

    if (event.type === 'reset') {
      const controls = input.elements || [];
      for (const control of controls) {
        dirtyState.delete(control);
        control.classList.remove('user-invalid-fallback');
        control.classList.remove('user-valid-fallback');
        control.removeAttribute('aria-invalid');
      }
      return;
    }

    if (!input.checkValidity) return;

    if (event.type === 'input' || event.type === 'change') {
      const state = dirtyState.get(input) || { hasInteracted: false, hasBlurred: false };
      state.hasInteracted = true;
      dirtyState.set(input, state);
      if (state.hasBlurred) {
        updateState(input);
      }
    } else if (event.type === 'blur') {
      const state = dirtyState.get(input) || { hasInteracted: false, hasBlurred: false };
      state.hasBlurred = true;
      dirtyState.set(input, state);
      if (state.hasInteracted) {
        updateState(input);
      }
    }
  };

  const init = (root = document) => {
    if (CSS.supports('selector(:user-invalid)')) return;

    root.addEventListener('blur', handleEvent, true); // Capture phase
    root.addEventListener('input', handleEvent);
    root.addEventListener('change', handleEvent);
    root.addEventListener('reset', handleEvent, true); // Capture resets
  };

  return { init };
})();

// Initialize for a specific form
const form = document.querySelector('#demo-form');
UserInvalidFallback.init(form);

その他の注意事項

  1. モバイルでの動作: モバイル デバイスでは、OS の選択ツールによって「ぼかし」の動作が異なる場合があります。実際のデバイスでテストすることをおすすめします。
  2. ユーザー補助: ネイティブの :user-invalid は ARIA 属性と自動的に同期されません。aria-invalid を視覚的な状態と同期させるために、次の JavaScript を追加します。
// Sync aria-invalid with the CSS :user-invalid state
const syncAria = (el) => {
  el.setAttribute?.('aria-invalid', el.matches(':user-invalid') ? 'true' : 'false');
};

// Update on blur (to show error) and input (to clear it)
document.addEventListener('blur', (e) => syncAria(e.target), true);
document.addEventListener('input', (e) => {
  if (e.target.hasAttribute('aria-invalid')) syncAria(e.target);
});