mozilla

Revision 57087 of cursor

  • Revision slug: SVG/Element/cursor
  • Revision title: cursor
  • Revision id: 57087
  • Created:
  • Creator: Manuel_Strehl
  • Is current revision? No
  • Comment add compat table; 46 words added

Revision Content

{{ SVGRefElem() }}

The cursor element can be used to define a platform-independent custom cursor. A recommended approach for defining a platform-independent custom cursor is to create a PNG image and define a cursor element that references the PNG image and identifies the exact position within the image which is the pointer position (i.e., the hot spot).

The PNG format is recommended because it supports the ability to define a transparency mask via an alpha channel. If a different image format is used, this format should support the definition of a transparency mask (two options: provide an explicit alpha channel or use a particular pixel color to indicate transparency). If the transparency mask can be determined, the mask defines the shape of the cursor; otherwise, the cursor is an opaque rectangle. Typically, the other pixel information (e.g., the R, G and B channels) defines the colors for those parts of the cursor which are not masked out. Note that cursors usually contain at least two colors so that the cursor can be visible over most backgrounds.

Usage context

Categories None
Permitted content Any number of the following elements, in any order:
Descriptive elements »
Normative document SVG 1.1 (2nd Edition)

Example

Attributes

Global attributes

Specific attributes

  • {{ SVGAttr("x") }}
  • {{ SVGAttr("y") }}
  • {{ SVGAttr("xlink:href") }}

DOM Interface

This element implements the SVGCursorElement interface.

Browser compatibility

{{ CompatibilityTable() }}

{{ CompatTableDesktop(['Basic Support', CompatChrome('1.0'), CompatNo(), CompatUnknown(), CompatNo(), CompatSafari('3.0')]) }} {{ CompatTableMobile(['Basic Support', CompatUnknown(), CompatNo(), CompatNo(), CompatNo(), CompatSafari('3.0')]) }}

Revision Source

<p>{{ SVGRefElem() }}</p>
<p>The <code>cursor</code> element can be used to define a platform-independent custom cursor. A recommended approach for defining a platform-independent custom cursor is to create a PNG image and define a <code>cursor</code> element that references the PNG image and identifies the exact position within the image which is the pointer position (i.e., the hot spot).</p>
<p>The PNG format is recommended because it supports the ability to define a transparency mask via an alpha channel. If a different image format is used, this format should support the definition of a transparency mask (two options: provide an explicit alpha channel or use a particular pixel color to indicate transparency). If the transparency mask can be determined, the mask defines the shape of the cursor; otherwise, the cursor is an opaque rectangle. Typically, the other pixel information (e.g., the R, G and B channels) defines the colors for those parts of the cursor which are not masked out. Note that cursors usually contain at least two colors so that the cursor can be visible over most backgrounds.</p>
<h2>Usage context</h2>
<table class="standard-table"> <tbody> <tr> <th scope="row">Categories</th> <td><em>None</em></td> </tr> <tr> <th scope="row">Permitted content</th> <td>Any number of the following elements, in any order:<br> <a href="/en/SVG/Element#Descriptive" title="en/SVG/Attribute#Descriptive">Descriptive elements</a> »</td> </tr> <tr> <th scope="row">Normative document</th> <td><a class="external" href="http://www.w3.org/TR/SVG/interact.html#CursorElement" title="http://www.w3.org/TR/SVG/interact.html#CursorElement">SVG 1.1 (2nd Edition)</a></td> </tr> </tbody>
</table><h2>Example</h2>
<h2>Attributes</h2>
<h3>Global attributes</h3>
<ul> <li><a href="/en/SVG/Attribute#ConditionalProccessing" title="en/SVG/Attribute#ConditionalProccessing">Conditional processing attributes</a> »</li> <li><a href="/en/SVG/Attribute#Core" title="en/SVG/Attribute#Core">Core attributes</a> »</li> <li><a href="/en/SVG/Attribute#XLink" title="en/SVG/Attribute#XLink">Xlink attributes</a> »</li> <li>{{ SVGAttr("externalResourcesRequired") }}</li>
</ul>
<h3>Specific attributes</h3>
<ul> <li>{{ SVGAttr("x") }}</li> <li>{{ SVGAttr("y") }}</li> <li>{{ SVGAttr("xlink:href") }}</li>
</ul><h2>DOM Interface</h2>
<p>This element implements the <code><a href="/en/DOM/SVGCursorElement" title="en/DOM/SVGCursorElement">SVGCursorElement</a></code> interface.</p>
<h2>Browser compatibility</h2>
<p>{{ CompatibilityTable() }}</p>
<p>{{ CompatTableDesktop(['Basic Support', CompatChrome('1.0'), CompatNo(), CompatUnknown(), CompatNo(), CompatSafari('3.0')]) }} {{ CompatTableMobile(['Basic Support', CompatUnknown(), CompatNo(), CompatNo(), CompatNo(), CompatSafari('3.0')]) }}</p>
Revert to this revision