# 变量输入控件

您可使用变量输入控件（变量输入）来设置变量的值。

信息注释变量输入 作为 Dashboard bundle 的一部分包含在内。 Dashboard bundle 对象有额外的限制，并且可能无法获得与其他可视化相同的支持。有关更多信息，请参阅[Dashboard bundle](https://help.qlik.com/zh-CN/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Visualizations/DashboardBundle/dashboard-bundle.htm)。

[Variable Input](https://play.vidyard.com/HDPoZEThcGVqi9Hs4mbc3i)

## 适合使用它的情况

如果可视化中的表达式包含变量，则可以使用变量输入控件让用户控制变量值。

## 创建变量输入控件

您可以在正在编辑的工作表上创建变量输入控件。

执行以下操作：

1. 在资产面板中，打开 图表。

2. 在仪表板对象下，将一个变量输入对象拖动到工作表。

3. 在属性面板的外观 > Variable（变量）下的 Name（名称）中选择要使用的变量。

4. 在 Show as:（显示为：）中选择您希望如何输入数据

   * Buttons（按钮）让您可以添加许多按钮，定义的每一个变量值对应一个按钮。

     您可以在 Display（显示）中选择如何显示按钮，选择 Row （行）可在水平行中显示它们，或者选择 Column（列）可在垂直列中显示它们。

     您可以使用 Values（值）下的 Fixed or dynamic values（列）设置，采用两种不同的方法定义按钮：固定 (Fixed) 或动态 (Dynamic)。

     如果选择使用固定值，则需要使用 Add Alternative（添加备选项）添加每一个按钮，然后为每一个按钮定义值 (Value) 和标签 (Label)。

     如果使用动态值，则在 Dynamic values（动态值）中使用字符串定义按钮。使用 | 分隔按钮，使用 ~ 分隔值与标签。例如，'Germany~GER|France~FRA' 将创建标签为 GER 和 FRA 的两个按钮。第一个将变量值更改为 Germany，第二个将值更改为 France。如果您要将值用作标签，则不需要指定标签。

   * Drop down（下拉列表）将为定义的每个变量值添加带有一个项的下拉菜单。

     您可以使用 Values（值）下的 Fixed or dynamic values（固定和动态值）设置，采用两种不同的方法定义项：固定 (Fixed) 或动态 (Dynamic)。

     如果选择使用固定值，则需要使用 Add Alternative（添加备选项）添加每一项，然后为每一项定义值 (Value) 和标签 (Label)。

     如果使用动态值，则在 Dynamic values（动态值）中使用字符串定义项。使用 | 分隔项，使用 ~ 分隔值与标签。例如，'Germany~GER|France~FRA' 将创建标签为 GER 和 FRA 的两个项。第一个将变量值更改为 Germany，第二个将值更改为 France。如果您要将值用作标签，则不需要指定标签。

   * Input box（输入框）提供了一个简单输入框，它将会更新变量值。

   * Slider（滑块）将创建一个用于更新变量值的滑块。使用 Values（值）下的 Min（最小值）定义最小设置，使用 Max（最大值）定义最大设置。还可以使用 Step（步长）设置要使用的步长。如果您选择 Slider label（滑块标签），将在拖动滑块时显示选定值。

     当您停止拖动滑块时，将更新变量值，但如果您希望在拖动时更新变量值，您可以选择 Update on drag（在拖动时更新）。当您希望基于变量的可视化在拖动滑块时动态更新，这可能会非常有用。使用此选项时应多加小心，因为持续重绘图表可能会让人讨厌。

## 自定义样式设定

在属性面板中的外观下有大量样式设定按钮可供您使用。

单击外观>演示文稿下的the 样式 icon以进一步自定义图表的样式。 您可以通过单击每个部分旁的 ![重置](https://help.qlik.com/zh-CN/sense/May2026/Subsystems/Hub/Content/Resources/Images/Icons/reset.svg) 重置样式。单击 ![重置](https://help.qlik.com/zh-CN/sense/May2026/Subsystems/Hub/Content/Resources/Images/Icons/reset.svg) 全部重置可重置样式面板中所有可用标签的样式。

有关设置单个可视化样式的常规信息，请参见[将自定义样式应用于可视化](https://help.qlik.com/zh-CN/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Visualizations/style-visualization.htm)。

### 自定义文本

可以在外观 > 常规下设置标题、副标题和脚注的文本。若要隐藏这些元素，请关闭显示标题。

图表上不同标签的可见性取决于特定于图表的设置和标签显示选项。这些可以在属性面板中进行配置。

您可以设置图表中显示的文本的样式。

执行以下操作：

1. 在属性面板中，展开外观部分。

2. 在外观 > 展示下，单击 the 样式 icon。

3. 在常规选项卡上，设置以下文本元素的字体、强调样式、字体大小和颜色：

   * 标题

   * 副标题

   * 脚注

### 自定义背景

可以自定义图表的背景。可以通过颜色和图像来设置背景。

执行以下操作：

1. 在属性面板中，展开外观部分。

2. 在外观 > 展示下，单击 the 样式 icon 。

3. 在样式面板的一般选项卡上，您可以选择背景颜色（单色或表达式）。您也可将背景设置为媒体库或 URL 中的图像。

   使用背景色时，请使用滑块调整背景的不透明度。

   使用背景图像时，可以调整图像大小和位置。

### 自定义边框和阴影

您可以自定义图表的边框和阴影。

执行以下操作：

1. 在属性面板中，展开外观部分。

2. 在外观 > 展示下，单击 the 样式 icon。

3. 在样式面板的常规选项卡上的边框下，调整轮廓大小以增加或减少图表周围的边框线。

4. 选择边框的颜色。

5. 调整拐角半径以控制边框的圆度。

6. 在常规选项卡的阴影下，选择阴影大小和颜色。选择无以移除阴影。

## 创建变量输入控件

您可以在正在编辑的工作表上创建变量输入控件。

执行以下操作：

1. 在资产面板中，打开 图表。

2. 在仪表板对象下，将一个变量输入对象拖动到工作表。

3. 在属性面板的外观 > Variable（变量）下的 Name（名称）中选择要使用的变量。

4. 在 Show as:（显示为：）中选择您希望如何输入数据

   * Buttons（按钮）让您可以添加许多按钮，定义的每一个变量值对应一个按钮。

     您可以在 Display（显示）中选择如何显示按钮，选择 Row （行）可在水平行中显示它们，或者选择 Column（列）可在垂直列中显示它们。

     您可以使用 Values（值）下的 Fixed or dynamic values（列）设置，采用两种不同的方法定义按钮：固定 (Fixed) 或动态 (Dynamic)。

     如果选择使用固定值，则需要使用 Add Alternative（添加备选项）添加每一个按钮，然后为每一个按钮定义值 (Value) 和标签 (Label)。

     如果使用动态值，则在 Dynamic values（动态值）中使用字符串定义按钮。使用 | 分隔按钮，使用 ~ 分隔值与标签。例如，'Germany~GER|France~FRA' 将创建标签为 GER 和 FRA 的两个按钮。第一个将变量值更改为 Germany，第二个将值更改为 France。如果您要将值用作标签，则不需要指定标签。

   * Drop down（下拉列表）将为定义的每个变量值添加带有一个项的下拉菜单。

     您可以使用 Values（值）下的 Fixed or dynamic values（固定和动态值）设置，采用两种不同的方法定义项：固定 (Fixed) 或动态 (Dynamic)。

     如果选择使用固定值，则需要使用 Add Alternative（添加备选项）添加每一项，然后为每一项定义值 (Value) 和标签 (Label)。

     如果使用动态值，则在 Dynamic values（动态值）中使用字符串定义项。使用 | 分隔项，使用 ~ 分隔值与标签。例如，'Germany~GER|France~FRA' 将创建标签为 GER 和 FRA 的两个项。第一个将变量值更改为 Germany，第二个将值更改为 France。如果您要将值用作标签，则不需要指定标签。

   * Input box（输入框）提供了一个简单输入框，它将会更新变量值。

   * Slider（滑块）将创建一个用于更新变量值的滑块。使用 Values（值）下的 Min（最小值）定义最小设置，使用 Max（最大值）定义最大设置。还可以使用 Step（步长）设置要使用的步长。如果您选择 Slider label（滑块标签），将在拖动滑块时显示选定值。

     当您停止拖动滑块时，将更新变量值，但如果您希望在拖动时更新变量值，您可以选择 Update on drag（在拖动时更新）。当您希望基于变量的可视化在拖动滑块时动态更新，这可能会非常有用。使用此选项时应多加小心，因为持续重绘图表可能会让人讨厌。

## 自定义样式设定

在属性面板中的外观下有大量样式设定按钮可供您使用。

单击外观>演示文稿下的the 样式 icon以进一步自定义图表的样式。 您可以通过单击每个部分旁的 ![重置](https://help.qlik.com/zh-CN/sense/May2026/Subsystems/Hub/Content/Resources/Images/Icons/reset.svg) 重置样式。单击 ![重置](https://help.qlik.com/zh-CN/sense/May2026/Subsystems/Hub/Content/Resources/Images/Icons/reset.svg) 全部重置可重置样式面板中所有可用标签的样式。

有关设置单个可视化样式的常规信息，请参见[将自定义样式应用于可视化](https://help.qlik.com/zh-CN/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Visualizations/style-visualization.htm)。

### 自定义文本

可以在外观 > 常规下设置标题、副标题和脚注的文本。若要隐藏这些元素，请关闭显示标题。

图表上不同标签的可见性取决于特定于图表的设置和标签显示选项。这些可以在属性面板中进行配置。

您可以设置图表中显示的文本的样式。

执行以下操作：

1. 在属性面板中，展开外观部分。

2. 在外观 > 展示下，单击 the 样式 icon。

3. 在常规选项卡上，设置以下文本元素的字体、强调样式、字体大小和颜色：

   * 标题

   * 副标题

   * 脚注

### 自定义背景

可以自定义图表的背景。可以通过颜色和图像来设置背景。

执行以下操作：

1. 在属性面板中，展开外观部分。

2. 在外观 > 展示下，单击 the 样式 icon 。

3. 在样式面板的一般选项卡上，您可以选择背景颜色（单色或表达式）。您也可将背景设置为媒体库或 URL 中的图像。

   使用背景色时，请使用滑块调整背景的不透明度。

   使用背景图像时，可以调整图像大小和位置。

### 自定义边框和阴影

您可以自定义图表的边框和阴影。

执行以下操作：

1. 在属性面板中，展开外观部分。

2. 在外观 > 展示下，单击 the 样式 icon。

3. 在样式面板的常规选项卡上的边框下，调整轮廓大小以增加或减少图表周围的边框线。

4. 选择边框的颜色。

5. 调整拐角半径以控制边框的圆度。

6. 在常规选项卡的阴影下，选择阴影大小和颜色。选择无以移除阴影。

## 限制

有关一般限制的信息，请参阅 [限制](https://help.qlik.com/zh-CN/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Visualizations/DashboardBundle/dashboard-bundle.htm#Limitati)。

* 滑块标签只能显示数值。这意味着，如果值为日期，则会显示日期的数值。如果值为百分比值，则不会显示百分比字符。

相关学习:

* [如何配置仪表板捆绑变量输入对象？](https://help.qlik.com/lnk/How_configure_Dashboard_Bundle_Variable_input_object)

## 了解详情

* [如何配置仪表板捆绑变量输入对象？](https://help.qlik.com/lnk/How_configure_Dashboard_Bundle_Variable_input_object)