Manage Navigation - BEA WebLogic User Manual

Part IV Presentation of Mobile Content

Manage Navigation

This section describes pagination and Back-to-Top functionality in WebLogic Mobility Server.
Pagination
Pagination refers to dividing a document into pages. WebLogic Mobility Server provides the
following two pagination options:
•
Automatic pagination
Authors need not worry about manipulating pages, cards or decks (groups of cards) because
WebLogic Mobility Server automatically handles pagination for targeted devices.
•
Author-controlled pagination
WebLogic Mobility Server provides the option of author-controlled pagination. Author-
controlled pagination overrides the automatic pagination function within WebLogic Mobility
Server.
Automatic Pagination
WebLogic Mobility Server automatically divides mmXHTML or the WebLogic Mobility Server
JSP taglib documents into pages of a size appropriate to the device receiving the content.
Automatic Pagination Rules
In WebLogic Mobility Server, content elements are given default pagination rules. The following
pagination rules apply:
•
Page breaks are avoided inside words so that a word does not begin on one page and finish on
another
•
Page breaks are avoided inside elements, such as tables, forms and paragraphs
•
Page breaks are positioned so that small chunks of content do not occur on a new page or
card. For example, a page does not start with:
<p>a few words. The End.</p>
•
If an HTML element or <mm-group> element is too big to fit on a page then that element is
split, for example, at the end of a sentence
Author-Controlled Pagination
This section describes how the author can override automatic pagination by specifying pagination
controls in the document.
Author controlled pagination is the splitting of content by the author onto separate pages or cards.
The main objectives of the author-controlled pagination are as follows:
•
To provide authors with the ability to control where page breaks occur
•
To provide authors with the ability to control which elements should not be separated
This functionality uses concepts and syntax defined in the CSS 2 paper on "Paged Media" as
defined by the World Wide Web Consortium (W3C):
http://www.w3.org/TR/REC-CSS2/page.html
88 - BEA WebLogic Mobility Server User Guide