予定枠最上部の要素を取得する

目次

予定枠最上部の要素を取得する

予定枠最上部の要素を取得します。
1 つのポータルに複数のポートレットがある場合、最初のポートレットのみ動作します。

  • 取得する位置の詳細は、次のとおりです。
    • 日表示画面

    • 週表示画面

    • 月表示画面

    • グループ日表示

    • グループ週表示

関数

garoon.schedule.calendar.getDayFirstSpaceElement(viewType, date)

利用できるバージョン

  • クラウド版 Garoon
  • パッケージ版 Garoon 4.10 以降
    ただし、グループ週表示画面は、パッケージ版 Garoon 4.6 以降

引数

パラメーター名 指定する値 必須 説明
viewType 文字列 必須 取得するスペース要素の画面表示の種類
次のいずれかの値を指定します。
  • DAY:日表示画面
  • WEEK:週表示画面
  • MONTH:月表示画面
  • GROUP_DAY:グループ日表示画面
  • GROUP_WEEK:グループ週表示画面
date 文字列 必須 取得するスペース要素の日付
「YYYY-MM-DD」の形式で指定します。
例:2022-09-29

戻り値

説明
Element オブジェクト 予定枠最上部の要素
null になる条件
  • 指定された要素が存在しない。

サンプルコード

1
2
3
4
5
6
7
8
9
// 追加したい要素を作成
const divElement = document.createElement('div');
divElement.textContent = 'Hello World';

// 月表示画面の予定枠最上部の要素を取得
const element = garoon.schedule.calendar.getDayFirstSpaceElement('MONTH', '2022-09-29');

// 作成した要素を取得した空白部分の要素に追加
element.appendChild(divElement);

利用できる画面

  • 日表示 *1
  • 月表示 *1
  • 週表示 *1
  • グループ日表示 *1
  • グループ週表示 *1
  • ポータル *2
  • 個人設定:My ポータルのプレビュー *2
  • システム管理(各アプリケーション):ポータルのプレビュー *2
  • システム管理(各アプリケーション):選択ユーザーでのポータルのプレビュー *2
  • ポータルの設定:プレビュー *2
  • ポータルの設定:ユーザーを選択してプレビュー *2

*1 引数に指定した viewType によって異なります。 ^

*2 ポータルにポートレットを配置した場合のみ動作します。 ^