Microsoft Fabric 项目发布要求

本文档概述了Microsoft Fabric 工件（特定于工作负荷的工件）的所有发布要求。

常规要求

项命名、图标和基本元数据的一般要求

1.1 - 项目具有明确的名称

项目必须具有明确的描述性显示名称，可帮助用户了解其用途和类型。 不能使用泛型名称（例如 AI、代理人等），除非它们包含指示专业、公司或产品的前缀或后缀。

阶段要求：

参考：

• 项清单
• 如何创建项
• Fabric UX 系统

1.2 - 项目有清晰的图标

项必须提供一个清晰、可识别的图标，以直观方式表示 Fabric 接口中的项类型

阶段要求：

参考：

• 项清单
• Fabric UX 系统
• Microsoft Fabric 视觉对象工具包

指引：

UX：

文件类型图标由容器和内部 Fluent 系统图标组成。 有 3 个通用形状：垂直、水平和方形。 某些内部图标在特定形状中效果更好，所以请探索哪个形状是最佳的。

此网格模板显示我们使用的大小：20/24/ 32/ 40 / 48 / 64 对于工作区，工作负荷 L2 页和卡片使用 24x24px 大小。

内部图标应居中位于容器内。 如果图标由仅/大部分笔划组成，并且需要更多权重，则可以调整为 1.5 像素的重量。 容器内图标尺寸的常规参考：

• 20px 容器中的 12px
• 在宽度为 24px 的容器中有一个宽度为 14px 的元素
• 32px 容器中的 20px
• 40px 容器中的 24px
• 48px 容器中的 28px
• 36px 在 64px 容器中

确保内部图标尽可能居中。 除非另有说明，否则所有图标均用 1px 笔划绘制。 项图标必须遵循图标创建准则，以便跨 Fabric 平台保持一致性。

1.2.1 - 项目具有清晰的活动图标

项目必须提供不同的活动状态图标，以指示何时选定或处于焦点状态。

阶段要求：

参考：

• 项清单
• Fabric UX 系统
• Microsoft Fabric 视觉对象工具包
• Fabric UX 系统

1.3 - 项目在“创建”菜单中具有清晰的标题

项必须在“创建”菜单中显示一个清晰的标题，该标题与项的显示名称匹配，以便保持一致性

阶段要求：

参考：

• 项清单
• 如何创建项

1.4 - 项目在“创建”菜单中具有清晰的副标题

项目必须在“创建”菜单中提供简洁、信息丰富的副标题，用于描述项目的用途或关键功能

阶段要求：

参考：

• 项清单
• Fabric UX 系统

1.5 - 项目可在“新”菜单中收藏

项目必须支持“新建”菜单中的偏爱功能，以允许用户快速访问常用项

阶段要求：

参考：

• 如何创建项
• 项清单
• Fabric UX 系统

项目创建流程

项目创建体验和工作区集成的要求

2.1 - 项目创建体验

项创建流必须遵循 Fabric 设计准则，为用户提供一致的直观体验

阶段要求：

参考：

• 如何创建项
• 项清单
• 项目概念
• Fabric UX 系统

2.2 - 可以在 Creation Hub 中创建项

项目必须能够通过 Fabric 创建平台进行集中管理和创建。

阶段要求：

参考：

• 如何创建项
• 项清单
• 项目概念
• Fabric UX 系统

2.3 - 可以在“工作区”菜单中创建项

项必须可用于通过工作区“+新建”菜单创建上下文项

阶段要求：

参考：

• 如何创建项
• 项清单
• 项目概念
• Fabric UX 系统

2.4 - 配置平台创建体验

项创建必须使用 Fabric 的默认命名体验（Product.json中的 createItemDialogConfig）。 自定义项创建流已弃用，如果使用它们应避免生成默认名称以防止工作区混乱

阶段要求：

参考：

• 如何创建项
• 项清单
• 项目概念
• Fabric UX 系统

2.5 - 项目保存于工作区中

创建项在创建完成后必须立即保存，并在工作区中显示。

阶段要求：

参考：

• 项目概念
• 如何存储项定义

2.6 - 项位于多任务菜单中并支持该行为

项目必须显示在多任务菜单中，并支持无缝地在多个打开的项之间进行切换

