Shorthand properties
Definition
Shorthand properties are CSS properties that let you set the values of several other CSS properties simultaneously. Using a shorthand property, a Web developer can write more concise and often more readable style sheets, saving time and energy.
The CSS specification defines shorthand properties to group the definition of common properties acting on the same theme. E. g. the CSS background
property is a shorthand property that's able to define the value of background-color
, background-image
, background-repeat
, and background-position
. Similarly, the most common font-related properties can be defined using the shorthand font
, and the different margins around a box can be defined using the margin
shorthand.
Tricky edge cases
Even if they are very convenient to use, there are a few edge cases to keep in mind when using them:
- A value which is not specified is set to its initial value. That sounds anecdotal, but it really means that it overrides previously set values. Therefore:
CSSCopy Code
background-color: red; background: url(images/bg.gif) no-repeat top right;
will not set the color of the background tored
but tobackground-color
's default,transparent
, as the second rule has precedence. - Only the individual properties values can inherit. As missing values are replaced by their initial value, it is impossible to allow inheritance of individual properties by omitting them. The keyword
inherit
can be applied to a property, but only as a whole, not as a keyword for one value or another. That means that the only way to make some specific value to be inherited is to use the longhand property with the keywordinherit.
- Shorthand properties try not to force a specific order for the values of the properties they replace. This works well when these properties use values of different types, as the order has no importance, but this does not work as easily when several properties can have identical values. Handling of these cases are grouped in several categories:
- Shorthands handling properties related to edges of a box, like
border-style
,margin
orpadding
, always use a consistent 1-to-4-value syntax representing those edges:The 1-value syntax: border-width: 1em
— The unique value represents all edgesThe 2-value syntax: border-width: 1em 2em
— The first value represents the vertical, that is top and bottom, edges, the second the horizontal ones, that is the left and right ones.The 3-value syntax: border-width: 1em 2em 3em
— The first value represents the top edge, the second, the horizontal, that is left and right, ones, and the third value the bottom edgeThe 4-value syntax:
border-width: 1em 2em 3em 4em
— The four values represent the top, right, bottom and left edges respectively, always in that order, that is clock-wise starting at the top (The initial letter of Top-Right-Bottom-Left matches the order of the consonant of the word trouble: TRBL) - Similarly, shorthands handling properties related to corners of a box, like
border-radius
, always use a consistent 1-to-4-value syntax representing those corners:The 1-value syntax: border-radius: 1em
— The unique value represents all cornersThe 2-value syntax: border-radius: 1em 2em
— The first value represents the top left and bottom right corner, the second the top right and bottom left ones.The 3-value syntax: border-radius: 1em 2em 3em
— The first value represents the top left corner, the second the top right and bottom left ones, and the third value the bottom right cornerThe 4-value syntax:
border-radius: 1em 2em 3em 4em
— The four values represent the top left, top right, bottom right and bottom left corners respectively, always in that order, that is clock-wise starting at the top left.
- Shorthands handling properties related to edges of a box, like
Background properties
A background with the following properties:
background-color: #000; background-image: url(images/bg.gif); background-repeat: no-repeat; background-position: top right;
Can be shortened to just one declaration:
background: #000 url(images/bg.gif) no-repeat top right;
(The shorthand form is actually the equivalent of the longhand properties above plus background-attachment: scroll
and, in CSS3, some additional properties.)
Font properties
The following declarations:
font-style: italic; font-weight: bold; font-size: .8em; line-height: 1.2; font-family: Arial, sans-serif;
can be shortened to the following:
font: italic bold .8em/1.2 Arial, sans-serif;
This shorthand declaration is actually equivalent to the longhand declarations above plus font-variant: normal
and font-size-adjust: none
(CSS2.0 / CSS3), font-stretch: normal
(CSS3).
Border properties
With borders, the width, color, and style can be simplified into one declaration. For example,
border-width: 1px; border-style: solid; border-color: #000;
Can be written as
border: 1px solid #000;
Margin and Padding properties
Shorthand versions of margin and padding values work the same way. The following CSS declarations:
margin-top: 10px; margin-right: 5px; margin-bottom: 10px; margin-left: 5px;
are the same as the following declaration (note that the values are in clockwise order from top: top, right, bottom, then left (TRBL, the consonants in "trouble"))
margin: 10px 5px 10px 5px;
See also
- CSS Reference
- CSS Key Concepts: CSS syntax, at-rule, comments, specificity and inheritance, the box, layout modes and visual formatting models, and margin collapsing, or the initial, computed, resolved, specified, used, and actual values. Definitions of value syntax, shorthand properties and replaced elements.
- Shorthand properties:
background
,font
,margin
,border
,border-top
,border-right
,border-bottom
,border-left
,border-width
,border-color
,border-style
,transition
,animation
,transform
,padding
,list-style
,border-radius
.
License
© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/css/shorthand_properties