Wikipedia talk:Manual of Style/Accessibility

"WT:ACCESS" redirects here. For the related wikiproject talk page, see Wikipedia talk:WikiProject Accessibility.

"WT:COLOR" and "WT:COLOUR" redirect here. For WikiProject Color's talk page, see Wikipedia talk:WikiProject Color.

WP:NOBR notes

are there any acceptable uses for the HTML line break <br/>? on a recent edit of mine, I substituted a {{ubl}} template into the HTML line break, as this was not being used for a list but as a visual break for the default size, separating the series title from the year in a table, for visual harmony.

I have seen this sort of visual break in many articles that I have edited, especially less cared ones, but how should it be handled? is it COMPLETELY discouraged it, even for use cases where there is legitemately no factor other than aesthetics or what to do instead? Juwan (talk) 12:21, 19 September 2024 (UTC)

Not to hock my own slogan, but essentially as I understand it, break means pause. That is to say, line breaks are acceptable when they actually represent semantic breaks in content, perhaps roughly equivalent to a paragraph break. They should neither be used to create the appearance of lists nor to manually wrap a single block of text, but beyond that there are actually plenty of plausible applications. Infobox templates themselves actually use them a lot under the hood. Remsense ‥ 论 12:24, 19 September 2024 (UTC)

oh, that's actually a great essay! if you think it is appropriate please link it on the section, that's exactly what I was looking for. Juwan (talk) 12:49, 19 September 2024 (UTC)

It's incomplete at the moment, and I like the idea that others would link such things rather than me if they find it useful so that only useful things get linked, so if you think it would help others then go for it! Remsense ‥ 论 12:56, 19 September 2024 (UTC)

Line breaks are for visual appearance only, and so semantically they are equivalent to whitespace. Appropriate semantic markup should be used as applicable. Line breaks should be used sparingly. As browser widths change or other elements are added to the page, the page will automatically be laid out differently by browsers, and manual overrides can work against this process producing a pleasing result. isaacl (talk) 18:40, 19 September 2024 (UTC)

Where to place accessibility templates on problem templates

The section on color suggests placing the {{Overcolored}} template at the top of articles with contrast issues. What about templates. For example, the {{Transport in Mexico City}} template has major issues with contrast. But if I place the template at the top of the template itself, it will appear on dozens of pages, which would be disruptive. I wound up placing it on the Transport in Mexico City template talk page at the top of my topic.

It would be good to clarify this in the text as to where it would best be placed in templates.

Thisisnotatest (talk) 06:14, 26 September 2024 (UTC)

I would put it on the doc page as well. If there's not a maintenance category for templates with accessibility issues, maybe it should be created and populated! I would personally appreciate that. Remsense ‥ 论 07:04, 26 September 2024 (UTC)

Place it in the template, either in the documentation, or if it doesn't, then at the bottom between the noinclude tags. Gonnym (talk) 08:31, 26 September 2024 (UTC)

Thank you! I've moved it to the template documentation as well as added it to a related template. That's what I will do moving forward. Thisisnotatest (talk) 07:21, 27 September 2024 (UTC)

Looping GIFs and accessibility

My edit Animations: Clarified 5 seconds as total playing time was reverted by Remsense with the comment "This is confusing to me: are looping GIFs simply not allowed?"

Rather than risking getting into an edit war, I am moving the matter here to attempt to gain consensus on wording before proposing a final edit.

WCAG 2.1 provides Technique G152: Setting animated gif images to stop blinking after n cycles (within 5 seconds)

Looping GIFs are permitted as long as they stop looping such that the total animation time is 5.0 seconds or less. So:

• A 1 second long animated GIF could loop 5 times
• A 1.5 second long animated GIF could loop 3 times
• A 2 or 2.5 second long animated GIF could only loop twice
• A 3 second long animated GIF could not loop at all
• Endlessly looping animated GIFs are not permitted at all

Hope that makes it clear (which I believe the current page wording does not do).

Thisisnotatest (talk) 07:11, 27 September 2024 (UTC)

Suffice it to say, this does require conversation as almost no one operates based on this understanding, even if it's well-founded. Remsense ‥ 论 07:13, 27 September 2024 (UTC)

From what I understand, and I'm woefully underread in the literature so this is partially anecdotal so forgive me, there is a significant distinction in accessibility between short animations that loop and long animations. SC 2.2.2: Pause, Stop, Hide says

