New Features Described in Oracle JET's Documentation for Release 21.0.0

Here are updates to the documentation for Oracle JET to describe new features and enhancements added to Release 21.0.0.

For other changes in this release, see the product Release Notes.

Oracle JET

Documentation updates for this release of Oracle JET.

• New Core Pack components

  The following Core Pack components are now available:

  • oj-c-switch, the Core Pack replacement for oj-switch.
  • oj-c-input-search, including support for List View and tabular collection templates.
  • oj-c-sort-control, for rendering the JET sort affordance in sortable table-header templates.
  • oj-c-table-display, a display-only, accessible table component.
  • oj-c-train, the Core Pack replacement for oj-train.

  See the API documentation and the migration sections for the corresponding legacy components when moving an application to a Core Pack component.

• Context-menu clickthrough

  Legacy JET and Core Pack components that support context menus now recognize the data-oj-alt-clickthrough attribute on child elements. Set it to "enabled" to allow a containing component's context menu to open when an interactive descendant would otherwise veto it, or to "disabled" to prevent containing JET components from opening their context menus for that gesture. If both values occur between the gesture target and the owning component root, "disabled" takes precedence.

• oj-c-select-multiple add-to-list action

  oj-c-select-multiple can display a link in its dropdown that launches application UI to add an item. Configure add-to-list and listen for the ojAddToListAction event.

• Core Pack chart support

  oj-c/chart-utils is available for working with Core Pack chart data. oj-c-line-chart and oj-c-area-chart support the related chart APIs. oj-c-picto-chart and oj-c-picto-chart-item add support for item drilling, annotations, patterns, and richer datatip content.

• Core Pack validation utilities

  The oj-c/validation-utils module is available for use with Core Pack form controls.

• List View keyboard navigation

  oj-c-list-view improves keyboard focus and navigation while content loads, when no data is available, and when invoking an item action. The changes make list item and row navigation more predictable for keyboard users.

• oj-c-progress-button loading behavior

  oj-c-progress-button updates its loading behavior so that the component remains accessible and its busy state is communicated consistently while an action is in progress.

• Select Single user assistance

  oj-select-single now displays help.instruction, help-hints.definition, and help-hints.source in a dropdown that opens below the field and in the mobile fullscreen dropdown. If the dropdown opens above the field, the user assistance remains below the focused field.

• Accessibility improvements

  This release includes accessibility improvements for oj-slider, oj-range-slider, oj-color-palette, and oj-color-spectrum.

Migration Information

Note the following changes when you migrate an application to Release 21.0.0.

• Alta theme assets removed

  JET 21.0.0 no longer ships Alta CSS, SCSS, demo-theme, or Sass Theme Builder assets. Applications that load paths such as css/alta, css/alta-android, css/alta-ios, or css/alta-windows must migrate to Redwood or to a Stable-based custom theme. Requests for removed Alta assets return 404.

• Offline Persistence Toolkit removed

  The Offline Persistence Toolkit is no longer included in the Oracle JET distribution. Applications that import persist/* modules must provide their own copy of the toolkit or migrate away from those modules. Custom component projects that retain a separately supplied toolkit must configure additionalPaths: ["persist"] for the jetwc-require-paths audit rule.

• oj.OAuth removed

  The oj.OAuth helper class has been removed. Applications that use it must implement an appropriate replacement for their OAuth integration.

• Legacy component deprecations

  oj-action-card, oj-refresher, oj-swipe-actions, oj-diagram, oj-picto-chart, oj-switch, and oj-train are deprecated. Use the corresponding Core Pack component where one is available. Desktop support for oj-refresher and oj-swipe-actions is also deprecated.

• oj-focus-highlight style class deprecations

  The oj-focus-highlight style class is deprecated on oj-button, oj-dialog, oj-label, oj-list-view, oj-navigation-list, oj-popup, oj-slider, and oj-switch. Applications should use the supported component styling and focus behavior instead of applying this class.

• Content Security Policy expression evaluation

  JET now uses the strict Content Security Policy expression evaluator by default. Applications that rely on expression features that require dynamic code evaluation must update their expressions or explicitly configure an appropriate evaluator. Review and test application CSP settings after upgrading.

• HTML rendering in legacy form controls

  Formatted HTML supplied to legacy JET form components is handled more strictly. Review applications that supply HTML in labels, help, messages, or other form-control content and use the supported template or DOM APIs when richer content is required.

• URL and module path validation

  JET validates URLs used by links, message sounds, and DVT tooltip strings more strictly. Unsafe URL protocols are rejected or omitted. ModuleElementUtils, ModuleRouterAdapter, and legacy ojModule now validate module names and paths before loading view or view-model resources. Applications that derive module names from URLs, use broad regular-expression routes, or use unsupported RequireJS aliases must map them to explicit, safe logical module names.

• FilterFactory filtering

  FilterFactory now limits text-filter length and handles attribute string and multi-field object filters more strictly. Applications that create filters from unbounded user input should validate the input and verify expected filtering behavior after upgrading.

Tooling/Library Changes

• jQuery and jQuery UI

  JET now uses jQuery 4.0.0 and jQuery UI 1.14.2. JET components do not require application changes solely because of this update, but applications that use jQuery directly should test their code and review the jQuery 4.0 upgrade guide.

• Knockout

  JET now uses Knockout 3.5.3. The update includes Trusted Types support and TypeScript definition updates. TypeScript applications may need source updates for changes involving read-only and writable computed observables, computed or subscribable call signatures, and ko.applyBindings root-node nullability.

• Oracle JET CLI

  The CLI uses adm-zip 0.6.0 for ZIP processing and no longer includes the unused extract-zip dependency in generated templates. Webpack-enabled projects use Webpack 5.101.0. The deprecated svg option for ojet build and ojet serve has been removed; configure SVG sprite optimization through theme assets or hook-configured svgSprite options instead.

  Requests to use the removed Alta theme now fail with a clear error. Generated test and migration fixtures use current theme CSS paths.

Oracle JET Audit Framework

• There are no new Audit rules or updates in this release.

Documentation Accessibility

For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc.

Access to Oracle Support

Oracle customer access to and use of Oracle support services will be pursuant to the terms and conditions specified in their Oracle order for the applicable services.