From: Dominik Csapak <d.csapak@proxmox.com>
To: yew-devel@lists.proxmox.com
Subject: [PATCH yew-widget-toolkit v4] widget: add 'div' and 'span' helper functions
Date: Wed, 8 Apr 2026 12:02:50 +0200 [thread overview]
Message-ID: <20260408100408.1274308-1-d.csapak@proxmox.com> (raw)
these are 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.
In addition to the `div` helper also add a `span` helper,
Import the `ContainerBuilder` trait with a different name, otherwise
it conflicts with the Properties macro generated types.
To expose these functions, simply make the 'container' module public.
Signed-off-by: Dominik Csapak <d.csapak@proxmox.com>
---
changes from v3:
* drop 'italic' function, we can decide later if we want that/how we
want to name it
* make the trait import global with different name, and give a better
explanation why it's necessary.
src/widget/container.rs | 17 +++++++++++++++++
src/widget/mod.rs | 2 +-
2 files changed, 18 insertions(+), 1 deletion(-)
diff --git a/src/widget/container.rs b/src/widget/container.rs
index 23d637b..6d51662 100644
--- a/src/widget/container.rs
+++ b/src/widget/container.rs
@@ -3,6 +3,9 @@ use std::borrow::Cow;
use yew::prelude::*;
use yew::virtual_dom::VTag;
+// include with different name, since Properties macro generates a `StructNameBuilder`
+// already, which results here in `ContainerBuilder``
+use crate::props::ContainerBuilder as PwtContainerBuilder;
use crate::props::{IntoVTag, ListenersWrapper, WidgetStdProps};
use pwt_macros::widget;
@@ -57,3 +60,17 @@ impl IntoVTag for Container {
)
}
}
+
+/// Helper function to create a `<div>` element with a single child.
+///
+/// It's the same as `Container::new().with_child(comp)`
+pub fn div(comp: impl Into<Html>) -> Container {
+ Container::new().with_child(comp)
+}
+
+/// Helper function to create a `<span>` element with a single child.
+///
+/// It's the same as `Container::from_tag("span").with_child(comp)`
+pub fn span(comp: impl Into<Html>) -> Container {
+ Container::from_tag("span").with_child(comp)
+}
diff --git a/src/widget/mod.rs b/src/widget/mod.rs
index 0df2cbf..ff3234a 100644
--- a/src/widget/mod.rs
+++ b/src/widget/mod.rs
@@ -31,7 +31,7 @@ pub use catalog_loader::PwtCatalogLoader;
mod column;
pub use column::Column;
-mod container;
+pub mod container;
pub use container::Container;
mod confirm_dialog;
--
2.47.3
next reply other threads:[~2026-04-08 10:04 UTC|newest]
Thread overview: 2+ messages / expand[flat|nested] mbox.gz Atom feed top
2026-04-08 10:02 Dominik Csapak [this message]
2026-04-10 6:39 ` applied: " Dietmar Maurer
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=20260408100408.1274308-1-d.csapak@proxmox.com \
--to=d.csapak@proxmox.com \
--cc=yew-devel@lists.proxmox.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox