Lzh on GitHub

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 等工具类来控制鼠标悬停在元素上时显示的光标:

将鼠标悬停在每个按钮上以查看光标变化

<button class="cursor-pointer ...">Submit</button>
<button class="cursor-progress ...">Saving...</button>
<button class="cursor-not-allowed ..." disabled>Confirm</button>

使用自定义值

使用 cursor-[<value>] 语法可以根据完全自定义的值来设置光标

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

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

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

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

响应式设计

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

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

变体文档 中了解更多关于使用变体的信息。