Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

"Target Size Enhanced" - atomic rule #2279

Open
wants to merge 8 commits into
base: develop
Choose a base branch
from
Open

Conversation

Jym77
Copy link
Collaborator

@Jym77 Jym77 commented Feb 6, 2025

New take at "Target Size" rule, as an automated rule with definitions, following CG decision.

For first pass, please focus reviews on the overall structure rather than the details of each definition 🙂

Closes issue(s):

Need for Call for Review:
This will require a 2 weeks Call for Review (new rule)


Pull Request Etiquette

When creating PR:

  • Make sure you're requesting to pull a branch (right side) to the develop branch (left side).
  • Make sure you do not remove the "How to Review and Approve" section in your pull request description

After creating PR:

  • Add yourself (and co-authors) as "Assignees" for PR.
  • Add label to indicate if it's a Rule, Definition or Chore.
  • Link the PR to any issue it solves. This will be done automatically by referencing the issue at the top of this comment in the indicated place.
  • Optionally request feedback from anyone in particular by assigning them as "Reviewers".

When merging a PR:

  • Close any issue that the PR resolves. This will happen automatically upon merging if the PR was correctly linked to the issue, e.g. by referencing the issue at the top of this comment.

How to Review And Approve

  • Go to the “Files changed” tab
  • Here you will have the option to leave comments on different lines.
  • Once the review is completed, find the “Review changes” button in the top right, select “Approve” (if you are really confident in the rule) or "Request changes" and click “Submit review”.
  • Make sure to also review the proposed Call for Review period. In case of disagreement, the longer period wins.

@Jym77 Jym77 added the Rule Use this label for a new rule that does not exist already label Feb 6, 2025
@Jym77 Jym77 self-assigned this Feb 6, 2025
@@ -0,0 +1,819 @@
---
id: gi8qkf
Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For first pass of review, please focus on global structure to se whether this is a good structure for the rule. We'll discuss details of the definitions later.

Copy link
Collaborator

@dan-tripp-siteimprove dan-tripp-siteimprove left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The general structure looks good to me. I am interested in the definition of "inline". I look forward to that part.

Copy link
Member

@carlosapaduarte carlosapaduarte left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Great work so far. Looking forward to moving this one forward.

title: Clickable area
key: clickable-area
unambiguous: true
objective: false
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why is this definition not objective?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Because I feel that "topmost event target" is not really objective.

Comment on lines 29 to 31
- the element is [rendered on a line]; or
- the element is [User Agent controlled][user agent controlled component]; or
- the element has [essential size][].
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just wondering if these should be in the expectation?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The full point of #2214 and the CG discussion was to have them as Inapplicable 🤷

</body>
```

### Inapplicable
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Shouldn't we have one with a clickable area that is not a semantic widget?

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🤔 Wouldn't that be bad for 1.3.1?
a <span onclick="alert('Hello')">Say hello</span> would fail 1.3.1. We can have one (with associated caveats), but I'm afraid it would cause problems for tools that do not have the same separation as ACT rules and would (rightfully) fail it.

Copy link

netlify bot commented Feb 20, 2025

Deploy Preview for act-rules ready!

Name Link
🔨 Latest commit 77a7611
🔍 Latest deploy log https://app.netlify.com/sites/act-rules/deploys/67b73d2c56e6190008f8b3d2
😎 Deploy Preview https://deploy-preview-2279--act-rules.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

@@ -0,0 +1,37 @@
---
title: Observed as a pointer events target
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Could the words "observed as" be cut out?

I know you added those words recently, so I assume you see considerable value in them. Still I must ask this, because when I first read those words, it made me wonder: is there another term called "pointer events target" that is different from "observed as a pointer events target"? If so, what does the venn diagram of these two sets look like? After I read the background and searched elsewhere for a minute, I arrived at the answers "no, or at least: not officially" and "n/a". If I'm the only reader that will go through that thought process: then it doesn't matter. If I'm not: then we have a cognitive load question here for future readers.

The background is essential commentary, but I'm not sure that it's essential to have it in the wording of the term itself. I figure most conversations about target size will just talk about "pointer event targets" and won't need to get into the details.

To summarize: the value of having "observed as" in the wording of the term itself is, IMO, outweighed by the cost of the added cognitive load.

@@ -0,0 +1,19 @@
---
title: In a Block of Text
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I was going to look at the examples of this PR via the new "deploy preview" functionality, which is here. When I clicked on the "Open in a new tab" links for the examples, they didn't work, because they're pointing to w3.org rather than deploy-preview-2279--act-rules.netlify.app. Is this a known limitation? If so, can I help fix it?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
reviewers wanted Rule Use this label for a new rule that does not exist already
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants