Skip to content

breaking(tabbar): 收敛底部标签栏设计与公开契约 - #1085

Open
RSS1102 wants to merge 6 commits into
developfrom
rss1102/breaking/tabbar-design-alignment
Open

breaking(tabbar): 收敛底部标签栏设计与公开契约#1085
RSS1102 wants to merge 6 commits into
developfrom
rss1102/breaking/tabbar-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

💡 需求背景和解决方案

TabBar 将内容类型、选项选中样式、容器外形和图文布局分离;公开 Demo 包含三个分组、九个四项标签栏实例及七个代码入口。

  • variant 拆分为 type/itemStyle/style/layoutuseVerticalDivider 更名为 splitvalue/onChanged 管理受控选择,Theme 只保存子树视觉默认值。
  • 修复 nullable Theme 插值产生透明色和无边线覆盖的问题;文字默认值低于显式主题,局部字体配置不覆盖状态颜色。共享解析器只对组合 defaults 使用字段级来源解析。
  • 弹出菜单捕获触发位置的局部主题,菜单行不遮盖面板背景;滚动后菜单定位在触发标签上方。
  • 修复 none/linear/elastic 动态切换的位置失步和中断动画跳变;Demo 状态由页面 State 持有,打开代码不会重置选择。双层级初始选中“我的”,菜单为“基本信息/个人主页/设置”。
  • TTabBarItemWithBadge/PopRoute/PopupDialog/PopupDialogState/PanelWithDownArrow 私有化;调用方应使用 TTabBar 与公开菜单配置组合,不依赖内部路由和绘制实现。

Spec 与证据:行为契约分轮验收记录浅色整页深色整页浅色菜单展开深色菜单展开

本轮本地验证:Flutter 3.32.0/3.47.0 TabBar/Text/工具 67/67,Demo 5 项与实际七个核心片段编译通过,两版本严格 analyze 零问题。TabBar 覆盖率 518/531(97.55%),Text 219/222(98.65%)。Linux 3.32.0 组件明暗原基线 14/14;整页与菜单展开明暗 4/4 严格复跑,无像素容差。

设计参考:固定 Figma 节点。本轮未重跑移动设备逐像素对照或 release build;历史设备和构建证据不代替当前验证。远端 CI 与新一轮 CNB Review 以推送后的新 head 为准。

📝 更新日志

  • breaking(tabbar): 将 variant 拆分为 typeitemStylestylelayout,将 useVerticalDivider 更名为 split,移除 Theme 中的行为与结构选择器

  • breaking(tabbar): 不再公开内部徽标适配项、弹层路由、弹层状态与绘制器,请使用 TTabBar 和公开菜单配置组合

  • feat(tabbar): 支持横向图文布局并完善文本、徽标、双层级与胶囊示例

  • fix(tabbar): 修复局部文字主题、菜单主题与面板背景覆盖以及空值主题插值问题

  • fix(tabbar): 修复指示器动画模式切换和连续切换时的位置跳变

  • 本条 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 下载

…abbar-design-alignment

# Conflicts:
#	tdesign-component/example/lib/base/example_widget.dart
#	tdesign-component/example/test/fonts/README.md
#	tdesign-component/tool/component_test_manifest.dart
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