Affix 固钉

将页面元素钉在可视范围。

何时使用

当内容区域比较长，需要滚动页面时，这部分内容对应的操作或者导航需要在滚动范围内始终展现。常用于侧边菜单和按钮组合。页面可视范围过小时，慎用此功能以免遮挡页面内容。

代码演示

基本

最简单的用法。

<template>
  <div>
    <a-affix :offsetTop="this.top">
      <a-button type="primary" @click="()=>{this.top += 10}">Affix top</a-button>
    </a-affix>
    <br />
    <a-affix :offsetBottom="this.bottom">
      <a-button type="primary" @click="()=>{this.bottom += 10}">Affix bottom</a-button>
    </a-affix>
  </div>
</template>
<script>
  export default {
    data() {
      return {
        top: 10,
        bottom: 10,
      };
    },
  };
</script>

固定状态改变的回调

可以获得是否固定的状态。

<template>
  <a-affix :offsetTop="120" @change="change">
    <a-button>120px to affix top</a-button>
  </a-affix>
</template>
<script>
  export default {
    methods: {
      change(affixed) {
        console.log(affixed);
      },
    },
  };
</script>

滚动容器

用 target 设置 Affix 需要监听其滚动事件的元素，默认为 window。

<template>
  <div id="components-affix-demo-target" class="scrollable-container" ref="container">
    <div class="background">
      <a-affix :target="() => this.$refs.container">
        <a-button type="primary">
          Fixed at the top of container
        </a-button>
      </a-affix>
    </div>
  </div>
</template>
<style>
  #components-affix-demo-target.scrollable-container {
    height: 100px;
    overflow-y: scroll;
  }
  #components-affix-demo-target .background {
    padding-top: 60px;
    height: 300px;
    background-image: url('https://zos.alipayobjects.com/rmsportal/RmjwQiJorKyobvI.jpg');
  }
</style>

API

事件

注意：Affix 内的元素不要使用绝对定位，如需要绝对定位的效果，可以直接设置 Affix 为绝对定位：

<a-affix :style="{ position: 'absolute', top: y, left: x}">
  ...
</a-affix>