Files
cv/docs/design/specs/ui/spec-ui-navigation.md
T
dong.nguyen d827bf9b23 feat: resume download, router v7/v8 migrations, spec restructure
- Add resume download button in Hero CTA and Contact section
- Migrate react-router v6→v7 and v7→v8
- Restructure specs: UI specs to specs/ui/, v2 specs to specs/v2/
- Add profile-photo assets (jpg + webp)
- Update AGENTS.md, spec-v2.md index
2026-10-06 14:14:01 +07:00

109 lines
2.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# UI Spec — Navigation
## Overview
Sticky navigation bar xuất hiện ở top mọi trang. Chứa logo, menu links, theme toggle.
---
## Structure
```
Navigation
├── Container (max-width, centered, padding)
│ ├── Logo (link → /)
│ ├── Menu (desktop)
│ │ ├── Home
│ │ ├── About
│ │ ├── Experience
│ │ ├── Projects
│ │ ├── Engineering
│ │ ├── Blog
│ │ └── Contact
│ ├── ThemeToggle (dark/light/system)
│ └── MobileMenuButton (hamburger)
└── MobileMenu (overlay, slide-in từ phải)
├── Menu links (vertical stack)
└── ThemeToggle
```
---
## Props
```ts
interface NavigationProps {
currentPage: string;
}
```
---
## Desktop Behavior
- Sticky top, z-index cao nhất (trừ modal)
- Background: surface color, backdrop-blur khi scroll
- Logo bên trái, menu giữa, theme toggle bên phải
- Menu links: text color muted, active state accent color, hover underline nhẹ
- Spacer giữa menu và theme toggle
---
## Mobile Behavior
- Logo bên trái, hamburger bên phải
- Menu button: icon 3 lines, toggle thành X khi mở
- Mobile menu: full-screen overlay, slide-in từ phải
- Menu links: vertical stack, font-size lớn, padding rộng
- Click ngoài overlay → đóng menu
- Click link → đóng menu + navigate
- Body scroll lock khi menu mở
---
## Responsive Breakpoints
| Breakpoint | Width | Behavior |
|---|---|---|
| Mobile | < 768px | Hamburger menu |
| Tablet | 768–1023px | Full menu |
| Desktop | >= 1024px | Full menu |
---
## Accessibility
- `role="navigation"` trên container
- `aria-label="Main navigation"`
- Mobile menu: `aria-expanded`, `aria-controls`
- Focus trap khi menu mở
- Escape → đóng menu
- Focus return về hamburger button khi đóng
- Semantic `<nav>` element
- Skip link (first focusable element) → "Skip to content"
---
## State
- `isOpen` (mobile menu)
- `currentPage` (active link highlighting)
- `scrolled` (background blur trigger)
---
## Variants
| Variant | Context |
|---|---|
| Default | All pages |
| Scrolled | When page scroll Y > 0 |
---
## Constraints
- Không hard-code links — derive từ routes
- Logo clickable → /
- Theme toggle không trigger re-render toàn bộ app (context-based)