DIV CSS 佈局教程網

打造 textarea 隨內容自動撐高的 jQuery 外掛
編輯:JQuery入門技巧     

多行文字輸入框有個長年問題:內容寫長了就要在小小的框裡捲動,寫短了又留一堆空白。解法是讓 textarea 的高度跟著內容長大。以下把它包成一個可重複使用的外掛。

外掛主體

 (function($){
    $.fn.autoTextarea = function(options) {
        var defaults = {
            // 是否自動撐高。預設 null 表示不限制;
            // 若設為數值,則作為自動撐高的上限
            maxHeight: null,
            minHeight: $(this).height()
        };
        var opts = $.extend({}, defaults, options);

        return $(this).each(function() {
            $(this).bind("paste cut keydown keyup focus blur", function(){
                var height, style = this.style;

                // 先縮回最小高度,才能正確量測目前內容實際需要多高
                this.style.height = opts.minHeight + 'px';

                if (this.scrollHeight > opts.minHeight) {
                    if (opts.maxHeight && this.scrollHeight > opts.maxHeight) {
                        height = opts.maxHeight;
                        style.overflowY = 'scroll';   // 超過上限,出現捲軸
                    } else {
                        height = this.scrollHeight;
                        style.overflowY = 'hidden';   // 撐高,隱藏捲軸
                    }
                    style.height = height + 'px';
                }
            });
        });
    };
})(jQuery); 

呼叫方式

 <textarea name="textarea" id="textarea" cols="60" rows="4" class="chackTextarea-area"></textarea>

<script type="text/javascript">
$(".chackTextarea-area").autoTextarea({
    maxHeight: 220    // 高度上限;設為 null 則不限
});
</script> 

運作原理說明

核心技巧是「先縮回最小高度,再讀 scrollHeight」。如果不清掉既有高度,scrollHeight 會包含先前撐開的空間,導致高度只增不減——使用者刪除文字時,欄位就會卡在最高的那個尺寸。先重設為 minHeight,量到的才是內容真正需要的高度。

綁定的事件清單中,paste 與 cut 分別處理貼上與剪下(這兩個動作用 keydown 攔不到),keydown 與 keyup 覆蓋一般輸入與刪除,focus 與 blur 則處理初始狀態的校正。

兩個可以再強化的地方

1. 用 input 事件取代大半鍵盤事件。現代瀏覽器支援 input 事件,它在任何導致內容變動的操作後都會觸發,包含貼上、剪下、 Undo、以及以程式改值,比列舉一堆事件更可靠:

 $(this).on('input propertychange', function(){ /* 重新計算高度 */ }); 

2. 避免每次按鍵都觸發排版。高度計算會讀取 layout 資訊,成本不低。實務上可以用 requestAnimationFrame 或簡單的 debounce 把多次計算合併成一次,輸入大量文字時會明顯順暢。

另外提醒:範例中的 minHeight 在外掛定義時就讀了一次 $(this).height(),若元素當時是隱藏狀態,取到的值可能為 0。遇到這種情況,建議改為在第一次觸發事件時才讀取,或允許由呼叫端明確傳入 minHeight。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved