在此页

• 句法
• 用法注意事项
• 形式定义
• 形式句法
• 范例
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

cursor CSS property sets the type of mouse cursor, if any, to show when the mouse pointer is over an element.

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

句法

/* Keyword value */
cursor: pointer;
cursor: auto;
/* URL, with a keyword fallback */
cursor: url(hand.cur), pointer;
/* URL and coordinates, with a keyword fallback */
cursor: url(cursor1.png) 4 12, auto;
cursor: url(cursor2.png) 2 2, pointer;
/* Global values */
cursor: inherit;
cursor: initial;
cursor: unset;
					

cursor property is specified as zero or more <url> values, separated by commas, followed by a single mandatory keyword value . Each <url> should point to an image file. The browser will try to load the first image specified, falling back to the next if it can't, and falling back to the keyword value if no images could be loaded (or if none were specified).

每个 <url> may be optionally followed by a pair of space-separated numbers, which represent <x><y> coordinates. These will set the cursor's hotspot, relative to the top-left corner of the image.

For example, this specifies two images using <url> values, providing <x><y> coordinates for the second one, and falling back to the progress keyword value if neither image can be loaded:

cursor: url(one.svg), url(two.svg) 5 5, progress;
					

值

<url>

A url(…) or a comma separated list url(…), url(…), … , pointing to an image file. More than one <url> may be provided as fallbacks, in case some cursor image types are not supported. A non-URL fallback (one or more of the keyword values) must be at the end of the fallback list. See Using URL values for the cursor property 了解更多细节。

<x> <y>

Optional x- and y-coordinates. Two unitless nonnegative numbers less than 32.

Keyword values

Move your mouse over values to see their live appearance in your browser:

Category	CSS 值	范例	描述
General	auto		The UA will determine the cursor to display based on the current context. E.g., equivalent to text when hovering text.
	default		The platform-dependent default cursor. Typically an arrow.
	none		No cursor is rendered.
Links & status	context-menu		A context menu is available.
	help		Help information is available.
	pointer		The cursor is a pointer that indicates a link. Typically an image of a pointing hand.
	progress		The program is busy in the background, but the user can still interact with the interface (in contrast to wait ).
	wait		The program is busy, and the user can't interact with the interface (in contrast to progress ). Sometimes an image of an hourglass or a watch.
Selection	cell		The table cell or set of cells can be selected.
	crosshair		Cross cursor, often used to indicate selection in a bitmap.
	text		The text can be selected. Typically the shape of an I-beam.
	vertical-text		The vertical text can be selected. Typically the shape of a sideways I-beam.
Drag & drop	alias		An alias or shortcut is to be created.
	copy		Something is to be copied.
	move		Something is to be moved.
	no-drop		An item may not be dropped at the current location. bug 275173 : On Windows and Mac OS X, no-drop 如同 not-allowed .
	not-allowed		The requested action will not be carried out.
	grab		Something can be grabbed (dragged to be moved).
	grabbing		Something is being grabbed (dragged to be moved).
Resizing & scrolling	all-scroll		Something can be scrolled in any direction (panned). bug 275174 : On Windows, all-scroll 如同 move .
	col-resize		The item/column can be resized horizontally. Often rendered as arrows pointing left and right with a vertical bar separating them.
	row-resize		The item/row can be resized vertically. Often rendered as arrows pointing up and down with a horizontal bar separating them.
	n-resize		Some 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. In some environments, an equivalent bidirectional resize cursor is shown. For example, n-resize and s-resize are the same as ns-resize .
	e-resize
	s-resize
	w-resize
	ne-resize
	nw-resize
	se-resize
	sw-resize
	ew-resize		Bidirectional resize cursor.
	ns-resize
	nesw-resize
	nwse-resize
Zooming	zoom-in		Something can be zoomed (magnified) in or out.
	zoom-out

用法注意事项

Although the specification does not define any size limitations for cursor , individual user agents may choose to do so. Cursor changes using images which are outside the size range supported by the browser will generally just be ignored.

