Oracle® Fusion Middleware Mobile Browser Developer's Guide for Oracle Application Development Framework 11g Release 1 (11.1.1.7.2) Part Number E10140-08 |
|
|
PDF · Mobi · ePub |
This chapter describes the Apache MyFaces Trinidad components that are supported by ADF Mobile browser.
This chapter includes the following sections:
ADF Mobile browser supports more than 60 of Apache MyFaces Trinidad components, enabling you to build applications with a rich component set that renders appropriately to the screens of mobile devices. For more information, refer to the Apache MyFaces Trinidad site (http://myfaces.apache.org/trinidad
/).
The high-latency and low-bandwidth of networks in mobile environments decrease application responsiveness for mobile users. Screens refresh slowly, diminishing the mobile user experience. ADF Mobile browser's support of Partial Page Rendering (PPR) compensates for the negative impact that slow connections have on screen updates by minimizing the amount of data requested from the server; using PPR, mobile device screen updates do not require a full refresh. Browsers that do not support AJAX (Asynchronous JavaScript and XML) use full page rendering instead of PPR. For example, a page submission on basic HTML browsers (which do not support JavaScript) results in the refresh of a full page.
Note:
Browsers for BlackBerry 4.5 (and earlier versions) do not support PPR. Specifying the autosubmit
attribute on certain form components results in the submission of the page after the user exits the field. A full, not partial, refresh of the page then follows.
ADF Mobile browser supports dialogs, pages used by applications to obtain user input. Because mobile browsers cannot open a new window that contains a dialog (a pop-up window), they present dialogs as new pages within the main browser window after they automatically preserve the state of the current page.
On browsers for BlackBerry 4.5 and earlier versions, the bullets in a list sublevel (such as those in a tr:panelList
component) appear large and are not indented. The BlackBerry browser's table handling may affect complex layouts; the BlackBerry browser does not allow horizontal scrolling. Instead, it wraps a table row onto multiple display lines which may disturb the layout. For more information, see Chapter 6, "Design Guidelines for BlackBerry 4.2 to 4.5."
ADF Mobile browser supports input text fields and lists, core components that support user input.
You can create input fields using the following components:
tr:inputColor
Note:
Mobile browsers do not support an inline chooseColor
or a color
dialog for the tr:inputColor
component.
tr:inputDate
tr:inputHidden
tr:inputText
Note:
Basic HTML browsers do not support the autosubmit
attribute of the tr:inputText
component.
Note:
Trinidad optimizes the tr:inputText
component for narrow-screen devices (that is, devices with a screen width measuring less than 240 pixels). For more information see Chapter 7, "Narrow Screen Support and User Agent Details Support."
You can create lists using the following components:
tr:panelChoice
tr:panelList
tr:selectBooleanCheckBox
tr:selectBooleanRadio
tr:selectItem
Note:
Mobile browsers do not support the disabled
attribute for the tr:selectItem
component.
tr:selectManyCheckBox
tr:selectManyListBox
tr:selectOneChoice
tr:selectOneListBox
tr:selectOneRadio
tr:resetButton
Note:
Basic HTML browsers do not support the autosubmit
attribute for the tr:resetButton
component.
ADF Mobile browser uses the Apache MyFacesTrinidad core components that support output on mobile device applications. These components include those for displaying text and images and also components for displaying, or hiding, text.
The following components enable you to display text:
tr:iterator
tr:message
tr:messages
Note:
Component-specific messages do not display on a mobile browser in the same manner as they do in a desktop browser. Instead, they display in the region where the message component (tr:message
or tr:messages
) is placed on the web page.
tr:outputDocument
tr:outputForwarded
tr:outputLabel
tr:outputText
The following components enable you to display images:
tr:icon
tr:image
tr:panelTip
The following components enable showing or hiding items:
tr:panelAccordion
Note:
Mobile browsers only support a full-page update; they do not support the partialTriggers
attribute of the tr:panelAccordion
component.
tr:panelTabbed
Note:
To conserve space on mobile devices, the renderer intentionally prevents the display of tab bars on both the top and bottom of the tr:panelTabbed
component. Valid values for the attribute positions are top
and bottom
. If both
is specified, then the renderer displays the tabs on top.
tr:showDetail
Note:
For the tr:showDetail
component, the disclosure arrow does not display; the [+] and [-] symbols display instead.
tr:showDetailHeader
Note:
For the tr:showDetailHeader
component, the disclosure arrow does not appear on mobile browsers.
tr:showDetailItem
Note:
For the tr:showDetailItem
component, the disclosure arrow does not appear on mobile browsers its flex
attribute is not supported.
The layout components supported by ADF Mobile browser include those for managing the page itself (such as tr:document
and tr:form
) as well as components for laying out the sections of a page, such as tr:group
, tr:panelFormLayout
, and tr:panelGroupLayout
.
The following components enable you to manage the page:
tr:document
tr:form
Note:
Mobile browsers do not support the defaultCommand
attribute of the tr:form
component.
tr:page
Note:
Mobile browsers do not support the tr:page
facet of the tr:page
component.
The following ADF Faces core tags support page layout for mobile device applications:
tr:group
tr:panelBorderLayout
Note:
Only the top
and bottom
facets are supported for the tr:panelBorderLayout
component. Mobile browsers do not support the following facets:
left
right
start
end
innerLeft
innerRight
innerStart
innerEnd
The tr:panelBorderLayout
component does not render if you use any of these unsupported facets.
tr:panelBox
tr:panelFormLayout
tr:panelGroupLayout
tr:panelHeader
tr:panelHorizontalLayout
Note:
Mobile devices do not support the halign=end
attribute definition for the tr:panelHorizontalLayout
component.
tr:panelLabelAndMessage
Note:
Trinidad optimizes the tr:panelLabelAndMessage
component for narrow-screen devices (that is, devices with a screen width measuring less than 240 pixels). For more information see Section 7.1, "Determining Narrow Screen Support."
tr:panelPage
tr:panelPageHeader
Note:
Mobile devices only support the following facets of the tr:panelPageHeader
component:
branding
brandingApp
navigation1
navigation2
tr:panelRadio
Note:
Trinidad optimizes the tr:panelRadio
component for narrow-screen devices (that is, devices with a screen width measuring less than 240 pixels). For more information see Section 7.1, "Determining Narrow Screen Support."
tr:panelCaptionGroup
The following components control the space allocation on pages:
tr:separator
tr:spacer
tr:subform
ADF Mobile browser supports such components as buttons, links, and breadcrumbs that enable users to navigate to other pages of the application, or to external locations.
ADF Mobile browser supports the following button types:
tr:commandButton
Note:
Because the text
attribute cannot display if the icon
attribute has been set, you can define buttons on mobile devices as text or as an image, but not both. If you set the disabled
attribute to true
, then a tr:commandButton
component with an icon
attribute renders as a static image with no links.
tr:goButton
See Chapter 8, "Extending ADF Mobile Browser Applications" for information on how to use the tr:goButton
component to integrate e-mail, telephony, and Google maps into an application.
ADF Mobile browser supports the following components for creating hyperlinks:
tr:commandLink
Note:
Because the tr:commandLink
component renders as an input element in basic mobile HTML browsers, its child components cannot render. For more information on input elements in basic mobile HTML browsers, see Section 5.2, "Developing Applications for Basic HTML Mobile Browsers."
tr:goLink
See Chapter 8, "Extending ADF Mobile Browser Applications" for information on how to use the tr:goLink
component to integrate e-mail, telephony, and Google maps into an application.
ADF Mobile browser supports the following navigation components:
tr:breadcrumbs
Note:
Trinidad optimizes the tr:breadcrumbs
component for narrow-screen devices (that is, devices with a screen width measuring less than 240 pixels). For more information see Chapter 7, "Determining Narrow Screen Support."
tr:commandNavigationItem
Note:
tr:commandNavigationItem
does not render when you set the disabled
attribute to true
for the following:
tr:selectOneListBox
tr:selectOneChoice
tr:processChoiceBar
tr:navigationPane
with hint, "choice"
tr:selectRangeChoiceBar
tr:navigationPane
Note:
tr:navigationPane hint = "choice"
with a destination value is not supported for basic HTML browsers.
Note:
Trinidad optimizes the tr:navigationPane
component for narrow-screen devices (that is, devices with a screen width measuring less than 240 pixels). For more information see Chapter 7, "Determining Narrow Screen Support."
tr:train
Note:
The tr:train
component appears as x of y instead of listing each item. This is a display-only component in ADF Mobile browser; users cannot navigate through the application by clicking the x of y component. To enable navigation, you must add a separate link or button.
tr:processChoiceBar
Note:
Trinidad optimizes the tr:processChoiceBar
component for narrow-screen devices (that is, devices with a screen width measuring less than 240 pixels). For more information see Section 7.1, "Determining Narrow Screen Support."
tr:selectRangeChoiceBar
Note:
Trinidad optimizes the tr:selectRangeChoiceBar
component for narrow-screen devices (that is, devices with screen width measuring less than 240 pixels). For more information see Chapter 7, "Determining Narrow Screen Support."
ADF Mobile browser supports data visualization tools (DVTs), described in the "Creating Databound ADF Data Visualization Components" section in Oracle Fusion Middleware Fusion Developer's Guide for Oracle Application Development Framework.
ADF Mobile browser supports the following types of graphs:
area
bar
bar (horizontal)
bubble
combination (horizontal bar and line)
funnel
line
pareto
pie
radar
scattar/polar
stock
ADF Mobile browser supports the following types of gauges:
dial
status meter
status meter (vertical)
LED
To add these components to an application, first move a data control into the source editor using a drag-and-drop operation and then select Trinidad Gauges or Trinidad Graphs from the context menu. For example, Figure 3-1 illustrates the context menu when you drag a collection into a component in the source editor.
After you select either the Trinidad Graphs or Trinidad Gauges options, the DVT wizard appears and opens to the Component Gallery page, shown in Figure 3-2. You select the DVT type from this page.
Note:
For Oracle Fusion Middleware 11g release 1, ADF Mobile browser supports only static graphs and gauges, both of which are rendered as PNG images. Any mobile device that supports this image format can display graphs and gauges.
ADF Mobile browser applications can display structured data in the rows and columns of a table or hierarchically as trees.
ADF Mobile browser supports tables comprised of the following components:
tr:table
Note:
ADF Mobile browser does not support the allDetailsEnabled
attribute for the tr:table
component; this attribute is always set to false
.
tr:column
Note:
When you nest tr:column
tags to create column groups, the header facets do not render for the column groups.
Creating a single-column table optimizes how tables display on mobile devices.
ADF Mobile browser supports the tr:tree
component.
Note:
tr:tree
may not render on basic HTML browsers.
Release 11g of ADF Mobile browser does not support some components or attributes.
Release 11g of ADF Mobile browser does not support the following components:
tr:chart
tr:chooseColor
tr:chooseDate
tr:inputFile
tr:inputListOFVariables
tr:inputNumberSpinbox
tr:legend
tr:media
tr:navigationTree
tr:panelButtonBar
tr:panelPopup
tr:panelSideBar
tr:poll
tr:progressIndicator
tr:selectManyShuttle
tr:selectOrderShuttle
tr:singleStepButtonBar
tr:statusIndicator
tr:switcher
tr:treeTable
Release 11g of ADF Mobile browser does not support the following component attributes on any component.
accessKey
shortDesc (tooltip)