| 代号 | view_develop |
版本 | v1 |
| 分类 | 模块开发 | 输出格式 | Markdown |
| 类型 | 系统模板 | ||
指引 AI 按前端规范为实体开发 browse/create/view 等页面
原始模板内容
展开
# 任务:为"{{metamodelName}}"开发视图页面
## 背景信息
- 实体名称:{{metamodelName}}
- 实体代号:{{metamodelCode}}
- 所属模块:{{moduleName}}({{moduleCode}})
## 已有字段
{{fieldSummary}}
## 已有行为
{{behaviorSummary}}
## 已有关系
{{relationSummary}}
## 视图规范
### 目录结构
自定义视图放在实体的 views 目录下:
```
{{moduleCode}}/{{metamodelCode}}/views/
├── browse.ext.php (列表页扩展 - 追加内容)
├── create.ext.php (新增页扩展)
├── update.ext.php (编辑页扩展)
├── view.ext.php (详情页扩展)
├── browse.new.php (列表页整页替换 - 慎用)
└── create.new.php (新增页整页替换 - 慎用)
```
### 视图优先级
1. `.new.php` — 整页替换标准模板
2. displayConfig 模板 — Behavior 中配置的 template
3. 实体自有 `.php` — 实体目录下的标准视图
4. 标准模板回退 — `@common/views/template/index/{action}`
5. no-view-configured 错误页
### 扩展视图(推荐方式)
- `.ext.php` 在标准模板渲染后追加,用 `$this->registerJs()` 注册 JS
- 不使用 `beginBlock()`(在 ext 中不可靠)
### 前端规范
- PC 端使用 Bootstrap 5.3.3(纯 BS5,无第三方主题)
- 资源路径:CSS → `@web/pc/css/`,JS → `@web/pc/js/`
- 禁止内联样式重复,公共样式写框架文件
- 表单统一 JSON 提交(`contentType: 'application/json'`)
- URL 必须带 `.html` 后缀
### UI 规范
- 不使用图标(删除按钮的 trash 图标除外)
- 最多 3 个主色:#0087F7(主), #00A256(成功), #ed4014(危险) + 灰度
- 禁止渐变,纯色
- 按钮:btn-primary(蓝/主操作), btn-warning(黄/次要), btn-danger(红/仅删除), btn-success(绿/引导)
- 禁止 btn-info
## 请求
请根据"{{metamodelName}}"的业务场景和字段定义,开发合适的视图页面。优先使用 `.ext.php` 扩展方式,仅在标准模板无法满足时才使用 `.new.php` 整页替换。