mirror of
https://github.com/facebook/docusaurus.git
synced 2025-05-01 19:27:48 +02:00
4a448773b6
Co-authored-by: Joshua Chen <sidachen2003@gmail.com> Co-authored-by: Viktor Malmedal <viktor.malmedal@eniro.com> Co-authored-by: sebastienlorber <lorber.sebastien@gmail.com> Co-authored-by: Sébastien Lorber <slorber@users.noreply.github.com>
45 lines
1.1 KiB
Markdown
45 lines
1.1 KiB
Markdown
---
|
|
slug: /api/misc/@docusaurus/eslint-plugin/no-html-links
|
|
---
|
|
|
|
# no-html-links
|
|
|
|
Ensure that the Docusaurus [`<Link>`](../../../docusaurus-core.md#link) component is used instead of `<a>` tags.
|
|
|
|
The `<Link>` component has prefetching and preloading built-in. It also does build-time broken link detection, and helps Docusaurus understand your site's structure better.
|
|
|
|
## Rule Details {#details}
|
|
|
|
Examples of **incorrect** code for this rule:
|
|
|
|
```html
|
|
<a href="/page">go to page!</a>
|
|
|
|
<a href="https://twitter.com/docusaurus" target="_blank">Twitter</a>
|
|
```
|
|
|
|
Examples of **correct** code for this rule:
|
|
|
|
```js
|
|
import Link from '@docusaurus/Link'
|
|
|
|
<Link to="/page">go to page!</Link>
|
|
|
|
<Link to="https://twitter.com/docusaurus">Twitter</Link>
|
|
```
|
|
|
|
## Rule Configuration {#configuration}
|
|
|
|
Accepted fields:
|
|
|
|
```mdx-code-block
|
|
<APITable>
|
|
```
|
|
|
|
| Option | Type | Default | Description |
|
|
| --- | --- | --- | --- |
|
|
| `ignoreFullyResolved` | `boolean` | `false` | Set to true will not report any `<a>` tags with absolute URLs including a protocol. |
|
|
|
|
```mdx-code-block
|
|
</APITable>
|
|
```
|