cursor

< css‎ | properties
Jump to: navigation, search

cursor

This article is In Progress.


W3C Recommendation

Summary

The cursor CSS property specifies the mouse cursor displayed when the mouse pointer is over an element.

Overview table

Initial value auto
Applies to all elements
Inherited Yes
Media visual
Computed value as specified (if a keyword), URLs are converted to absolute
Animatable No
CSS Object Model Property cursor
Percentages N/A

Syntax

  • cursor: standard values
  • cursor: url() hotspot-x hotspot-y, keyword;
  • cursor: url(), keyword


Values

standard values
There are many standard cursors available:
  • auto
  • default
  • none
  • context-menu
  • help
  • pointer
  • progress
  • wait
  • cell
  • crosshair
  • text
  • vertical-text
  • alias
  • copy
  • move
  • no-drop
  • not-allowed
  • e-resize
  • n-resize
  • ne-resize
  • nw-resize
  • s-resize
  • se-resize
  • sw-resize
  • w-resize
  • ew-resize
  • ns-resize
  • nesw-resize
  • nwse-resize
  • col-resize
  • row-resize
  • all-scroll
  • zoom-in
  • zoom-out

These have varying support across different browsers — see the support section. The examples below feature different boxes with different cursor values set on them, so you can get an idea of what the different ones look like.

url(), keyword
Instead of specifying a standard pointer type, you can specify a url() function pointing to a custom graphic to use as a cursor, which must be followed by a fallback keyword to use as a pointer if the image is not available (this can be auto or a standard keyword value). For example, cursor: url(), auto;

You can supply multiple url() functions separated by commas (url(), url(), auto for example), and the browser will use the earliest appropriate image it can find. Limitations include:

  • Cursor size: if the cursor image is over a certain size it will be ignored (in Gecko for example the limit is 128×128px). You should limit yourself about 32×32px anyway, for maximum compatibility with operating systems and platforms.
  • Browser: In Opera, the custom cursors are just ignored, and the keywords are used instead.
  • Transparency: Translucent cursors are not supported on Windows releases earlier than XP. This is a limitation of the operating system. Transparency works on all platforms.
  • Image format: Most browsers support a wide variety of image formats, but you should stick to something common and web-optimizable for the most part, such as JPG or PNG. You'll also need to include a CUR format image, as they are required by IE. Animateds PNGs and GIFs will only produce static cursors.
url() hotspot-x hotspot-y, keyword;
CSS3 allows you to specify a custom cusor image along with an X and Y number values for the pointer hotspot, for example cursor: url(cursor2.png) 2 2, auto;. If not specified, the hotspot position defaults to the top left corner of the cursor image, or may be read from the meta data inside the image file, in the case of CUR and XBM format files.


Compatibility

There is no data available for topic "css", feature "cursor". If you think that there should be data available, consider opening an issue.


Needs Examples: This section should include examples.




See also

Related articles

Visual Effects











  • cursor







Attribution

This article contains content originally from external sources.

Portions of this content come from the Mozilla Developer Network cc-by-sa-small-wpd.svg.

Portions of this content come from the Microsoft Developer Network.