阶段要求：

参考：

• 项目概念
• 项清单
• Fabric UX 系统

2.7 - 项目创建在 *.powerbi.com 和 *.fabric.microsoft.com 下生效

项目创建必须在 powerbi.com 和 fabric.microsoft.com 域上正确运行，以实现跨平台支持的目的。

阶段要求：

功能区和工具栏

项目编辑器的功能区和工具栏要求需遵循设计准则

3.1 - 条目编辑器功能区存在

项目编辑器必须使用一个功能区界面来实现，以确保在整个 Fabric 中提供一致的用户体验。 此功能区应包括项目编辑所需的所有操作和控件，并且必须固定在画布上方。 功能区选项卡不能用于切换视图。

阶段要求：

参考：

• 项目概念
• Fabric UX 系统
• Microsoft Fabric 视觉对象工具包
• Fabric 模板

指引：

UX：

项目编辑器必须使用一个功能区界面来实现，以确保在整个 Fabric 中提供一致的用户体验。 此功能区应包括项目编辑所需的所有操作和控件，并且必须固定在画布上方。 功能区选项卡不能用于切换视图。

3.2 - 项目编辑器功能区的动作与样式指南保持一致

项目编辑器功能区操作必须使用处于微妙状态的Fabric按钮组件。 任何其他组件应最大高度为 32 像素

阶段要求：

参考：

• 项目概念
• Fabric UX 系统
• Microsoft Fabric 视觉对象工具包
• 文档

指引：

UX：

项目编辑器功能区操作必须使用处于微妙状态的Fabric按钮组件。 任何其他组件应最大高度为 32 像素。

3.2.10 - 项目编辑器功能区提示 - 遵循样式指南

Ribbon 工具提示必须遵循 Fabric 准则中的内容、时间控制和位置安排，以帮助用户理解。

阶段要求：

参考：

• 项目概念
• Fabric UX 系统
• Microsoft Fabric 视觉对象工具包
• 文档

指引：

UX：

3.3 - 项编辑器功能区具有“开始”选项卡

项目编辑器功能区必须包含“开始”选项卡作为主编辑器页面。 它还必须称为“首页”，并在功能区中成为第一个选项卡。 这是用户打开项目编辑器时首先登陆的位置。 选项卡只用于切换功能区控件，不能用于切换画布。

阶段要求：

参考：

• 项目概念
• Fabric UX 系统
• Microsoft Fabric 视觉对象工具包
• 文档

指引：

UX：

项目编辑器功能区必须包含“开始”选项卡作为主编辑器页面，它还必须称为“主页”，并且是功能区中的第一个选项卡。 这是用户打开物品编辑器时首先进入的界面。

3.4 - 项编辑器功能区实现保存按钮/自动保存

项编辑器应提供显式保存功能或自动保存以防止数据丢失

阶段要求：

参考：

• 项目概念
• Fabric UX 系统
• Microsoft Fabric 视觉对象工具包
• 文档

指引：

UX：

项编辑器应实现用户数据保护的保存按钮或自动保存功能。 按钮仅为图标。

3.6 - 项编辑器功能区颜色 - 遵循样式指南

功能区颜色必须使用批准的颜色标记和主题支持来遵循 Fabric 样式准则。 示例：当表状态变为“表消除”时，表格的颜色将从灰色变为红色。

阶段要求：

参考：

• 项目概念
• Fabric UX 系统
• Microsoft Fabric 视觉对象工具包
• 文档

指引：

UX：

3.7 - 项目编辑器功能区排版 - 遵循样式指南

Ribbon 字体样式必须使用 Fabric 批准的字体、大小和粗细以确保文本显示一致。

阶段要求：

指引：

UX：

3.8 - 项编辑器功能区提升 - 遵循样式指南

功能区提升（阴影/深度）必须遵循 Fabric 准则来保持适当的视觉分层

阶段要求：

参考：

• 项目概念
• Fabric UX 系统
• Microsoft Fabric 视觉对象工具包
• 文档

指引：

UX：

3.9 - 项目编辑器功能区的边框半径 - 遵循样式指南

功能区边框半径必须遵循 Fabric 指南，以确保圆角样式一致。

阶段要求：

参考：

