mirror of
https://github.com/ant-design/ant-design.git
synced 2024-12-13 07:39:10 +08:00
4af6a526e2
* 📦 ADD: replace prop to Anchor * 📖 DOC: add demo * 🧪 TEST: snapshots * Update components/anchor/index.en-US.md Co-authored-by: kiner-tang(文辉) <1127031143@qq.com> * Update components/anchor/index.en-US.md Co-authored-by: kiner-tang(文辉) <1127031143@qq.com> * Update components/anchor/index.zh-CN.md Co-authored-by: kiner-tang(文辉) <1127031143@qq.com> * Update components/anchor/index.zh-CN.md Co-authored-by: kiner-tang(文辉) <1127031143@qq.com> * 🧪 TEST: Anchor replace * 🧪 TEST: Anchor with href * 🗑 REMOVE: unnecessary href default value * Update components/anchor/demo/replace.md Co-authored-by: kiner-tang(文辉) <1127031143@qq.com> * Update components/anchor/demo/replace.md Co-authored-by: kiner-tang(文辉) <1127031143@qq.com> --------- Co-authored-by: kiner-tang(文辉) <1127031143@qq.com>
79 lines
3.6 KiB
Markdown
79 lines
3.6 KiB
Markdown
---
|
|
category: Components
|
|
title: Anchor
|
|
cover: https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*TBTSR4PyVmkAAAAAAAAAAAAADrJ8AQ/original
|
|
coverDark: https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*JGb3RIzyOCkAAAAAAAAAAAAADrJ8AQ/original
|
|
demo:
|
|
group:
|
|
title: Navigation
|
|
order: 3
|
|
---
|
|
|
|
Hyperlinks to scroll on one page.
|
|
|
|
## When To Use
|
|
|
|
For displaying anchor hyperlinks on page and jumping between them.
|
|
|
|
> Notes for developers
|
|
>
|
|
> After version `4.24.0`, we rewrite Anchor use FC, Some methods of obtaining `ref` and calling internal instance methods will invalid.
|
|
|
|
## Examples
|
|
|
|
<!-- prettier-ignore -->
|
|
<code src="./demo/basic.tsx" iframe="200">Basic</code>
|
|
<code src="./demo/horizontal.tsx" iframe="200">Horizontal Anchor</code>
|
|
<code src="./demo/static.tsx" >Static Anchor</code>
|
|
<code src="./demo/onClick.tsx">Customize the onClick event</code>
|
|
<code src="./demo/customizeHighlight.tsx">Customize the anchor highlight</code>
|
|
<code src="./demo/targetOffset.tsx" iframe="200">Set Anchor scroll offset</code>
|
|
<code src="./demo/onChange.tsx">Listening for anchor link change</code>
|
|
<code src="./demo/replace.tsx" iframe="200">Replace href in history</code>
|
|
<code src="./demo/legacy-anchor.tsx" debug>Deprecated JSX demo</code>
|
|
<code src="./demo/component-token.tsx" debug>Component Token</code>
|
|
|
|
## API
|
|
|
|
### Anchor Props
|
|
|
|
| Property | Description | Type | Default | Version |
|
|
| --- | --- | --- | --- | --- |
|
|
| affix | Fixed mode of Anchor | boolean | true | |
|
|
| bounds | Bounding distance of anchor area | number | 5 | |
|
|
| getContainer | Scrolling container | () => HTMLElement | () => window | |
|
|
| getCurrentAnchor | Customize the anchor highlight | (activeLink: string) => string | - | |
|
|
| offsetTop | Pixels to offset from top when calculating position of scroll | number | 0 | |
|
|
| showInkInFixed | Whether show ink-square when `affix={false}` | boolean | false | |
|
|
| targetOffset | Anchor scroll offset, default as `offsetTop`, [example](#components-anchor-demo-targetoffset) | number | - | |
|
|
| onChange | Listening for anchor link change | (currentActiveLink: string) => void | | |
|
|
| onClick | Set the handler to handle `click` event | (e: MouseEvent, link: object) => void | - | |
|
|
| items | Data configuration option content, support nesting through children | { key, href, title, target, children }\[] [see](#anchoritem) | - | 5.1.0 |
|
|
| direction | Set Anchor direction | `vertical` \| `horizontal` | `vertical` | 5.2.0 |
|
|
| replace | Replace items' href in browser history instead of pushing it | boolean | false | 5.7.0 |
|
|
|
|
### AnchorItem
|
|
|
|
| Property | Description | Type | Default | Version |
|
|
| --- | --- | --- | --- | --- |
|
|
| key | The unique identifier of the Anchor Link | string \| number | - | |
|
|
| href | The target of hyperlink | string | | |
|
|
| target | Specifies where to display the linked URL | string | | |
|
|
| title | The content of hyperlink | ReactNode | | |
|
|
| children | Nested Anchor Link, `Attention: This attribute does not support horizontal orientation` | [AnchorItem](#anchoritem)\[] | - | |
|
|
| replace | Replace item href in browser history instead of pushing it | boolean | false | 5.7.0 |
|
|
|
|
### Link Props
|
|
|
|
We recommend using the items form instead.
|
|
|
|
| Property | Description | Type | Default | Version |
|
|
| -------- | ----------------------------------------- | --------- | ------- | ------- |
|
|
| href | The target of hyperlink | string | | |
|
|
| target | Specifies where to display the linked URL | string | | |
|
|
| title | The content of hyperlink | ReactNode | | |
|
|
|
|
## Design Token
|
|
|
|
<ComponentTokenTable component="Anchor"></ComponentTokenTable>
|