From 4e86ed83d9b90ea50cef1ba8565debc722f5d0e2 Mon Sep 17 00:00:00 2001
From: seonghobae <8172694+seonghobae@users.noreply.github.com>
Date: Thu, 9 Jul 2026 14:04:27 +0000
Subject: [PATCH] feat: add aria-label to table-based form controls for
 accessibility

Added explicit aria-label attributes to the <select> in GroupModal
and the <input> in CardinalityModal to ensure screen readers provide
full context for these table-based controls.
---
 .jules/palette.md                                   | 4 ++++
 frontend/src/components/modals/CardinalityModal.tsx | 1 +
 frontend/src/components/modals/GroupModal.tsx       | 1 +
 3 files changed, 6 insertions(+)

diff --git a/.jules/palette.md b/.jules/palette.md
index 4fa55f04..84e2da92 100644
--- a/.jules/palette.md
+++ b/.jules/palette.md
@@ -46,3 +46,7 @@
 ## 2026-07-05 - Accessible Disabled Buttons
 **Learning:** Adding `aria-describedby` to disabled buttons and explicitly linking them to visible helper text elements allows screen readers to announce the reason for being disabled, significantly improving accessibility for interactive elements that depend on prior state (like selecting a project).
 **Action:** Always pair disabled interactive elements with visible helper text and use `aria-describedby` to semantically link them, ensuring the context is available to assistive technologies.
+
+## 2026-07-09 - [UX improvement] Accessible table-based form controls
+**Learning:** In table-based forms where inputs or `<select>` elements correspond to a specific row/column property (e.g., Distinct Count, Group Assignment), the visual context or `<label>` often only provides the row identity. Always provide an explicit `aria-label` directly on the input/select to give screen readers full context (e.g., `${column.column_name} distinct count`), even if it is linked to a label via `id`.
+**Action:** Add explicit `aria-label` attributes to form controls in table layouts to ensure complete context is read by screen readers.
diff --git a/frontend/src/components/modals/CardinalityModal.tsx b/frontend/src/components/modals/CardinalityModal.tsx
index 8d360537..f8194b95 100644
--- a/frontend/src/components/modals/CardinalityModal.tsx
+++ b/frontend/src/components/modals/CardinalityModal.tsx
@@ -161,6 +161,7 @@ export function CardinalityModal({
                     </td>
                     <td>
                       <input
+                        aria-label={`${column.column_name} distinct count`}
                         id={inputId}
                         inputMode="numeric"
                         min="1"
diff --git a/frontend/src/components/modals/GroupModal.tsx b/frontend/src/components/modals/GroupModal.tsx
index 30f0993f..03177d99 100644
--- a/frontend/src/components/modals/GroupModal.tsx
+++ b/frontend/src/components/modals/GroupModal.tsx
@@ -132,6 +132,7 @@ export function GroupModal({
                   {node.data.title}
                 </span>
                 <select
+                  aria-label={`${node.data.title} 그룹 배정`}
                   value={node.data.businessGroup?.id ?? ""}
                   onChange={(event) =>
                     onAssignBusinessGroup(node.id, event.target.value)