ScrollingFrame 由可自訂的 畫布 和 滾動條 組成,具有內建的滾動互動性以及不同的自訂滾動方式。ScrollingFrame 非常適合在有限的空間中顯示大量資訊,並且與 列表 和 網格 佈局搭配良好。

畫布
畫布 是 ScrollingFrame 的主要區域,可以包含其他 GuiObjects。滾動行為會在以下情況下自動調整:
| 框架設置 | 結果 |
|---|---|
| 框架的 CanvasSize 高於其整體高度;具體來說,總 CanvasSize.Y 超過總 Size.Y。 | 啟用垂直滾動,並顯示垂直滾動條。 |
| 框架的 CanvasSize 寬於其整體寬度;具體來說,總 CanvasSize.X 超過總 Size.X。 | 啟用水平滾動,並顯示水平滾動條。 |
| 框架的 AutomaticCanvasSize 設置為 Y 或 XY,且其內容(子 GuiObjects)的總高度超過其總 Size.Y。 | 啟用垂直滾動,並顯示垂直滾動條。 |
| 框架的 AutomaticCanvasSize 設置為 X 或 XY,且其內容(子 GuiObjects)的總寬度超過其總 Size.X。 | 啟用水平滾動,並顯示水平滾動條。 |
CanvasPosition 屬性反映畫布在框架內的 當前 位置偏移量(以像素為單位),並相應地設置滾動條的位置。請注意,如果滾動條不可見,則此屬性不會起作用。
內邊距
滾動框架的 CanvasSize 可能會受到 VerticalScrollBarInset 和/或 HorizontalScrollBarInset 屬性的影響。在以下示例圖中,垂直滾動框架使用 100% 的畫布寬度。當 VerticalScrollBarInset 設置為 None(默認值)時,畫布延伸到滾動框架的全寬,遮擋了滾動條下方的一小部分內容。相反,將 VerticalScrollBarInset 設置為 Always 或 ScrollBar 時,畫布會根據 ScrollBarThickness 的數量進行內縮,使畫布與滾動條邊緣對齊。

滾動條
框架的 滾動條 反映當前畫布位置,並提供自動拖動滾動的互動性。對於垂直滾動條,VerticalScrollBarPosition 屬性可以將滾動條的位置切換到畫布的左側或右側,但水平滾動條只能放置在畫布下方。
滾動條的構造由三個資產屬性組成:
- TopImage — 顯示在垂直滾動條的頂部,或顯示在水平滾動條的左側(對於水平滾動條,逆時針旋轉 90°)。
- BottomImage — 顯示在垂直滾動條的底部,或顯示在水平滾動條的右側(對於水平滾動條,逆時針旋轉 90°)。

每個圖像根據 ScrollBarThickness 屬性進行縮放,該屬性改變垂直滾動條的寬度或水平滾動條的高度。
可以通過 ScrollBarImageColor3 和 ScrollBarImageTransparency 屬性進行額外的視覺修改,這些屬性分別用於調整滾動條圖像資產的顏色和不透明度。
剪裁
By default, GuiObject containers clip their content (descendant GuiObjects) through the ClipsDescendants boolean. If you want descendants to appear outside of a container's bounds, simply set ClipsDescendants to false.


Importantly, StarterGui.ClipsDescendantsSupportsRotation must be true for clipping to work on rotated descendants (non‑zero Rotation) within the container. However, clipping by a rotated container (clipping container itself is rotated) or by rounded corners (UICorner) is not supported. If you need clipping on rotated or rounded containers, consider CanvasGroup.

Rotation = 0

Rotation = 10
彈性
默認情況下,ScrollingFrames 在觸控設備上表現出彈性滾動行為,這意味著用戶可以將畫布拖動到其邊界之外,並在釋放時,畫布會彈回到其最小或最大限制。如果您希望完全移除彈性行為並確保畫布永遠不會超出其限制,請將 ElasticBehavior 屬性設置為 Never。