This chapter describes how to accommodate the behavior of BlackBerry browsers 4.2 to 4.5.
This chapter includes the following sections:
The BlackBerry browser behaves differently than other browsers in that it does not display pages using horizontal scrolling. Instead, it fits a page to the width of the screen.
Browsers wrap long words between fields. When formatting tables, avoid placing such words on lines that contain multiple fields.
Note:
Within this chapter, a word refers to a series of characters. In this context, a word does not include white space.
Because the default mode of the BlackBerry browser limits the browser width to that of the physical screen, any field that cannot fit within a line is displayed on the next line. If the intent of an application is to display multiple elements on one line, then you must ensure that the total width of the fields are within the width of the browser. Like other browsers, the BlackBerry browser wraps multiple lines when needed. The column width cannot be reduced beyond the size of the longest word in the field.
To prevent fields from wrapping, ensure that the total of the size attribute values in a table's row satisfies the following formula when all of the fields in a row are input fields.
3*Number of columns + the Sum of the size attributes in all columns <=X, when X=48
In general, field sizes in table columns should satisfy the following formula:
3 * Number of Columns + Sum of size attributes in all input field columns + Sum of number of characters in longest words in all output field columns <= X, when X=48
If the field still wraps, decrease the value of X
until the field fits the row.
To preserve the intended programming flexibility, ADF Mobile supports nowrap
attributes in Trinidad components. You may encounter problems if you add nowrap
to a component definition if you program an application to support paging.
When formatting columns, set the percentage of the width for both the LabelWidth
and the FieldWidth
attributes in the tr:panelFormLayout
component at 100%.
The same application may display differently on different devices. The following circumstances can contribute to such discrepancies:
Changing the minimum font size through user preferences affects the formatting ability of the ADF Mobile browser renderer. For example, input fields and their corresponding labels align properly when the font is set to its default size of 6 pt., as shown in Figure 6-1.
However, increasing the font size to 10 pt. disrupts the display by shifting the input fields beneath their corresponding labels. As a result, the page is difficult to read.
Figure 6-2 shows a page that is too large for the display screen.
Differing screen sizes can affect display. Even if the font size is at the default size of 6 pt. (illustrated in Figure 6-1), the same application appears differently on other devices. In Figure 6-3, the input fields barely fit the device's screen, even though they are easily accommodated on other devices running the same application, as shown in Figure 6-1.
In addition, input fields may display properly on the screen of one device, but may appear crowded on the screen of another type of device.
Figure 6-4 shows an application whose table cells are not wide enough to accommodate the text, causing it to wrap.