表單輸入框的預設提示文字 (Placeholder) 是提升表單易用性的關鍵細節。雖然 HTML5 原生支援 placeholder 屬性,但在舊版瀏覽器相容、複雜互動邏輯、或需支援非輸入類型元素時,JavaScript 方案仍具價值。本文詳細解析 jQuery 實現預設值顯示/隱藏的完整方案。
<input type="text" name="username" placeholder="請輸入帳號">
<textarea name="bio" placeholder="自我介紹..."></textarea>
優點:零 JS 依賴、語意化、無障礙支援佳、效能最佳。
適用場景:現代專案、無特殊互動需求。
title 屬性或 data-placeholder 作為提示文字來源;(function($) {
$.fn.placeholderFallback = function(options) {
const settings = $.extend({
placeholderAttr: 'data-placeholder', // 來源屬性
activeClass: 'placeholder-active', // 樣式鉤子
filter: 'input:text, input:password, textarea' // 目標元素
}, options);
return this.each(function() {
const $container = $(this);
const $inputs = $container.find(settings.filter);
$inputs.each(function() {
const $input = $(this);
const placeholder = $input.attr(settings.placeholderAttr)
|| $input.attr('title')
|| $input.attr('placeholder');
if (!placeholder) return;
// 初始化:若無值則填入提示文字
if (!$input.val()) {
setPlaceholder($input, placeholder);
}
// 綁定事件
$input.on('focus.placeholder', function() {
if ($input.val() === placeholder) {
$input.val('').removeClass(settings.activeClass);
}
}).on('blur.placeholder', function() {
if (!$input.val()) {
setPlaceholder($input, placeholder);
}
});
// 表單送出前清理
$input.closest('form').on('submit.placeholder', function() {
if ($input.val() === placeholder) {
$input.val('');
}
});
});
function setPlaceholder($el, text) {
$el.val(text).addClass(settings.activeClass);
}
});
};
})(jQuery);
// 使用方式
$(function() {
$('form').placeholderFallback({
placeholderAttr: 'data-placeholder',
activeClass: 'has-placeholder'
});
});
.has-placeholder {
color: #999; // 提示文字顏色
font-style: italic; // 區分使用者輸入
}
/* 針對 password 欄位特殊處理:需切換 type */
input[type="password"].has-placeholder {
/* 可搭配字體圖示顯示鎖頭圖示 */
font-family: 'FontAwesome', sans-serif;
}
提示文字顯示時需為 type="text",聚焦切回 password:
$input.on('focus.placeholder', function() {
if ($input.val() === placeholder && $input.attr('type') === 'password') {
$input.attr('type', 'text').val('').removeClass(settings.activeClass);
}
}).on('blur.placeholder', function() {
if (!$input.val()) {
$input.attr('type', 'password');
setPlaceholder($input, placeholder);
}
});
使用事件委派或重新初始化:
// 方案一:事件委派 (效能較好)
$(document).on('focus.placeholder', 'input[data-placeholder], textarea[data-placeholder]', function() {
// ... 邏輯同前
});
// 方案二:AJAX 完成後重新掃描
$.ajaxComplete(function() {
$('form').placeholderFallback();
});
const supportsPlaceholder = 'placeholder' in document.createElement('input');
if (!supportsPlaceholder) {
$('form').placeholderFallback();
}
// 現代瀏覽器直接使用原生 placeholder
<label for="id"> 關聯輸入框,螢幕閱讀器才能正確朗讀aria-label:若無可見標籤,補充 aria-label="提示文字"| 錯誤做法 | 問題 | 正確做法 |
|---|---|---|
直接用 value="提示文字" 且無 JS 清理 |
使用者未修改就送出,髒資料入庫 | 送出前檢查並清空,或用 placeholder 屬性 |
用 title 屬性當提示文字來源 |
滑鼠懸停會顯示 tooltip 干擾 | 改用 data-placeholder 或 HTML5 placeholder |
| 未處理密碼欄位類型切換 | 提示文字以明文顯示,洩露長度資訊 | 聚焦時切換 type="password" |
現代專案首選 HTML5 placeholder,舊版相容專案使用 jQuery 方案時,務必處理:表單送出清理、密碼欄位類型切換、動態元素綁定、無障礙屬性。將邏輯封裝為 jQuery Plugin ($.fn.placeholderFallback) 可提升複用性與維護性。