本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# Canvas
<a name="v10-panels-canvas"></a>

****  
本文档主题专为支持 **Grafana 10.x 版本**的 Grafana 工作区而设计。  
有关支持 Grafana 版本 12.x 的 Grafana 工作空间，请参阅。[在 Grafana 版本 12 中工作](using-grafana-v12.md)  
对于支持 Grafana 9.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 9](using-grafana-v9.md)。  
对于支持 Grafana 8.x 版本的 Grafana 工作区，请参阅[使用 Grafana 版本 8](using-grafana-v8.md)。

画布将 Grafana 的强大功能与自定义元素的灵活性相结合。画布是可扩展的表单构建面板，允许在静态和动态布局中显式放置元素。这使您能够以标准 Grafana 面板无法实现的方式设计自定义可视化和叠加数据，所有这些都在 Grafana 的 UI 中完成。如果您使用过流行的 UI 和 Web 设计工具，那么设计画布面板会感觉非常熟悉。

## 元素
<a name="v10-panels-canvas-elements"></a>

您可以在画布上添加这些元素。通过添加多种不同类型的元素，您可以以任何其他可视化无法实现的方式自定义可视化。

**指标值**

指标值元素让您可以轻松选择要在画布上显示的数据。此元素具有独特的*编辑*模式，可通过上下文菜单**编辑**选项或双击面板来触发。在编辑模式下，您可以选择要显示的字段数据。

**文本**

文本元素使您能够轻松地向画布添加文本。该元素还支持编辑模式，可通过双击或上下文菜单中的编辑菜单选项触发。

**椭圆**

椭圆元素允许您在画布上添加一个基本的椭圆。椭圆元素可以显示文本（固定数据和字段数据），其背景颜色可以根据数据阈值进行更改。

**矩形**

通过矩形元素，您可以在画布上添加基本的矩形。矩形元素可以显示文本（固定数据和字段数据），其背景颜色可以根据数据阈值进行更改。

**图标**

通过图标元素，您可以将支持的图标添加到画布。可根据阈值或值映射来设置图标的颜色。

**服务器**

服务器元素让您可以轻松表示单个服务器、服务器堆栈、数据库或终端。服务器元素支持状态颜色、灯泡颜色和灯泡闪烁率，所有这些都可通过固定值或字段值来配置。

**Button**

您可以通过按钮元素在画布上添加基本按钮。按钮元素支持触发未经验证的基本 API 调用。API 设置可在按钮元素编辑器中找到。您也可以在 API 编辑器中传递模板变量。

**注意**  
只有在禁用内联编辑时，选择按钮才会触发 API 调用。请参阅[画布编辑](#v10-panels-canvas-editing)。

## Connections
<a name="v10-panels-canvas-connections"></a>

在构建画布时，您可以将元素连接在一起，以创建更复杂的可视化效果。您可以通过从一个元素的连接锚点拖动到另一个元素的连接锚点，来创建连接。您也可以创建与画布背景的连接。当您将鼠标悬停在元素上并打开内联编辑时，会显示连接锚点。要删除连接，请选择该连接，然后按 `Delete` 或 `Backspace`。

您可以根据固定值或字段值设置连接的大小和颜色。为此，请进入面板编辑模式，选择连接，然后在面板编辑器中修改连接的属性。

## 画布编辑
<a name="v10-panels-canvas-editing"></a>

**内联编辑器**

您可以在控制面板模式的上下文中内联编辑画布。

**平移和缩放**

您可以在画布上打开平移和缩放功能。这让您可以创建和浏览更复杂的设计。

**注意**  
Grafana Labs 目前提供平移和缩放预览版。支持有限，并且在正式发布之前可能会发生重大更改。

**上下文菜单**

通过上下文菜单，您可以快速高效地执行常见任务。支持的功能包括打开和关闭内联编辑器、复制元素、删除元素等。

右键单击面板（或等效操作）或给定画布元素会触发上下文菜单。

右键单击*面板*时，您可以设置背景图像，轻松地向画布添加元素。

右键单击*元素*时，您可以编辑、删除和复制该元素，或者修改元素的图层位置。

## 画布选项
<a name="v10-panels-canvas-options"></a>

**内联编辑**

内联编辑开关让您可以锁定或解锁画布面板。关闭后，画布面板将处于*锁定*状态，将元素冻结在原位并防止意外修改。

**数据链接**

画布支持[数据链接](v10-panels-configure-data-links.md)。您可以按照以下步骤为指标值元素创建数据链接，并在使用该字段名称的所有元素中显示。

**为元素创建数据链接**

1. 设置要绑定到字段值的元素。

1. 关闭内联编辑开关。

1. 为**带有名称的字段**创建覆盖，然后从列表中选择元素字段名称。

1. 选择 **\+ 添加覆盖属性**按钮。

1. 从列表中选择**数据链接 > 数据链接**。

1. 选择 **\+ 添加链接**，为数据链接添加标题和 URL。

1. 将鼠标悬停在元素上可显示数据链接工具提示。

1. 选择能够打开数据链接的元素。

如果多个元素使用相同的字段名称，而您又想控制哪些元素显示数据链接，可使用 [从计算添加字段](v10-panels-xform-functions.md#v10-panels-xform-funcs-add) 转换创建唯一字段名称。您在转换中创建的别名将显示为可与元素一起使用的字段。