Represents the cascaded format and style of the object that overrides the format and style specified in global style sheets, inline styles, and HTML attributes.

Members Table

The following table lists the members exposed by the runtimeStyle object.

Attributes/Properties

Property	Description
onOffBehavior	This property is deprecated. Gets an object that indicates whether the specified Microsoft DirectAnimation behavior is running.

Filters

Filter property	Description
Alpha	Adjusts the opacity of the content of the object.
BlendTrans	Reveals new content of the object by fading the original content.
Chroma	Displays a specific color of the content of the object as transparent.
DropShadow	Creates a solid silhouette of the content of the object, offset in the specified direction. This creates the illusion that the content is floating and casting a shadow.
FlipH	Displays the content of the object flipped across the horizontal axis.
FlipV	Displays the content of the object flipped across the vertical axis.
Glow	Adds radiance around the outside edges of the content of the object so that it appears to glow.
Gray	Displays the content of the object in grayscale.
Invert	Reverses the hue, saturation, and brightness values of the content of the object.
Light	Creates the effect of a light shining on the content of the object.
MaskFilter	Displays transparent pixels of the object content as a color mask, and makes the nontransparent pixels transparent.
MotionBlur	Causes the content of the object to appear to be in motion.
Redirect	Not supported.
RevealTrans	Reveals new content of the object using one of 24 predefined Transition effects.
Shadow	Creates a solid silhouette of the content of the object, offset in the specified direction. This creates the illusion of a shadow.
Wave	Performs a sine wave distortion of the content of the object along the vertical axis.
Xray	Changes the color depth of the content of the object and displays it in black and white.

Methods

Method	Description
getAttribute	Retrieves the value of the specified attribute.
getExpression	Retrieves the expression for the given property.
removeAttribute	Removes an attribute from an object.
removeExpression	Removes the expression from the specified property.
setAttribute	Sets the value of the specified attribute.
setExpression	Sets an expression for the specified object.

Styles

