Skip to content

Commit

Permalink
Add advisement for LegacyUnenumerableNamedProperties
Browse files Browse the repository at this point in the history
  • Loading branch information
tobie committed Aug 22, 2017
1 parent 3a840fd commit 7a14655
Showing 1 changed file with 25 additions and 0 deletions.
25 changes: 25 additions & 0 deletions index.bs
Original file line number Diff line number Diff line change
Expand Up @@ -8527,6 +8527,31 @@ entails.

<h4 id="LegacyUnenumerableNamedProperties" extended-attribute lt="LegacyUnenumerableNamedProperties">[LegacyUnenumerableNamedProperties]</h4>

<div class="advisement">

The [{{LegacyUnenumerableNamedProperties}}] [=extended attribute=] is an undesirable feature.
It exists only so that legacy Web platform features can be specified.
It should not be used in specifications
unless required to specify the behavior of legacy APIs.
Editors who wish to use this feature are strongly advised to discuss this
by <a href="https://github.com/w3c/respec/issues/new?title=[legacy]">filing an issue</a>
before proceeding.

<small class="non-normative">
The [{{LegacyUnenumerableNamedProperties}}] [=extended attribute=] appears on
the following [=interfaces=]:
{{HTMLCollection}},
{{NamedNodeMap}},
{{HTMLAllCollection}},
{{HTMLFormElement}},
{{PluginArray}},
{{MimeTypeArray}},
{{Plugin}}, and
{{Window}}. [[DOM]] [HTML]
</small>

</div>

If the [{{LegacyUnenumerableNamedProperties}}]
[=extended attribute=]
appears on a [=interface=]
Expand Down

0 comments on commit 7a14655

Please sign in to comment.