HOWTO · JavaScript

使用 Javascript 更改 Div 的文字

本教程詳細介紹瞭如何在 Javascript 中更改 div 的文字

本頁內容

若要變更 div 顯示的文字,請先選取該元素,再將字串指定給它的 textContent 屬性。這會把字串視為文字,即使其中包含 < 或 > 等字元也一樣。

使用 textContent 變更 div 的文字

在瀏覽器頁面中,請將指令碼放在元素之後,或等文件載入完成後再執行。選取器必須符合你要更新的 div。

<div id="message">Welcome</div>
<script>
  const message = document.querySelector("#message");
  message.textContent = "Hello, world!";
</script>

上方的瀏覽器範例會更新實際頁面,畫面上顯示的「Welcome」標籤仍是英文。若要查看屬性指定與顯示值的小型 JavaScript 範例,請執行:

const div = { textContent: "" };
div.textContent = "Hello, world!";
console.log(div.textContent);
Hello, world!

這個可執行範例使用一般物件示範如何指定屬性及輸出值;HTML 範例則示範如何更新實際頁面。一般物件範例顯示的「Hello, world!」標籤也維持英文。指定 textContent 時,元素原有的子節點會被包含新字串的文字節點取代。若目標是設定純文字,尤其是值來自使用者或其他不可信來源時,請使用此屬性。

如何選擇 textContent 或 innerHTML

設定文字時請使用 textContent。innerHTML 會將指定字串解析為 HTML,並以解析後的節點取代元素的子節點,因此只有在確實要插入標記時才選用它。將不可信資料放入會解析 HTML 的情境可能造成跨網站指令碼風險;不過,解析標記並不代表每個字串都會自動以程式碼執行。

例如,將字串 <strong>Hi</strong> 指定給 textContent,會照原樣顯示這些字元。若指定給 innerHTML,則會建立 strong 元素,因此瀏覽器會以粗體顯示「Hi」。若需要標記,請將標記與不可信值分開,並採用合適且安全的呈現方式。

使用其他 JavaScript 方法更新文字

innerText 可取得或設定呈現後的文字,也可能反映樣式與版面配置;需要這種呈現文字行為時再使用它。若只是直接替換文字,通常使用 textContent 更清楚。

建立 DOM 內容時,你可以使用 createTextNode 建立文字節點,再以該節點取代現有子節點。以反引號括住的範本字串可用來組合動態字串;將組合後的字串指定給 textContent,仍會把它視為文字。如果頁面已載入 jQuery,$("#message").text("Hello, world!") 會設定所選元素的文字。若沒有載入 jQuery,請使用上方示範的瀏覽器 DOM API。

使用 CSS 產生內容顯示裝飾文字

CSS 的 ::before 和 ::after 偽元素可加入視覺裝飾,例如在元素旁加上小標籤。產生的內容不會透過 JavaScript 更新 div 的 DOM 文字,因此不適合用來呈現重要資訊或互動內容。部分替代元素(包括 img)呈現產生內容的方式也與一般元素不同。若文字必須成為頁面實際內容的一部分,請使用 textContent。