BackTop回到顶部

返回页面顶部的操作按钮。

何时使用#

  • 当页面内容区域比较长时;

  • 当用户需要频繁返回顶部查看相关内容时。

代码演示

Scroll down to see the bottom-right gray button.

最简单的用法。

expand codeexpand code
import { BackTop } from 'antd';
import React from 'react';

const App: React.FC = () => (
  <>
    <BackTop />
    Scroll down to see the bottom-right
    <strong className="site-back-top-basic"> gray </strong>
    button.
  </>
);

export default App;
.site-back-top-basic {
  color: rgba(64, 64, 64, 0.6);
}

可以自定义回到顶部按钮的样式,限制宽高:40px * 40px

注意:BackTop 需要一个可接受 onClick 事件的元素作为 children。 如果您直接将文本作为子项放置,则该组件将无法正常运行。

expand codeexpand code
import { BackTop } from 'antd';
import React from 'react';

const style: React.CSSProperties = {
  height: 40,
  width: 40,
  lineHeight: '40px',
  borderRadius: 4,
  backgroundColor: '#1088e9',
  color: '#fff',
  textAlign: 'center',
  fontSize: 14,
};

const App: React.FC = () => (
  <div style={{ height: '600vh', padding: 8 }}>
    <div>Scroll to bottom</div>
    <div>Scroll to bottom</div>
    <div>Scroll to bottom</div>
    <div>Scroll to bottom</div>
    <div>Scroll to bottom</div>
    <div>Scroll to bottom</div>
    <div>Scroll to bottom</div>
    <BackTop>
      <div style={style}>UP</div>
    </BackTop>
  </div>
);

export default App;

API#

有默认样式,距离底部 50px,可覆盖。

自定义样式宽高不大于 40px * 40px。

参数说明类型默认值版本
duration回到顶部所需时间(ms)number4504.4.0
target设置需要监听其滚动事件的元素,值为一个返回对应 DOM 元素的函数() => HTMLElement() => window
visibilityHeight滚动高度达到此参数值才出现 BackTopnumber400
onClick点击按钮的回调函数function-
Anchor锚点ConfigProvider全局化配置