Windows apps
Collapse the table of content
Expand the table of content

cursor property

Sets or retrieves the type of cursor to display as the mouse pointer moves over the object.

This property is not supported for Windows Store apps using JavaScript.

CSS 2.1, Section 18.1

Syntax

cursor: all-scroll | auto | col-resize | crosshair | default | hand | help | move | no-drop | not-allowed | pointer | progress | row-resize | text | url(uri) | vertical-text | wait | *-resize

Property values

A variable of type String that specifies or receives one or more of the following possible values, separated by commas.

all-scroll

Arrows pointing up, down, left, and right with a dot in the middle, indicating that the page can be scrolled in any direction.

auto

Default. Browser determines which cursor to display based on the current context.

col-resize

Arrows pointing left and right with a vertical bar separating them, indicating that the item/column can be resized horizontally.

crosshair

Simple cross hair.

default

Platform-dependent default cursor; usually an arrow.

hand

Hand with the first finger pointing up, as when the user moves the pointer over a link.

help

Arrow with question mark, indicating help is available.

move

Crossed arrows, indicating something is to be moved.

no-drop

Hand with a small circle with a line through it, indicating that the dragged item cannot be dropped at the current cursor location.

not-allowed

Circle with a line through it, indicating that the requested action will not be carried out.

pointer

Hand with the first finger pointing up, as when the user moves the pointer over a link. Identical to hand.

progress

Arrow with an hourglass next to it, indicating that a process is running in the background. User interaction with the page is unaffected.

row-resize

Arrows pointing up and down with a horizontal bar separating them, indicating that the item/row can be resized vertically.

text

Editable text; usually an I-bar.

url(uri)

Cursor is defined by the author, using a custom URI, such as url('mycursor.cur'). Cursors of type .CUR and .ANI are the only supported cursor types.

vertical-text

Editable vertical text, indicated by a horizontal I-bar.

wait

Hourglass or watch, indicating that the program is busy and the user should wait.

*-resize

Arrows, indicating an edge is to be moved; the asterisk (*) can be N, NE, NW, S, SE, SW, E, or W—each representing a compass direction.

CSS information

Applies ToAll elements
Mediavisual
Inherited1
Initial Value

Standards information

Remarks

The property handles a comma-separated list of cursor values. If the user agent does not understand or cannot find the first cursor specified, it looks at the next cursor in the comma-separated list and continues until it finds a usable cursor. If the user agent does not understand any of the cursors that are listed, the cursor does not change.

Cursors support many shape, color and movement combinations. This permits you to subtitute the default cursors with your preferred design. For instance, you may want your company logo to display as the "progress" cursor; or your country's flag waving in the wind to display as the "wait" cursor.

Cursors have been the subject of security bulletins and updates. If your custom cursors are not behaving as expected, examine the security settings for your browser along with your cursors. This is a common issue with animated cursors. For an example, refer to TechNet Security Resources and search for "Microsoft Security Bulletin MS05-002".

Examples

The following examples use the cursor attribute and the cursor property to change the cursor as it passes over an object.

This example uses a call to an embedded (global) style sheet to set the cursor to hand as the cursor passes over all paragraphs.

Code example: http://samples.msdn.microsoft.com/workshop/samples/author/dhtml/refs/cursor_h.htm


<STYLE>
    P { cursor : hand; }
</STYLE>

This example uses inline scripting to set the cursor to hand as the cursor passes over the paragraph.

Code example: http://samples.msdn.microsoft.com/workshop/samples/author/dhtml/refs/cursor_s.htm


<P onmouseover="this.style.cursor='hand'">

This example demonstrates setting a custom cursor, by using the url(uri) value.

Code example: http://samples.msdn.microsoft.com/workshop/samples/author/dhtml/refs/cursor_c.htm


<STYLE>
oBox.style.cursor = "url(" + Some_Uniform_Resource_Identifier + ")";
</STYLE>

Here is a sample of all currently supported cursors, as of a Windows Store app using JavaScript.

Code example: http://samples.msdn.microsoft.com/workshop/samples/author/dhtml/refs/cursor_a.htm

See also

CSSStyleDeclaration
currentStyle
defaults
runtimeStyle
style

 

 

Build date: 10/15/2012

Community Additions

Show:
© 2016 Microsoft