---
order: 6
---
# 参数栏

常用的报表会需要一些条件筛选出对应的数据，参数栏就是用来放置这些筛选条件的，如在参数栏放置一个时间的下拉框筛选出对应时间的数据，放置这些筛选条件的方式有两种：

- 将参数组件拖入参数栏，并设置组件的相关属性
- 将[模型字段](../../../data-gov/GLOSSARY.md#data-model)拖入到参数栏，参数栏会根据字段的类型生成对应输入组件，比如拖入`销售日期`字段到参数栏，会自动生成日期组件

![设置](./images/2021-11-04-16-43-34.gif)

示例地址：[单向分组](https://demo.succbi.com/v5/demo/%E5%8D%95%E5%90%91%E5%88%86%E7%BB%84)

## 布局设置{#layout}

参数栏支持设置其内部布局，点击参数栏的空白处，在设计器的右侧栏显示的**属性栏**>**内部布局**处可以设置。

![内部布局](./images/2021-11-02-18-35-04.png)

- **对齐方式**：控制参数栏中各组件的对齐方式，如`左对齐`，`水平居中`，`右对齐`。未勾选**与表体对齐**属性时参照画布对齐，勾选**与表体对齐**属性后参照表体对齐
- **行间距**：设置参数栏内组件的行间距，参数组件换行可以使用[换行符](https://docs.succapp.com/v5/rpt/component/warp)组件
- **与表体对齐**：勾选表示参数栏内的组件与表体对齐，与表体对齐的方式在**对齐方式**属性中设置

## 样式设置{#style}

参数栏同样支持样式设置，包括填充与内边距，具体介绍如下：

- **填充**：在**属性栏**>**填充**可以设置参数栏的填充效果，包括`无填充`、`颜色填充`、`图片填充`
- **内边距**：在**属性栏**>**内边距**可以设置参数栏的内边距

## 设置打开报表时显示表体内容{#initializtion}

想要打开报表后查询结果自行加载，或只有在点击了查询按钮后才加载查询结果，就可以在**属性栏**>**高级**处进行设置。具体属性介绍如下：

![高级](./images/2021-11-02-18-36-46.png)

- **初始化时查询**：默认勾选，勾选表示打开报表后查询结果自行加载出来，不勾选时需要搭配`查询`按钮使用，只有在点击了查询按钮后才加载查询结果。如：[横向嵌套分组](https://demo.succbi.com/v5/demo/%E6%A8%AA%E5%90%91%E5%B5%8C%E5%A5%97%E5%88%86%E7%BB%84)
- **修改参数时查询**：默认勾选，表示修改参数栏中组件的值会加载查询结果，比如修改时间下拉框中的选中时间，报表会加载出该时间的查询结果

## 相关文档{#docs}

- 输入组件自带过滤功能，设置自动过滤属性后，系统会自动根据输入组件指定的字段过滤数据，更多信息可以查看[下拉框](../../components/input/combobox.md)文档
- 在报表的右侧属性栏中，也提供了过滤功能，在过滤器中也可以实现数据筛选，更多信息可以查看[过滤器](../data/README.md#filter)文档
- 参数栏组件的默认值可以通过设置参数动态控制，也可以通过URL传递参数值控制组件的默认值，更多信息可以查看[参数](../../../data-viz/dash/design/data/param.md#url-param)文档
- 参数栏中下拉框可实现参数联动，如大区-省-市-门店联动，在选择了某大区后，省的下拉列表中只会显示该大区对应的省，以及市和门店也只显示对应根节点下的数据，更多信息可以查看[下拉框](../../components/input/combobox.md)文档