Compartilhar via


runtimeStyle Object

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.

Attribute Property Description
background-size New for Internet Explorer 9  backgroundSize Gets or sets the size of the background images.
onOffBehavior Gets an object that indicates whether the specified Microsoft DirectAnimation behavior is running.
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.
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.
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 New for Internet Explorer 9  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 New for Internet Explorer 9  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.
-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 New for Internet Explorer 9  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 New for Internet Explorer 9  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 New for Internet Explorer 9  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 New for Internet Explorer 9  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 New for Internet Explorer 9  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 New for Internet Explorer 9  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 New for Internet Explorer 9  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 New for Internet Explorer 9  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 Gets or sets the interpolation (resampling) method used to stretch images.
opacity New for Internet Explorer 9  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 page.
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: https://samples.msdn.microsoft.com/workshop/samples/author/dhtml/refs/runtimeStyle.htm

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