📝 Retoques menores en documentación
This commit is contained in:
parent
bfaf2e569f
commit
6203a02b89
4 changed files with 16 additions and 18 deletions
|
|
@ -85,7 +85,7 @@ pub fn html(input: TokenStream) -> TokenStream {
|
|||
/// b: 0,
|
||||
/// c: Some(0),
|
||||
/// d: vec![1, 2, 3],
|
||||
/// e: "four".to_owned(),
|
||||
/// e: "four".to_string(),
|
||||
/// });
|
||||
/// # }
|
||||
/// ```
|
||||
|
|
|
|||
|
|
@ -8,17 +8,15 @@ use crate::{util, AutoDefault, CowStr, Weight};
|
|||
/// Los distintos modos de carga permiten optimizar el rendimiento y controlar el comportamiento del
|
||||
/// script en relación con el análisis del documento HTML y la ejecución del resto de scripts.
|
||||
///
|
||||
/// - [`From`] - Carga estándar con la etiqueta `<script src="...">`.
|
||||
/// - [`Defer`] - Igual que [`From`], pero con el atributo `defer`, descarga en paralelo y se
|
||||
/// ejecuta tras el análisis del documento HTML, respetando el orden de
|
||||
/// aparición.
|
||||
/// - [`Async`] - Igual que [`From`], pero con el atributo `async`, descarga en paralelo y se
|
||||
/// ejecuta en cuanto esté listo, **sin garantizar** el orden relativo respecto
|
||||
/// a otros scripts.
|
||||
/// - [`Inline`] - Inserta el código directamente en la etiqueta `<script>`.
|
||||
/// - [`OnLoad`] - Inserta el código JavaScript y lo ejecuta tras el evento `DOMContentLoaded`.
|
||||
/// - [`From`] - Carga estándar con la etiqueta `<script src="...">`.
|
||||
/// - [`Defer`] - Igual que [`From`], pero con el atributo `defer`, descarga en paralelo y se
|
||||
/// ejecuta tras el análisis del documento HTML, respetando el orden de aparición.
|
||||
/// - [`Async`] - Igual que [`From`], pero con el atributo `async`, descarga en paralelo y se
|
||||
/// ejecuta en cuanto esté listo, **sin garantizar** el orden relativo respecto a otros scripts.
|
||||
/// - [`Inline`] - Inserta el código directamente en la etiqueta `<script>`.
|
||||
/// - [`OnLoad`] - Inserta el código JavaScript y lo ejecuta tras el evento `DOMContentLoaded`.
|
||||
/// - [`OnLoadAsync`] - Igual que [`OnLoad`], pero con manejador asíncrono (`async`), útil si dentro
|
||||
/// del código JavaScript se utiliza `await`.
|
||||
/// del código JavaScript se utiliza `await`.
|
||||
#[derive(AutoDefault)]
|
||||
enum Source {
|
||||
#[default]
|
||||
|
|
|
|||
|
|
@ -8,8 +8,8 @@ use crate::{util, AutoDefault, CowStr, Weight};
|
|||
/// Los estilos pueden cargarse desde un archivo externo o estar embebidos directamente en una
|
||||
/// etiqueta `<style>`.
|
||||
///
|
||||
/// - [`From`] - Carga la hoja de estilos desde un archivo externo, insertándola mediante una
|
||||
/// etiqueta `<link>` con `rel="stylesheet"`.
|
||||
/// - [`From`] - Carga la hoja de estilos desde un archivo externo, insertándola mediante una
|
||||
/// etiqueta `<link>` con `rel="stylesheet"`.
|
||||
/// - [`Inline`] - Inserta directamente el contenido CSS dentro de una etiqueta `<style>`.
|
||||
#[derive(AutoDefault)]
|
||||
enum Source {
|
||||
|
|
|
|||
|
|
@ -7,7 +7,7 @@ use std::str::FromStr;
|
|||
|
||||
/// Representa una **unidad CSS** lista para formatear o deserializar.
|
||||
///
|
||||
/// ## Unidades soportadas
|
||||
/// # Unidades soportadas
|
||||
///
|
||||
/// - **Absolutas** *(valores enteros, `isize`)*:
|
||||
/// - `Cm(isize)` - `cm` (centímetros)
|
||||
|
|
@ -24,13 +24,13 @@ use std::str::FromStr;
|
|||
/// - `RelVh(f32)` - `vh` (1% de la **altura** del viewport)
|
||||
/// - `RelVw(f32)` - `vw` (1% del **ancho** del viewport)
|
||||
///
|
||||
/// ## Valores especiales
|
||||
/// # Valores especiales
|
||||
///
|
||||
/// - `None` - equivale a un texto vacío (`""`), útil para atributos opcionales.
|
||||
/// - `Auto` - equivale a `"auto"`.
|
||||
/// - `Zero` - equivale a `"0"` (cero sin unidad).
|
||||
///
|
||||
/// ## Características
|
||||
/// # Características
|
||||
///
|
||||
/// - Soporta unidades **absolutas** (`cm`, `in`, `mm`, `pc`, `pt`, `px`) y **relativas** (`em`,
|
||||
/// `rem`, `%`, `vh`, `vw`).
|
||||
|
|
@ -38,7 +38,7 @@ use std::str::FromStr;
|
|||
/// - `Display` para formatear a cadena (p. ej., `UnitValue::Px(12)` genera `"12px"`).
|
||||
/// - `Deserialize` delega en `FromStr`, garantizando una gramática única.
|
||||
///
|
||||
/// ## Ejemplos
|
||||
/// # Ejemplos
|
||||
///
|
||||
/// ```rust
|
||||
/// # use pagetop::prelude::*;
|
||||
|
|
@ -52,7 +52,7 @@ use std::str::FromStr;
|
|||
/// assert_eq!(UnitValue::from_str("0").unwrap(), UnitValue::Zero);
|
||||
/// ```
|
||||
///
|
||||
/// ## Notas
|
||||
/// # Notas
|
||||
///
|
||||
/// - Las absolutas **no aceptan** decimales (p. ej., `"1.5px"` sería erróneo).
|
||||
/// - Se aceptan signos `+`/`-` en todas las unidades (p. ej., `"-12px"`, `"+0.5em"`).
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue