Skip to content

Conversation

danae404
Copy link

@danae404 danae404 commented Sep 11, 2025

This PR addresses #533

Add notes and examples to clarify that ::cue(*) matches all WebVTT internal node objects, including the root list of WebVTT node objects, and to clarify that ::cue(:root) is a valid selector and it matches the same elements as ::cue.

Because a universal selector is within the class of type selectors, delete the parenthical note in Example 22 that makes it seem that type selectors can never match the root.

Also add spacing around the section of Leaf Node Objects. The current spacing makes it easy to confuse it as a subclass of WebVTT Internal Node Objects.


Preview | Diff

@w3cbot
Copy link

w3cbot commented Sep 11, 2025

danae404 marked as non substantive for IPR from ash-nazg.

@danae404
Copy link
Author

@gkatsev

Copy link
Collaborator

@gkatsev gkatsev left a comment

Choose a reason for hiding this comment

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

Thanks! A couple small things.

</pre>
</td>
<td class=long>
<p><a>WebVTT Internal Node Objects</a> (except the root <a>list of WebVTT Node Objects</a>)
Copy link
Collaborator

Choose a reason for hiding this comment

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

should the except the root parenthetical be removed from the class selector example below (line 5099) as well?

Copy link
Author

@danae404 danae404 Oct 8, 2025

Choose a reason for hiding this comment

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

I dont think you can assign a class to plain text in the cue; you have to encompass the text in a <c> to give it a class. So keeping the parenthesis still makes sense.

index.bs Outdated

</dl>

<br>
Copy link
Collaborator

Choose a reason for hiding this comment

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

ah, much better!

Copy link
Member

Choose a reason for hiding this comment

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

I don't like br being used for spacing purposes. Can we use CSS instead? dl + p { margin-top: 2em }

index.bs Outdated
Comment on lines 5432 to 5435
empty string. Note that the <a>universal selector</a> matches all <a>WebVTT Internal Node Objects</a>, including the
root <a>list of WebVTT Node Objects</a>.</p></li>

<li><p>''::cue(:root)'' is equivalent to ''::cue''.</p></li>
Copy link
Collaborator

Choose a reason for hiding this comment

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

May be better to make these two as a <p class=note> to keep this change editorial, since notes are non-normative.

…ng around the WebVTT Leaf Nodes section so that it does not get confused to be subclass of WebVTT Internal Nodes
@danae404 danae404 force-pushed the selector-clarifications branch from 46e5068 to 898f395 Compare October 8, 2025 20:20
@danae404 danae404 requested review from gkatsev and zcorpan October 8, 2025 20:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants