The following topics introduce the new and changed features of ADF Faces and other significant changes, which are described in this guide.
Oracle Fusion Middleware Release 12c (12.2.1.1.0) of Oracle JDeveloper and Oracle Application Development Framework (Oracle ADF) includes the following new and changed development features, which are described in this guide.
ADF Faces converters supports new formats for negative numbers. For more information, see How to Specify Negative Numbers for Converters.
The masonryLayout component now supports tile sizes beyond 3x2 or 3x2. For more information, see How to Use a masonryLayout Component.
The codeEditor component supports code completion so developers can add their own code hints and a number of other enhancements. For more information, see Using Code Editor.
The inputDate component has a performance enhancement that allows it to open calendar immediately on the client. It no longer needs to fetch from the server to get its content. For more information, see How to Add an InputDate Component.
Exporting data from table, tree or tree table components to Excel spreadsheets is enhanced so that the format of the data field is preserved. The type of the field is used to set the format in the Excel cell, and if the format is not valid, then the default is to export text as Text format. For more information, see Exporting Data from Table, Tree, or Tree Tables.
The table component supports clientside fetching of rows to eliminate re-fetching when the user scrolls back up the already fetched table rows. The number of rows on the client that can be cached is configured using the attribute maxClientRows
in combination with a scrollPolicy
attribute set to scroll
. For more information, see How to Display a Table on a Page.
The inputListOfValues component can use af:autoSuggestBehavior
to filter the list when the user enters more than a specified minimum number of characters. For more information, see How to Use the InputListOfValues Component.
The calendar component now supports printing for all types of views. For more information, see About Creating a Calendar Component.
ADF Data Visualization Components
A new chart component, the ADF DVT Stock chart, is now available. Use stock charts to display the different values and trade volumes of stocks and shares. The client-side stock chart is recommended over the legacy server-side stock graph. For more information, see Chart Component Use Cases and Examples and How to Add Data to Stock Charts.
The ADF DVT Chart solution now also includes range charts. The range chart can be created by providing high and low values to area or bar charts. Use range charts to represent data within a particular significant range or as an alternative to using reference areas. Range bar charts are also useful to create waterfall charts for cost analysis. For more information, see Chart Component Use Cases and Examples.
The ADF DVT Chart solution now also includes split Dual-Y charts. The split dual-y chart can be created for all charts that support a Y2 axis. Use split Dual-Y charts to better represent different axis data or to unclutter a chart’s plot area. For more information, see Chart Component Use Cases and Examples.
A new data visualization component, the ADF DVT Picto Chart, is now available. The Picto chart is a versatile data visualization tool that allows for more aesthetically pleasing presentation of information. Picto charts are used to represent absolute numbers or parts of a population, and can be used in a variety of ways. For more information, see Using Picto Chart Components.
A new data visualization component, the ADF DVT Tag Cloud, is now available. The tag cloud is a data visualization tool that displays tag metadata or string metrics in a cloud or rectangular layout. Tags may be grouped by color and may be assigned relative size or importance, which is reflected in the font size of the tag. For more information, see Using Tag Cloud Components.
Other ADF DVT Chart changes include the following improvements. For more information, see Customizing Chart Display Elements.
Bar charts now support varying width for bars.
Chart titles and footnotes can now be aligned to the plot area bounds in addition to the container bounds.
You can now specify groups of series to be stacked together in any stacked chart via the new stackCategory
attribute.
You can now customize or remove slice labels from funnel charts.
Charts with time axes can now be configured to be continuous despite having irregular data using the new skipGaps
attribute.
Chart tooltips and labels can now be customized using the new tooltipLabel
and tooltipDisplay
attributes.
Chart axes now support logarithmic scale.
Bubble and Scatter charts now support line connectors between data points.
Chart data items, series and group items now support drilling. Chart groups can also be arranged in a hierarchical axis with custom styling.
The ADF DVT Status Meter Gauge has several improvements. You can now customize the size and color of the gauge plot area and gauge border. Circular status meter gauges now support custom inner ring size, and start and end angles for partial shape rendering. Gauge titles can now be customized and positioned. The indicator can now be made larger than the plot area. For more information, see Configuring Gauges.
Other ADF DVT gauge changes include the following improvements. For more information, see Gauge Component Use Cases and Examples.
The ADF DVT Rating Gauge and LED Gauge now support human shape. Rating gauges can now be rendered vertically.
ADF DVT gauges now support custom labels.
The panelSpringboard component supports swipe gestures that allow the user to navigate back and forth between child pages. For more information, see Displaying or Hiding Contents in Panels.
ADF Faces supports pass-through attributes to enable applications to add non-standard attributes in addition to those defined in the component library and have those attributes appear in the component’s generated DOM. For more information, see What You May Need to Know About Pass-Through Attributes.
For Release 12c (12.2.1.1.0), this document has been updated in several ways. Following are the sections that have been added or changed.
Part I Getting Started with ADF Faces
Revised chapter ADF Faces Component Demo Application to update the images for the Alta skin used in the current release.
Part IV Using Common ADF Faces Components
Revised section Using File Upload to describe how to display the progress bar while uploading a file using an inputFile
component.
Revised section Using Code Editor to describe the option to configure the code editor component to list all warnings and errors in a message pane.
Revised section What You May Need to Know About Programmatically Enabling Sorting for Table Columns to clarify the use of panelCollection
components to enable multi-column sorting when the underlying table model is not a CollectionModel
instance.
Revised section What You May Need to Know About Performing an Action on Selected Rows in Tables to describe the correct usage of setRowKey()
and setRowIndex()
to change the current record of operation on ADF Faces table/tree/treeTable components.
Added new section What You May Need to Know About Scrollbars in a List View to describe a how to implement the iOS scrollbar display behavior for other operating systems.
Revised section Content Delivery to replace the deprecated table
component ScrollPolicy attribute option loadMore with the scroll option that closely simulates virtualized scrolling on tablet devices.
Added new section Controlling Display Behavior of Popups to describe a how to dismiss a popup using a timeout property.
Revised section How to Add a Thematic Map to Page to describe new MaxZoom attribute that lets you control maximum zoom level for the thematic map
component.
Revised section Scrolling and Page Controls to describe new ScrollPolicy attribute to support enhanced scrolling in pivot table
components.
Revised section Editing Data Cells to describe new ValueSubmitPolicy attribute with the option Lazy that lets you customize the submission of modified data cells in the pivot table
component to prevent a server roundtrip when the user navigates from cell to cell.
Revised section What Happens at Runtime: How the Query Component Renders Operators to clarify the role of the predefined operators specified in the QueryDescriptor
class backing query search components.
Part V Using ADF Data Visualization Components
Added new section How to Configure NBox Attribute Groups to provide a step-by-step guide to adding and customizing attribute groups on NBox components in UI-first development.
Part VI Completing Your View
Revised section Configuring Accessibility Support in ADF Faces to remove the large font accessibility preference from the accessibility-profile element.
Revised section About User Customization to include the UI Aspect information to better describe the default ADF Faces component personalization capabilities.
Revised section Creating Emailable Pages to describe an enhancement to emailable pages that renders the footer properly.
Added new section What You May Need to Know About Navigating Away From the ADS Enabled Page to describe a limitation of ADS to reactivate active data-enabled components when navigating away from the browser page.
Part VII Appendices
Revised section Tab Traversal Sequence in a Table to better describe how the user may navigate a table using the Tab and Enter keys.
Moved test automation information to a new section Using Test Automation for ADF Faces to better describe best practices for using the ADF Faces test automation framework.
Added new section Simulating Mouse Events in ADF Faces Test Automation to describe how you can simulate mouse events that you can use to test mouse events.
Revised section Enabling Test Automation for ADF Faces to describe the role of a response cookie that ADF enables when you enable automation and set oracle.adf.view.rich.automation.ENABLED
to SAFE
or FULL
.