SearchField QML Type

This property holds the clear indicator.

This property holds the index of the currently selected suggestion in the popup list.

The default value is -1 when count is 0, and 0 otherwise.

See also activated(), text, and highlightedIndex.

This property holds a delegate that presents an item in the search field popup.

It is recommended to use ItemDelegate (or any other AbstractButton derivatives) as the delegate. This ensures that the interaction works as expected, and the popup will automatically close when appropriate. When other types are used as the delegate, the popup must be closed manually. For example, if MouseArea is used:

delegate: Rectangle {
    // ...
    MouseArea {
        // ...
        onClicked: searchField.popup.close()
    }
}

This property holds the model that provides delegate instances for the search field.

It is typically assigned to a ListView in the contentItem of the popup.

This property holds the index of the currently highlighted item in the popup list.

When the highlighted item is activated, the popup closes, currentIndex is updated to match highlightedIndex, and this property is reset to -1, indicating that no item is currently highlighted.

See also highlighted() and currentIndex.

This property holds a boolean value that determines whether the search is triggered on every text edit.

When set to true, the searchTriggered() signal is emitted on each text change, allowing you to respond to every keystroke. When set to false, the searchTriggered() is only emitted when the user presses the Enter or Return key.

See also searchTriggered().

This property holds the popup.

The popup can be opened or closed manually, if necessary:

onSpecialEvent: searchField.popup.close()

This property holds the search indicator.

This property holds the number of suggestions to display from the suggestion model.

This property holds the data model used to display search suggestions in the popup menu.

SearchField {
    textRole: "age"
    suggestionModel: ListModel {
        ListElement { name: "Karen"; age: "66" }
        ListElement { name: "Jim"; age: "32" }
        ListElement { name: "Pamela"; age: "28" }
    }
}

See also textRole.

This property holds the current input text in the search field.

Text is bound to the user input, triggering suggestion updates or search logic.

See also searchTriggered() and textEdited().

This property holds the model role used to display items in the suggestion model shown in the popup list.

When the model has multiple roles, textRole can be set to determine which role should be displayed.

This signal is emitted when the user confirms their input by pressing the Enter or Return key.

This signal is typically used to trigger a search or action based on the final text input, and it indicates the user's intention to complete or submit the query.

See also searchTriggered().

This signal is emitted when the item at index is activated by the user.

An item is activated when it is selected while the popup is open, causing the popup to close (and currentIndex to change). The currentIndex property is set to index.

See also currentIndex.

This signal is emitted when the item at index in the popup list is highlighted by the user.

The highlighted signal is only emitted when the popup is open and an item is highlighted, but not necessarily activated.

See also highlightedIndex.

This signal is emitted when a search action is initiated.

It occurs in two cases: 1. When the Enter or Return key is pressed, it will be emitted together with accepted() signal 2. When the text is edited and if the live property is set to true, this signal will be emitted.

This signal is ideal for initiating searches both on-demand and in real-time as the user types, depending on the desired interaction model.

See also accepted() and textEdited().

This signal is emitted every time the user modifies the text in the search field, typically with each keystroke.

See also searchTriggered().