列表与滚动

滚动视图

core.Scroll 是平台自己的滚动视图，因此惯性滑动、回弹、滚动条、吸附和触摸滚动都是原生的。子元素按纵向排开，设置 Horizontal 后按横向排开，长度随内容而定。

core.Scroll{Style: core.Style{FlexGrow: 1}, Children: []core.Node{
	core.View{Style: core.Style{Padding: core.All(16), Gap: 12}, Children: rows},
}}

滚动视图填满容器，内边距放在内容上，因此滚动条贴着边缘。除非样式另有设置，它会收缩以适应父容器。HideIndicator 隐藏平台指示器，Bar 绘制应用自己的滚动条。

Behavior 和 BehaviorFunc 决定滚动方式：Paging、SnapToInterval 和 SnapToOffsets 配合 SnapToAlignment、DecelerationRate、NoBounces、ContentInset 以及键盘相关规则。MinZoomScale 和 MaxZoomScale 允许双指缩放，OnRefresh 和 Refreshing 让下拉刷新，OffsetValues 在主线程跟随偏移，用于随滚动移动的效果。

page := core.Scroll{
	OnScroll: func(e core.ScrollEvent) { y.Set(e.Offset.Y) },
	Behavior: core.ScrollBehavior{
		Paging:                    true,
		KeyboardDismissMode:       core.KeyboardDismissOnDrag,
		KeyboardShouldPersistTaps: core.KeyboardTapsHandled,
	},
	Children: []core.Node{...},
}

OnScroll 每轮最多报告一次偏移，或按 ScrollEventThrottle 的间隔报告。OnScrollDragStart、OnScrollDragEnd、OnMomentumStart、OnMomentumEnd 和 OnScrollEnd 标出用户手势的起止。Ref 用 ScrollTo、ScrollToEnd、ZoomTo 和列表的 ScrollToIndex 从代码滚动。

列表

core.List 在原生滚动视图上显示长数据，只创建屏幕附近的行。Count 给出条目数，Row 构建一行；Key 给每行一个身份，因此在上面增删行时，保留下来的行会保留自己的单元格。

core.List{
	Count:         func() int { return len(items) },
	Key:           func(i int) any { return items[i].ID },
	EstimatedSize: 56,
	Row: func(cx *core.Scope, r core.ListRow) core.Node {
		item := items[r.Index()]
		return core.View{Style: core.Style{Padding: core.All(12)}, Children: []core.Node{
			core.Text{Content: item.Title},
		}}
	},
}

Header、Footer、Empty 和 Separator 放置在列表首尾和行之间。NumColumns 让行并排，Gap 和 ColumnGap 设置间距，Horizontal 横向滚动。StickyHeaderIndices 把这些行固定在视口起点，直到下一行把它们推走，StickyHeaderOffset 让它们上方的内容保持可见。

OnViewableItemsChange 按 ViewabilityConfig 的阈值报告可见行，OnLoadMore 在视口接近末尾时运行，每批行只运行一次。OnLoadMoreAtStart 在开头做同样的事，InitialScrollIndex 让列表从某一行打开。Inverted 把第 0 行放在末尾，像聊天一样，MaintainVisibleContentPosition 在用户接近末尾时跟随增长的内容。

core.List{Ref: list, Count: count, EstimatedSize: 64, Row: row, OnLoadMore: loadMore,
	StickyHeaderIndices: headers(), Footer: core.View{Style: core.Style{Height: core.Pt(24)}}}

list.ScrollToIndexAt(index, 0.5, 0, true) 把某一行滚到视口中间，list.ScrollToEnd(true) 滚到末尾。列表也可以和其他内容放在同一个页面里：设置 Viewport: core.ListViewportParent，外层的滚动视图会带着列表一起滚动。

表格

base/datatable 显示百万行的表格，行和列都虚拟化，带固定表头、排序、选择、调整和移动列，以及应用自己的单元格。base.Table 用于较小数据的普通表格，base/plot 绘制图表。

下一步

• 动画：跟随滚动视图的效果。
• 文本：会换行的文本行。
• 导航：内容可以滚动的页面。