ポータルの各ページの <body>
タグの前に、カスタム JavaScript コードまたは HTML コンテンツを追加します。分析トラッキングの構成もご覧ください。
たとえば、次のようなカスタム スクリプトを定義できます。
- ポータルの各ページが DOM に読み込まれたときに
onLoad
JavaScript イベントによって実行されるスクリプト。 - ポータルの各ページから離れたときに
onUnload
JavaScript イベントによって実行されるスクリプト。
カスタム関数は、(window
変数で宣言された)グローバル名前空間内の portal.pageEventListeners
の一部として定義する必要があります。
onLoad
イベントと onUnload
イベントはどちらも、最初のパラメータとしてページの現在のパス(例: /quickstart
)を受け取ります。onUnload
関数は 2 番目のパラメータとして onLoad
呼び出しの戻り値を受け取るため、これら 2 つのイベントの間でコンテキストを受け渡すことができます。onUnload
では、不要になったイベント リスナーなどのクリーンアップ処理を行います。
例:
<script>
window.portal = {};
window.portal.pageEventListeners = {
onLoad: (path) => {
if (path === '/quickstart') {
// Change text content of first <p> element to something
// else. (DOM must be loaded when onLoad is called)
document.getElementsByTagName('p')[0].textContent =
'Welcome to the quick start! Be sure to send us your feedback.';
// print a custom message to the console every second while user is on
// quickstart page.
const interval =
window.setInterval(() => console.log('Hello'), 1000);
return interval;
}
return undefined;
},
onUnload: (path, contextReturnedFromOnLoad) => {
if (contextReturnedFromOnLoad != null) {
// Stop printing custom message to console every second.
window.clearInterval(contextReturnedFromOnLoad)
}
},
};
</script>
ポータルの各ページにカスタム JavaScript コードを追加するには:
- [Publish] > [Portals] を選択し、目的のポータルを選択します。
- 上部のナビゲーション バーにあるプルダウン メニューから [Settings] を選択します。
- [Custom Scripts] タブをクリックします。
- [Custom Scripts] セクションにあるテキスト ボックスにカスタム JavaScript コードを入力します。
複数のスクリプトを含めることができます。
警告: カスタムコードは必ず<script>
タグと</script>
タグで囲んでください。無効な JavaScript コードは、コンテンツの正しい表示を妨げたり、サイト全体のセキュリティを脆弱にしたりすることがあります。 - [Save] をクリックします。