リリース16.0.0のOracle JETドキュメントで説明されている新機能

ここでは、リリース16.0.0に追加された新機能および拡張機能について説明する、Oracle JETのドキュメントの更新を示します。

このリリースのその他の変更については、製品のリリース・ノートを参照してください。

Oracle JET

このリリースのOracle JETのドキュメントの更新事項。

移行情報

リリース16.0.0に移行するJETアプリケーションに影響する次の変更に注意してください:

このリリースのOracle JETへのアプリケーションの移行に関するステップバイステップ情報については、次の項を参照してください。

Oracle JET Audit Framework

このリリースのOracle JETには、Oracle JET Audit Framework (JAF)のバージョン8.13.5が含まれています。

Oracle JET Audit Frameworkの使用および拡張は、次のように更新されました。

新規および変更されたJAF監査機能:

  • JAFでは既存のルールに変更が加えられています:

    • Rule: oj-html-alta-deprecated Severity: blocker¹ Message ID's: jet-0510, 5825

      このルールでは、JETバージョンのエージ・チェックが実行されなくなり、その重大度がblockerになりました。以前の重大度はmajorでした。 

    • Rule: oj-ts-ojcomp-deprecated Severity: major Message ID: jet-3400 
Deprecated JET component classes should not be instantiated

      このルールによって生成されるメッセージには、クラスを非推奨にしたリリースを識別するためのsince値が含まれるようになり、開発者がメタデータに説明を含めていない場合に非推奨のクラスに使用する代替も追加されます。

    • oj-html-slot-pref-contentおよびoj-tsx-slot-pref-contentルールの拡張メッセージ情報

      出力形式が非proseの場合、oj-html-slot-pref-contentおよびoj-tsx-slot-pref-contentルールでは、監査診断メッセージから解析された拡張メッセージ情報が提供されるようになりました。拡張情報は、出力オブジェクトまたはJSONエントリにmsgExプロパティとして表示されます。そのルールのmsgExの形式については、ルールの説明を参照してください。

    • jetwc-require-pathsルールでは、標準セット(JET-60499)にJETコア・パックのoj-cパスを追加する標準セット(JET-60512)を補完するために、構成内でのadditionalPaths配列の定義が可能になりました
  • JAFには新しいルールが含まれます:

    • テーマのアンチパターンの使用を識別するルール。 

      Rule: oj-html-wctag-anti-pattern  Severity: info  Message ID: jet-2220
Some components, or component features, may be present but are not applicable for use in all design
systems and as such may be flagged as anti-patterns in the content of a particular theme. In these
cases, the feature should not be used if targeting the design system in question.

Rule: oj-tsx-wctag-anti-pattern  Severity: info  Message ID: jet-7175
Some components, or component features, may be present but are not applicable for use in all design
systems and as such may be flagged as anti-patterns in the content of a particular theme. In these
cases, the feature should not be used if targeting the design system in question.

Rule: oj-html-prop-anti-pattern  Severity: info¹  Message ID's: jet-2225, 2226
Some components, or component features, may be present but are not applicable for use in all design
systems and as such may be flagged as anti-patterns in the content of a particular theme. In these
cases, the feature should not be used if targeting the design system in question.
¹ Possibility of more than 1 severity since there are 2 message ID's

Rule: oj-tsx-prop-anti-pattern  Severity: info¹  Message ID's: jet-7180, 7181
Some components, or component features, may be present but are not applicable for use in all design
systems and as such may be flagged as anti-patterns in the content of a particular theme. In these
cases, the feature should not be used if targeting the design system in question.
¹ Possibility of more than 1 severity since there are 2 message ID's

    • <oj-tree-view>テンプレート内のアクション可能なコンテンツをチェックするルール 

      Rule: oj-html-treeview-actionable-content  Severity: blocker  Message ID: jet-5835
<oj-tree-view> does not support actionable/interactive content (i.e. buttons, links, Inputs, etc)
inside templated content.

Rule: oj-tsx-treeview-actionable-content  Severity: blocker  Message ID: jet-7185
<oj-tree-view> does not support actionable/interactive content (i.e. buttons, links, Inputs, etc)
inside templated content.

    • バインディング・タグのスロット属性の使用をチェックし、デフォルト・スロットを持つコンポーネントの直接の子であるバインディング・タグをチェックするルール。

      Rule: oj-html-binding-as-slot-child  Severity: blocker¹  Message ID's: jet-5840, 5841
JET binding components such as <oj-bind-if> are not present in the final browser DOM at runtime, and
as such will not function correctly when directly assigned to a slot. They should always be wrapped
in another element such as a <div> or which has the slot attribute applied.

¹ Possibility of more than 1 severity since there are 2 message ID's
    • Rule: jetwco-validate-applied-audits  Severity: blocker  Message ID: jetwco-0050
This rule checks that any applied-audits defined by a component are actually valid in the context of
the available rule-packs

    • 兄弟を持つポップアップ・タイプ・コンポーネントの使用を確認します。Preactとコンポーネント自体の両方がポップアップDOMの親の変更を実行するため、競合が発生する可能性があります。ポップアップ・コンポーネントは、独自のラッパー要素にラップする必要があります。

      Rule: oj-tsx-popup-sibling  Severity: major  Message ID: jet-7190
Due to an integration issue between Preact and the JET popup components (such as <oj-popup>,
<oj-dialog> and <oj-drawer-popup>) where both Preact and the components themselves perform
reparenting of the popup DOM, the popup component should be wrapped in its own wrapper element.
e.g. replace