“

Content that moves or auto-updates can be a barrier to anyone who has trouble reading stationary text quickly as well as anyone who has trouble tracking moving objects. It can also cause problems for screen readers.

Moving content can also be a severe distraction for some people. Certain groups, particularly those with attention deficit disorders, find blinking content distracting, making it difficult for them to concentrate on other parts of the Web page. Five seconds was chosen because it is long enough to get a user's attention, but not so long that a user cannot wait out the distraction if necessary to use the page.

”

The operative sentence uses the word "blinking" in a manner I find to be a bit vague: I would intuit some distinction many people would perceive between "blinking", merely "looping", and "ongoing" animated content in terms of its potential to interfere with their ability to focus or comfortably read? Later, "blinking" is defined as "content that causes a distraction problem", which is unfortunately a bit circular for our purposes. If blinking is coterminous with moving, why isn't moving used? Remsense ‥ 论 07:22, 27 September 2024 (UTC)

As I understood it at the time that the HTML BLINK element was first deprecated, it's because certain blink rates can trigger seizures. I've never heard of a looped animation doing that, unless the animation is essentially two images displayed alternately. --Redrose64 🌹 (talk) 08:20, 27 September 2024 (UTC)

It doesn't only say blinking, it also says moving or scrolling. The area of concern is "The intent of this Success Criterion is to avoid distracting users during their interaction with a Web page." Long form animations need to be done via a pauseable video rather than by an uncontrollable animated GIF. Thisisnotatest (talk) 09:57, 27 September 2024 (UTC)

I'm just trying to fully understand what SC 2.2.2 says and why. Most concretely, it says:

• Content that moves or auto-updates can be a barrier to anyone who has trouble reading stationary text quickly as well as anyone who has trouble tracking moving objects. It can also cause problems for screen readers.
• Moving content can also be a severe distraction for some people. Certain groups, particularly those with attention deficit disorders, find blinking content distracting, making it difficult for them to concentrate on other parts of the Web page.

The first point is about moving content in general, and doesn't really apply to our conversation about looping GIFs in particular. The second specifically discusses blinking content, which is the distinction I'm currently unclear about. Remsense ‥ 论 10:04, 27 September 2024 (UTC)

I do find it odd that they seem to focus on blinking so much. The issue is that if anything on my screen is animating when I am trying to read some other content on the page, then I will have difficulty concentrating on that other content. It doesn't matter whether the animated content is blinking or showing how an oil rig operates. If I have no way to stop it, I can't focus on the content that I'm interested in focusing on.

I've seen reports of usability tests where people will hold their hand up to obscure the unstoppable animation, and I've done that too. That assumes an abled person who can hold their hand up for an extended period of time; someone who is both attention challenged and arm-mobility disabled would not have that workaround. It still would take some of their/my attention away from trying to absorb the content of interest. And it's making the site visitor adapt to the site rather than the site adapting to the visitor. Hope that makes it clear. Thisisnotatest (talk) 23:51, 29 September 2024 (UTC)

Certainly. As I admitted, my previous understanding was based partially on my own anecdotal experience, where I can only recall those in my life having spoken about an inability to focus amid stimulus I would have characterized as "blinking" or "ongoing" above, rather than "looping". Of course, I don't doubt at all that the problem would cover that area also—there was just enough of a question in my mind that I felt it appropriate to make explicit.

General question I may cross-post to WP:VPT: what feasibility would there be in building a tool that can help us accomplish this task? It would seem to require transcoding every GIF on a live page to a video—there's no real advantage to using GIFs at all, right? Remsense ‥ 论 23:58, 29 September 2024 (UTC)

My experience is that content that stops moving within the first five seconds can be extremely difficult to understand because you may not even pay much attention to it in that time (while reading the rest of the article) and you may need more time than that to view all the details in the content. Forbidding brief looping content on GIFs is very problematic for that reason. I was brought here from Talk:Four-dimensional space where User:Humphrey Tribble and User:Mgnbar appear to be trying to forbid File:8-cell-simple.gif from being used to illustrate the article on accessibility grounds, and claiming that this discussion provides consensus for their position. I for one would find a static frame (or more or less the same thing, an image that animates briefly and then turns into a static frame) much less informative in this context, and I see no such consensus here. —David Eppstein (talk) 23:29, 24 December 2024 (UTC)