• 项目概念
• Fabric UX 系统
• Microsoft Fabric 视觉对象工具包
• 文档

指引：

UX：

3.10 - 项目编辑器栏的间距和布局 - 遵循风格指南

功能区的间距和布局必须使用 Fabric 认可的填充、边距和网格系统，以确保视觉一致性。

阶段要求：

参考：

• 项目概念
• Fabric UX 系统
• Microsoft Fabric 视觉对象工具包
• 文档

指引：

UX：

功能区的间距和布局必须使用 Fabric 认证的填充、边距和网格系统以实现视觉一致性。 按钮功能区的间距和布局：如果将按钮放在彼此旁边，应使用 0px 间距。 在按钮之间添加边框线时，左侧和右侧使用 4px 间距。 如果放置不同的组件（例如下拉列表）在它们之间使用 4px 间距。

画布和编辑器

项目画布和编辑器 UI 组件的要求

4.1 - 画布边框 - 遵循样式指南

画布边框样式必须遵循 Fabric 颜色、宽度和边框半径指南

阶段要求：

参考：

• 项目概念
• Fabric UX 系统
• Microsoft Fabric 视觉对象工具包
• 文档

指引：

UX：

画布边框样式必须遵循 Fabric 颜色、宽度和边框半径准则。 画布必须根据 Fabric 设计标准实现适当的边框样式。

4.2 - 颜色 - 遵循样式指南

画布颜色应遵循使用语义颜色标记和主题支持的 Fabric 样式准则

阶段要求：

参考：

• 项目概念
• Fabric UX 系统
• Microsoft Fabric 视觉对象工具包
• 文档
• Fabric 模板

指引：

UX：

画布颜色应遵循 Fabric 样式指南，并使用语义色彩标记和主题支持。 画布颜色必须遵循 Fabric 设计系统颜色准则，以确保一致性。

4.3 - 空状态 - 遵循样式指南

如果存在空状态（推荐），它应遵循 Fabric 指南，为用户提供有用的信息和清晰的操作。

阶段要求：

参考：

• 项目概念
• Fabric UX 系统
• Microsoft Fabric 视觉对象工具包
• 文档

指引：

UX：

如果存在空状态（建议），应遵循 Fabric 指南，为用户提供有用的信息和明确的操作。 画布必须正确实现空状态，以在不存在内容时指导用户。

4.4 - 左抽屉 - 遵循样式指南

如果存在左抽屉面板，则应遵循 Microsoft Fabric 设计系统关于宽度、动画和内容组织的准则。

阶段要求：

参考：

• 项目概念
• Fabric UX 系统
• Microsoft Fabric 视觉对象工具包
• 文档

指引：

UX：

如果存在左侧抽屉面板，则应遵循 Fabric 设计准则中的宽度、动画和内容组织规定。 画布可以为其他导航或工具实现左抽屉。

4.5 - 底部抽屉 - 遵循样式指南

如果底部抽屉面板存在，则应遵循 Fabric 关于高度、动画和内容组织的指导原则。

阶段要求：

参考：

• 项目概念
• Fabric UX 系统
• Microsoft Fabric 视觉对象工具包
• 文档

指引：

UX：

如果底部抽屉面板存在，则应遵循 Fabric 的高度、动画和内容组织设计准则。 画布可以通过实现底部抽屉来增加其他功能。

4.6 - 选项卡 - 遵循样式指南

选项卡组件应遵循 Fabric 指南来设置样式、交互和活动状态指示

阶段要求：

参考：

• 项目概念
• Fabric UX 系统
• Microsoft Fabric 视觉对象工具包
• 文档

指引：

UX：

选项卡组件应遵循 Fabric 指南来设置样式、交互和活动状态指示。 画布可以实现选项卡来组织编辑器中的内容。

4.7 - 切换控件 - 遵循样式指南

如果存在切换控件，则应该遵循 Fabric 的大小、颜色和交互行为准则。

阶段要求：

参考：

• 项目概念
• Fabric UX 系统
• Microsoft Fabric 视觉对象工具包
• 文档

指引：

UX：

如果存在 Switch/toggle 控件，则应遵循 Fabric 大小、颜色和交互行为的准则。 画布可以实现用于切换功能的开关控件。

4.8 - Canvas Center 控件 - 遵循设计规范

