Get View Fraction
ScrollBoxЧто это
Pure-функция, возвращает долю видимой области прокрутки (ScrollBox) относительно общего размера контента. Значение от 0.0 до 1.0, где 1.0 означает, что весь контент помещается в видимую область (прокрутка не требуется). Полезна для определения положения ползунка скроллбара или для кастомной индикации прогресса прокрутки.
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- Target (ScrollBox Object Reference) — ссылка на ScrollBox, для которого запрашивается доля видимой области
Выходы (данные):
- Return Value (Float) — доля видимой области (0.0–1.0)
Когда используется
- Для синхронизации кастомного ползунка скроллбара с позицией прокрутки.
- Для реализации «бесконечной» подгрузки контента при приближении к концу списка (в комбинации с
GetScrollOffsetиGetScrollEnd). - Для анимации элементов интерфейса в зависимости от степени прокрутки.
Типичные проблемы
- Неправильная интерпретация значения:
GetViewFractionвозвращает долю видимой области, а не абсолютную позицию. Для получения позиции используйтеGetScrollOffset. - Игнорирование pure-природы: Функция не имеет exec-пинов, поэтому её можно вызывать в любом месте графа, не заботясь о порядке выполнения. Однако это же означает, что результат не обновится, если не вызвать функцию заново после изменения прокрутки.
- Путаница с
GetScrollEnd:GetViewFractionпоказывает, сколько контента видно, аGetScrollEnd— максимальное смещение прокрутки. Не заменяйте одно другим.