To be clear, I did more research during and after this conversation, and I am in full agreement with the OP that accessibility standards say this and for good reasons we should be applying onwiki. I do think by far the ideal solution is conversion to a seekable, pausable video. Remsense ‥ 论 23:42, 24 December 2024 (UTC)

In the case of a short smoothly looping video, this would make it impossible to view the video in an uninterrupted way as it loops, breaking its accessibility. —David Eppstein (talk) 00:02, 25 December 2024 (UTC)

Is this so? I suppose it depends somewhat on device, but videos set to loop on my computer and phone hosted on wiki both work as intended. Remsense ‥ 论 00:03, 25 December 2024 (UTC)

You have an example of this, embedded within an article (not a separate viewer app) on Wikipedia?

In the meantime this seems to me to be a technical issue with Wikimedia rather than a content issue. If people are distracted by looping images to the point of needing them to stop to make article content accessible, they should be able to stop them, but currently Wikimedia has no way of doing so and no way of changing the image's default behavior. See T85838 and T85840. For some reason Wikimedia thinks of these as being very low priority but that's an issue for them, not for us. —David Eppstein (talk) 00:11, 25 December 2024 (UTC)

I'll do you one better: link me a looping GIF you want to test, and I'll convert it to WEBM and upload it to Commons so you can compare the results yourself. (I suppose it isn't magic and you can likely very trivially just do it yourself as well. I haven't discerned whether there's an ideal tool to use for this, but the one I'm using works to my eye.) Remsense ‥ 论 00:15, 25 December 2024 (UTC)

The one that led me to this discussion is File:8-cell-simple.gif, which is by the way one of a very small number of mathematics Featured Pictures. But my experience with webm files in Wikipedia articles, such as the one in Figure-eight knot (mathematics), is that clicking on them them to animate them causes them to pop up into a separate viewer. What I want to see is a way to get them to animate in place, within the context of an article, not separated from the article by a viewer interface. —David Eppstein (talk) 00:36, 25 December 2024 (UTC)

That is certainly a WMF-domain thing, yes. I also agree that it feels pointless to ask—people are very busy and all. I think we could agree it's worth replacing at least some GIFs with WEBMs under the current conditions? Remsense ‥ 论 00:39, 25 December 2024 (UTC)

So you admit that direct replacement is not actually possible?

What is the point of an accessibility guideline that impedes understanding by preventing us from including even Featured Pictures, with no adequate way of replacing them by an equivalent alternative? —David Eppstein (talk) 00:53, 25 December 2024 (UTC)

I am extremely torn in my position, because I am fine with using videos and dealing with the unideal interface but I know others might not be fine with that. But it is hard to be complacent with saying we don't have the tools to comply with accessibility BCPs.

I feel forced to pick which one of two groups of users that their preferences borne of totally reasonable accessibility concerns don't matter as much. I am trying to be as thoughtful as I can about it, but I feel boxed in. Remsense ‥ 论 00:56, 25 December 2024 (UTC)

To be clear, I would find relegating that image to a separate popup to be an accessibility barrier to my own understanding of it in the context of the article. I am very sympathetic to accessibility concerns in general, and I understand that the presence of moving content could be highly distracting to some readers, again an accessibility barrier. There is a solution to this dilemma: convince Wikimedia to prioritize this accessibility concern, as represented by the phab tickets linked above, rather than forcing us to choose between unsatisfactory options.

There does appear to be a workaround for the users who dislike animated gifs: there exist browser extensions (at least for Firefox) to turn off or switch on and off animated gifs. It may not be satisfactory but it is at least not impossible. There does not appear to be any workaround in the other direction for people who would like to improve their understanding of topics by studying relevant animations in the context of an article over an extended period of time. —David Eppstein (talk) 01:12, 25 December 2024 (UTC)

Webms on current Wikipedia suck for accessibility. The software controls are confusing, poorly implemented, and seem like a hacked on afterthought. –jacobolus (t) 02:31, 25 December 2024 (UTC)

For some reason this is stressing me out more than these issues usually do, I guess because per above I feel like I have to in effect choose between two groups of people, if merely though admitting the infrastructure can't do what we need it to do. I guess if I'm !voting on a preference I'm abstaining from an opinion until I don't have to make such a choice. Remsense ‥ 论 02:37, 25 December 2024 (UTC)

