Sebuah ScrollingFrame terdiri dari kanvas yang dapat disesuaikan dan bilah gulir dengan interaktivitas gulir bawaan dan berbagai cara untuk menyesuaikan cara gulir bekerja. ScrollingFrame ideal untuk menampilkan banyak informasi dalam ruang yang terbatas dan bekerja dengan baik dengan daftar dan grid tata letak.
Kanvas
Kanvas adalah area utama dari ScrollingFrame yang dapat berisi objek GuiObjects lainnya. Perilaku gulir secara otomatis beradaptasi dalam skenario berikut:
| Pengaturan Bingkai | Hasil |
|---|---|
| Ukuran CanvasSize bingkai lebih tinggi dari tinggi keseluruhannya; khususnya total CanvasSize.Y melebihi total Size.Y. | Gulir vertikal diaktifkan dan bilah gulir vertikal muncul. |
| Ukuran CanvasSize bingkai lebih lebar dari lebar keseluruhannya; khususnya total CanvasSize.X melebihi total Size.X. | Gulir horizontal diaktifkan dan bilah gulir horizontal muncul. |
| Ukuran AutomaticCanvasSize bingkai diatur ke Y atau XY dan total tinggi kontennya (anak GuiObjects) melebihi total Size.Y. | Gulir vertikal diaktifkan dan bilah gulir vertikal muncul. |
| Ukuran AutomaticCanvasSize bingkai diatur ke X atau XY dan total lebar kontennya (anak GuiObjects) melebihi total Size.X. | Gulir horizontal diaktifkan dan bilah gulir horizontal muncul. |
Properti CanvasPosition mencerminkan offset posisi saat ini dari kanvas dalam bingkai, dalam piksel, dan mengatur posisi bilah gulir sesuai. Perhatikan bahwa properti ini tidak berfungsi jika bilah gulir tidak terlihat.
Inset
Ukuran CanvasSize bingkai gulir dapat dipengaruhi oleh properti VerticalScrollBarInset dan/atau HorizontalScrollBarInset. Dalam diagram contoh berikut, bingkai yang menggulir secara vertikal menggunakan lebar kanvas 100%. Dengan VerticalScrollBarInset diatur ke None (default), kanvas memperluas ke lebar penuh bingkai gulir, menutupi sedikit konten di bawah bilah gulir. Sebaliknya, pengaturan VerticalScrollBarInset baik Always atau ScrollBar menginset kanvas sebesar ScrollBarThickness sehingga kanvas bertemu tepi-ke-tepi dengan bilah gulir.
Bilah Gulir
Bilah gulir bingkai mencerminkan posisi kanvas saat ini dan menyediakan interaktivitas seret-untuk-gulir secara otomatis. Untuk bilah gulir vertikal, properti VerticalScrollBarPosition mengubah posisi bilah ke kiri atau kanan kanvas, tetapi bilah gulir horizontal hanya dapat diposisikan di bawah kanvas.
Konstruksi bilah gulir terdiri dari tiga properti aset:
- TopImage — Menampilkan di bagian atas bilah gulir vertikal, atau di sebelah kiri bilah gulir horizontal (diputar 90° berlawanan arah jarum jam untuk bilah gulir horizontal).
- MidImage — Meliputi area antara TopImage dan BottomImage (diputar 90° berlawanan arah jarum jam untuk bilah gulir horizontal).
- BottomImage — Menampilkan di bagian bawah bilah gulir vertikal, atau di sebelah kanan bilah gulir horizontal (diputar 90° berlawanan arah jarum jam untuk bilah gulir horizontal).
Setiap gambar diskalakan berdasarkan properti ScrollBarThickness yang mengubah lebar bilah gulir vertikal atau tinggi bilah gulir horizontal.
Modifikasi visual tambahan dapat dilakukan melalui properti ScrollBarImageColor3 dan ScrollBarImageTransparency yang mewarnai aset gambar bilah dan mengubah opasitasnya, masing-masing.
Pemotongan
Secara default, kontainer GuiObject memotong kontennya (keturunan GuiObjects) melalui boolean ClipsDescendants. Jika Anda ingin keturunan muncul di luar batas kontainer, cukup atur ClipsDescendants ke false.
Penting untuk dicatat, StarterGui.ClipsDescendantsSupportsRotation harus true agar pemotongan bekerja pada keturunan yang diputar (non-zero Rotation) dalam kontainer. Namun, pemotongan oleh kontainer yang diputar (kontainer pemotongan itu sendiri diputar) atau oleh sudut yang membulat (UICorner) tidak didukung. Jika Anda memerlukan pemotongan pada kontainer yang diputar atau dibulatkan, pertimbangkan untuk menggunakan CanvasGroup.
Rotation = 0
Rotation = 10
Elastisitas
Secara default, ScrollingFrames menunjukkan perilaku gulir elastis pada perangkat yang mendukung sentuhan, yang berarti pengguna dapat menyeret kanvas sedikit lebih jauh dari batasnya dan, setelah dilepaskan, kanvas akan kembali ke batas minimum atau maksimumnya. Jika Anda ingin menghapus perilaku elastis sepenuhnya dan memastikan kanvas tidak pernah menggulir melewati batasnya, atur properti ElasticBehavior ke Never.