Page MenuHomePhabricator

Persistent state for ReferencePreviews implementation
Open, Needs TriagePublic

Description

Context

Only on desktop, the treatment group will receive this new user flow.

Designs:

2026-03 Version for implementation.png (1×3 px, 351 KB)

From left to right:

  • Non-persistent popup while hovering the footnote marker. This is the same behavior as previously, with no changes made to the pop-up.
  • Persistent state after clicking the footnote marker.

See Figma for details.

User stories

As a reader reading a Wikipedia article, when I hover over a footnote marker in an article in read mode, I want to be able to optionally persist the popup so that I can make my own decision to visit the reference list or be satisfied with the information presented to me in the popup.

GIVEN I am reading an article (logged-in/out) on desktop
WHEN I click on a footnote marker (e.g.[1])
THEN I am presented with the Reference Preview

GIVEN I opened the persistent state of the Reference Preview in an article on desktop, by clicking on a footnote marker
WHEN I click on the link in the pop-up
THEN I am taken to the position of the reference in the reference list (same as old onClick behavior)

GIVEN I opened a Reference Preview in an article on desktop
WHEN I click on the X or outside of the pop-up
THEN the pop-up is cleared from view

Notes
  • Persistent state is dismissed with X or by clicking anywhere outside of the popup.
  • Content should ideally not shift position when moving from non-persistent to persistent state. (not a must, since with pop-ups that open above the footnote marker this might be awkward to achieve).
  • Clicking and double clicking to select text should be possible in both the persistent and the non-persistent state.
  • Scrolling through the content should be possible in non-persistent state as well.
  • The "Click for more options" tooltip only appears on the footnote marker not the popup and clicking the pop-up will not change its state.
  • A click on "Zum Einzelnachweis springen" lets the popup stay open in its persistent state even if it will not be visible any more in almost all cases. But the user can scroll up and find the open popup again.
  • Hovering does not make the popup persistent.
  • When I click a footnote marker two or more times rapidly the popup goes into the persistent state with all the controls. Clicking again doesn't do anything in addition to that.
Other
  • Isn't it confusing when additional clicks on the footnote marker don't do anything any more?

→ Idea: For the experiment we intentionally don't want this click to do anything. We could add a little CSS animation that animates the "Zum Einzelnachweis springen" briefly to get the user's attention.
→ Maybe later, no animation at the moment.

Implementation
  1. Implement a testkitchen stub with treatment group that manually triggers the new workflow.
  2. Add the X button in the corner and make it close the popup.
  3. Clicking anywhere outside of the popup closes it.
  4. Add the "jump down" link to the popup.
  5. Add instrumentation to the new link → T417581
  6. Add the Test Kitchen code that triggers this new workflow for the treatment group. (Keep the URL parameter for testing.)

Update
Out of scope - see comment below and new task T425776

Event Timeline

Lina_Farid_WMDE renamed this task from UX designs for treatment group - onClick opens Reference Preview to UX designs for treatment group: onClick opens Reference Preview.Feb 16 2026, 11:33 AM
thiemowmde renamed this task from UX designs for treatment group: onClick opens Reference Preview to UX designs for treatment group: Optional persistent state for Reference Preview.Feb 18 2026, 2:31 PM
thiemowmde updated the task description. (Show Details)
thiemowmde added subscribers: lilients_WMDE, thiemowmde.
Tobi_WMDE_SW renamed this task from UX designs for treatment group: Optional persistent state for Reference Preview to UX designs for treatment group: Persistent state for Reference Preview.Fri, Apr 24, 8:19 AM
WMDE-Fisch renamed this task from UX designs for treatment group: Persistent state for Reference Preview to Persistent state for ReferencePreviews implementation.Mon, Apr 27, 7:16 AM
WMDE-Fisch updated the task description. (Show Details)

Change #1279233 had a related patch set uploaded (by Mareike Heuer; author: Mareike Heuer):

[mediawiki/extensions/Cite@master] Persistent reference preview state for Treatment Group

https://gerrit.wikimedia.org/r/1279233

See Figma for details.

We see in the screenshots that the link to jump down has a smaller font size than the content.

In Figma this is
16px for the title and content of the popup
14px for the link

In the extension it's currently 14px everywhere.

So the question is, if we still want to make the link text smaller.

Test wiki created on Patch demo by Christoph Jauera (WMDE) using patch(es) linked to this task:
https://facfae1dd1.catalyst.wmcloud.org/w/

Test wiki on Patch demo by Christoph Jauera (WMDE) using patch(es) linked to this task was deleted:

https://facfae1dd1.catalyst.wmcloud.org/w/

Implementing the persistent state requires changes to the Popups extension which adds complexity as and cross-team coordination. Since it would also be a new feature, we decided it's out of scope for the current A/B test. This will allow us to focus on the core user need, which is to jump to the reflist via the "Jump to reference list" link inside the Reference Preview popup. The persistent state may be revisited at another time.
The new task is https://phabricator.wikimedia.org/T425776