• 
• 
• Referencia
• 
• Fundamentos
• 
• Etiqueta

labelDesde: siempre

Una etiqueta para un elemento.

Al insertar una etiqueta en el contenido, esta se adjunta al elemento anterior más cercano que no sea un espacio. El elemento anterior debe estar en el mismo ámbito que la etiqueta, lo que significa que, por ejemplo, Hello #[<label>] no funcionaría.

Un elemento etiquetado se puede referenciar, consultar y estilizar a través de su etiqueta.

Una vez construida, podés obtener el nombre de una etiqueta usando str.

Ejemplo

#show <a>: set text(blue)
#show label("b"): set text(red)

= Heading <a>
*Strong* #label("b")

Sintaxis

Esta función también tiene una sintaxis dedicada: podés crear una etiqueta encerrando su nombre entre paréntesis angulares. Esto funciona tanto en marcado como en código. El nombre de una etiqueta puede contener letras, números, _, -, : y .. Una etiqueta no puede estar vacía.

Tené en cuenta que hay una diferencia sintáctica al usar la sintaxis dedicada de esta función. En el siguiente código, el <a> termina el título y, por lo tanto, se adjunta al título en sí, mientras que el #label("b") es parte del título y, por lo tanto, se adjunta al texto del título.

// Equivalent to `#heading[Introduction] <a>`.
= Introduction <a>

// Equivalent to `#heading[Conclusion #label("b")]`.
= Conclusion #label("b")

Actualmente, las etiquetas solo se pueden adjuntar a elementos en modo marcado, no en modo código. Esto podría cambiar en el futuro.

Constructor

Si un tipo tiene un constructor, podés llamarlo como una función para crear un valor nuevo de ese tipo.

Crea una etiqueta a partir de una cadena de texto.

name

str

ObligatorioPosicional

Los parámetros posicionales se especifican en orden, sin nombres.

El nombre de la etiqueta.

A diferencia de la sintaxis dedicada, este constructor acepta cualquier cadena de texto no vacía, incluidos los nombres con caracteres especiales.

EnteroPágina anterior

MóduloPágina siguiente