• Introduction
  • Getting Started
  • Vue 2 End of Support
  • Vue Wrappers End of Life
  • Native Components
    • Animation
    • Buttons
    • Chartsupdated
    • Conversational UI
    • Data Tools
    • Date Inputs
    • Dialogs
    • Drawing
    • Dropdowns
    • Editor
    • Excel Export
    • File Saver
    • Form
    • Gauges
    • Gridupdated
    • Icons
    • Indicators
    • Inputsupdated
    • Labels
    • Layout
    • ListBox
    • ListView
    • Notification
    • PDF Processing
    • Popup
    • Progress Bars
    • Scheduler
    • ScrollView
    • Tooltip
    • TreeList
    • TreeView
    • Upload
  • Wrapper Components
  • Sample Applications
  • Styling & Themes
  • Common Features
  • Project Setup
  • Knowledge Base
  • Changelog
  • FAQ
  • Troubleshooting
New to Kendo UI for Vue? Start a free 30-day trial

DropDownTreeProps

Represents the props of the Kendo UI for Vue DropDownTree component.

NameTypeDefaultDescription

accessKey?

string

Specifies the accessKey of the DropDownTree.

adaptive?

boolean

Provides different rendering of the popup element based on the screen dimensions.

adaptiveTitle?

string

Specifies the text that is rendered as title in the adaptive popup.

ariaDescribedBy?

string

Identifies the element(s) which will describe the component, similar to HTML aria-describedby attribute. For example these elements could contain error or hint message.

ariaLabel?

string

Defines the aria-label attribute of the component.

ariaLabelledBy?

string

Identifies the element(s) which will label the component.

className?

string

Sets additional classes to the DropDownTree.

dataItemKey

string

Sets the key for comparing the data items of the DropDownTree (see example). If dataItemKey is not set, the DropDownTree compares the items by reference.

dataItems?

any[]

Sets the data of the DropDownTree (see example).

dir?

string

Represents the dir HTML attribute.

disabled?

boolean

Sets the disabled state of the DropDownTree.

expandField?

string

Specifies the name of the field which will provide a Boolean representation of the expanded state of the item.

fillMode?

string

solid

Configures the fillMode of the DropDownTree.

The available options are:

  • solid
  • flat
  • outline
  • null—Does not set a fillMode className.

filter?

string

Sets the value of filtering input. Useful for making the filtering input a controlled component.

filterable?

boolean

Enables the filtering functionality of the DropDownTree (more information and examples).

any

Defines the slot that will be used for footer (see example).

header?

any

Defines the slot that will be used for header (see example).

id?

string

Specifies the id of the component.

item?

any

Defines the slot that will be used for rendering each of the DropDownTree items (see example).

label?

string

Renders a floating label for the DropDownTree.

listNoData?

any

Defines the slot that will be rendered in the DropDownTree popup when no data is available (see example).

loading?

boolean

Sets the loading state of the DropDownTree (see example).

modelValue?

any

name?

string

Specifies the name property of the input DOM element.

onBlur?

(event: DropDownTreeBlurEvent) => void

Fires each time the DropDownTree gets blurred.

onChange?

(event: DropDownTreeChangeEvent) => void

Fires each time the value of the DropDownTree is about to change (see examples).

onClose?

(event: DropDownTreeCloseEvent) => void

Fires each time the popup of the DropDownTree is about to close.

onExpandChange?

(event: any) => void

Fires when the expanding or collapsing of an item is requested (see examples).

onFilterChange?

(event: DropDownTreeFilterChangeEvent) => void

Fires each time the user types in the filter input (see example). You can filter the source based on the passed filtration value.

onFocus?

(event: DropDownTreeFocusEvent) => void

Fires each time the user focuses the DropDownTree.

onOpen?

(event: DropDownTreeOpenEvent) => void

Fires each time the popup of the DropDownTree is about to open.

opened?

boolean

Sets the opened state of the DropDownTree.

placeholder?

string

The hint that is displayed when the DropDownTree is empty.

popupSettings?

DropDownsPopupSettings

Configures the popup of the DropDownTree.

required?

boolean

Specifies if null is a valid value for the component.

rounded?

string

medium

Configures the roundness of the DropDownTree.

The available options are:

  • small
  • medium
  • large
  • full
  • null—Does not set a rounded className.

selectField?

string

Specifies the name of the field which will provide a Boolean representation of the selected state of the item.

size?

string

medium

Configures the size of the DropDownTree.

The available options are:

  • small
  • medium
  • large
  • null—Does not set a size className.

subItemsField?

string

Specifies the name of the field which will provide an array representation of the item subitems. Defaults to 'items'.

tabIndex?

number

Specifies the tabIndex of the DropDownTree.

textField

string

Sets the data item field that represents the item text (see example).

valid?

boolean

Overrides the validity state of the component. If valid is set, the required property will be ignored.

validationMessage?

string

Controls the form error message of the component. If set to an empty string, no error will be thrown.

validityStyles?

boolean

If set to false, no visual representation of the invalid state of the component will be applied.

value?

any

Sets the value of the DropDownTree (see example). It can be an object from the data-tree.

valueMap?

(value: any) => any

Represents a callback function, which returns the value for submitting. The returned value will be rendered in an option of a hidden select.

class App extends React.Component {
   render() {
      return (
         <form>
             <DropDownTree
                 data={[ { text: "Austria", id: 1 } , { text: "Belarus", id: 2 } ]}
                 valueMap={value => value && value.id}
             />
             <button type="submit">Submit</button>
         </form>
      );
   }
}
ReactDOM.render(<App />, document.querySelector('my-app'));

valueRender?

any

Defines the slot that will be used for rendering the selected value (see example).