此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

inset

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨2021年4月⁩.

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

CSS 属性 inset 是一个对应于 toprightbottomleft 属性的简写属性。它的多值语法与 margin 简写属性相同。

inset 属性(包括 inset)对非定位元素无效。

尝试一下

inset: 1em;
inset: 5% 0;
inset: 2em 50px 20px;
inset: 10px 30% 20px 0;
inset: 0;
<section id="default-example">
  <div class="example-container">
    <div id="example-element">我处于绝对定位状态。</div>
    <p>
      街道上四处泥泞,像是洪水刚刚从大地上退去一般,倘若此时你在霍尔本山腰间遇上一只大约四十英尺长的斑龙,如同巨象一般横冲直撞地进入山中,那也不足为奇。
    </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;
}

虽然该属性属于 CSS 逻辑属性与逻辑值模块,但它并不定义逻辑偏移量。它定义的是物理偏移量,与元素的书写模式、文本方向或文字排列方向无关。

组成属性

该属性是以下 CSS 属性的简写:

语法

css
/* <length> 值 */
inset: 10px; /* 所有边距都应用相同的值 */
inset: 4px 8px; /* 上/下 左/右 */
inset: 5px 15px 10px; /* 上 左/右 下 */
inset: 2.4em 3em 3em 3em; /* 上 右 下 左 */
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> 值表示相对于包含区块的宽度(左/右)或高度(上/下)的百分比 */
inset: 10% 5% 5% 5%;

/* 关键字值 */
inset: auto;

/* 全局值 */
inset: inherit;
inset: initial;
inset: revert;
inset: revert-layer;
inset: unset;

inset 属性的取值与 left 属性相同。

形式定义

初始值该简写所对应的每个属性:
适用元素positioned elements
是否是继承属性
Percentagesrelative to the containing block's size in the corresponding axis (e.g. width for left or right, height for top or bottom)
计算值该简写所对应的每个属性:
  • top: if specified as a length, the corresponding absolute length; if specified as a percentage, the specified value; otherwise, auto
  • bottom: if specified as a length, the corresponding absolute length; if specified as a percentage, the specified value; otherwise, auto
  • left: if specified as a length, the corresponding absolute length; if specified as a percentage, the specified value; otherwise, auto
  • right: if specified as a length, the corresponding absolute length; if specified as a percentage, the specified value; otherwise, auto
动画类型a length, percentage or calc();

形式语法

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

示例

为元素设置偏移

HTML

html
<div>
  <span class="exampleText">示例文本</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;
}

结果

规范

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

浏览器兼容性

参见