Message Scroller消息滚动

查看源码components/message_scroller.go

消息流#

点击上下按钮改变调用方持有的滚动偏移。

启用 JavaScript 后可运行预览;源码和安装命令仍可直接查看。

用法
earlier, later := tree.ID(page, "earlier"), tree.ID(page, "later")
scroller := components.BeginMessageScroller(canvas, theme, viewport, 380, offset)
scroller = scroller.Buttons(earlier, "Earlier messages", later, "Later messages")
scroller.BeginContent()
for index := range 5 {
    item := scroller.ItemGeometry(index, float32(index)*74, 62)
    if item.Visible { canvas.Fill(item.Bounds, theme.Muted) }
}
scroller.EndContent()
if canvas.Clicked(earlier) { offset = max(0, offset-72) }
if canvas.Clicked(later) { offset = min(144, offset+72) }

接近末尾#

展示偏移、滑块和可用方向变化。

启用 JavaScript 后可运行预览;源码和安装命令仍可直接查看。

用法
bar := tree.ID(page, "scrollbar")
earlier, later := tree.ID(page, "earlier"), tree.ID(page, "later")
scroller := components.BeginMessageScroller(canvas, theme, viewport, 380, offset)
scroller = scroller.Scrollbar(bar, "Message position", "Conversation")
scroller = scroller.Buttons(earlier, "Earlier messages", later, "Later messages")
geometry := scroller.BeginContent()
item := scroller.ItemGeometry(4, 296, 62)
if item.Visible { canvas.Fill(item.Bounds, theme.Muted) }
scroller.EndContent()
if geometry.CanStart && canvas.Clicked(earlier) { offset = max(0, offset-72) }
if geometry.CanEnd && canvas.Clicked(later) { offset = min(144, offset+72) }

安装

将组件源码复制到自己的项目,直接修改。

仓库命令
go run ./cmd/viva add --out ./components/local message-scroller

源码组件用法#

此预览直接调用生产 Go 组件。稳定 ID、值与打开状态仍由应用持有;组件只负责绘制并声明交互语义。

  • 标题旁的源码链接列出了全部选项与视觉决策。
  • 请使用原生命令验证系统文本、焦点、无障碍与平台集成。
  • 浏览器预览验证共享布局和场景行为,不代表原生性能。

验证边界#

示例覆盖当前 API 的代表性状态,但不表示每个桌面后端都已完成真机验证。

键盘操作

Tab 在控件间移动;Ctrl/⌘ K 搜索组件。进入预览后,键盘事件由 Go 运行时处理。