Do we need to call out team and transit colors under color?

I notice a lot of issues on Wikipedia where text has contrast issues because someone has duplicated team or transit route colors. Do we want to specifically mention that using team and transit colors for text is not exempt from meeting contrast requirements, and that accessibility takes precedence over non-logo branding?

Team example

Geelong West Giants uses white text on a orange background extensively. Orange text or backgrounds are particularly problematic because white on orange fails WCAG 2.x contrast test, but some people find orange on black harder to read. The logo doesn't need to meet contrast, but text does. The best practice would likely be to abandon the orange background.

The color #FFFFFF (white) on #F15C22 (orange) has a contrast of 3.33:1, which fails for text smaller than 18.66px bold or 24px not bold.

Transit example

{{Transport in Mexico City}} themes colors by route and mode. Several of the routes use insufficient contrast, such as Cablebús line 1, which has white on light blue, which violates contrast at all sizes.

The color #FFFFFF (white) on #4EC3E0 (light blue) has a contrast of 2.05:1, which fails for text at all sizes. This issue is complicated that the icon is supplied by the government of Mexico City, but the license permits modification, such as making the "1" black instead of white (changing fill="#FFFFFF" to fill="#000000" in the SVG code). But it might be simpler and less distracting to use actual text rather than an SVG image.

Thisisnotatest (talk) 21:24, 27 September 2024 (UTC)

These colors have always been horrible, and not only for accessibility reasons. Look at Template:Geelong Football League, the hyperlink in title is completely hidden. Gonnym (talk) 21:32, 27 September 2024 (UTC)

