CharacterData

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

CharacterData 抽象介面表示包含字元的 Node 物件。這是一個抽象介面,這意味著不存在 CharacterData 型別的物件:它由其他介面實現,例如 TextCommentCDATASectionProcessingInstruction,這些介面不是抽象的。

EventTarget Node CharacterData

例項屬性

此介面還繼承了其父介面 NodeEventTarget 的屬性。

CharacterData.data

一個表示該物件包含的文字資料的字串。

CharacterData.length 只讀

返回一個數字,表示物件中包含的字串的大小。

CharacterData.nextElementSibling 只讀

返回此節點之後、作為其同級節點的第一個 Element

CharacterData.previousElementSibling 只讀

返回此節點之前、作為其同級節點的第一個 Element

例項方法

此介面還繼承了其父介面 NodeEventTarget 的方法。

CharacterData.after()

CharacterData 物件的父物件的子列表(緊跟在 CharacterData 物件之後)中插入一組 Node 物件或字串。

CharacterData.appendData()

將給定的字串附加到 CharacterData.data 字串;此方法返回後,data 包含連線後的字串。

CharacterData.before()

CharacterData 物件的父物件的子列表(緊跟在 CharacterData 物件之前)中插入一組 Node 物件或字串。

CharacterData.deleteData()

CharacterData.data 字串中刪除指定數量的字元(從指定偏移量開始);此方法返回後,data 包含縮短後的字串。

CharacterData.insertData()

CharacterData.data 字串的指定偏移量處插入指定的字元;此方法返回後,data 包含修改後的字串。

CharacterData.remove()

從其父物件的子列表中刪除該物件。

CharacterData.replaceData()

用指定的字串替換指定數量的字元(從指定偏移量開始);此方法返回後,data 包含修改後的字串。

CharacterData.replaceWith()

用一組 Node 物件或字串替換其父物件的子列表中的字元。

CharacterData.substringData()

返回一個字串,其中包含 CharacterData.data 中指定長度且從指定偏移量開始的部分。

規範

規範
DOM
# interface-characterdata

瀏覽器相容性

另見

  • DOM 概覽頁面.
  • 實現它的具體介面有:TextCDATASectionProcessingInstructionComment