XSL-FO region-bodyObjeto

XSL-FO 参考手册Manual de referencia de XSL-FO

Definición y uso

El objeto <fo:region-body> define el área principal de la página.

XSL-FO utiliza los siguientes elementos para definir las áreas de la página:

  • <fo:region-body> define el área principal
  • <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, el margen de region-body debe ser al menos del mismo tamaño que las cuatro subáreas mencionadas.

Consejo:Para proporcionar múltiples columnas en el área region-body, ¡debe establecer el atributo column-count en un valor mayor que 1!/p>

Nota:Si el valor del atributo overflow es "scroll", no puede establecer el atributo column-count en un valor mayor que 1.

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

<fo:region-body>
<!--
Contents:EMPTY
-->
</fo:region-body>

Atributos

Atributos [A-B] Atributos [C-Z]
background-attachment clip
background-color column-count
background-image column-gap
background-repeat display-align
background-position-horizontal end-indent
background-position-vertical margin-bottom
border-after-color margin-left
border-after-style margin-right
border-after-width margin-top
border-before-color overflow
border-before-style padding-after
border-before-width padding-before
border-bottom-color padding-bottom
border-bottom-style padding-end
border-bottom-width padding-left
border-end-color padding-right
border-end-style padding-start
border-end-width padding-top
border-left-color region-name
border-left-style reference-orientation
border-left-width space-after
border-right-color space-before
border-right-style writing-mode
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:simple-page-master master-name="intro">
<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 la tercera plantilla se llaman "left" y "right". Pueden usarse 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:

<fo:simple-page-master master-name="A4"
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 es 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 área principal es de 3 centímetros (en los cuatro lados).

Las áreas before, after, start y end del área principal son de 2 centímetros.

El ancho del área principal 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

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 área principal.


XSL-FO 参考手册Manual de referencia de XSL-FO Otras extensiones