Sebuah ScrollingFrame terdiri dari kanvas yang dapat disesuaikan dan bilah gulir dengan interaktivitas menggulung bawaan dan berbagai cara untuk menyesuaikan cara menggulung berfungsi. ScrollingFrame sangat ideal untuk menampilkan banyak informasi dalam ruang 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 menggulung otomatis beradaptasi dalam skenario berikut:
| Pengaturan Bingkai | Hasil |
|---|---|
| Ukuran CanvasSize bingkai lebih tinggi dari tinggi keseluruhannya; khususnya total CanvasSize.Y melebihi total Size.Y. | Menggulung vertikal diaktifkan dan bilah gulir vertikal muncul. |
| Ukuran CanvasSize bingkai lebih lebar dari lebar keseluruhannya; khususnya total CanvasSize.X melebihi total Size.X. | Menggulung 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. | Menggulung 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. | Menggulung horizontal diaktifkan dan bilah gulir horizontal muncul. |
Properti CanvasPosition mencerminkan offset posisi kanvas saat ini di dalam bingkai, dalam piksel, dan mengatur posisi bilah gulir sesuai. Perlu dicatat bahwa properti ini tidak melakukan apa pun jika bilah gulir tidak terlihat.
Inset
Ukuran CanvasSize bingkai menggulung mungkin dipengaruhi oleh properti VerticalScrollBarInset dan/atau HorizontalScrollBarInset. Dalam diagram contoh berikut, bingkai yang menggulung secara vertikal menggunakan lebar kanvas 100%. Dengan VerticalScrollBarInset yang diatur ke None (default), kanvas meluas ke seluruh lebar bingkai menggulung, menutupi sedikit konten di bawah bilah gulir. Sebaliknya, pengaturan VerticalScrollBarInset baik Always atau ScrollBar menempatkan kanvas sebesar jumlah ScrollBarThickness sehingga kanvas bertemu dengan tepi‑ke‑tepi dengan bilah gulir.
Bilah Gulir
Bilah gulir bingkai mencerminkan posisi kanvas saat ini dan memberikan interaktivitas drag‑to‑scroll otomatis. Untuk bilah gulir vertikal, properti VerticalScrollBarPosition mengalihkan 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 — Menghiasi 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 disesuaikan 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.
Elastisitas
Secara default, ScrollingFrames menunjukkan perilaku menggulung elastis pada perangkat yang mendukung sentuhan, yang berarti pengguna dapat menarik kanvas sedikit lebih jauh dari batasnya dan, setelah dilepaskan, kanvas akan melenting kembali ke batas minimum atau maksimumnya. Jika Anda ingin menghilangkan perilaku elastis sepenuhnya dan memastikan kanvas tidak pernah menggulung melewati batasnya, atur properti ElasticBehavior ke Never.