inset

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.

Die inset-Eigenschaft in CSS ist eine Kurzform, die den Eigenschaften top, right, bottom und/oder left entspricht. Sie hat die gleiche Mehrwert-Syntax wie die Kurzform von margin.

Diese inset-Eigenschaften, einschließlich inset, haben keine Wirkung auf nicht positionierte Elemente.

Probieren Sie es aus

Obwohl sie Teil des Moduls für CSS-logische Eigenschaften und Werte ist, definiert sie keine logischen Versätze. Sie definiert physische Versätze, unabhängig von der Schreibrichtung, Richtung und Textorientierung des Elements.

Bestandteil-Eigenschaften

Diese Eigenschaft ist eine Kurzform für die folgenden CSS-Eigenschaften:

Syntax

css
/* <length> values */
inset: 10px; /* value applied to all edges */
inset: 4px 8px; /* top/bottom left/right */
inset: 5px 15px 10px; /* top left/right bottom */
inset: 2.4em 3em 3em 3em; /* top right bottom left */
inset: calc(anchor(50%) + 10px) anchor(self-start) auto auto;
inset: anchor-size(block) calc(anchor(50%) + 10px) auto
  calc(anchor-size(width) / 4);

/* <percentage>s of the width (left/right) or height (top/bottom) of the containing block */
inset: 10% 5% 5% 5%;

/* Keyword value */
inset: auto;

/* Global values */
inset: inherit;
inset: initial;
inset: revert;
inset: revert-layer;
inset: unset;

Werte

Die inset-Eigenschaft nimmt die gleichen Werte wie die left-Eigenschaft an.

Formale Definition

Anfangswertwie die jeweiligen Kurzschreibweisen:
Anwendbar aufpositionierte Elemente
VererbtNein
Prozentwerterelative to the containing block's size in the corresponding axis (e.g. width for left or right, height for top or bottom)
Berechneter Wertwie die jeweiligen Kurzschreibweisen:
  • top: falls als Länge angegeben, die zugehörige absolute Länge; falls als Prozentwert angegeben, der angegebene Wert; ansonsten auto
  • bottom: falls als Länge angegeben, die zugehörige absolute Länge; falls als Prozentwert angegeben, der angegebene Wert; ansonsten auto
  • left: falls als Länge angegeben, die zugehörige absolute Länge; falls als Prozentwert angegeben, der angegebene Wert; ansonsten auto
  • right: falls als Länge angegeben, die zugehörige absolute Länge; falls als Prozentwert angegeben, der angegebene Wert; ansonsten auto
AnimationstypLängenangabe, Prozentsatz oder calc();

Formale Syntax

inset = 
  <'top'>{1,4}  

<top> = 
  auto                 |
  <length-percentage>  |
  <anchor()>           |
  <anchor-size()>      

<length-percentage> = 
  <length>      |
  <percentage>  

<anchor()> = 
  anchor( <anchor-name>?                  &&
  <anchor-side> , <length-percentage>? )  

<anchor-size()> = 
  anchor-size( [ <anchor-name> || <anchor-size> ]? , <length-percentage>? )  

<anchor-name> = 
  <dashed-ident>  

<anchor-side> = 
  inside        |
  outside       |
  top           |
  left          |
  right         |
  bottom        |
  start         |
  end           |
  self-start    |
  self-end      |
  <percentage>  |
  center        

<anchor-size> = 
  width        |
  height       |
  block        |
  inline       |
  self-block   |
  self-inline

Beispiele

Versätze für ein Element festlegen

HTML

html
<div>
  <span class="exampleText">Example text</span>
</div>

CSS

css
div {
  background-color: yellow;
  width: 150px;
  height: 120px;
  position: relative;
}

.exampleText {
  writing-mode: sideways-rl;
  position: absolute;
  inset: 20px 40px 30px 10px;
  background-color: #c8c800;
}

Ergebnis

Spezifikationen

Specification
CSS Logical Properties and Values Level 1
# propdef-inset

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch