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

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 0 places 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 value0
Applies toall elements
Inheritedno
Computed valuethe absolute <length>, snapped as a line width
Animation typea length

Formal syntax

outline-offset = 
<length> |
inset

Examples

Setting outline offset in pixels

HTML

html
<p>Gallia est omnis divisa in partes tres.</p>

CSS

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

Browser compatibility

See also