inset-block

Baseline Widely available *

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

* Some parts of this feature may have varying levels of support.

Die inset-block CSS Eigenschaft definiert die logischen Block-Anfangs- und Endversätze eines Elements, die je nach Schreibrichtung, Richtung und Textausrichtung des Elements zu physischen Versätzen werden. Sie entspricht den Eigenschaften top und bottom, oder right und left, abhängig von den für writing-mode, direction und text-orientation definierten Werten.

Diese inset-Eigenschaft hat keine Wirkung auf nicht-positionierte Elemente.

Probieren Sie es aus

inset-block: 10px 20px;
writing-mode: horizontal-tb;

inset-block: 20px 40px;
writing-mode: vertical-rl;

inset-block: 5% 20%;
writing-mode: horizontal-tb;

inset-block: 1rem auto;
writing-mode: vertical-lr;

<section id="default-example">
  <div class="example-container">
    <div id="example-element">I am absolutely positioned.</div>
    <p>
      As much mud in the streets as if the waters had but newly retired from the
      face of the earth, and it would not be wonderful to meet a Megalosaurus,
      forty feet long or so, waddling like an elephantine lizard up Holborn
      Hill.
    </p>
  </div>
</section>

.example-container {
  border: 0.75em solid #ad1457;
  padding: 0.75em;
  text-align: left;
  position: relative;
  width: 100%;
  min-height: 200px;
}

#example-element {
  background-color: #07136c;
  border: 6px solid #ffa000;
  color: white;
  position: absolute;
  inset: 0;
}

Bestandteileigenschaften

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

Syntax

css
/* <length> values */
inset-block: 3px 10px;
inset-block: 2.4em 3em;
inset-block: 10px; /* value applied to start and end */
inset-block: auto anchor(start);
inset-block: 10em anchor-size(--my-anchor height, 10%);

/* <percentage>s of the width or height of the containing block */
inset-block: 10% 5%;

/* Keyword value */
inset-block: auto;

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

Werte

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

Formale Definition

Anfangswertwie die jeweiligen Kurzschreibweisen:
Anwendbar aufpositionierte Elemente
VererbtNein
Prozentwertelogische Höhe des beinhaltenden Blocks
Berechneter Wertwie die jeweiligen Kurzschreibweisen:
AnimationstypLängenangabe, Prozentsatz oder calc();

Formale Syntax

inset-block = 
  <'top'>{1,2}  

<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

Festlegen von Block-Anfangs- und Endversätzen

HTML

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

CSS

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

.exampleText {
  writing-mode: vertical-lr;
  position: relative;
  inset-block: 20px 50px;
  background-color: #c8c800;
}

Ergebnis

Spezifikationen

Specification
CSS Logical Properties and Values Level 1
# propdef-inset-block
CSS Positioned Layout Module Level 3
# propdef-inset-block

Browser-Kompatibilität

Siehe auch