HTMLStyleObject : Object
Return to: HTML DOM Level 2 index

Reference to the inline CSS style for the element. This is an internal convenience object to allow access to the CSS style properties, and cannot be instantiated directly. It will disappear in future revisions.

Constructors

Constructor Action IE Mozilla Netscape Opera Safari
HTMLStyleObject Constructor() : HTMLStyleObject
Reference to the inline CSS style for the element.
 Show Details

HTMLStyleObject() : HTMLStyleObject

Reference to the inline CSS style for the element.

Returns
HTMLStyleObject

Visibility
internal

Properties

Property Action IE Mozilla Netscape Opera Safari
accelerator : String
Specifies whether or not the element has an accelerator key, which is a shortcut for selecting the element.
 Show Details 5.5+ no no no no
Remarks
IE only.
azimuth : String
Specifies the speaker balance for audio content.
 Show Details no no no no no
Remarks
To specify an angle, use syntax similar to "90deg".
Availability

W3C
background : String
Defines the background properties for an element.
 Show Details 4.0+ 1.0+ 4.0+ 4.0+ 1.0+
To specify a background image in an "images" directory named myCat.jpg that repeats vertically, use the following syntax: body {background: url(images/myCat.jpg), repeat-y}.
Remarks
Use the background property as a shortcut to typing out all of the individual background properties separately. You can specify any valid value for a background- property as part of background.
Availability

W3C
backgroundAttachment : String
Specifies whether or not the background image is fixed or scrollable as a user scrolls the document.
 Show Details 4.0+ 1.0+ 6.0+ 4.0+ 1.0+
Availability

W3C
backgroundColor : String
Specifies the background color for the element. Specify either a color name or RGB color code.
 Show Details 4.0+ 1.0+ 4.0+ 4.0+ 1.0+
Availability

W3C
backgroundImage : String
Specifies the URL for a background image for an element.
 Show Details 4.0+ 1.0+ 4.0+ 4.0+ 1.0+
To specify a background image in an "images" directory named myCat.jpg, use the following syntax: body {background-image: url(images/myCat.jpg)}.
Availability

W3C
backgroundPosition : String
Specifies the position of a background image for an element.
 Show Details 4.0+ 1.0+ 6.0+ 4.0+ 1.0+
Remarks
If you do not specify one or more of the values top, center, bottom, left, or right, you also specify absolute pixel values or percentage values.
Availability

W3C
backgroundPositionX : String
Specifies the x-position of a background image for an element.
 Show Details 5.0+ no no no no
Remarks
IE only.
backgroundPositionY : String
Specifies the y-position of a background image for an element.
 Show Details 5.0+ no no no no
Remarks
IE only.
backgroundRepeat : String
Specifies how a background image repeats for an element.
 Show Details 4.0+ 1.0+ 4.0+ 4.0+ 1.0+
Availability

W3C
border : String
Defines the border properties for an element.
 Show Details 4.0+ 1.0+ 4.0+ 5.0+ 1.0+
To specify a thick, red, dashed border, use the following syntax: .myborderclass {border: thick red dashed;}.
Remarks
Use the border property as a shortcut to typing out all of the individual border properties separately. You can specify any valid value for a border- property as part of border.
Availability

W3C
borderBottom : String
Defines the properties for the bottom border for the element.
 Show Details 4.0+ 1.0+ 6.0+ 4.0+ 1.0+
To specify a thick, red, dashed bottom border, use the following syntax: .myborderbottomclass {border-bottom: thick red dashed;}.
Remarks
Use the border-bottom property as a shortcut to typing out all of the individual border-bottom properties separately. You can specify any valid value for a border-bottom- property as part of border-bottom.
Availability

W3C
borderBottomColor : String
Specifies the color for a bottom border. Specify either a color name or RGB color code.
 Show Details 4.0+ 1.0+ 6.0+ 7.0+ 1.0+
Availability

W3C
borderBottomStyle : String
Specifies a style for a bottom border.
 Show Details 4.0+ 1.0+ 6.0+ 7.0+ 1.0+
Availability

W3C
borderBottomWidth : String
Specifies the width of the bottom border.
 Show Details 4.0+ 1.0+ 4.0+ 5.0+ 1.0+
Remarks
You can also specify a fixed pixel value for border-bottom-width.
Availability

W3C
borderCollapse : String
Specifies whether the borders for an element are collapsed or separated.
 Show Details 5.0+ 1.0+ 6.0+ 5.0+ 1.2+
