40 lines
1.3 KiB
Markdown
40 lines
1.3 KiB
Markdown
# 415 MailList 邮件列表
|
||
|
||
## 用途
|
||
|
||
展示虚拟化邮件列表，包含未读粗体、星标、附件计数、多选与打开事件。
|
||
|
||
## 最小示例
|
||
|
||
```go
|
||
var s mujica.ListState[string]
|
||
mails := []mujica.MailItem{{ID: "1", From: "Sakiko", Subject: "Second act", Unread: true, Attachments: 1}}
|
||
view := func(c *ui.Context) {
|
||
mujica.Use(c, mujica.Settings{})
|
||
if r := mujica.MailList(c, &s, mails, mujica.MailListOptions{}); r.Starred != "" {
|
||
mails[0].Starred = !mails[0].Starred
|
||
}
|
||
}
|
||
ui.Render(view, 400, 300, 1)
|
||
```
|
||
|
||
## 参数
|
||
|
||
`ListState[string]` 保存滚动与选择；`MailItem` 包含必填 ID、`From`、`Subject`、`Snippet`、`Time`、`Unread`、`Starred`、`Attachments`。`Height` 默认 420 DIP，必须 ≥ 0；`Disabled` 默认 false。
|
||
|
||
## 状态
|
||
|
||
默认、聚焦和悬停状态沿用主题、密度与文字缩放；适用操作在自身或祖先禁用时停止处理。
|
||
|
||
## 事件
|
||
|
||
`Changed()` 表示选择变化；`Opened` 返回打开的邮件 ID；`Starred` 返回请求切换星标的 ID。调用方更新数据。
|
||
|
||
## 键盘操作
|
||
|
||
上下方向键、Home / End 移动选择；Enter 或双击打开；S 请求星标；Cmd/Ctrl+A 全选；Cmd/Ctrl 点击切换单项，Shift 点击选择范围。
|
||
|
||
## 限制
|
||
|
||
星标、已读更新、邮件下载与打开由调用方处理；列表只构建可见行。
|