大网数据广告活动
Microsoft Graph 接口

微软待办 Microsoft Graph Toolkit 中的组件

· 52CE 我爱测

利用微软待办组件,用户可以查看、添加、删除、完成或编辑 todo 任务。 它适用于 Microsoft 微软待办 中微软待办。

微软待办 组件用于使登录用户可以使用 Microsoft Graph 中的 微软待办 API 查看、添加、删除、完成和/或编辑 微软待办 中的任务。

示例

以下示例显示登录用户使用组件微软待办任务mgt-todo。 可以使用代码编辑器查看属性 如何 更改组件的行为。

<iframe src="https://mgt.dev/iframe.html?id=components-mgt-todo--tasks&source=docs" height="500"></iframe>

在 mgt.dev 中打开此示例

属性

可以使用下列属性和属性自定义组件。

属性 属性 说明
只读 readOnly 一个布尔值,用于将任务界面设置为只读, (添加或删除任务) 。 默认值为“false”。
hide-header hideHeader 显示或隐藏组件标头的布尔值。 默认值为“false”。
hide-options hideOptions 用于显示或隐藏任务中的选项的布尔值。 默认值为“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 {
  --tasks-background-color
  --tasks-header-padding
  --tasks-title-padding
  --tasks-plan-title-font-size
  --tasks-plan-title-padding

  --tasks-new-button-width
  --tasks-new-button-height
  --tasks-new-button-color
  --tasks-new-button-background
  --tasks-new-button-border
  --tasks-new-button-hover-background
  --tasks-new-button-active-background

  --task-margin
  --task-background
  --task-border
  --task-header-color
  --task-header-margin

  --task-new-margin
  --task-new-border
  --task-new-input-margin
  --task-new-input-padding
  --task-new-input-font-size
  --task-new-select-border

  --task-new-add-button-background
  --task-new-add-button-disabled-background
  --task-new-cancel-button-color

  --task-complete-background
  --task-complete-border

  --task-icon-alignment: flex-start (default) | center | flex-end
  --task-icon-background
  --task-icon-background-completed
  --task-icon-border
  --task-icon-border-completed
  --task-icon-border-radius
  --task-icon-color
  --task-icon-color-completed
}

若要了解更多信息,请参阅 设置组件样式。

事件

从组件中触发以下事件。

事件 何时发出 自定义数据 Cancelable 气泡 使用自定义模板
taskClick 当用户单击或点击任务时触发 选定的 任务 否 否 否

有关处理事件的信息,请参阅 事件。

模板

组件 tasks 支持 多个模板 ,允许您替换组件的某些部分。 若要指定模板,请包含 <template> 组件中的元素,将 data-type 值设置为以下值之一。

数据类型 数据上下文 说明
task task: a to-do task object 替换整个默认任务。
task-details task: a to-do task object 模板将替换任务的详细信息部分。

下面的示例定义任务组件的模板。

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

Microsoft Graph 权限

此控件使用下列 Microsoft Graph API 和权限。

配置 权限 API
targetId set Tasks.Read /me/todo/lists/${listId}、 /me/todo/lists/{todoTaskListId}/tasks
targetId 未设置 Tasks.Read /me/todo/lists、 /me/todo/lists/{todoTaskListId}/tasks
创建、更新或删除任务 Tasks.ReadWrite /me/todo/lists/{todoTaskListId}/tasks/{taskId}

身份验证

任务组件使用身份验证文档中介绍的全局 身份验证提供程序。

缓存

组件 mgt-todo 不缓存任何数据。

历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 sebastienlevert)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。