no-broken-fragment-link
ハイパーリンク(<a href="#…"> / <area href="#…">)に指定されたフラグメントが、HTML Living Standard § Scrolling to a fragment に従い、同じドキュメント内に存在するIDを参照しているかどうかを確認します。
旧no-refer-to-non-existent-idルールから分割されました。HTML LS はフラグメントリンクの参照先不在を適合性違反として扱いません(参照先が存在しない場合、フラグメントへのスクロールは単に何も起きないだけです)。そのため、このルールのデフォルト深刻度はno-refer-to-non-existent-idのerrorではなくwarningです。
fragmentRefersNameAttr オプションを指定すると、id だけでなく要素の name 属性の値に一致するフラグメントも許容します。
❌ 間違ったコード例
<a href="#baz">Fragment link</a>
<section id="qux">...</section>
✅ 正しいコード例
<a href="#baz">Fragment link</a>
<section id="baz">...</section>
Interface
{
"no-broken-fragment-link": boolean
}
Options
{
"no-broken-fragment-link": {
"options": {
"fragmentRefersNameAttr"?: boolean
}
}
}
| Property | Type | Default Value | Description |
|---|---|---|---|
fragmentRefersNameAttr | boolean | false | フラグメントの参照先をIDだけでなくname属性の値も含めます。 |
Default Severity
warning