outline-offset - CSS: Cascading Style Sheets 编辑

The outline-offset CSS property sets the amount of space between an outline and the edge or border of an element.

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

Syntax

/* <length> values */
outline-offset: 3px;
outline-offset: 0.2em;

/* Global values */
outline-offset: inherit;
outline-offset: initial;
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.

Formal definition

Initial value	0
Applies to	all elements
Inherited	no
Computed value	as specified, but with relative lengths converted into absolute lengths
Animation type	a length

Formal syntax

<length>

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	Status	Comment
CSS Basic User Interface Module Level 3 The definition of 'outline-offset' in that specification.	Recommendation	Initial definition

Browser compatibility

BCD tables only load in the browser

See also

• outline
• outline-color
• outline-style
• outline-width