element-plus/website/docs/zh-CN/affix.md

Affix 固钉

将页面元素固定在特定可视区域。

基本用法

固钉默认固定在页面顶部。

:::demo 通过设置 offset 属性来改变吸顶距离，默认值为 0。

<el-affix :offset="120">
  <el-button type="primary">距离顶部 120px</el-button>
</el-affix>

:::

指定容器

通过设置 target 属性，让固钉始终保持在容器内，超过范围则隐藏。

:::demo 请注意容器避免出现滚动条。

<div class="affix-container">
  <el-affix target=".affix-container" :offset="80">
    <el-button type="primary">指定容器</el-button>
  </el-affix>
</div>

:::

固定位置

Affix 组件提供了两个固定位置：top 和 bottom。

:::demo 通过设置 position 属性来改变固定位置，默认值为 top 。

<el-affix position="bottom" :offset="20">
  <el-button type="primary">距离底部 20px</el-button>
</el-affix>

:::

Attributes

参数	说明	类型	可选值	默认值
offset	偏移距离	number	—	0
position	固钉位置	string	top / bottom	top
target	指定容器（CSS 选择器）	string	—	—
z-index	固钉层级	number	—	100

Events

事件名称	说明	回调参数
change	固钉状态改变时触发的事件	(value: boolean)
scroll	滚动时触发的事件	滚动距离和固钉状态

Methods

方法名	说明	参数
update	手动更新固钉状态	—