godotengine / godotengine/godot-docs
documentation for Range property "page" is incomplete
- 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.