ブラウザベースのクライアント拡張機能¶
利用可能な Liferay 7.4 U45+/GA45+
Liferayは、ページを補強し機能を統合するための、ブラウザベースの様々なクライアント拡張機能を提供します。 これらの拡張機能には、CSS、JS、テーマCSS、テーマFavicon、カスタム要素、IFrameが含まれます。
これらのエクステンションは Liferay Workspaceから作成し、デプロイすることができます。 これらのブラウザベースのクライアント拡張の基本バージョンを生成するには、Liferayワークスペースの Blade CLI を使って次のコマンドを実行します。
blade create -t client-extension [your-new-folder-name]
カスタム要素 と IFrame クライアント拡張の作成については、 カスタム要素および IFrame クライアント拡張を理解する を参照してください。
注釈
レイアウトセット(=ページセット)、マスターテンプレート、ページテンプレート、個々のコンテンツページに、JS、CSS、テーマCSSのクライアント拡張機能を追加することができます。 拡張機能を追加するレベルにより、どのエンティティが拡張機能のコードを継承するかが決まります。 例えば、マスターテンプレートに拡張機能を追加した場合、マスターテンプレートを使用しているすべてのページテンプレートとコンテンツページは、その拡張機能を継承します。
JavaScript クライアント拡張¶
JavaScriptのクライアント拡張機能は、最もわかりやすく、簡単に作ることができます。 JavaScriptクライアント拡張をLiferayインスタンスにデプロイし、それを使用するようにページを設定すると、そのページにアクセスするたびに、それに含まれるJavaScriptが自動的に実行されます。 これにより、OSGiモジュールやテーマを使用せずに、ページに特別な機能を追加することができます。
このタイプの作業を始めるには、 最初のJavaScriptクライアント拡張を作成する を参照してください。
CSS クライアント拡張¶
CSSクライアント拡張は、ページ上のCSSスタイリングを上書きする方法です。 CSSクライアント拡張をLiferayインスタンスにデプロイし、それを使用するようにページを設定すると、それに含まれるCSSが、テーマやスタイルブックの設定など、ページに存在するスタイリングを上書きします。
このタイプの作業を始めるには、 最初のCSSクライアントエクステンションを作成する を参照してください。
テーマCSSクライアントエクステンション¶
CSSクライアントエクステンションと同様に、テーマ全体を展開することなく、 テーマ と同じ方法でCSSを追加することも可能です。 このタイプのクライアント拡張機能では、 clay.css
ファイルと main.css
ファイルを使用します。これは、デフォルトでテーマによって生成されるスタイルファイルと同じものです。 このタイプのクライアント拡張は、Liferayアプリケーションメニューの Remote Apps からオプションとして追加できます。
注釈
このタイプのクライアント拡張機能を使用するには、clay.css
と main.css
ファイルがリモートでホストされている必要があります。
テーマファビコンクライアントエクステンション¶
また、クライアントエクステンションを使用して、Liferayのページのファビコンを上書きすることができます。 テーマのファビコンクライアント拡張をデプロイすると、それに含まれるアイコンファイルがLiferayのあらゆるページで利用可能になります。 ページデザインオプションメニューからページのファビコンを設定する際に、別の Client Extensions タブでアクセスすることができます。
カスタム要素クライアント拡張機能¶
旧製品名:カスタムエレメントリモートアプリ
カスタム要素クライアント拡張は、Liferayのフロントエンドインフラを使用して、外部アプリケーションをプラットフォームと統合し、ページウィジェットとしてレンダリングします。 Liferayの外からアクセスできるあらゆるドメインのアプリケーションを統合することができます。
カスタム要素クライアント拡張を使用するには、Liferayに登録するために必要なURLと詳細情報を持つエントリーを会社レベルで作成します。 そして、Liferay は各エントリに対してユニークなウィジェットを生成し、アプリケーションを カスタム HTML 要素としてレンダリングします。 .
詳しくは、 カスタムエレメントとIFrameクライアント拡張機能を理解する を参照してください。
IFrameクライアント拡張機能¶
旧製品名:IFrame Remote Apps
IFrame クライアント拡張は、 カスタム要素クライアント拡張と同様に動作します 。 しかし、外部アプリケーションを <iframe>
HTML 要素としてレンダリングし、ホストページからのインタラクションを制限することができます。 詳しくは、 カスタムエレメントとIFrameクライアント拡張機能を理解する を参照してください。