From f4b77ae89801c8091aacf5de58c9e9da455a53de Mon Sep 17 00:00:00 2001
From: seonghobae <8172694+seonghobae@users.noreply.github.com>
Date: Wed, 5 Aug 2026 21:38:45 +0000
Subject: [PATCH] =?UTF-8?q?=F0=9F=8E=A8=20Palette:=20[=EC=A0=91=EA=B7=BC?=
 =?UTF-8?q?=EC=84=B1]=20GroupModal=EC=9D=98=20=EC=83=89=EC=83=81=20?=
 =?UTF-8?q?=EC=84=A0=ED=83=9D=EA=B8=B0=20=EC=8A=A4=EC=99=80=EC=B9=98?=
 =?UTF-8?q?=EC=97=90=20=EC=98=AC=EB=B0=94=EB=A5=B8=20radio=20=EC=97=AD?=
 =?UTF-8?q?=ED=95=A0=20=EB=B0=8F=20aria-checked=20=EC=86=8D=EC=84=B1=20?=
 =?UTF-8?q?=EC=A0=81=EC=9A=A9?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .Jules/palette.md                                     | 3 +++
 frontend/src/components/modals/GroupModal.tsx         | 3 ++-
 frontend/src/components/modals/ModalCoverage.test.tsx | 2 +-
 frontend/src/styles.css                               | 2 +-
 4 files changed, 7 insertions(+), 3 deletions(-)

diff --git a/.Jules/palette.md b/.Jules/palette.md
index 7577a1ca..f1b5831b 100644
--- a/.Jules/palette.md
+++ b/.Jules/palette.md
@@ -56,3 +56,6 @@
 ## 2024-07-14 - Native Keyboard Submission with Forms for Modals
 **Learning:** Modals designed with plain `<div>` elements as wrappers instead of `<form>` lack native keyboard submission support, forcing users to switch from keyboard to mouse to confirm actions like "Save".
 **Action:** When designing modals or popups containing inputs, always use a `<form>` element to wrap the content, handle the `onSubmit` event (calling `e.preventDefault()`), and set the primary confirmation button to `type="submit"` to enable seamless Enter-key submission for keyboard users.
+## 2026-08-06 - [Radiogroup 하위 역할 및 ARIA 상태]
+**Learning:** `role="radiogroup"`을 사용하여 커스텀 선택 영역(예: 색상 스와치)을 감쌀 때, 하위 요소가 `role="radio"`를 가지고 `aria-pressed` 대신 `aria-checked` 속성을 사용하도록 하는 것이 중요합니다. 스크린 리더는 radiogroup의 상태와 탐색 옵션을 올바르게 알리기 위해 부모-자식 역할 관계에 의존합니다. 구조가 일치하지 않으면 항목 수와 상태가 제대로 알려지지 않습니다.
+**Action:** `role="radiogroup"`이 포함된 커스텀 라디오 그룹을 만들 때 하위 상호 작용 요소가 `role="radio"`를 가지고 `aria-pressed` 대신 `aria-checked`를 사용하여 상태를 표현하도록 항상 적용하세요. 관련된 DOM 테스트 선택자가 'radio' 역할을 조회하도록 업데이트되었는지 확인하세요.
diff --git a/frontend/src/components/modals/GroupModal.tsx b/frontend/src/components/modals/GroupModal.tsx
index bd96c21b..e68be5c7 100644
--- a/frontend/src/components/modals/GroupModal.tsx
+++ b/frontend/src/components/modals/GroupModal.tsx
@@ -75,8 +75,9 @@ export function GroupModal({
             {BUSINESS_GROUP_COLORS.map((color) => (
               <button
                 type="button"
+                role="radio"
                 aria-label={`색상 ${color}`}
-                aria-pressed={newGroupColor === color}
+                aria-checked={newGroupColor === color}
                 className="groupManager__swatch"
                 key={color}
                 onClick={() => setNewGroupColor(color)}
diff --git a/frontend/src/components/modals/ModalCoverage.test.tsx b/frontend/src/components/modals/ModalCoverage.test.tsx
index 8732f7ef..90d327ad 100644
--- a/frontend/src/components/modals/ModalCoverage.test.tsx
+++ b/frontend/src/components/modals/ModalCoverage.test.tsx
@@ -262,7 +262,7 @@ describe('modal behavior coverage', () => {
       />,
     )
     fireEvent.change(screen.getByLabelText('그룹 이름'), { target: { value: 'New' } })
-    fireEvent.click(screen.getAllByRole('button', { name: /^색상 / })[1]!)
+    fireEvent.click(screen.getAllByRole('radio', { name: /^색상 / })[1]!)
     fireEvent.click(screen.getByRole('button', { name: '추가' }))
     vi.spyOn(window, 'confirm').mockReturnValueOnce(true)
     fireEvent.click(screen.getByRole('button', { name: 'Billing 그룹 삭제' }))
diff --git a/frontend/src/styles.css b/frontend/src/styles.css
index 3605ce9f..49a5747a 100644
--- a/frontend/src/styles.css
+++ b/frontend/src/styles.css
@@ -943,7 +943,7 @@ button:disabled {
   box-shadow: 0 0 0 1px var(--color-border);
 }
 
-.groupManager__swatch[aria-pressed="true"] {
+.groupManager__swatch[aria-checked="true"] {
   box-shadow: 0 0 0 3px var(--color-text-strong);
 }