🎨 Palette: Accessible Collapsibles

.jules/palette.md

@@ -0,0 +1,4 @@
+
+## 2025-04-29 - Accessible Collapsibles with Unique IDs
+**Learning:** For accessible React interactive widgets (like tabs or collapsibles), it's important to use React's `useId` hook to generate unique IDs for `aria-controls` mappings. This ensures correct screen reader context and prevents ID collisions when multiple instances of the widget are rendered on the same page.
+**Action:** Always use `useId` for mapping `aria-controls` to the corresponding `id` of the controlled element in custom interactive components.

src/components/wiki/wiki-collapsible.tsx

@@ -1,6 +1,6 @@
 "use client";
 
-import { useState } from "react";
+import { useState, useId } from "react";
 
 interface WikiCollapsibleProps {
   title: string;
@@ -14,6 +14,7 @@ export function WikiCollapsible({
   defaultOpen = true,
 }: WikiCollapsibleProps) {
   const [isOpen, setIsOpen] = useState(defaultOpen);
+  const contentId = useId();
 
   return (
     <div className="border border-wiki-border-light bg-wiki-offwhite">
@@ -22,11 +23,17 @@ export function WikiCollapsible({
         <button
           onClick={() => setIsOpen(!isOpen)}
           className="text-wiki-link text-sm hover:underline"
+          aria-expanded={isOpen}
+          aria-controls={contentId}
         >
           [{isOpen ? "hide" : "show"}]
         </button>
       </div>
-      {isOpen && <div className="px-4 py-3">{children}</div>}
+      {isOpen && (
+        <div id={contentId} className="px-4 py-3">
+          {children}
+        </div>
+      )}
     </div>
   );
 }