[PATCH yew-widget-toolkit] widget: add 'div' macro

[PATCH yew-widget-toolkit] widget: add 'div' macro

[Dominik Csapak]

this is just a simple wrapper around the `Container` widget, but it's
very useful in situations where bare strings are used in a flex layout,
since e.g. a `Row` with multiple children that are all strings won't get
a proper flex layout (since they're not elements)

So instead of writing
```
Row::new()
    .with_child(Container::new().with_child("Text1"))
    .with_child(Container::new().with_child("Text2"))
```

one can now write
```
Row::new()
    .with_child(div!("Text1"))
    .with_child(div!("Text2"))
```

which is much shorter and more readable.

Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>
---
 src/lib.rs           |  1 +
 src/widget/macros.rs | 34 ++++++++++++++++++++++++++++++++++
 src/widget/mod.rs    |  2 ++
 3 files changed, 37 insertions(+)
 create mode 100644 src/widget/macros.rs

diff --git a/src/lib.rs b/src/lib.rs
index d3ac6ea..198b987 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -370,6 +370,7 @@ pub mod prelude {
     pub use crate::props::WidgetBuilder;
     pub use crate::props::WidgetStyleBuilder;
     pub use crate::tr;
+    pub use crate::widget::macros;
     pub use crate::{gettext, gettext_noop, ngettext, npgettext, pgettext};
 }
 
diff --git a/src/widget/macros.rs b/src/widget/macros.rs
new file mode 100644
index 0000000..fc4e05f
--- /dev/null
+++ b/src/widget/macros.rs
@@ -0,0 +1,34 @@
+//! Helper and utility macros to make some often used patterns more ergonomic
+
+/// A macro to wrap some elements or strings in a `<div>`.
+///
+/// Expands to `Container::new().with_child(param1).with_child(param2)...`
+///
+/// Examples:
+/// ```
+/// # use pwt::widget::Container;
+/// # use pwt::div;
+///   // must be used, either directly or via pwt::prelude::*
+///   use pwt::props::ContainerBuilder;
+///
+/// # fn main() {
+///   let div = div!("Some Text");
+/// # drop(div);
+///
+///   // is the same as
+///   let div = Container::new().with_child("Some Text");
+/// # drop(div);
+///
+///   // you can also specify multiple elements
+///   div!("Text1", "Text2");
+///
+///   // or components
+///   div!(Container::new());
+/// # }
+/// ```
+#[macro_export]
+macro_rules! div {
+    ($($arg:expr),* $(,)?) => {
+        $crate::widget::Container::new()$(.with_child($arg))*
+    };
+}
diff --git a/src/widget/mod.rs b/src/widget/mod.rs
index 0df2cbf..1998332 100644
--- a/src/widget/mod.rs
+++ b/src/widget/mod.rs
@@ -85,6 +85,8 @@ pub use list::{List, ListTile, ListTileObserver};
 #[doc(hidden)]
 pub use list::{PwtList, PwtListTileObserver};
 
+pub mod macros;
+
 mod mask;
 pub use mask::Mask;
 #[doc(hidden)]
-- 
2.47.3

superseded: [PATCH yew-widget-toolkit] widget: add 'div' macro

[Dominik Csapak]

superseded by v2:
https://lore.proxmox.com/yew-devel/20260402134337.3433085-1-d.csapak@proxmox.com/

On 4/2/26 3:22 PM, Dominik Csapak wrote:
> this is just a simple wrapper around the `Container` widget, but it's
> very useful in situations where bare strings are used in a flex layout,
> since e.g. a `Row` with multiple children that are all strings won't get
> a proper flex layout (since they're not elements)
> 
> So instead of writing
> ```
> Row::new()
>      .with_child(Container::new().with_child("Text1"))
>      .with_child(Container::new().with_child("Text2"))
> ```
> 
> one can now write
> ```
> Row::new()
>      .with_child(div!("Text1"))
>      .with_child(div!("Text2"))
> ```
> 
> which is much shorter and more readable.
> 
> Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>
> ---
>   src/lib.rs           |  1 +
>   src/widget/macros.rs | 34 ++++++++++++++++++++++++++++++++++
>   src/widget/mod.rs    |  2 ++
>   3 files changed, 37 insertions(+)
>   create mode 100644 src/widget/macros.rs
> 
> diff --git a/src/lib.rs b/src/lib.rs
> index d3ac6ea..198b987 100644
> --- a/src/lib.rs
> +++ b/src/lib.rs
> @@ -370,6 +370,7 @@ pub mod prelude {
>       pub use crate::props::WidgetBuilder;
>       pub use crate::props::WidgetStyleBuilder;
>       pub use crate::tr;
> +    pub use crate::widget::macros;
>       pub use crate::{gettext, gettext_noop, ngettext, npgettext, pgettext};
>   }
>   
> diff --git a/src/widget/macros.rs b/src/widget/macros.rs
> new file mode 100644
> index 0000000..fc4e05f
> --- /dev/null
> +++ b/src/widget/macros.rs
> @@ -0,0 +1,34 @@
> +//! Helper and utility macros to make some often used patterns more ergonomic
> +
> +/// A macro to wrap some elements or strings in a `<div>`.
> +///
> +/// Expands to `Container::new().with_child(param1).with_child(param2)...`
> +///
> +/// Examples:
> +/// ```
> +/// # use pwt::widget::Container;
> +/// # use pwt::div;
> +///   // must be used, either directly or via pwt::prelude::*
> +///   use pwt::props::ContainerBuilder;
> +///
> +/// # fn main() {
> +///   let div = div!("Some Text");
> +/// # drop(div);
> +///
> +///   // is the same as
> +///   let div = Container::new().with_child("Some Text");
> +/// # drop(div);
> +///
> +///   // you can also specify multiple elements
> +///   div!("Text1", "Text2");
> +///
> +///   // or components
> +///   div!(Container::new());
> +/// # }
> +/// ```
> +#[macro_export]
> +macro_rules! div {
> +    ($($arg:expr),* $(,)?) => {
> +        $crate::widget::Container::new()$(.with_child($arg))*
> +    };
> +}
> diff --git a/src/widget/mod.rs b/src/widget/mod.rs
> index 0df2cbf..1998332 100644
> --- a/src/widget/mod.rs
> +++ b/src/widget/mod.rs
> @@ -85,6 +85,8 @@ pub use list::{List, ListTile, ListTileObserver};
>   #[doc(hidden)]
>   pub use list::{PwtList, PwtListTileObserver};
>   
> +pub mod macros;
> +
>   mod mask;
>   pub use mask::Mask;
>   #[doc(hidden)]