Style attribute	Style property	Description
-ms-accelerator	accelerator	Gets or sets a string that indicates whether the object represents a keyboard shortcut.
background	background	Gets or sets up to five separate background properties of the object.
background-attachment	backgroundAttachment	Gets or sets how the background image is attached to the object within the document.
background-clip	backgroundClip	Gets or sets the background painting area.
background-color	backgroundColor	Gets or sets the color behind the content of the object.
background-image	backgroundImage	Gets or sets the background image of the object.
background-origin	backgroundOrigin	Gets or sets the background positioning area of a box or multiple boxes.
background-position	backgroundPosition	Sets or retrieves the position of the background of the object.
-ms-background-position-x	backgroundPositionX	Gets or sets the x-coordinate of the backgroundPosition property.
-ms-background-position-y	backgroundPositionY	Gets or sets the y-coordinate of the backgroundPosition property.
background-repeat	backgroundRepeat	Gets or sets how the backgroundImage property of the object is tiled.
background-size	backgroundSize	Gets or sets the size of the background images.
-ms-behavior	behavior	Gets or sets the location of the Dynamic HTML (DHTML) behavior.
border	border	Sets or retrieves the properties to draw around the object.
border-bottom	borderBottom	Sets or retrieves the properties of the bottom border of the object.
border-bottom-color	borderBottomColor	Gets or sets the color of the bottom border of the object.
border-bottom-left-radius	borderBottomLeftRadius	Gets or sets one or two values that define the radii of the quarter ellipse that defines the shape of the lower-left corner for the outer border edge of the current box.
border-bottom-right-radius	borderBottomRightRadius	Gets or sets one or two values that define the radii of the quarter ellipse that defines the shape of the lower-right corner for the outer border edge of the current box.
border-bottom-style	borderBottomStyle	Gets or sets the style of the bottom border of the object.
border-bottom-width	borderBottomWidth	Gets or sets the width of the bottom border of the object.
border-collapse	borderCollapse	Gets or sets a value that indicates whether the row and cell borders of a table are joined in a single border or detached as in standard HTML.
border-color	borderColor	Gets or sets the border color of the object.
border-left	borderLeft	Sets or retrieves the properties of the left border of the object.
border-left-color	borderLeftColor	Gets or sets the color of the left border of the object.
border-left-style	borderLeftStyle	Gets or sets the style of the left border of the object.
border-left-width	borderLeftWidth	Gets or sets the width of the left border of the object.
border-radius	borderRadius	Gets or sets one or more values that define the radii of a quarter ellipse that defines the shape of the corners for the outer border edge of the current box.
border-right	borderRight	Sets or retrieves the properties of the right border of the object.
border-right-color	borderRightColor	Gets or sets the color of the right border of the object.
border-right-style	borderRightStyle	Gets or sets the style of the right border of the object.
border-right-width	borderRightWidth	Gets or sets the width of the right border of the object.
border-spacing	borderSpacing	Gets or sets the distance between the borders of adjoining cells in a table.
border-style	borderStyle	Gets or sets the style of the left, right, top, and bottom borders of the object.
border-top	borderTop	Sets or retrieves the properties of the top border of the object.
border-top-color	borderTopColor	Gets or sets the color of the top border of the object.
border-top-left-radius	borderTopLeftRadius	Gets or sets one or two values that define the radii of the quarter ellipse that defines the shape of the upper-left corner for the outer border edge of the current box.
border-top-right-radius	borderTopRightRadius	Gets or sets one or two values that define the radii of the quarter ellipse that defines the shape of the upper-right corner for the outer border edge of the current box.
border-top-style	borderTopStyle	Gets or sets the style of the top border of the object.
border-top-width	borderTopWidth	Gets or sets the width of the top border of the object.
border-width	borderWidth	Gets or sets the width of the left, right, top, and bottom borders of the object.
bottom	bottom	Gets or sets the bottom position of the object in relation to the bottom of the next positioned object in the document hierarchy.
box-shadow	boxShadow	Gets or sets a comma-separated list of shadows that attaches one or more drop shadows to the current box.
box-sizing	boxSizing	Gets or sets the box model to use for object sizing.
caption-side	captionSide	Gets or sets where the caption of a table is located.
clear	clear	Gets or sets whether the object allows floating objects on its left side, right side, or both, so that the next text displays past the floating objects.
clip	clip	Sets or retrieves which part of a positioned object is visible.
color	color	Gets or sets the color of the text of the object.
content	content	Gets or sets generated content to insert before or after an element.
counter-increment	counterIncrement	Gets or sets a list of counters to increment.
counter-reset	counterReset	Gets or sets a list of counters to create or reset to zero.
	cssText	Gets or sets the persisted representation of the style rule.
