`outline-offset` CSS property
The outline-offset CSS property sets the amount of space between an outline and the edge or border of an element.
The outline-offset CSS property sets the amount of space between an outline and the edge or border of an element.
CSS Demo: outline-offset
```css interactive-example-choice outline-offset: 4px;
```css interactive-example-choice
outline-offset: 0.6rem;
```css interactive-example-choice outline-offset: 12px; outline: 5px dashed blue;
```html interactive-example
<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>
```css interactive-example
example-element {
border: 2px solid crimson; outline: 0.75em solid; padding: 0.75em; width: 80%; height: 100px; }
## Syntax
```css
/* <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
Formal syntax
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
Setting_outline_offset_in_pixels
Specifications
Browser compatibility
See also
- outline
- outline-width
- outline-style
- outline-color