# ember/template-no-invalid-link-text

💼 This rule is enabled in the 📋 `template-lint-migration` [config](https://github.com/ember-cli/eslint-plugin-ember#-configurations).

<!-- end auto-generated rule header -->

Disallows invalid or uninformative link text content.

Link text should be descriptive and provide context about the destination. Generic phrases like "click here" or "read more" are not accessible because they don't convey meaningful information, especially for screen reader users who may navigate by links alone.

## Rule Details

This rule disallows the following link text values:

- "click here"
- "more info"
- "read more"
- "more"

Comparison is case-insensitive and whitespace is normalized.

Links with a valid `aria-label` or `aria-labelledby` attribute are exempt. A valid `aria-label` must be non-empty and must not itself be a disallowed text value.

## Examples

Examples of **incorrect** code for this rule:

```gjs
<template>
  <a href="/about">Click here</a>
</template>
```

```gjs
<template>
  <a href="/docs">Read more</a>
</template>
```

```gjs
<template>
  <LinkTo @route="info">More info</LinkTo>
</template>
```

Examples of **correct** code for this rule:

```gjs
<template>
  <a href="/about">About Us</a>
</template>
```

```gjs
<template>
  <a href="/docs">Documentation</a>
</template>
```

```gjs
<template>
  <a href="/page" aria-label="View user profile">Click here</a>
</template>
```

## Options

| Name              | Type       | Default | Description                                                                 |
| ----------------- | ---------- | ------- | --------------------------------------------------------------------------- |
| `allowEmptyLinks` | `boolean`  | `false` | When `true`, allows links with no text content.                             |
| `linkComponents`  | `string[]` | `[]`    | Additional component names treated as links (besides `<a>` and `<LinkTo>`). |

## References

- [WebAIM: Link Text and Appearance](https://webaim.org/techniques/hypertext/link_text)
- [WCAG 2.4.4: Link Purpose (In Context)](https://www.w3.org/WAI/WCAG21/Understanding/link-purpose-in-context.html)
- [ember-template-lint: no-invalid-link-text](https://github.com/ember-template-lint/ember-template-lint/blob/main/docs/rule/no-invalid-link-text.md)