Page MenuHomePhabricator

Minerva ToC UI tweaks
Closed, ResolvedPublic3 Estimated Story PointsDesign

Description

A few final touches to the ToC UIs before we launch the A/B test

FAB zero state

image.png (720×1,560 px, 336 KB)

Open state

Screenshot 2026-02-05 at 9.45.36 AM.png (1,504×1,262 px, 296 KB)

Min height

Screenshot 2026-02-05 at 9.46.34 AM.png (952×774 px, 125 KB)

Sticky header open

Screenshot 2026-02-05 at 9.48.44 AM.png (986×1,144 px, 311 KB)

Wide

image.png (2,984×1,791 px, 991 KB)

Screenshot 2026-02-05 at 9.49.48 AM.png (1,354×700 px, 212 KB)

Transitions

Note that the 2nd screenshot does not auto-close the TOC when clicking a section, but @JScherer-WMF confirmed that auto-closing the TOC is the intended behavior.

Opening and closing the button is a fade in/out transition that takes 300ms
By clicking the ToC item, appropriate section scrolls into view

  • 25% of the total viewport height shows above/below the menu to maintain the article context.
  • 56px high linear gradient with the 'background-base' background-base colour to show that there are more links above/below
  • use a large neutral-normal button. Do not change the icon when it's open. Instead, use the active button state.
  • Min height of the toc menu is 250px
  • Max width = 640

Figma dev mode link

Related Objects

StatusSubtypeAssignedTask
ResolvedNone
ResolvedDesignlwatson

Event Timeline

JScherer-WMF updated the task description. (Show Details)
JScherer-WMF updated the task description. (Show Details)
JScherer-WMF updated the task description. (Show Details)

Change #1238337 had a related patch set uploaded (by LWatson; author: LWatson):

[mediawiki/extensions/ReaderExperiments@master] Minerva TOC: Revise floating button states

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

matthiasmullie subscribed.

Unclaiming the task for now - I'm currently working on something else, so it's up for grabs!

Note that the 2nd screenshot does not auto-close the TOC when clicking a section, but @JScherer-WMF confirmed that auto-closing the TOC (like we currently have) is the intended behavior.

Change #1238337 merged by jenkins-bot:

[mediawiki/extensions/ReaderExperiments@master] Minerva TOC: Revise button states

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

HSwan-WMF set the point value for this task to 3.Feb 11 2026, 5:56 PM
lwatson changed the task status from Open to In Progress.Feb 11 2026, 11:22 PM
lwatson claimed this task.

