埃米尔设计工程
- 作者仓库星标 0
- 作者仓库 sea-prototype-template
- 领域
- 设计与多媒体
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @lemu · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 即装即用
- 是否需要外部接口密钥
- 不需要
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- 未检出明确要求
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 网络行为
- 仅限本地
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# Emil's Design Engineering Principles
A comprehensive guide for building polished, accessible web interfaces based on Emil Kowalski's design engineering practices.
## Quick Reference
| Category | When to Use |
| --- | --- |
| [Animations](animations.md) | Enter/exit transitions, easing, springs, performance |
| [UI Polish](ui-polish.md) | Typography, visual design, layout, colors |
| [Forms & Controls](forms-controls.md) | Inputs, buttons, form submission |
| [Touch & Accessibility](touch-accessibility.md) | Mobile, touch devices, keyboard nav, a11y |
| [Component Design](component-design.md) | Compound components, composition, props API |
| [Marketing](marketing.md) | Landing pages, blogs, docs sites |
| [Performance](performance.md) | Virtualization, preloading, optimization |
## Core Principles
### 1. No Layout Shift
Dynamic elements should cause no layout shift. Use hardcoded dimensions, `font-variant-numeric: tabular-nums` for changing numbers, and avoid font weight changes on hover/selected states.
### 2. Touch-First, Hover-Enhanced
Design for touch first, then add hover enhancements. Disable hover effects on touch devices. Ensure 44px minimum tap targets. Never rely on hover for core functionality.
### 3. Keyboard Navigation
Tabbing should work consistently. Only allow tabbing through visible elements. Ensure keyboard navigation scrolls elements into view with `scrollIntoView()`.
### 4. Accessibility by Default
Every animation needs `prefers-reduced-motion` support. Every icon button needs an aria label. Every interactive element needs proper focus states.
### 5. Speed Over Delight
Product UI should be fast and purposeful. Skip animations for frequently-used interactions. Marketing pages can be more elaborate.
## Decision Flowcharts
### Should I Animate This?
```
Will users see this 100+ times daily?
├── Yes → Don't animate
└── No
├── Is this user-initiated?
│ └── Yes → Animate with ease-out (150-250ms)
└── Is this a page transition?
└── Yes → Animate (300-400ms max)
```
### What Easing Should I Use?
```
Is the element entering or exiting?
├── Yes → ease-out
└── No
├── Is it moving on screen?
│ └── Yes → ease-in-out
└── Is it a hover/color change?
├── Yes → ease
└── Default → ease-out
```
## Common Mistakes
| Mistake | Fix |
| --- | --- |
| `transition: all` | Specify exact properties |
| Hover effects on touch | Use `@media (hover: hover)` |
| Font weight change on hover | Use consistent weights |
| Animating `height`/`width` | Use `transform` and `opacity` only |
| No reduced motion support | Add `prefers-reduced-motion` query |
| z-index: 9999 | Use fixed scale or `isolation: isolate` |
| Custom page scrollbars | Only customize scrollbars in small elements |
## Review Checklist
When reviewing UI code, check:
- [ ] No layout shift on dynamic content
- [ ] Animations have reduced motion support
- [ ] Touch targets are 44px minimum
- [ ] Hover effects disabled on touch devices
- [ ] Keyboard navigation works properly
- [ ] Icon buttons have aria labels
- [ ] Forms submit with Enter/Cmd+Enter
- [ ] Inputs are 16px+ to prevent iOS zoom
- [ ] No `transition: all`
- [ ] z-index uses fixed scale
## Reference Files
For detailed guidance on specific topics:
- [animations.md](animations.md) - Easing, timing, springs, performance
- [ui-polish.md](ui-polish.md) - Typography, shadows, gradients, scrollbars
- [forms-controls.md](forms-controls.md) - Inputs, buttons, form patterns
- [touch-accessibility.md](touch-accessibility.md) - Touch devices, keyboard nav, a11y
- [component-design.md](component-design.md) - Compound components, composition, props API
- [marketing.md](marketing.md) - Landing pages, blogs, docs
- [performance.md](performance.md) - Virtualization, preloading, optimization
章节与文件索引
按说明文件中的顺序排列。
快速参考
1. 无布局变化
2. 触摸优先,悬停增强
3. 键盘导航
4. 默认辅助功能
文件/命令 -> font-variant-numeric: tabular-nums · scrollIntoView() · prefers-reduced-motion · transition: all · @media (hover: hover) · height · width · transform
内容校验值 -> 6e853b5b0ebc
当前原文的自动摘译,尚未人工审校。
快速参考
类别 · 何时使用动画 · 进入/退出过渡、缓动、弹簧、性能 UI 润色 · 版式、视觉设计、布局、颜色 表单和控件 · 输入、按钮、表单提交 触摸和辅助功能 · 移动设备、触摸设备、键盘导航、a11y
1. 无布局变化
动态元素不应导致布局变化。使用硬编码尺寸,
font-variant-numeric: tabular-nums来更改数字,并避免在悬停/选定状态下更改字体粗细。2. 触摸优先,悬停增强
首先针对触摸进行设计,然后添加悬停增强功能。禁用触摸设备上的悬停效果。确保最小点击目标为 44 像素。永远不要依赖悬停来实现核心功能。
3. 键盘导航
Tab 键应始终如一地工作。只允许使用 Tab 键浏览可见元素。使用
scrollIntoView()确保键盘导航将元素滚动到视图中。4. 默认辅助功能
每个动画都需要
prefers-reduced-motion支持。每个图标按钮都需要一个 aria 标签。每个交互元素都需要适当的焦点状态。