检查 浏览器兼容性 table for any notes on cursor size limits.

形式定义

初始值	auto
适用于	所有元素
继承	yes
计算值	as specified, but with <url> values made absolute
动画类型	discrete

形式句法

[ [ <url> [ <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 | grab | grabbing ] ]
					

范例

Setting cursor types

.foo {
  cursor: crosshair;
}
.bar {
  cursor: zoom-in;
}
/* A fallback keyword value is required when using a URL */
.baz {
  cursor: url("hyper.cur"), auto;
}
					

规范

规范	状态	注释
CSS Basic User Interface Module Level 3 The definition of 'cursor' in that specification.	推荐	Addition of several keywords and the positioning syntax for url() .
CSS Level 2 (Revision 1) The definition of 'cursor' in that specification.	推荐	初始定义。

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
cursor	Chrome 完整支持 1	Edge 完整支持 12	Firefox 完整支持 1 注意事项 完整支持 1 注意事项 注意事项 Starting in Firefox 67, the maximum size allowed for custom cursors is 32x32 pixels due to cursors being misused by certain malicious sites.	IE 完整支持 4 注意事项 完整支持 4 注意事项 注意事项 In Internet Explorer 11, when cursor is applied to an element and this element is underneath an open <select> menu and the user hovers over a <select> menu item that's on top of said element, the cursor for said element will be displayed rather than the <select> 's normal cursor. See bug 817822 .	Opera 完整支持 7	Safari 完整支持 1.2	WebView Android 不支持 No	Chrome Android 完整支持 18	Firefox Android 不支持 No	Opera Android 完整支持 14	Safari iOS 完整支持 1	Samsung Internet Android 完整支持 1.0
alias	Chrome 完整支持 1	Edge 完整支持 12	Firefox 完整支持 1.5	IE 完整支持 10	Opera 完整支持 10.6	Safari 完整支持 3	WebView Android 不支持 No	Chrome Android 完整支持 18	Firefox Android 不支持 No	Opera Android 完整支持 14	Safari iOS 完整支持 1	Samsung Internet Android 完整支持 1.0
all-scroll	Chrome 完整支持 1	Edge 完整支持 12	Firefox 完整支持 1.5	IE 完整支持 6	Opera 完整支持 10.6	Safari 完整支持 3	WebView Android 不支持 No	Chrome Android 完整支持 18	Firefox Android 不支持 No	Opera Android 完整支持 14	Safari iOS 完整支持 1	Samsung Internet Android 完整支持 1.0
auto	Chrome 完整支持 1	Edge 完整支持 12	Firefox 完整支持 1	IE 完整支持 4	Opera 完整支持 7	Safari 完整支持 1.2	WebView Android 不支持 No	Chrome Android 完整支持 18	Firefox Android 不支持 No	Opera Android 完整支持 14	Safari iOS 完整支持 1	Samsung Internet Android 完整支持 1.0
Bidirectional resize cursors ( ew-resize , nesw-resize , ns-resize ，和 nwse-resize )	Chrome 完整支持 1	Edge 完整支持 12	Firefox 完整支持 1.5	IE 完整支持 10	Opera 完整支持 10.6	Safari 完整支持 3	WebView Android 不支持 No	Chrome Android 完整支持 18	Firefox Android 不支持 No	Opera Android 完整支持 14	Safari iOS 完整支持 1	Samsung Internet Android 完整支持 1.0
cell	Chrome 完整支持 1	Edge 完整支持 12	Firefox 完整支持 1.5	IE 完整支持 10	Opera 完整支持 10.6	Safari 完整支持 3	WebView Android 不支持 No	Chrome Android 完整支持 18	Firefox Android 不支持 No	Opera Android 完整支持 14	Safari iOS 完整支持 1	Samsung Internet Android 完整支持 1.0
col-resize	Chrome 完整支持 1	Edge 完整支持 12	Firefox 完整支持 1.5	IE 完整支持 6	Opera 完整支持 10.6	Safari 完整支持 3	WebView Android 不支持 No	Chrome Android 完整支持 18	Firefox Android 不支持 No	Opera Android 完整支持 14	Safari iOS 完整支持 1	Samsung Internet Android 完整支持 1.0
context-menu	Chrome 完整支持 1 注意事项 完整支持 1 注意事项 注意事项 This cursor is only supported on macOS and Linux.	Edge 完整支持 12	Firefox 完整支持 1.5 注意事项 完整支持 1.5 注意事项 注意事项 This cursor is only supported on macOS and Linux.	IE 完整支持 10	Opera 完整支持 10.6	Safari 完整支持 3	WebView Android 不支持 No	Chrome Android 完整支持 18 注意事项 完整支持 18 注意事项 注意事项 This cursor is only supported on macOS and Linux.	Firefox Android 不支持 No	Opera Android 完整支持 14 注意事项 完整支持 14 注意事项 注意事项 This cursor is only supported on macOS and Linux.	Safari iOS 完整支持 1	Samsung Internet Android 完整支持 1.0 注意事项 完整支持 1.0 注意事项 注意事项 This cursor is only supported on macOS and Linux.
copy	Chrome 完整支持 1	Edge 完整支持 12	Firefox 完整支持 1.5	IE 完整支持 10	Opera 完整支持 10.6	Safari 完整支持 3	WebView Android 不支持 No	Chrome Android 完整支持 18	Firefox Android 不支持 No	Opera Android 完整支持 14	Safari iOS 完整支持 1	Samsung Internet Android 完整支持 1.0
crosshair	Chrome 完整支持 1	Edge 完整支持 12	Firefox 完整支持 1	IE 完整支持 4	Opera 完整支持 7	Safari 完整支持 1.2	WebView Android 不支持 No	Chrome Android 完整支持 18	Firefox Android 不支持 No	Opera Android 完整支持 14	Safari iOS 完整支持 1	Samsung Internet Android 完整支持 1.0
default	Chrome 完整支持 1	Edge 完整支持 12	Firefox 完整支持 1	IE 完整支持 4	Opera 完整支持 7	Safari 完整支持 1.2	WebView Android 不支持 No	Chrome Android 完整支持 18	Firefox Android 不支持 No	Opera Android 完整支持 14	Safari iOS 完整支持 1	Samsung Internet Android 完整支持 1.0
Grab cursors ( grab and grabbing )	Chrome 完整支持 68 注意事项 完整支持 68 注意事项 注意事项 Chrome also continues to support the prefixed versions. 完整支持 1 Prefixed 注意事项 Prefixed Implemented with the vendor prefix: -webkit- 注意事项 Chrome 22 added Windows support.	Edge 完整支持 14	Firefox 完整支持 27 完整支持 27 完整支持 1.5 Prefixed Prefixed Implemented with the vendor prefix: -moz-	IE 不支持 No	Opera 完整支持 55 注意事项 完整支持 55 注意事项 注意事项 Opera also continues to support the prefixed versions. 完整支持 15 Prefixed 注意事项 Prefixed Implemented with the vendor prefix: -webkit- 注意事项 Opera 22 added Windows support.	Safari 完整支持 11	WebView Android 不支持 No	Chrome Android 完整支持 68 注意事项 完整支持 68 注意事项 注意事项 Chrome also continues to support the prefixed versions. 完整支持 18 Prefixed 注意事项 Prefixed Implemented with the vendor prefix: -webkit- 注意事项 Chrome 22 added Windows support.	Firefox Android 不支持 No	Opera Android 完整支持 48 注意事项 完整支持 48 注意事项 注意事项 Opera also continues to support the prefixed versions. 完整支持 14 Prefixed 注意事项 Prefixed Implemented with the vendor prefix: -webkit- 注意事项 Opera 22 added Windows support.	Safari iOS 完整支持 1	Samsung Internet Android 完整支持 10.0
help	Chrome 完整支持 1	Edge 完整支持 12	Firefox 完整支持 1	IE 完整支持 4	Opera 完整支持 7	Safari 完整支持 1.2	WebView Android 不支持 No	Chrome Android 完整支持 18	Firefox Android 不支持 No	Opera Android 完整支持 14	Safari iOS 完整支持 1	Samsung Internet Android 完整支持 1.0
inherit	Chrome 完整支持 1	Edge 完整支持 12	Firefox 完整支持 1	IE 完整支持 8	Opera 完整支持 9	Safari 完整支持 1.2	WebView Android 不支持 No	Chrome Android 完整支持 18	Firefox Android 不支持 No	Opera Android 完整支持 14	Safari iOS 完整支持 1	Samsung Internet Android 完整支持 1.0
move	Chrome 完整支持 1	Edge 完整支持 12	Firefox 完整支持 1	IE 完整支持 4	Opera 完整支持 7	Safari 完整支持 1.2	WebView Android 不支持 No	Chrome Android 完整支持 18	Firefox Android 不支持 No	Opera Android 完整支持 14	Safari iOS 完整支持 1	Samsung Internet Android 完整支持 1.0
no-drop	Chrome 完整支持 1	Edge 完整支持 12	Firefox 完整支持 1.5	IE 完整支持 6	Opera 完整支持 10.6	Safari 完整支持 3	WebView Android 不支持 No	Chrome Android 完整支持 18	Firefox Android 不支持 No	Opera Android 完整支持 14	Safari iOS 完整支持 1	Samsung Internet Android 完整支持 1.0
none	Chrome 完整支持 5	Edge 完整支持 12	Firefox 完整支持 3	IE 完整支持 9	Opera 完整支持 15	Safari 完整支持 5	WebView Android 不支持 No	Chrome Android 完整支持 18	Firefox Android 不支持 No	Opera Android 完整支持 14	Safari iOS 完整支持 4.2	Samsung Internet Android 完整支持 1.0
not-allowed	Chrome 完整支持 1	Edge 完整支持 12	Firefox 完整支持 1.5	IE 完整支持 6	Opera 完整支持 10.6	Safari 完整支持 3	WebView Android 不支持 No	Chrome Android 完整支持 18	Firefox Android 不支持 No	Opera Android 完整支持 14	Safari iOS 完整支持 1	Samsung Internet Android 完整支持 1.0
pointer	Chrome 完整支持 1	Edge 完整支持 12	Firefox 完整支持 1	IE 完整支持 6	Opera 完整支持 7	Safari 完整支持 1.2	WebView Android 不支持 No	Chrome Android 完整支持 18	Firefox Android 不支持 No	Opera Android 完整支持 14	Safari iOS 完整支持 1	Samsung Internet Android 完整支持 1.0
progress	Chrome 完整支持 1	Edge 完整支持 12	Firefox 完整支持 1	IE 完整支持 6	Opera 完整支持 7	Safari 完整支持 1.2	WebView Android 不支持 No	Chrome Android 完整支持 18	Firefox Android 不支持 No	Opera Android 完整支持 14	Safari iOS 完整支持 1	Samsung Internet Android 完整支持 1.0
row-resize	Chrome 完整支持 1	Edge 完整支持 12	Firefox 完整支持 1.5	IE 完整支持 6	Opera 完整支持 10.6	Safari 完整支持 3	WebView Android 不支持 No	Chrome Android 完整支持 18	Firefox Android 不支持 No	Opera Android 完整支持 14	Safari iOS 完整支持 1	Samsung Internet Android 完整支持 1.0
text	Chrome 完整支持 1	Edge 完整支持 12	Firefox 完整支持 1	IE 完整支持 4	Opera 完整支持 7	Safari 完整支持 1.2	WebView Android 不支持 No	Chrome Android 完整支持 18	Firefox Android 不支持 No	Opera Android 完整支持 14	Safari iOS 完整支持 1	Samsung Internet Android 完整支持 1.0
Unidirectional resize cursors ( n-resize , e-resize , s-resize , w-resize , ne-resize , nw-resize , se-resize ，和 sw-resize )	Chrome 完整支持 1	Edge 完整支持 12	Firefox 完整支持 1	IE 完整支持 4	Opera 完整支持 7	Safari 完整支持 1.2	WebView Android 不支持 No	Chrome Android 完整支持 18	Firefox Android 不支持 No	Opera Android 完整支持 14	Safari iOS 完整支持 1	Samsung Internet Android 完整支持 1.0
url()	Chrome 完整支持 1	Edge 完整支持 12	Firefox 完整支持 1.5 注意事项 完整支持 1.5 注意事项 注意事项 Firefox 4 added macOS support.	IE 完整支持 6	Opera 完整支持 15	Safari 完整支持 3	WebView Android 不支持 No	Chrome Android 完整支持 18	Firefox Android 不支持 No	Opera Android 完整支持 14	Safari iOS 完整支持 1	Samsung Internet Android 完整支持 1.0
url() positioning syntax	Chrome 完整支持 1	Edge 完整支持 79	Firefox 完整支持 1.5 注意事项 完整支持 1.5 注意事项 注意事项 Firefox 4 added macOS support.	IE 不支持 No	Opera 完整支持 15	Safari 完整支持 3	WebView Android 不支持 No	Chrome Android 完整支持 18	Firefox Android 不支持 No	Opera Android 完整支持 14	Safari iOS 完整支持 1	Samsung Internet Android 完整支持 1.0
vertical-text	Chrome 完整支持 1	Edge 完整支持 12	Firefox 完整支持 1.5	IE 不支持 No	Opera 完整支持 10.6	Safari 完整支持 3	WebView Android 不支持 No	Chrome Android 完整支持 18	Firefox Android 不支持 No	Opera Android 完整支持 14	Safari iOS 完整支持 1	Samsung Internet Android 完整支持 1.0
wait	Chrome 完整支持 1	Edge 完整支持 12	Firefox 完整支持 1	IE 完整支持 4	Opera 完整支持 7	Safari 完整支持 1.2	WebView Android 不支持 No	Chrome Android 完整支持 18	Firefox Android 不支持 No	Opera Android 完整支持 14	Safari iOS 完整支持 1	Samsung Internet Android 完整支持 1.0
Zoom cursors ( zoom-in and zoom-out )	Chrome 完整支持 37	Edge 完整支持 12	Firefox 完整支持 24 完整支持 24 完整支持 1 Prefixed Prefixed Implemented with the vendor prefix: -moz-	IE 不支持 No	Opera 完整支持 24 完整支持 24 不支持 15 — 23 Prefixed Prefixed Implemented with the vendor prefix: -webkit-	Safari 完整支持 9	WebView Android 不支持 No	Chrome Android 完整支持 37	Firefox Android 不支持 No	Opera Android 完整支持 24 完整支持 24 不支持 14 — 24 Prefixed Prefixed Implemented with the vendor prefix: -webkit-	Safari iOS 完整支持 1	Samsung Internet Android 完整支持 3.0

图例

完整支持

完整支持

不支持

不支持

见实现注意事项。

见实现注意事项。

要求使用供应商前缀或不同名称。

要求使用供应商前缀或不同名称。

另请参阅

• Using URL values for the cursor property
• pointer-events
• url() function

元数据

• 最后修改： Aug 3, 2020

相关话题

1. CSS
2. CSS 参考
3. CSS Basic User Interface
4. 指南

   1. Using URL values for the cursor property
5. 特性

   1. appearance (-moz-appearance, -webkit-appearance)
   2. aspect-ratio
   3. box-sizing
   4. caret-color
   5. cursor
   6. ime-mode
   7. outline
   8. outline-color
   9. outline-offset
   10. outline-style
   11. outline-width
   12. resize
   13. text-overflow
   14. user-select