画像に代替テキストが無い
image-alt-text既定で動く日本語 / 英語
「」のように、代替テキストの無い画像
例
指摘される文
四月から六月の売上です。
chaff の出力
3:1 画像「」に代替テキストがありません
直した文
四月から六月の売上です。
chaff の出力
指摘なし
直し方
画像が伝えることを一言で書いてください（）。飾りの画像なら、HTML で alt="" と書くと読み上げが飛ばします。
なぜ指摘するのか
画像が読み込めないときと、画面読み上げで読むときは、代替テキストだけが画像の代わりに伝わります。「」のように空だと、そこに何があったのか読み手には分かりません。HTML の <img> は alt 属性が無いものだけを数え、alt="" は飾りの画像と書き手が明示したものとして数えません（markdownlint の MD045 と同じ）。
指摘しないもの
HTML で alt="" と書いた画像は、飾りと明示したものとして指しません。引用（>）とコードの中の画像も見ません。
止める・ゆるめる
この一か所だけ黙らせる（文書に書く）
<!-- stet: image-alt-text — 理由 -->
チームでゆるめる（理由は chaff.yaml にコメントで残ります）
npx chaffjs relax image-alt-text --why "理由"
チームで止める（chaff.yaml）
rules:
image-alt-text: off
技術的な情報
- 層
- L1
- 状態
- 安定
- 重さ
- 注意
- 対象の言語
- 日本語と英語
- 向いている文章
- business, technical, blog, legal, docs, academic, literature, speech
- 文書から読み取るもの
- markdown
強さ（段階）
chaff.yaml の rules にこの名前と段階を書くと変わります。書かなければ、ジャンルが決めた段階で動きます（どのジャンルで動くかは下の「ジャンルごとの動き」にあります）。
| strict | エラー |
|---|---|
| normal | 注意 |
| relaxed | 情報 |
このルールには数える上限がありません。段階は指摘の重さを変えます。relaxed にすると指摘は消えずに一段軽く出ます。
ジャンルごとの動き
- 既定で動くジャンル
- technical/spec, technical/readme, blog/tech, blog/essay, blog/owned-media, business/proposal, business/report, business/email, business/press-release, business/meeting-notes, legal/contract, legal/statute, legal/judgment, legal/patent, docs/manual, docs/faq, docs/glossary, academic/paper, literature/fiction, literature/essay, literature/poetry, literature/play, speech/address, speech/transcript
指摘の文
画像「{image}」に代替テキストがありません
このページはルールの定義ファイルから作られています:packages/chaff/rules/image-alt-text.yaml