cursor	cursor	Gets or sets the type of cursor to display as the mouse pointer moves over the object.
direction	direction	Gets or sets the reading order of the object.
empty-cells	emptyCells	Determines whether to show or hide a cell without content.
font	font	Sets or retrieves a combination of separate font properties of the object. Alternatively, sets or retrieves one or more of six user-preference fonts.
font-family	fontFamily	Gets or sets the name of the font used for text in the object.
font-size	fontSize	Gets or sets a value that indicates the font size used for text in the object.
font-size-adjust	fontSizeAdjust	Gets or sets a value that specifies an aspect value for an element that will effectively preserve the x-height of the first choice font, whether it is substituted or not.
font-stretch	fontStretch	Gets or sets a value that indicates a normal, condensed, or expanded face of a font family.
font-style	fontStyle	Gets or sets the font style of the object as italic, normal, or oblique.
font-variant	fontVariant	Gets or sets whether the text of the object is in small capital letters.
font-weight	fontWeight	Gets or sets the weight of the font of the object.
height	height	Gets or sets the height of the object.
-ms-ime-mode	imeMode	Gets or sets the state of an Input Method Editor (IME).
-ms-layout-flow	layoutFlow	Gets or sets the direction and flow of the content in the object.
-ms-layout-grid	layoutGrid	Sets or retrieves the composite document grid properties that specify the layout of text characters.
-ms-layout-grid-char	layoutGridChar	Gets or sets the size of the character grid used for rendering the text content of an element.
-ms-layout-grid-line	layoutGridLine	Gets or sets the gridline value used for rendering the text content of an element.
-ms-layout-grid-mode	layoutGridMode	Gets or sets whether the text layout grid uses two dimensions.
-ms-layout-grid-type	layoutGridType	Gets or sets the type of grid used for rendering the text content of an element.
left	left	Gets or sets the position of the object relative to the left edge of the next positioned object in the document hierarchy.
letter-spacing	letterSpacing	Gets or sets the amount of additional space between letters in the object.
line-break	lineBreak	Gets or sets line-breaking rules for text in selected languages such as Japanese, Chinese, and Korean.
line-height	lineHeight	Gets or sets the distance between lines in the object.
list-style	listStyle	Sets or retrieves up to three separate listStyle properties of the object.
list-style-image	listStyleImage	Gets or sets a value that indicates which image to use as a list-item marker for the object.
list-style-position	listStylePosition	Gets or sets a variable that indicates how the list-item marker is drawn relative to the content of the object.
list-style-type	listStyleType	Gets or sets the predefined type of the line-item marker for the object.
margin	margin	Gets or sets the width of the top, right, bottom, and left margins of the object.
margin-bottom	marginBottom	Gets or sets the height of the bottom margin of the object.
margin-left	marginLeft	Gets or sets the width of the left margin of the object.
margin-right	marginRight	Gets or sets the width of the right margin of the object.
margin-top	marginTop	Gets or sets the height of the top margin of the object.
max-height	maxHeight	Gets or sets the maximum height for an element.
max-width	maxWidth	Gets or sets the maximum width for an element.
min-height	minHeight	Gets or sets the minimum height for an element.
min-width	minWidth	Gets or sets the minimum width for an element.
-ms-block-progression	msBlockProgression	Gets or sets the block progression and layout orientation.
-ms-interpolation-mode	msInterpolationMode	Obsolete. Gets or sets the interpolation (resampling) method used to stretch images.
opacity	opacity	Gets or sets a value that specifies object or group opacity in Cascading Style Sheets (CSS) or Scalable Vector Graphics (SVG).
orphans	orphans	Gets or sets the minimum number of lines of a paragraph that must appear at the bottom of a page.
outline	outline	Gets or sets the color, style, and width of the outline frame.
outline-color	outlineColor	Gets or sets the color of the outline frame.
outline-style	outlineStyle	Gets or sets the style of the outline frame.
outline-width	outlineWidth	Gets or sets the width of the outline frame.
overflow	overflow	Gets or sets a value indicating how to manage the content of the object when the content exceeds the height or width of the object.
-ms-overflow-x	overflowX	Gets or sets how to manage the content of the object when the content exceeds the width of the object.
-ms-overflow-y	overflowY	Gets or sets how to manage the content of the object when the content exceeds the height of the object.
padding	padding	Gets or sets the amount of space to insert between the object and its margin or, if there is a border, between the object and its border.
padding-bottom	paddingBottom	Gets or sets the amount of space to insert between the bottom border of the object and the content.
padding-left	paddingLeft	Gets or sets the amount of space to insert between the left border of the object and the content.
padding-right	paddingRight	Gets or sets the amount of space to insert between the right border of the object and the content.
padding-top	paddingTop	Gets or sets the amount of space to insert between the top border of the object and the content.
page-break-after	pageBreakAfter	Gets or sets a value indicating whether a page break occurs after the object.
page-break-before	pageBreakBefore	Gets or sets a string indicating whether a page break occurs before the object.
page-break-inside	pageBreakInside	Gets or sets a string indicating whether a page break is allowed to occur inside the object.
	pixelBottom	Sets or retrieves the bottom position of the object.
	pixelHeight	Sets or retrieves the height of the object.
	pixelLeft	Sets or retrieves the left position of the object.
	pixelRight	Sets or retrieves the right position of the object.
	pixelTop	Sets or retrieves the top position of the object.
	pixelWidth	Sets or retrieves the width of the object.
	posBottom	Sets or retrieves the bottom position of the object in the units specified by the bottom attribute.
	posHeight	Sets or retrieves the height of the object in the units specified by the height attribute.
