Files

yanweidong 72a83f5fcd docs(agents): add design references

2026-08-10 23:34:28 +08:00

name, description, user-invocable

name	description	user-invocable
arco-vue-affix	Arco Design Vue 固钉 Affix 组件参考。用于 Vue 3、`@arco-design/web-vue`、`<a-affix>`、属性、事件、插槽、示例和实现细节。	false

固钉 Affix

简介

基本用法，不设置固定位置时，当页面滚动元素不可见时，元素固定在页面最顶部。

<template>
  <a-affix>
    <a-button type="primary">Affix Top</a-button>
  </a-affix>
</template>

参数名	描述	类型	默认值
offset-top	距离窗口顶部达到指定偏移量后触发	`number`	`0`
offset-bottom	距离窗口底部达到指定偏移量后触发	`number`	`-`
target	滚动容器，默认是 `window`	`string \| HTMLElement \| Window`	`-`
target-container	`target`的外层滚动元素，默认是 `window`。`Affix` 将会监听该元素的滚动事件，并实时更新固钉的位置。主要是为了解决 `target` 属性指定为非 `window` 元素时，如果外层元素滚动，可能会导致固钉跑出容器问题	`string \| HTMLElement \| Window`	`-`

事件名	描述	参数
change	固定状态发生改变时触发	fixed: `boolean`

方法名	描述	参数	返回值
updatePosition	更新位置	-	-

顶部固定：当页面滚动或浏览器窗口改变时，元素向上滚动到距顶部一定距离时固定。
底部固定：当页面滚动或浏览器窗口改变时，元素向下滚动到距底部一定距离时固定。
固定状态改变回调：当固定状态发生改变时，会触发事件。
滚动容器：用 target 设置需要监听其滚动事件的元素，默认为 window。target 指定为非 window 容器时，可能会出现 target外层元素滚动，固钉元素跑出滚动容器的问题。这个时候可以通过传入targetContainer传入target外层的滚动元素。