萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

jQuery 表單輸入框預設值/提示文字最佳實踐

前言

表單輸入框的預設提示文字 (Placeholder) 是提升表單易用性的關鍵細節。雖然 HTML5 原生支援 placeholder 屬性,但在舊版瀏覽器相容、複雜互動邏輯、或需支援非輸入類型元素時,JavaScript 方案仍具價值。本文詳細解析 jQuery 實現預設值顯示/隱藏的完整方案。

HTML5 原生方案 (優先推薦)

<input type="text" name="username" placeholder="請輸入帳號">
<textarea name="bio" placeholder="自我介紹..."></textarea>

優點:零 JS 依賴、語意化、無障礙支援佳、效能最佳。
適用場景:現代專案、無特殊互動需求。

jQuery 相容方案 (IE9+ / 舊專案維護)

核心邏輯

  1. 讀取元素 title 屬性或 data-placeholder 作為提示文字來源
  2. 聚焦時:若值等於提示文字 → 清空
  3. 失焦時:若值為空 → 恢復提示文字
  4. 表單送出前:清理提示文字避免被送往伺服器

完整實作程式碼

;(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'
    });
});

對應 CSS 樣式

.has-placeholder {
    color: #999;           // 提示文字顏色
    font-style: italic;    // 區分使用者輸入
}

/* 針對 password 欄位特殊處理:需切換 type */
input[type="password"].has-placeholder {
    /* 可搭配字體圖示顯示鎖頭圖示 */
    font-family: 'FontAwesome', sans-serif;
}

進階議題處理

1. Password 欄位類型切換

提示文字顯示時需為 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);
    }
});

2. 動態新增元素 (AJAX 載入表單)

使用事件委派或重新初始化:

// 方案一:事件委派 (效能較好)
$(document).on('focus.placeholder', 'input[data-placeholder], textarea[data-placeholder]', function() {
    // ... 邏輯同前
});

// 方案二:AJAX 完成後重新掃描
$.ajaxComplete(function() {
    $('form').placeholderFallback();
});

3. 整合瀏覽器原生支援檢測

const supportsPlaceholder = 'placeholder' in document.createElement('input');

if (!supportsPlaceholder) {
    $('form').placeholderFallback();
}
// 現代瀏覽器直接使用原生 placeholder

無障礙 (Accessibility) 考量

  • 標籤關聯:務必使用 <label for="id"> 關聯輸入框,螢幕閱讀器才能正確朗讀
  • aria-label:若無可見標籤,補充 aria-label="提示文字"
  • 顏色對比:提示文字顏色需符合 WCAG AA 級對比度 (至少 4.5:1)

常見錯誤避雷指南

錯誤做法問題正確做法
直接用 value="提示文字" 且無 JS 清理 使用者未修改就送出,髒資料入庫 送出前檢查並清空,或用 placeholder 屬性
用 title 屬性當提示文字來源 滑鼠懸停會顯示 tooltip 干擾 改用 data-placeholder 或 HTML5 placeholder
未處理密碼欄位類型切換 提示文字以明文顯示,洩露長度資訊 聚焦時切換 type="password"

總結

現代專案首選 HTML5 placeholder,舊版相容專案使用 jQuery 方案時,務必處理:表單送出清理、密碼欄位類型切換、動態元素綁定、無障礙屬性。將邏輯封裝為 jQuery Plugin ($.fn.placeholderFallback) 可提升複用性與維護性。

copyright © 萬盛學電腦網 all rights reserved