Add button chip style refresh design spec
This commit is contained in:
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.
|
||||
Reference in new issue
Block a user