Traducción no oficial al español rioplatense, generada con IA (Claude Sonnet 5.5) bajo la dirección y revisión de Jassiel Ovando. No es una publicación de Typst GmbH ni cuenta con su aval; ante cualquier duda, prevalece la documentación oficial en inglés. ¿Un error de traducción o una sugerencia? Reportalo. Tipografía: Reforma, de PampaType.

listElemento
Signo de pregunta
Desde: siempreIr al código fuente

Una lista con viñetas.

Muestra verticalmente una secuencia de elementos, cada uno introducido por un marcador.

Ejemplo

Normal list.
- Text
- Math
- Layout
- ...

Multiple lines.
- This list item spans multiple
  lines because it is indented.

Function call.
#list(
  [Foundations],
  [Calculate],
  [Construct],
  [Data Loading],
)

Sintaxis

Esta función también tiene una sintaxis dedicada: empezá una línea con un guion seguido de un espacio para crear un elemento de lista. Un elemento de lista puede contener varios párrafos y otro contenido de bloque. Todo el contenido que tenga más sangría que el marcador de un elemento pasa a formar parte de ese elemento.

Parámetros

list(
tight: bool,marker: contentarrayfunction,indent: length,body-indent: length,spacing: autolength,marker-align: alignment,..content,
) → content

tight
bool
Configurable con set
Signo de pregunta
Por defecto: true

Define el espaciado por defecto de la lista. Si es false, los elementos se separan con el espaciado de párrafo. Si es true, en cambio usan el interlineado de párrafo. Esto hace que la lista sea más compacta, lo que puede verse mejor si los elementos son cortos.

En modo marcado, el valor de este parámetro se determina según si los elementos están separados por una línea en blanco. Si los elementos se siguen directamente, se establece en true; si los elementos están separados por una línea en blanco, se establece en false. La compacidad definida en el marcado no se puede reemplazar con reglas set.

ExpandirVer ejemplo
- If a list has a lot of text, and
  maybe other inline content, it
  should not be tight anymore.

- To make a list wide, simply insert
  a blank line between the items.

marker
content o array o function
Configurable con set
Signo de pregunta
Por defecto: ([•], [‣], [–])

El marcador que introduce cada elemento.

En lugar de contenido simple, también podés pasar un array con varios marcadores que se usarán para las listas anidadas. Si la profundidad de anidamiento de la lista supera la cantidad de marcadores, los marcadores se repiten cíclicamente. Para tener control total, podés pasar una función que asigne la profundidad de anidamiento de la lista (empezando desde 0) al marcador deseado.

ExpandirVer ejemplo
#set list(marker: [--])
- A more classic list
- With en-dashes

#set list(marker: ([•], [--]))
- Top-level
  - Nested
  - Items
- Items

indent
length
Configurable con set
Signo de pregunta
Por defecto: 0pt

La sangría de cada elemento.

body-indent
length
Configurable con set
Signo de pregunta
Por defecto: 0.5em

El espaciado entre el marcador y el cuerpo de cada elemento.

spacing
auto o length
Configurable con set
Signo de pregunta
Por defecto: auto

El espaciado entre los elementos de la lista.

Si se establece en auto, usa el leading del párrafo para las listas compactas y el spacing del párrafo para las listas amplias (no compactas).

marker-align
alignment
Configurable con set
Signo de pregunta
Por defecto: end

Alineación que se usa para los marcadores de lista.

La alineación vertical siempre es relativa a la altura de los elementos de la lista a los que están unidos. Por defecto no está especificada, lo que significa que cada marcador se alineará verticalmente con la línea base del elemento al que está unido (que suele ser su primera línea de texto o, si no, su parte superior).

La alineación horizontal, en cambio, es relativa a los otros marcadores del mismo nivel de la lista. Por defecto se establece en end, lo que significa que los marcadores se alinean hacia el final de la dirección de texto actual (right para texto LTR, left para RTL). Sin embargo, como los marcadores de cada nivel suelen ser idénticos, se espera que la alineación horizontal no tenga un efecto real la mayoría de las veces. De todos modos, todavía es posible que marque una diferencia en algunos casos, en particular si los marcadores usan contadores u otras formas de estado para mostrar contenido distinto en cada elemento.

ExpandirVer ejemplo
- Baseline \
  aligned

#set list(marker-align: horizon)

- Horizon \
  aligned

children
content
ObligatorioPosicional
Signo de pregunta
Variádico
Signo de pregunta

Los hijos de la lista con viñetas.

Al usar la sintaxis de lista, los elementos adyacentes se reúnen automáticamente en listas, incluso a través de construcciones como los bucles for.

ExpandirVer ejemplo
#for letter in "ABC" [
  - Letter #letter
]

Funciones
Signo de pregunta

itemElemento
Signo de pregunta
Desde: 0.4.0Ir al código fuente

Un elemento de una lista con viñetas.

list.item(content) → content

body
content
ObligatorioPosicional
Signo de pregunta

El cuerpo del elemento.