Skip to content

breaking(TSwitch): 独立加载状态并收敛示例 - #1050

Merged
RSS1102 merged 5 commits into
developfrom
rss1102/style/switch-miniprogram-alignment
Aug 26, 2026
Merged

breaking(TSwitch): 独立加载状态并收敛示例#1050
RSS1102 merged 5 commits into
developfrom
rss1102/style/switch-miniprogram-alignment

Conversation

@RSS1102

@RSS1102 RSS1102 commented Aug 23, 2026

Copy link
Copy Markdown
Collaborator

🤔 这个 PR 的性质是?

勾选规则:
1.只要有新增参数,就勾选”新特性提交“
2.只修改内部bug,未新增参数,才勾选”日常 bug 修复“
3.其他选项视具体改动判断

  • 日常 bug 修复
  • 新特性提交
  • 文档改进
  • 演示代码改进
  • 组件样式/交互改进
  • CI/CD 改进
  • 重构
  • 代码风格优化
  • 测试用例
  • 分支合并
  • 其他

🔗 相关 Issue

Related: #1027

💡 需求背景和解决方案

TSwitch 原先通过 TSwitchVariant.loading 同时表达内容样式和加载状态,导致 variant 承担两类语义。本次将加载状态收敛为独立的 loading 参数,并同步整理公开 Demo 的分组、状态和尺寸展示。

  • 新增 final bool loading,默认值为 false;加载时显示加载指示器并禁用交互。
  • TSwitchVariant 仅保留 filledtexticon 三种内容样式。
  • loadingvariant 同时设置时,加载状态临时覆盖滑块内容;加载结束后恢复对应 variant
  • onChanged == null 仍是普通禁用状态的唯一入口,不新增 disableddefaultValuecustomValue
  • 公开 Demo 按“组件类型 / 组件状态 / 组件样式”组织,复用 ExamplePageExampleModuleTCellGroup,未修改 ExampleItem 或新增公共示例组件。
  • 同步公开 dartdoc、API 生成产物、示例代码片段及 Spec 014

迁移方式:

// Before
TSwitch(
  value: value,
  variant: TSwitchVariant.loading,
  onChanged: onChanged,
)

// After
TSwitch(
  value: value,
  loading: true,
  onChanged: onChanged,
)

验证结果:

  • Switch 组件测试 15 项通过,生产源码行覆盖率 341/358 = 95.25%
  • Switch Demo 测试 4 项通过,Demo 行覆盖率 49/49 = 100%
  • light/dark Golden 均已提交,并在不带 --update-goldens 的模式下完成比对。
  • tdesign-componentexampleflutter analyze 均为 0 issues。
  • Flutter 3.32.0 与 latest 的 analyze、test、APK、Web 共 8 项 CNB CI 均通过。
  • Android 16 实机已重新安装并运行最新示例。
Light Dark
Switch light Demo Switch dark Demo

📝 更新日志

  • breaking(TSwitch): 将加载状态迁移为独立的 loading 参数,移除 TSwitchVariant.loading

  • 本条 PR 不需要纳入 Changelog

☑️ 请求合并前的自查清单

⚠️ 请自检并全部勾选全部选项⚠️

  • 标题遵循 Conventional Commits 格式:type(<scope>?): 修改描述
    示例:fix(TBottomTabBar): 修复 iconText 模式底部溢出
  • “相关 Issue”处带上修复的 Issue 链接或无关联 Issue
  • 已添加对应的 Spec 链接,或已由 Review 确认本次改动无需 Spec
  • 相关文档已补充或无须补充

@github-actions

github-actions Bot commented Aug 23, 2026

Copy link
Copy Markdown
Contributor

完成

Web Demo

APK 下载

@RSS1102 RSS1102 changed the title style(TSwitch): 对齐小程序示例分组与状态展示 breaking(TSwitch): 独立加载状态并收敛示例 Aug 26, 2026
@RSS1102
RSS1102 merged commit 2a9460c into develop Aug 26, 2026
17 checks passed
@RSS1102
RSS1102 deleted the rss1102/style/switch-miniprogram-alignment branch August 26, 2026 13:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant