HOWTO · JavaScript
如何在 JavaScript 中將 Div 捲動到底部
本文說明如何將可捲動的 div 捲動到最新內容,並介紹 scrollTop 與 scrollHeight、jQuery、jQuery .animate()、element.scroll(),以及 scrollIntoView() 的適用情境。
本頁內容
若要讓 <div> 顯示最新內容,請將它的 scrollTop 設為 scrollHeight - clientHeight。容器必須有固定或受限制的高度,而且內容必須超出可視範圍。例如,新增聊天訊息後,對聊天容器執行這項計算。本文也會介紹 jQuery、動畫捲動、element.scroll(),以及何時適合使用 scrollIntoView()。
在 JavaScript 中使用 scrollTop 和 scrollHeight 將 <div> 捲動到底部
scrollTop 是容器已垂直捲動的像素數。scrollHeight 會計算完整內容的高度,包括可視區域以外的部分;clientHeight 則是容器內部可視區域的高度。因此,垂直捲動的最大有效位置是 scrollHeight - clientHeight,不需要直接指定完整的 scrollHeight。
容器必須有高度限制,而且內容高度要超過該限制,才能捲動。CSS 的 overflow-y: auto 會在需要時顯示捲軸;overflow-y: scroll 也可使用,並會保留捲軸的空間。以下可執行的 JavaScript 範例使用與 DOM 屬性相同的數值示範這項計算:
const container = { scrollTop: 0, scrollHeight: 640, clientHeight: 240 };
container.scrollTop = container.scrollHeight - container.clientHeight;
console.log(container.scrollTop);
400
在瀏覽器中,請在內容加入容器後,對實際的容器執行這項指定,例如:const box = document.querySelector('#chat'); box.scrollTop = box.scrollHeight - box.clientHeight;。如果內容是非同步呈現,請等呈現完成後再指定,這樣測得的高度才會包含新內容。
在 JavaScript 中使用 jQuery 將 <div> 捲動到底部
如果頁面已使用 jQuery,可以用它的 scrollTop() 方法設定垂直捲動位置。若要讀取 scrollHeight,請存取選取元素底層的 DOM 節點,例如 $('#chat')[0],再從該節點的 clientHeight 扣除。操作方式如下:const box = $('#chat')[0]; $('#chat').scrollTop(box.scrollHeight - box.clientHeight);。
這種方式仍需要可捲動的容器,以及超出容器範圍的內容。jQuery 是外部函式庫依賴;若頁面原本沒有使用 jQuery,使用原生的 scrollTop 方法就不必額外加入這項依賴。以下瀏覽器程式碼僅供說明,未實際執行。
在 JavaScript 中使用 jQuery .animate() 將 <div> 捲動到底部
若想讓容器在一段時間內移動,而不是立刻跳到底部,可以使用 jQuery .animate()。傳入目標 scrollTop 和以毫秒為單位的時間長度。例如:const box = $('#chat')[0]; $('#chat').stop(true).animate({ scrollTop: box.scrollHeight - box.clientHeight }, 500);。
500 表示要求動畫持續半秒。先呼叫 .stop(true) 會停止目前的動畫並清除佇列中的動畫,再開始新的動畫;因此,內容反覆更新時不會累積一串待執行的動畫。和立即捲動的 jQuery 方法一樣,這種方式需要 jQuery 和可捲動的容器。以下瀏覽器程式碼未實際執行。
在 JavaScript 中使用 element.scroll() 將 <div> 捲動到底部
原生 element.scroll() 方法接受目標位置,也可以要求平滑捲動。目標位置與使用 scrollTop 時相同:
const box = document.querySelector('#chat'); box.scroll({ top: box.scrollHeight - box.clientHeight, behavior: 'smooth' });
若要立即移動,請省略 behavior: 'smooth',或改用 behavior: 'instant'。這段瀏覽器 API 程式碼僅供說明,未實際執行;它假設 #chat 指向預定的可捲動容器,而且容器內容已經呈現。
在 JavaScript 中使用 element.scrollIntoView() 將 <div> 捲動到底部
scrollIntoView() 會將呼叫此方法的元素捲動到可視範圍內。為了做到這點,它可能會捲動容器、其他祖先元素,或整個頁面。這個方法不會直接把容器內部的捲動位置設為底部。
如果目標是顯示最後一個項目或標記,可以使用這個方法。在內容後方加入標記,再呼叫 document.querySelector('#latest-message').scrollIntoView({ block: 'end', behavior: 'smooth' });。這會以該元素為目標;依版面配置而定,頁面或祖先容器也可能跟著移動。若要可靠地將特定容器本身捲到底部,請改用 scrollTop 或 element.scroll()。以下瀏覽器程式碼未實際執行。
結論
若要捲動可捲動的 <div>,直接使用原生方法即可:在最新內容加入後,將 scrollTop 設為 scrollHeight - clientHeight。如果頁面已依賴 jQuery,可使用它的 scrollTop();若需要定時移動效果,則可使用 .animate()。原生 element.scroll() 也支援平滑捲動。若要讓特定子元素進入可視範圍,請使用 scrollIntoView();若要設定容器本身的捲動位置,則使用前述方法。