ant-design/components/affix/index.en-US.md

37 lines
1.4 KiB
Markdown
Raw Normal View History

---
category: Components
type: Navigation
2016-09-21 11:28:38 +08:00
title: Affix
---
Make an element stick to viewport.
2016-09-10 13:43:30 +08:00
## When To Use
2016-11-29 17:13:24 +08:00
When user browses a long web page, some content need to stick to the viewport. This is common for menus and actions.
2016-11-29 17:13:24 +08:00
Please note that Affix should not cover other content on the page, especially when the size of the viewport is small.
## API
2017-10-25 10:25:44 +08:00
| Property | Description | Type | Default |
2019-05-07 14:57:32 +08:00
| --- | --- | --- | --- |
| offsetBottom | Pixels to offset from bottom when calculating position of scroll | number | - |
2017-10-25 10:25:44 +08:00
| offsetTop | Pixels to offset from top when calculating position of scroll | number | 0 |
| target | specifies the scrollable area dom node | () => HTMLElement | () => window |
2017-10-25 10:25:44 +08:00
| onChange | Callback for when affix state is changed | Function(affixed) | - |
2016-09-10 12:45:33 +08:00
**Note:** Children of `Affix` can not be `position: absolute`, but you can set `Affix` as `position: absolute`:
```jsx
2019-05-07 14:57:32 +08:00
<Affix style={{ position: 'absolute', top: y, left: x }}>...</Affix>
2016-09-10 12:45:33 +08:00
```
## FAQ
### Affix bind container with `target`, sometime move out of container.
We don't listen window scroll for performance consideration. You can add listener if you still want: <https://codesandbox.io/s/2xyj5zr85p>
Related issue[#3938](https://github.com/ant-design/ant-design/issues/3938) [#5642](https://github.com/ant-design/ant-design/issues/5642) [#16120](https://github.com/ant-design/ant-design/issues/16120)