ant-design/components/anchor/index.en-US.md
Yuki Zhang 4eff22497d
feat: Anchor horizontal (#39372)
* feat: AnchorInk

* feat: update

* feat: update ink

* test: add test

* feat: handle with nested link

* feat: improve

* fix: lint

* feat: get direction from context in AnchorLink

* docs: update demo

* test: update snapshot

* test: update snapshot

* test: update snapshot

* test: update test cases

* test: update snapshot

* test: update snapshots

* test: update snapshots

* test: update test cases

* test: update test cases

* docs: update

* test: improve

* docs: update demo

* doc: update demos

* doc: update demos again

* feat: use scroll-into-view-if-needed

* fix: hide  scrollbar

* docs: update demos

* fix: active transition for horizontal anchor

* chore: fix terser (#39617)

* chore: fix terser

* chore: clean up

* test: update snapshot

* feat: improve code style

* feat: anchor ink improvement

* feat: improve code style

* fix: lint issue

* test: update snapshots

* docs: simplified the demo

* feat: Merge the AnchorInk component back into the Anchor component

* feat: Adjust DOM order

* test: update snapshots

* docs: Improve the document

* feat: simplify css classnames

* test: update snapshots

Co-authored-by: 二货爱吃白萝卜 <smith3816@gmail.com>
2022-12-27 17:14:35 +08:00

3.1 KiB

category title cover demo group
Components Anchor https://mdn.alipayobjects.com/huamei_7uahnr/afts/img/A*TBTSR4PyVmkAAAAAAAAAAAAADrJ8AQ/original
title order
Navigation 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

Basic Horizontal Anchor Static Anchor Customize the onClick event Customize the anchor highlight Set Anchor scroll offset Listening for anchor link change Deprecated JSX demo

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 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 - 5.1.0
direction Set Anchor direction vertical | horizontal vertical 5.2.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[] -

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