position	position	Gets or sets the type of positioning used for the object.
	posLeft	Sets or retrieves the left position of the object in the units specified by the left attribute.
	posRight	Sets or retrieves the right position of the object in the units specified by the right attribute.
	posTop	Sets or retrieves the top position of the object in the units specified by the top attribute.
	posWidth	Sets or retrieves the width of the object in the units specified by the width attribute.
quotes	quotes	Gets or sets the pairs of strings to be used as quotes in generated content.
right	right	Gets or sets the position of the object relative to the right edge of the next positioned object in the document hierarchy.
ruby-align	rubyAlign	Gets or sets the position of the ruby text specified by the rt object.
ruby-overhang	rubyOverhang	Gets or sets the position of the ruby text specified by the rt object.
ruby-position	rubyPosition	Gets or sets the position of the ruby text specified by the rt object.
-ms-scrollbar-3dlight-color	scrollbar3dLightColor	Gets or sets the color of the top and left edges of the scroll box and scroll arrows of a scroll bar.
-ms-scrollbar-arrow-color	scrollbarArrowColor	Gets or sets the color of the arrow elements of a scroll arrow.
-ms-scrollbar-base-color	scrollbarBaseColor	Gets or sets the color of the main elements of a scroll bar, which include the scroll box, track, and scroll arrows.
-ms-scrollbar-darkshadow-color	scrollbarDarkShadowColor	Gets or sets the color of the gutter of a scroll bar.
-ms-scrollbar-face-color	scrollbarFaceColor	Gets or sets the color of the scroll box and scroll arrows of a scroll bar.
-ms-scrollbar-highlight-color	scrollbarHighlightColor	Gets or sets the color of the top and left edges of the scroll box and scroll arrows of a scroll bar.
-ms-scrollbar-shadow-color	scrollbarShadowColor	Gets or sets the color of the bottom and right edges of the scroll box and scroll arrows of a scroll bar.
-ms-scrollbar-track-color	scrollbarTrackColor	Gets or sets the color of the track element of a scroll bar.
float	styleFloat	Gets or sets on which side of the object the text will flow.
table-layout	tableLayout	Gets or sets a string that indicates whether the table layout is fixed.
text-align	textAlign	Gets or sets whether the text in the object is left-aligned, right-aligned, centered, or justified.
-ms-text-align-last	textAlignLast	Gets or sets how to align the last line or only line of text in the object.
-ms-text-autospace	textAutospace	Gets or sets the autospacing and narrow space width adjustment of text.
text-decoration	textDecoration	Gets or sets a value that indicates whether the text in the object has blink, line-through, overline, or underline decorations.
	textDecorationBlink	Sets or retrieves a Boolean value that indicates whether the object's textDecoration property has a value of "blink."
	textDecorationLineThrough	Sets or retrieves a Boolean value indicating whether the text in the object has a line drawn through it.
	textDecorationNone	Sets or retrieves the Boolean value indicating whether the textDecoration property for the object has been set to none.
	textDecorationOverline	Sets or retrieves a Boolean value indicating whether the text in the object has a line drawn over it.
	textDecorationUnderline	Sets or retrieves whether the text in the object is underlined.