<div>
  <oj-dialog>Hello</oj-dialog>
  <oj-button>Open Popup</oj-button>
</div>

with:

<div>
  <div>
    <oj-dialog>Hello</oj-dialog>
  </div>
  <oj-button>Open Popup</oj-button>
</div>
    • ライトバック構文の使用をチェックします
      Rule: oj-html-attr-expr-writeback  Severity: minor  Message ID: jet-2235
An attribute expression uses write-back syntax ("{{...}}" but the attribute 
metadata does not support write-back. Note that although technically incorrect, 
functionally there is no harm incurred by using the wrong style of 
binding notation for a read-only property except for a theoretical performance 
penalty (minimal).

    • コンポーネント・メタデータの説明テキストをチェックします

      Rule: jetwc-well-formed-description  Severity: info  Message ID: jetwc-0240
This rule checks that any description text defined as part of a components metadata is expressed as
well formed sentences with a leading capital and terminating period / full stop

    • JETコア・パック・コンポーネントで使用する場合、HTMLでのon-focusイベントおよびon-blurイベントの使用をチェックします。

      Rule: oj-html-event-focus-blur  Severity: minor  Message ID: jet-2240
JET Core-Pack components do not dispatch focus or blur events. Listen for focusin and focusout
events instead.

    • <oj-c-button>のデフォルト・スロットが使用されていないことを確認します

      Rule: ojc-html-button-defslot  Severity: blocker¹  Message ID's: ojc-0010, 0011
There is no default slot for <oj-c-button>. If it has been used to label the button, the 'label'
attribute should be used.

Rule: ojc-tsx-button-defslot  Severity: blocker¹  Message ID's: ojc-0015, 0016
<oj-c-button> does not have a default slot defined for it. (To label a button the 'label' property
should be used.

    • TSXファイルでの不明なイベントの使用をチェックします

      Rule: oj-tsx-event  Severity: major  Message ID: jet-7195
JSX component event attributes (e.g. "onojXxx" or onYyyChanged) must be defined events for the
component.
    • Rule: oj-html-slot-default  Severity: major  Message ID: jet-0530
A child component is defined in a component parent's default slot, but the parent does not support
default slots.
  • JAFでは、次のルールが削除されました:
    • oj-html-combo-converterとoj-tsx-combo-converter (および対応するメッセージであるJET-0380とJET-7045)は廃止されました。これらのルールは、コンバータがコンボのドロップダウン内のラベルを書式設定しなくなった、JET 9.2.0で導入された動作変更を開発者に警告していました。

ルール・ライターの変更:

  • Oracle JAF Issueクラスには、出力オブジェクトに追加情報を追加するために使用できる新しいメソッドsetMsgEx()が含まれています。「ルール問題クラスのメソッド」を参照してください。

  • 新しいMetaLibメソッド

    getTagStatus()、getPropStatus()およびisTagStatus()メソッドは、deprecated、antiPattern、maintenanceまたはsupersedesのコンポーネントまたはプロパティのステータスをすばやくチェックします。Oracle JET監査メタデータ・インタフェース・ライブラリのMetadataメソッドに関する項を参照してください。

  • MetaLib.hasTagDynamicSlot()

    このメソッドは、ユーザー・コンポーネントおよびJETコア・パック・コンポーネントに加えて、レガシーJETコンポーネント(oj-*)に対してtrueを返すようになりました。Oracle JET監査メタデータ・インタフェース・ライブラリのTagメソッドに関する項を参照してください。

  • 新しいTSXルール・リスナー・タイプ

    TsxEventを使用すると、ルールでは、他のTsxXxxリスナーがコールされる前に、.tsxファイル内の各関数宣言に対してTsxFunctionがコールされている間にTSXレンダリング可能コンテンツ内のイベント・プロパティをリスニングできます。TSXルールのリスナー・タイプに関する項を参照してください。

  • 新しいJafLibメソッド

    2つの新しいリリース・カウント・メソッド(getMajorReleaseCount(string semver | number major)およびgetJafReleaseCount())は、JETメジャー・リリースの推定数を返します。JafLib: JAFコア・アクセス・メソッドに関する項を参照してください。

  • 非推奨のWebコンポーネントのJETバージョン・エージング・ポリシー

    このポリシーは変更されました。以前は、非推奨になってから3つ以上のメジャーJETリリースが経過した場合、JAFは発行したメッセージの重大度をblockerに上げました。これはすべてのWebコンポーネントに適用されました。エージング・チェックはJETコンポーネントにのみ適用され、ユーザー定義コンポーネントには適用されません。JAFは、JETコンポーネントとユーザー定義コンポーネントを区別します。以前は、一部のコンポーネントはこれに従っていませんでした。次のルールは更新されました。

    oj-html-ojtag-deprecated
oj-html-ojattr-deprecated
oj-html-ojattr-enum-deprecated
oj-html-slot-deprecated
oj-tsx-ojtag-deprecated
oj-tsx-slot-deprecated
oj-tsx-ojattr-deprecated
oj-tsx-ojattr-enum-deprecated

ドキュメントのアクセシビリティ

オラクルのアクセシビリティについての詳細情報は、Oracle Accessibility ProgramのWebサイト(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=docacc)を参照してください。

Oracleサポートへのアクセス

サポートをご契約のお客様には、My Oracle Supportを通して電子支援サービスを提供しています。詳細情報は(http://www.oracle.com/pls/topic/lookup?ctx=acc&id=info) か、聴覚に障害のあるお客様は (http://www.oracle.com/pls/topic/lookup?ctx=acc&id=trs)を参照してください。