All Products
Search
Document Center

Quick BI:Tree Drop

Last Updated:Jun 23, 2026

An advanced control for complex data entry forms, commonly used to select cascading options from hierarchical data.

p724550

Scenarios

Use the tree drop-down control to select cascading data from a hierarchy. For example, select a customer region and the corresponding province and city in the region.

Renderings

p724552

Control configuration

Basic parameters

Parameter

Description

p724554

① Display Title: Specifies whether to display the control title. You can customize the display name, which serves as the column name in the data form.

② Control type: After you select a control, you can change the control type. The drop-down options support replacement with other basic and advanced control types.

③ Table Field Name: The name of the corresponding field in the database table created from the data form.

Note

The field or table name must start with a letter and can contain letters, digits, and underscores (_). The name can be up to 40 characters in length.

④ Prompt: The placeholder text displayed in the control. For example, Select.

p504676

⑤ Description: A custom description for the control.

⑥ Description Information Location: The position of the description text. Valid values: Bottom, Right, and Below.

Default State: The initial state of the control. Valid values: Normal, Read-only, and Hidden.

Option

Parameter

Description

Select Data Source from the Source drop-down list. image.png

Source: Select Data Source or Dataset as the data source type.

② Data Source: Select a data source from the drop-down list.

③ Data Table: Select a data table from the drop-down list.

④ Field to be Linked: Select Field to be Linked from the drop-down list.

Note

The levels of the tree drop-down take effect based on the order in which the data fields are added.

p724564

Select Dataset from the Source drop-down list.

image.png

① Source: Select Data Source or Dataset as the data source type.

② Dataset: Select a dataset from the drop-down list.

③ Data Field: Select a data field from the Data Field drop-down list.

image.png

Validation

Parameter

Description

image.png

① Required: Specifies whether the field is required. If you select this option, the control is set to Required.

② Input data invalid prompt text: The custom error message displayed when a validation rule is triggered. For example, if Required is selected and no value is specified, this error message is displayed.

Section

Parameter

Description

单行文本-样式

Widget Width: Set the width to Default or Whole Line.

Note

You can also drag the control border to manually adjust the width.

树形下拉组件宽度