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

[PATCH yew-widget-toolkit v2] 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>
---
changes in v2:
used the correct use statement in the prelude section

 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..a759350 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -358,6 +358,7 @@ pub mod prelude {
     #[doc(hidden)]
     pub use yew::prelude::*;
 
+    pub use crate::div;
     pub use crate::props::CallbackMutScopeExt;
     pub use crate::props::ContainerBuilder;
     pub use crate::props::CssBorderBuilder;
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