CSS cursor Property

Description

The CSS cursor property is used to define the appearance of the mouse cursor when it hovers over an HTML element. It allows web developers to specify a variety of cursor styles to provide visual feedback to users. For instance, you can set it to "pointer" for clickable elements like links or buttons, "default" for regular text, or choose from a range of other values such as "crosshair," "move," or even custom images using URLs. This property enhances user experience by giving visual cues about interactivity, helping to guide user actions when interacting with web content.

Initial value

auto

Applies to

All elements

Inherited

Yes

Computed value

As specified, but with relative URI converted into absolute URI

Animatable

No

JavaScript syntax

object.style.cursor

Interactive Demo

cursor: help;

cursor: progress;

cursor: wait;

cursor: not-allowed;

cursor: move;

cursor: e-resize;

Syntax

cursor: [ [<uri> [<x> <y>]?,]* [ 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 ] ] | inherit

Values

Move mouse over values to see cursors in action

• autoThe browser determines the cursor to display based on the current context.
• defaultThe platform-dependent default cursor. Often rendered as an arrow.
• noneNo cursor is rendered for the element.

• context-menuA context menu is available for the object under the cursor. Often rendered as an arrow with a small menu-like graphic next to it.
• helpHelp is available for the object under the cursor. Often rendered as a question mark or a balloon.
• pointerThe cursor is a pointer that indicates a link.
• progressThe program is busy in the background but the user can still interact with the interface.
• waitIndicates that the program is busy and the user should wait. Often rendered as a watch or hourglass.

• cellIndicates that a cell or set of cells may be selected. Often rendered as a thick plus-sign with a dot in the middle.
• crosshairA simple crosshair (e.g., short line segments resembling a "+" sign). Often used to indicate a two dimensional bitmap selection mode.
• textIndicating text can be selected, typically an I-beam.
• vertical-textIndicating that vertical text can be selected, typically a sideways I-beam.

• aliasIndicates an alias of/shortcut to something is to be created. Often rendered as an arrow with a small curved arrow next to it.
• copyIndicates something is to be copied. Often rendered as an arrow with a small plus sign next to it.
• moveIndicates something is to be moved.
• no-dropIndicates that the dragged item cannot be dropped at the current cursor location. Often rendered as a hand or pointer with a small circle with a line through it.
• not-allowedIndicates that the requested action will not be carried out. Often rendered as a circle with a line through it.

• n-resizeSome edge is to be moved. For example, the se-resize cursor is used when the movement starts from the south-east corner of the box.
• ne-resizeAs above
• e-resizeAs above
• se-resizeAs above
• s-resizeAs above
• sw-resizeAs above
• w-resizeAs above
• nw-resizeAs above
• ew-resizeIndicates a bidirectional resize cursor.
• ns-resizeAs above
• nesw-resizeAs above
• nwse-resizeAs above
• col-resizeIndicates that the item/column can be resized horizontally. Often rendered as arrows pointing left and right with a vertical bar separating them.
• row-resizeIndicates that the item/row can be resized vertically. Often rendered as arrows pointing up and down with a horizontal bar separating them.
• all-scrollIndicates that the something can be scrolled in any direction. Often rendered as arrows pointing up, down, left, and right with a dot in the middle.

• zoom-inIndicates that something can be zoomed (magnified) in.
• zoom-outIndicates that something can be zoomed (magnified) out.

• <uri>The user agent retrieves the cursor from the resource designated by the URI. If the user agent cannot handle the first cursor of a list of cursors, it must attempt to handle the second, etc. If the user agent cannot handle any user-defined cursor, it must use the cursor keyword at the end of the list.

Example

<div class="hidden">Please wait ...

   <div class="button">Point at me.</div> 

</div>

.hidden {
   visibility: hidden; 
   width: 125px; 
   text-align: center;
}
.button {
   visibility: visible;
   border: 1px solid orange;
}
.hidden:hover {
   visibility: visible; 
   cursor: wait; 
}

Browser Support

The following table will show you the current browser support for the CSS cursor property.

Desktop
12	1	1	7	1.2

Tablets / Mobile
18	95	14	1	1	4.4

Last updated by CSSPortal on: 1st January 2024