ScrollArea

为长内容提供可滚动区域。

实时预览

正在加载预览…

参数配置

全部字段 6

ScrollAreaOptions

Styles · 0

Go 代码

Go
// Inside a view; c is *ui.Context, t is nui.Theme.
nui.ScrollArea(c.Key("scroll"), t, nui.ScrollAreaOptions{ScrollbarWidth: nui.Set(float32(6))}, func() {
	for i := range 30 {
		ui.Textf(c.Key(i), "Activity item %02d", i+1).Padding(8)
	}
}).Height(240)

使用说明

在预览区域滚动 30 条示例记录，并调整滚动条宽度。ScrollArea 的父布局需要给出高度约束；实际动态记录应使用稳定业务 ID。

API 参考

ScrollArea

源码 
func ScrollArea(c *ui.Context, t Theme, opts ScrollAreaOptions, content func()) ui.Element

ScrollAreaOptions

源码 
type ScrollAreaOptions struct {
	Direction      ScrollDirection
	ScrollbarColor Optional[ui.Color]
	ScrollbarWidth Optional[float32]
	State          *ui.ScrollState
	Decoration
}
字段类型说明
DirectionScrollDirection

Go 零值: zero value

滚动区域支持的方向。

ScrollbarColorOptional[ui.Color]

Go 零值: unset

滚动条颜色覆盖。

ScrollbarWidthOptional[float32]

Go 零值: unset

滚动条宽度覆盖。

State*ui.ScrollState

Go 零值: nil

由应用持有的持久控件状态。

UIStyles

Go 零值: zero value

以部件名称为键覆盖外观和间距。

Stylefunc(Slot, ui.Element)

Go 零值: nil

同步配置当前构建的部件；不要保留 Element。