godotengine / godotengine/godot-docs

documentation for Range property "page" is incomplete

Open
#12,007 1 comment 0 reactions 0 assignees View on GitHub
area:class reference bug
Dominant language
reStructuredText
Stars
5.7k
Forks
3.8k
Avg merge
1d 20h
Merged PRs (30d)
25

Description

**Your Godot version:**
Godot 4

**Issue description:**
The documentation for Range's "page" property states simply:
`Page size. Used mainly for ScrollBar. A ScrollBar's grabber length is the ScrollBar's size multiplied by page over the difference between min_value and max_value.`

From my own testing I think this is misleading and incomplete. It seems page size actually alters the effective maximum value of the Range. i.e. a Range with a max_value of 100 and a page of 10 will actually be clamped to 90. That's not mentioned anywhere, not under page nor under max_value. This also makes the statement about the ScrollBar's grabber length technically inaccurate since it's actually the ratio between page and the effective range that matters (i.e. max - min - page and not simply max - min).

**URL to the documentation page (if already existing):**
https://docs.godotengine.org/en/stable/classes/class_range.html#class-range-property-page

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.