outline
Baseline 2023
Newly available
Since March 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.
The outline
CSS shorthand property sets most of the outline properties in a single declaration.
Try it
Constituent properties
This property is a shorthand for the following CSS properties:
Syntax
/* style */
outline: solid;
/* style | color */
outline: dashed #f66;
/* width | style */
outline: thick inset;
/* width | style | color*/
outline: 3px solid green;
/* Global values */
outline: inherit;
outline: initial;
outline: revert;
outline: revert-layer;
outline: unset;
The outline
property may be specified using one, two, or three of the values listed below. The order of the values does not matter. As with all shorthand properties, any omitted sub-values will be set to their initial value.
Note:
The outline will be invisible for many elements if its style is not defined. This is because the style defaults to none
. A notable exception is input
elements, which are given default styling by browsers.
Values
<'outline-width'>
-
Sets the thickness of the outline. Defaults to
medium
if absent. Seeoutline-width
. <'outline-style'>
-
Sets the style of the outline. Defaults to
none
if absent. Seeoutline-style
. <'outline-color'>
-
Sets the color of the outline. Defaults to
invert
for browsers supporting it,currentcolor
for the others. Seeoutline-color
.
Description
Outline is a line outside of the element's border. Unlike other areas of the box, outlines don't take up space, so they don't affect the layout of the document in any way.
There are a few properties that affect an outline's appearance. It is possible to change the style, color, and width using the outline
property, the distance from the border using the outline-offset
property, and corner angles using the border-radius
property.
An outline is not required to be rectangular: While dealing with multiline text, some browsers will draw an outline for each line box separately, while others will wrap the whole text with a single outline.
Accessibility
Assigning outline
a value of 0
or none
will remove the browser's default focus style. If an element can be interacted with it must have a visible focus indicator. Provide obvious focus styling if the default focus style is removed.
Formal definition
Initial value | as each of the properties of the shorthand:
|
---|---|
Applies to | all elements |
Inherited | no |
Computed value | as each of the properties of the shorthand:
|
Animation type | as each of the properties of the shorthand:
|
Formal syntax
outline =
<'outline-width'> ||
<'outline-style'> ||
<'outline-color'>
<outline-width> =
<line-width>
<outline-style> =
auto |
<outline-line-style>
<outline-color> =
auto |
<color> |
<image-1D>
<line-width> =
<length [0,∞]> |
thin |
medium |
thick
<image-1D> =
<stripes()>
<stripes()> =
stripes( <color-stripe># )
<color-stripe> =
<color> &&
[ <length-percentage> | <flex> ]?
<length-percentage> =
<length> |
<percentage>
Examples
Using outline to set a focus style
HTML
<a href="#">This link has a special focus style.</a>
CSS
a {
border: 1px solid;
border-radius: 3px;
display: inline-block;
margin: 10px;
padding: 5px;
}
a:focus {
outline: 4px dotted #e73;
outline-offset: 4px;
background: #ffa;
}
Result
Specifications
Specification |
---|
CSS Basic User Interface Module Level 4 # outline |
Browser compatibility
BCD tables only load in the browser