vue3.0 ElementPlus 中文版入门教程 ElementPlus Affix 固钉
Affix 固钉
将页面元素固定在特定可视区域。
基本用法
固钉默认固定在页面顶部。
通过设置 offset 属性来改变吸顶距离，默认值为 0。
<template>
<el-affix :offset="120">
<el-button type="primary">距离顶部 120px</el-button>
</el-affix>
</template>
指定容器
通过设置 target 属性，让固钉始终保持在容器内，超过范围则隐藏。
请注意容器避免出现滚动条。
<template>
<div class="affix-container">
<el-affix target=".affix-container" :offset="80">
<el-button type="primary">指定容器</el-button>
</el-affix>
</div>
</template>
固定位置
Affix 组件提供了两个固定位置：top 和 bottom。
通过设置 position 属性来改变固定位置，默认值为 top 。
<template>
<el-affix position="bottom" :offset="20">
<el-button type="primary">距离底部 20px</el-button>
</el-affix>
</template>
Attributes
| 参数 | 说明 | 类型 | 可选值 | 默认值 |
|---|---|---|---|---|
| offset | 偏移距离 | number | — | 0 |
| position | 固钉位置 | string | top / bottom | top |
| target | 指定容器（CSS 选择器） | string | — | — |
| z-index | 固钉层级 | number | — | 100 |
Events
| 事件名称 | 说明 | 回调参数 |
|---|---|---|
| change | 固钉状态改变时触发的事件 | (value: boolean) |
| scroll | 滚动时触发的事件 | 滚动距离和固钉状态 |
Methods
| 方法名 | 说明 | 参数 |
|---|---|---|
| update | 手动更新固钉状态 | — |