Many years ago, the ice hockey WikiProject moved to using colour borders instead of colour backgrounds in order to improve accessibility (including legibility). See Template:Montreal Canadiens for an example. (Some ice hockey editors don't like how it looks, while others do, but the consensus has held.) I feel this approach is a reasonable tradeoff between visual design goals, and should be considered for other similar scenarios. isaacl (talk) 16:22, 28 September 2024 (UTC)

I don't see the point of it. It's a digression. I mean, I guess the people doing it think it adds a coolness factor, but this isn't TikTok. We aren't here to be cool, and we're here to be informative, and coolness is a distraction from that.

When we have a list of the names of fruits, we don't precede each one by an icon depicting the fruit. List of typefaces (thank the forces that be) doesn't display the name of each typeface in that typeface. But some people, when they create or see a list of countries, they feel the impulse to prefix each name with the country's flag, as though every mention of a country merits another reminder to the reader of what that country's flag looks like. This situation is the same. It's an encyclopedia, not a font catalog or sports journal or score sheet. Identify typefaces, countries, routes, teams, etc., by name, without decoration. And not only do the color embellishments serve no useful purpose but, as you note, they break accessibility. Largoplazo (talk) 17:13, 28 September 2024 (UTC)

Funny enough, I'd much rather List of typefaces show examples of how each typeface looks like (and I actually do believe that is informative), than see another list with a country flag in it. Gonnym (talk) 10:27, 29 September 2024 (UTC)

So what is the path forward for this?

How do we get consensus to move all sports templates to the ice hockey model? Do we need a bot to make this edit, given that hundreds of pages are involved? Further, some of this styling has carried over to section headings in the manually edited content, for instance the table headings on Geelong West Giants.

And what would be a solution for transit? I'm happy to go in to, say, {{New York City Subway}} and replace all the icons with text. (I did check the history and there is no mention of "accessibility" or "contrast" in any of the revisions.) I suppose I could be bold and see what happens, but without specific advice here on Wikipedia:Manual of Style/Accessibility I don't feel I have the concrete advice to back me up. I don't want to get into an edit war.

I suggest adding the following text to Wikipedia:Manual of Style/Accessibility:

Do not use logos or themed colors in place of default-color text links. They can keep people with low vision who don't use screen readers from being able to read the link, and can cause concentration issues for people with cognitive disabilities.

Thisisnotatest (talk) 23:36, 29 September 2024 (UTC)

Further, when non-white background colors are used, it can interfere with being able to see whether a link underline indicates the linked page does or does not exist. Actually, it can interfere with being able to see the link underline at all. Thisisnotatest (talk) 04:58, 1 October 2024 (UTC)

Also noticing templates where the title bar text is over a background gradient, where once of the background colors would properly take white text and the other one would properly take black text, making it impossible to choose an accessible text color that works with both. For example, {{MARTA Red and Gold lines}}, {{MARTA Blue and Green lines}}, and {{Richmond station (California)}}. Thisisnotatest (talk) 22:34, 4 October 2024 (UTC)

RfC partly concerning vision accessibility

 You are invited to join the discussion at Wikipedia talk:Manual of Style/Linking § RfC: Linking of three-part place names. -- Tamzin^{[cetacean needed]} (they|xe) 20:59, 17 October 2024 (UTC)

What to do about flashing images

MOS:ANIMATION: In addition, animations must not produce more than three flashes in any one-second period. Content that flashes more than that limit is known to cause seizures.[14]

Let's say there's an animated image in several articles with rapid blinking, well exceeding 3 f/s. And, let's say it's effectively impossible to illustrate the thing it illustrates, w/out rapid blinking. Is the right thing to do, just remove the image then? Photosensitivity Warning: Thinking of File:Strobe 2.gif. Looking at that thing gives me a headache. --Slowking Man (talk) 21:56, 21 October 2024 (UTC)

Concerns with MOS:PSEUDOHEAD

Going to say my piece here before being bold and seeing if others agree. The "acceptable" way of PSEUDOHEAD, shouldn't be an "acceptable" method. It's still pseudohead and is very manipulated by the community. Countless articles I have seen have dodged the use of headers by using bold markup instead which is pretty stupid, in my opinion. Maybe changing the language to make sure that people understand that it is ONLY to be used for when {{TOC limit}} can't be used. Right now, if I was an editor who never saw it. I'd see the acceptable way of using it and then just go ahead and use it, no questions. Or even get rid of the acceptable way and make it incorrect and tell people to suck it up. Cowboygilbert - (talk) ♥ 19:49, 31 October 2024 (UTC)

I would go further: if you're running into situations where you're struggling with {{TOC limit}}, there's almost certainly something wrong with how you're structuring the article. Even the heftiest prose articles rarely need level-4 headings and frankly should never use level-5 headings. I'm willing to go out on a limb and say the same is the case for list articles unless someone can show me a counterexample. Remsense ‥ 论 19:53, 31 October 2024 (UTC)

I did see an issue with {{TOC limit}} is that you need to have nested-headers when doing lvl 4 or lvl 5. So it MUST follow a level 3 header.

So you can't do:
== Header ==
==== Small header====


so you have to do:
== Header ==
=== Small-ish header ===
==== Small header ====


Which could be fixed with fixing the TOC limit template code but I am not a template editor. Cowboygilbert - (talk) ♥ 19:57, 31 October 2024 (UTC)

I'm not quite understanding how this is an issue, unless it's that other editors would like to skip to smaller font sizes or more granular divisions. I would reiterate what I said above: it seems almost certain to me that if an editor finds themselves wanting this, they should consider whether they're doing something idiosyncratic or unnecessary. Remsense ‥ 论 20:01, 31 October 2024 (UTC)

I saw it happen on Chromakopia while fixing it's PSEUDOHEAD. It has lvl 2 headers and then lvl 4 headers, but you can't limit lvl 3 because there are other sections that need to show on the TOC. (i did have to google idiosyncratic btw) But on articles where I mainly see it, which is in Category:Production discographies, they aren't an issue because it's usually a lvl 2 followed by a lvl 3 header. Cowboygilbert - (talk) ♥ 20:04, 31 October 2024 (UTC)

My point is that one should never have to skip levels: usually, the better solution is either to omit the granular lower-level headings as unnecessary, or be less dogmatic about the scope of higher-level headings (for example, sections that relate the narrative of a historical event shouldn't be stuffed under a top-level "History" section, like my least favorite LTA and many others feel the need to do). Remsense ‥ 论 20:10, 31 October 2024 (UTC)

MOS:GOODHEAD is clear: Nest headings sequentially, starting with level 2 (==), then level 3 (===) and so on. (Level 1 is the auto-generated page title.) Do not skip parts of the sequence --Redrose64 🌹 (talk) 00:04, 1 November 2024 (UTC)

I suppose I would echo Gil's question here: what is the expected use case for pseudoheaders when formatted correctly? Remsense ‥ 论 02:09, 1 November 2024 (UTC)