The following topics introduce the new and changed features of ADF Faces and other significant changes, which are described in this guide. This document is the new edition of the document formerly titled Oracle Fusion Middleware Web User Interface Developer's Guide for Oracle Application Development Framework.
Oracle Fusion Middleware Release 12c (12.1.2) of Oracle JDeveloper and Oracle Application Development Framework (Oracle ADF) includes the following new and changed development features, which are described in this guide.
New Skyros skin. All images of components at runtime have been replaced to reflect the new Skyros skin. In addition, the following specific changes have been made:
Section 220.127.116.11, "How to Globally Set Graph Font Using a Skin" removed references to the
Facelets support. All chapters have been revised for Facelets.
New JDeveloper window names, context menu options, and other user interface changes in JDeveloper are reflected in all chapters of this guide.
Button and link components are now consolidated into the
af:link components. All code examples in the book have been updated to reflect these new components.
target tag allows you to explicitly state which target components you want executed and rendered when a specific event (or events) is fired by a component. This provides a more fine-grained ability to control partial page rendering. For more information, see Chapter 8, "Rerendering Partial Page Content."
convertTimeZone converter can interpret four-digit year values when using a two-digit year pattern, in conjunction with the
inputDate components. See Section 7.3.4, "What You May Need to Know About Date Time Converters."
gridCell components. See Section 9.3, "Arranging Content in a Grid."
panelSpringboard components. See Section 9.10, "Displaying or Hiding Contents in Panels."
usage attributes for input components:
inputText component, see Section 11.3.1, "How to Add an inputText Component."
inputColor component, see Section 11.5.1, "How to Add an inputColor Component."
inputDate component, see Section 11.5.2, "How to Add an InputDate Component."
Custom list of time zones can be configured for the
inputDate component. See Section 11.5.4, "What You May Need to Know About Creating a Custom Time Zone List."
animationInterval attribute on the
inputRangeSlider components. See Section 11.4.1, "How to Add an inputNumberSlider or an inputRangeSlider Component."
Support for an indeterminate (or mixed) state on the
selectBooleanCheckbox component. See Section 11.6, "Using Selection Components."
Multiple file upload support on the
inputFile component. See Section 11.9, "Using File Upload."
codeEditor component that renders a widget for code editing. See Section 11.10, "Using Code Editor."
timeSlotsPerHour attributes for the
calendar component. See Section 17.3.1, "How to Configure the Calendar Component."
treeTable components can now navigate through "pages" of rows, rather than continuous scrolling. See Section 12.2.2, "Content Delivery."
treeTable components now allow freezing of columns starting from the end column. See Section 12.3.2, "Formatting Tables."
treeTable components can now have individual rows span multiple columns. See Section 12.3.3, "Formatting Columns."
listItem components provide a simplified, one-column table. See Section 12.10, "Displaying a Collection in a List."
selected attribute for
link components that, if set to
true, styles the component as selected it renders. The
iconPosition attribute for these components also supports additional values (
bottom) to determine where the component renders an icon if one is specified. See Section 20.3, "Using Buttons and Links for Navigation."
Ability to determine the size of the tabs rendered by a
navigationPane component. See Section 20.8.4, "What You May Need to Know About the Size of Navigation Tabs."
Display overflow of tabs like a conveyor belt. See Section 20.8.5, "What You May Need to Know About Navigation Tabs in a Compressed Layout."
dynamicComponent allows the exact components to be rendered to be determined at runtime. See Chapter 21, "Determining Components at Runtime."
timeline component that is an interactive data visualization tool that allows users to view events in chronological order and easily navigate forwards and backwards within a defined time range. See Chapter 27, "Using Timeline Components." Chapter 22, "Introduction to ADF Data Visualization Components" was also revised to add an introduction to this new component.
sunburst components that display quantitative hierarchical data across two dimensions, represented visually by size and color. See the following:
HTML5 support. If the client's browser supports it, HTML5 is now the default image format, instead of Flash, for the following DVT components:
HTML5 is also the default image format for all new DVT components, including sunbursts, timelines, and treemaps.
maxWidth attributes on the
graph component. See Section 23.3.4, "How to Customize Graph Legends."
Data marker selection support on graphs. See Section 23.7.8, "Adding Data Marker Selection Support for Graphs."
New features on the
Single-click editing. See Section 18.104.22.168, "Editing Data Cells."
Context menu options for column and header layer sorting. See Section 22.214.171.124, "Data and Header Sorting."
New page control alternative to scrollbars, and attributes available to set the start position for row and column data cells or headers. See Section 126.96.36.199, "Scrolling and Page Controls" and Section 25.2.6, "What You Many Need to Know About Displaying Large Data Sets."
Persistent header layer labels when displaying large data sets. See Section 188.8.131.52, "Persistent Header Layers."
Split view configuration of the data in large data sets. See Section 184.108.40.206, "Split View of Large Data Sets."
Header cell word wrapping with long header titles. See Section 220.127.116.11, "Header Cell Word Wrapping."
Active Data Service (ADS) support. See Section 18.104.22.168, "Active Data Support (ADS)."
Declarative styling attributes for header and data cells. See Section 25.2.4, "Configuring Pivot Table Display Size and Style."
Mobile device support. See Section 25.2.7, "What You May Need to Know About Pivot Tables on Touch Devices."
Pivot filter bar. See Section 25.4.2, "Using a Pivot Filter Bar with a Graph."
Support for printable pages. See Section 25.5.4, "Displaying Pivot Tables in Printable Pages."
Drag and drop support for
hierarchyViewer component. See Section 36.8.3, "Adding Drag and Drop Functionality for DVT Hierarchy Viewers, Sunbursts, and Treemaps."
popup component is now a valid root for the
showPrintablePageBehavior tag. See Section 37.2, "Displaying a Page for Print."
Only postback values of editable components when those values have changed since the last request. See Section A.2.3.16, "Postback Payload Size Optimization."
Display or hide ADF version information on an HTML page. See Section A.2.3.19, "Version Number Information."
Support for Oracle Traffic Director by the ADF Faces Caching Filter (ACF). See Section A.2.3.21, "ADF Faces Caching Filter."
Invalid browser notification. See Section A.2.3.23, "Internet Explorer Compatibility View Mode."
Session timeout when a warning dialog is displayed. See Section A.2.3.24, "Session Timeout Warning."
Removal of dynamic URL parameters in URLs. See Section A.2.3.26, "Clean URLs."
Ability to disable the splash screen displayed when loading a page. See Section A.2.3.27, "Page Loading Splash Screen."
Globally control over how certain layout components and tables handle being stretched. See Section A.2.3.29, "Geometry Management for Layout and Table Components."
Content delivery network (CDN) support. See Appendix A, "Using Content Delivery Networks."
Increased support for tablet and mobile devices. See Appendix D, "Creating Web Applications for Touch Devices Using ADF Faces."
For Release 12c (12.1.2), this document has been updated in several ways, to include corrections and clarifications. In addition, the following significant changes or additions have occurred in these sections:
Chapters now include a "Use Cases and Examples" section.
All Introduction sections in chapters have been renamed to "About..."
Revised Section 7.4, "Creating Custom ADF Faces Converters" for clarity.
Updated code examples in Section 7.4.1, "How to Create a Custom ADF Faces Converter."
Removed obsolete text in Section 7.5.1, "How to Add Validation."
Moved the "Displaying Images in a Carousel" section from the "Using Output Components" chapter to "Using Tables, Trees, and Other Collection-Based Components." See Section 12.11, "Displaying Images in a Carousel."
Revised Chapter 19, "Displaying Tips, Messages, and Help" for clarity and to remove obsolete content.
Revised Chapter 32, "Internationalizing and Localizing Pages" to describe the configuration you make in an
adf-config.xml file if you want to override a resource bundle in a customizable application. See Section 32.3.8, "What You May Need to Know About Overriding a Resource Bundle in a Customizable Application."
Revised Chapter 22, "Introduction to ADF Data Visualization Components" to remove obsolete content regarding embedded fonts for the
gauge components. In addition, the DVT components that support the Active Data Service (ADS) are listed.
Revised various sections in Chapter 23, "Using Graph Components" to:
add more use cases.
correct errors in code examples and procedures.
reflect pre-existing components contained in the graph component.
add procedure for creating a time selector. See Section 22.214.171.124, "How to Add a Time Selector to a Graph."
Revised various sections in Chapter 24, "Using Gauge Components" to:
correct errors in code examples and procedures.
reflect pre-existing components contained in the gauge component.
describe how to use skinning keys for various functionality.
Removed the following sections from Chapter 24, "Using Gauge Components"
"How to Specify the Layout of Gauges in a Gauge Set"
"What You May Need to Know About Configuring Gauge Set Display"
Revised Section 33.3.3, "ADF Data Visualization Components Accessibility Guidelines" to document guidelines for the
Revised various sections in Chapter 29, "Using Hierarchy Viewer Components" to:
correct errors in code examples and procedures
describe how to use skinning keys for various functionality.
Removed obsolete section in Chapter 29, "Using Hierarchy Viewer Components": "How to Configure a Hierarchy Viewer to Invoke a Context Menu."
Consolidated drag and drop features for graph and gantt components into Section 36.8, "Adding Drag and Drop Functionality for DVT Components."
Revised Section 37.3, "Creating Emailable Pages" to add to the list of supported email clients and to add information about the
Revised Section A.2.3.11, "Test Automation" to document coding errors that will produce assertion failed errors only after test automation is enabled.
Added new appendix to document troubleshooting the application user interface. See Appendix G, "Troubleshooting ADF Faces."