docs: add web frontend engineering guide
This commit is contained in:
24
web/.ai-specs/coding-specs/style-asset-spec.md
Normal file
24
web/.ai-specs/coding-specs/style-asset-spec.md
Normal file
@@ -0,0 +1,24 @@
|
||||
# style-asset-spec
|
||||
|
||||
## 适用范围
|
||||
|
||||
- 涉及全局样式、Element Plus 样式覆盖、资源文件和主题变量时必读。
|
||||
|
||||
## 边界规则
|
||||
|
||||
- `src/style` 只放全局样式、重置样式、主题覆盖和 Element Plus 覆盖。
|
||||
- 页面局部样式优先写在对应 `.vue` 文件内,不要随手上提到全局。
|
||||
- `src/assets` 放构建期静态资源;只有明确需要原样暴露的资源才考虑放 `public`。
|
||||
- Element Plus 的全局覆盖优先集中到 `src/style/element*` 相关文件。
|
||||
|
||||
## 联动检查
|
||||
|
||||
- 改全局样式:同步检查登录页、主布局页、错误页和插件页。
|
||||
- 改主题变量或图标资源:同步检查使用这些资源的组件和页面。
|
||||
- 改资源引用路径:同步检查 Vite 构建、打包后路径和生产环境资源可达性。
|
||||
|
||||
## 常见错误
|
||||
|
||||
- 为了修某一个页面,把选择器直接写到全局样式里误伤其他页面。
|
||||
- 把只在一个页面使用的图片或样式工具放到全局目录。
|
||||
- 改 Element Plus 覆盖后没有检查常用表单、表格、弹窗。
|
||||
Reference in New Issue
Block a user