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

added guts of custom elements semantics section #26

Merged
merged 9 commits into from
Dec 8, 2014

Conversation

stevefaulkner
Copy link
Contributor

not finished but far enough along to be reviewed

<h3>Custom Tag Semantics</h3>
<p>By default a <a href="#dfn-custom-tag">custom tag</a> has no special meaning at all. It <a href="http://www.w3.org/TR/html/dom.html#represents">represents</a> its children.</p>
<p>For example a custom tag, could be named <em>taco-button</em> but it does not express the semantics of a HTML <a href="http://www.w3.org/TR/html/forms.html#the-button-element"><code>button</code></a> element simply due to its name. As instaniated a custom tag conveys a similar amount of semantics as a HTML <a href="http://www.w3.org/TR/html/grouping-content.html#the-div-element"><code>div</code></a> or <code><a href="http://www.w3.org/TR/html/text-level-semantics.html#the-span-element">span</a></code> element. The addition of visual styling and scripted events to the <em>taco-button</em> could provide hints as to the semantics and expected interaction behaviours of the custom element for <em>some</em> users, but for the semantics to be formally expressed, developers must convey the role, states and properties of the element to browser APIs.</p>
<pre>&lt;!-- taco-button represents a span with a fancy name -->
Copy link
Contributor

Choose a reason for hiding this comment

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

Brace with <code class="prettyprint"> here and on. See example above (look for "amazement" in text)

Copy link
Contributor Author

Choose a reason for hiding this comment

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

done

@stevefaulkner
Copy link
Contributor Author

added pretty styles and note about event handlers and styles for note/example code

@dglazkov
Copy link
Contributor

dglazkov commented Dec 8, 2014

LGTM.

dglazkov added a commit that referenced this pull request Dec 8, 2014
added guts of custom elements semantics section
@dglazkov dglazkov merged commit b14e2da into WICG:gh-pages Dec 8, 2014
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.

3 participants