5.3 Links

5.3.1 Link requirements

Unidirectional hyperlinks traverse from clickable content to a target location.

• A basic-link object is used for creating a hyperlink.

  • Its content is the clickable content used by the document reader to traverse to the target of the link;

    • it requires support by the user agent;

    • there is no need to be supported for a print-only medium;

    • any content can be wrapped up in a link construct.

  • A strict interpretation of the XSL-FO Recommendation implies that only the construct's inline area is "hot" and not the areas generated by descendants of the formatting object.

• The target location can be another point within the document.

  • For this, use the internal-destination property.

  • The user agent software reading the document would navigate the reader to the target page.

• The target location can be a point outside the document.

  • For this, use the external-destination property.

  • The operating system running the user agent software would probably invoke the application associated with the file being pointed to, e.g.:

    • a web browser for an HTML page.

The object is an inline construct.

• It must be placed in a block to be a block-level construct.

• It may contain either block-level or inline-level constructs.

The construct is unidirectional.

• There is no back-link property associated with the link itself.

• The ability for a user agent to "go back" to where the link originated is a function of the user agent based on a history of the user's locations.

  • The user agent is not using a property of the link itself that indicates where the link was made from.

5.3.2 The basic-link object

Purpose

• This is the inline display of the start resource of a unidirectional link to a single end point.

Content

• ( 6.9.2 ) (#PCDATA %inline; %block; )*,

• child objects (listed alphabetically ):

  • %block; ( 6.2 ; 69),

  • %inline; ( 6.2 ; 70),

• any number of marker children at the beginning.

Property sets

• Common accessibility properties ( 7.4 ; 326),

• common aural properties ( 7.6 ; 327),

• common border, padding, and background properties ( 7.7 ; 328),

• common margin properties inline ( 7.11 ; 333),

• common relative position properties ( 7.12 ; 333).

Other optional properties

• alignment-adjust ( 7.13.1 ; 346),

• alignment-baseline ( 7.13.2 ; 346),

• baseline-shift ( 7.13.3 ; 351),

• destination-placement-offset ( 7.22.5 ; 373),

• dominant-baseline ( 7.13.5 ; 374),

• external-destination ( 7.22.6 ; 376),

• id ( 7.28.2 ; 384),

• indicate -destination ( 7.22.7 ; 384),

• internal-destination ( 7.22.8 ; 385),

• keep-together ( 7.19.3 ; 386),

• keep-with- next ( 7.19.4 ; 386),

• keep-with-previous ( 7.19.5 ; 387),

• line-height ( 7.15.4 ; 390),

• show-destination ( 7.22.9 ; 412),

• target-presentation-context ( 7.22.12 ; 420),

• target-processing-context ( 7.22.13 ; 420),

• target-stylesheet ( 7.22.14 ; 420).

Shorthands influencing the above properties

• font ( 7.29.13 ; 377),

• page-break-after ( 7.29.16 ; 401),

• page-break-before ( 7.29.17 ; 401),

• page-break-inside ( 7.29.18 ; 402),

• vertical-align ( 7.29.22 ; 424).

An excerpt from Figure 5-2 is shown in Example 5-7.