Skip to content

docs(dropdown-menu): 补齐官方示例矩阵 - #1034

Open
RSS1102 wants to merge 1 commit into
developfrom
rss1102/cnb-issue-78/docs/dropdown-menu-official-demos
Open

docs(dropdown-menu): 补齐官方示例矩阵#1034
RSS1102 wants to merge 1 commit into
developfrom
rss1102/cnb-issue-78/docs/dropdown-menu-official-demos

Conversation

@RSS1102

@RSS1102 RSS1102 commented Aug 18, 2026

Copy link
Copy Markdown
Collaborator

🤔 这个 PR 的性质是?

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

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

🔗 相关 Issue

💡 需求背景和解决方案

DropdownMenu 的锚点、滚动跟随与自动方向能力已完整,但示例页未公开展示官方 1/2/3 列多选、纯禁用菜单、向上展开与自定义开合图标场景,示例分组也较零散。本次仅改动 Example 层:

  • 将示例重组为 01 组件类型 / 02 组件状态 / 03 Flutter 额外能力 三组,按场景归类。
  • 多选示例新增单列/双列/三列(columns: 1/2/3,面板 maxHeight: 280)。
  • 新增纯禁用菜单(复用现有 enabled: false)。
  • 新增向上展开 + 自定义开合图标(复用现有 placement: TDropdownMenuPlacement.aboveTDropdownMenuItem.custom)。

实现复用现有公开 API,未改动组件源码与公开 API,无 breaking change。对应 Spec:specs/011-dropdown-menu-official-demos/

验证与待办(如实说明):Flutter 3.32.0 聚焦测试与分析通过、组件生产源码 LCOV ≥95%、生成片段与源码同步;Flutter latest 聚焦测试与分析通过,但既有组件用例存在一处非本次改动的 0.93px 几何断言差异(原容差 0.5px)尚未处理。真机/像素与官方截图对照、新 Demo 的 Golden 快照,以及勾选默认位置/空选行为/全局最大高度等公开契约的维护者决策,均仍待完成。

📝 更新日志

  • docs(dropdown-menu): 示例新增 1/2/3 列多选、禁用与向上展开自定义图标场景,并重组示例分组

  • 本条 PR 不需要纳入 Changelog

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

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

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

@github-actions

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