メインコンテンツまでスキップ

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-iderrorではなく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
}
}
}
PropertyTypeDefault ValueDescription
fragmentRefersNameAttrbooleanfalseフラグメントの参照先をIDだけでなくname属性の値も含めます。

Default Severity

warning