font Attribute | font Property

Sets or retrieves a combination of separate font properties of the object. Alternatively, sets or retrieves one or more of six user-preference fonts.

Syntax

CSS	{ font : sFont }
Scripting	[ sFont = ] object.style.font

Possible Values

sFont

String that specifies or receives up to six of the following space-delimited property values. Alternatively, sets or retrieves the six listed text fonts. font-style Any of the range of font-style values available to the fontStyle property. font-variant Any of the range of font-variant values available to the fontVariant property. font-weight Any of the range of font-weight values available to the fontWeight property. font-size Any of the range of font-size values available to the fontSize property. When this value is an integer followed by a percent (%), the value is a percentage of the parent object's font size. In Microsoft Internet Explorer 3.0, a percentage value is calculated as a percentage of the default font size. font-size err! missing description. line-height Any of the range of line-height values available to the lineHeight property. When used with the font property, this attribute must include a slash (/) before the value. Line height percentage values are calculated as a percentage of the font size of the element itself, not of the parent. font-family Any of the range of font-family values available to the fontFamily property. This property can be set to multiple comma-separated values. Its default value depends on user settings. caption User-preference font used in objects that have captions—buttons, labels, and so on. icon User-preference font used in icon labels. menu User-preference font used in menus. message-box User-preference font used in dialog boxes. small-caption User-preference font used in small controls. status-bar User-preference font used in window status bars.

The property is read/write. The property has a default value of normal normal normal medium medium normal "Times New Roman". The Cascading Style Sheets (CSS) attribute is inherited.

DHTML expressions can be used in place of the preceding value(s). As of Internet Explorer 8, expressions are supported in IE7 Standards mode and IE5 (Quirks) mode only. For more information, see About Dynamic Properties and Defining Document Compatibility.

Remarks

This is a composite property that specifies up to six font values. The font-style, font-variant, and font-weight values may appear in any order before font-size. However, the font-size, line-height, and font-family properties must appear in the order listed. Setting the font property also sets the component properties. In this case, the string must be a combination of valid values for the component properties; only font-family may have more than one value. If the string does not contain a value for a component property, that property is set to its default, regardless of prior settings for that component property.

When specifying the user preferences caption, icon, menu, message-box, small-caption, or status-bar for this property, do not set other values for the font property on the same element. If you do, the other values might render, but the user preference value is ignored.

As of Internet Explorer 6, when you use the !DOCTYPE declaration to specify standards-compliant mode, the following conditions apply to this property.

1. The font-size and font-family values must be declared. If font-size and font-family are not declared, or are not in the correct order, the font property is ignored.
2. All specified values must appear in the correct order. Otherwise, the font property is ignored.
3. In standards-compliant mode, the default font-size is small, not medium. If not explicitly set, font-size returns a point value.

For more information about standards-compliant parsing and the !DOCTYPE declaration, see CSS Enhancements in Internet Explorer 6.

Examples

The following examples use the font attribute and the font property to change font characteristics.

This example uses an inline style sheet to set the font attributes.

Copy

<SPAN STYLE="font:italic normal bolder 12pt Arial"> 
: 
</SPAN>

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

This example uses inline scripting to set the font properties.

Copy

<DIV onmouseover="this.style.font = 'italic small-caps bold 12pt serif'">
:
</DIV>

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

Standards Information

This property is defined in Cascading Style Sheets (CSS), Level 1 (CSS1).

Applies To

A, ADDRESS, B, BIG, BLOCKQUOTE, BODY, BUTTON, CAPTION, CENTER, CITE, CODE, COL, COLGROUP, CSSStyleDeclaration, currentStyle, CUSTOM, DD, defaults, DFN, DIR, DIV, DL, DT, EM, FIELDSET, FORM, hn, HTML, I, IMG, INPUT type=button, INPUT type=checkbox, INPUT type=file, INPUT type=image, INPUT type=password, INPUT type=radio, INPUT type=reset, INPUT type=submit, INPUT type=text, ISINDEX, KBD, LABEL, LEGEND, LI, LISTING, MARQUEE, MENU, NOBR, OL, P, PLAINTEXT, PRE, runtimeStyle, S, SAMP, SELECT, SMALL, SPAN, STRIKE, STRONG, style, SUB, SUP, TABLE, TBODY, TD, TEXTAREA, TFOOT, TH, THEAD, TR, TT, U, UL, VAR, XMP, CSSRuleStyleDeclaration Constructor, CSSStyleDeclaration Constructor

See Also

CSS Length Units