cranpose_ui/widgets/
column.rs

1//! Column widget implementation
2
3#![allow(non_snake_case)]
4
5use cranpose_core::NodeId;
6use cranpose_ui_layout::{HorizontalAlignment, LinearArrangement};
7
8use super::layout::Layout;
9use crate::{composable, layout::policies::FlexMeasurePolicy, modifier::Modifier};
10
11/// Specification for Column layout behavior.
12#[derive(Clone, Copy, Debug, PartialEq)]
13pub struct ColumnSpec {
14    pub vertical_arrangement: LinearArrangement,
15    pub horizontal_alignment: HorizontalAlignment,
16}
17
18impl ColumnSpec {
19    pub fn new() -> Self {
20        Self::default()
21    }
22
23    pub fn vertical_arrangement(mut self, arrangement: LinearArrangement) -> Self {
24        self.vertical_arrangement = arrangement;
25        self
26    }
27
28    pub fn horizontal_alignment(mut self, alignment: HorizontalAlignment) -> Self {
29        self.horizontal_alignment = alignment;
30        self
31    }
32}
33
34impl Default for ColumnSpec {
35    fn default() -> Self {
36        Self {
37            vertical_arrangement: LinearArrangement::Start,
38            horizontal_alignment: HorizontalAlignment::Start,
39        }
40    }
41}
42
43/// A layout composable that places its children in a vertical sequence.
44///
45/// # When to use
46/// Use `Column` to arrange items top-to-bottom. For horizontal arrangement, use [`Row`](crate::widgets::Row).
47///
48/// # Arguments
49///
50/// * `modifier` - Modifiers to apply to the column layout.
51/// * `spec` - Configuration for vertical arrangement and horizontal alignment.
52/// * `content` - The children composables to layout.
53///
54/// # Example
55///
56/// ```rust,ignore
57/// Column(
58///     Modifier::padding(16.0),
59///     ColumnSpec::default().vertical_arrangement(LinearArrangement::spaced_by(8.0)),
60///     || {
61///         Text("Title", Modifier::empty());
62///         Text("Subtitle", Modifier::empty());
63///     }
64/// );
65/// ```
66#[composable]
67pub fn Column<F>(modifier: Modifier, spec: ColumnSpec, content: F) -> NodeId
68where
69    F: FnMut() + 'static,
70{
71    let policy = FlexMeasurePolicy::column(spec.vertical_arrangement, spec.horizontal_alignment);
72    Layout(modifier, policy, content)
73}
cranpose_ui/widgets/column.rs

cranpose_ui/widgets/
column.rs
