Compose 调用层参数设计规范(基于默认值复用原则)

Compose 调用层参数设计规范(基于默认值复用原则)

一、核心设计思想

如果一个属性在大多数情况下都不变,就不应该在每个页面都去设置它。

  • 调用层(Page/Screen)职责:仅填充业务内容,不配置UI细节。
  • 中间层职责:完成通用UI配置后,调用层应"保持沉默",仅传递差异化数据。

通俗类比:订购笔记本电脑

层级 角色 核心行为
结构层 工厂模具 定义屏幕位置、键盘位置等基础布局规则
中间层 产品经理 定义默认银色、默认16G内存、默认带充电器等通用配置
调用层 消费者 场景A(标准版):仅说"我要一台"(无差异化数据);场景B(定制版):仅说"我要32G内存"(仅传差异化数据)

二、代码写法对比

前提

UserInfoCard 中间层已配置默认背景、默认图标、默认样式。

1. 坏的写法(未利用默认值)

调用层重复传递通用UI配置,代码臃肿且难以维护:

kotlin 复制代码
// 调用层
UserInfoCard(
    title = "陈奕迅",
    backgroundImage = R.drawable.ic_mine_login, // 每次都要传
    titleRightDrawable = IconRes(R.drawable.svg_tag_vip), // 每次都要传
    bottomRightDrawable = IconRes(R.drawable.svg_arrow), // 每次都要传
    padding = 16.dp // 甚至还要传间距
)
2. 好的写法(仅传差异化数据)

场景A:最基础的展示(仅传核心业务数据)

kotlin 复制代码
// 只需要传 title,因为除了 title,别的卡片都长一样
UserInfoCard(title = "陈奕迅") 

场景B:超级VIP用户(仅传差异化图标)

kotlin 复制代码
// 只有"图标"是和别人不一样的(差异化),所以只传图标
UserInfoCard(
    title = "周杰伦",
    titleRightDrawable = IconRes(R.drawable.svg_tag_super_vip) 
)

三、核心优势

  1. 代码可读性:调用层可直接体现卡片的业务重点(如"该卡片的特殊之处是超级VIP图标")。
  2. 降低改版成本:若需修改通用配置(如所有卡片默认背景图),仅需修改中间层一个默认值,全App所有调用处自动生效;若调用层重复传参,则需修改所有调用位置。

总结

  1. 调用层应遵循"最小传参原则",仅传递与默认配置不同的差异化数据。
  2. 通用UI配置(背景、图标、间距等)统一在中间层通过默认参数定义,避免调用层重复配置。
  3. 该设计可提升代码可读性,大幅降低UI改版时的维护成本。
相关推荐
芜名氏4 天前
API 文档生成工具——SpringDoc
java·spring boot·ci/cd·设计规范
Easyhood7 天前
Android 开发入门实践(十四):Compose 副作用入门与四个常用 API
android·开发语言·kotlin·android jetpack·compose
女神下凡11 天前
芯参谋(95):嵌入式文件系统_开发指南
linux·服务器·arm开发·驱动开发·设计规范
工业HMI实战笔记15 天前
印刷电路板HMI:SMT贴装的元件定位界面
制造·设计规范·设计语言·1024程序员节
女神下凡15 天前
芯参谋(85):Linux_PPI_NAND_驱动开发指南
linux·运维·arm开发·驱动开发·单片机·嵌入式硬件·设计规范
Autumn_ing15 天前
Pixso AI 如何按团队设计规范生成 UI?以消息设置页说明选库与验收
人工智能·ui·设计规范·pixso
女神下凡17 天前
芯参谋(87):Linux 系统(SPI NOR)驱动开发指南
linux·运维·arm开发·驱动开发·嵌入式硬件·设计规范
女神下凡18 天前
芯参谋(83):AliOS Things_驱动开发指南
arm开发·驱动开发·单片机·嵌入式硬件·设计规范·1024程序员节
工业HMI实战笔记18 天前
皮革加工HMI:制革鞣制的化工参数界面
信息可视化·设计规范·设计语言