Kapitola 3. Formátovací objekty

Vytváří samostatný blok textu. Používá se proto pro odstavce, nadpisy a podobné druhy objektů.

Formátovací objekt umožňuje sdružit několik blokových formátovacích objektů a změnit některé vlastnosti – typicky tok směru textu nebo orientaci.

<fo:block>
  ...
</fo:block>
<fo:block-container reference-orientation="90" width="8cm">
  <fo:block>
    ... otočený odstavec ...
  </fo:block>
</fo:block-container>
<fo:block>
  ...
</fo:block>

Pro vytváření seznamů existuje sada formátovacích objektů. Celý seznam je uložen v fo:list-block. Každá položka seznamu je ohraničena pomocí fo:list-item. Položka seznamu pak má své návěstí (jako je odrážka, číslo, text) fo:list-item-label a tělo fo:list-item-body. Obsahem těla i návěstí musí být fo:block.

Obrázek 3.1. Formátovací model seznamů

<fo:list-block provisional-distance-between-starts="1em">
  <fo:list-item>
    <fo:list-item-label end-indent="label-end()">
      <fo:block>&#x2022;</fo:block>
    </fo:list-item-label>
    <fo:list-item-body start-indent="body-start()">
      <fo:block>První položka seznamu</fo:block>
    </fo:list-item-body>
  </fo:list-item>
  <fo:list-item>
    <fo:list-item-label end-indent="label-end()">
      <fo:block>&#x2022;</fo:block>
    </fo:list-item-label>
    <fo:list-item-body start-indent="body-start()">
      <fo:block>Druhá položka seznamu</fo:block>
    </fo:list-item-body>
  </fo:list-item>
</fo:list-block>

<fo:list-block provisional-distance-between-starts="52%" provisional-label-separation="4%" 
               font-size="9pt" text-align="justify">
  <fo:list-item>
    <fo:list-item-label end-indent="label-end()">
      <fo:block>My, občané České republiky v Čechách, na Moravě 
	a ve Slezsku, ...</fo:block>
    </fo:list-item-label>
    <fo:list-item-body start-indent="body-start()" language="en">
      <fo:block>We, the citizens of the Czech Republic in Bohemia, 
	Moravia, and Silesia, ...</fo:block>
    </fo:list-item-body>
  </fo:list-item>
  <fo:list-item>
    <fo:list-item-label end-indent="label-end()">
      <fo:block>Česká republika je ...</fo:block>
    </fo:list-item-label>
    <fo:list-item-body start-indent="body-start()" language="en">
      <fo:block>The Czech Republic is ...</fo:block>
    </fo:list-item-body>
  </fo:list-item>
</fo:list-block>

Model tabulek ve FO je podobný jako v HTML – tabulka (fo:table, fo:table-and-caption) se skládá z buněk (fo:table-cell), které jsou součástí řádky (fo:table-row) a řádka je součástí nějaké skupiny v tabulce (fo:table-body, fo:table-footer, fo:table-header). Pomocí vlastností pak můžeme nastavovat takové věci jako slučování buněk, rámečky okolo buněk a celé tabulky, barvy, pozadí, zarovnání obsahu buněk apod.

<fo:table>
  <fo:table-body>
    <fo:table-row>
      <fo:table-cell>
        <fo:block>A</fo:block>
      </fo:table-cell>
      <fo:table-cell>
        <fo:block>B</fo:block>
      </fo:table-cell>
   </fo:table-row>
    <fo:table-row>
      <fo:table-cell>
        <fo:block>C</fo:block>
      </fo:table-cell>
      <fo:table-cell>
        <fo:block>D</fo:block>
      </fo:table-cell>
   </fo:table-row>
 </fo:table-body>
</fo:table>

Formátovací objekt se používá pro změnu formátování části textu uvnitř odstavce a dalších formátovacích objektů.

Formátovací objekt se používá pro sdružení více blokových objektů do jednoho inline, obvykle z důvodu rozdílného směru sázení textu v jednotlivých blocích.

Při vkládání obrázků je potřeba mít obrázek ve formátu podporovaném použitým procesorem FO. Většina procesorů podporuje bitmapové formáty PNG a JPEG. Podporované vektorové formáty se liší procesor od procesoru. Dobrou zprávou je, že většina procesorů si dnes poradí s SVG.

<fo:external-graphic src="url(foto.jpg)" 
                     content-width="5cm" 
                     width="40%" 
                     text-align="center"
                     display-align="center"/>

Formátovací objekt umožňuje dané místo vyplnit libovolným znakem. Pokud chceme nějaký prostor vyplnit celý, musí být zarovnání do bloku. Pro poslední řádku odstavce proto použijeme nastavení text-align-last="justify".

<fo:block text-align-last="justify">
  Úvod
  <fo:leader leader-pattern="dots"/>
  1
</fo:block>

Stále větší počet druhů dat lze reprezentovat nějakým XML formátem. Formátovací objekt fo:instream-foreign-object umožňuje přímo mezi FO zařadit fragment dat v jiném formátu – nejčastěji MathML nebo SVG. Záleží pak samozřejmě na schopnostech procesoru FO, zda daný druh dat podporuje.

<fo:instream-foreign-object content-width="16cm">
  <svg viewBox="0 0 400 400" xmlns="http://www.w3.org/2000/svg">
    <desc>This is a blue circle with a red outline</desc>
    <g>
      <circle style="fill: blue; stroke: red" cx="200" cy="200" r="100"/>
      <text x="150" y="160" stroke="yellow" fill="white" 
	    font-weight="bold" font-size="20">Hello World</text>
    </g>
  </svg>
