outerText Property | Internet Development Index |
Sets or retrieves the text of the object.
Syntax
HTML N/A Scripting object.outerText [ = sTxt ]
Possible Values
sTxt String that specifies or receives the text. The property is read/write. The property has no default value.
Expressions can be used in place of the preceding value(s), as of Microsoft® Internet Explorer 5. For more information, see About Dynamic Properties.
Remarks
The outerText property is read-only on the html, tBody, td, tFoot, th, tHead, and tr objects.
When this property is set, the given string completely replaces the original text in the object.
You can set this property only after the onload event fires on the window. When dynamically creating a tag using TextRange, innerHTML, or outerHTML, use Microsoft® JScript® to create new events to handle the newly formed tags. Microsoft Visual Basic® Scripting Edition (VBScript) is not supported.
You can change the value of the title element using the document.TITLE property.
To change the contents of the table, tFoot, tHead, and tr elements, use the table object model. For example, use the rowIndex property or the rows collection to retrieve a reference to a specific table row. You can add or delete rows using the insertRow and deleteRow methods. To retrieve a reference to a specific cell, use the cellIndex property or the cells collection. You can add or delete rows using the insertCell and deleteCell methods. To change the content of a particular cell, use the innerHTML property.
Example
This example uses the outerText property to replace an object's content; the object itself also is replaced.
<DIV ID=oDiv> <P ID=oPara>Here's the text that will change.</P> </DIV> : <BUTTON onclick="oPara.outerText='WOW! It changed!'">Change text</BUTTON> <BUTTON onclick="oDiv.innerHTML='<P ID=oPara> And back again</P>'">Reset</BUTTON>
Standards Information
There is no public standard that applies to this property.
Applies To
A, ACRONYM, ADDRESS, APPLET, AREA, B, BDO, BGSOUND, BIG, BLOCKQUOTE, BR, BUTTON, CENTER, CITE, CODE, COMMENT, CUSTOM, DD, DEL, DFN, DIR, DIV, DL, DT, EM, EMBED, FIELDSET, FONT, FORM, hn, HR, HTML, I, IFRAME, IMG, INPUT type=button, INPUT type=checkbox, INPUT type=file, INPUT type=hidden, INPUT type=image, INPUT type=password, INPUT type=radio, INPUT type=reset, INPUT type=submit, INPUT type=text, INS, KBD, LABEL, LEGEND, LI, LISTING, MAP, MARQUEE, MENU, nextID, NOBR, OBJECT, OL, P, PLAINTEXT, PRE, Q, RT, RUBY, S, SAMP, SELECT, SMALL, SPAN, STRIKE, STRONG, SUB, SUP, TABLE, TBODY, TD, TEXTAREA, TFOOT, TH, THEAD, TR, TT, U, UL, VAR, WBR, XMP
See Also
insertAdjacentText