← 中文资源

简体中文版本

滚动锚定

滚动锚定在视口上方内容尺寸变化时保持可见内容不动:浏览器选中锚点节点,在布局变化时补偿滚动位置,避免阅读位置跳动。

阅读英文原文

概念定义

没有锚定时,在视口上方插入横幅会把一切推下去、阅读位置跳变。有锚定时,浏览器选中靠近视口顶部的节点,通过反向调整 scrollTop 让它在视觉上保持不动:布局变化发生在上方不可见处,用户原地不动。

工作机制

引擎从视口顶部附近的元素中选择锚点,偏好视觉权重大的节点。布局变化后计算位移并调整滚动位置;对某元素设置 overflow-anchor: none 可将其排除出候选,对容器设置则对其子树禁用该特性。

使用场景

带懒加载媒体的长文、向前插入历史的聊天记录、插入广告的动态信息流。依赖原始 scrollTop 数学的无限滚动必须考虑补偿,或局部禁用滚动容器上的锚定。

常见误区

锚定只对视口上方生效:视口内部的位移照样可见并计入布局偏移指标。编程式 scrollTo 与补偿在同一帧交错可能落在意外位置。给每个动画头部都排除锚点,等于把锚定解决的跳变问题请了回来;正确做法是为晚到内容预留空间。

代码示例

/* Markup contract: each .form__field contains a label, an input,
   an optional .form__hint, and a .form__error paragraph. */

.form {
  display: grid;
  gap: var(--space-4, 1.5rem);
  max-inline-size: 32rem;
}

.form__field {
  display: grid;
  gap: var(--space-2, 0.5rem);
  border-radius: var(--radius-sm, 0.375rem);
}

.form__field > label {
  font-weight: 600;
}

.form__field input {
  font: inherit;
  padding-block: 0.5rem;
  padding-inline: 0.65rem;
  border: 1px solid var(--color-border, #a1a1aa);
  border-radius: var(--radius-sm, 0.375rem);
  background: var(--color-surface, #ffffff);
  color: var(--color-text, #18181b);
}

.form__error {
  display: none;
  margin: 0;
  font-size: 0.875rem;
  color: var(--color-danger, #b91c1c);
}

.form__field:has(input:required) > label::after {
  content: " *";
  color: var(--color-danger, #b91c1c);
}

.form__field:has(input:focus-visible) {
  outline: 2px solid var(--color-focus, #4f46e5);
  outline-offset: 4px;
}

/* :user-invalid appears only after the user has interacted or tried to submit. */
.form__field:has(input:user-invalid) input,
.form__field:has(input[aria-invalid="true"]) input {
  border-color: var(--color-danger, #b91c1c);
  background: var(--color-danger-surface, #fef2f2);
}

.form__field:has(input:user-invalid) .form__error,
.form__field:has(input[aria-invalid="true"]) .form__error {
  display: block;
}

@media (forced-colors: active) {
  .form__field:has(input:user-invalid) input,
  .form__field:has(input[aria-invalid="true"]) input {
    border: 2px solid Mark;
  }
}

/* Fallback without :has: use the general sibling combinator and show the
   message only for inputs explicitly marked invalid by script or server. */
@supports not selector(:has(*)) {
  .form__field input[aria-invalid="true"] {
    border-color: var(--color-danger, #b91c1c);
  }

  .form__field input[aria-invalid="true"] ~ .form__error {
    display: block;
  }
}