CharacterData

Esta tradução está incompleta. Ajude a traduzir este artigo em inglês

A interface abstrata CharacterData representa um objeto Node que contém caracteres. Esta é uma interface abstrata, o que significa que não há nenhum objeto do tipo CharacterData: ela é implementada por outras interfaces, como Text, Comment ou ProcessingInstruction, que não são abstratas.

  <div id="interfaceDiagram" style="display: inline-block; position: relative; width: 100%; padding-bottom: 11.666666666666666%; vertical-align: middle; overflow: hidden;"><svg style="display: inline-block; position: absolute; top: 0; left: 0;" viewbox="-50 0 600 70" preserveAspectRatio="xMinYMin meet"><a xlink:href="https://developer.mozilla.org/pt-BR/docs/Web/API/EventTarget" target="_top"><rect x="1" y="1" width="110" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="56" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">EventTarget</text></a><polyline points="111,25  121,20  121,30  111,25" stroke="#D4DDE4" fill="none"/><line x1="121" y1="25" x2="151" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/pt-BR/docs/Web/API/Node" target="_top"><rect x="151" y="1" width="75" height="50" fill="#fff" stroke="#D4DDE4" stroke-width="2px" /><text  x="188.5" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">Node</text></a><polyline points="226,25  236,20  236,30  226,25" stroke="#D4DDE4" fill="none"/><line x1="236" y1="25" x2="266" y2="25" stroke="#D4DDE4"/><a xlink:href="https://developer.mozilla.org/pt-BR/docs/Web/API/CharacterData" target="_top"><rect x="266" y="1" width="130" height="50" fill="#F4F7F8" stroke="#D4DDE4" stroke-width="2px" /><text  x="331" y="30" font-size="12px" font-family="Consolas,Monaco,Andale Mono,monospace" fill="#4D4E53" text-anchor="middle" alignment-baseline="middle">CharacterData</text></a></svg></div>

  a:hover text { fill: #0095DD; pointer-events: all;}

Propriedades

Herda propriedades de seu pai, Node, e implementa as interfaces ChildNode e NonDocumentTypeChildNode.

CharacterData.data: É um DOMString representando os dados textuais contidos neste objeto.
CharacterData.length Somente leitura: Retorna um unsigned long representando o tamanho da string contida em CharacterData.data.
NonDocumentTypeChildNode.nextElementSibling Somente leitura: Returns the Element immediately following the specified one in its parent's children list, or null if the specified element is the last one in the list.
NonDocumentTypeChildNode.previousElementSibling Somente leitura: Returns the Element immediately prior to the specified one in its parent's children list, or null if the specified element is the first one in the list.

Methods

Inherits methods from its parent, Node, and implements the ChildNode and NonDocumentTypeChildNode interface.

CharacterData.appendData(): Appends the given DOMString to the CharacterData.data string; when this method returns, data contains the concatenated DOMString.
CharacterData.deleteData(): Removes the specified amount of characters, starting at the specified offset, from the CharacterData.data string; when this method returns, data contains the shortened DOMString.
CharacterData.insertData(): Inserts the specified characters, at the specified offset, in the CharacterData.data string; when this method returns, data contains the modified DOMString.
ChildNode.remove(): Removes the object from its parent children list.
CharacterData.replaceData(): Replaces the specified amount of characters, starting at the specified offset, with the specified DOMString; when this method returns, data contains the modified DOMString.
CharacterData.substringData(): Returns a DOMString containing the part of CharacterData.data of the specified length and starting at the specified offset.

Specifications

Specification	Status	Comment
DOM The definition of 'CharacterData' in that specification.	Padrão em tempo real	Added implemention of the `ChildNode` and `NonDocumentTypeChildNode` interface.
Document Object Model (DOM) Level 3 Core Specification The definition of 'CharacterData' in that specification.	Obsoleto	No change from Document Object Model (DOM) Level 2 Core Specification.
Document Object Model (DOM) Level 2 Core Specification The definition of 'CharacterData' in that specification.	Obsoleto	No change from Document Object Model (DOM) Level 1 Specification.
Document Object Model (DOM) Level 1 Specification The definition of 'CharacterData' in that specification.	Obsoleto	Initial definition.

Browser compatibility

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`CharacterData`	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support 6	Opera Full support Yes	Safari Full support Yes	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support Yes	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes
Implements the `ChildNode` interface Non-standard	Chrome Full support Yes	Edge Full support ≤18	Firefox Full support 25 Notes Full support 25 Notes Notes Two properties, `nextElementSibling` and `previousElementSibling`, have been moved to the `NonDocumentTypeChildNode` interface, also implemented by `CharacterData`.	IE No support No	Opera Full support Yes	Safari No support No	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support 25 Notes Full support 25 Notes Notes Two properties, `nextElementSibling` and `previousElementSibling`, have been moved to the `NonDocumentTypeChildNode` interface, also implemented by `CharacterData`.	Opera Android Full support Yes	Safari iOS ?	Samsung Internet Android Full support Yes
`appendData`	Chrome Full support Yes	Edge Full support 12	Firefox Full support Yes	IE ?	Opera Full support Yes	Safari Full support Yes	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support Yes	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes
`data`	Chrome Full support Yes	Edge Full support 12	Firefox Full support Yes	IE ?	Opera Full support Yes	Safari Full support Yes	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support Yes	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes
`deleteData`	Chrome Full support Yes	Edge Full support 12	Firefox Full support Yes	IE ?	Opera Full support Yes	Safari Full support Yes	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support Yes	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes
`insertData`	Chrome Full support Yes	Edge Full support 12	Firefox Full support Yes	IE ?	Opera Full support Yes	Safari Full support Yes	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support Yes	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes
`length`	Chrome Full support Yes	Edge Full support 12	Firefox Full support Yes	IE ?	Opera Full support Yes	Safari Full support Yes	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support Yes	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes
`replaceData`	Chrome Full support Yes	Edge Full support 12	Firefox Full support Yes	IE ?	Opera Full support Yes	Safari Full support Yes	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support Yes	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes
`substringData`	Chrome Full support Yes	Edge Full support 12	Firefox Full support Yes	IE ?	Opera Full support Yes	Safari Full support Yes	WebView Android Full support Yes	Chrome Android Full support Yes	Firefox Android Full support Yes	Opera Android Full support Yes	Safari iOS Full support Yes	Samsung Internet Android Full support Yes

Legend

Full support: Full support
No support: No support
Compatibility unknown: Compatibility unknown
Non-standard. Expect poor cross-browser support.: Non-standard. Expect poor cross-browser support.
See implementation notes.: See implementation notes.

Propriedades

Methods

Specifications

Browser compatibility

Legend

See also

Aprenda o melhor em desenvolvimento web