Compare commits

...

3 commits

Author SHA1 Message Date
fe2b2c176f ♻️ (bootsier): Mueve Brand al core de PageTop 2026-08-17 05:53:55 +02:00
bf4c635e59 ♻️ (pagetop): Sustituye Attr<T> por Option<T>
`Attr<T>` no aportaba nada sobre `Option<T>` directo: `Getters` ya trata
los campos `Option<T>` como caso especial (`Option<&T>`, o `Option<T>`
con `#[getters(copy)]`) y `#[builder_fn]` funciona igual sobre ellos.
2026-08-17 05:28:12 +02:00
213aa18b12 ♻️ (locale): Sustituye Attr<Lc> por Lc::none() 2026-08-17 03:16:49 +02:00
33 changed files with 577 additions and 469 deletions

View file

@ -143,6 +143,8 @@ impl Theme for Bootsier {
cx: &mut Context, cx: &mut Context,
) -> Option<Result<Markup, ComponentError>> { ) -> Option<Result<Markup, ComponentError>> {
setup_component!(component, { setup_component!(component, {
Badge => |c| theme::bs::badge::setup(c),
Brand => |c| theme::bs::brand::setup(c),
Button => |c| theme::bs::button::setup(c), Button => |c| theme::bs::button::setup(c),
Container => |c| theme::bs::container::setup(c), Container => |c| theme::bs::container::setup(c),
Image => |c| theme::bs::image::setup(c), Image => |c| theme::bs::image::setup(c),

View file

@ -0,0 +1,9 @@
use pagetop::prelude::*;
pub use pagetop::base::component::Brand;
// **< Brand SETUP >********************************************************************************
pub(crate) fn setup(brand: &mut Brand) {
brand.alter_prop(PropsOp::replace_classes("brand", "navbar-brand"));
}

View file

@ -63,9 +63,9 @@ pub(crate) fn render(field: &Field, cx: &mut Context) -> Result<Markup, Componen
let strict = field.kind().is_strict(); let strict = field.kind().is_strict();
let masked = *field.kind() == Kind::StrictPassword; let masked = *field.kind() == Kind::StrictPassword;
let autocomplete = if strict { let autocomplete = if strict {
Some(form::Autocomplete::Off) Some(&form::Autocomplete::Off)
} else { } else {
field.autocomplete().get() field.autocomplete()
}; };
// La etiqueta flotante requiere `placeholder` para animar la etiqueta. // La etiqueta flotante requiere `placeholder` para animar la etiqueta.
@ -100,12 +100,12 @@ pub(crate) fn render(field: &Field, cx: &mut Context) -> Result<Markup, Componen
type=(field.kind()) type=(field.kind())
id=[input_id.as_deref()] id=[input_id.as_deref()]
class=(input_class) class=(input_class)
name=[field.name().get()] name=[field.name().as_deref()]
value=[field.value().get()] value=[field.value().as_deref()]
minlength=[field.minlength().get()] minlength=[field.minlength()]
maxlength=[field.maxlength().get()] maxlength=[field.maxlength()]
placeholder=[placeholder] placeholder=[placeholder]
inputmode=[field.inputmode().get()] inputmode=[field.inputmode()]
autocomplete=[autocomplete] autocomplete=[autocomplete]
spellcheck=[strict.then_some("false")] spellcheck=[strict.then_some("false")]
autocorrect=[strict.then_some("off")] autocorrect=[strict.then_some("off")]

View file

@ -85,10 +85,10 @@ pub(crate) fn render(field: &Field, cx: &mut Context) -> Result<Markup, Componen
select select
id=[select_id.as_deref()] id=[select_id.as_deref()]
class="form-select" class="form-select"
name=[field.name().get()] name=[field.name().as_deref()]
multiple[*field.multiple()] multiple[*field.multiple()]
size=[field.rows().get()] size=[field.rows()]
autocomplete=[field.autocomplete().get()] autocomplete=[field.autocomplete()]
autofocus[*field.autofocus()] autofocus[*field.autofocus()]
required[*field.required()] required[*field.required()]
disabled[*field.disabled()] disabled[*field.disabled()]
@ -97,7 +97,7 @@ pub(crate) fn render(field: &Field, cx: &mut Context) -> Result<Markup, Componen
@match entry { @match entry {
form::select::Entry::Item(opt) => { form::select::Entry::Item(opt) => {
option option
value=(opt.value().as_str().unwrap_or("")) value=(opt.value().as_deref().unwrap_or(""))
selected[*opt.selected()] selected[*opt.selected()]
disabled[*opt.disabled()] disabled[*opt.disabled()]
{ {
@ -111,7 +111,7 @@ pub(crate) fn render(field: &Field, cx: &mut Context) -> Result<Markup, Componen
{ {
@for opt in group.items() { @for opt in group.items() {
option option
value=(opt.value().as_str().unwrap_or("")) value=(opt.value().as_deref().unwrap_or(""))
selected[*opt.selected()] selected[*opt.selected()]
disabled[*opt.disabled()] disabled[*opt.disabled()]
{ {

View file

@ -91,18 +91,18 @@ pub(crate) fn render(field: &Textarea, cx: &mut Context) -> Result<Markup, Compo
textarea textarea
id=[textarea_id.as_deref()] id=[textarea_id.as_deref()]
class="form-control" class="form-control"
name=[field.name().get()] name=[field.name().as_deref()]
rows=[field.rows().get()] rows=[field.rows()]
minlength=[field.minlength().get()] minlength=[field.minlength()]
maxlength=[field.maxlength().get()] maxlength=[field.maxlength()]
placeholder=[placeholder] placeholder=[placeholder]
autocomplete=[field.autocomplete().get()] autocomplete=[field.autocomplete()]
autofocus[*field.autofocus()] autofocus[*field.autofocus()]
readonly[*field.readonly()] readonly[*field.readonly()]
required[*field.required()] required[*field.required()]
disabled[*field.disabled()] disabled[*field.disabled()]
{ {
@if let Some(value) = field.value().get() { (value) } @if let Some(value) = field.value().as_deref() { (value) }
} }
@if floating { (label) } @if floating { (label) }
@if let Some(description) = field.help_text().lookup(cx) { @if let Some(description) = field.help_text().lookup(cx) {

View file

@ -1,81 +0,0 @@
use pagetop::prelude::*;
use crate::theme::*;
/// Marca de identidad para mostrar en una barra de navegación [`Navbar`](crate::theme::bs::Navbar).
///
/// Representa la identidad del sitio con una imagen, título y eslogan:
///
/// - Si hay URL ([`with_route()`](Self::with_route)), el bloque completo actúa como enlace. Por
/// defecto enlaza a la raíz del sitio (`/`).
/// - Si no hay imagen ([`with_image()`](Self::with_image)) ni título
/// ([`with_title()`](Self::with_title)), la marca de identidad no se renderiza.
/// - El eslogan ([`with_slogan()`](Self::with_slogan)) es opcional; por defecto no tiene contenido.
#[derive(AutoDefault, Clone, Debug, Getters)]
pub struct Brand {
/// Devuelve la imagen de marca (si la hay).
image: Embed<bs::Image>,
/// Devuelve el título de la identidad de marca.
#[default(_code = "Lc::n(&global::SETTINGS.app.name)")]
title: Lc,
/// Devuelve el eslogan de la marca.
slogan: Lc,
/// Devuelve la ruta asociada a la marca (si existe).
#[default(_code = "Some(\"/\".into())")]
route: Option<Route>,
}
#[async_trait]
impl Component for Brand {
fn new() -> Self {
Self::default()
}
async fn prepare(&self, cx: &mut Context) -> Result<Markup, ComponentError> {
let image = self.image().render(cx).await;
let title = self.title().using(cx);
if title.is_empty() && image.is_empty() {
return Ok(html! {});
}
let slogan = self.slogan().using(cx);
Ok(html! {
@if let Some(route) = self.route() {
a class="navbar-brand" href=(route.resolve(cx)) { (image) (title) (slogan) }
} @else {
span class="navbar-brand" { (image) (title) (slogan) }
}
})
}
}
impl Brand {
// **< Brand BUILDER >**************************************************************************
/// Asigna o quita la imagen de marca. Si se pasa `None`, no se mostrará.
#[builder_fn]
pub fn with_image(mut self, image: Option<bs::Image>) -> Self {
self.image.alter_component(image);
self
}
/// Establece el título de la identidad de marca.
#[builder_fn]
pub fn with_title(mut self, title: Lc) -> Self {
self.title = title;
self
}
/// Define el eslogan de la marca.
#[builder_fn]
pub fn with_slogan(mut self, slogan: Lc) -> Self {
self.slogan = slogan;
self
}
/// Define la ruta de destino. Si es `None`, la marca no será un enlace.
#[builder_fn]
pub fn with_route(mut self, route: Option<Route>) -> Self {
self.route = route;
self
}
}

View file

@ -5,6 +5,9 @@ pub mod layout;
mod badge; mod badge;
pub use badge::Badge; pub use badge::Badge;
mod brand;
pub use brand::Brand;
pub mod breadcrumb; pub mod breadcrumb;
#[doc(inline)] #[doc(inline)]
pub use breadcrumb::Breadcrumb; pub use breadcrumb::Breadcrumb;

120
src/base/component/brand.rs Normal file
View file

@ -0,0 +1,120 @@
use crate::prelude::*;
/// Componente para mostrar la **identidad de marca** de un sitio o aplicación.
///
/// Combina una imagen, un título y un eslogan opcional, típicamente en la cabecera de la página o
/// dentro de una barra de navegación proporcionada por un tema.
///
/// - Si hay ruta ([`with_route()`]), el bloque completo actúa como enlace. Por defecto enlaza a la
/// raíz del sitio (`/`).
/// - Si no hay imagen ([`with_image()`]) ni título ([`with_title()`]), la marca de identidad no se
/// renderiza.
/// - El eslogan ([`with_slogan()`]) es opcional; por defecto no tiene contenido.
///
/// # Ejemplo
///
/// ```rust,no_run
/// use pagetop::prelude::*;
///
/// let brand = Brand::new()
/// .with_image(Some(Image::with(image::Source::logo(PageTopSvg::Color))))
/// .with_title(Lc::n("PageTop"))
/// .with_route(Route::from("/"));
/// ```
///
/// [`with_route()`]: Self::with_route
/// [`with_image()`]: Self::with_image
/// [`with_title()`]: Self::with_title
/// [`with_slogan()`]: Self::with_slogan
#[derive(AutoDefault, Clone, Debug, Getters)]
pub struct Brand {
/// Devuelve identificador, clases CSS, atributos HTML y valores extra del componente.
props: Props,
/// Devuelve la imagen de marca (si la hay).
image: Embed<Image>,
/// Devuelve el título de la identidad de marca.
#[default(_code = "Lc::n(&global::SETTINGS.app.name)")]
title: Lc,
/// Devuelve el eslogan de la marca.
slogan: Lc,
/// Devuelve la ruta asociada a la marca (si existe).
#[default(_code = "Some(\"/\".into())")]
route: Option<Route>,
}
#[async_trait]
impl Component for Brand {
fn new() -> Self {
Self::default()
}
fn id(&self) -> Option<String> {
self.props.get_id()
}
fn setup(&mut self, _cx: &Context) {
self.alter_prop(PropsOp::prepend_classes("brand"));
}
async fn prepare(&self, cx: &mut Context) -> Result<Markup, ComponentError> {
let image = self.image().render(cx).await;
let title = self.title().using(cx);
if image.is_empty() && title.is_empty() {
return Ok(html! {});
}
let slogan = self.slogan().using(cx);
Ok(html! {
@if let Some(route) = self.route() {
a (self.props()) href=(route.resolve(cx)) { (image) (title) (slogan) }
} @else {
span (self.props()) { (image) (title) (slogan) }
}
})
}
}
impl Brand {
// **< Brand BUILDER >**************************************************************************
/// Establece el identificador único del componente; igual a `with_prop(PropsOp::set_id(id))`.
#[builder_fn]
pub fn with_id(mut self, id: impl Into<CowStr>) -> Self {
self.props.alter_id(id);
self
}
/// Modifica identificador, clases CSS, atributos HTML o valores extra del componente.
#[builder_fn]
pub fn with_prop(mut self, op: PropsOp) -> Self {
self.props.alter_prop(op);
self
}
/// Asigna o quita la imagen de marca. Si se pasa `None`, no se mostrará.
#[builder_fn]
pub fn with_image(mut self, image: impl Into<Option<Image>>) -> Self {
self.image.alter_component(image);
self
}
/// Establece el título de la identidad de marca.
#[builder_fn]
pub fn with_title(mut self, title: Lc) -> Self {
self.title = title;
self
}
/// Define el eslogan de la marca.
#[builder_fn]
pub fn with_slogan(mut self, slogan: Lc) -> Self {
self.slogan = slogan;
self
}
/// Define la ruta de destino. Si es `None`, la marca no será un enlace.
#[builder_fn]
pub fn with_route(mut self, route: impl Into<Option<Route>>) -> Self {
self.route = route.into();
self
}
}

View file

@ -74,9 +74,9 @@ pub struct Button {
/// Devuelve el valor del botón. /// Devuelve el valor del botón.
value: AttrValue, value: AttrValue,
/// Devuelve la etiqueta del botón. /// Devuelve la etiqueta del botón.
label: Attr<Lc>, label: Lc,
/// Devuelve el texto emergente del botón (atributo `title`). /// Devuelve el texto emergente del botón (atributo `title`).
title: Attr<Lc>, title: Lc,
/// Devuelve si el botón recibe el foco automáticamente al cargar la página. /// Devuelve si el botón recibe el foco automáticamente al cargar la página.
autofocus: bool, autofocus: bool,
/// Devuelve si el botón está deshabilitado. /// Devuelve si el botón está deshabilitado.
@ -102,8 +102,8 @@ impl Component for Button {
button button
type=(self.kind()) type=(self.kind())
(self.props()) (self.props())
name=[self.name().get()] name=[self.name().as_deref()]
value=[self.value().get()] value=[self.value().as_deref()]
title=[self.title().lookup(cx)] title=[self.title().lookup(cx)]
autofocus[*self.autofocus()] autofocus[*self.autofocus()]
disabled[*self.disabled()] disabled[*self.disabled()]
@ -124,7 +124,7 @@ impl Button {
pub fn submit(label: Lc) -> Self { pub fn submit(label: Lc) -> Self {
Self { Self {
kind: ButtonAction::Submit, kind: ButtonAction::Submit,
label: Attr::some(label), label,
..Default::default() ..Default::default()
} }
} }
@ -135,7 +135,7 @@ impl Button {
pub fn reset(label: Lc) -> Self { pub fn reset(label: Lc) -> Self {
Self { Self {
kind: ButtonAction::Reset, kind: ButtonAction::Reset,
label: Attr::some(label), label,
..Default::default() ..Default::default()
} }
} }
@ -147,7 +147,7 @@ impl Button {
pub fn plain(label: Lc) -> Self { pub fn plain(label: Lc) -> Self {
Self { Self {
kind: ButtonAction::Plain, kind: ButtonAction::Plain,
label: Attr::some(label), label,
..Default::default() ..Default::default()
} }
} }
@ -188,17 +188,17 @@ impl Button {
self self
} }
/// Establece o elimina la etiqueta visible del botón (basta pasar `None` para quitarla). /// Establece la etiqueta visible del botón (usa [`Lc::none()`] para quitarla).
#[builder_fn] #[builder_fn]
pub fn with_label(mut self, label: impl Into<Option<Lc>>) -> Self { pub fn with_label(mut self, label: Lc) -> Self {
self.label.alter_opt(label.into()); self.label = label;
self self
} }
/// Establece o elimina el texto emergente del botón (basta pasar `None` para quitarlo). /// Establece el texto emergente del botón (usa [`Lc::none()`] para quitarlo).
#[builder_fn] #[builder_fn]
pub fn with_title(mut self, title: impl Into<Option<Lc>>) -> Self { pub fn with_title(mut self, title: Lc) -> Self {
self.title.alter_opt(title.into()); self.title = title;
self self
} }

View file

@ -103,9 +103,9 @@ pub struct Field {
/// Devuelve el nombre compartido por todas las casillas del grupo. /// Devuelve el nombre compartido por todas las casillas del grupo.
name: AttrName, name: AttrName,
/// Devuelve la etiqueta del grupo. /// Devuelve la etiqueta del grupo.
label: Attr<Lc>, label: Lc,
/// Devuelve el texto de ayuda del grupo. /// Devuelve el texto de ayuda del grupo.
help_text: Attr<Lc>, help_text: Lc,
/// Devuelve las casillas del grupo. /// Devuelve las casillas del grupo.
items: Vec<Item>, items: Vec<Item>,
/// Devuelve si todo el grupo está deshabilitado. /// Devuelve si todo el grupo está deshabilitado.
@ -141,7 +141,7 @@ impl Component for Field {
async fn prepare(&self, cx: &mut Context) -> Result<Markup, ComponentError> { async fn prepare(&self, cx: &mut Context) -> Result<Markup, ComponentError> {
// En `setup()` se garantiza que `name` e `id` están definidos antes del renderizado. // En `setup()` se garantiza que `name` e `id` están definidos antes del renderizado.
let name = self.name().get().unwrap(); let name = self.name().as_deref().unwrap();
let container_id = self.id().unwrap(); let container_id = self.id().unwrap();
Ok(html! { Ok(html! {
@ -162,8 +162,8 @@ impl Component for Field {
type="checkbox" type="checkbox"
id=(&item_id) id=(&item_id)
class="form-check-input" class="form-check-input"
name=(&name) name=(name)
value=[item.value().get()] value=[item.value().as_deref()]
checked[*item.checked()] checked[*item.checked()]
disabled[*item.disabled() || *self.disabled()]; disabled[*item.disabled() || *self.disabled()];
label class="form-check-label" for=(&item_id) { label class="form-check-label" for=(&item_id) {
@ -207,17 +207,17 @@ impl Field {
self self
} }
/// Establece o elimina la etiqueta visible del grupo (basta pasar `None` para quitarla). /// Establece la etiqueta visible del grupo (usa [`Lc::none()`] para quitarla).
#[builder_fn] #[builder_fn]
pub fn with_label(mut self, label: impl Into<Option<Lc>>) -> Self { pub fn with_label(mut self, label: Lc) -> Self {
self.label.alter_opt(label.into()); self.label = label;
self self
} }
/// Establece o elimina el texto de ayuda del grupo (basta pasar `None` para quitarlo). /// Establece el texto de ayuda del grupo (usa [`Lc::none()`] para quitarlo).
#[builder_fn] #[builder_fn]
pub fn with_help_text(mut self, help_text: impl Into<Option<Lc>>) -> Self { pub fn with_help_text(mut self, help_text: Lc) -> Self {
self.help_text.alter_opt(help_text.into()); self.help_text = help_text;
self self
} }

View file

@ -46,7 +46,7 @@ pub struct Checkbox {
/// Devuelve el nombre del campo. /// Devuelve el nombre del campo.
name: AttrName, name: AttrName,
/// Devuelve la etiqueta del control. /// Devuelve la etiqueta del control.
label: Attr<Lc>, label: Lc,
/// Devuelve si el control debe estar marcado/activo por defecto. /// Devuelve si el control debe estar marcado/activo por defecto.
checked: bool, checked: bool,
/// Devuelve si el control recibe el foco automáticamente al cargar la página. /// Devuelve si el control recibe el foco automáticamente al cargar la página.
@ -98,7 +98,7 @@ impl Component for Checkbox {
async fn prepare(&self, cx: &mut Context) -> Result<Markup, ComponentError> { async fn prepare(&self, cx: &mut Context) -> Result<Markup, ComponentError> {
// En `setup()` se garantiza que `name` e `id` están definidos antes del renderizado. // En `setup()` se garantiza que `name` e `id` están definidos antes del renderizado.
let name = self.name().get().unwrap(); let name = self.name().as_deref().unwrap();
let container_id = self.id().unwrap(); let container_id = self.id().unwrap();
let checkbox_id = util::join!(&container_id, "-checkbox"); let checkbox_id = util::join!(&container_id, "-checkbox");
@ -111,7 +111,7 @@ impl Component for Checkbox {
role=[is_switch.then_some("switch")] role=[is_switch.then_some("switch")]
id=(&checkbox_id) id=(&checkbox_id)
class="form-check-input" class="form-check-input"
name=(&name) name=(name)
value="true" value="true"
checked[*self.checked()] checked[*self.checked()]
autofocus[*self.autofocus()] autofocus[*self.autofocus()]
@ -182,10 +182,10 @@ impl Checkbox {
self self
} }
/// Establece o elimina la etiqueta visible del control (basta pasar `None` para quitarla). /// Establece la etiqueta visible del control (usa [`Lc::none()`] para quitarla).
#[builder_fn] #[builder_fn]
pub fn with_label(mut self, label: impl Into<Option<Lc>>) -> Self { pub fn with_label(mut self, label: Lc) -> Self {
self.label.alter_opt(label.into()); self.label = label;
self self
} }

View file

@ -81,7 +81,7 @@ impl Component for Form {
(self.props()) (self.props())
action=[self.action().try_resolve(cx)] action=[self.action().try_resolve(cx)]
method=[method] method=[method]
accept-charset=[self.charset().get()] accept-charset=[self.charset().as_deref()]
{ {
(self.children().render(cx).await) (self.children().render(cx).await)
} }

View file

@ -27,9 +27,9 @@ pub struct Fieldset {
/// Devuelve identificador, clases CSS, atributos HTML y valores extra del componente. /// Devuelve identificador, clases CSS, atributos HTML y valores extra del componente.
props: Props, props: Props,
/// Devuelve la leyenda del `fieldset`. /// Devuelve la leyenda del `fieldset`.
legend: Attr<Lc>, legend: Lc,
/// Devuelve la descripción del `fieldset`. /// Devuelve la descripción del `fieldset`.
description: Attr<Lc>, description: Lc,
/// Devuelve si el `fieldset` está deshabilitado. /// Devuelve si el `fieldset` está deshabilitado.
disabled: bool, disabled: bool,
/// Devuelve la lista de componentes del `fieldset`. /// Devuelve la lista de componentes del `fieldset`.
@ -84,17 +84,17 @@ impl Fieldset {
self self
} }
/// Establece o elimina la leyenda del `fieldset` (basta pasar `None` para quitarla). /// Establece la leyenda del `fieldset` (usa [`Lc::none()`] para quitarla).
#[builder_fn] #[builder_fn]
pub fn with_legend(mut self, legend: impl Into<Option<Lc>>) -> Self { pub fn with_legend(mut self, legend: Lc) -> Self {
self.legend.alter_opt(legend.into()); self.legend = legend;
self self
} }
/// Establece o elimina la descripción del `fieldset` (basta pasar `None` para quitarla). /// Establece la descripción del `fieldset` (usa [`Lc::none()`] para quitarla).
#[builder_fn] #[builder_fn]
pub fn with_description(mut self, description: impl Into<Option<Lc>>) -> Self { pub fn with_description(mut self, description: Lc) -> Self {
self.description.alter_opt(description.into()); self.description = description;
self self
} }

View file

@ -48,8 +48,8 @@ impl Component for Hidden {
Ok(html! { Ok(html! {
input input
type="hidden" type="hidden"
name=[self.name().get()] name=[self.name().as_deref()]
value=[self.value().get()]; value=[self.value().as_deref()];
}) })
} }
} }

View file

@ -161,17 +161,19 @@ pub struct Field {
/// Devuelve el valor inicial del campo. /// Devuelve el valor inicial del campo.
value: AttrValue, value: AttrValue,
/// Devuelve la etiqueta del campo. /// Devuelve la etiqueta del campo.
label: Attr<Lc>, label: Lc,
/// Devuelve el texto de ayuda del campo. /// Devuelve el texto de ayuda del campo.
help_text: Attr<Lc>, help_text: Lc,
/// Devuelve la longitud mínima permitida en caracteres. /// Devuelve la longitud mínima permitida en caracteres.
minlength: Attr<u16>, #[getters(copy)]
minlength: Option<u16>,
/// Devuelve la longitud máxima permitida en caracteres. /// Devuelve la longitud máxima permitida en caracteres.
maxlength: Attr<u16>, #[getters(copy)]
maxlength: Option<u16>,
/// Devuelve el texto indicativo del campo. /// Devuelve el texto indicativo del campo.
placeholder: Attr<Lc>, placeholder: Lc,
/// Devuelve la configuración de autocompletado del campo. /// Devuelve la configuración de autocompletado del campo.
autocomplete: Attr<form::Autocomplete>, autocomplete: Option<form::Autocomplete>,
/// Devuelve si el campo recibe el foco automáticamente al cargar la página. /// Devuelve si el campo recibe el foco automáticamente al cargar la página.
autofocus: bool, autofocus: bool,
/// Devuelve si el campo es de sólo lectura. /// Devuelve si el campo es de sólo lectura.
@ -183,7 +185,8 @@ pub struct Field {
/// Devuelve si el campo se muestra como texto plano sin bordes ni fondo. /// Devuelve si el campo se muestra como texto plano sin bordes ni fondo.
plaintext: bool, plaintext: bool,
/// Devuelve la sugerencia de teclado virtual para el campo. /// Devuelve la sugerencia de teclado virtual para el campo.
inputmode: Attr<Mode>, #[getters(copy)]
inputmode: Option<Mode>,
} }
#[async_trait] #[async_trait]
@ -199,7 +202,7 @@ impl Component for Field {
fn setup(&mut self, _cx: &Context) { fn setup(&mut self, _cx: &Context) {
if let Some(container_id) = self if let Some(container_id) = self
.id() .id()
.or_else(|| self.name().get().map(|n| util::join!("edit-", n))) .or_else(|| self.name().as_deref().map(|n| util::join!("edit-", n)))
{ {
self.alter_prop(PropsOp::ensure_id(container_id)); self.alter_prop(PropsOp::ensure_id(container_id));
} }
@ -225,9 +228,9 @@ impl Component for Field {
let strict = self.kind().is_strict(); let strict = self.kind().is_strict();
let masked = *self.kind() == Kind::StrictPassword; let masked = *self.kind() == Kind::StrictPassword;
let autocomplete = if strict { let autocomplete = if strict {
Some(form::Autocomplete::Off) Some(&form::Autocomplete::Off)
} else { } else {
self.autocomplete().get() self.autocomplete()
}; };
Ok(html! { Ok(html! {
@ -249,12 +252,12 @@ impl Component for Field {
type=(self.kind()) type=(self.kind())
id=[input_id.as_deref()] id=[input_id.as_deref()]
class=(input_class) class=(input_class)
name=[self.name().get()] name=[self.name().as_deref()]
value=[self.value().get()] value=[self.value().as_deref()]
minlength=[self.minlength().get()] minlength=[self.minlength()]
maxlength=[self.maxlength().get()] maxlength=[self.maxlength()]
placeholder=[self.placeholder().lookup(cx)] placeholder=[self.placeholder().lookup(cx)]
inputmode=[self.inputmode().get()] inputmode=[self.inputmode()]
autocomplete=[autocomplete] autocomplete=[autocomplete]
spellcheck=[strict.then_some("false")] spellcheck=[strict.then_some("false")]
autocorrect=[strict.then_some("off")] autocorrect=[strict.then_some("off")]
@ -418,41 +421,41 @@ impl Field {
self self
} }
/// Establece o elimina la etiqueta visible del campo (basta pasar `None` para quitarla). /// Establece la etiqueta visible del campo (usa [`Lc::none()`] para quitarla).
#[builder_fn] #[builder_fn]
pub fn with_label(mut self, label: impl Into<Option<Lc>>) -> Self { pub fn with_label(mut self, label: Lc) -> Self {
self.label.alter_opt(label.into()); self.label = label;
self self
} }
/// Establece o elimina el texto de ayuda del campo (basta pasar `None` para quitarlo). /// Establece el texto de ayuda del campo (usa [`Lc::none()`] para quitarlo).
#[builder_fn] #[builder_fn]
pub fn with_help_text(mut self, help_text: impl Into<Option<Lc>>) -> Self { pub fn with_help_text(mut self, help_text: Lc) -> Self {
self.help_text.alter_opt(help_text.into()); self.help_text = help_text;
self self
} }
/// Establece la longitud mínima permitida en caracteres (`None` para no imponer mínimo). /// Establece la longitud mínima permitida en caracteres (`None` para no imponer mínimo).
#[builder_fn] #[builder_fn]
pub fn with_minlength(mut self, minlength: Option<u16>) -> Self { pub fn with_minlength(mut self, minlength: impl Into<Option<u16>>) -> Self {
self.minlength.alter_opt(minlength); self.minlength = minlength.into();
self self
} }
/// Establece la longitud máxima permitida en caracteres (`None` para no imponer límite). /// Establece la longitud máxima permitida en caracteres (`None` para no imponer límite).
#[builder_fn] #[builder_fn]
pub fn with_maxlength(mut self, maxlength: Option<u16>) -> Self { pub fn with_maxlength(mut self, maxlength: impl Into<Option<u16>>) -> Self {
self.maxlength.alter_opt(maxlength); self.maxlength = maxlength.into();
self self
} }
/// Establece o elimina el texto indicativo del campo (`None` para quitarlo). /// Establece el texto indicativo del campo (usa [`Lc::none()`] para quitarlo).
/// ///
/// Este texto aparece en el mismo campo y desaparece en cuanto el usuario empieza a escribir. /// Este texto aparece en el mismo campo y desaparece en cuanto el usuario empieza a escribir.
/// Al ser texto visible para el usuario se acepta [`Lc`] para poder localizarlo. /// Al ser texto visible para el usuario se acepta [`Lc`] para poder localizarlo.
#[builder_fn] #[builder_fn]
pub fn with_placeholder(mut self, placeholder: impl Into<Option<Lc>>) -> Self { pub fn with_placeholder(mut self, placeholder: Lc) -> Self {
self.placeholder.alter_opt(placeholder.into()); self.placeholder = placeholder;
self self
} }
@ -462,8 +465,11 @@ impl Field {
/// [`Autocomplete::email()`](form::Autocomplete::email) o /// [`Autocomplete::email()`](form::Autocomplete::email) o
/// [`Autocomplete::current_password()`](form::Autocomplete::current_password)). /// [`Autocomplete::current_password()`](form::Autocomplete::current_password)).
#[builder_fn] #[builder_fn]
pub fn with_autocomplete(mut self, autocomplete: Option<form::Autocomplete>) -> Self { pub fn with_autocomplete(
self.autocomplete.alter_opt(autocomplete); mut self,
autocomplete: impl Into<Option<form::Autocomplete>>,
) -> Self {
self.autocomplete = autocomplete.into();
self self
} }
@ -510,8 +516,8 @@ impl Field {
/// A diferencia del atributo `type` ([`form::input::Kind`]), no restringe los valores aceptados /// A diferencia del atributo `type` ([`form::input::Kind`]), no restringe los valores aceptados
/// ni activa la validación del navegador; es sólo una sugerencia de presentación. /// ni activa la validación del navegador; es sólo una sugerencia de presentación.
#[builder_fn] #[builder_fn]
pub fn with_inputmode(mut self, inputmode: Option<Mode>) -> Self { pub fn with_inputmode(mut self, inputmode: impl Into<Option<Mode>>) -> Self {
self.inputmode.alter_opt(inputmode); self.inputmode = inputmode.into();
self self
} }
} }

View file

@ -35,17 +35,21 @@ pub struct Number {
/// Devuelve el nombre del campo. /// Devuelve el nombre del campo.
name: AttrName, name: AttrName,
/// Devuelve el valor inicial del campo. /// Devuelve el valor inicial del campo.
value: Attr<u64>, #[getters(copy)]
value: Option<u64>,
/// Devuelve la etiqueta del campo. /// Devuelve la etiqueta del campo.
label: Attr<Lc>, label: Lc,
/// Devuelve el texto de ayuda del campo. /// Devuelve el texto de ayuda del campo.
help_text: Attr<Lc>, help_text: Lc,
/// Devuelve el valor mínimo permitido. /// Devuelve el valor mínimo permitido.
min: Attr<u64>, #[getters(copy)]
min: Option<u64>,
/// Devuelve el valor máximo permitido. /// Devuelve el valor máximo permitido.
max: Attr<u64>, #[getters(copy)]
max: Option<u64>,
/// Devuelve el incremento entre valores del campo. /// Devuelve el incremento entre valores del campo.
step: Attr<u64>, #[getters(copy)]
step: Option<u64>,
/// Devuelve si el campo recibe el foco automáticamente al cargar la página. /// Devuelve si el campo recibe el foco automáticamente al cargar la página.
autofocus: bool, autofocus: bool,
/// Devuelve si el campo es de sólo lectura. /// Devuelve si el campo es de sólo lectura.
@ -69,7 +73,7 @@ impl Component for Number {
fn setup(&mut self, _cx: &Context) { fn setup(&mut self, _cx: &Context) {
if let Some(container_id) = self if let Some(container_id) = self
.id() .id()
.or_else(|| self.name().get().map(|n| util::join!("edit-", n))) .or_else(|| self.name().as_deref().map(|n| util::join!("edit-", n)))
{ {
self.alter_prop(PropsOp::ensure_id(container_id)); self.alter_prop(PropsOp::ensure_id(container_id));
} }
@ -100,11 +104,11 @@ impl Component for Number {
type="number" type="number"
id=[input_id.as_deref()] id=[input_id.as_deref()]
class="form-control" class="form-control"
name=[self.name().get()] name=[self.name().as_deref()]
min=[self.min().get()] min=[self.min()]
max=[self.max().get()] max=[self.max()]
step=[self.step().get()] step=[self.step()]
value=[self.value().get()] value=[self.value()]
autofocus[*self.autofocus()] autofocus[*self.autofocus()]
readonly[*self.readonly()] readonly[*self.readonly()]
required[*self.required()] required[*self.required()]
@ -146,36 +150,36 @@ impl Number {
/// Establece el valor inicial del campo. /// Establece el valor inicial del campo.
#[builder_fn] #[builder_fn]
pub fn with_value(mut self, value: Option<u64>) -> Self { pub fn with_value(mut self, value: impl Into<Option<u64>>) -> Self {
self.value.alter_opt(value); self.value = value.into();
self self
} }
/// Establece o elimina la etiqueta visible del campo (basta pasar `None` para quitarla). /// Establece la etiqueta visible del campo (usa [`Lc::none()`] para quitarla).
#[builder_fn] #[builder_fn]
pub fn with_label(mut self, label: impl Into<Option<Lc>>) -> Self { pub fn with_label(mut self, label: Lc) -> Self {
self.label.alter_opt(label.into()); self.label = label;
self self
} }
/// Establece o elimina el texto de ayuda del campo (basta pasar `None` para quitarlo). /// Establece el texto de ayuda del campo (usa [`Lc::none()`] para quitarlo).
#[builder_fn] #[builder_fn]
pub fn with_help_text(mut self, help_text: impl Into<Option<Lc>>) -> Self { pub fn with_help_text(mut self, help_text: Lc) -> Self {
self.help_text.alter_opt(help_text.into()); self.help_text = help_text;
self self
} }
/// Establece el valor mínimo permitido (`None` para no imponer mínimo). /// Establece el valor mínimo permitido (`None` para no imponer mínimo).
#[builder_fn] #[builder_fn]
pub fn with_min(mut self, min: Option<u64>) -> Self { pub fn with_min(mut self, min: impl Into<Option<u64>>) -> Self {
self.min.alter_opt(min); self.min = min.into();
self self
} }
/// Establece el valor máximo permitido (`None` para no imponer máximo). /// Establece el valor máximo permitido (`None` para no imponer máximo).
#[builder_fn] #[builder_fn]
pub fn with_max(mut self, max: Option<u64>) -> Self { pub fn with_max(mut self, max: impl Into<Option<u64>>) -> Self {
self.max.alter_opt(max); self.max = max.into();
self self
} }
@ -184,8 +188,8 @@ impl Number {
/// Pasar `None` omite el atributo `step` y deja que el navegador aplique su valor por defecto /// Pasar `None` omite el atributo `step` y deja que el navegador aplique su valor por defecto
/// (normalmente `1`). /// (normalmente `1`).
#[builder_fn] #[builder_fn]
pub fn with_step(mut self, step: Option<u64>) -> Self { pub fn with_step(mut self, step: impl Into<Option<u64>>) -> Self {
self.step.alter_opt(step); self.step = step.into();
self self
} }

View file

@ -101,9 +101,9 @@ pub struct Field {
/// Devuelve el nombre compartido por todos los botones de opción del grupo. /// Devuelve el nombre compartido por todos los botones de opción del grupo.
name: AttrName, name: AttrName,
/// Devuelve la etiqueta del grupo. /// Devuelve la etiqueta del grupo.
label: Attr<Lc>, label: Lc,
/// Devuelve el texto de ayuda del grupo. /// Devuelve el texto de ayuda del grupo.
help_text: Attr<Lc>, help_text: Lc,
/// Devuelve las opciones del grupo. /// Devuelve las opciones del grupo.
items: Vec<Item>, items: Vec<Item>,
/// Devuelve si la selección de alguna opción del grupo es obligatoria. /// Devuelve si la selección de alguna opción del grupo es obligatoria.
@ -141,7 +141,7 @@ impl Component for Field {
async fn prepare(&self, cx: &mut Context) -> Result<Markup, ComponentError> { async fn prepare(&self, cx: &mut Context) -> Result<Markup, ComponentError> {
// En `setup()` se garantiza que `name` e `id` están definidos antes del renderizado. // En `setup()` se garantiza que `name` e `id` están definidos antes del renderizado.
let name = self.name().get().unwrap(); let name = self.name().as_deref().unwrap();
let container_id = self.id().unwrap(); let container_id = self.id().unwrap();
Ok(html! { Ok(html! {
@ -178,8 +178,8 @@ impl Component for Field {
type="radio" type="radio"
id=(&item_id) id=(&item_id)
class="form-check-input" class="form-check-input"
name=(&name) name=(name)
value=[item.value().get()] value=[item.value().as_deref()]
checked[checked] checked[checked]
required[*self.required()] required[*self.required()]
disabled[*item.disabled() || *self.disabled()]; disabled[*item.disabled() || *self.disabled()];
@ -227,17 +227,17 @@ impl Field {
self self
} }
/// Establece o elimina la etiqueta visible del grupo (basta pasar `None` para quitarla). /// Establece la etiqueta visible del grupo (usa [`Lc::none()`] para quitarla).
#[builder_fn] #[builder_fn]
pub fn with_label(mut self, label: impl Into<Option<Lc>>) -> Self { pub fn with_label(mut self, label: Lc) -> Self {
self.label.alter_opt(label.into()); self.label = label;
self self
} }
/// Establece o elimina el texto de ayuda del grupo (basta pasar `None` para quitarlo). /// Establece el texto de ayuda del grupo (usa [`Lc::none()`] para quitarlo).
#[builder_fn] #[builder_fn]
pub fn with_help_text(mut self, help_text: impl Into<Option<Lc>>) -> Self { pub fn with_help_text(mut self, help_text: Lc) -> Self {
self.help_text.alter_opt(help_text.into()); self.help_text = help_text;
self self
} }

View file

@ -36,17 +36,21 @@ pub struct Range {
/// Devuelve el nombre del campo. /// Devuelve el nombre del campo.
name: AttrName, name: AttrName,
/// Devuelve el valor inicial del campo. /// Devuelve el valor inicial del campo.
value: Attr<f64>, #[getters(copy)]
value: Option<f64>,
/// Devuelve la etiqueta del campo. /// Devuelve la etiqueta del campo.
label: Attr<Lc>, label: Lc,
/// Devuelve el texto de ayuda del campo. /// Devuelve el texto de ayuda del campo.
help_text: Attr<Lc>, help_text: Lc,
/// Devuelve el valor mínimo permitido. /// Devuelve el valor mínimo permitido.
min: Attr<f64>, #[getters(copy)]
min: Option<f64>,
/// Devuelve el valor máximo permitido. /// Devuelve el valor máximo permitido.
max: Attr<f64>, #[getters(copy)]
max: Option<f64>,
/// Devuelve el incremento entre valores del campo. /// Devuelve el incremento entre valores del campo.
step: Attr<f64>, #[getters(copy)]
step: Option<f64>,
/// Devuelve si el control recibe el foco automáticamente al cargar la página. /// Devuelve si el control recibe el foco automáticamente al cargar la página.
autofocus: bool, autofocus: bool,
/// Devuelve si el control está deshabilitado. /// Devuelve si el control está deshabilitado.
@ -66,7 +70,7 @@ impl Component for Range {
fn setup(&mut self, _cx: &Context) { fn setup(&mut self, _cx: &Context) {
if let Some(container_id) = self if let Some(container_id) = self
.id() .id()
.or_else(|| self.name().get().map(|n| util::join!("edit-", n))) .or_else(|| self.name().as_deref().map(|n| util::join!("edit-", n)))
{ {
self.alter_prop(PropsOp::ensure_id(container_id)); self.alter_prop(PropsOp::ensure_id(container_id));
}; };
@ -87,11 +91,11 @@ impl Component for Range {
type="range" type="range"
id=[range_id.as_deref()] id=[range_id.as_deref()]
class="form-range" class="form-range"
name=[self.name().get()] name=[self.name().as_deref()]
min=[self.min().get()] min=[self.min()]
max=[self.max().get()] max=[self.max()]
step=[self.step().get()] step=[self.step()]
value=[self.value().get()] value=[self.value()]
autofocus[*self.autofocus()] autofocus[*self.autofocus()]
disabled[*self.disabled()]; disabled[*self.disabled()];
@if let Some(description) = self.help_text().lookup(cx) { @if let Some(description) = self.help_text().lookup(cx) {
@ -134,22 +138,22 @@ impl Range {
/// Pasar `None` omite el atributo `value` y deja que el navegador aplique su valor por defecto /// Pasar `None` omite el atributo `value` y deja que el navegador aplique su valor por defecto
/// (normalmente el punto medio del rango). /// (normalmente el punto medio del rango).
#[builder_fn] #[builder_fn]
pub fn with_value(mut self, value: Option<f64>) -> Self { pub fn with_value(mut self, value: impl Into<Option<f64>>) -> Self {
self.value.alter_opt(value); self.value = value.into();
self self
} }
/// Establece o elimina la etiqueta visible del campo (basta pasar `None` para quitarla). /// Establece la etiqueta visible del campo (usa [`Lc::none()`] para quitarla).
#[builder_fn] #[builder_fn]
pub fn with_label(mut self, label: impl Into<Option<Lc>>) -> Self { pub fn with_label(mut self, label: Lc) -> Self {
self.label.alter_opt(label.into()); self.label = label;
self self
} }
/// Establece o elimina el texto de ayuda del campo (basta pasar `None` para quitarlo). /// Establece el texto de ayuda del campo (usa [`Lc::none()`] para quitarlo).
#[builder_fn] #[builder_fn]
pub fn with_help_text(mut self, help_text: impl Into<Option<Lc>>) -> Self { pub fn with_help_text(mut self, help_text: Lc) -> Self {
self.help_text.alter_opt(help_text.into()); self.help_text = help_text;
self self
} }
@ -157,8 +161,8 @@ impl Range {
/// ///
/// Pasar `None` omite el atributo `min` y deja que el navegador aplique su valor por defecto. /// Pasar `None` omite el atributo `min` y deja que el navegador aplique su valor por defecto.
#[builder_fn] #[builder_fn]
pub fn with_min(mut self, min: Option<f64>) -> Self { pub fn with_min(mut self, min: impl Into<Option<f64>>) -> Self {
self.min.alter_opt(min); self.min = min.into();
self self
} }
@ -166,8 +170,8 @@ impl Range {
/// ///
/// Pasar `None` omite el atributo `max` y deja que el navegador aplique su valor por defecto. /// Pasar `None` omite el atributo `max` y deja que el navegador aplique su valor por defecto.
#[builder_fn] #[builder_fn]
pub fn with_max(mut self, max: Option<f64>) -> Self { pub fn with_max(mut self, max: impl Into<Option<f64>>) -> Self {
self.max.alter_opt(max); self.max = max.into();
self self
} }
@ -176,8 +180,8 @@ impl Range {
/// Pasar `None` omite el atributo `step` y deja que el navegador aplique su valor por defecto /// Pasar `None` omite el atributo `step` y deja que el navegador aplique su valor por defecto
/// (normalmente `1`). /// (normalmente `1`).
#[builder_fn] #[builder_fn]
pub fn with_step(mut self, step: Option<f64>) -> Self { pub fn with_step(mut self, step: impl Into<Option<f64>>) -> Self {
self.step.alter_opt(step); self.step = step.into();
self self
} }

View file

@ -197,17 +197,18 @@ pub struct Field {
/// Devuelve el nombre del campo. /// Devuelve el nombre del campo.
name: AttrName, name: AttrName,
/// Devuelve la etiqueta del campo. /// Devuelve la etiqueta del campo.
label: Attr<Lc>, label: Lc,
/// Devuelve el texto de ayuda del campo. /// Devuelve el texto de ayuda del campo.
help_text: Attr<Lc>, help_text: Lc,
/// Devuelve las entradas de la lista (elementos individuales y grupos de elementos). /// Devuelve las entradas de la lista (elementos individuales y grupos de elementos).
entries: Vec<Entry>, entries: Vec<Entry>,
/// Devuelve si la lista permite selección múltiple. /// Devuelve si la lista permite selección múltiple.
multiple: bool, multiple: bool,
/// Devuelve el número de filas visibles de la lista de selección. /// Devuelve el número de filas visibles de la lista de selección.
rows: Attr<u16>, #[getters(copy)]
rows: Option<u16>,
/// Devuelve la configuración de autocompletado del campo. /// Devuelve la configuración de autocompletado del campo.
autocomplete: Attr<form::Autocomplete>, autocomplete: Option<form::Autocomplete>,
/// Devuelve si la lista recibe el foco automáticamente al cargar la página. /// Devuelve si la lista recibe el foco automáticamente al cargar la página.
autofocus: bool, autofocus: bool,
/// Devuelve si la selección de un elemento es obligatoria. /// Devuelve si la selección de un elemento es obligatoria.
@ -229,7 +230,7 @@ impl Component for Field {
fn setup(&mut self, _cx: &Context) { fn setup(&mut self, _cx: &Context) {
if let Some(container_id) = self if let Some(container_id) = self
.id() .id()
.or_else(|| self.name().get().map(|n| util::join!("edit-", n))) .or_else(|| self.name().as_deref().map(|n| util::join!("edit-", n)))
{ {
self.alter_prop(PropsOp::ensure_id(container_id)); self.alter_prop(PropsOp::ensure_id(container_id));
} }
@ -260,10 +261,10 @@ impl Component for Field {
select select
id=[select_id.as_deref()] id=[select_id.as_deref()]
class="form-select" class="form-select"
name=[self.name().get()] name=[self.name().as_deref()]
multiple[*self.multiple()] multiple[*self.multiple()]
size=[self.rows().get()] size=[self.rows()]
autocomplete=[self.autocomplete().get()] autocomplete=[self.autocomplete()]
autofocus[*self.autofocus()] autofocus[*self.autofocus()]
required[*self.required()] required[*self.required()]
disabled[*self.disabled()] disabled[*self.disabled()]
@ -272,7 +273,7 @@ impl Component for Field {
@match entry { @match entry {
Entry::Item(opt) => { Entry::Item(opt) => {
option option
value=(opt.value().as_str().unwrap_or("")) value=(opt.value().as_deref().unwrap_or(""))
selected[*opt.selected()] selected[*opt.selected()]
disabled[*opt.disabled()] disabled[*opt.disabled()]
{ {
@ -286,7 +287,7 @@ impl Component for Field {
{ {
@for opt in group.items() { @for opt in group.items() {
option option
value=(opt.value().as_str().unwrap_or("")) value=(opt.value().as_deref().unwrap_or(""))
selected[*opt.selected()] selected[*opt.selected()]
disabled[*opt.disabled()] disabled[*opt.disabled()]
{ {
@ -333,17 +334,17 @@ impl Field {
self self
} }
/// Establece o elimina la etiqueta visible del campo (basta pasar `None` para quitarla). /// Establece la etiqueta visible del campo (usa [`Lc::none()`] para quitarla).
#[builder_fn] #[builder_fn]
pub fn with_label(mut self, label: impl Into<Option<Lc>>) -> Self { pub fn with_label(mut self, label: Lc) -> Self {
self.label.alter_opt(label.into()); self.label = label;
self self
} }
/// Establece o elimina el texto de ayuda del campo (basta pasar `None` para quitarlo). /// Establece el texto de ayuda del campo (usa [`Lc::none()`] para quitarlo).
#[builder_fn] #[builder_fn]
pub fn with_help_text(mut self, help_text: impl Into<Option<Lc>>) -> Self { pub fn with_help_text(mut self, help_text: Lc) -> Self {
self.help_text.alter_opt(help_text.into()); self.help_text = help_text;
self self
} }
@ -389,8 +390,8 @@ impl Field {
/// Es especialmente útil con selección múltiple para controlar el número de filas visibles sin /// Es especialmente útil con selección múltiple para controlar el número de filas visibles sin
/// necesidad de recurrir al desplazamiento. /// necesidad de recurrir al desplazamiento.
#[builder_fn] #[builder_fn]
pub fn with_rows(mut self, rows: Option<u16>) -> Self { pub fn with_rows(mut self, rows: impl Into<Option<u16>>) -> Self {
self.rows.alter_opt(rows); self.rows = rows.into();
self self
} }
@ -404,8 +405,11 @@ impl Field {
/// Usa los métodos de [`form::Autocomplete`] para los valores más habituales. Pasa `None` para /// Usa los métodos de [`form::Autocomplete`] para los valores más habituales. Pasa `None` para
/// omitir el atributo. /// omitir el atributo.
#[builder_fn] #[builder_fn]
pub fn with_autocomplete(mut self, autocomplete: Option<form::Autocomplete>) -> Self { pub fn with_autocomplete(
self.autocomplete.alter_opt(autocomplete); mut self,
autocomplete: impl Into<Option<form::Autocomplete>>,
) -> Self {
self.autocomplete = autocomplete.into();
self self
} }

View file

@ -40,19 +40,22 @@ pub struct Textarea {
/// Devuelve el valor inicial del área de texto. /// Devuelve el valor inicial del área de texto.
value: AttrValue, value: AttrValue,
/// Devuelve la etiqueta del campo. /// Devuelve la etiqueta del campo.
label: Attr<Lc>, label: Lc,
/// Devuelve el texto de ayuda del campo. /// Devuelve el texto de ayuda del campo.
help_text: Attr<Lc>, help_text: Lc,
/// Devuelve el número de filas visibles del área de texto. /// Devuelve el número de filas visibles del área de texto.
rows: Attr<u16>, #[getters(copy)]
rows: Option<u16>,
/// Devuelve la longitud mínima permitida en caracteres. /// Devuelve la longitud mínima permitida en caracteres.
minlength: Attr<u16>, #[getters(copy)]
minlength: Option<u16>,
/// Devuelve la longitud máxima permitida en caracteres. /// Devuelve la longitud máxima permitida en caracteres.
maxlength: Attr<u16>, #[getters(copy)]
maxlength: Option<u16>,
/// Devuelve el texto indicativo del área de texto. /// Devuelve el texto indicativo del área de texto.
placeholder: Attr<Lc>, placeholder: Lc,
/// Devuelve la configuración de autocompletado del campo. /// Devuelve la configuración de autocompletado del campo.
autocomplete: Attr<form::Autocomplete>, autocomplete: Option<form::Autocomplete>,
/// Devuelve si el campo recibe el foco automáticamente al cargar la página. /// Devuelve si el campo recibe el foco automáticamente al cargar la página.
autofocus: bool, autofocus: bool,
/// Devuelve si el campo es de sólo lectura. /// Devuelve si el campo es de sólo lectura.
@ -76,7 +79,7 @@ impl Component for Textarea {
fn setup(&mut self, _cx: &Context) { fn setup(&mut self, _cx: &Context) {
if let Some(container_id) = self if let Some(container_id) = self
.id() .id()
.or_else(|| self.name().get().map(|n| util::join!("edit-", n))) .or_else(|| self.name().as_deref().map(|n| util::join!("edit-", n)))
{ {
self.alter_prop(PropsOp::ensure_id(container_id)); self.alter_prop(PropsOp::ensure_id(container_id));
} }
@ -109,18 +112,18 @@ impl Component for Textarea {
textarea textarea
id=[textarea_id.as_deref()] id=[textarea_id.as_deref()]
class="form-control" class="form-control"
name=[self.name().get()] name=[self.name().as_deref()]
rows=[self.rows().get()] rows=[self.rows()]
minlength=[self.minlength().get()] minlength=[self.minlength()]
maxlength=[self.maxlength().get()] maxlength=[self.maxlength()]
placeholder=[self.placeholder().lookup(cx)] placeholder=[self.placeholder().lookup(cx)]
autocomplete=[self.autocomplete().get()] autocomplete=[self.autocomplete()]
autofocus[*self.autofocus()] autofocus[*self.autofocus()]
readonly[*self.readonly()] readonly[*self.readonly()]
required[*self.required()] required[*self.required()]
disabled[*self.disabled()] disabled[*self.disabled()]
{ {
@if let Some(value) = self.value().get() { @if let Some(value) = self.value().as_deref() {
(value) (value)
} }
} }
@ -166,17 +169,17 @@ impl Textarea {
self self
} }
/// Establece o elimina la etiqueta visible del campo (basta pasar `None` para quitarla). /// Establece la etiqueta visible del campo (usa [`Lc::none()`] para quitarla).
#[builder_fn] #[builder_fn]
pub fn with_label(mut self, label: impl Into<Option<Lc>>) -> Self { pub fn with_label(mut self, label: Lc) -> Self {
self.label.alter_opt(label.into()); self.label = label;
self self
} }
/// Establece o elimina el texto de ayuda del campo (basta pasar `None` para quitarlo). /// Establece el texto de ayuda del campo (usa [`Lc::none()`] para quitarlo).
#[builder_fn] #[builder_fn]
pub fn with_help_text(mut self, help_text: impl Into<Option<Lc>>) -> Self { pub fn with_help_text(mut self, help_text: Lc) -> Self {
self.help_text.alter_opt(help_text.into()); self.help_text = help_text;
self self
} }
@ -185,32 +188,32 @@ impl Textarea {
/// Sin valor o pasando `None`, el área muestra su altura predeterminada, dos filas según el /// Sin valor o pasando `None`, el área muestra su altura predeterminada, dos filas según el
/// estándar. /// estándar.
#[builder_fn] #[builder_fn]
pub fn with_rows(mut self, rows: Option<u16>) -> Self { pub fn with_rows(mut self, rows: impl Into<Option<u16>>) -> Self {
self.rows.alter_opt(rows); self.rows = rows.into();
self self
} }
/// Establece la longitud mínima permitida en caracteres. /// Establece la longitud mínima permitida en caracteres.
#[builder_fn] #[builder_fn]
pub fn with_minlength(mut self, minlength: Option<u16>) -> Self { pub fn with_minlength(mut self, minlength: impl Into<Option<u16>>) -> Self {
self.minlength.alter_opt(minlength); self.minlength = minlength.into();
self self
} }
/// Establece la longitud máxima permitida en caracteres. /// Establece la longitud máxima permitida en caracteres.
#[builder_fn] #[builder_fn]
pub fn with_maxlength(mut self, maxlength: Option<u16>) -> Self { pub fn with_maxlength(mut self, maxlength: impl Into<Option<u16>>) -> Self {
self.maxlength.alter_opt(maxlength); self.maxlength = maxlength.into();
self self
} }
/// Establece o elimina el texto indicativo del área de texto (`None` para quitarlo). /// Establece el texto indicativo del área de texto (usa [`Lc::none()`] para quitarlo).
/// ///
/// Este texto aparece en el área de texto y desaparece en cuanto el usuario empieza a escribir. /// Este texto aparece en el área de texto y desaparece en cuanto el usuario empieza a escribir.
/// Al ser texto visible para el usuario se acepta [`Lc`] para poder localizarlo. /// Al ser texto visible para el usuario se acepta [`Lc`] para poder localizarlo.
#[builder_fn] #[builder_fn]
pub fn with_placeholder(mut self, placeholder: impl Into<Option<Lc>>) -> Self { pub fn with_placeholder(mut self, placeholder: Lc) -> Self {
self.placeholder.alter_opt(placeholder.into()); self.placeholder = placeholder;
self self
} }
@ -222,8 +225,11 @@ impl Textarea {
/// Usa los métodos de [`form::Autocomplete`] para los valores más habituales. Pasa `None` para /// Usa los métodos de [`form::Autocomplete`] para los valores más habituales. Pasa `None` para
/// omitir el atributo. /// omitir el atributo.
#[builder_fn] #[builder_fn]
pub fn with_autocomplete(mut self, autocomplete: Option<form::Autocomplete>) -> Self { pub fn with_autocomplete(
self.autocomplete.alter_opt(autocomplete); mut self,
autocomplete: impl Into<Option<form::Autocomplete>>,
) -> Self {
self.autocomplete = autocomplete.into();
self self
} }

View file

@ -29,7 +29,7 @@ pub struct Image {
/// Devuelve el origen de la imagen. /// Devuelve el origen de la imagen.
source: image::Source, source: image::Source,
/// Devuelve el texto alternativo localizado. /// Devuelve el texto alternativo localizado.
alternative: Attr<Lc>, alternative: Lc,
} }
#[async_trait] #[async_trait]
@ -140,7 +140,7 @@ impl Image {
/// decorativa. /// decorativa.
#[builder_fn] #[builder_fn]
pub fn with_alternative(mut self, alt: Lc) -> Self { pub fn with_alternative(mut self, alt: Lc) -> Self {
self.alternative.alter_value(alt); self.alternative = alt;
self self
} }
} }

View file

@ -263,8 +263,8 @@ impl Intro {
/// let intro_no_button = Intro::default().with_button(None); /// let intro_no_button = Intro::default().with_button(None);
/// ``` /// ```
#[builder_fn] #[builder_fn]
pub fn with_button(mut self, button: Option<(Lc, Route)>) -> Self { pub fn with_button(mut self, button: impl Into<Option<(Lc, Route)>>) -> Self {
self.button = button; self.button = button.into();
self self
} }

View file

@ -203,11 +203,11 @@ impl Component for Pager {
return Ok(html! {}); return Ok(html! {});
} }
let page = self.current_page().clamp(1, total_pages); let page = self.current_page().clamp(1, total_pages);
let base_path = self.base_path().as_str().unwrap_or_default(); let base_path = self.base_path().as_deref().unwrap_or("");
// Ruta común a los enlaces del paginador, con los parámetros de `extra_query` añadidos a // Ruta común a los enlaces del paginador, con los parámetros de `extra_query` añadidos a
// `base_path`. Pasa por `cx.route()` para preservar el parámetro `lang` si corresponde. // `base_path`. Pasa por `cx.route()` para preservar el parámetro `lang` si corresponde.
let mut route = cx.route(base_path.to_owned()); let mut route = cx.route(base_path);
for (key, value) in self.extra_query() { for (key, value) in self.extra_query() {
route.alter_param(key, value); route.alter_param(key, value);
} }

View file

@ -99,7 +99,7 @@ impl Column {
html! { html! {
th (self.props()) scope="col" aria-sort=(aria_sort) { th (self.props()) scope="col" aria-sort=(aria_sort) {
a href=[sort.href().as_str()] (link_props) { (label) } a href=[sort.href().as_deref()] (link_props) { (label) }
} }
} }
} }

View file

@ -21,7 +21,7 @@ use crate::prelude::*;
/// .with_prop(PropsOp::set("data-sort", "email")); /// .with_prop(PropsOp::set("data-sort", "email"));
/// ///
/// assert_eq!(link.props().get_id(), Some("sort-email".to_string())); /// assert_eq!(link.props().get_id(), Some("sort-email".to_string()));
/// assert_eq!(link.href().as_str(), Some("/admin/users?sort=email")); /// assert_eq!(link.href().as_deref(), Some("/admin/users?sort=email"));
/// assert_eq!(link.dir(), Some(&SortDir::Desc)); /// assert_eq!(link.dir(), Some(&SortDir::Desc));
/// ``` /// ```
/// ///

View file

@ -45,8 +45,8 @@ impl Child {
/// ///
/// Si se proporciona `Some(component)`, se encapsula como [`Child`]; y si es `None`, se limpia. /// Si se proporciona `Some(component)`, se encapsula como [`Child`]; y si es `None`, se limpia.
#[builder_fn] #[builder_fn]
pub fn with_component<C: Component>(mut self, component: Option<C>) -> Self { pub fn with_component<C: Component>(mut self, component: impl Into<Option<C>>) -> Self {
self.0 = component.map(|c| Arc::new(c) as Arc<dyn Component>); self.0 = component.into().map(|c| Arc::new(c) as Arc<dyn Component>);
self self
} }
@ -166,8 +166,8 @@ impl<C: Component> Embed<C> {
/// ///
/// Si se proporciona `Some(component)`, se encapsula como [`Embed`]; y si es `None`, se limpia. /// Si se proporciona `Some(component)`, se encapsula como [`Embed`]; y si es `None`, se limpia.
#[builder_fn] #[builder_fn]
pub fn with_component(mut self, component: Option<C>) -> Self { pub fn with_component(mut self, component: impl Into<Option<C>>) -> Self {
self.0 = component.map(Arc::new); self.0 = component.into().map(Arc::new);
self self
} }

View file

@ -26,7 +26,7 @@ pub use logo::PageTopSvg;
// **< HTML ATTRIBUTES >**************************************************************************** // **< HTML ATTRIBUTES >****************************************************************************
mod attr; mod attr;
pub use attr::{Attr, AttrName, AttrValue}; pub use attr::{AttrName, AttrValue};
mod props; mod props;
pub use props::{Props, PropsError, PropsExtra, PropsOp}; pub use props::{Props, PropsError, PropsExtra, PropsOp};

View file

@ -1,133 +1,5 @@
use crate::locale::{LangId, Lc};
use crate::{AutoDefault, builder_fn, util}; use crate::{AutoDefault, builder_fn, util};
/// Valor opcional para atributos HTML.
///
/// `Attr<T>` encapsula un `Option<T>` y sirve como tipo base para representar atributos HTML
/// opcionales, uniformes y tipados.
///
/// Este tipo **no impone ninguna normalización ni semántica concreta**; dichas reglas se definen en
/// implementaciones concretas como `Attr<Lc>` y `Attr<String>`, o en tipos específicos como
/// [`AttrName`].
#[derive(AutoDefault, Clone, Debug)]
pub struct Attr<T>(Option<T>);
impl<T> Attr<T> {
/// Crea un atributo vacío.
pub fn empty() -> Self {
Self(None)
}
/// Crea un atributo con valor.
pub fn some(value: T) -> Self {
Self(Some(value))
}
// **< Attr<T> BUILDER >************************************************************************
/// Establece un valor opcional para el atributo.
#[builder_fn]
pub fn with_opt(mut self, opt: Option<T>) -> Self {
self.0 = opt;
self
}
/// Establece un valor para el atributo.
#[builder_fn]
pub fn with_value(mut self, value: T) -> Self {
self.0 = Some(value);
self
}
/// Elimina el valor del atributo.
#[builder_fn]
pub fn with_none(mut self) -> Self {
self.0 = None;
self
}
// **< Attr<T> GETTERS >************************************************************************
/// Devuelve el valor (clonado), si existe.
pub fn get(&self) -> Option<T>
where
T: Clone,
{
self.0.clone()
}
/// Devuelve una referencia al valor, si existe.
pub fn as_ref(&self) -> Option<&T> {
self.0.as_ref()
}
/// Devuelve el valor (propiedad), si existe.
pub fn into_inner(self) -> Option<T> {
self.0
}
/// `true` si no hay valor.
pub fn is_empty(&self) -> bool {
self.0.is_none()
}
}
// **< Attr<Lc> >***********************************************************************************
/// Extiende [`Attr`] para [texto localizado](crate::locale) en atributos HTML.
///
/// Encapsula un [`Lc`] para manejar traducciones de forma segura en atributos.
///
/// # Ejemplo
///
/// ```rust
/// # use pagetop::prelude::*;
/// // Traducción por clave en las locales por defecto de PageTop.
/// let hello = Attr::<Lc>::new(Lc::l("test_hello_world"));
///
/// // Español disponible.
/// assert_eq!(
/// hello.lookup(&Locale::resolve("es-ES")),
/// Some("¡Hola mundo!".to_string())
/// );
///
/// // Japonés no disponible, traduce al idioma de respaldo (`"en-US"`).
/// assert_eq!(
/// hello.lookup(&Locale::resolve("ja-JP")),
/// Some("Hello world!".to_string())
/// );
///
/// // Uso típico en un atributo:
/// let title = hello.value(&Locale::resolve("es-ES"));
/// // Ejemplo: html! { a title=(title) { "Link" } }
/// ```
impl Attr<Lc> {
/// Crea una nueva instancia `Attr<Lc>`.
pub fn new(value: Lc) -> Self {
Self::some(value)
}
/// Devuelve la traducción para `language` si puede resolverse.
pub fn lookup(&self, language: &impl LangId) -> Option<String> {
self.0.as_ref()?.lookup(language)
}
/// Devuelve la traducción para `language` o una cadena vacía si no existe.
pub fn value(&self, language: &impl LangId) -> String {
self.lookup(language).unwrap_or_default()
}
}
// **< Attr<String> >*******************************************************************************
/// Extiende [`Attr`] para cadenas de texto.
impl Attr<String> {
/// Devuelve el texto como `&str` si existe.
pub fn as_str(&self) -> Option<&str> {
self.0.as_deref()
}
}
// **< AttrName >*********************************************************************************** // **< AttrName >***********************************************************************************
/// Nombre normalizado para el atributo `name` o similar de HTML. /// Nombre normalizado para el atributo `name` o similar de HTML.
@ -144,13 +16,13 @@ impl Attr<String> {
/// ```rust /// ```rust
/// # use pagetop::prelude::*; /// # use pagetop::prelude::*;
/// let name = AttrName::new(" DISplay name "); /// let name = AttrName::new(" DISplay name ");
/// assert_eq!(name.as_str(), Some("display_name")); /// assert_eq!(name.as_deref(), Some("display_name"));
/// ///
/// let empty = AttrName::default(); /// let empty = AttrName::default();
/// assert_eq!(empty.get(), None); /// assert_eq!(empty.get(), None);
/// ``` /// ```
#[derive(AutoDefault, Clone, Debug)] #[derive(AutoDefault, Clone, Debug)]
pub struct AttrName(Attr<String>); pub struct AttrName(Option<String>);
impl AttrName { impl AttrName {
/// Crea un nuevo `AttrName` normalizando el valor. /// Crea un nuevo `AttrName` normalizando el valor.
@ -163,33 +35,25 @@ impl AttrName {
/// Establece un nombre nuevo normalizando el valor. /// Establece un nombre nuevo normalizando el valor.
#[builder_fn] #[builder_fn]
pub fn with_name(mut self, name: impl AsRef<str>) -> Self { pub fn with_name(mut self, name: impl AsRef<str>) -> Self {
self.0 = match util::normalize_token(name) { self.0 = util::normalize_token(name);
Some(name) => Attr::some(name),
None => Attr::default(),
};
self self
} }
// **< AttrName GETTERS >*********************************************************************** // **< AttrName GETTERS >***********************************************************************
/// Devuelve el nombre normalizado, si existe.
pub fn get(&self) -> Option<String> {
self.0.get()
}
/// Devuelve el nombre normalizado (sin clonar), si existe. /// Devuelve el nombre normalizado (sin clonar), si existe.
pub fn as_str(&self) -> Option<&str> { pub fn as_deref(&self) -> Option<&str> {
self.0.as_str() self.0.as_deref()
} }
/// Devuelve el nombre normalizado (propiedad), si existe. /// Devuelve el nombre normalizado (clonado), si existe.
pub fn into_inner(self) -> Option<String> { pub fn get(&self) -> Option<String> {
self.0.into_inner() self.0.clone()
} }
/// `true` si no hay valor. /// `true` si no hay valor.
pub fn is_empty(&self) -> bool { pub fn is_empty(&self) -> bool {
self.0.is_empty() self.0.is_none()
} }
} }
@ -207,13 +71,13 @@ impl AttrName {
/// ```rust /// ```rust
/// # use pagetop::prelude::*; /// # use pagetop::prelude::*;
/// let s = AttrValue::new(" a new string "); /// let s = AttrValue::new(" a new string ");
/// assert_eq!(s.as_str(), Some("a new string")); /// assert_eq!(s.as_deref(), Some("a new string"));
/// ///
/// let empty = AttrValue::default(); /// let empty = AttrValue::default();
/// assert_eq!(empty.get(), None); /// assert_eq!(empty.get(), None);
/// ``` /// ```
#[derive(AutoDefault, Clone, Debug)] #[derive(AutoDefault, Clone, Debug)]
pub struct AttrValue(Attr<String>); pub struct AttrValue(Option<String>);
impl AttrValue { impl AttrValue {
/// Crea un nuevo `AttrValue` normalizando el valor. /// Crea un nuevo `AttrValue` normalizando el valor.
@ -226,32 +90,24 @@ impl AttrValue {
/// Establece una cadena nueva normalizando el valor. /// Establece una cadena nueva normalizando el valor.
#[builder_fn] #[builder_fn]
pub fn with_str(mut self, value: impl AsRef<str>) -> Self { pub fn with_str(mut self, value: impl AsRef<str>) -> Self {
self.0 = match util::non_blank(value.as_ref()) { self.0 = util::non_blank(value.as_ref()).map(str::to_string);
Some(value) => Attr::some(value.to_string()),
None => Attr::default(),
};
self self
} }
// **< AttrValue GETTERS >********************************************************************** // **< AttrValue GETTERS >**********************************************************************
/// Devuelve la cadena normalizada, si existe.
pub fn get(&self) -> Option<String> {
self.0.get()
}
/// Devuelve la cadena normalizada (sin clonar), si existe. /// Devuelve la cadena normalizada (sin clonar), si existe.
pub fn as_str(&self) -> Option<&str> { pub fn as_deref(&self) -> Option<&str> {
self.0.as_str() self.0.as_deref()
} }
/// Devuelve la cadena normalizada (propiedad), si existe. /// Devuelve la cadena normalizada (clonada), si existe.
pub fn into_inner(self) -> Option<String> { pub fn get(&self) -> Option<String> {
self.0.into_inner() self.0.clone()
} }
/// `true` si no hay valor. /// `true` si no hay valor.
pub fn is_empty(&self) -> bool { pub fn is_empty(&self) -> bool {
self.0.is_empty() self.0.is_none()
} }
} }

View file

@ -32,6 +32,7 @@ enum LcKind {
/// - Un texto puro (`n()`) que no requiere traducción. /// - Un texto puro (`n()`) que no requiere traducción.
/// - Una clave para traducir un texto del conjunto de traducciones predefinidas de PageTop (`l()`). /// - Una clave para traducir un texto del conjunto de traducciones predefinidas de PageTop (`l()`).
/// - Una clave para traducir de un conjunto concreto de traducciones (`t()`). /// - Una clave para traducir de un conjunto concreto de traducciones (`t()`).
/// - Ningún contenido (`none()`), para representar la ausencia en un campo `Lc` opcional.
/// ///
/// # ¿Cuál usar, `get()`, `lookup()` o `using()`? /// # ¿Cuál usar, `get()`, `lookup()` o `using()`?
/// ///
@ -122,6 +123,23 @@ impl Lc {
} }
} }
/// Crea una instancia **sin contenido**: no traduce nada y no representa ningún texto.
///
/// Equivale a [`Lc::default()`](Default::default), con un nombre más explícito. Útil para
/// representar la ausencia en un campo `Lc` opcional sin requerir `Option<Lc>`:
/// [`get()`](Self::get) y [`lookup()`](Self::lookup) devuelven `None`, y
/// [`using()`](Self::using) devuelve un marcado vacío.
///
/// ```rust
/// # use pagetop::prelude::*;
/// assert_eq!(Lc::none().get(), None);
/// ```
pub fn none() -> Self {
Self::default()
}
// **< Lc BUILDER >*****************************************************************************
/// Añade un argumento `{$arg}` => `value` a la traducción. /// Añade un argumento `{$arg}` => `value` a la traducción.
pub fn with_arg(mut self, arg: impl Into<CowStr>, value: impl Into<CowStr>) -> Self { pub fn with_arg(mut self, arg: impl Into<CowStr>, value: impl Into<CowStr>) -> Self {
self.args.push((arg.into(), value.into())); self.args.push((arg.into(), value.into()));
@ -142,6 +160,8 @@ impl Lc {
self self
} }
// **< Lc GETTERS >*****************************************************************************
/// Resuelve la traducción usando el idioma por defecto o, si no procede, el de respaldo de la /// Resuelve la traducción usando el idioma por defecto o, si no procede, el de respaldo de la
/// aplicación. /// aplicación.
/// ///

View file

@ -25,8 +25,8 @@ use crate::core::component::{AssetsOp, ChildOp, ComponentRender};
use crate::core::component::{Context, ContextError, Contextual}; use crate::core::component::{Context, ContextError, Contextual};
use crate::core::theme::{CoreRegions, RegionName, RegionRef, TemplateRef, ThemeRef}; use crate::core::theme::{CoreRegions, RegionName, RegionRef, TemplateRef, ThemeRef};
use crate::html::{Assets, Favicon, JavaScript, StyleSheet}; use crate::html::{Assets, Favicon, JavaScript, StyleSheet};
use crate::html::{Attr, Props, PropsOp};
use crate::html::{DOCTYPE, Markup, html}; use crate::html::{DOCTYPE, Markup, html};
use crate::html::{Props, PropsOp};
use crate::locale::{CharacterDirection, LangId, LanguageIdentifier, Lc}; use crate::locale::{CharacterDirection, LangId, LanguageIdentifier, Lc};
use crate::web::HttpRequest; use crate::web::HttpRequest;
use crate::{AutoDefault, builder_fn}; use crate::{AutoDefault, builder_fn};
@ -88,11 +88,11 @@ impl RegionName for ReservedRegions {
#[rustfmt::skip] #[rustfmt::skip]
#[derive(AutoDefault)] #[derive(AutoDefault)]
pub struct Page { pub struct Page {
title : Attr<Lc>, title : Lc,
description : Attr<Lc>, description: Lc,
metadata : Vec<(&'static str, &'static str)>, metadata : Vec<(&'static str, &'static str)>,
properties : Vec<(&'static str, &'static str)>, properties : Vec<(&'static str, &'static str)>,
context : Context, context : Context,
} }
impl Page { impl Page {
@ -128,14 +128,14 @@ impl Page {
/// Establece el título de la página como un valor traducible. /// Establece el título de la página como un valor traducible.
#[builder_fn] #[builder_fn]
pub fn with_title(mut self, title: Lc) -> Self { pub fn with_title(mut self, title: Lc) -> Self {
self.title.alter_value(title); self.title = title;
self self
} }
/// Establece la descripción de la página como un valor traducible. /// Establece la descripción de la página como un valor traducible.
#[builder_fn] #[builder_fn]
pub fn with_description(mut self, description: Lc) -> Self { pub fn with_description(mut self, description: Lc) -> Self {
self.description.alter_value(description); self.description = description;
self self
} }

45
tests/component_button.rs Normal file
View file

@ -0,0 +1,45 @@
use pagetop::prelude::*;
#[pagetop::test]
async fn label_is_rendered_when_set() {
let mut button = Button::submit(Lc::n("Save"));
let html = button.render(&mut Context::default()).await.into_string();
assert!(html.contains("Save"));
}
#[pagetop::test]
async fn label_can_be_cleared_with_lc_none() {
let mut button = Button::submit(Lc::n("Save")).with_label(Lc::none());
let html = button.render(&mut Context::default()).await.into_string();
assert!(!html.contains("Save"));
// The button itself must still render.
assert!(html.contains("<button"));
}
#[pagetop::test]
async fn title_attribute_is_absent_by_default() {
let mut button = Button::submit(Lc::n("Save"));
let html = button.render(&mut Context::default()).await.into_string();
assert!(!html.contains("title="));
}
#[pagetop::test]
async fn title_attribute_is_present_when_set() {
let mut button = Button::submit(Lc::n("Save")).with_title(Lc::n("Save changes"));
let html = button.render(&mut Context::default()).await.into_string();
assert!(html.contains(r#"title="Save changes""#));
}
#[pagetop::test]
async fn title_attribute_can_be_cleared_with_lc_none() {
let mut button = Button::submit(Lc::n("Save"))
.with_title(Lc::n("Save changes"))
.with_title(Lc::none());
let html = button.render(&mut Context::default()).await.into_string();
assert!(!html.contains("title="));
}

View file

@ -0,0 +1,72 @@
use pagetop::prelude::*;
#[pagetop::test]
async fn label_is_absent_by_default() {
let mut field = form::input::Field::text();
let html = field.render(&mut Context::default()).await.into_string();
assert!(!html.contains(r#"class="form-label""#));
}
#[pagetop::test]
async fn label_is_rendered_when_set() {
let mut field = form::input::Field::text().with_label(Lc::n("Full name"));
let html = field.render(&mut Context::default()).await.into_string();
assert!(html.contains(r#"class="form-label""#));
assert!(html.contains("Full name"));
}
#[pagetop::test]
async fn label_can_be_cleared_with_lc_none() {
let mut field = form::input::Field::text()
.with_label(Lc::n("Full name"))
.with_label(Lc::none());
let html = field.render(&mut Context::default()).await.into_string();
assert!(!html.contains(r#"class="form-label""#));
assert!(!html.contains("Full name"));
}
#[pagetop::test]
async fn help_text_is_absent_by_default() {
let mut field = form::input::Field::text();
let html = field.render(&mut Context::default()).await.into_string();
assert!(!html.contains(r#"class="form-text""#));
}
#[pagetop::test]
async fn help_text_is_rendered_when_set() {
let mut field = form::input::Field::text().with_help_text(Lc::n("We never share your data."));
let html = field.render(&mut Context::default()).await.into_string();
assert!(html.contains(r#"class="form-text""#));
assert!(html.contains("We never share your data."));
}
#[pagetop::test]
async fn placeholder_attribute_is_absent_by_default() {
let mut field = form::input::Field::text();
let html = field.render(&mut Context::default()).await.into_string();
assert!(!html.contains("placeholder="));
}
#[pagetop::test]
async fn placeholder_attribute_is_present_when_set() {
let mut field = form::input::Field::text().with_placeholder(Lc::n("Enter your name"));
let html = field.render(&mut Context::default()).await.into_string();
assert!(html.contains(r#"placeholder="Enter your name""#));
}
#[pagetop::test]
async fn placeholder_attribute_can_be_cleared_with_lc_none() {
let mut field = form::input::Field::text()
.with_placeholder(Lc::n("Enter your name"))
.with_placeholder(Lc::none());
let html = field.render(&mut Context::default()).await.into_string();
assert!(!html.contains("placeholder="));
}

38
tests/response_page.rs Normal file
View file

@ -0,0 +1,38 @@
use pagetop::prelude::*;
fn request() -> HttpRequest {
web::test::TestRequest::get().to_http_request()
}
#[pagetop::test]
async fn title_and_description_are_absent_by_default() {
let page = Page::new(request());
assert_eq!(page.title(), None);
assert_eq!(page.description(), None);
}
#[pagetop::test]
async fn title_and_description_reflect_the_values_set() {
let page = Page::new(request())
.with_title(Lc::n("Dashboard"))
.with_description(Lc::n("Overview of recent activity"));
assert_eq!(page.title(), Some("Dashboard".to_string()));
assert_eq!(
page.description(),
Some("Overview of recent activity".to_string())
);
}
#[pagetop::test]
async fn lc_none_clears_a_previously_set_title_and_description() {
let page = Page::new(request())
.with_title(Lc::n("Dashboard"))
.with_description(Lc::n("Overview of recent activity"))
.with_title(Lc::none())
.with_description(Lc::none());
assert_eq!(page.title(), None);
assert_eq!(page.description(), None);
}