nextcloud / nextcloud/richdocuments
[Bug]: Scroll behavior in documents is nigh-unusable on MacOS
Nobody has claimed this yet.
- Dominant language
- JavaScript
- Stars
- 453
- Forks
- 147
- Avg merge
- 14h 54m
- Merged PRs (30d)
- 83
Description
⚠️ This issue respects the following points: ⚠️
- This is a bug, not a question or a configuration/webserver/proxy issue.
- This issue is not already reported on Github OR Nextcloud Community Forum (I've searched it).
- Nextcloud Server is up to date. See Maintenance and Release Schedule for supported versions.
- I agree to follow Nextcloud's Code of Conduct.
Bug description
Scrolling behavior in documents behaves non-native, causing unexpected massive amounts of scrolling when expecting short/small scroll distances.
Steps to reproduce
On MacOS, using a Magic Mouse (possibly other input devices as well), perform the following steps.
- Go to lipsum.com and generate 100 paragraphs of Lorem Ipsum content. Copy.
- Log in to NextCloud. Go to Files > New > New Document.
- Paste the Lorem Ipsum content.
- Try to scroll using a minimal single-finger swipe on the mouse.
- Observe that the minimal swipe triggers a scroll to the next page.
- Observe that where normal scrolling on MacOS is continuous (ie: the same distance moved with your finger == same distance scrolled in your window), in NextCloud every millimeter you swipe is a new delightful surprise in how much the document progresses, making it hard to guesstimate how far you need to swipe.
Expected behavior
- Expect small scroll distances, similar to literally every other application on MacOS.
- Expect scroll distance to be uniformly distributed, so a long swipe in the magic mouse doesn't become an adventure but a predictable stroll through the document.
Nextcloud Server version
33
Operating system
None
PHP engine version
None
Web server
None
Database engine version
None
Is this bug present after an update or on a fresh install?
Upgraded to a MAJOR version (ex. 31 to 32)
Are you using the Nextcloud Server Encryption module?
None
What user-backends are you using?
- Default user-backend (database)
- LDAP/ Active Directory
- SSO - SAML
- Other
Configuration report
List of activated Apps
Nextcloud Signing status
Nextcloud Logs
Additional info
NB: The heavy emphasis on backend components in this bug template gives me the impression I'm reporting it in the wrong sub-project, but I haven't been able to find a better place. I have no idea what PHP version or database engine my admins are using, nor do I see the relevance for scroll behavior in the frontend.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start by reproducing the issue in Nextcloud's New Document flow on macOS with a Magic Mouse and a long document. Locate the document editor's scroll handling entry point, then verify that small and long gestures produce proportional continuous movement without unexpectedly advancing a whole page.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- javascript, macos
- Domain
- frontend
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Quiet
- Clarity
- Needs clarification
- Newbie friendliness
- 35/100