待办事项
待办事项是 Glint 的核心内容单元。每个待办事项属于一个分组,可以拥有嵌套的子待办层级,并支持评论和多选批量操作。
创建待办事项
在待办事项列表顶部的输入框中输入内容,然后按回车或点击添加。新待办事项将附加到列表末尾,具有下一个可用的 sortOrder 值。
若要创建子待办事项,请参见下方的子待办事项章节。
子待办事项
子待办事项是附属于父待办事项的嵌套待办。支持与顶级待办事项相同的所有操作(编辑、完成、删除、评论)。
创建子待办事项的步骤:
- 将鼠标悬停在现有待办事项上,显示其
...菜单。 - 点击添加子待办(或使用右键上下文菜单)。
- 输入标题后按回车。
子待办事项在其父项下方以缩进形式显示。点击父项旁边的展开/折叠箭头可控制子待办列表的显示。
WARNING
删除父待办事项会同时永久删除其所有子待办及相关评论。此操作不可撤销。
需要:add_subtodos 权限。
完成待办事项
点击复选框切换完成状态。已完成的待办事项以删除线样式显示。
- 你始终可以切换自己的待办状态。
- 切换他人的待办事项需要
complete_any_todo权限。
若分组启用了分离已完成待办选项,已完成的待办事项将移至列表底部的可折叠"已完成"区域中。
内联编辑
- 从
...菜单或右键上下文菜单中点击编辑。 - 待办事项标题变为可编辑输入框。
- 按回车保存,按 Escape 取消(不保存修改)。
需要:编辑自己的待办需要 edit_own_todos,编辑他人的需要 edit_any_todo。
排序
在桌面端,抓取待办事项左侧的拖拽手柄并拖动到新位置。排序结果会自动保存到服务器。
- 移动端不支持拖拽排序。
- 只能在同一分组内对顶级待办事项进行相互排序。子待办事项的排序同样遵循此规则,仅限其父项的子列表范围内。
需要:reorder_todos 权限。
评论
每个待办事项都有独立的评论区:
- 点击待办事项上的评论按钮或评论数量标记。
- 评论对话框打开,显示所有评论,包含作者、时间戳和内容。
- 输入新评论后点击发送(或按 Ctrl+Enter / Cmd+Enter)。
- 点击垃圾桶图标可删除评论(自己的评论可见,若拥有
delete_any_comment权限则可删除所有评论)。
需要:发布评论需要 comment 权限;删除需要 delete_own_comments 或 delete_any_comment。
多选操作
多选模式允许对多个待办事项同时执行批量操作。
进入选择模式:
- 右键点击任意待办事项 → 选择
- 或打开
...菜单 → 选择
选择条目:
- 点击任意待办事项切换选中 / 未选中状态。
- Shift+点击可范围选中从上次点击处到当前位置之间的所有待办事项。
- 点击选择栏中的全选可选中所有可见待办事项。
批量操作(通过选择栏):
| 操作 | 说明 |
|---|---|
| 标记完成 | 将所有选中待办事项设为已完成 |
| 标记未完成 | 清除所有选中待办事项的完成状态 |
| 删除 | 永久删除所有选中待办事项(及其子待办) |
| 清除选择 | 退出选择模式,不做任何更改 |
右键上下文菜单
右键点击任意待办事项可打开上下文菜单,包含所有可用操作:
- 添加子待办
- 评论
- 选择 / 取消选择
- 全选
- 编辑
- 标记完成 / 标记未完成
- 删除
可用操作会根据当前权限自动过滤。你没有权限执行的操作将被隐藏或禁用。
键盘快捷键
| 快捷键 | 操作 |
|---|---|
| 回车 | 提交新待办事项输入 |
| Escape | 取消内联编辑 |
| Ctrl+Enter / Cmd+Enter | 发送评论 |
| Shift+点击 | 范围选择待办事项(在多选模式下) |
API 参考
完整的端点参考(包括字段级权限检查和级联删除行为),详见待办事项 API。