中心抽屉界面面板应遵循 Fabric 的宽度、动画和内容组织准则。

阶段要求：

参考：

• 项目概念
• Fabric UX 系统
• Microsoft Fabric 视觉对象工具包
• 文档

指引：

UX：

导航

在项视图和级别之间导航的要求

5.1 - 多级导航

如果使用画布级别（L1 到 L2）之间的多级导航，则必须遵循 Fabric 转换、痕迹导航和后退导航指南

阶段要求：

参考：

• 项目概念
• Fabric UX 系统
• Microsoft Fabric 视觉对象工具包
• 文档

指引：

UX：

弹出对话框

遵循设计准则的弹出对话框和模态窗口的要求

6.1 - 弹出对话框 - 遵循样式指南

如果使用弹出对话框，则它们必须遵循 Fabric 样式指南中关于模态行为、背景和关闭模式的准则。

阶段要求：

参考：

• 项目概念
• Fabric UX 系统
• Microsoft Fabric 视觉对象工具包
• 文档

指引：

UX：

6.1.5 - 边框半径 - 遵循样式指南

对话框边框半径必须遵循 Fabric 设计规范，以便在所有模态窗口上实现一致的圆角样式。

阶段要求：

参考：

• 项目概念
• Fabric UX 系统
• Microsoft Fabric 视觉对象工具包
• 文档

指引：

UX：

6.2 - 颜色 - 遵循样式指南

对话框颜色需要遵循 Fabric 设计准则，使用语义颜色标记来设置背景、文本和边框。

阶段要求：

参考：

• 项目概念
• Fabric UX 系统
• Microsoft Fabric 视觉对象工具包
• 文档

指引：

UX：

6.3 - 版式 - 遵循样式指南

对话框版式必须使用 Fabric 批准的字体、大小和层次结构来用于标题、正文文本和操作。

阶段要求：

参考：

• 项目概念
• Fabric UX 系统
• Microsoft Fabric 视觉对象工具包
• 文档

指引：

UX：

6.4 - 提升 - 遵循样式指南

为确保合适的视觉层次，对话框层次必须遵循 Fabric 准则，并位于页面内容上方。

阶段要求：

参考：

• 项目概念
• Fabric UX 系统
• Microsoft Fabric 视觉对象工具包
• 文档

指引：

UX：

6.6 - 间距和布局 - 遵循样式指南

对话框间距和布局必须使用 Fabric 批准的填充、边距和内容组织模式

阶段要求：

参考：

• 项目概念
• Fabric UX 系统
• Microsoft Fabric 视觉对象工具包
• 文档

指引：

UX：

其他 UX 要求

其他要求，包括监视、设置和上下文菜单

7.1 - 监视中心集成

项目可选择与 Fabric Monitoring Hub 集成，以暴露作业执行和性能数据

阶段要求：

参考：

• 定义项目任务
• 项概念

7.2 - 工作区中的操作需要正常运行

如果使用工作区中的操作，则所有项目的操作（重命名、删除、共享等）必须正常工作。

阶段要求：

参考：

• 项目清单

7.3 - 试用体验

项目应提供示例或试用体验，以帮助用户在提交购买之前浏览功能。

阶段要求：

参考：

• 如何添加试用体验
• Fabric 模板

指引：

UX：

7.4 - 盈利体验

项目应提供示例或试用体验，以帮助用户在提交之前浏览功能

阶段要求：

参考：

• 如何将业务盈利化
• Fabric 模板

指引：

UX：

7.5 - 要完成的作业

项目应在清单中定义作业类型，以便启用作业跟踪和监控集成。

阶段要求：

参考：

• 如何添加要完成的作业
• 项清单

7.6 - 使用项设置

应遵循 Fabric 模式实现供用户配置的设置面板的项目或条目。

阶段要求：

参考：

• 项目明细表
• 如何添加自定义设置
• 项目概念

7.7 - 自定义项目动作

项目应为工作区中的项目定义自定义操作。 所有操作在定义后都需要正常运行。

阶段要求：

参考：

• 物品清单

其他信息

版本历史记录

自动生成此文档。

由 Microsoft Fabric 工作负荷验证系统生成
© 2025 Microsoft公司。 保留所有权利。