Availability

W3C
borderColor : String
Specifies the color for the borders for an element. Specify either a color name or RGB color code.
 Show Details 4.0+ 1.0+ 4.0+ 4.0+ 1.0+
Availability

W3C
borderLeft : String
Defines the properties for the left border for the element.
 Show Details 4.0+ 1.0+ 6.0+ 4.0+ 1.0+
To specify a thick, red, dashed left border, use the following syntax: .myborderleftclass {border-left: thick red dashed;}.
Remarks
Use the border-left property as a shortcut to typing out all of the individual border-left properties separately. You can specify any valid value for a border-left- property as part of border-left.
Availability

W3C
borderLeftColor : String
Specifies the color for a left border. Specify either a color name or RGB color code.
 Show Details 4.0+ 1.0+ 6.0+ 7.0+ 1.0+
Availability

W3C
borderLeftStyle : String
Specifies a style for a left border.
 Show Details 4.0+ 1.0+ 6.0+ 7.0+ 1.0+
Availability

W3C
borderLeftWidth : String
Specifies the width of the left border.
 Show Details 4.0+ 1.0+ 4.0+ 5.0+ 1.0+
Remarks
You can also specify a fixed pixel value for border-left-width.
Availability

W3C
borderRight : String
Defines the properties for the right border for the element.
 Show Details 4.0+ 1.0+ 6.0+ 4.0+ 1.0+
To specify a thick, red, dashed right border, use the following syntax: .myborderrightclass {border-right: thick red dashed;}.
Remarks
Use the border-right property as a shortcut to typing out all of the individual border-right properties separately. You can specify any valid value for a border-right- property as part of border-right.
Availability

W3C
borderRightColor : String
Specifies the color for a right border. Specify either a color name or RGB color code.
 Show Details 4.0+ 1.0+ 6.0+ 7.0+ 1.0+
Availability

W3C
borderRightStyle : String
Specifies a style for a right border.
 Show Details 4.0+ 1.0+ 6.0+ 7.0+ 1.0+
Availability

W3C
borderRightWidth : String
Specifies the width of the right border.
 Show Details 4.0+ 1.0+ 4.0+ 5.0+ 1.0+
Remarks
You can also specify a fixed pixel value for border-right-width.
Availability

W3C
borderSpacing : String
Specifies the number of pixels between the border and its contents.
 Show Details no 1.0+ 6.0+ 5.0+ 1.2+
To specify 6px of space on the sides and 12px of spacing above and below and element, use the following syntax: .myborderclass {border-spacing: 6px 12px;}.
Remarks
To specify different values for horizontal and vertical spacing, specify two values with the horizontal value first.
Availability

W3C
borderStyle : String
Specifies a style for a border.
 Show Details 4.0+ 1.0+ 4.0+ 5.0+ 1.0+
To specify a border style that is solid on top, ridged on the right and bottom, and solid on the left, use the following syntax: .myborderclass {border-style: solid ridged ridged solid;}.
Remarks

Use the border-style property as a shortcut to typing out all of the individual border-style properties separately. You can specify any valid value for a border-style- property as part of border-style.

You can specify up to four different border styles for the border of an element.

  • For border that is the same on all four sides, specify a single value.
  • For border that is different on the top/bottom and left/right sides, specify two values with the top/bottom value first.
  • For border that is different on the top, left/right, and bottom sides, specify three values with the top value first, followed by the left/right and then bottom values.
  • For border with four different styles, specify four values in the order of top, right, bottom, and left.
Availability

W3C
borderTop : String
Defines the properties for the top border for the element.
 Show Details 4.0+ 1.0+ 6.0+ 4.0+ 1.0+
To specify a thick, red, dashed top border, use the following syntax: .mybordertopclass {border-top: thick red dashed;}.
Remarks
Use the border-top property as a shortcut to typing out all of the individual border-top properties separately. You can specify any valid value for a border-top- property as part of border-top.
Availability

W3C
borderTopColor : String
Specifies the color for a top border. Specify either a color name or RGB color code.
 Show Details 4.0+ 1.0+ 6.0+ 7.0+ 1.0+
Availability

W3C
borderTopStyle : String
Specifies a style for a top border.
 Show Details 4.0+ 1.0+ 6.0+ 7.0+ 1.0+
Availability

