oracle-jet-core README

Features

This extension provides custom HTML data and snippet support for [Oracle JET]https://www.oracle.com/jet).

Custom HTML data support means that when you are editing HTML files, VS Code will offer auto-completion and hover for JET tags and attributes. As you start typing your Oracle JET html tag, a dropdown will show a list of matching choices.

This extension provides snippets for the most commonly used Oracle JET components. To invoke snippets, just type the shortcut and you will be shown a dropdown of choices. Each JET snippet shortcut starts with the letters "oj", a full list is shown below. Once you complete typing the shortcut, it will be replaced with the matching snippet, and the cursor will be moved to the relevant next position.

Intellisense for Oracle JET Web Components is available. Invoke the JET import from the command palette, select the folder containing your web components, and restart VSCode. Invoke JET Show Web Components Metadata to display an output channel summarizing the intellisense being used by this extension. Invoke JET Clear to reset the stored metadata.

A local mode is available for JET Web Components. In local mode, JET import will only store metadata to a workspace storage location. Intellisense will only use workspace-scoped lookups for JET web components. This may be useful for multiple workspaces with JET web components that vary by version, and no one global version would be accurate. This only applies to JET Web Components; JET core component Intellisense does not change.

JET auditing provides diagnostics for open files of javascript, html, or css types. These are shown in the VSCode Problems tab. JET audit reports are shown for open files in the JET output channel. Invoke JET Audit folder from the command palette for workspace reports and diagnostics.

JET decorations provide an indication of JET tags, selectable in settings.

Requirements

Custom data was stabilized in VS Code version 1.38 and this extension requires that version or higher.

Extension Settings

This extension modifies the user settings for:

• html.customData : points to the custom data file included in this extension

Known Issues

This version does not provides attribute value enumeration for nested JSON notation values.

VSCode currently has a bug that shows "data-" as an additional valid attribute, in cases where "data" is a valid attribute. Note that there is no valid "data-" attribute for JET.

There is a known bug in the HTML extension that requires you to restart VSCode after installation of this extension. After VScode fixes the issue, installation of this extension will no longer require a restart of VSCode.

For tsx/jsx files, insight is offered for JET tags, but full intellisense (hints for completion, attribute insight) is not yet available.

Release Notes

This release contains snippets and html tag support only for core Oracle JET components.

Snippets supported:

- "oj-checkboxset": "ojcb"
- "oj-combobox-one": "ojcbo
- "oj-combobox-many": "ojcbm
- "oj-input-date": "ojid"
- "oj-input-time": "ojiti
- "oj-input-date-time": "ojidt
- "oj-input-number": "ojin"
- "oj-input-password": "ojip"
- "oj-input-text": "ojit"
- "oj-label": "ojlab
- "oj-label-value": "ojlab
- "oj-radioset": "ojr"
- "oj-select-one": "ojso"
- "oj-select-many": "ojsm"
- "oj-slider": "ojsl"
- "oj-switch": "ojsw"   
- "oj-text-area": ""ojta"
- "oj-bind-text": "ojbt"
- "oj-bind-if": "ojbi"
- "oj-bind-for-each": "ojbfe
- "oj-table": "ojt"
- "oj-data-grid": "ojdg"
- "oj-list-view": "ojlv"
- "oj-tree-view": "ojtv"
- "oj-chart": "ojc" 
- "oj-rating-gauge": "ojrg"
- "oj-status-meter-gauge": "ojsmg
- "oj-option": "ojo"
- "oj-optgrp": "ojog"

About Oracle JET

To learn more about the Oracle JavaScript Extension Toolkit (JET), please visit the Oracle JET website.

License

Copyright (c) 2014, 2023 Oracle and/or its affiliates The Universal Permissive License (UPL), Version 1.0