use crate::prelude::*;
/// Representa una celda de datos (`
`) de una [`table::Row`].
///
/// El contenido es una lista [`Children`] para admitir cualquier número de componentes.
/// [`Cell::new()`] añade un componente como contenido inicial, normalmente un [`Lc`] con texto
/// literal ([`Lc::n()`]) o traducible (con [`Lc::l()`]/[`Lc::t()`]).
///
/// Un `&str`, un `String` o un [`Lc`] se convierten directamente en `Cell`; para estos tipos no
/// sería necesario llamar a [`Cell::new()`] de forma explícita.
///
/// ```rust,no_run
/// use pagetop::prelude::*;
///
/// let email: table::Cell = "ana@example.com".into();
/// let label: table::Cell = Lc::l("table-status").into();
/// let name = table::Cell::new(Html::with(|_| html! { "Julia" }));
/// ```
#[derive(AutoDefault, Clone, Debug, Getters)]
pub struct Cell {
/// Devuelve identificador, clases CSS y atributos HTML de la celda (` | `).
props: Props,
/// Devuelve la lista de componentes hijo que genera el contenido de la celda.
children: Children,
}
#[builder_impl]
impl Cell {
/// Crea una celda a partir del componente o texto ([`Lc`]) indicado.
///
/// Para combinar varios componentes en la misma celda basta con encadenar llamadas a
/// [`with_child()`](Cell::with_child):
///
/// ```rust,no_run
/// # use pagetop::prelude::*;
/// let status = table::Cell::new(Lc::n("Admin ")).with_child(Badge::labeled(Lc::n("active")));
/// ```
pub fn new(child: impl Into) -> Self {
Self {
children: Children::with(child.into()),
..Default::default()
}
}
// **< Cell BUILDER >***************************************************************************
/// Establece el identificador único de la celda.
pub fn with_id(mut self, id: impl Into) -> Self {
self.props.alter_id(id);
self
}
/// Modifica identificador, clases CSS o atributos HTML de la celda.
pub fn with_prop(mut self, op: PropsOp) -> Self {
self.props.alter_prop(op);
self
}
/// Establece el número de columnas que ocupa la celda (atributo `colspan`).
///
/// Con `1` (el valor por defecto de HTML) elimina el atributo en vez de fijarlo.
pub fn with_colspan(mut self, span: u8) -> Self {
self.props.alter_prop(if span == 1 {
PropsOp::remove("colspan")
} else {
PropsOp::set("colspan", span.to_string())
});
self
}
/// Establece el número de filas que ocupa la celda (atributo `rowspan`).
///
/// Con `1` (el valor por defecto de HTML) elimina el atributo en vez de fijarlo.
pub fn with_rowspan(mut self, span: u8) -> Self {
self.props.alter_prop(if span == 1 {
PropsOp::remove("rowspan")
} else {
PropsOp::set("rowspan", span.to_string())
});
self
}
/// Añade un nuevo componente a la celda o modifica la lista de componentes (`children`) con una
/// operación [`ChildOp`].
pub fn with_child(mut self, op: impl Into) -> Self {
self.children.alter_child(op.into());
self
}
}
impl From<&str> for Cell {
/// Convierte un `&str` en una celda de texto literal; equivale a `Cell::new(Lc::n(text))`.
fn from(text: &str) -> Self {
Cell::new(Lc::n(text.to_string()))
}
}
impl From for Cell {
/// Convierte un `String` en una celda de texto literal; equivale a `Cell::new(Lc::n(text))`.
fn from(text: String) -> Self {
Cell::new(Lc::n(text))
}
}
impl From for Cell {
/// Convierte un [`Lc`] en una celda traducible; equivale a `Cell::new(label)`.
fn from(label: Lc) -> Self {
Cell::new(label)
}
}
impl From for Cell {
/// Convierte cualquier componente en una celda; equivale a `Cell::new(component)`.
fn from(component: C) -> Self {
Cell::new(component)
}
}
|