SuperAPI AI 工具集

fluentui

前端与建站

查看项目

更新于 10-16 00:32

技能介绍

用途:在 VS Code Webview 中使用 FluentUI React v9 组件时提供经过验证的项目模式与经验,重点解决工具栏溢出、布局约束和样式集成问题。

主要能力:覆盖 Toolbar、Overflow、Menu、Button、Dialog 等组件的使用模式;针对 Overflow 与 Toolbar 提供布局约束、CSS Grid 与 Flexbox 选择、分隔线与优先级排序、调试清单等参考(见 references/OVERFLOW_PATTERNS.md)。还包含 MessageBar 多行布局的处理方式。

文档查询:FluentUI 提供 LLM 兼容文档,可用 fetch_webpage 获取。组件索引为 https://storybooks.fluentui.dev/react/llms.txt,单个组件文档为 https://storybooks.fluentui.dev/react/llms/components-{name}.txt,例如 components-overflow.txt、components-toolbar.txt、components-menu-menu.txt、components-button-button.txt。遇到不熟悉的组件应先查阅其文档。

关键用法:Overflow 通过测量子元素 clientWidth 决定隐藏项,因此子元素(通常是 Toolbar)必须设置 flex-wrap: nowrap; min-width: 0; overflow: hidden。与固定元素并排时应使用 CSS Grid(grid-template-columns: auto minmax(0, 1fr)),而非 Flexbox。OverflowItem 的 priority 越高越晚隐藏。菜单项需拆成独立组件以调用 useIsOverflowItemVisible。

常见陷阱:不要在 OverflowItem 子元素上写内联 display 样式,应使用 CSS 类并显式覆盖 &[data-overflowing] { display: none; };Overflow 不渲染包装元素;Toolbar 已由 Griffel 添加 display: flex 和 align-items: center。

适用场景:在 Webview 中新增或修改带溢出行为的工具栏、调试 FluentUI 布局/样式/测量问题、处理溢出菜单按钮渲染异常、以及将使用 Griffel 的组件与 SCSS 样式表集成。

限制:资料未提供完整代码示例、版本兼容范围与平台限制说明,暂未提供。