核心語法
.element {
cursor: value; /* 關鍵字值 */
cursor: url('path.cur'), auto; /* 自定義圖標 + 回退值 */
cursor: url('icon.png') 16 16, pointer; /* 熱點座標 (x y) + 回退 */
}
熱點座標:相對圖標左上角 (0,0),單位像素,指定「點擊生效點」位置。
標準關鍵字值分類速查表(MDN 标准)
1. 通用交互
| 值 | 外觀 | 語義/適用場景 | 備註 |
auto | 瀏覽器自動 | 默認,根據上下文自動切換 | 文本上顯示 text,鏈接上顯示 pointer |
default | 箭頭 | 默認箭頭,明確重置 | 常用於重置繼承的 cursor |
pointer | 手型 | 可點擊元素(鏈接、按鈕、卡片) | IE5 只認 hand,現已棄用 |
text | 工字型 (I-beam) | 可編輯/可選中文本 | 輸入框、文章正文 |
vertical-text | 橫向 I-beam | 垂直排版文本編輯 | CSS3 UI |
none | 隱藏 | 無光標(Canvas 遊戲、全屏演示) | 謹慎使用,影響可用性 |
context-menu | 箭頭+菜單圖標 | 右鍵菜單可用 | 較少見 |
2. 狀態反饋
| 值 | 外觀 | 語義 |
wait | 沙漏/轉圈 | 程序忙碌,用戶請等待(異步請求中) |
progress | 箭頭+沙漏 | 後台處理中,用戶仍可操作界面其他部分 |
help | 箭頭+問號 | 可用幫助信息(工具提示觸發區) |
not-allowed | 禁止符 (⛔) | 禁止操作(禁用按鈕、拖拽不可放區域) |
no-drop | 禁止符 (🚫) | 拖拽時不可放置 |
3. 調整大小/移動(Resize/Move)
| 值 | 外觀 | 方向語義 |
move | 十字箭頭 | 可移動對象(拖拽排序、視窗拖動) |
grab | 張開手 | 可抓取拖拽(地圖、畫布) |
grabbing | 握緊手 | 正在拖拽中 |
n-resize / s-resize | 雙向垂直箭頭 | 上/下邊緣調整高度 |
e-resize / w-resize | 雙向水平箭頭 | 右/左邊緣調整寬度 |
ne-resize / nw-resize / se-resize / sw-resize | 雙向斜向箭頭 | 四角調整寬高 |
ew-resize / ns-resize / nesw-resize / nwse-resize | 雙向箭頭 | 雙向同時調整(現代語法,語義更清晰) |
col-resize / row-resize | 雙向箭頭+分隔線 | 表格列/行調整寬高 |
all-scroll | 四向箭頭+中心點 | 任意方向滾動/平移 |
4. 放大/縮小/複製
| 值 | 外觀 | 場景 |
zoom-in | 放大鏡+ | 可放大查看(圖片畫廊) |
zoom-out | 放大鏡- | 可縮小查看 |
copy | 箭頭+加號 | 拖拽複製(按住 Alt/Option 時) |
alias | 箭頭+曲線箭頭 | 創建快捷方式/別名 |
cell | 粗十字 | 表格儲存格選擇 |
crosshair | 十字準星 | 精確選點(繪圖、標註) |
自定義光標最佳實踐
1. 格式與尺寸限制
- 格式:.cur (Windows 靜態)、.ani (Windows 動畫)、.png/.svg (現代瀏覽器)
- 尺寸:32×32 px 為標準,最大 128×128(超過會被忽略或縮放模糊)
- 熱點:.cur/.ani 內嵌熱點;png/svg 需在 CSS 指定
url('icon.png') 16 16
2. 回退鏈:永遠提供通用回退值
.custom-cursor {
cursor: url('custom.cur') 8 8, /* 首選:自定義 .cur 含熱點 */
url('custom.png') 16 16, /* 次選:png 手動指定熱點 */
url('fallback.svg') 16 16, /* 兜底:svg 矢量不失真 */
pointer; /* 終極回退:關鍵字值 */
}
3. 動畫光標
.ani 格式僅 Windows/IE/Edge 早期支持。現代方案:JS 滑鼠跟隨 + Canvas/WebGL 渲染動畫,完全跨平台、可控性極強(如粒子跟隨、磁性吸附)。
無障礙 (a11y) 與 UX 原則
- 語義一致性:可點擊元素必須
pointer,可編輯文本 text,禁用狀態 not-allowed。違背用戶心智模型會造成困惑。
- 不依賴光標傳達關鍵信息:螢幕閱讀器用戶無法感知光標變化,關鍵狀態(禁用、載入中)必須有視覺(顏色、圖標)+ 語義 (aria-disabled, aria-busy) 雙重保障。
- 觸屏設備無光標:
@media (pointer: coarse) 下光標樣式無意義,交互反饋靠 :active、:focus-visible、觸覺反饋。
- 性能:大量元素頻繁切換 cursor 可能觸發樣式重算,必要時用事件委託或 CSS 變量統一控制。
實戰片段:拖拽上傳區域光標狀態機
.drop-zone {
cursor: copy; /* 預設:可複製文件進入 */
}
.drop-zone.drag-over {
cursor: drop; /* CSS3 UI 草案值,現代瀏覽器支援有限 */
/* 替代方案:cursor: copy + 視覺高亮邊框 */
}
.drop-zone.drag-over.invalid-type {
cursor: not-allowed; /* 文件類型不匹配 */
}
.drop-zone.uploading {
cursor: progress; /* 上傳中,仍可操作其他區域 */
}
「光標是用戶與界面對話的第一語言,說準了,用戶就不需要思考。」