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.

relativeDesde: siempreIr al código fuente

Una longitud en relación con alguna longitud conocida.

Este tipo es una combinación de una longitud con una proporción. Resulta de la suma y resta de una longitud y una proporción. Dondequiera que se espere una longitud relativa, también podés usar una longitud o una proporción a secas.

Relativa a la página

Un caso de uso común es establecer el ancho o el alto de un elemento de diseño (por ejemplo, block, rect, etcétera) como cierto porcentaje del ancho de la página. Acá, el ancho del rectángulo se establece en 25%, así que ocupa un cuarto del ancho interior de la página (el ancho menos los márgenes).

#rect(width: 25%)

Las longitudes o proporciones a secas siempre son válidas donde se esperan longitudes relativas, pero las dos también se pueden mezclar libremente:

#rect(width: 25% + 1cm)

Para el contenido del background y el foreground de la página, las longitudes relativas se resuelven respecto del tamaño de la página incluido el bleed. Esta elección se hace por comodidad, ya que crear un fondo que tenga bien en cuenta el sangrado requiere, inherentemente, extenderlo hacia el área de sangrado.

Si estás intentando dar tamaño a un elemento para que ocupe el ancho completo de la página, tenés algunas opciones (esto depende mucho de tu caso de uso exacto):

  1. Establecer los márgenes de página en 0pt (#set page(margin: 0pt))
  2. Multiplicar la proporción por el ancho completo conocido de la página (21cm * 69%)
  3. Usar relleno que anule los márgenes (#pad(x: -2.5cm, ...))
  4. Usar el campo background o foreground de la página, ya que no tienen en cuenta los márgenes (tené en cuenta que renderizará el contenido fuera del flujo del documento; mirá place para controlar la posición del contenido)

Relativa a un contenedor

Cuando un elemento de diseño (por ejemplo, un rect) está anidado en otro contenedor de diseño (por ejemplo, un block) en lugar de ser un descendiente directo de la página, los anchos relativos pasan a ser relativos al contenedor:

#block(
  width: 100pt,
  fill: aqua,
  rect(width: 50%),
)

Scripting

Podés multiplicar longitudes relativas por proporciones, enteros y flotantes.

Una longitud relativa tiene los siguientes campos:

#(100% - 50pt).length \
#(100% - 50pt).ratio