Skip to content

breaking(TSideBar): 收敛侧边栏设计与公开契约 - #1083

Open
RSS1102 wants to merge 1 commit into
developfrom
rss1102/breaking/sidebar-design-alignment
Open

breaking(TSideBar): 收敛侧边栏设计与公开契约#1083
RSS1102 wants to merge 1 commit into
developfrom
rss1102/breaking/sidebar-design-alignment

Conversation

@RSS1102

@RSS1102 RSS1102 commented Sep 5, 2026

Copy link
Copy Markdown
Collaborator

🤔 这个 PR 的性质是?

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

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

🔗 相关 Issue

关联 #1027 中“导航 / SideBar 侧边栏”组件任务。

💡 需求背景和解决方案

现有 SideBar 的结构样式和高度同时由实例与 Theme 提供,默认宽度及公开 Demo 的数据、Badge、内容布局与当前移动端设计不一致。

  • TSideBarVariant 收敛为 line / tagstyle 为非空实例结构状态;新增默认 103 的 widthheight 继续由实例持有。
  • TSideBarThemeData 移除 style / height;Theme 只保留颜色、文字样式和内边距,解析优先级为实例 > Theme > TDesign Token。
  • 每项补齐 selected/enabled/label 语义,disabled 项不响应点击;默认标签使用 Body Large Token。
  • 公开 Demo 使用 10 项、默认第二项、第二项圆点/第三项数字 8,以及标题 + 48dp 圆角方图的纵向列表;保留锚点、切页禁用、图标与 tag 四条可操作路径。
  • Spec:SideBar 设计与公开契约收敛
入口浅色 锚点浅色 tag 深色
SideBar page light SideBar anchor light SideBar tag dark

本地验证:组件 43/43、Demo 8/8;生产覆盖率 232/232 = 100%;Flutter 3.32 Linux 的入口、锚点、tag 共 6 个 light/dark 严格 Golden 更新后无更新参数复跑通过并逐张核对;Flutter 3.32.0 / 3.47.0 analyze 零诊断,功能测试及 Web/Android 构建通过;Android 16 真机完成 uppercase Hot Restart、四条可见操作、integration 1/1、普通 APK 安装 Success 与冷启动。

📝 更新日志

  • breaking(TSideBar): 结构样式重命名为 line / tag,并移除 Theme 中的 styleheight 状态入口

  • breaking(TSideBar): 默认宽度调整为 103,并新增实例 width 覆盖入口

  • fix(TSideBar): 公开 Demo 补齐 10 项纵向图文、Badge、锚点、禁用、图标与 tag 操作状态

  • 本条 PR 不需要纳入 Changelog

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

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

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

@RSS1102 RSS1102 mentioned this pull request Sep 5, 2026
@github-actions

github-actions Bot commented Sep 5, 2026

Copy link
Copy Markdown
Contributor

完成

Web Demo

APK 下载

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