Microsoft Graph Toolkit でコンポーネントを実行するには

To Do コンポーネントは、サインインしているユーザーが Microsoft Graph の To Do API を使用して、Microsoft To Do からタスクを表示、追加、削除、完了、または編集できるようにするために使用されます。

次の例では、 mgt-todo コンポーネントを使用してサインインしているユーザーの Microsoft To Do タスクを表示します。 コード エディターを使用して、プロパティ がコンポーネントの動作をどのように変更させるかを確認することができます。

プロパティ

次の属性とプロパティを使用して、コンポーネントをカスタマイズできます。

属性 プロパティ 説明
読み取り専用 readOnly タスク インターフェイスを読み取り専用に設定するブール値 (タスクの追加または削除なし)。 既定値は false です。
initial-id="folder_id" initialId 最初に表示されたフォルダーを指定された ID に設定する文字列 ID。
target-id="folder_id" targetId タスク インターフェイスを指定されたフォルダー ID にロックする文字列 ID。
該当なし isNewTaskVisible レンダー時に新しいタスク ビューを表示するかどうかを指定します。
該当なし taskFilter ユーザーに表示されるタスクをフィルター処理する省略可能な関数。

次の例では、ID が 12345 のフォルダーのタスクのみを示しており、ユーザーが新しいタスクを作成することはできません。

<mgt-todo read-only initial-id="12345"></mgt-todo>

カスタム CSS 変数

mgt-todo コンポーネントは、以下の CSS カスタム プロパティを定義します。

<mgt-todo class="todo"></mgt-todo>
.todo {
    --task-new-cancel-button-color: blue;
    --task-detail-color: purple;
    --task-color: black;
    --task-background-color: white;
    --task-complete-background-color: grey;
    --task-date-input-active-color: blue;
    --task-date-input-hover-color: green;
    --task-background-color-hover: grey;
    --task-box-shadow: 0 0 10px 0 rgba(0, 0, 0, 0.2);
    --task-border: 1px solid black;
    --task-border-completed: 1px solid grey;
    --task-radio-background-color: green;
}

詳細については、「コンポーネントのスタイリング」を参照してください。

イベント

コンポーネントから次のイベントが発生します。

イベント いつ出力されるか カスタム データ キャンセル カスタム テンプレートを使用する
taskClick ユーザーがタスクをクリックまたはタップしたときに発生します 選択した タスク いいえ いいえ いいえ

イベントの処理の詳細については、「 イベント」を参照してください。

テンプレート

todo コンポーネントは、いくつかの テンプレート をサポートしており、コンポーネントの特定の部分を置き換えることができます。 テンプレートを指定するには、コンポーネント内に <template> 要素を含め、 data-type を次のいずれかの値に設定します。

データ型 データ コンテキスト 説明
タスク task: To Do タスク オブジェクト 既定のタスク全体を置き換えます。
task-details task: To Do タスク オブジェクト テンプレートは、タスクの詳細セクションを置き換えます。

次の例では、タスク コンポーネントのテンプレートを定義します。

<mgt-todo>
    <template data-type="task-details">
        <div>
            Importance Level: {{task.importance}}
        </div>
    </template>
</mgt-todo>

Microsoft Graph のアクセス許可

このコントロールは、以下の Microsoft Graph API とアクセス許可を使用します。 呼び出される API ごとに、ユーザーには、一覧表示されているアクセス許可の少なくとも 1 つが必要です。

構成 アクセス許可 API
targetId または initialId セット Tasks.Read、Tasks.ReadWrite /me/todo/lists/${listId}, /me/todo/lists/{todoTaskListId}/tasks
targetId 設定されていません Tasks.Read、Tasks.ReadWrite /me/todo/lists, /me/todo/lists/{todoTaskListId}/tasks
タスクの作成、更新、または削除 Tasks.ReadWrite /me/todo/lists/{todoTaskListId}/tasks/{taskId}

認証

todo コンポーネントは、 認証ドキュメントで説明されているグローバル認証プロバイダーを使用します。

キャッシュ

mgt-todo コンポーネントはデータをキャッシュしません。

ローカリゼーション

コントロールは、ローカライズできる次の変数を公開します。 詳細については、「 コンポーネントのローカライズ」を参照してください。

文字列名 既定値
cancelNewTaskSubtitle Cancel
newTaskPlaceholder Add a task
newTaskLabel New Task Input
addTaskButtonSubtitle Add
deleteTaskLabel Delete Task
dueDate Due date
newTaskDateInputLabel New Task Date Input
newTaskNameInputLabel New Task Name Input
cancelAddingTask Cancel adding a new task