滾動框架

*此內容是使用 AI(Beta 測試版)翻譯,可能含有錯誤。若要以英文檢視此頁面,請按一下這裡

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

螢幕上顯示的範例滾動框架,包含一個分頁類別欄和一個供玩家考慮購買的魔法物品列表。

畫布

畫布ScrollingFrame 的主要區域,可以包含其他 GuiObjects。滾動行為會在以下情況下自動調整:

框架設置結果
框架的 CanvasSize 高於其整體高度;具體來說,總 CanvasSize.Y 超過總 Size.Y啟用垂直滾動,並顯示垂直滾動條。
框架的 CanvasSize 寬於其整體寬度;具體來說,總 CanvasSize.X 超過總 Size.X啟用水平滾動,並顯示水平滾動條。
框架的 AutomaticCanvasSize 設置為 YXY,且其內容(子 GuiObjects)的總高度超過其總 Size.Y啟用垂直滾動,並顯示垂直滾動條。
框架的 AutomaticCanvasSize 設置為 XXY,且其內容(子 GuiObjects)的總寬度超過其總 Size.X啟用水平滾動,並顯示水平滾動條。

CanvasPosition 屬性反映畫布在框架內的 當前 位置偏移量(以像素為單位),並相應地設置滾動條的位置。請注意,如果滾動條不可見,則此屬性不會起作用。

內邊距

滾動框架的 CanvasSize 可能會受到 VerticalScrollBarInset 和/或 HorizontalScrollBarInset 屬性的影響。在以下示例圖中,垂直滾動框架使用 100% 的畫布寬度。當 VerticalScrollBarInset 設置為 None(默認值)時,畫布延伸到滾動框架的全寬,遮擋了滾動條下方的一小部分內容。相反,將 VerticalScrollBarInset 設置為 AlwaysScrollBar 時,畫布會根據 ScrollBarThickness 的數量進行內縮,使畫布與滾動條邊緣對齊。

滾動條

框架的 滾動條 反映當前畫布位置,並提供自動拖動滾動的互動性。對於垂直滾動條,VerticalScrollBarPosition 屬性可以將滾動條的位置切換到畫布的左側或右側,但水平滾動條只能放置在畫布下方。

滾動條的構造由三個資產屬性組成:

  • TopImage — 顯示在垂直滾動條的頂部,或顯示在水平滾動條的左側(對於水平滾動條,逆時針旋轉 90°)。
  • MidImage — 橫跨 TopImageBottomImage 之間的區域(對於水平滾動條,逆時針旋轉 90°)。
  • BottomImage — 顯示在垂直滾動條的底部,或顯示在水平滾動條的右側(對於水平滾動條,逆時針旋轉 90°)。
顯示構成滾動框架滾動條的三個圖像資產元素的示意圖。

每個圖像根據 ScrollBarThickness 屬性進行縮放,該屬性改變垂直滾動條的寬度或水平滾動條的高度。

可以通過 ScrollBarImageColor3ScrollBarImageTransparency 屬性進行額外的視覺修改,這些屬性分別用於調整滾動條圖像資產的顏色和不透明度。

剪裁

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.

彈性

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

©2026 Roblox Corporation、Roblox、Roblox 標誌及 Powering Imagination 是我們在美國及其他國家地區的部分註冊與未註冊商標。