⚓ T416598 Minerva ToC UI tweaks
Page Menu
Phabricator
Create Task
Maniphest
T416598
Minerva ToC UI tweaks
Closed, Resolved
Public
3 Estimated Story Points
Design
Actions
Edit Task
Edit Related Tasks...
Create Subtask
Edit Parent Tasks
Edit Subtasks
Merge Duplicates In
Close As Duplicate
Edit Related Objects...
Edit Commits
Edit Mocks
Mute Notifications
Protect as security issue
Assigned To
lwatson
Authored By
JScherer-WMF
Feb 5 2026, 2:44 PM
2026-02-05 14:44:03 (UTC+0)
Tags
ReaderExperiments-MinervaTOC
Reader Growth Team (Sprint 3 (Feb 17 - Mar 2) Q3 25/26)
(Signoff)
MW-1.46-notes (1.46.0-wmf.17; 2026-02-24)
Referenced Files
F72477085: Screenshot 2026-03-02 at 5.23.01 PM.png
Mar 2 2026, 10:24 PM
2026-03-02 22:24:22 (UTC+0)
F72316928: close hedy_lamarr_floating TOC .gif
Feb 24 2026, 4:07 PM
2026-02-24 16:07:19 (UTC+0)
F72316926: hedy_lamarr_floating TOC.gif
Feb 24 2026, 4:07 PM
2026-02-24 16:07:19 (UTC+0)
F72316911: Screenshot 2026-02-24 at 10.55.35 AM.png
Feb 24 2026, 4:07 PM
2026-02-24 16:07:19 (UTC+0)
F72316909: Screenshot 2026-02-24 at 10.55.22 AM.png
Feb 24 2026, 4:07 PM
2026-02-24 16:07:19 (UTC+0)
F72316895: Screenshot 2026-02-24 at 10.47.11 AM.png
Feb 24 2026, 4:07 PM
2026-02-24 16:07:19 (UTC+0)
F72316877: Screenshot 2026-02-24 at 10.32.26 AM.png
Feb 24 2026, 4:07 PM
2026-02-24 16:07:19 (UTC+0)
F72316865: Screenshot 2026-02-24 at 10.22.14 AM.png
Feb 24 2026, 4:07 PM
2026-02-24 16:07:19 (UTC+0)
View All 18 Files
Subscribers
Aklapper
egardner
Etonkovidova
JScherer-WMF
matthiasmullie
SherryYang-WMF
Description
A few final touches to the ToC UIs before we launch the A/B test
FAB zero state
Open state
Min height
Sticky header open
Wide
Transitions
Screen Recording 2026-02-05 at 9.23.37 AMlow.mov
3 MB
Screen Recording 2026-02-05 at 9.20.19 AM.mov
2 MB
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
Details
Related Changes in Gerrit:
Subject
Repo
Branch
Lines +/-
Limit additional whitespace to sticky header version only
mediawiki/extensions/MobileFrontend
wmf/1.46.0-wmf.17
+2
-2
Limit additional whitespace to sticky header version only
mediawiki/extensions/MobileFrontend
master
+2
-2
Minerva TOC: add fade in and out transitions
mediawiki/extensions/ReaderExperiments
master
+32
-35
Consolidate scroll indicator work into standalone component
mediawiki/extensions/ReaderExperiments
master
+147
-163
Minerva TOC: add scroll indicator gradients
mediawiki/extensions/ReaderExperiments
master
+148
-15
Minerva TOC: minor design revisions
mediawiki/extensions/ReaderExperiments
master
+45
-15
Minerva TOC: Revise button states
mediawiki/extensions/ReaderExperiments
master
+29
-37
Customize query in gerrit
Related Objects
Search...
Task Graph
Mentions
Status
Subtype
Assigned
Task
Open
None
T415948
[EPIC] Minerva TOC
Resolved
Design
lwatson
T416598
Minerva ToC UI tweaks
Mentioned In
T416744: [Minerva TOC] keyboard navigation
Mentioned Here
T417932: [Minerva TOC] design feedback
Event Timeline
JScherer-WMF
created this task.
Feb 5 2026, 2:44 PM
2026-02-05 14:44:03 (UTC+0)
Restricted Application
added a subscriber:
Aklapper
View Herald Transcript
Feb 5 2026, 2:44 PM
2026-02-05 14:44:04 (UTC+0)
JScherer-WMF
updated the task description.
(Show Details)
Feb 5 2026, 2:54 PM
2026-02-05 14:54:13 (UTC+0)
JScherer-WMF
updated the task description.
(Show Details)
Feb 5 2026, 2:57 PM
2026-02-05 14:57:46 (UTC+0)
JScherer-WMF
updated the task description.
(Show Details)
JScherer-WMF
updated the task description.
(Show Details)
JScherer-WMF
updated the task description.
(Show Details)
SherryYang-WMF
triaged this task as
High
priority.
Feb 5 2026, 11:41 PM
2026-02-05 23:41:31 (UTC+0)
SherryYang-WMF
edited projects, added
Reader Growth Team
; removed
Reader Growth Team (Sprint 2 (Feb 3 - 16) Q3 25/26)
SherryYang-WMF
moved this task from
Incoming/Inbox
to
Needs Refinement
on the
Reader Growth Team
board.
SherryYang-WMF
subscribed.
Izno
added a project:
MinervaNeue
Feb 6 2026, 11:39 PM
2026-02-06 23:39:53 (UTC+0)
Izno
removed a project:
MinervaNeue
Feb 6 2026, 11:43 PM
2026-02-06 23:43:38 (UTC+0)
gerritbot
added a comment.
Feb 10 2026, 1:05 PM
2026-02-10 13:05:24 (UTC+0)
Comment Actions
Change #1238337 had a related patch set uploaded (by LWatson; author: LWatson):
[mediawiki/extensions/ReaderExperiments@master] Minerva TOC: Revise floating button states
gerritbot
added a project:
Patch-For-Review
Feb 10 2026, 1:05 PM
2026-02-10 13:05:25 (UTC+0)
lwatson
mentioned this in
T416744: [Minerva TOC] keyboard navigation
Feb 10 2026, 1:14 PM
2026-02-10 13:14:40 (UTC+0)
matthiasmullie
added a project:
ReaderExperiments-MinervaTOC
Feb 10 2026, 3:48 PM
2026-02-10 15:48:26 (UTC+0)
matthiasmullie
claimed this task.
Feb 10 2026, 4:53 PM
2026-02-10 16:53:16 (UTC+0)
matthiasmullie
removed
matthiasmullie
as the assignee of this task.
Feb 11 2026, 4:21 PM
2026-02-11 16:21:33 (UTC+0)
matthiasmullie
subscribed.
Comment Actions
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.
matthiasmullie
updated the task description.
(Show Details)
Feb 11 2026, 4:22 PM
2026-02-11 16:22:10 (UTC+0)
gerritbot
added a comment.
Feb 11 2026, 5:01 PM
2026-02-11 17:01:16 (UTC+0)
Comment Actions
Change #1238337
merged
by jenkins-bot:
[mediawiki/extensions/ReaderExperiments@master] Minerva TOC: Revise button states
Maintenance_bot
removed a project:
Patch-For-Review
Feb 11 2026, 5:31 PM
2026-02-11 17:31:47 (UTC+0)
HSwan-WMF
set the point value for this task to
Feb 11 2026, 5:56 PM
2026-02-11 17:56:59 (UTC+0)
ReleaseTaggerBot
added a project:
MW-1.46-notes (1.46.0-wmf.16; 2026-02-17)
Feb 11 2026, 6:00 PM
2026-02-11 18:00:26 (UTC+0)
lwatson
changed the task status from
Open
to
In Progress
Feb 11 2026, 11:22 PM
2026-02-11 23:22:57 (UTC+0)
lwatson
claimed this task.
lwatson
edited projects, added
Reader Growth Team (Sprint 2 (Feb 3 - 16) Q3 25/26)
; removed
Reader Growth Team
Feb 11 2026, 11:37 PM
2026-02-11 23:37:11 (UTC+0)
lwatson
added a parent task:
T415948: [EPIC] Minerva TOC
lwatson
moved this task from
Committed
to
Doing
on the
Reader Growth Team (Sprint 2 (Feb 3 - 16) Q3 25/26)
board.
Feb 11 2026, 11:46 PM
2026-02-11 23:46:31 (UTC+0)
lwatson
added a comment.
Feb 13 2026, 1:59 PM
2026-02-13 13:59:11 (UTC+0)
Comment Actions
@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?
gerritbot
added a comment.
Feb 13 2026, 2:09 PM
2026-02-13 14:09:32 (UTC+0)
Comment Actions
Change #1239348 had a related patch set uploaded (by LWatson; author: LWatson):
[mediawiki/extensions/ReaderExperiments@master] Minerva TOC: minor design revisions
gerritbot
added a project:
Patch-For-Review
Feb 13 2026, 2:09 PM
2026-02-13 14:09:33 (UTC+0)
gerritbot
added a comment.
Feb 13 2026, 3:08 PM
2026-02-13 15:08:55 (UTC+0)
Comment Actions
Change #1239358 had a related patch set uploaded (by LWatson; author: LWatson):
[mediawiki/extensions/ReaderExperiments@master] Minerva TOC: add scroll indicator gradients
gerritbot
added a comment.
Feb 17 2026, 4:52 PM
2026-02-17 16:52:10 (UTC+0)
Comment Actions
Change #1239348
merged
by jenkins-bot:
[mediawiki/extensions/ReaderExperiments@master] Minerva TOC: minor design revisions
lwatson
added a comment.
Feb 17 2026, 4:59 PM
2026-02-17 16:59:26 (UTC+0)
Comment Actions
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
ReleaseTaggerBot
edited projects, added
MW-1.46-notes (1.46.0-wmf.17; 2026-02-24)
; removed
MW-1.46-notes (1.46.0-wmf.16; 2026-02-17)
Feb 17 2026, 5:00 PM
2026-02-17 17:00:55 (UTC+0)
SherryYang-WMF
moved this task from
Sprint 2 (Feb 3 - 16) Q3 25/26
to
Sprint 3 (Feb 17 - Mar 2) Q3 25/26
on the
Reader Growth Team
board.
Feb 17 2026, 5:41 PM
2026-02-17 17:41:46 (UTC+0)
SherryYang-WMF
edited projects, added
Reader Growth Team (Sprint 3 (Feb 17 - Mar 2) Q3 25/26)
; removed
Reader Growth Team (Sprint 2 (Feb 3 - 16) Q3 25/26)
egardner
moved this task from
Committed
to
Code Review
on the
Reader Growth Team (Sprint 3 (Feb 17 - Mar 2) Q3 25/26)
board.
Feb 17 2026, 6:33 PM
2026-02-17 18:33:33 (UTC+0)
egardner
moved this task from
Code Review
to
QA
on the
Reader Growth Team (Sprint 3 (Feb 17 - Mar 2) Q3 25/26)
board.
Feb 17 2026, 9:09 PM
2026-02-17 21:09:33 (UTC+0)
gerritbot
added a comment.
Feb 17 2026, 9:27 PM
2026-02-17 21:27:46 (UTC+0)
Comment Actions
Change #1239358
merged
by jenkins-bot:
[mediawiki/extensions/ReaderExperiments@master] Minerva TOC: add scroll indicator gradients
Maintenance_bot
removed a project:
Patch-For-Review
Feb 17 2026, 9:30 PM
2026-02-17 21:30:45 (UTC+0)
gerritbot
added a comment.
Feb 18 2026, 1:15 AM
2026-02-18 01:15:24 (UTC+0)
Comment Actions
Change #1240090 had a related patch set uploaded (by LWatson; author: LWatson):
[mediawiki/extensions/ReaderExperiments@master] Minerva TOC: add fade in and out transitions
gerritbot
added a project:
Patch-For-Review
Feb 18 2026, 1:15 AM
2026-02-18 01:15:26 (UTC+0)
gerritbot
added a comment.
Feb 18 2026, 2:13 PM
2026-02-18 14:13:02 (UTC+0)
Comment Actions
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
lwatson
moved this task from
QA
to
Code Review
on the
Reader Growth Team (Sprint 3 (Feb 17 - Mar 2) Q3 25/26)
board.
Feb 18 2026, 3:51 PM
2026-02-18 15:51:20 (UTC+0)
PatchDemoBot
added a comment.
Feb 18 2026, 6:56 PM
2026-02-18 18:56:31 (UTC+0)
Comment Actions
Test wiki
created
on
Patch demo
by LWatson-WMF using patch(es) linked to this task:
matthiasmullie
moved this task from
Code Review
to
QA
on the
Reader Growth Team (Sprint 3 (Feb 17 - Mar 2) Q3 25/26)
board.
Feb 19 2026, 9:49 AM
2026-02-19 09:49:38 (UTC+0)
gerritbot
added a comment.
Feb 19 2026, 12:48 PM
2026-02-19 12:48:49 (UTC+0)
Comment Actions
Change #1239916
merged
by jenkins-bot:
[mediawiki/extensions/ReaderExperiments@master] Consolidate scroll indicator work into standalone component
gerritbot
added a comment.
Feb 19 2026, 1:02 PM
2026-02-19 13:02:49 (UTC+0)
Comment Actions
Change #1240090
merged
by jenkins-bot:
[mediawiki/extensions/ReaderExperiments@master] Minerva TOC: add fade in and out transitions
Maintenance_bot
removed a project:
Patch-For-Review
Feb 19 2026, 1:31 PM
2026-02-19 13:31:15 (UTC+0)
Etonkovidova
moved this task from
QA
to
Signoff
on the
Reader Growth Team (Sprint 3 (Feb 17 - Mar 2) Q3 25/26)
board.
Feb 24 2026, 4:07 PM
2026-02-24 16:07:19 (UTC+0)
Etonkovidova
subscribed.
Comment Actions
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 state
enwiki
?mpo=mobile-toc-abc:treatment2
Note: - extra space is displayed on the left side of the title
(2)
Open state
design
enwiki
?mpo=mobile-toc-abc:treatment2
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
design
enwiki
?mpo=mobile-toc-abc:treatment2
(4)
Wide
Wide
- design
enwiki
?mpo=mobile-toc-abc:treatment2
(5)
Transitions
click on the gifs
clicking on Contents button
clicking on the TOC headers
Note: there is no scrolling effect when clicking on the header in the TOC
gerritbot
added a comment.
Feb 26 2026, 5:11 PM
2026-02-26 17:11:34 (UTC+0)
Comment Actions
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
gerritbot
added a project:
Patch-For-Review
Feb 26 2026, 5:11 PM
2026-02-26 17:11:36 (UTC+0)
egardner
subscribed.
Feb 26 2026, 5:13 PM
2026-02-26 17:13:45 (UTC+0)
Comment Actions
@Etonkovidova
looks like you have identified a bug – I merged
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.
matthiasmullie
added a comment.
Feb 26 2026, 5:16 PM
2026-02-26 17:16:59 (UTC+0)
Comment Actions
ought to fix those selectors
egardner
added a comment.
Feb 26 2026, 5:32 PM
2026-02-26 17:32:10 (UTC+0)
Comment Actions
In
T416598#11655690
@matthiasmullie
wrote:
ought to fix those selectors
Awesome, I can try to review this shortly.
lwatson
moved this task from
Signoff
to
QA
on the
Reader Growth Team (Sprint 3 (Feb 17 - Mar 2) Q3 25/26)
board.
Feb 27 2026, 12:53 AM
2026-02-27 00:53:34 (UTC+0)
lwatson
moved this task from
QA
to
Code Review
on the
Reader Growth Team (Sprint 3 (Feb 17 - Mar 2) Q3 25/26)
board.
gerritbot
added a comment.
Feb 27 2026, 1:08 AM
2026-02-27 01:08:17 (UTC+0)
Comment Actions
Change #1244719
merged
by jenkins-bot:
[mediawiki/extensions/MobileFrontend@master] Limit additional whitespace to sticky header version only
lwatson
added a comment.
Feb 27 2026, 1:20 AM
2026-02-27 01:20:24 (UTC+0)
Comment Actions
thanks
@matthiasmullie
for the quick fix! +2
Maintenance_bot
removed a project:
Patch-For-Review
Feb 27 2026, 1:30 AM
2026-02-27 01:30:42 (UTC+0)
ReleaseTaggerBot
edited projects, added
MW-1.46-notes (1.46.0-wmf.18; 2026-03-03)
; removed
MW-1.46-notes (1.46.0-wmf.17; 2026-02-24)
Feb 27 2026, 2:00 AM
2026-02-27 02:00:49 (UTC+0)
lwatson
moved this task from
Code Review
to
QA
on the
Reader Growth Team (Sprint 3 (Feb 17 - Mar 2) Q3 25/26)
board.
Feb 27 2026, 3:27 AM
2026-02-27 03:27:15 (UTC+0)
gerritbot
added a comment.
Feb 27 2026, 8:50 AM
2026-02-27 08:50:30 (UTC+0)
Comment Actions
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
gerritbot
added a project:
Patch-For-Review
Feb 27 2026, 8:50 AM
2026-02-27 08:50:31 (UTC+0)
lwatson
added a comment.
Feb 28 2026, 4:03 PM
2026-02-28 16:03:09 (UTC+0)
Comment Actions
Regarding
@Etonkovidova
's note from this comment
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:
gerritbot
added a comment.
Mar 2 2026, 9:13 AM
2026-03-02 09:13:45 (UTC+0)
Comment Actions
Change #1245265
merged
by jenkins-bot:
[mediawiki/extensions/MobileFrontend@wmf/1.46.0-wmf.17] Limit additional whitespace to sticky header version only
Stashbot
added a comment.
Mar 2 2026, 9:15 AM
2026-03-02 09:15:07 (UTC+0)
Comment Actions
Mentioned in SAL (#wikimedia-operations)
[2026-03-02T09:15:06Z]
T416598
)]]
Stashbot
added a comment.
Mar 2 2026, 9:16 AM
2026-03-02 09:16:50 (UTC+0)
Comment Actions
Mentioned in SAL (#wikimedia-operations)
[2026-03-02T09:16:49Z]
T416598
)]] synced to the testservers (see
). Changes can now be verified there.
Stashbot
added a comment.
Mar 2 2026, 9:26 AM
2026-03-02 09:26:09 (UTC+0)
Comment Actions
Mentioned in SAL (#wikimedia-operations)
[2026-03-02T09:26:08Z]
T416598
)]] (duration: 11m 02s)
Maintenance_bot
removed a project:
Patch-For-Review
Mar 2 2026, 9:30 AM
2026-03-02 09:30:44 (UTC+0)
ReleaseTaggerBot
edited projects, added
MW-1.46-notes (1.46.0-wmf.17; 2026-02-24)
; removed
MW-1.46-notes (1.46.0-wmf.18; 2026-03-03)
Mar 2 2026, 2:00 PM
2026-03-02 14:00:59 (UTC+0)
matthiasmullie
added a comment.
Mar 2 2026, 9:11 PM
2026-03-02 21:11:33 (UTC+0)
Comment Actions
Fix also backported to production earlier today.
lwatson
closed this task as
Resolved
Mar 2 2026, 10:24 PM
2026-03-02 22:24:22 (UTC+0)
lwatson
moved this task from
QA
to
Signoff
on the
Reader Growth Team (Sprint 3 (Feb 17 - Mar 2) Q3 25/26)
board.
Comment Actions
Confirming that the whitespace was fixed on production. Example:
Log In to Comment
Content licensed under Creative Commons Attribution-ShareAlike (CC BY-SA) 4.0 unless otherwise noted; code licensed under GNU General Public License (GPL) 2.0 or later and other open source licenses. By using this site, you agree to the Terms of Use, Privacy Policy, and Code of Conduct.
Wikimedia Foundation
Code of Conduct
Disclaimer
CC-BY-SA
GPL
Credits
US