W3C
borderTopWidth : String
Specifies the width of the top border.
 Show Details 4.0+ 1.0+ 4.0+ 5.0+ 1.0+
Remarks
You can also specify a fixed pixel value for border-top-width.
Availability

W3C
borderWidth : String
Specifies the width of the border.
 Show Details 4.0+ 1.0+ 4.0+ 5.0+ 1.0+
To specify a border width that is 2px on top, 1px on the right and bottom, and 2px on the left, use the following syntax: .myborderclass {border-width: 2px 1px 1px 2px;}.
Remarks

You can also specify a fixed pixel value for border-width.

You can specify up to four different widths for the border of an element.

  • For border that is the same on all four sides, specify a single value.
  • For border that is different on the top/bottom and left/right sides, specify two values with the top/bottom value first.
  • For border that is different on the top, left/right, and bottom sides, specify three values with the top value first, followed by the left/right and then bottom values.
  • For border with four different styles, specify four values in the order of top, right, bottom, and left.
Availability

W3C
bottom : String
Specifies the y-coordinate for the position of the element relative to the bottom edge of the parent element or browser window.
 Show Details 5.0+ 1.0+ 6.0+ 5.0+ 1.0+
Remarks
You can also specify a fixed pixel or percentage value for bottom.
Availability

W3C
captionSide : String
Specifies the position of a caption for the element.
 Show Details no 1.0+ 6.0+ 6.0+ 1.0+
Availability

W3C
clear : String
Specifies the position of the element relative to a floating object on the page.
 Show Details 4.0+ 1.0+ 4.0+ 5.0+ 1.0+
Availability

W3C
clip : String
Specifies the x- and y-coordinates (in pixels) for the clipping rectangle around the element.
 Show Details 4.0+ 1.0+ 6.0+ 5.0+ 1.0+
Availability

W3C
color : String
Specifies the color of the text for the element. Specify either a color name or RGB color code.
 Show Details 3.0+ 1.0+ 4.0+ 4.0+ 1.0+
Availability

W3C
content : String
Specifies the content to insert before or after the element.
 Show Details no 1.0+ 6.0+ 7.0+ 1.0+
To specify that a paragraph should have an image from an "images" directory called "bluestar.gif" before it use the following syntax: p:before {content: url(images/bluestar.gif);}.
Remarks
Use content to specify either a quote style or an image to use (similar to a bullet) before or after an element.
Availability

W3C
counterIncrement : String
Specifies a name of a counter and how much to increment the counter by.
 Show Details no no no 7.0+ no
To specify a level-1 section heading with an incremented Roman numeral before each heading, use the following syntax: H1:before {counter(section, upper-roman); counter-increment: section;}.
Remarks
Use the counter-increment property for styles such as numbered headings.
Availability

W3C
counterReset : String
Resets a counter to the specified value.
 Show Details no no no 7.0+ no
To specify a level-1 section heading with an incremented Roman numeral before each heading and that sets a counter called "section" to "1" each time it occurs, use the following syntax: H1:before {counter(chapter, upper-roman); counter-increment: section; counter-reset section 1;}.
Availability

W3C
cue : String
Defines the properties for an aural cue before or after an element.
 Show Details no no no no no
To specify a sound file named "bell.wav" before an H1 element and a sound file named "horns.wav", use the following syntax: H1 {cue: url("bell.wav") url("horns.wav");}.
Remarks
Use the cue property as a shortcut to typing out both the cue-before and cue-after properties separately.
Availability

W3C
cueBefore : String
Defines the properties for an aural cue before an element.
 Show Details no no no no no
To specify a sound file named "bell.wav" before an H1 element, use the following syntax: H1 {cue-before: url("bell.wav");}.
Availability

W3C
cueAfter : String
Defines the properties for an aural cue after an element.
 Show Details no no no no no
To specify a sound file named "horns.wav" after an H1 element, use the following syntax: H1 {cue: url("horns.wav");}.
Availability

W3C
cursor : String
Specifies which cursor to display when a user mouses over the element.
 Show Details 5.0+ 1.0+ 6.0+ 7.0+ 1.2+
Availability

W3C
direction : String
Specifies the text direction for the element.
 Show Details 5.0+ 1.0+ 6.0+ no 1.0+
Availability

W3C
display : String
Specifies how to display the element.
 Show Details 4.0+ 1.0+ 4.0+ 5.0+ 1.0+
Availability

