`) de una [`Table`].
///
/// El contenido (`label`) es un [`Lc`]. Si la columna debe permitir ordenar la tabla al pulsarla,
/// añade un [`table::SortLink`] con [`with_sort()`](Self::with_sort) para que `Table` envuelva la
/// etiqueta en un enlace y añada el `aria-sort` y las clases CSS correspondientes.
///
/// Un `&str`, un `String` o un [`Lc`] se convierten directamente en `Column`; para estos tipos no
/// sería necesario llamar a [`Column::new()`] de forma explícita.
///
/// ```rust
/// use pagetop::locale::Lc;
/// use pagetop::base::component::table::Column;
///
/// let column: Column = Lc::n("User").into();
/// assert_eq!(column.label().get(), Some("User".to_string()));
/// assert!(column.sort().is_none());
/// ```
#[derive(AutoDefault, Clone, Debug, Getters)]
pub struct Column {
/// Devuelve identificador, clases CSS y atributos HTML de la celda de cabecera (`
`).
props: Props,
/// Devuelve el contenido de la cabecera.
label: Lc,
/// Devuelve el enlace de ordenación de la columna, si es ordenable.
sort: Option,
}
#[builder_impl]
impl Column {
/// Crea una cabecera con el texto localizado indicado.
pub fn new(label: Lc) -> Self {
Self {
label,
..Default::default()
}
}
// **< Column BUILDER >*************************************************************************
/// Establece el identificador único de la celda de cabecera.
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 columna.
pub fn with_prop(mut self, op: PropsOp) -> Self {
self.props.alter_prop(op);
self
}
/// Establece el número de columnas que ocupa la cabecera (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 cabecera (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
}
/// Convierte la columna en ordenable con el enlace indicado, o la vuelve no ordenable con
/// `None`.
pub fn with_sort(mut self, sort: impl Into