自從 HTML5 引入 contenteditable 屬性後,div 就能像 textarea 一樣承載可編輯內容。這篇整理一系列以 div 打造編輯器的實作細節。
div.contentEditable = true;
也可以在 HTML 中直接寫 <div contenteditable="true">。
實現可視化編輯有兩種 API:contentEditable 與 designMode。前者最早由 IE 實作,後來各大瀏覽器陸續跟進並被納入 HTML5 標準;後者只能将整个 document 設為可編輯。contentEditable 能作用於任意元素,應用範圍更廣,是未來的方向。
注意 contenteditable 與 draggable 會互相衝突。若同時存在,通常要把 draggable 設為 false,否則無法正常編輯。
htmlElement.contentEditable = false;
if (event.keyCode == 13) {
htmlElement.blur();
}
if (event.shiftKey && event.keyCode == 13) {
return;
}
Chrome 上直接 return 即可。Firefox 需要手動插入 <br>:
if (event.shiftKey && event.keyCode == 13) {
var text = htmlElement.textContent;
htmlElement.innerHTML = text + '<br>';
return;
}
相關的 CSS 屬性:
width: 80px; /* 限制 div 寬度 */
text-overflow: clip; /* 溢出時不換行也不省略;設為 ellipsis 則顯示 … */
white-space: nowrap; /* 強制單行顯示 */
overflow: hidden; /* 隱藏溢出內容 */
word-wrap: break-word; /* 允許自動換行 */
一般設定前兩項即可達成需求,其餘視情況補上。
outline: none;
/* 或 */
outline: 0;
使用 selection 物件的 modify(alter, direction, granularity) 方法。它用於移動焦點或擴展/縮小選取範圍:
alter: "move" 移動焦點;"extend" 改變 selection
direction: forward | backward | left | right
granularity: character | word | sentence | line | paragraph
| lineboundary | sentenceboundary | paragraphboundary
| documentboundary
Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1 之後才支援。全選的寫法:
if (window.getSelection) {
var sel = window.getSelection();
sel.modify('move', 'left', 'documentboundary');
sel.modify('extend', 'right', 'documentboundary');
}
遺憾的是 Firefox 的實作不支援 sentence、paragraph 與各種 boundary 參數。可改用 line 逐行擴展:
var isFireFox = function () {
var ua = navigator.userAgent.toLowerCase();
return !!ua.match(/firefox\/([\d.]+)/);
};
if (isFireFox()) {
var count = htmlElement.innerHTML.split('<br>').length;
for (var i = 0; i < count; i++) {
sel.modify('extend', 'right', 'line');
}
}
聊天視窗是典型場景:新訊息永遠要可見。相關屬性有 scrollTop、scrollLeft、scrollWidth、scrollHeight。
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8" />
<title>將滾動條保持在最底部的方法</title>
</head>
<body>
<script type="text/javascript">
function add() {
var now = new Date();
var div = document.getElementById('scrolldIV');
div.innerHTML = div.innerHTML + 'time_' + now.getTime() + '<br>';
div.scrollTop = div.scrollHeight;
}
</script>
<p>請點擊「插入一行」,當出現滾動條時,它將自動保持在底部。</p>
<div id="scrolldIV"
style="overflow:auto; height:100px; width:400px; border:1px solid #999;">
</div>
<input type="button" value="插入一行" onclick="add();">
</body>
</html>
核心就一行:div.scrollTop = div.scrollHeight;。scrollHeight 是包含隱藏部分在內的完整內容高度。同理,滾到最右是 div.scrollLeft = div.scrollWidth;。搭配 offsetHeight、offsetLeft 等屬性可以做更精細的位置控制。
textarea 的高度是固定的,無法隨內容增長。用 contenteditable 的 div 可以模擬出「越打越高,超過上限後出現滾動條」的效果。
<div class="testbox" contenteditable="true"></div>
.testbox {
width: 400px;
min-height: 120px;
max-height: 300px;
margin-left: auto;
margin-right: auto;
padding: 3px;
outline: 0;
border: 1px solid #a0b3d6;
font-size: 12px;
word-wrap: break-word;
overflow-x: hidden;
overflow-y: auto;
}
min-height 決定初始高度,max-height 搭配 overflow-y: auto 決定何時出現滾動條。
contenteditable 好用但陷阱不少:貼上內容會帶入來源頁面的樣式、使用者可能插入任意 HTML 造成 XSS、undo/redo 行為各瀏覽器不一致、composition 事件(中文輸入法)處理繁瑣。
正式專案請考慮成熟方案如 ProseMirror、Slate、Lexical 或 Tiptap,它們處理了 selection 管理、協作編輯與輸入法相容等問題。若只是想讓 textarea 高度自適應,其實不必動用 contenteditable——一行 JS 就夠了:
textarea.addEventListener('input', function () {
this.style.height = 'auto';
this.style.height = this.scrollHeight + 'px';
});