Add button chip style refresh design spec

This commit is contained in:
TTlaji committed 2026-06-08 22:52:36 +08:00
1 parent 215bfad260
commit c18a5d4c2d
1 file changed
+117
@@ -0,0 +1,117 @@
# Speaking Lab Button and Chip Style Refresh Design
## Goal
Refresh all Speaking Lab buttons and chips into a flatter, more refined style inspired by the saved TEco Lab reference page while preserving the current HTML structure and class names.
This is a CSS-only visual refactor unless implementation discovers a narrow accessibility issue that cannot be solved with CSS. Existing behavior, event wiring, IDs, and class names must remain unchanged.
## Reference Interpretation
The TEco Lab reference uses compact controls with:
- rounded-full chips and rounded-lg buttons;
- small, dense typography around 12px to 14px;
- low-contrast neutral backgrounds for inactive controls;
- solid dark/highlight backgrounds only for active or primary controls;
- minimal borders, soft inset or low shadow texture, and smooth hover/active feedback.
Speaking Lab should adapt those ideas to its Study Notebook direction: warm paper surfaces, deep green primary actions, subdued neutrals, and soft warning colors.
## Scope
Update `styles.css` for these existing selectors and related states:
- `.chip` and `.chip.active`;
- `.secondary-action`;
- `.danger-action`;
- `.primary-link`;
- `#adminSubmitBtn`;
- primary form buttons such as `.auth-form button[type="submit"]`, `.admin-form button[type="submit"]`, `.activation-code-form button[type="submit"]`, and `.practice-answer-row button`;
- relevant disabled, hover, active, and focus-visible states.
Do not rename selectors, add new required HTML, or change JavaScript behavior.
## Visual Rules
### Chips
`.chip` should become a compact capsule:
- pill radius;
- 12px font size;
- medium-bold weight;
- horizontal padding that supports short Chinese labels without crowding;
- inactive background in warm light neutral;
- no hard border in the default state;
- hover background slightly darker with subtle elevation;
- `.active` background deep green or dark ink, white text, and a low shadow.
### Secondary Actions
`.secondary-action` should be quiet and tactile:
- no heavy border;
- light warm neutral or translucent white background;
- muted text color;
- rounded-lg or small pill shape depending on existing dimensions;
- hover smoothly darkens the surface and text;
- active state gently presses down;
- disabled state is visibly inactive without looking broken.
This should cover admin entry, logout, cancel edit, refresh, edit, copy, and other secondary operations that use this class or existing secondary-action variants.
### Danger Actions
`.danger-action` should be soft warning, not pure red:
- pale rose background;
- dark rose text;
- transparent or rose-tinted border;
- hover deepens the rose background and text slightly;
- active state presses down;
- disabled state uses muted rose/neutral colors.
### Primary Actions
`#adminSubmitBtn`, `.primary-link`, login submit, activation-code submit, AI primary action, and practice check buttons should share a clear primary treatment:
- solid deep green background;
- white or warm-white text;
- minimal border matching the background;
- rounded pill or 10px radius based on control context;
- subtle shadow/elevation;
- hover slightly lightens or darkens while lifting by 1px;
- active removes the lift and compresses visually;
- focus-visible ring uses a soft green halo.
## Compatibility
The changes must not break:
- home category filters and material cards;
- study mode tabs and recording/sentence controls;
- login/register form controls;
- admin create/edit form buttons;
- admin video/user/activation-code action rows;
- disabled buttons and hidden states.
Existing responsive rules should keep working. If a button currently becomes full-width or wraps on small screens, preserve that behavior.
## Testing
Verification should include:
- syntax sanity via existing JS checks if implementation touches no JS;
- browser visual checks for home, study, admin, and login pages;
- at least one desktop viewport and one mobile-width viewport;
- confirm hover/active/focus/disabled states are not visually broken where practical;
- confirm no text overflows inside buttons or chips.
## Non-Goals
- No page structure redesign in this task.
- No new icon system in this task.
- No JavaScript behavior changes.
- No changes to backend or data model.
- No full Study Notebook layout implementation beyond button and chip styling.