W3C
elevation : String
Specifies the elevation of the element. You can either one of the relative elevations or specify an angle in degrees.
 Show Details no no no no no
Remarks
To specify an angle, use syntax similar to "90deg".
Availability

W3C
emptyCells : String
Specifies whether to show or hide borders for empty table cells.
 Show Details no 1.0+ 6.0+ 5.0+ 1.2+
Availability

W3C
filter : String
Specifies a filter for the element to render and any parameters that the filter takes. You can specify multiple filters.
 Show Details 4.0+ no no no no
Remarks
IE only.
float : String
Specifies if an element should float towards the left or right margin of its parent element or web browser.
 Show Details 4.0+ 1.0+ 4.0+ 6.0+ 1.0+
Availability

W3C
font : String
Defines the properties for the font for the element.
 Show Details 3.0+ 1.0+ 4.0+ 6.0+ 1.0+
To specify an italic, 12px, sans-serif font for a paragraph, use the following syntax: p { font: italic 12px sans-serif; }.
Remarks
Use the font property as a shortcut to typing out all of the individual font properties separately. You can specify any valid value for a font property as part of font.
Availability

W3C
fontFamily : String
Specifies the font face for the element.
 Show Details 4.0+ 1.0+ 4.0+ 4.0+ 1.0+
Availability

W3C
fontSize : String
Specifies either the explicit or relative size of the font compared to the base font size.
 Show Details 4.0+ 1.0+ 4.0+ 4.0+ 1.0+
Remarks
You can explicitly specify a font size for font-size in either pixels or a percentage.
Availability

W3C
fontSizeAdjust : String
Specifies the adjustment to make in font size if an explicitly specified font is unavailable.
 Show Details no no no no no
Availability

W3C
fontStretch : String
Specifies how a font should be condensed or stretched.
 Show Details no no no no no
Availability

W3C
fontStyle : String
Specifies a style for a font (e.g. italic).
 Show Details 4.0+ 1.0+ 4.0+ 4.0+ 1.0+
Availability

W3C
fontVariant : String
Specifies a variation for a font (e.g. small-caps).
 Show Details 4.0+ 1.0+ 4.0+ 4.0+ 1.0+
Availability

W3C
fontWeight : String
Specifies the weight of a font (e.g. bold).
 Show Details 4.0+ 1.0+ 4.0+ 4.0+ 1.0+
Availability

W3C
height : String
Specifies the height (in pixels, points, or as a percentage) of the content of the element.
 Show Details 4.0+ 1.0+ 4.0+ 4.0+ 1.0+
Remarks
height does not include the margins, padding, or borders of an element.
Availability

W3C
imeMode : String
Specifies the state of the Input Method Editor (IME) for the element, which allows users to enter and edit Chinese, Japanese, and Korean characters.
Show Details 5.5+ no no no no
Remarks
IE only.
layoutFlow : String
Specifies the flow direction for the content of the element.
 Show Details 5.5+ no no no no
Remarks
IE only.
layoutGrid : String
Defines the set of layout-grid properties for an element.
 Show Details 5.5+ no no no no
Remarks
IE only.
layoutGridChar : String
Specifies the size of a character grid for the content of an element.
 Show Details 5.5+ no no no no
Remarks
IE only.
layoutGridLine : String
Specifies the grid line value for the text content of an element.
 Show Details 5.5+ no no no no
Remarks
IE only.
layoutGridMode : String
Specifies if the element text layout grid uses the line and/or char mode.
 Show Details 5.5+ no no no no
Remarks
IE only.
layoutGridType : String
Specifies the type of layout grid for the content of an element.
 Show Details 5.5+ no no no no
Remarks
IE only.
left : String
Specifies the x-coordinate for the position of the element relative to the left edge of the parent element or browser window.
 Show Details 4.0+ 1.0+ 4.0+ 5.0+ 1.0+
Remarks
You can also specify a fixed pixel or percentage value for left.
Availability

W3C
letterSpacing : String
Specifies the amount of space (in points or pixels) between letters in the text of the element.
 Show Details 4.0+ 1.0+ 6.0+ 4.0+ 1.0+
Availability

W3C
lineBreak : String
Specifies line-breaking rules for Japanese text.
 Show Details 5.5+ no no no no
Remarks
IE only.
lineHeight : String
Specifies line height of text in multiline elements, such as paragraphs.
 Show Details 3.0+ 1.0+ 4.0+ 4.0+ 1.0+
