diff --git a/extensions/pagetop-bootsier/src/theme/form/check.rs b/extensions/pagetop-bootsier/src/theme/form/check.rs index b0578092..824ed92a 100644 --- a/extensions/pagetop-bootsier/src/theme/form/check.rs +++ b/extensions/pagetop-bootsier/src/theme/form/check.rs @@ -4,7 +4,7 @@ use pagetop::prelude::*; // **< Item >*************************************************************************************** -/// Casilla de verificación individual de un [`form::check::Group`](Group). +/// Casilla de verificación individual de un [`form::check::Field`](Field). /// /// Representa cada casilla de un grupo de casillas de verificación, con una etiqueta localizable /// visible. Puede marcarse como seleccionada o deshabilitada de forma independiente al resto. @@ -61,17 +61,17 @@ impl Item { } } -// **< Group >************************************************************************************** +// **< Field >************************************************************************************** /// Componente para crear un **grupo de casillas de verificación**. /// /// Renderiza un conjunto de casillas de verificación donde, a diferencia de un grupo de botones -/// [`form::radio::Group`](crate::theme::form::radio::Group), cada casilla puede marcarse de forma +/// [`form::radio::Field`](crate::theme::form::radio::Field), cada casilla puede marcarse de forma /// independiente. /// -/// Las casillas se añaden mediante [`with_item()`](Group::with_item) usando instancias de +/// Las casillas se añaden mediante [`with_item()`](Field::with_item) usando instancias de /// [`form::check::Item`](Item). Si se activa el modo en línea con -/// [`with_inline()`](Group::with_inline), las casillas se disponen horizontalmente. +/// [`with_inline()`](Field::with_inline), las casillas se disponen horizontalmente. /// /// El atributo `name` de cada casilla se construye automáticamente combinando el `name` del grupo /// y el `name` del [`form::check::Item`](Item) con un guion bajo. Por ejemplo, para el grupo con @@ -83,7 +83,7 @@ impl Item { /// ```rust /// # use pagetop::prelude::*; /// # use pagetop_bootsier::prelude::*; -/// let interests = form::check::Group::new() +/// let interests = form::check::Field::new() /// .with_name("interests") /// .with_label(L10n::n("Areas of interest")) /// .with_item(form::check::Item::new("art", L10n::n("Art"))) @@ -107,7 +107,7 @@ impl Item { /// } /// ``` #[derive(AutoDefault, Clone, Debug, Getters)] -pub struct Group { +pub struct Field { #[getters(skip)] id: AttrId, /// Devuelve las clases CSS del contenedor del grupo. @@ -126,7 +126,7 @@ pub struct Group { inline: bool, } -impl Component for Group { +impl Component for Field { fn new() -> Self { Self::default() } @@ -185,8 +185,8 @@ impl Component for Group { } } -impl Group { - // **< Group BUILDER >************************************************************************** +impl Field { + // **< Field BUILDER >************************************************************************** /// Establece el identificador único (`id`) del grupo de casillas. #[builder_fn] diff --git a/extensions/pagetop-bootsier/src/theme/form/radio.rs b/extensions/pagetop-bootsier/src/theme/form/radio.rs index a27a36a8..2514c4bf 100644 --- a/extensions/pagetop-bootsier/src/theme/form/radio.rs +++ b/extensions/pagetop-bootsier/src/theme/form/radio.rs @@ -6,7 +6,7 @@ use crate::LOCALES_BOOTSIER; // **< Item >*************************************************************************************** -/// Botón de opción individual de un [`form::radio::Group`](Group). +/// Botón de opción individual de un [`form::radio::Field`](Field). /// /// Representa cada opción de un grupo de opciones exclusivas entre sí, con un valor (el que se /// envía al servidor), una etiqueta localizable visible y puede marcarse como seleccionada o @@ -60,24 +60,24 @@ impl Item { } } -// **< Group >************************************************************************************** +// **< Field >************************************************************************************** /// Componente para crear un **grupo de botones de opción**. /// /// Renderiza un grupo de botones de opción [`form::radio::Item`](Item) que comparten el mismo /// atributo `name`, por lo que sólo puede seleccionarse uno a la vez. Las opciones se añaden con -/// [`with_item()`](Group::with_item). +/// [`with_item()`](Field::with_item). /// -/// Si se activa el modo en línea [`with_inline()`](Group::with_inline), los botones se -/// disponen horizontalmente. El atributo `required` se propaga a todos los botones del grupo para -/// cumplir con la especificación HTML. +/// Si se activa el modo en línea [`with_inline()`](Field::with_inline), los botones se disponen +/// horizontalmente. El atributo `required` se propaga a todos los botones del grupo para cumplir +/// con la especificación HTML. /// /// # Ejemplo /// /// ```rust /// # use pagetop::prelude::*; /// # use pagetop_bootsier::prelude::*; -/// let plan = form::radio::Group::new() +/// let plan = form::radio::Field::new() /// .with_name("plan") /// .with_label(L10n::n("Subscription plan")) /// .with_item(form::radio::Item::new("monthly", L10n::n("Monthly"))) @@ -95,7 +95,7 @@ impl Item { /// } /// ``` #[derive(AutoDefault, Clone, Debug, Getters)] -pub struct Group { +pub struct Field { #[getters(skip)] id: AttrId, /// Devuelve las clases CSS del contenedor del grupo. @@ -116,7 +116,7 @@ pub struct Group { inline: bool, } -impl Component for Group { +impl Component for Field { fn new() -> Self { Self::default() } @@ -187,8 +187,8 @@ impl Component for Group { } } -impl Group { - // **< Group BUILDER >************************************************************************** +impl Field { + // **< Field BUILDER >************************************************************************** /// Establece el identificador único (`id`) del grupo de opciones. #[builder_fn] diff --git a/extensions/pagetop-bootsier/src/theme/form/select.rs b/extensions/pagetop-bootsier/src/theme/form/select.rs index 5d5c53ec..10c6e9d8 100644 --- a/extensions/pagetop-bootsier/src/theme/form/select.rs +++ b/extensions/pagetop-bootsier/src/theme/form/select.rs @@ -7,7 +7,7 @@ use crate::LOCALES_BOOTSIER; // **< Item >*************************************************************************************** -/// Elemento individual de [`form::select::List`] o de [`form::select::Group`]. +/// Elemento individual de [`form::select::Field`] o de [`form::select::Group`]. /// /// Representa un elemento dentro de una lista de selección o de un grupo de elementos de la lista. /// Cada elemento tiene un valor que se envía al servidor y una etiqueta localizable visible para el @@ -67,7 +67,7 @@ impl Item { // **< Group >************************************************************************************** -/// Grupo de elementos dentro de [`form::select::List`]. +/// Grupo de elementos dentro de [`form::select::Field`]. /// /// Agrupa un conjunto de elementos dentro de una lista de selección con una etiqueta visible. El /// grupo completo puede deshabilitarse en bloque con [`with_disabled()`](Group::with_disabled). @@ -117,13 +117,13 @@ impl Group { // **< Entry >************************************************************************************** -/// Entrada de [`form::select::List`] con un elemento o un grupo de elementos. +/// Entrada de [`form::select::Field`] con un elemento o un grupo de elementos. /// -/// Cada entrada se crea implícitamente cuando se usa [`form::select::List::with_item()`] para -/// añadir un elemento individual o [`form::select::List::with_group()`] para añadir un grupo de +/// Cada entrada se crea implícitamente cuando se usa [`form::select::Field::with_item()`] para +/// añadir un elemento individual o [`form::select::Field::with_group()`] para añadir un grupo de /// elementos a una lista de selección. /// -/// Con [`form::select::List::entries()`] se pueden recuperar todas las entradas para su +/// Con [`form::select::Field::entries()`] se pueden recuperar todas las entradas para su /// renderizado. #[derive(Clone, Debug)] pub enum Entry { @@ -133,16 +133,16 @@ pub enum Entry { Group(Group), } -// **< List >*************************************************************************************** +// **< Field >************************************************************************************** /// Componente para crear una **lista de selección**. /// /// Renderiza un campo para mostrar una lista de elementos con una etiqueta opcional. Permite elegir /// uno, o más de uno si se activa la selección múltiple con -/// [`with_multiple()`](List::with_multiple). +/// [`with_multiple()`](Field::with_multiple). /// -/// Los elementos individuales se añaden con [`with_item()`](List::with_item); los grupos de -/// elementos con un encabezado común se añaden con [`with_group()`](List::with_group). Ambos +/// Los elementos individuales se añaden con [`with_item()`](Field::with_item); los grupos de +/// elementos con un encabezado común se añaden con [`with_group()`](Field::with_group). Ambos /// métodos pueden combinarse libremente. /// /// # Ejemplo @@ -150,7 +150,7 @@ pub enum Entry { /// ```rust /// # use pagetop::prelude::*; /// # use pagetop_bootsier::prelude::*; -/// let idioma = form::select::List::new() +/// let idioma = form::select::Field::new() /// .with_name("language") /// .with_label(L10n::n("Language")) /// .with_item(form::select::Item::new("", L10n::n("— Choose —")).with_selected(true)) @@ -190,7 +190,7 @@ pub enum Entry { /// } /// ``` #[derive(AutoDefault, Clone, Debug, Getters)] -pub struct List { +pub struct Field { #[getters(skip)] id: AttrId, /// Devuelve las clases CSS del contenedor de la lista de selección. @@ -217,7 +217,7 @@ pub struct List { disabled: bool, } -impl Component for List { +impl Component for Field { fn new() -> Self { Self::default() } @@ -299,8 +299,8 @@ impl Component for List { } } -impl List { - // **< List BUILDER >*************************************************************************** +impl Field { + // **< Field BUILDER >*************************************************************************** /// Establece el identificador único (`id`) del control. #[builder_fn] @@ -361,11 +361,11 @@ impl List { /// Establece si el control permite seleccionar varios elementos. /// /// Al activar la selección múltiple, se muestra una lista en lugar de un desplegable. Se - /// recomienda combinar con [`with_size()`](List::with_size) para controlar el número de filas + /// recomienda combinar con [`with_size()`](Field::with_size) para controlar el número de filas /// visibles. /// /// Para un número reducido de elementos con etiquetas descriptivas considera usar - /// [`form::check::Group`] en su lugar, ofrece una presentación más clara y es más accesible en + /// [`form::check::Field`] en su lugar, ofrece una presentación más clara y es más accesible en /// pantallas pequeñas. #[builder_fn] pub fn with_multiple(mut self, multiple: bool) -> Self {