# 表单布局样式模板

`form layout init --style-template <名|id>` 用这些模板初始化布局。

## ⚠ 流式和表格式是**两套独立模板**，不能混用

同一个名字在两套里往往是**不同的 id**（紧凑版 / 轻便版 / 碧海蓝天 / 极简白 / 极简淡蓝 /
清新蓝绿 / 商务蓝 / 淡雅丁香 两套都有），而且各自还有对方没有的模板。所以**解析模板名必须
先知道表单的布局类型**。

| 表单布局 | 接口 | 内置模板数 |
|---|---|---|
| 流式 `FLOW` | `/api/form/flow/template/list` | 24（本环境另有若干用户导入的） |
| 表格式 `EXCEL` | `/api/form/form/layout/template/listTemplateAdvancedByPage` | 20 |

**拿错一套不会报错**——平台收到一个不属于该布局类型的 id，直接忽略；命令照常打印"已初始化"，
样式却纹丝不动。这是最容易踩的坑：改了没效果，还以为模板名写错了。

CLI 已按布局类型自动选接口并校验：传了不属于当前布局那一套的名字或 id 会直接报错，并列出该
布局类型下可用的模板。

## 用法

```bash
# 按名字（按当前表单的布局类型实时解析，推荐）
e10-cli form layout init <objId> <appId> --style-template 碧空如洗

# 按 id（同样会校验它属于当前布局那一套）
e10-cli form layout init <objId> <appId> --style-template 830000000000000022

# 不传则用该布局类型的缺省模板：流式=标准版、表格式=表格版
e10-cli form layout init <objId> <appId>

# 指定视图 + 只读/必填
e10-cli form layout init <objId> <appId> --view-id <viewId> --style-template 紧凑版 --read-only
```

## 内置模板

> 模板列表**按租户动态**（用户可以自行导入模板，本环境流式那套就多出十几个带「(导入)」的
> 副本），**以命令输出为准**；下表是验证环境的内置项，供参考。

### 流式（FLOW）

| styleTemplateId | 模板名 |
|---|---|
| `820000000000000001` | 标准版（**缺省**） |
| `820000000000000002` | 标准版（无表头） |
| `820000000000000011` | 表格版 |
| `810000000001000004` | 轻量设置版 |
| `810000000001000001` / `002` / `003` | 分区卡片版 1 / 2 / 3 |
| `830000000000000010` | 紧凑版 |
| `830000000000000011` | 轻便版 |
| `830000000000000012` | word版 |
| `830000000000000015` / `016` / `017` | 轻量紫 / 轻量白 / 轻量蓝 |
| `830000000000000018` | 简约瀑布流 |
| `830000000000000019` | 半透蒙版 |
| `830000000000000021` | 碧海蓝天 |
| `830000000000000022` | 碧空如洗 |
| `830000000000000023` | 淡雅丁香 |
| `830000000000000024` | 极简白 |
| `830000000000000025` | 极简淡蓝 |
| `830000000000000026` | 简洁现代 |
| `830000000000000027` | 清新蓝绿 |
| `830000000000000028` | 深蓝商务 |
| `830000000000000029` | 商务蓝 |

### 表格式（EXCEL）

| styleTemplateId | 模板名 |
|---|---|
| `700000000000000007` | 标准版 |
| `700000000000000008` | 表格版（**缺省**，生成的 comps 默认只读） |
| `700000000000000009` | 紧凑版 |
| `700000000000000010` | 轻便版 |
| `830421425497325568` | 靛青线条 |
| `830662158415355904` | 简约深蓝 |
| `830714355284320256` | 极简淡蓝 |
| `830718787623460864` | 现代简约 |
| `830722618751066113` | 商务淡蓝 |
| `830743788745531393` | 极简白 |
| `830749075757998081` | 极简灰 |
| `830751622581329920` | 清新蓝绿 |
| `830764108161785857` | 淡蓝水晶 |
| `830765800429674496` | 银光浅灰 |
| `831747419499700225` | 暗夜流光 |
| `831759140499447809` | 公文样式 |
| `831897833480421377` | 淡雅丁香 |
| `917557790734188546` | 商务蓝 |
| `933871446777094145` | 碧海蓝天 |
| `1000599952745676801` | 青蓝冰水 |

## 注意

- 模板只影响**布局样式**（间距/边框/配色），不影响字段的 readOnly/required（这俩由 `--read-only`/`--required` 或 fields.json 控制）。
- `表格版`（EXCEL 008）历史问题：生成的 comps 默认 readOnly=true。`form layout init` 会显式按 `--read-only`（默认 false 可编辑）覆盖，所以即使用 008 也能可编辑。
- 建表（`form create`）时**不能**指定样式模板，只能建完再 `form layout init --style-template` 换。