boxElementoDesde: siempre
Un contenedor en línea que da tamaño al contenido.
Todos los elementos, excepto la matemática en línea, el texto y los boxes, son de nivel de bloque y no pueden aparecer dentro de un párrafo. La función box se puede usar para integrar esos elementos en un párrafo. Por defecto, los boxes toman el tamaño de su contenido, pero también se les puede dar tamaño explícitamente.
De manera similar a los bloques, los boxes se pueden usar para recortar contenido o para darle un fondo o un borde. Sin embargo, solo deberían usarse con estos fines si el contenedor resultante se usa en un contexto en línea. De lo contrario, es preferible un block.
Ejemplo
Refer to the docs
#box(
height: 9pt,
image("docs.svg")
)
for more information.
Parámetros
widthPor defecto: auto
El ancho del box.
Los boxes pueden tener anchos fraccionarios, como demuestra el siguiente ejemplo.
Nota: Actualmente, dentro de los párrafos solo los boxes, y solo sus anchos, pueden tener tamaño fraccionario. En el futuro se podría agregar compatibilidad con imágenes, formas y más con tamaño fraccionario.
Ver ejemplo
Line in #box(width: 1fr, line(length: 100%)) between.
heightPor defecto: auto
La altura del box.
baselinePor defecto: (at: auto, shift: 0% + 0pt)
La posición vertical de la línea base del box. Se usa para alinear el box con el texto que lo rodea en un párrafo, ya que la línea base está pensada para ir justo debajo del texto por defecto.
Por defecto, la línea base del box coincidirá con la línea base de su contenido (por ejemplo, del texto o la ecuación que contiene): esta es la opción auto. Sin embargo, la línea base se puede ajustar de dos maneras. La primera es simplemente elegir una alineación vertical, como top, horizon o bottom, para colocar la línea base en esa posición, en relación con la altura total del box (incluido el inset).
La otra manera de ajustarla es desplazar verticalmente la línea base por defecto una cierta cantidad, especificada como una longitud relativa. Por ejemplo, un valor de 2pt la moverá hacia arriba esa longitud exacta (lo que hace que el contenido baje, ya que el punto de alineación sube), mientras que -40% desplazará la línea base hacia abajo un 40 % de la altura total del box, incluido el inset (lo que hace que el contenido suba).
Ambas opciones se pueden especificar al mismo tiempo mediante un diccionario con las claves at y shift, respectivamente. Por ejemplo, al especificar (at: bottom, shift: 10pt), la línea base del box se establecerá a una altura exactamente 10pt por encima de la parte inferior de su contenido.
Ver ejemplo
Image: #box(baseline: 40%, image("tiger.jpg", width: 2cm)).
fillPor defecto: none
El color de fondo del box. Mirá la documentación del rectángulo para más detalles.
strokePor defecto: (:)
El color del borde del box. Mirá la documentación del rectángulo para más detalles.
radiusPor defecto: (:)
Cuánto se redondean las esquinas del box. Mirá la documentación del rectángulo para más detalles.
insetPor defecto: (:)
Cuánto relleno se agrega al contenido del box.
Puede ser una única longitud para todos los lados o un diccionario de longitudes para lados individuales. Al pasar un diccionario, puede contener las siguientes claves, en orden de precedencia: top, right, bottom, left (que controlan los lados respectivos de la celda), x, y (que controlan los insets vertical y horizontal) y rest (que abarca todos los insets no definidos por otras entradas del diccionario). Todas las claves son opcionales; las claves omitidas usarán su valor establecido previamente o el valor por defecto si nunca se establecieron.
Las longitudes relativas de este parámetro son relativas al tamaño del box sin contar el outset. Tené en cuenta que los insets y outsets relativos son distintos de los anchos y altos relativos, que son relativos al contenedor.
Nota: Cuando el box contiene texto, su tamaño exacto depende de los bordes de texto actuales.
Ver ejemplo
#rect(inset: 0pt)[Tight]
outsetPor defecto: (:)
Cuánto se expande el tamaño del box sin afectar el diseño.
Puede ser una única longitud para todos los lados o un diccionario de longitudes para lados individuales. Las longitudes relativas de este parámetro son relativas al tamaño del box sin contar el outset. Mirá la documentación de inset de arriba para más detalles.
Esto es útil para evitar que el relleno afecte el diseño de las líneas. Para una versión generalizada del ejemplo de abajo, mirá la documentación del parámetro block del texto raw.
Ver ejemplo
An inline
#box(
fill: luma(235),
inset: (x: 3pt, y: 0pt),
outset: (y: 3pt),
radius: 2pt,
)[rectangle].
clipPor defecto: false
Si se recorta el contenido que está dentro del box.
Recortar es útil cuando el contenido del box es más grande que el propio box, ya que todo el contenido que exceda los límites del box quedará oculto.
Ver ejemplo
#box(
width: 50pt,
height: 50pt,
clip: true,
image("tiger.jpg", width: 100pt, height: 100pt)
)
bodyPor defecto: none
El contenido del box.