This page is In Progress

Notice: The WebPlatform project, supported by various stewards between 2012 and 2015, has been discontinued. This site is now available on github.

cursor

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.

Examples

To make the cursor appear like it’s busy

.busy  {
    cursor: wait;
}

View live example

See also

Related articles

Visual Effects

Attributions

  • Mozilla Developer Network cc-by-sa-small-wpd.svg.

  • Microsoft Developer Network.