mozilla

font

Summary

The font CSS property is either a shorthand property for setting font-style, font-variant, font-weight, font-size, line-height and font-family, or a way to set the element's font to a system font, using specific keywords.

As with any shorthand CSS properties, the values which are not set in it are set to their individual initial values, eventually overriding values previously set using non-shorthand properties.

Note: There are a few caveats when using the CSS font shorthand. If these conditions are not met, the property is invalid and is entirely ignored.

  • Initial value the concatenation of the initial values of its longhand properties:
    • font-style: normal
    • font-variant: normal
    • font-weight: normal
    • font-stretch: normal
    • font-size: medium
    • line-height: normal
    • font-family: depends on user agent
  • Applies to all elements. It also applies to ::first-letter and ::first-line.
  • Inherited yes
  • Percentages The values of its longhand properties the percentage value belongs to:
    • font-size: refer to the parent element's font size
    • line-height: refer to the font size of the element itself
  • Media visual
  • Computed value as each of the properties of the shorthand:
    • font-style: as specified
    • font-variant: as specified
    • font-weight: the keyword or the numerical value as specified, with bolder and lighter transformed to the real value
    • font-stretch: as specified
    • font-size: as specified, but with relative lengths converted into absolute lengths
    • line-height: for percentage and length values, the absolute length, otherwise as specified
    • font-family: as specified
  • Animatable as each of the properties of the shorthand:
  • Canonical order order of appearance in the formal grammar of the values

Syntax

/* size | family */
font: 2em "Open Sans", sans-serif;

/* style | size | family */
font: italic 2em "Open Sans", sans-serif;

/* style | variant | weight | size/line-height | family */
font: italic small-caps bolder 16px/3 cursive;

/* The font used in system dialogs */
font: message-box;

/* Global values */
font: inherit;
font: initial;
font: unset;

Values

<'font-style'>
See the font-style CSS property.
<'font-variant'>
See the font-variant CSS property.
<'font-weight'>
See the font-weight CSS property.
<'font-size'>
See the font-size CSS property.
<'line-height'>
See the line-height CSS property.
<'font-family'>
See the font-family CSS property.
caption icon menu message-box small-caption status-bar
Instead of specifying individual longhand properties, a keyword can be used to represent a specific system font:
caption The font used for captioned controls (e.g., buttons, drop-downs, etc.).
icon The font used to label icons.
menu The font used in menus (e.g., dropdown menus and menu lists).
message-box The font used in dialog boxes.
small-caption The font used for labeling small controls.
status-bar The font used in window status bars.
Browsers implementing these often implement several more, prefixed, values; Gecko implements -moz-window, -moz-document, -moz-desktop, -moz-info, -moz-dialog, -moz-button, -moz-pull-down-menu, -moz-list and -moz-field.

Formal syntax

[ [ <'font-style'> || <font-variant-css21> || <'font-weight'> || <'font-stretch'> ]? <'font-size'> [ / <'line-height'> ]? <'font-family'> ] | caption | icon | menu | message-box | small-caption | status-bar

where
<font-variant-css21> = [ normal | small-caps ]

Examples

/* Set the font size to 12px and the line height to 14px. Set the font family to sans-serif */
p { font: 12px/14px sans-serif }
/* Set the font size to 80% of the parent element or default value (if no parent element present) 
and set the font family to sans-serif */ 
p { font: 80% sans-serif }
/* Set the font weight to bold, the font-style to italic, the font size to large, 
and the font family to serif. */
p { font: bold italic large serif }
/* Use the same font as the status bar of the window */
p { font: status-bar }

Live Sample

Specifications

Specification Status Comment
CSS Fonts Module Level 3
The definition of 'font' in that specification.
Candidate Recommendation No change
CSS Level 2 (Revision 1)
The definition of 'font-weight' in that specification.
Recommendation Added support for keywords
CSS Level 1
The definition of 'font' in that specification.
Recommendation Initial definition

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
Shorthand 1.0 1.0 (1.0) 3.0 3.5 1.0 (85)
System fonts 1.0 1.0 (1.0) 4.0 6.0 1.0 (85)
Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support ? ? ? ? ?

See also