カスタム スクリプトの追加

ポータルの各ページの <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 コードを追加するには:

  1. [Publish] > [Portals] を選択し、目的のポータルを選択します。
  2. 上部のナビゲーション バーにあるプルダウン メニューから [Settings] を選択します。
  3. [Custom Scripts] タブをクリックします。
  4. [Custom Scripts] セクションにあるテキスト ボックスにカスタム JavaScript コードを入力します。
    複数のスクリプトを含めることができます。
    警告: カスタムコードは必ず <script> タグと </script> タグで囲んでください。無効な JavaScript コードは、コンテンツの正しい表示を妨げたり、サイト全体のセキュリティを脆弱にしたりすることがあります。
  5. [Save] をクリックします。