blockElementoDesde: siempre
Un contenedor de bloque.
Un contenedor así se puede usar para separar contenido, para darle tamaño o recortarlo, o para darle un fondo o un borde.
Los bloques también son la forma principal de controlar si el texto pasa a formar parte de un párrafo o no. Mirá la documentación de párrafos para más detalles.
Ejemplos
Con un bloque, podés darle un fondo al contenido y, aun así, permitir que se corte entre varias páginas.
#set page(height: 100pt)
#block(
fill: luma(230),
inset: 8pt,
radius: 4pt,
lorem(30),
)
Los bloques también son útiles para forzar a que elementos que de otro modo serían en línea pasen a ser de nivel de bloque, especialmente al escribir reglas show.
#show heading: it => it.body
= Blockless
More text.
#show heading: it => block(it.body)
= Blocky
More text.
Parámetros
widthPor defecto: auto
El ancho del bloque.
Ver ejemplo
#set align(center)
#block(
width: 60%,
inset: 8pt,
fill: silver,
lorem(10),
)
heightPor defecto: auto
La altura del bloque. Cuando la altura es mayor que el espacio restante de una página y breakable es true, el bloque continuará en la página siguiente con la altura restante.
Ver ejemplo
#set page(height: 80pt)
#set align(center)
#block(
width: 80%,
height: 150%,
fill: aqua,
)
breakablePor defecto: true
Si el bloque se puede cortar y continuar en la página siguiente.
Ver ejemplo
#set page(height: 80pt)
The following block will
jump to its own page.
#block(
breakable: false,
lorem(15),
)
fillPor defecto: none
El color de fondo del bloque. Mirá la documentación del rectángulo para más detalles.
strokePor defecto: (:)
El color del borde del bloque. Mirá la documentación del rectángulo para más detalles.
radiusPor defecto: (:)
Cuánto se redondean las esquinas del bloque. Mirá la documentación del rectángulo para más detalles.
insetPor defecto: (:)
Cuánto relleno se agrega al contenido del bloque. Mirá la documentación de box para más detalles.
outsetPor defecto: (:)
Cuánto se expande el tamaño del bloque sin afectar el diseño. Mirá la documentación de box para más detalles.
spacingPor defecto: 1.2em
El espaciado alrededor del bloque. Cuando es auto, hereda el spacing del párrafo.
Entre dos bloques adyacentes, gana el mayor entre el espaciado below del primer bloque y el above del segundo. Además, el espaciado de bloques tiene prioridad sobre el spacing del párrafo.
Tené en cuenta que esto es solo un atajo para establecer above y below en el mismo valor. Como los valores de above y below pueden diferir, un bloque de contexto solo da acceso a block.above y block.below, no directamente a block.spacing.
Esta propiedad se puede usar en combinación con una regla show para ajustar el espaciado alrededor de elementos arbitrarios de bloque.
Ver ejemplo
#set align(center)
#show math.equation: set block(above: 8pt, below: 16pt)
This sum of $x$ and $y$:
$ x + y = z $
A second paragraph.
abovePor defecto: auto
El espaciado entre este bloque y su antecesor.
belowPor defecto: auto
El espaciado entre este bloque y su sucesor.
clipPor defecto: false
Si se recorta el contenido que está dentro del bloque.
Recortar es útil cuando el contenido del bloque es más grande que el propio bloque, ya que todo el contenido que exceda los límites del bloque quedará oculto.
Ver ejemplo
#block(
width: 50pt,
height: 50pt,
clip: true,
image("tiger.jpg", width: 100pt, height: 100pt)
)
stickyPor defecto: false
Si este bloque debe quedar pegado al siguiente, sin corte entre ambos.
Por defecto, esto se establece en los bloques de títulos para evitar títulos huérfanos al final de la página.
Ver ejemplo
// Disable stickiness of headings.
#show heading: set block(sticky: false)
#lorem(20)
= Chapter
#lorem(10)
bodyPor defecto: none
El contenido del bloque.