Container
Constrain and center a reading or application column.
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.
<view>
<Column class="example">
<Checkbox label="Use a narrower content column" model:checked={narrow} />
<Box class="surface">
<Container style={Style::new().max_width(Size::Px(content_width.get().unwrap_or(640.0)))} class="sample">
<Text text="Container centers this content within the outer Box." />
</Container>
</Box>
</Column>
</view>
<rust>
use inrux::prelude::*;
let narrow: Signal<bool> = Signal::new(false);
let content_width_narrow = narrow.clone();
let content_width: Computed<f32> = Computed::new(move || {
if content_width_narrow.get() {
320.0
} else {
640.0
}
});
</rust>
<style scoped>
.example {
padding: 24px;
gap: 16px;
}
.surface {
padding: 16px;
background: #f5f5f5;
}
.sample {
padding: 16px;
background: #fff0e8;
}
</style>
API Reference
Props
This component has no component-specific props. It accepts these common attributes:
| Prop | Type | Default | Description |
|---|---|---|---|
id | String-like expression | Not set | Style-selector identity; independent of retained mount identity. |
class | String-like expression | Not set | Whitespace-separated stylesheet classes. |
style | Style | Not set | Explicit Rust style overrides for this node. |
key | String-like expression | Not set | Retained sibling identity; preserve it while reordering children. |
width | Size | Component style | Explicit width constraint; otherwise use the resolved style. |
height | Size | Component style | Explicit height constraint; otherwise use the resolved style. |
padding | f32 | Component style | Uniform padding in logical pixels; otherwise use the resolved style. |
gap | f32 | Component style | Child 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
| Event | Payload | Description |
|---|---|---|
| — | — | No component events are emitted. |
Behavior
Container adds a width cap and automatic inline margins. Use an outer Box for application gutters. The mounted root has no parent to distribute its margins, so place Container within the root surface.
Styling and limits
Override the cap through max-width or Style::max_width. Padding counts toward the constrained width. CSS margin-inline: 0 removes automatic centering.
Read the detailed reference for validation and native integration details. The playgrounds include a working Container specimen with its surrounding state and reset controls.