#42005 이후 태그 페이지 밖에서는 태그 설명이 더 이상 표시되지 않음

Claude는 우리가 막 해결 우회 방안을 작성한 사례에 대해 다음 버그 리포트를 작성했습니다:

#42005 (“A11Y: don’t use the title attribute for category and tag descriptions”, 2026년 7월) 이후, 태그 설명은 기본 UI에서 볼 수 있는 공간이 더 이상 없습니다.

재현 단계

  1. 태그에 설명을 추가합니다. 예를 들어 KER 태그에 Kreiselternrat을 입력합니다.
  2. /latest, /categories, 해당 태그가 포함된 토픽, 또는 편집기의 태그 선택 창을 엽니다.
  3. 태그에 마우스를 올리거나 포커스를 맞춥니다.

기대 동작: 변경 사항 이전처럼 (title 툴팁을 사용하던 시절), 설명을 읽을 수 있는 접근 가능한 방법이 있어야 합니다.

실제 동작: 아무것도 표시되지 않습니다. 설명은 /tag/ 및 /tags 페이지에서만 표시됩니다.

이것이 단순한 디자인 선택이 아니라 버그라고 생각하는 이유

PR 설명에는 해당 정보가 "이미 ‘카테고리 정보’ 토픽, 카테고리 드롭다운, 카테고리 헤더에 제공된다"고 되어 있습니다. 이는 카테고리에 대해서는 사실입니다. 하지만 태그에 대해서는 그렇지 않습니다: ‘태그 정보’ 토픽은 없고, 태그 선택 창 행에도 표시되지 않으며, 토픽 목록에도 표시되지 않습니다.

데이터는 여전히 클라이언트로 전송되어 렌더러로 전달되지만, 렌더러는 이를 무시합니다:

  • frontend/discourse/app/lib/render-tag.js의 defaultRenderTag는 params.description (토픽 목록, 토픽 제목, tags_descriptions를 통한 검색)을 받지만 이를 무시합니다.
  • frontend/discourse/select-kit/components/tag-row.gjs는 dDiscourseTag에 description=this.item.description을 전달하지만, 이 또한 무시됩니다.

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개의 좋아요