2.4 KiB
2.4 KiB
页面风格仅影响 UI 设计
背景
当前项目生成时，stylePreset 不只写入颜色、圆角、阴影等视觉 token，还会在 PageCompositionService.applyStylePreset() 中覆盖页面 canvas。这会导致用户选择“卡片门户”“高密后台”“分类浏览”后，页面布局从表格、卡片、分栏等结构之间切换。
用户期望页面风格只影响 UI 观感，不影响页面布局。布局应继续由页面类型、字段语义、字段数量、图片字段、分类字段等业务特征自动判断。
目标
stylePreset可以影响视觉 token：颜色、强调色、背景、边框、文字色、圆角、阴影、内容宽度、密度等。stylePreset不再覆盖canvas。- 同一组页面输入在不同风格下应得到同一个
canvas。 - 生成结果仍保留
layout.stylePreset、layout.styleTokens和composition.stylePreset，方便模板渲染不同 UI 风格。
非目标
- 不移除前端页面上的“页面风格”选项。
- 不改变页面设计器的组件能力。
- 不改变自动布局算法本身。
- 不重做模板视觉样式，只调整风格选择与布局选择的边界。
设计
PageCompositionService 仍先调用 chooseLayout() 生成布局决策。之后如果传入 stylePresetCode，只解析 preset 并写入布局 JSON 的视觉字段，不再调用会修改 decision.canvas 的覆盖逻辑。
PageStylePresetRegistry 可以继续保留风格 token 和密度信息。和 canvas 相关的映射不再由页面组合服务消费；如果清理范围可控，可以删除 registry 内的 canvas 映射方法，避免未来误用。
测试改为覆盖新的不变量：
- 前台普通列表选择
card_portal后，canvas仍保持自动布局判断出的frontend-list-v1，同时写入stylePreset=card_portal和styleTokens。 - 后台普通列表选择
data_dense后，canvas仍保持自动布局判断出的admin-list-v1，同时写入stylePreset=data_dense。 - registry 测试聚焦 token、density、非法 code 回退，不再断言风格会返回某个 canvas。
验证
运行后端相关单元测试：
PageCompositionServiceStylePresetTestPageStylePresetRegistryTest
必要时补跑包含页面设计初始化的一键生成相关测试，确认 stylePreset 仍能从前端请求传到页面布局 JSON。