Remarks
You can also specify a fixed pixel or percentage value for line-height.
Availability

W3C
listStyle : String
Defines the properties for the list style for a list element.
 Show Details 4.0+ 1.0+ 6.0+ 4.0+ 1.0+
To specify an unordered list with a square bullet outside of the list, use the following syntax: ul { list-style: square outside;}.
Remarks
Use the list-style property as a shortcut to typing out all of the individual list-style properties separately. You can specify any valid value for a list-style property as part of list-style.
Availability

W3C
listStyleImage : String
Specifies the URL to an image to use for list items.
 Show Details 4.0+ 1.0+ 6.0+ 4.0+ 1.0+
To specify an unordered list that uses an image called "bluestar.gif" for a bullet, use the following syntax: ul { url(bluestar.gif)}.
Availability

W3C
listStylePosition : String
Specifies the position of the bullet or number for a list.
 Show Details 4.0+ 1.0+ 6.0+ 4.0+ 1.0+
Availability

W3C
listStyleType : String
Specifies the position of the bullet or number for a list.
 Show Details 4.0+ 1.0+ 4.0+ 4.0+ 1.0+
Availability

W3C
margin : String
Defines the widths (in pixels, points, or a percentage) for the margins for the element.
 Show Details 4.0+ 1.0+ 4.0+ 4.0+ 1.0+
To specify a margin that is 10px wide on the top and left and 5px wide on the bottom and right, use the following syntax: body {margin: 10px 5px 5px 10px;}.
Remarks

Use the margin property as a shortcut to typing out all of the individual margin properties separately. You can specify any valid value for a margin property as part of margin.

You can specify up to four different widths for the margin of an element.

  • For a margin that is the same on all four sides, specify a single value.
  • For a margin that is different on the top/bottom and left/right sides, specify two values with the top/bottom value first.
  • For a margin that is different on the top, left/right, and bottom sides, specify three values with the top value first, followed by the left/right and then bottom values.
  • For a margin with four different widths, specify four values in the order of top, right, bottom, and left.
Availability

W3C
marginBottom : String
Specifies the width (in pixels, points, or a percentage) for the bottom margin of an element.
 Show Details 4.0+ 1.0+ 4.0+ 4.0+ 1.0+
Availability

W3C
marginLeft : String
Specifies the width (in pixels, points, or a percentage) for the left margin of an element.
 Show Details 4.0+ 1.0+ 4.0+ 4.0+ 1.0+
Availability

W3C
marginRight : String
Specifies the width (in pixels, points, or a percentage) for the right margin of an element.
 Show Details 4.0+ 1.0+ 4.0+ 4.0+ 1.0+
Availability

W3C
marginTop : String
Specifies the width (in pixels, points, or a percentage) for the top margin of an element.
 Show Details 4.0+ 1.0+ 4.0+ 4.0+ 1.0+
Availability

W3C
markerOffset : String
Specifies the width (in pixels or points) between the marker box of an element and the surrounding box of its parent element.
 Show Details no no no no no
Availability

W3C
marks : String
Specifies if cross or crop marks should appear outside of the element on a printed page.
 Show Details no no no no no
Availability

W3C
maxHeight : String
Specifies the maximum height that an element may be.
 Show Details no 1.0+ 6.0+ 7.0+ 1.3+
Remarks
This property is useful for elements that are relatively sized compared to a browser window or parent element.
Availability

W3C
maxWidth : String
Specifies the maximum width that an element may be.
 Show Details no 1.0+ 6.0+ 7.0+ 1.0+
Remarks
This property is useful for elements that are relatively sized compared to a browser window or parent element.
Availability

W3C
minHeight : String
Specifies the minimum height that an element may be.
 Show Details no 1.0+ 6.0+ 7.0+ 1.3+
Remarks
This property is useful for elements that are relatively sized compared to a browser window or parent element.
Availability

W3C
minWidth : String
Specifies the minimum width that an element may be.
 Show Details no 1.0+ 6.0+ 7.0+ 1.0+
Remarks
This property is useful for elements that are relatively sized compared to a browser window or parent element.
Availability

W3C
mozBinding : String
Specifies the URL of an XBL file to bind to the element.
 Show Details no no 6.0+ no no
Remarks
Proprietary Mozilla property.
mozBorderRadius : String
Specifies the radius of the border around the element.
 Show Details no 1.0+