Skip to content
全部文档

cursor

用于控制鼠标悬停在元素上时光标样式的工具类。

快速参考

属性
cursor-autocursor: auto;
cursor-defaultcursor: default;
cursor-pointercursor: pointer;
cursor-waitcursor: wait;
cursor-textcursor: text;
cursor-movecursor: move;
cursor-helpcursor: help;
cursor-not-allowedcursor: not-allowed;
cursor-nonecursor: none;
cursor-context-menucursor: context-menu;
cursor-progresscursor: progress;
cursor-cellcursor: cell;
cursor-crosshaircursor: crosshair;
cursor-vertical-textcursor: vertical-text;
cursor-aliascursor: alias;
cursor-copycursor: copy;
cursor-no-dropcursor: no-drop;
cursor-grabcursor: grab;
cursor-grabbingcursor: grabbing;
cursor-all-scrollcursor: all-scroll;
cursor-col-resizecursor: col-resize;
cursor-row-resizecursor: row-resize;
cursor-n-resizecursor: n-resize;
cursor-e-resizecursor: e-resize;
cursor-s-resizecursor: s-resize;
cursor-w-resizecursor: w-resize;
cursor-ne-resizecursor: ne-resize;
cursor-nw-resizecursor: nw-resize;
cursor-se-resizecursor: se-resize;
cursor-sw-resizecursor: sw-resize;
cursor-ew-resizecursor: ew-resize;
cursor-ns-resizecursor: ns-resize;
cursor-nesw-resizecursor: nesw-resize;
cursor-nwse-resizecursor: nwse-resize;
cursor-zoom-incursor: zoom-in;
cursor-zoom-outcursor: zoom-out;
cursor-(<custom-property>)cursor: var(<custom-property>);
cursor-[<value>]cursor: <value>;

示例

基础示例

使用 cursor-pointercursor-grab 等工具类,控制鼠标悬停在元素上时显示的光标:

html
<!-- [!code classes:cursor-pointer,cursor-progress,cursor-not-allowed] -->
<button class="cursor-pointer ...">Submit</button>
<button class="cursor-progress ...">Saving...</button>
<button class="cursor-not-allowed ..." disabled>Confirm</button>

使用自定义值

使用 cursor-[<value>] 等工具类,根据完全自定义的值设置光标:

html
<button class="cursor-[url(hand.cur),_pointer] ...">
 <!-- ... -->
</button>

对于 CSS 变量,也可以使用 cursor-(<custom-property>) 语法:

html
<button class="cursor-(--my-cursor) ...">
 <!-- ... -->
</button>

这只是 cursor-[var(<custom-property>)] 的简写,会自动为你加上 var() 函数。

响应式设计

使用 md: 等断点变体为 cursor 工具类添加前缀,使其仅在中等及以上屏幕尺寸生效:

html
<button class="cursor-not-allowed md:cursor-auto ...">
 <!-- ... -->
</button>

变体文档 中了解如何使用变体。

文档译文以 MIT 协议授权;原文版权归 Tailwind Labs。湘ICP备2026005453号-2