appendData (W3C DOM Core method)
| Version | Depr. | Static |
|---|---|---|
| DOM1 | No | No |
| IE6+ | FF1.5+ | SA1.3+ | OP9+ |
|---|---|---|---|
| Full | Full | Full | Full |
- Returns
void- Throws
NO_MODIFICATION_ALLOWED_ERR
Example
var sentence = document.createTextNode("When you're smiling");
sentence.appendData(", the whole world smiles with you.");In the
example above we create a Text node with the value
When you're smiling, then we use the
appendData method to add the string , the
whole world smiles with you. to the end of that node.
The
final result is a single Text node with the data (and nodeValue)
When you're smiling, the whole world smiles with you.,
that has a length of 53.
Arguments
- string (
DOMString) required The string to append.
Description
Append a string to the end of this character data.
After a successful operation, the data and length properties of the node
reflect the change.
I've never used this method — JavaScript's built-in string manipulation methods are far more flexible and powerful than anything offered by the DOM.
Compatibility
| Internet Explorer | Firefox | Safari | Opera | |||||||
|---|---|---|---|---|---|---|---|---|---|---|
| 5.5 | 6.0 | 7.0 | 1.5 | 2.0 | 3.0 | 1.3 | 2.0 | 3.0 | 9.0 | 9.5 |
| Partial | Full | Full | Full | Full | Full | Full | Full | Full | Full | Full |
Internet Explorer 5.5 in HTML doesn't implement this method (it returns undefined).
User-contributed notes
There are no comments yet.
Add a note
To post a note on this topic, please log in with your SitePoint username and password. If you don't have an account yet, you can create a new account for free.