text-indent	textIndent	Gets or sets the indentation of the first line of text in the object.
-ms-text-justify	textJustify	Gets or sets the type of alignment used to justify text in the object.
-ms-text-kashida-space	textKashidaSpace	Gets or sets the ratio of kashida expansion to white space expansion when justifying lines of text in the object.
-ms-text-overflow	textOverflow	Gets or sets a value that indicates whether to render ellipses(...) to indicate text overflow.
text-transform	textTransform	Gets or sets the rendering of the text in the object.
-ms-text-underline-position	textUnderlinePosition	Gets or sets the position of the underline decoration that is set through the textDecoration property of the object.
top	top	Gets or sets the position of the object relative to the top of the next positioned object in the document hierarchy.
unicode-bidi	unicodeBidi	Gets or sets the level of embedding with respect to the bidirectional algorithm.
vertical-align	verticalAlign	Gets or sets the vertical alignment of the object.
visibility	visibility	Gets or sets whether the content of the object is displayed.
widows	widows	Gets or sets the minimum number of lines of a paragraph that must appear at the top of a document.
width	width	Gets or sets the width of the object.
-ms-word-break	wordBreak	Gets or sets line-breaking behavior within words, particularly where multiple languages appear in the object.
word-spacing	wordSpacing	Gets or sets the amount of additional space between words in the object.
-ms-word-wrap	wordWrap	Gets or sets whether to break words when the content exceeds the boundaries of its container.
-ms-writing-mode	writingMode	Gets or sets the direction and flow of the content in the object.
z-index	zIndex	Gets or sets the stacking order of positioned objects.
-ms-zoom	zoom	Gets or sets the magnification scale of the object.

Remarks

The runtimeStyle object sets and retrieves the format and style of an object, and overrides existing formats and styles in the process. Other than having precedence over the style object and not persisting, the runtimeStyle object is equivalent to the style object.

To change or clear multiple style properties simultaneously, use this object with the cssText property. For example, to change the font color and background color of a DIV element, you could use the following code:

<DIV onclick="this.runtimeStyle.cssText = 'color:red;background-color:blue;border:5px solid black;'">
Click this DIV to change style properties.</DIV>

Internet Explorer 8 or later. The behavior of setAttribute method depends on the current document compatibility mode. For more information, see Attribute Differences in Internet Explorer 8

Example

This example sets a value on the runtimeStyle object to affect the currentStyle object, but not the style object.

<SCRIPT>
function fnChangeValue(sValue){
   if(oDIV.runtimeStyle.backgroundColor == oDIV.style.backgroundColor){
      sValue="";
   }
   oDIV.runtimeStyle.backgroundColor = sValue;
   alert(oDIV.style.backgroundColor +
      "\n" + oDIV.currentStyle.backgroundColor +
      "\n" + oDIV.runtimeStyle.backgroundColor);
}
</SCRIPT>

<DIV ID = "oDIV">
This is a demonstration DIV.
</DIV>

<INPUT TYPE = "button" VALUE = "Change Color" onclick="fnChangeValue('blue')">

Code example: http://samples.msdn.microsoft.com/workshop/samples/author/dhtml/refs/runtimeStyle.htm

Standards Information

There is no public standard that applies to this object.

Applies To

A, ABBR, ACRONYM, ADDRESS, APPLET, B, BIG, BLOCKQUOTE, BODY, BR, BUTTON, CAPTION, CENTER, CITE, CODE, COL, COLGROUP, CUSTOM, cssText, DD, DEL, DFN, DIR, DIV, DL, DT, EM, EMBED, FIELDSET, FONT, FORM, FRAME, FRAMESET, 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, MARQUEE, MENU, NOBR, OBJECT, OL, OPTION, P, PLAINTEXT, PRE, Q, S, SAMP, SELECT, SMALL, SPAN, STRIKE, STRONG, SUB, SUP, TABLE, TBODY, TD, TEXTAREA, TFOOT, TH, THEAD, TR, TT, U, UL, VAR, XMP, Element Constructor

See Also

currentStyle