DOM/prefixes: Difference between revisions

< DOM
(stub with a few sections)
 
m (s)
 
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
<div style="float:right">__TOC__</div>
{{stub}}
{{stub}}


Line 4: Line 5:


== Prefixed APIs ==
== Prefixed APIs ==
* <code>element.mozMatchesSelector</code>
** see https://developer.mozilla.org/en-US/docs/Web/API/Element.matches
* <code>[https://developer.mozilla.org/en-US/docs/Web/API/window.mozAnimationStartTime window.mozAnimationStartTime]</code>
** to be proposed in a standard?
* <code>window.mozRequestAnimationFrame</code>
** use [https://developer.mozilla.org/en-US/docs/Web/API/window.requestAnimationFrame window.requestAnimationFrame] (FF23+, IE10+, Chrome)
* ... add any that you see on DevMo or anywhere else (e.g. the source code), link to where its defined/documented (e.g. DevMo link). Feel free to file a bug asking for any of them to be supported in unprefixed form (if not already), and link to the bug in the entry here.


== Policy ==
== Policy ==
In short: no new DOM/WebAPI prefixes.
== Unprefixing ==
When do we implement an unprefixed version of an API?
Requirements for unprefixing a particular DOM API:
# There must be a public specification for the unprefixed version.
# We must make sure our implementation adheres to the specification before supporting the unprefixed version of an API in Gecko.


== Dropping ==
== Dropping ==
When do we drop support for a prefixed version of an API?
Requirements:
# We must support an unprefixed version
# The web doesn't depend on the prefixed version too much (to be evaluated on a per case basis).


== See Also ==
== See Also ==
Line 13: Line 34:
* [[DOM]]
* [[DOM]]
* [[HTML5]]
* [[HTML5]]
* [[WebAPI]]
* [[Standards]]
* [[WebAPI]] / [[WebAPI/2013-07-02]]

Latest revision as of 00:38, 16 August 2013

This article is a stub. You can help MozillaWiki by expanding it.

Some DOM APIs have vendor prefixes on them. This page provides documentation on which (partial), why (Mozilla's DOM prefixing policy), and how we transition away from vendor prefixes.

Prefixed APIs

Policy

In short: no new DOM/WebAPI prefixes.

Unprefixing

When do we implement an unprefixed version of an API?

Requirements for unprefixing a particular DOM API:

  1. There must be a public specification for the unprefixed version.
  2. We must make sure our implementation adheres to the specification before supporting the unprefixed version of an API in Gecko.

Dropping

When do we drop support for a prefixed version of an API?

Requirements:

  1. We must support an unprefixed version
  2. The web doesn't depend on the prefixed version too much (to be evaluated on a per case basis).

See Also