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 September 2021.

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

Die inset-block-Eigenschaft CSS definiert die logischen Block-Anfangs- und End-Offsets eines Elements, die zu physikalischen Offsets in Abhängigkeit des Schreibmodus, der Richtungsabhängigkeit und der Textorientierung des Elements abgebildet 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 property hat keine Auswirkung 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;
}

Zughörige Eigenschaften

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(--myAnchor 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 dieselben Werte wie die left-Eigenschaft an.

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 End-Offsets

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