</fo:instream-foreign-object>

Používá se uvnitř fo:block a umožňuje určit odlišné formátovací vlastnosti pro první řádek odstavce.

<fo:block>
  <fo:initial-property-set font-weight="bold"/>
  Text odstavce, jehož první řádka bude zobrazena
  tučným písmem...
</fo:block>

Aktuální číslo strany lze do dokumentu vložit pomocí fo:page-number. Způsob číslování se přitom nastavuje na sekvenci stránek (fo:page-sequence) pomocí vlastností initial-page-number a format.

Každý FO může mít přiřazen jedinečný identifikátor ve vlastnosti id. Objekt fo:page-number-citation pak vrací stránku s výskytem objektu, jehož identifikátor zadáme ve vlastnosti ref-id.

Každý FO může mít přiřazen jedinečný identifikátor ve vlastnosti id. Objekt fo:page-number-citation-last pak poslední stránku oblasti, na které se vykreslil objekt, jehož identifikátor zadáme ve vlastnosti ref-id.

Formátovací objekt je v XSL-FO od verze 1.1.

Poznámky pod čarou se vytvářejí pomocí objektů fo:footnote a fo:footnote-body. Poznámky pod čarou nejsou standardně odděleny čarou, ta se musí vygenerovat pomocí statického obsahu pro oblast xsl-footnote-separator.

<fo:footnote>
  <fo:inline font-size="70%" baseline-shift="super">1</fo:inline>
  <fo:footnote-body>
    <fo:block>
      <fo:inline font-size="70%" baseline-shift="super">1</fo:inline>
      Text poznámky
    </fo:block>
  </fo:footnote-body>
</fo:footnote>

Pokud symbol poznámky rozbije řádkování, je možné použít na rodičovském objektu vlastnost line-stacking-strategy s hodnotou font-height.

Plovoucí objekty (fo:float) umožňují obtékání obrázků, případně umístění nějakého většího objektu na první volné místo.

<fo:float float="end">
  <fo:block>
    ...plovoucí obsah...
  </fo:block>
</fo:float>

Odkazy se vytvářejí pomocí objektu fo:basic-link. Ten může ukazovat buď na jiné místo dokumentu určené pomocí internal-destination, nebo na externí dokument pomocí external-destination.

V mnoha dokumentech chceme mít v záhlaví/zápatí kromě čísla strany např. název kapitoly nebo podkapitoly. K dosažení tohoto efektu můžeme použít objekty fo:marker a fo:retrieve-marker. První umožňuje do dokumentu vložit značku a druhý zjistit aktuální značku.

Můžeme mít přitom libovolný počet kategorií značek a u každé zjišťovat první či poslední výskyt značky apod.

<!-- Vytvoření značky -->
<fo:marker marker-class-name="kapitola">Úvod</fo:marker>

<!-- Zjištění aktuální značky -->
<fo:retrieve-marker retrieve-class-name="kapitola" 
   retrieve-position="first-including-carryover"/>

<fo:retrieve-marker retrieve-class-name="kapitola" 
   retrieve-position="last-starting-within-page"/>

Umožňuje implementovat v tabulkách odlišný obsah fo:table-header a fo:table-footer na každé stránce.

Formátovací objekt je v XSL-FO od verze 1.1.

Objekt slouží k seskupení několika formátovacích objektů a k nastavení společných vlastností.

Formátovací objekt fo:bookmark-tree společně s objekty fo:bookmark a fo:bookmark-title umožňuje do výstupních formátů, kde to má smysl, vygenerovat záložky.

Formátovací objekt je v XSL-FO od verze 1.1.

Objekty fo:change-bar-begin a fo:change-bar-end umožňují vyznačit místa začátku a konce změny v dokumentu. Lze pak určit, kde a jakým stylem se má na okraji textu zobrazot vertikální čára vyznačující změnu.

Formátovací objekt je v XSL-FO od verze 1.1.

V XSL-FO 1.1 bylo přidáno několik objektů a vlastností, které umožňují snazší generování rejstříků.

Skoro na každém formátovacím objektu lze nyní použít atribut index-key, do kterého lze uložit název rejstříkového hesla.

Při generování samotného rejstříku pak můžeme snadno získat seznam všech stránek, kde se dané rejstříkové heslo vyskytuje pomocí formátovacích objektů fo:index-page-citation-list a fo:index-key-reference.

<fo:block index-key="opalování">Jak se správně opalovat</fo:block>

…

<fo:index-page-citation-list>
  <fo:index-key-reference ref-index-key="opalování"/>
</fo:index-page-citation-list>

Rejstříkové heslo může být vyznačeno přímo na formátovacím objektu pomocí atributu index-key. Pokud rejstříkové heslo přesahuje nějaký delší úsek dokumentu, je možné vyznačit začátek a konec platnosti rejstříkového hesla pomocí objektů fo:index-range-begin a fo:index-range-end.

Formátovací objekt fo:index-page-citation-list může pomocí vlastnosti merge-sequential-page-numbers automaticky zajistit převod souvislé posloupnosti čísel stránek na rozsah. Uvnitř objektu se může vyskytovat více objektů fo:index-key-reference s různým nastavením formátovacích vlastností. Formátovač pak správně seřadí čísla stran a zachová formátovací vlastnosti.

Formátovací objekty jsou v XSL-FO od verze 1.1.