docs(规范): 完善按钮样式统一规范和UI开发指南

- 新增按钮样式统一规范章节,明确表格列表页面按钮样式要求
- 完善图标使用规范,增加按钮样式说明
- 优化页面开发规范,统一按钮和主题色彩要求
- 强调禁止使用圆角按钮(round属性),确保界面一致性
- 添加正确和错误示例,提供完整的实现参考
This commit is contained in:
Leo 2025-07-09 10:17:57 +08:00
parent 99019bc689
commit 83e099a687

151
CLAUDE.md
View File

@ -289,7 +289,7 @@ coiMsgBox('确定要删除吗?', '删除确认').then(() => {
<!-- 在组件插槽中使用 -->
<CoiEmpty>
<template #action>
<NButton type="primary" round>
<NButton type="primary">
<template #icon>
<NIcon>
<icon-park-outline:plus />
@ -340,12 +340,17 @@ coiMsgBox('确定要删除吗?', '删除确认').then(() => {
- ✅ 空状态组件的操作按钮
- ✅ 表单提交和取消按钮
**2. 图标尺寸规范**
**2. 按钮样式规范**
- ✅ 表格列表页面的操作按钮:使用标准方形按钮,不使用圆角(`round`)属性
- ✅ 按钮格式:图标 + 文字的组合形式
- ✅ 参考用户管理页面的按钮样式标准
**3. 图标尺寸规范**
- 默认按钮:无需指定尺寸
- 大按钮:可根据需要调整
- 小按钮:保持图标清晰可见
**3. 图标样式要求**
**4. 图标样式要求**
```html
<template #icon>
<NIcon>
@ -361,6 +366,7 @@ coiMsgBox('确定要删除吗?', '删除确认').then(() => {
- ❌ 在JavaScript中动态处理图标组件
- ❌ 使用其他图标库(除非特殊需求)
- ❌ 图标与功能语义不匹配
- ❌ 在表格列表页面使用圆角按钮(`round` 属性)
### 示例:完整的页面按钮实现
```vue
@ -948,8 +954,15 @@ async function handleSubmit() {
/>
```
### 按钮样式规范
2. **按钮样式一致性**
- ✅ 表格列表页面的操作按钮必须使用标准方形按钮样式
- ✅ 按钮格式:图标 + 文字的组合形式
- ✅ 严禁使用圆角按钮(`round` 属性)
- ✅ 参考用户管理页面的按钮样式标准
### 动态主题色彩规范
2. **主题色彩一致性**
3. **主题色彩一致性**
- ✅ 所有标签、按钮、状态指示器必须使用系统动态主题色彩
- ✅ 使用 CSS 变量而非硬编码颜色值
- ✅ 遵循项目的主题色彩体系,确保在主题切换时保持一致性
@ -1042,12 +1055,13 @@ var(--info-color) /* 信息色 */
- ❌ 忽略主题切换时的色彩适配
- ❌ 使用与系统主题不一致的自定义颜色方案
- ❌ 在标签、按钮等组件上使用固定颜色样式
- ❌ 在表格列表页面使用圆角按钮(`round` 属性)
### 示例:完整的表格页面实现
```vue
<template>
<div class="page-container">
<!-- 操作区域 -->
<!-- 操作区域 - 使用标准方形按钮,不使用圆角 -->
<div class="action-bar">
<NButton type="primary" @click="handleAdd">
<template #icon>
@ -1055,6 +1069,20 @@ var(--info-color) /* 信息色 */
</template>
新增
</NButton>
<NButton type="error" @click="handleDelete">
<template #icon>
<NIcon><icon-park-outline:delete /></NIcon>
</template>
删除
</NButton>
<NButton @click="handleExport">
<template #icon>
<NIcon><icon-park-outline:download /></NIcon>
</template>
导出
</NButton>
</div>
<!-- 数据表格 - 表头不加粗,使用默认样式 -->
@ -1293,6 +1321,119 @@ import { coiMsgError, coiMsgSuccess, coiMsgWarning } from '@/utils/coi'
**遵循此规范确保所有表单页面具有一致的用户体验和错误处理机制!**
## 🎯 按钮样式统一规范(强制要求)
**所有新创建的表格列表页面必须严格遵循标准按钮样式规范,确保界面的一致性和专业性**
### 按钮样式核心要求
1. **标准方形按钮**
- ✅ 所有表格列表页面的操作按钮必须使用标准方形样式
- ✅ 严禁使用圆角按钮(`round` 属性)
- ✅ 参考用户管理页面的按钮样式标准
2. **图标 + 文字组合**
- ✅ 按钮必须采用图标 + 文字的组合形式
- ✅ 图标位于文字左侧,提升用户体验
- ✅ 使用语义化的图标选择
### 正确的按钮实现示例
```vue
<template>
<div class="page-actions">
<!-- ✅ 正确:标准方形按钮 + 图标 + 文字 -->
<NButton type="primary" @click="handleAdd">
<template #icon>
<NIcon><icon-park-outline:plus /></NIcon>
</template>
新增
</NButton>
<NButton type="error" @click="handleDelete">
<template #icon>
<NIcon><icon-park-outline:delete /></NIcon>
</template>
删除
</NButton>
<NButton @click="handleExport">
<template #icon>
<NIcon><icon-park-outline:download /></NIcon>
</template>
导出
</NButton>
<NButton type="primary" @click="handleSearch">
<template #icon>
<NIcon><icon-park-outline:search /></NIcon>
</template>
搜索
</NButton>
<NButton @click="handleReset">
<template #icon>
<NIcon><icon-park-outline:refresh /></NIcon>
</template>
重置
</NButton>
</div>
</template>
```
### 错误示例(严格禁止)
```vue
<template>
<div class="page-actions">
<!-- ❌ 错误:使用圆角按钮 -->
<NButton type="primary" round @click="handleAdd">
<template #icon>
<NIcon><icon-park-outline:plus /></NIcon>
</template>
新增
</NButton>
<!-- ❌ 错误:只有文字没有图标 -->
<NButton type="primary" @click="handleAdd">
新增
</NButton>
<!-- ❌ 错误:只有图标没有文字 -->
<NButton type="primary" @click="handleAdd">
<template #icon>
<NIcon><icon-park-outline:plus /></NIcon>
</template>
</NButton>
</div>
</template>
```
### 参考标准页面
- ✅ 用户管理页面:`src/views/system/user/index.vue`
- ✅ 角色管理页面:`src/views/system/role/index.vue`
- ✅ 菜单管理页面:`src/views/system/menu/index.vue`
### 强制要求检查清单
开发新的表格列表页面时,必须确保:
- [ ] 所有操作按钮都使用标准方形样式(不使用 `round` 属性)
- [ ] 所有按钮都采用图标 + 文字的组合形式
- [ ] 按钮样式与现有页面保持一致
- [ ] 图标选择符合语义化要求
- [ ] 按钮类型和颜色符合项目主题规范
### 严格禁止行为
- ❌ 使用圆角按钮(`round` 属性)
- ❌ 按钮只有图标没有文字
- ❌ 按钮只有文字没有图标
- ❌ 使用与项目标准不一致的按钮样式
- ❌ 忽略参考页面的样式标准
**遵循此规范确保所有表格列表页面具有统一的按钮样式和用户体验!**
## 文档资源
项目包含完整的文档系统: