Skip to content

待办事项

待办事项是 Glint 的核心内容单元。每个待办事项属于一个分组,可以拥有嵌套的子待办层级,并支持评论和多选批量操作。


创建待办事项

在待办事项列表顶部的输入框中输入内容,然后按回车或点击添加。新待办事项将附加到列表末尾,具有下一个可用的 sortOrder 值。

若要创建子待办事项,请参见下方的子待办事项章节。


子待办事项

子待办事项是附属于父待办事项的嵌套待办。支持与顶级待办事项相同的所有操作(编辑、完成、删除、评论)。

创建子待办事项的步骤:

  1. 将鼠标悬停在现有待办事项上,显示其 ... 菜单。
  2. 点击添加子待办(或使用右键上下文菜单)。
  3. 输入标题后按回车

子待办事项在其父项下方以缩进形式显示。点击父项旁边的展开/折叠箭头可控制子待办列表的显示。

WARNING

删除父待办事项会同时永久删除其所有子待办及相关评论。此操作不可撤销。

需要:add_subtodos 权限。


完成待办事项

点击复选框切换完成状态。已完成的待办事项以删除线样式显示。

  • 你始终可以切换自己的待办状态。
  • 切换他人的待办事项需要 complete_any_todo 权限。

若分组启用了分离已完成待办选项,已完成的待办事项将移至列表底部的可折叠"已完成"区域中。


内联编辑

  1. ... 菜单或右键上下文菜单中点击编辑
  2. 待办事项标题变为可编辑输入框。
  3. 回车保存,按 Escape 取消(不保存修改)。

需要:编辑自己的待办需要 edit_own_todos,编辑他人的需要 edit_any_todo


排序

在桌面端,抓取待办事项左侧的拖拽手柄并拖动到新位置。排序结果会自动保存到服务器。

  • 移动端不支持拖拽排序。
  • 只能在同一分组内对顶级待办事项进行相互排序。子待办事项的排序同样遵循此规则,仅限其父项的子列表范围内。

需要:reorder_todos 权限。


评论

每个待办事项都有独立的评论区:

  1. 点击待办事项上的评论按钮或评论数量标记。
  2. 评论对话框打开,显示所有评论,包含作者、时间戳和内容。
  3. 输入新评论后点击发送(或按 Ctrl+Enter / Cmd+Enter)。
  4. 点击垃圾桶图标可删除评论(自己的评论可见,若拥有 delete_any_comment 权限则可删除所有评论)。

需要:发布评论需要 comment 权限;删除需要 delete_own_commentsdelete_any_comment


多选操作

多选模式允许对多个待办事项同时执行批量操作。

进入选择模式:

  • 右键点击任意待办事项 → 选择
  • 或打开 ... 菜单 → 选择

选择条目:

  • 点击任意待办事项切换选中 / 未选中状态。
  • Shift+点击可范围选中从上次点击处到当前位置之间的所有待办事项。
  • 点击选择栏中的全选可选中所有可见待办事项。

批量操作(通过选择栏):

操作说明
标记完成将所有选中待办事项设为已完成
标记未完成清除所有选中待办事项的完成状态
删除永久删除所有选中待办事项(及其子待办)
清除选择退出选择模式,不做任何更改

右键上下文菜单

右键点击任意待办事项可打开上下文菜单,包含所有可用操作:

  • 添加子待办
  • 评论
  • 选择 / 取消选择
  • 全选
  • 编辑
  • 标记完成 / 标记未完成
  • 删除

可用操作会根据当前权限自动过滤。你没有权限执行的操作将被隐藏或禁用。


键盘快捷键

快捷键操作
回车提交新待办事项输入
Escape取消内联编辑
Ctrl+Enter / Cmd+Enter发送评论
Shift+点击范围选择待办事项(在多选模式下)

API 参考

完整的端点参考(包括字段级权限检查和级联删除行为),详见待办事项 API