contentEditable 最早由 Microsoft 提出,後來被各家瀏覽器陸續實作並納入標準,是一個可以套用在任何元素上的全域屬性。顧名思義,它的工作就是讓使用者直接在頁面上編輯元素裡的內容:加上這個屬性之後,元素變得可以取得滑鼠焦點,點下去會出現插入符號(caret),提示這塊區域是可以打字修改的。
它本質上是布林屬性,取值 true 或 false。此外還有一個比較少被提到的 inherit(繼承)狀態:明確寫 true 代表允許編輯,寫 false 代表禁止編輯,而完全不指定時則由 inherit 決定——父元素可編輯,子元素就跟著可編輯。這讓你可以只在外層容器開啟一次編輯,內部再由個別元素用 false 關掉。
與它搭配使用的是唯讀屬性 isContentEditable。它在執行階段回報目前元素是否處於可編輯狀態,可編輯時為 true,否則為 false,常用來做狀態判斷或樣式切換。
<!DOCTYPE Html>
<head>
<meta charset="UTF-8">
<title>contentEditable 屬性示例</title>
</head>
<h2>可編輯列表</h2>
<ul contentEditable="true">
<li>列表元素1</li>
<li>列表元素2</li>
<li>列表元素3</li>
</ul>
這段程式碼執行後的結果如下圖,讀者可以直接在瀏覽器裡點上去試著編輯:
談到多行文字輸入,大家第一個想到的通常是 textarea。它確實方便,卻有個先天限制:高度是被動的。你要嘛用 rows、cols 指定行列數,要嘛直接用 CSS 給定寬高,內容變多時它不會自己長高,只會跳出捲軸。
但「自動增高」在很多場景裡剛好是剛需,最典型的就是微博這類社群貼文的輸入框:先有一個預設高度,文字超過之後方塊往下長高,长到設定的上限之後才改成內部捲動。
如果硬用 textarea 實作,就得靠 JavaScript 監聽輸入事件、量測內容高度再回寫 style.height,桌面端勉強堪用,到了行動端更顯得笨重。這時候 contenteditable 就是個漂亮的解法。
例如:
<div contenteditable="true" class="box" id="box"></div>
<style>
.box{
width:200px;
max-height:100px;
border:1px solid #ccc;
overflow-y:auto;
overflow-x:hidden;
}
</style>
只要把 contenteditable 設為 true,這個 div 立刻變成可編輯區域,而且會隨著內容增加而自動變高;再給它一個 max-height 搭配 overflow-y: auto,超過上限後的垂直捲動就交給瀏覽器處理,一行 JavaScript 都不用寫。
整體來說,contenteditable 把「會隨內容長高」這件事還給了瀏覽器,省下一堆高度計算的樣板程式。只要再補上表單取值、內容清洗與無障礙這幾個環節,它就是打造類微博輸入框、行內即時編輯、所見即所得編輯器的理想起點。