Skip to content

Select

Choose a controlled string value from options.

On this page

Usage

Replace src/App.iru in a scaffolded project with this complete file, then run cargo run. Keep the scaffold's main.rs and build.rs; this file includes its state, handlers and scoped styles. Use an egui project for this example.

src/App.iru
<view>
    <Column class="example">
        <Text text="Performance profile" />
        <Select model:value={profile} options={vec!["Eco".into(), "Balanced".into(), "Fast".into()]} />
        <Text text={format!("Selected: {}", profile)} />
        <Button text="Reset profile" @click={reset} class="action" />
    </Column>
</view>
<rust>
use inrux::prelude::*;

let profile: String = "Balanced".into();

/// Replace the controlled selection with one of the declared options.
fn reset(state: &mut State, _: &Context<State>) {
    state.profile = "Balanced".into();
}
</rust>
<style scoped>
.example {
    padding: 24px;
    gap: 16px;
}
.action {
    background: #b84200;
    color: white;
    padding: 12px;
    border-radius: 6px;
}
.action:hover {
    background: #913400;
}
.action:focus-visible {
    border-width: 2px;
    border-color: #262626;
}
</style>

API Reference

Props

PropTypeDefaultDescription
valueString-like expressionRequired without model:valueControlled selected value.
model:valueretained field: String or Signal<String>Not setTwo-way selected-value binding; use instead of value.
optionsVec<String>RequiredOwned list of selectable values.
disabledboolfalsePrevent selection changes.

Common props

PropTypeDefaultDescription
idString-like expressionNot setStyle-selector identity; independent of retained mount identity.
classString-like expressionNot setWhitespace-separated stylesheet classes.
styleStyleNot setExplicit Rust style overrides for this node.
keyString-like expressionNot setRetained sibling identity; preserve it while reordering children.
widthSizeComponent styleExplicit width constraint; otherwise use the resolved style.
heightSizeComponent styleExplicit height constraint; otherwise use the resolved style.
paddingf32Component styleUniform padding in logical pixels; otherwise use the resolved style.
gapf32Component styleChild spacing in logical pixels; otherwise use the resolved style.

“Component style” means the attribute is omitted and the normal style cascade supplies the value. Application styles can override framework defaults.

Emits

EventPayloadDescription
@changeStringSelected value. Required without a model; a model listener runs after assignment.

Bind events with @event={handler}. Ordinary handlers receive &mut State and &Context<State>; controlled value handlers can also receive the listed payload. With model:value or model:checked, the setter runs before the optional model listener, which reads the updated state. Stateless children forward a typed Emit<T>.

Behavior and limits

Use a String/Signal model or value with @change; options is an owned Vec. disabled prevents changing the value. Use the egui Engine playground for the current popup and keyboard behavior. Do not treat this prototype as a portable combobox.

Choose the egui facade feature to use it. Read the backend support matrix before changing engines. Common style support does not add missing overlay/animation services to another backend.

Inrux · Built with Nuxt Content, IPEX, and Akaza UI.