#65856 closed defect (bug) (fixed)
Lint the About page CSS for 7.1
| Reported by: | afercia | Owned by: | |
|---|---|---|---|
| Priority: | normal | Milestone: | 7.1 |
| Component: | Administration | Version: | 7.1 |
| Severity: | normal | Keywords: | has-patch dev-reviewed |
| Cc: | Focuses: | accessibility, css, coding-standards |
Description
In #29792 / https://github.com/WordPress/wordpress-develop/pull/12934 I'm experimenting a Stylelint configuration to lint the Core admin CSS.
I took the liberty to run it on the about.css file of the About page for WordPress 7.1. The linting reported several issues (50 errors). It would be good to fix at least a part of them.
More importantly:
In [63182] see #65698, two new order CSS properties have been added for the About page. They are used for the reponsive view media query at 600 pixels. Have they been carefully checked to see if they introduce any accessibility problems? Cc @joedolson
Most of the other errors are about:
- Indentation.
- Unnecessary spacing inside parentheses.
- Unnecessary quotes.
- Line-height value with unit.
- Duplicate selectors.
- Not shortened color values.
- Missing leading zero for decimal values.
PR incoming shortly.
Change History (16)
This ticket was mentioned in PR #13014 on WordPress/wordpress-develop by @afercia.
2 months ago
#1
- Keywords has-patch added
@mukesh27 commented on PR #13014:
2 months ago
#3
Refrain from using over-qualified selectors, div.container can simply be stated as .container.
Not able to see this type of selector change in PR. Did i missed anything?
@wildworks commented on PR #13014:
2 months ago
#4
Sorry, the commit 07788a5aff3289008c41d39c76163ff8d078ab61 was incorrect. I have fixed it in a5c848a27a50dc6a52ec0d413334d4ea6fe4aa60.
@wildworks commented on PR #13014:
2 months ago
#5
I'd like to commit this as there are only two hours left until the 7.1 RC commit freeze today.
#7
@
2 months ago
- Keywords dev-feedback added
This is a backport request of [63212] to the 7.1 branch.
@wildworks commented on PR #13014:
2 months ago
#8
#9
follow-up:
↓ 10
@
2 months ago
@afercia I added the order properties myself; they move two decorative images in containers that hold no other content.
#10
in reply to: ↑ 9
@
2 months ago
Replying to joedolson:
@afercia I added the
orderproperties myself; they move two decorative images in containers that hold no other content.
Thanks for confirming they do not impact a11y.
#11
@
2 months ago
- Keywords dev-reviewed added; dev-feedback removed
Approved for backport to the 7.1 branch.
@afercia commented on PR #13014:
2 months ago
#13
Refrain from using over-qualified selectors, div.container can simply be stated as .container.
Not able to see this type of selector change in PR. Did i missed anything?
Yes, you missed what I mentioned in the section "What this PR does not fix".
@afercia commented on PR #13014:
2 months ago
#15
For history, these are the errors and warnings left in the about.css file after the linting, based on the experimental Stylelint configuration in the works on https://github.com/WordPress/wordpress-develop/pull/12934
In a future, all of these should be either fixed or get a stylelint-disable{-line}{-next-line} comment with a required disable reason added to the comment.
src/wp-admin/css/about.css
81:1 ✖ Unexpected duplicate selector ".about__container", first used at line 22 no-duplicate-selectors
146:1 ✖ Unexpected duplicate selector ".about__section", first used at line 111 no-duplicate-selectors
242:1 ✖ Unexpected duplicate selector ".about__section .is-section-header", first used at line 186 no-duplicate-selectors
335:3 ✖ Avoid the order property. For accessibility reasons, visual, reading, and DOM order must match. Only use property-disallowed-list
the order property when it does not affect reading order, meaning, and interaction.
339:3 ✖ Avoid the order property. For accessibility reasons, visual, reading, and DOM order must match. Only use property-disallowed-list
the order property when it does not affect reading order, meaning, and interaction.
395:1 ✖ Unexpected duplicate selector ".about__container", first used at line 22 no-duplicate-selectors
406:19 ⚠ Unexpected qualifying type selector "h3.is-larger-heading" selector-no-qualifying-type
415:19 ⚠ Unexpected qualifying type selector "h1.is-smaller-heading" selector-no-qualifying-type
416:19 ⚠ Unexpected qualifying type selector "h2.is-smaller-heading" selector-no-qualifying-type
425:19 ⚠ Unexpected qualifying type selector "h3.is-smaller-heading" selector-no-qualifying-type
450:19 ⚠ Unexpected qualifying type selector "p.is-subheading" selector-no-qualifying-type
480:17 ⚠ Unexpected qualifying type selector "a.button.button-hero" selector-no-qualifying-type
540:19 ⚠ Unexpected qualifying type selector "hr.is-small" selector-no-qualifying-type
545:19 ⚠ Unexpected qualifying type selector "hr.is-large" selector-no-qualifying-type
549:19 ⚠ Unexpected qualifying type selector "hr.is-invisible" selector-no-qualifying-type
553:19 ⚠ Unexpected qualifying type selector "div.updated" selector-no-qualifying-type
554:19 ⚠ Unexpected qualifying type selector "div.error" selector-no-qualifying-type
563:1 ✖ Unexpected duplicate selector ".about__section", first used at line 111 no-duplicate-selectors
568:1 ✖ Unexpected duplicate selector ".about__section.is-feature", first used at line 200 no-duplicate-selectors
584:20 ⚠ Unexpected qualifying type selector "h3.is-larger-heading" selector-no-qualifying-type
810:1 ✖ Expected no more than 1 empty line @stylistic/max-empty-lines
926:1 ✖ Expected no more than 1 empty line @stylistic/max-empty-lines
936:1 ✖ Expected no more than 1 empty line @stylistic/max-empty-lines
948:1 ✖ Expected no more than 1 empty line @stylistic/max-empty-lines
968:13 ⚠ Unexpected qualifying type selector "div.updated" selector-no-qualifying-type
969:13 ⚠ Unexpected qualifying type selector "div.error" selector-no-qualifying-type
1288:13 ⚠ Unexpected qualifying type selector "h2.wp-people-group" selector-no-qualifying-type
1347:43 ⚠ Unexpected qualifying type selector "p.wp-credits-list" selector-no-qualifying-type
1351:13 ⚠ Unexpected qualifying type selector "p.wp-credits-list" selector-no-qualifying-type
✖ 29 problems (12 errors, 17 warnings)
4 errors potentially fixable with the "--fix" option.
![(please configure the [header_logo] section in trac.ini)](/chrome/site/your_project_logo.png)
Trac ticket: https://core.trac.wordpress.org/ticket/65856#ticket
The CSS for the WordPress 7.1 About page contains several CSS Coding Standards errors.
This PR aims to fix _most_ of them.
Importtant for accessibility:
At the moment, the
about.cssfile contains two new order CSS properties. They are used for the responsive view at 600 pixels. They should be carefully checked to see if they introduce any accessibility problems.A list of the errors is available in the attached txt file:
01 about-page-css-errors.txt
What this PR does _not_ fix:
h3.is-larger-headingwhere the element type selector should not be used. So far, I'm considering this a 'warning' and not a real error although this is explicitly mentioned in the CSS Coding Standards:## Use of AI Tools
None