nextcloud / nextcloud/richdocuments

[Bug]: Scroll behavior in documents is nigh-unusable on MacOS

Open
#5,524 1 comment 1 reaction 0 assignees View on GitHub

Nobody has claimed this yet.

0. Needs triage bug
Dominant language
JavaScript
Stars
453
Forks
147
Avg merge
14h 54m
Merged PRs (30d)
83

Description

⚠️ This issue respects the following points: ⚠️
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.

  1. Go to lipsum.com and generate 100 paragraphs of Lorem Ipsum content. Copy.
  2. Log in to NextCloud. Go to Files > New > New Document.
  3. Paste the Lorem Ipsum content.
  4. Try to scroll using a minimal single-finger swipe on the mouse.
  5. Observe that the minimal swipe triggers a scroll to the next page.
  6. 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
  1. Expect small scroll distances, similar to literally every other application on MacOS.
  2. 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

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. 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

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.