属性

属性	类型	默认值	说明
enabled	boolean	true	子树里要不要用自绘滚动条。设为 false 时子树不初始化，已经挂上的会被销毁。嵌套时内层覆盖外层。
autoHide	'never' | 'scroll' | 'leave' | 'move'	'scroll'	滚动条自动收起的时机。never 一直显示，scroll 滚动时显示，leave 指针离开后收起，move 指针移动时显示。
autoHideDelay	number	800	自动收起前等待的毫秒数。
options	ScrollbarsOptions	—	透传给 OverlayScrollbars 的选项（PartialOptions）。最后深合并，优先级最高。

插槽

插槽	说明
default	使用自绘滚动条的子树。

其它导出

导出	类型	说明
useScrollbars	(target: MaybeRefOrGetter<HTMLElement | null | undefined>, options?: UseScrollbarsOptions) => UseScrollbarsResult	给自己写的滚动容器挂上自绘滚动条。外层没有 ScrollbarsProvider 时什么都不做。容器自己就是视口，子节点不动。要在 Provider 的后代组件里调用。
UseScrollbarsOptions	{ enabled?: MaybeRefOrGetter<boolean> }	useScrollbars 的第二个参数。enabled 默认 true，控制这个容器自己要不要用。外层 Provider 关闭时，写 true 也不生效。
UseScrollbarsResult	{ active: Readonly<Ref<boolean>> }	active 表示当前元素上是否已经挂上自绘滚动条。
ScrollbarsProviderProps	类型	上面属性表对应的类型。
ScrollbarsProviderSlots	类型	上面插槽表对应的类型。
ScrollbarsOptions	PartialOptions	OverlayScrollbars 的选项类型，options 属性用它。
ScrollbarsAutoHide	'never' | 'scroll' | 'leave' | 'move'	autoHide 的取值类型。
ScrollbarsContext	类型	Provider 向子树提供的内容：enabled、合并后的 options，以及 mount。
ScrollbarsHandle	{ update, destroy }	mount 返回的句柄，用来更新选项或销毁滚动条。
scrollbarsKey	InjectionKey<ScrollbarsContext>	Provider 用的注入 key。

外观变量

变量	默认值	说明
--astryx-scrollbar-size	10px	滚动条粗细。
--astryx-scrollbar-thumb	次要文字色 45%	滑块颜色。
--astryx-scrollbar-thumb-hover	次要文字色 70%	悬停和拖动时的滑块颜色。
--astryx-scrollbar-track	transparent	轨道背景。
--astryx-scrollbar-radius	9999px	轨道和滑块圆角。

原生属性

组件本身不渲染元素，class 和 style 不会传下去。