CharacterData 抽象インターフェイスは、文字を包含する Node オブジェクトを表します。これは抽象インターフェイスであり、CharacterData 型のオブジェクトは存在しません。抽象化されていない Text、Comment、ProcessingInstruction といったインターフェイスによって実装されています。
プロパティ
親インターフェイスである Node からプロパティを継承します。また、ChildNode および NonDocumentTypeChildNode インターフェイスを実装します。
CharacterData.data- 当該オブジェクトが包含するテキストデータを表す
DOMStringです。 CharacterData.length読取専用CharacterData.dataが持つ文字列のサイズを表すunsigned longを返します。NonDocumentTypeChildNode.nextElementSibling読取専用- 親要素の子のリストで、指定した要素の直後にある
Elementを返します。または、指定した要素がリストの末尾にある場合はnullを返します。 NonDocumentTypeChildNode.previousElementSibling読取専用- 親要素の子のリストで、指定した要素の直前にある
Elementを返します。または、指定した要素がリストの先頭にある場合はnullを返します。
メソッド
親インターフェイスである Node からメソッドを継承します。また、ChildNode および NonDocumentTypeChildNode インターフェイスを実装します。
CharacterData.appendData()- 指定した
DOMStringをCharacterData.dataの文字列に追加します。メソッドの戻り値でdataは、結合したDOMStringを持ちます。 CharacterData.deleteData()CharacterData.dataの文字列の指定したオフセット位置から、指定した量の文字を削除します。メソッドの戻り値でdataは、削除後のDOMStringを持ちます。CharacterData.insertData()CharacterData.dataの文字列の指定したオフセット位置に、指定した文字を挿入します。メソッドの戻り値でdataは、変更後のDOMStringを持ちます。ChildNode.remove()- 親要素の子のリストから、オブジェクトを削除します。
CharacterData.replaceData()- 指定したオフセット位置から指定した量の文字列を、指定した
DOMStringに置き換えます。メソッドの戻り値でdataは、変更後のDOMStringを持ちます。 CharacterData.substringData()CharacterData.dataの指定したオフセット位置から、指定した長さの部分を持つDOMStringを返します。
仕様
ブラウザ実装状況
| 機能 | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
|---|---|---|---|---|---|
| 基本サポート | 1.0 | 1.0 (1.7 or earlier) | 6 | (有) | (有) |
ChildNode インターフェイスを実装 |
? | 25.0 (25.0) [1] | 未サポート | ? | 未サポート |
| 機能 | Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
|---|---|---|---|---|---|
| 基本サポート | (有) | 1.0 (1.0) | (有) | (有) | (有) |
ChildNode インターフェイスを実装 |
? | 25.0 (25.0) [1] | 未サポート | ? | 未サポート |
[1] nextElementSibling および previousElementSibling の 2 つのプロパティは NonDocumentTypeChildNode インターフェイスに移動しました。CharacterData でも実装されています。