Skip to content

feat(TCascader): 对齐级联面板与公开示例 - #1060

Open
RSS1102 wants to merge 9 commits into
developfrom
rss1102/style/cascader-demo-alignment
Open

feat(TCascader): 对齐级联面板与公开示例#1060
RSS1102 wants to merge 9 commits into
developfrom
rss1102/style/cascader-demo-alignment

Conversation

@RSS1102

@RSS1102 RSS1102 commented Aug 31, 2026

Copy link
Copy Markdown
Collaborator

🤔 这个 PR 的性质是?

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

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

🔗 相关 Issue

Related to #1027

💡 需求背景和解决方案

Cascader 原组件与公开 Demo 未完整覆盖设计稿中的 step/tab、逐级副标题、任意层选择、搜索及受控提交路径,部分视觉值还可能被 Material 隐式默认主题覆盖。

  • TCascader 保持平铺且严格受控:value 是唯一外部状态源,onChanged == null 时禁用;Popup、标题、搜索、草稿、取消与提交继续由调用方组合。
  • 新增可选参数 subtitles,由组件按内部活动层级展示对应副标题,不新增层级 Controller 或第二状态源。
  • 保留 variant 的既有默认值 TCascaderVariant.tab;公开基础示例显式使用 step,选项卡示例显式使用 tab。
  • 修正活动层级、末级路径、不可变 options、选项行与导航尺寸、SafeArea、字体、图标、背景和分隔线;主题解析只接受调用方显式 Material 覆盖,否则回落到 TDesign token。
  • 公开 Demo 对齐为「类型 / 进阶」两组七个实例;自定义 keys 在业务数据进入组件时转换为 TCascaderOption,查看代码展示真实的 TCell + TPopup + TCascader 受控组合及各实例差异配置。
  • TSearchBar 仅在内部 TextField 边界提供透明 Material 上下文;TPopup 相对 develop 无源码差异,不影响 Popup、ActionSheet、Picker、Calendar 的结构和主题。
  • Spec:specs/024-cascader-demo-alignment/spec.md
小程序公开 Demo(375×771) Flutter 3.32 Linux dark Golden(375×1017)
小程序 Cascader Flutter Cascader

验证:Flutter 3.32.0 / latest 严格 analyze、组件与 Demo 回归、APK/iOS/Web 构建全部通过;Flutter 3.32.0 Linux visual regression 通过;Cascader 生产代码覆盖率 248/251 = 98.80%,Search 生产代码覆盖率 193/197 = 97.97%;示例代码生成检查无漂移。

📝 更新日志

  • feat(TCascader): 支持按活动层级展示次级标题,并完善 step/tab、任意层选择和搜索组合示例。

  • fix(TCascader): 修正层级面板的交互、尺寸与主题回退,避免 Material 隐式默认样式覆盖 TDesign 视觉。

  • 本条 PR 不需要纳入 Changelog

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

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

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

@github-actions

github-actions Bot commented Aug 31, 2026

Copy link
Copy Markdown
Contributor

完成

Web Demo

APK 下载

@RSS1102 RSS1102 mentioned this pull request Sep 3, 2026
…ader-demo-alignment

# Conflicts:
#	.cnb/.reusable-stages.yml
#	.github/workflows/test-build.yml
#	tdesign-component/example/test/fonts/README.md
#	tdesign-component/tool/check_component_coverage.dart
#	tdesign-component/tool/run_component_regression.dart
#	tdesign-component/tool/run_visual_regression.dart
…ader-demo-alignment

# Conflicts:
#	.cnb/.reusable-stages.yml
#	.github/workflows/test-build.yml
#	tdesign-component/tool/check_component_coverage.dart
#	tdesign-component/tool/run_component_regression.dart
#	tdesign-component/tool/run_visual_regression.dart
@RSS1102 RSS1102 changed the title docs(TCascader): 对齐公开示例与 Flutter 用法 feat(TCascader): 对齐级联面板与公开示例 Sep 4, 2026
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