Documentation

リモートアプリケーションUIリファレンス

リモートアプリケーションは、Liferayのフロントエンド基盤を利用して、外部のJavaScriptアプリケーションを登録し、ページウィジェットとして描画します。 リモートアプリケーションにアクセスするには、 グローバルメニュー(Global Menu) を開き、 [アプリケーション] タブをクリックし、 [Remote Apps] へ移動します。

リモートアプリケーションを追加するには、 [追加] ボタン(Add Button)をクリックします。

リモートアプリを作成または編集する場合、選択したリモートアプリの種類(IFrameまたはカスタム要素など)に応じて、以下のフィールドを利用できます。

項目

説明

名前

リモートアプリのエントリーとそのウィジェットに使用される表示名です。

説明

リモートアプリのエントリーに対する説明です。

ソースコードURL

便宜上、外部アプリケーションのソースコードへのURLを指定します。

種類

現在、Liferayは2つのタイプをサポートしています。IFrameとカスタム要素です。 これらのタイプは、Liferayプラットフォームと外部アプリケーションの間の契約を決定します。

URL(IFrame

外部アプリケーションがホストされている場所のURL。 エントリーのウィジェットは、リモートアプリのURLを指す <iframe>要素でアプリをレンダリングします。

HTML 要素名 (カスタム要素)

その .js ファイルで宣言されているカスタム要素の名前。 カスタム要素を作成する.jsファイルは、その要素に名前を関連付ける必要があります。 この名前は、HTML要素名の値と一致する必要があります。

ESモジュールを使用(カスタム要素

ブラウザがアプリケーションのJSインジェクションを ESモジュールとして認識するかどうかを判断します。 有効にすると、Liferayはリモートアプリケーションを構築する際に<script src="js url" type="module">を使用するため、アプリケーションはES6ブラウザモジュールとして扱われます。

URL(カスタム要素

アプリケーションの.jsの各ファイルについて、個別の URLを入力します。 追加 ボタン(Add Button)をクリックして、URL項目をさらに追加します。

CSS URL (カスタム要素)

アプリケーションの.cssの各ファイルについて、個別のURLを入力します。 追加 ボタン(Add Button)をクリックして、CSS URL項目をさらに追加します。

インスタンス化可能

リモートアプリケーションのウィジェットがインスタンス化可能かどうかを判定します。 有効にすると、同じページにウィジェットの複数のインスタンスを追加することができます。

ポートレットのカテゴリー名

ウィジェットメニューで、ウィジェットのカテゴリを入力します。 デフォルト値は リモートアプリケーション です。

フレンドリURLのマッピング

ウィジェットのフレンドリURLマッピングを定義することで、よりユーザにとって読みやすいURLを使用して参照できるようになります。

詳細設定

アプリのウィジェットのすべてのインスタンスに含まれるデフォルトプロパティを定義します。 これらのプロパティは、ウィジェットによって追加のURL属性としてアプリケーションに渡されるため、プログラム的にアクセスすることができます。 必要であれば、個々のウィジェットインスタンスでこれらのエントリープロパティをオーバーライドするように設定することができます。