Grid layout

masonry/examples/grid_masonry.rs

@@ -0,0 +1,119 @@
+// Copyright 2024 the Xilem Authors
+// SPDX-License-Identifier: Apache-2.0
+
+//! Shows how to use a grid layout in Masonry.
+
+// On Windows platform, don't show a console when opening the app.
+#![windows_subsystem = "windows"]
+
+use masonry::app_driver::{AppDriver, DriverCtx};
+use masonry::dpi::LogicalSize;
+use masonry::widget::{Button, Grid, GridParams, Prose, RootWidget, SizedBox};
+use masonry::{Action, Color, PointerButton, WidgetId};
+use winit::window::Window;
+
+struct Driver {
+    grid_spacing: f64,
+}
+
+impl AppDriver for Driver {
+    fn on_action(&mut self, ctx: &mut DriverCtx<'_>, _widget_id: WidgetId, action: Action) {
+        if let Action::ButtonPressed(button) = action {
+            if button == PointerButton::Primary {
+                self.grid_spacing += 1.0;
+            } else if button == PointerButton::Secondary {
+                self.grid_spacing -= 1.0;
+            } else {
+                self.grid_spacing += 0.5;
+            }
+
+            ctx.get_root::<RootWidget<Grid>>()
+                .get_element()
+                .set_spacing(self.grid_spacing);
+        }
+    }
+}
+
+fn grid_button(params: GridParams) -> Button {
+    Button::new(format!(
+        "X: {}, Y: {}, W: {}, H: {}",
+        params.x, params.y, params.width, params.height
+    ))
+}
+
+pub fn main() {
+    let label = SizedBox::new(
+        Prose::new("Change spacing by right and\n left clicking on the buttons")
+            .with_text_size(14.0),
+    )
+    .border(Color::rgb8(40, 40, 80), 1.0);
+    let button_inputs = vec![
+        GridParams {
+            x: 0,
+            y: 0,
+            width: 1,
+            height: 1,
+        },
+        GridParams {
+            x: 2,
+            y: 0,
+            width: 2,
+            height: 1,
+        },
+        GridParams {
+            x: 0,
+            y: 1,
+            width: 1,
+            height: 2,
+        },
+        GridParams {
+            x: 1,
+            y: 1,
+            width: 2,
+            height: 2,
+        },
+        GridParams {
+            x: 3,
+            y: 1,
+            width: 1,
+            height: 1,
+        },
+        GridParams {
+            x: 3,
+            y: 2,
+            width: 1,
+            height: 1,
+        },
+        GridParams {
+            x: 0,
+            y: 3,
+            width: 4,
+            height: 1,
+        },
+    ];
+
+    let driver = Driver { grid_spacing: 1.0 };
+
+    // Arrange widgets in a 4 by 4 grid.
+    let mut main_widget = Grid::with_dimensions(4, 4)
+        .with_spacing(driver.grid_spacing)
+        .with_child(label, GridParams::new(1, 0, 1, 1));
+    for button_input in button_inputs {
+        let button = grid_button(button_input);
+        main_widget = main_widget.with_child(button, button_input);
+    }
+
+    let window_size = LogicalSize::new(800.0, 500.0);
+    let window_attributes = Window::default_attributes()
+        .with_title("Grid Layout")
+        .with_resizable(true)
+        .with_min_inner_size(window_size);
+
+    masonry::event_loop_runner::run(
+        masonry::event_loop_runner::EventLoop::with_user_event(),
+        window_attributes,
+        RootWidget::new(main_widget),
+        driver,
+    )
+    .unwrap();
+}

masonry/src/widget/flex.rs

@@ -524,7 +524,7 @@ impl<'a> WidgetMut<'a, Flex> {
     ///
     /// # Panics
     ///
-    /// Panics if the the element at `idx` is not a widget.
+    /// Panics if the element at `idx` is not a widget.
     pub fn update_child_flex_params(&mut self, idx: usize, params: impl Into<FlexParams>) {
         let child = &mut self.widget.children[idx];
         let child_val = std::mem::replace(child, Child::FixedSpacer(0.0, 0.0));