Skip to content

Center

Center a group within available free space.

On this page

Available with egui, Masonry and GPUI through the same public component API. Platform input and accessibility coverage still have alpha limits.

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.

src/App.iru
<view>
    <Column class="example">
        <Checkbox label="Use a taller preview" model:checked={tall} />
        <Center height={Size::Px(preview_height.get().unwrap_or(120.0))} class="sample">
            <Text text="Centered on both axes" width={Size::Content} />
        </Center>
    </Column>
</view>
<rust>
use inrux::prelude::*;

let tall: Signal<bool> = Signal::new(true);
let preview_height_tall = tall.clone();
let preview_height: Computed<f32> = Computed::new(move || {
    if preview_height_tall.get() {
        240.0
    } else {
        120.0
    }
});
</rust>
<style scoped>
.example {
    padding: 24px;
    gap: 16px;
}
.sample {
    background: #f5f5f5;
    border-radius: 8px;
}
</style>

API Reference

Props

This component has no component-specific props. It accepts these common attributes:

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
——No component events are emitted.

Behavior

Center aligns the main and cross axes. Vertical centering needs free height. A child with explicitly filled width cannot move horizontally; use automatic or bounded width when that is your intent. Multiple children form one vertical group.

Styling and limits

Set the containing dimensions and child widths deliberately. Center does not resize an explicitly filled child merely to create empty space.

Read the detailed reference for validation and native integration details. The playgrounds include a working Center specimen with its surrounding state and reset controls.

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