@JScherer-WMF regarding the toc items/links interactive states:

  • I'm overriding Minerva link interaction styles by making the "Top" link text color-base when hovered on and active. Do you have other suggestions?
  • All links, including the "Top" link, change to a purple color when visited (color-visited, #6a60b0) in Vector TOC. Is this the same for the new Minerva TOC?

Change #1239348 had a related patch set uploaded (by LWatson; author: LWatson):

[mediawiki/extensions/ReaderExperiments@master] Minerva TOC: minor design revisions

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

Change #1239358 had a related patch set uploaded (by LWatson; author: LWatson):

[mediawiki/extensions/ReaderExperiments@master] Minerva TOC: add scroll indicator gradients

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

Change #1239348 merged by jenkins-bot:

[mediawiki/extensions/ReaderExperiments@master] Minerva TOC: minor design revisions

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

regarding the toc items/links interactive states:

  • "Top" links are regular blue links with: color-progressive, color-progressive--hover, color-progressive--active
  • The active section link is bold and color-base
  • All visited links, or links that were clicked on by the user are color-visited

Change #1239358 merged by jenkins-bot:

[mediawiki/extensions/ReaderExperiments@master] Minerva TOC: add scroll indicator gradients

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

Change #1240090 had a related patch set uploaded (by LWatson; author: LWatson):

[mediawiki/extensions/ReaderExperiments@master] Minerva TOC: add fade in and out transitions

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

Change #1239916 had a related patch set uploaded (by Matthias Mullie; author: Matthias Mullie):

[mediawiki/extensions/ReaderExperiments@master] Consolidate scroll indicator work into standalone component

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

Change #1239916 merged by jenkins-bot:

[mediawiki/extensions/ReaderExperiments@master] Consolidate scroll indicator work into standalone component

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

Change #1240090 merged by jenkins-bot:

[mediawiki/extensions/ReaderExperiments@master] Minerva TOC: add fade in and out transitions

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

Etonkovidova subscribed.

Checked with

  • ?mpo=mobile-toc-abc:treatment1 (sticky header)
  • ?mpo=mobile-toc-abc:treatment2 (floating button) 

@JScherer-WMF - please review the Notes. The issues seem minor to me, but if some following-up actions are needed, let me know.

(1) FAB zero state

FAB zero stateenwiki ?mpo=mobile-toc-abc:treatment2
image.png (720×1,560 px, 336 KB)
Screenshot 2026-02-24 at 10.22.14 AM.png (341×720 px, 112 KB)
Note: - extra space is displayed on the left side of the title
Screenshot 2026-02-24 at 10.22.33 AM.png (327×711 px, 111 KB)
Screenshot 2026-02-24 at 10.22.14 AM.png (341×720 px, 113 KB)

(2) Open state

designenwiki ?mpo=mobile-toc-abc:treatment2
Screenshot 2026-02-05 at 9.45.36 AM.png (1,504×1,262 px, 296 KB)
Screenshot 2026-02-24 at 10.32.26 AM.png (351×740 px, 65 KB)
Note: TOC in the design covers the top of the article text and the tool bar entirely. On enwiki the tool bar is visible (and can be interacted with).

(3) Min height

designenwiki ?mpo=mobile-toc-abc:treatment2
Screenshot 2026-02-05 at 9.46.34 AM.png (952×774 px, 125 KB)
Screenshot 2026-02-24 at 10.47.11 AM.png (315×688 px, 45 KB)

(4) Wide

Wide - designenwiki ?mpo=mobile-toc-abc:treatment2
image.png (2,984×1,791 px, 991 KB)
Screenshot 2026-02-05 at 9.49.48 AM.png (1,354×700 px, 212 KB)
Screenshot 2026-02-24 at 10.55.22 AM.png (1,101×894 px, 353 KB)
Screenshot 2026-02-24 at 10.55.35 AM.png (1,001×899 px, 259 KB)

(5) Transitions

  • click on the gifs
clicking on Contents buttonclicking on the TOC headers
hedy_lamarr_floating TOC.gif (406×727 px, 134 KB)
close hedy_lamarr_floating TOC .gif (406×727 px, 186 KB)
Note: there is no scrolling effect when clicking on the header in the TOC

Change #1244719 had a related patch set uploaded (by Matthias Mullie; author: Matthias Mullie):

[mediawiki/extensions/MobileFrontend@master] Limit additional whitespace to sticky header version only

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

@Etonkovidova looks like you have identified a bug – I merged https://gerrit.wikimedia.org/r/c/mediawiki/extensions/MobileFrontend/+/1241037 on Monday with the understanding that the style was scoped to treatment 1, but it looks like the styles are also applying to treatment 2 (I wonder if control is impacted too).

@lwatson do you have time to look into this? If not I can try to get to it tomorrow. This will hopefully be a quick CSS-only fix that we can backport.

Change #1244719 merged by jenkins-bot:

[mediawiki/extensions/MobileFrontend@master] Limit additional whitespace to sticky header version only

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

Change #1245265 had a related patch set uploaded (by Matthias Mullie; author: Matthias Mullie):

[mediawiki/extensions/MobileFrontend@wmf/1.46.0-wmf.17] Limit additional whitespace to sticky header version only

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

Regarding @Etonkovidova's note from this comment https://phabricator.wikimedia.org/T416598#11646646:

Note: - extra space is displayed on the left side of the title.

Matthias addressed the spacing issue introduced by T417932: [Minerva TOC] design feedback. The reserved space (margin-left applied to the heading and tagline) is intended strictly for the sticky implementation (treatment 1). Previously, this space was being incorrectly applied to the floating button implementation (treatment 2). You can view the fix on beta here: https://en.wikipedia.beta.wmcloud.org/wiki/Moon?mpo=mobile-toc-abc:treatment2

Change #1245265 merged by jenkins-bot:

[mediawiki/extensions/MobileFrontend@wmf/1.46.0-wmf.17] Limit additional whitespace to sticky header version only

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

Mentioned in SAL (#wikimedia-operations) [2026-03-02T09:15:06Z] <mlitn@deploy2002> Started scap sync-world: Backport for [[gerrit:1245265|Limit additional whitespace to sticky header version only (T416598)]]

Mentioned in SAL (#wikimedia-operations) [2026-03-02T09:16:49Z] <mlitn@deploy2002> mlitn: Backport for [[gerrit:1245265|Limit additional whitespace to sticky header version only (T416598)]] synced to the testservers (see https://wikitech.wikimedia.org/wiki/Mwdebug). Changes can now be verified there.

Mentioned in SAL (#wikimedia-operations) [2026-03-02T09:26:08Z] <mlitn@deploy2002> Finished scap sync-world: Backport for [[gerrit:1245265|Limit additional whitespace to sticky header version only (T416598)]] (duration: 11m 02s)

Fix also backported to production earlier today.

Confirming that the whitespace was fixed on production. Example: https://en.wikipedia.org/wiki/Moon?mpo=mobile-toc-abc:treatment2

Screenshot 2026-03-02 at 5.23.01 PM.png (367×711 px, 90 KB)