outline-offset CSS property
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2017.
The outline-offset CSS property sets the amount of space between an outline and the edge or border of an element.
Try it
outline-offset: 4px;
outline-offset: 0.6rem;
outline-offset: 12px;
outline: 5px dashed blue;
<section class="default-example" id="default-example">
<div class="transition-all" id="example-element">
This is a box with an outline around it.
</div>
</section>
#example-element {
border: 2px solid crimson;
outline: 0.75em solid;
padding: 0.75em;
width: 80%;
height: 100px;
}
Syntax
/* <length> values */
outline-offset: 3px;
outline-offset: 0.2em;
/* Global values */
outline-offset: inherit;
outline-offset: initial;
outline-offset: revert;
outline-offset: revert-layer;
outline-offset: unset;
Values
<length>-
The width of the space between the element and its outline. A negative value places the outline inside the element. A value of
0places the outline so that there is no space between it and the element.
Description
An outline is a line that is drawn around an element, outside the border edge. The space between an element and its outline is transparent. In other words, it is the same as the parent element's background.
Accessibility
When an outline is used as a focus indicator, the 3:1 contrast ratio defined in Success Criterion 1.4.11 Non-text Contrast requires the outline-color be measured against the color of the background. The outline-offset creates a transparent space between the element's edge and its outline. The offset outline is drawn either over whatever is behind the element or, with a negative offset, over the element's own background, which may change the color the ratio is measured against.
When you use an outline as a focus indicator, test your focused outline inside a container that clips its overflow and inside a scroll container. A positive offset can move the outline outside such an ancestor, where part of the indicator is cut off. Success Criterion 2.4.11 Focus Not Obscured (Minimum) requires that the focused component not be entirely hidden, and Success Criterion 2.4.13 Focus Appearance sets a minimum area for the indicator itself.
Formal definition
| Initial value | 0 |
|---|---|
| Applies to | all elements |
| Inherited | no |
| Computed value | the absolute <length>, snapped as a line width |
| Animation type | a length |
Formal syntax
outline-offset =
<length> |
inset
Examples
>Setting outline offset in pixels
HTML
<p>Gallia est omnis divisa in partes tres.</p>
CSS
p {
outline: 1px dashed red;
outline-offset: 10px;
background: yellow;
border: 1px solid blue;
margin: 15px;
}
Result
Specifications
| Specification |
|---|
| CSS Basic User Interface Module Level 4> # outline-offset> |