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

[css-cascade] Apparent contradiсtion between definitions of "the cascade" and "the output of the cascade" #6996

Open
SelenIT opened this issue Jan 28, 2022 · 3 comments
Labels
css-cascade-4 Current Work

Comments

@SelenIT
Copy link
Collaborator

SelenIT commented Jan 28, 2022

The 1st paragraph of the §6. Cascading in both Level 4 and Level 5 states (emphasis mine):

The cascade takes an unordered list of declared values for a given property on a given element, sorts them by their declaration’s precedence as determined below, and outputs a single cascaded value.

At the same time, the last paragraph of §6.1. Cascade Sorting Order says that

The output of the cascade is a (potentially empty) sorted list of declared values for each property on each element.

These statements seem to contradict each other, which is confusing. Are "the output of the cascade" and the thing that "the cascade outputs" not the same thing? Shouldn't this be clarified for consistency?

@SelenIT SelenIT changed the title [css-cascade] Apparent contradiсtion between definitions of the cascade and the output of the cascade [css-cascade] Apparent contradiсtion between definitions of "the cascade" and "the output of the cascade" Jan 28, 2022
@tabatkins
Copy link
Member

Yes, "cascaded value" and "output of the cascade" are not the same thing. If you follow the "cascaded value" link to its definition, you see:

The cascaded value represents the result of the cascade: it is the declared value that wins the cascade (is sorted first in the output of the cascade). If the output of the cascade is an empty list, there is no cascaded value.

The "output of the cascade" is a list; the "cascaded value" is one of the items in that list, or nothing if it's empty.

That said, the wording there is indeed somewhat confusing. Ideas, @fantasai?

@tabatkins tabatkins added the css-cascade-4 Current Work label Jan 28, 2022
@tabatkins
Copy link
Member

Wondering if just "cascade list" might be an appropriate replacement for "output of the cascade"

@SelenIT
Copy link
Collaborator Author

SelenIT commented Jan 29, 2022

"Cascade list" sounds great!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
css-cascade-4 Current Work
Projects
None yet
Development

No branches or pull requests

2 participants