2016-07-11 11:40:20 +08:00
|
|
|
---
|
|
|
|
|
category: Components
|
2016-11-09 14:43:32 +08:00
|
|
|
type: Navigation
|
2016-07-11 11:40:20 +08:00
|
|
|
title: BackTop
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
`BackTop` makes it easy to go back to the top of the page.
|
|
|
|
|
|
|
|
|
|
## When To Use
|
|
|
|
|
|
|
|
|
|
- When the page content is very long.
|
|
|
|
|
- When you need to go back to the top very frequently in order to view the contents.
|
|
|
|
|
|
|
|
|
|
## API
|
|
|
|
|
|
|
|
|
|
> The distance to the bottom is set to `50px` by default, which is overridable.
|
|
|
|
|
|
|
|
|
|
> If you decide to use custom styles, please note the size limit: no more than `40px * 40px`.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Property | Description | Type | Default
|
|
|
|
|
-----|-----|-----|------
|
2017-01-20 20:10:50 +08:00
|
|
|
visibilityHeight | the `BackTop` button will not show until the scroll height reaches this value | number | 400
|
2016-07-11 11:40:20 +08:00
|
|
|
onClick | a callback function, which can be executed when you click the button | Function | -
|
2017-03-30 14:23:25 +08:00
|
|
|
target | specifies the scrollable area dom node | () => HTMLElement | () => window
|
