-
Notifications
You must be signed in to change notification settings - Fork 46
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
Initial commit for #279. #381
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Looks good! Here are some nits.
index.bs
Outdated
should always have a corresponding IDL attribute with the same name, | ||
and the state between the two should be kept synchronized. | ||
Carving out a synchronized IDL attribute with inconsistent naming | ||
results in confusion, and should be avoided at all costs. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This needs an example.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
And we should definitely mention the classic examples of <input value>
/ <input checked>
somewhere in this.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
See: 357a8da
|
||
<div class="note"> | ||
This does not hold the other way around. | ||
A new IDL attribute does not always warrant a content attribute counterpart. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This needs an example of an IDL attribute that does not correspond to an HTML attribute.
Co-authored-by: Lea Verou <[email protected]>
Co-authored-by: Theresa O'Connor <[email protected]>
Co-authored-by: Theresa O'Connor <[email protected]>
Co-authored-by: Theresa O'Connor <[email protected]>
Co-authored-by: Lea Verou <[email protected]>
should have a corresponding IDL attribute with the same name, | ||
and the state between the two should be kept synchronized. | ||
Carving out a synchronized IDL attribute with inconsistent naming | ||
results in confusion, and should be avoided. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
results in confusion, and should be avoided. | |
results in confusion, and should be avoided. | |
<div class=example> | |
The <{input}> element has <{input/value}> and <{input/checked}> attributes that hold the default state of the element. | |
There are also {{HTMLInputElement/value}} and {{HTMLInputElement/checked}} that hold the *current* state of the element. | |
The fact that these are not synchronized, and despite the same name, they actually hold different data, has caused authors a lot of confusion. | |
</div> |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM
* Initial commit for #279. * Update index.bs Co-authored-by: Lea Verou <[email protected]> * Update index.bs Co-authored-by: Theresa O'Connor <[email protected]> * Update index.bs Co-authored-by: Theresa O'Connor <[email protected]> * Update index.bs Co-authored-by: Theresa O'Connor <[email protected]> * Added counterpattern examples. * Update index.bs Co-authored-by: Lea Verou <[email protected]> Co-authored-by: Lea Verou <[email protected]> Co-authored-by: Theresa O'Connor <[email protected]>
There needs to be some extra details fleshed out.
Preview | Diff