---
order: 3
navTitle: 输入框
---
# 仪表板组件-输入框

输入框可以对输入的字段进行筛选。如表格和输入框搭配使用，实现对企业名称的筛选。

![srk](./images/srk.gif)

示例地址：[输入框](https://demo.succbi.com/v5/bi/%E6%98%8E%E7%BB%86%E8%A1%A8\(%E4%BC%81%E4%B8%9A%E5%9F%BA%E6%9C%AC%E4%BF%A1%E6%81%AF%E8%A1%A8\))

## 输入框实现 {#achieve}

输入框的**字段**取一个维度或度量，如企业名称、经营范围等。

**操作步骤**

![srk](./images/srksl.gif)

1. 拖入输入框，将【企业名称】字段双击或拖入到**属性栏**>**数据**中，默认勾选自动过滤
2. **匹配模式**设置：输入框会根据输入的字段类型进行模式匹配。当输入框中的字段类型为字符型时，对字段进行模糊[匹配](#匹配模式)；当输入框中输入的字段类型为数值型时，对字段进行数值大小[匹配](#匹配模式)

通过上述2个步骤，即可实现输入框对企业名称进行筛选。

## 输入框属性{#attribute}

可以对输入框的默认值、输入提示、自动过滤等进行设置，此外，还可以对**字体**、**背景**、**内边距**等样式进行自定义。

![输入框属性](./images/2020-09-02-15-42-44.png)

- **默认值**：默认的筛选条件设置，可以写固定值或者表达式
- **输入提示**：对输入框中的文字提示进行设置。当输入框内容为空时，显示输入提示信息。
- **自动过滤**：勾选后可通过输入的内容对组件的数据进行过滤，默认勾选。自动过滤可以设置**影响范围**、**作用数据源**和**匹配模式**。若不勾选**自动过滤**，则可以在需要进行数据过滤的组件中，添加[过滤](../../design/data/data-filter/README.md)条件
  - **影响范围**：影响范围可设置为全部或者指定的图表
  - **作用数据源**：作用数据源可设置为当前数据源或者关联数据源

### 匹配模式{#match}

勾选**自动过滤**之后，可以对输入框的匹配模式进行设置。输入框的匹配模式和输入框中的字段类型有关，字符型和数值型对应不同的匹配模式。

![匹配模式](./images/2020-09-14-13-54-17.png)

- 当输入框中输入的字段类型为字符型时，对字段进行模糊匹配，有以下几种方式：
  - **包含**：匹配出包含输入框中内容的数据，字符型时的默认匹配方式为**包含**
  - **开头为**：匹配出开头为输入框中内容的数据
  - **结尾为**：匹配出结尾为输入框中内容的数据
  - **精确匹配**：匹配出和输入框中内容完全一致的数据

- 当输入框中输入的字段类型为数值型时，对字段进行数值大小匹配，有以下几种方式：
  - **等于**：匹配出等于输入框中内容的数据，数值型时的默认匹配方式为**等于**
  - **大于**：匹配出大于输入框中内容的数据
  - **小于**：匹配出小于输入框中内容的数据

### 多行输入{#multiline}

当输入的文字内容较多时，可设置多行输入，超过宽度的文字会换行显示。

![多行输入](./images/2020-09-14-13-45-30.png)