ComboBox

import { ComboBox } from "std-widgets.slint";
export component Example inherits Window {
    width: 100px;
    height: 100px;
    background: transparent;
    ComboBox {
        x: 5px; y: 5px;
        width: 100px;
        model: ["first", "second", "third"];
        current-value: "first";
    }
}

slint

A button that, when clicked, opens a popup to select a value.

Properties

current-index

int(in-out)default: 0

The index of the selected value.

ComboBox {
    model: ["first", "second", "third"];
    current-index: 1;
}

slint

current-value

string(in-out)default: ""

The currently selected text.

Note

To change the selection from host code (Rust, C++, JavaScript, Python), write to current-index. Writes to current-value are not supported — they don’t change the selection. The visible state continues to reflect model[current-index].

enabled

booldefault: true

Defaults to true. When false, the combobox can’t be interacted with

has-focus

bool(out)

Set to true when the combobox has keyboard focus.

model

[string]default: []

The list of possible values

ComboBox {
    model: ["first", "second", "third"];
}

slint

Note

When setting this property, the ComboBox will try to preserve the current-index. If the current-index is larger than the new model length, it is set to the last item in the model.

Callbacks

selected(string)

A value was selected from the combo box by the user. The argument is the currently selected value.

ComboBox {
    model: ["first", "second", "third"];
    selected(value) => {
        debug("Selected value: ", value);
    }
}

slint