Skip to content

Tree-Select

Description

Tree-select refers to a special type of dropdown menu element used in forms, presenting information in a hierarchical, tree-like structure.

Unlike a standard dropdown menu with a flat list of options, a tree-select organizes options into parent-child relationships, letting users navigate through nested categories to find the specific choice they need.

Use Case

  1. Nesting levels
  2. Multiple selection
  3. Improved organization
  4. Visual clarity
  5. User-friendly navigation
  6. Enhanced accessibility
  7. Project breakdown structure
  8. Issue categorization
  9. Resource allocation
  10. Data Aggregation and Filtering

Interactivity

  1. Integrate a search bar within the tree-select. As users type, highlight matching options across all levels, dynamically filtering the displayed nodes.
  2. Contextual suggestions
  3. Show previews of selected options or additional information when hovering over nodes.
  4. Based on the chosen branch or category in the tree, show or hide additional fields in the form.
  5. Perform calculations based on user selections within the tree-select.
  6. Enable multiple users to collaboratively choose options in the tree-select and leave annotations or comments on specific nodes.

API

Events

Name Description
onChange (element) The onChange event occurs when the value of an field is changed
onFocus (element) The onfocus event occurs when an field gets focus
onBlur (element) The onblur event occurs when an field loses focus

Methods

Name Description Parameters
this.addClassName Add style class to a form item (fields: String|String[], className: String)
this.hide Hides the field (fields: String|String[])
this.show Displays the field (fields: String|String[])
this.disable Disable tree-select field from user interaction (fields: String|String[])
this.enable Enable tree-select field from user interaction (fields: String|String[])
this.setData Set the data in the field. The Value object should be of type { componentId: componentValue } (Value: Object)

Info

  1. The show() and hide() methods can also be used to control the visibility of the tree-select component in response to user input.
  2. Fields refers to a component ID or a list of component IDs. You can fetch the ID from the Component Attribute panel in the Page Builder.
  3. Before using this.show(fields), make sure the component is hidden. This can be done using this.hide(fields) or by enabling the Hidden checkbox in the Component Attribute panel.
  4. Before using this.enable(fields), make sure the component is disabled. This can be done using this.disable(fields) or by enabling the Disabled checkbox in the Component Attribute panel.

Steps to use the methods for the Page Builder components

  1. Go to Form Attribute Action Panel Setting (Mounted | refresh | click 'Add action').
  2. Write the method/code as shown in the Example below.
  3. Click on Save.
  4. On the main screen click on Save again.
  5. Click on Preview to see the code in action.

Example

  1. this.addClassName(fields, className)

    • Go to Form Attribute Style Sheets add the class
      .abc{ // abc is the class name
      background-color: red;
      }
      
    • Follow the steps mentioned above, under Steps to use the methods for the Page Builder components
    • this.addClassName('treeselect_4xgiru3n', 'abc')
  2. this.hide(fields)

    var fields= ['treeselect_4xgiru3n']
    this.hide(fields)
    

  3. this.show(fields)

    var fields= ['treeselect_4xgiru3n']
    this.show(fields)
    

  4. this.disable(['fields'])

    this.disable(['treeselect_4xgiru3n'])
    

  5. this.enable(['fields'])

    this.enable(['treeselect_4xgiru3n'])
    

  6. this.setData(Value)

    this.setData(
    {"treeselect_4xgiru3n": "Option 2",})
    

Config

Name Description Icon
ID The tree-select component's unique identifier
Name [Optional] The display name of the Tree-select field
Width [Optional] Width of the field
Label Width Width of the label associated with an input field. It determines the horizontal space occupied by the label text
Label Wrap If the label is longer than the allowed width the text will continue on another line
Hide Label Hides the label on the form
Placeholder The short hint is displayed in the input field before the user enters a value
Text Prompt A description to aid the user when completing the field
Multiple Allows users to choose multiple options from different branches or levels within the tree-select structure
Searchable Allows users to search the from the options
Optional any Node users can choose any node from any level within the tree, including child nodes
Option Choose either Static or Dynamic way of adding data to the options of the Tree Select

Static data refers to a fixed set of options that are pre-defined and loaded into the Tree Select at the time of initialization

Dynamic data are options fetched as needed from sources like databases or APIs. The Tree Select updates choices based on user selections. You select from Data source which refers to the origin of the data; Function which refers to the code that manipulates the data, and Assigned Value which refers to the specific value stored or associated with a data element
Default Value The default value which is filled in the field before the user changes it
Custom Class An HTML class attribute which allows further customisation See Form Attribute > Style Sheets
Attribute Action Enable Data Binding to connect the data to UI.
Enable Hidden action to hide the field.
Enable Disabled action to make the field unusable.
Enable Show Clear button action to make the clear button visible.
Action Settings Click on the drop-down to select the pre-defined methods you wish to apply to your component. In this case, you can choose either mounted or refresh for onChange, onFocus, or onBlur

First time User?

If you are using the Page Builder components on the ConnexCS platform for the first time, we request you to use our guide on steps to use the Components.