問題說明
如果是必填下拉式選單 (例如「選擇國家/地區」),當預設選項的值為空白時,標準驗證會立即將該欄位標示為無效。這可能會造成視覺干擾。我們希望只有在使用者開啟選單後未選擇任何選項就關閉,或嘗試提交表單時,才顯示錯誤訊息。
解決方法
:user-invalid 虛擬類別可與 <select> 元素完美搭配。這項功能會遵循使用者的互動流程:單純載入頁面或聚焦/模糊,但未進行任何變更,都不算互動,因此在使用者主動嘗試選取之前,欄位會保持中立。
導入策略
- HTML 限制:使用
<select>搭配required。第一個選項應包含value="",且最好停用/隱藏,強制使用者做出有效選擇。 - 視覺回饋:使用
:user-invalid設定選取方塊邊框的樣式。 - 時機:如果使用者在模糊控制項之前或提交表單時變更值 (即使變回預設的無效狀態),瀏覽器就會將該欄位視為「已互動」。
導入指南
1. HTML 結構
這裡的關鍵是「預留位置」選項。
<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);
其他考量
- 行動裝置行為:在行動裝置上,「模糊」效果可能會因 OS 挑選器而異。建議在實際裝置上測試。
- 無障礙功能:原生
:user-invalid不會自動與 ARIA 屬性同步。新增下列 JavaScript,讓aria-invalid與視覺狀態保持同步:
// 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);
});