タグの説明は #42005 以降、タグページ以外では表示されなくなりました

Claudeがバグレポートを作成しました。これは、私たちがまさに回避策を書いたケースに関するものです。

#42005(「A11Y: カテゴリとタグの説明にtitle属性を使用しない」、2026年7月)以降、タグの説明はメインUI内で表示される場所がなくなりました。

再現手順

  1. タグに説明を付けます。例えば、KER タグに Kreiselternrat という説明など。
  2. /latest、/categories、そのタグを含むトピック、またはコンポーザー内のタグピッカーを開きます。
  3. タグにマウスをホバーするか、フォーカスします。

期待される動作: 変更前(title ツールチップとして表示されていた)と同様に、説明を読めるアクセシビリティ対応の手段が何らか存在する。

実際の動作: 何も表示されない。説明は /tag/ と /tags ページでのみ表示されます。

これがバグだと考える理由(単なる設計上の選択ではない)

PRでは、情報が「『このカテゴリについて』のトピック、カテゴリドロップダウン、カテゴリヘッダーですでに利用可能」と述べられています。これはカテゴリには当てはまりますが、タグには当てはまりません。タグには「about」トピックが存在せず、タグピッカーの行には表示されず、トピックリストにも表示されません。

データはクライアントに送信され、レンダラーに渡されますが、無視されています。

  • frontend/discourse/app/lib/render-tag.js 内の defaultRenderTag は、params.description(トピックリスト、トピックタイトル、検索経由の tags_descriptions)を受け取りますが、それを破棄しています。
  • frontend/discourse/select-kit/components/tag-row.gjs は、description=this.item.description を dDiscourseTag に渡していますが、これも同様に破棄されています。

title 属性が不適切なツールであることは私も同意します。PR自体が、代わりにアクセシブルなツールチップ/トグルチップ建议使用を提案しています。Discourseにはfloat-kitに DTooltip があり、ホバーとキーボードフォーカスで動作します。タグ(およびタグピッカーの行)でこれを使用できないでしょうか? サイト設定で有効化する形など。

回避策: 今すぐ必要な方へ: api.replaceTagRenderer と float-kit のツールチップサービスを使用して、まさにこれを実現する小さなテーマコンポーネントがあります。ホバーとキーボードフォーカスで動作します: GitHub - thoka/discourse-tag-description-tooltip: Discourse theme component: show the tag description in a tooltip on hover and focus · GitHub

「いいね!」 2

これはバグではありません。少なくとも、私たちがバグを定義する意味ではそうではありません。一般的にバグとは、意図通りに機能していない要素を指し、今回の変更は意図的なものでした。今回はむしろUX(ユーザー体験)の問題と言えます。

トピックリストで、誰もが同じようにアクセスできる方法でこの情報を確認できます:

確かに見つけにくくなっています。説明文をより目立たせることに広範な関心がある場合は、検討可能な機能リクエストとして受け付けます。

また、Tag Banners コンポーネントも提供しており、トピックタグリストに説明文をバナーとして表示できます。

タグに対するツールチップ(マウスオーバーヒント)をオプションとして実装することは難しいです。データの不均衡という問題が、title属性の場合と同様に発生するからです。マウスオーバーによるツールチップはデスクトップでは問題ありませんが、モバイルでは機能しません。特に、タグは通常リンクとして扱われるため、クリック時の動作はすでに確保されている必要があります。

「いいね!」 1