XSL-FO region-beforeObjeto
Manual de referencia de XSL-FO
Definición y uso
El objeto <fo:region-before> define el área superior (encabezado) de la página.
XSL-FO utiliza los siguientes elementos para definir las áreas de la página:
- <fo:region-body> define el área del cuerpo
- <fo:region-before> define el área superior (encabezado)
- <fo:region-after> define el área inferior (pie de página)
- <fo:region-start> define el área izquierda (barra lateral izquierda)
- <fo:region-end> define el área derecha (barra lateral derecha)
Nota:region-before, region-after, region-start y region-end son parte de region-body. Para evitar que el texto dentro de region-body cubra el texto de otras áreas, los márgenes de region-body deben ser al menos del mismo tamaño que las dimensiones de las cuatro subáreas mencionadas.
Nota:Según la recomendación de la versión XSL-FO 1.0, los atributos padding y border-width deben ser 0.
Sintaxis
<!--
Contents:EMPTY
-->
</fo:region-before>
Propiedades
| Propiedades [A-B] | Propiedades [C-Z] |
|---|---|
| background-attachment | clip |
| background-color | display-align |
| background-image | extent |
| background-repeat | overflow |
| background-position-horizontal | padding-after |
| background-position-vertical | padding-before |
| border-after-color | padding-bottom |
| border-after-style | padding-end |
| border-after-width | padding-left |
| border-before-color | padding-right |
| border-before-style | padding-start |
| border-before-width | padding-top |
| border-bottom-color | precedence |
| border-bottom-style | region-name |
| border-bottom-width | reference-orientation |
| border-end-color | writing-mode |
| border-end-style | |
| border-end-width | |
| border-left-color | |
| border-left-style | |
| border-left-width | |
| border-right-color | |
| border-right-style | |
| border-right-width | |
| border-start-color | |
| border-start-style | |
| border-start-width | |
| border-top-color | |
| border-top-style | |
| border-top-width |
Ejemplo 1
XSL-FO utiliza plantillas de página llamadas "Page Masters" para definir el diseño de las páginas. Cada plantilla debe tener un nombre único:
<fo:region-body margin="5in" />
</fo:simple-page-master>
<fo:simple-page-master master-name="left">
<fo:region-body margin-left="2in" margin-right="3in" />
</fo:simple-page-master>
<fo:simple-page-master master-name="right">
<fo:region-body margin-left="3in" margin-right="2in" />
</fo:simple-page-master>
En el ejemplo anterior, tres elementos <fo:simple-page-master> definen tres plantillas diferentes. Cada plantilla (page-master) tiene un nombre diferente.
La primera plantilla se llama "intro". Puede usarse como plantilla para la página de introducción.
La segunda y tercera plantillas se llaman "left" y "right". Pueden usarse como plantillas para páginas con números pares e impares.
Ejemplo 2
Este es un fragmento extraído de un documento XSL-FO:
page-width="297mm" page-height="210mm"
margin-top="1cm" margin-bottom="1cm"
margin-left="1cm" margin-right="1cm">
<fo:region-body margin="3cm"/>
<fo:region-before extent="2cm"/>
<fo:region-after extent="2cm"/>
<fo:region-start extent="2cm"/>
<fo:region-end extent="2cm"/>
</fo:simple-page-master>
El código anterior define una "Simple Page Master Template" con el nombre "A4".
El ancho de la página es de 297 milímetros y la altura de 210 milímetros.
Los cuatro márgenes de la página (superior, inferior, izquierdo y derecho) son de 1 centímetro.
El margen del cuerpo es de 3 centímetros (en los cuatro lados).
Las áreas before, after, start y end del cuerpo son de 2 centímetros.
El ancho del cuerpo en el ejemplo anterior se puede calcular restando los márgenes izquierdo y derecho y el margen de region-body del ancho de la página:
297mm - (2 x 1cm) - (2 x 3cm) = 297mm - 20mm - 60mm = 217mm
Ten en cuenta que las regiones (region-start y region-end) no se incluyen en el cálculo. Como se explicó anteriormente, estas regiones son parte del cuerpo.
Manual de referencia de XSL-FO Otras extensiones