XSL-FO region-startObjeto
Manual de referencia de XSL-FO
Definición y uso
El objeto <fo:region-start> define la región izquierda de la página (barra lateral izquierda).
XSL-FO utiliza los siguientes elementos para definir las regiones de la página:
- <fo:region-body> define la región del cuerpo
- <fo:region-before> define la región superior (encabezado)
- <fo:region-after> define la región inferior (pie de página)
- <fo:region-start> define la región izquierda (barra lateral izquierda)
- <fo:region-end> define la región 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 regiones, los márgenes de region-body deben ser, como mínimo, del mismo tamaño que las cuatro subregiones mencionadas.
Nota:Según la recomendación de la versión 1.0 de XSL-FO, los atributos padding y border-width deben ser 0.
Sintaxis
<!--
Contents:EMPTY
-->
</fo:region-start>
Atributos
| Atributos [A-B] | Atributos [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 | region-name |
| border-bottom-style | reference-orientation |
| border-bottom-width | writing-mode |
| border-end-color | |
| 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 la página. 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 utilizarse como plantilla para la página de introducción.
La segunda y tercera plantillas se llaman "left" y "right". Pueden utilizarse como plantillas de página para números de página 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" llamada "A4".
El ancho de la página es de 297 milímetros y la altura es de 210 milímetros.
Los cuatro márgenes de la página (superior, inferior, izquierdo y derecho) son de 1 centímetro.
Los márgenes del cuerpo son de 3 centímetros (en los cuatro lados).
Las regiones 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 los márgenes de region-body del ancho de la página:
297mm - (2 x 1cm) - (2 x 3cm) = 297mm - 20mm - 60mm = 217mm
Tenga 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