♻️ (bootsier): Unifica nombre principal a Field
This commit is contained in:
parent
1313f5e05f
commit
9273be2110
3 changed files with 38 additions and 38 deletions
|
|
@ -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]
|
||||
|
|
|
|||
|
|
@ -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]
|
||||
|
|
|
|||
|
|
@ -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 {
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue