курсор
Свойство cursor CSS задаёт курсор мыши, если таковой требуется, для отображения при наведении указателя мыши на элемент.
Настройка курсора должна информировать пользователей о действиях, которые можно выполнить с помощью мыши в текущем месте, включая: выделение текста, активацию всплывающих или контекстных меню, копирование содержимого, изменение размера таблиц и так далее. Можно указать либо тип курсора с помощью ключевого слова, либо загрузить конкретный значок для использования (с необязательными резервными изображениями и обязательным ключевым словом в качестве окончательного резервного варианта).
Попробовать
Синтаксис
/* Keyword value */ cursor: auto; cursor: pointer; /* … */ cursor: zoom-out; /* URL with mandatory keyword fallback */ cursor: url(hand.cur), pointer; /* URL and coordinates, with mandatory keyword fallback */ cursor: url(cursor_1.png) 4 12, auto; cursor: url(cursor_2.png) 2 2, pointer; /* URLs and fallback URLs (some with coordinates), with mandatory keyword fallback */ cursor: url(cursor_1.svg) 4 5, url(cursor_2.svg), /* …, */ url(cursor_n.cur) 5 5, progress; /* Global values */ cursor: inherit; cursor: initial; cursor: revert; cursor: revert-layer; cursor: unset;
Свойство cursor задаётся как ноль или более <url> значений, разделённых запятыми, за которыми следует единственное обязательное ключевое значение. Каждое <url> должно указывать на файл изображения. Браузер попытается загрузить первое указанное изображение, перейдя к следующему, если первое не удастся, и перейдя к значению ключевого слова, если ни одно из изображений не удалось загрузить (или если ни одно не было указано).
Каждое <url> может быть дополнительно снабжено парой разделённых пробелом чисел, которые устанавливают координаты <x> и <y> «точки привязки» курсора относительно верхнего левого угла изображения.
Значения
-
<url>Необязательно -
URL-адрес или список URL-адресов, разделённых запятыми
url(), url(), …, указывающий на файл изображения. Можно указать несколько значений<url>в качестве резервных вариантов, на случай если некоторые типы изображений курсора не поддерживаются. Значение, не являющееся URL-адресом (одно или несколько ключевых значений) должно находиться в конце списка резервных вариантов. -
<x>,<y>Необязательно -
Необязательные координаты x и y, указывающие «точку привязки» курсора; точное положение внутри курсора, на которое указывается.
Числа указаны в единицах пикселей изображения. Они относительны к верхнему левому углу изображения, что соответствует
0 0, и ограничены границами изображения курсора. Если эти значения не указаны, они могут быть взяты из файла самого, а в противном случае по умолчанию будут установлены в верхнем левом углу изображения. keyword-
Необходимо указать ключевое значение, указывающее тип курсора для использования или резервный курсор для использования, если все указанные значки не удаётся загрузить.
Доступные ключевые слова перечислены в таблице ниже. Помимо
none, что означает отсутствие курсора, имеется изображение, демонстрирующее, как отображались курсоры ранее. Вы можете навести курсор мыши на строки таблицы, чтобы увидеть эффект различных значений ключевых слов курсора в вашем браузере сегодня.Категория Ключевое слово Пример Описание Общие autoБраузер определит курсор для отображения на основе текущего контекста. Например, эквивалентно textпри наведении на текст.defaultКурсор по умолчанию, зависящий от платформы. Обычно стрелка. noneКурсор не отображается. Ссылки & статус context-menuДоступно контекстное меню. helpДоступна справочная информация. pointerКурсор — указатель, указывающий на ссылку. Обычно изображение руки, указывающей. progressПрограмма выполняет фоновые задачи, но пользователь по-прежнему может взаимодействовать с интерфейсом (в отличие от wait).waitПрограмма выполняет задачи, и пользователь не может взаимодействовать с интерфейсом (в отличие от progress). Иногда изображение песочных часов или часов.Выделение cellЯчейка или набор ячеек таблицы могут быть выделены. crosshairПерекрестный курсор, часто используется для обозначения выделения в растровом изображении. textТекст можно выделить. Обычно имеет форму I-луча. vertical-textВертикальный текст можно выделить. Обычно имеет форму I-луча, повернутого на бок. Перетаскивание aliasСоздается псевдоним или ярлык. copyНечто копируется. moveНечто перемещается. no-dropЭлемент не может быть помещён в текущее место.
Ошибка Firefox 275173: В Windows и macOSno-dropэквивалентноnot-allowed.not-allowedЗапрошенное действие не будет выполнено. grabНечто можно взять (перетащить для перемещения). grabbingНечто берётся (перетаскивается для перемещения). Изменение размера & прокрутка all-scrollНечто можно прокрутить в любом направлении (перемещать).
Ошибка Firefox 275174: В Windowsall-scrollэквивалентноmove.col-resizeЭлемент/колонка может быть изменена по горизонтали. Часто отображается как стрелки, указывающие влево и вправо, разделённые вертикальной чертой. row-resizeЭлемент/строка может быть изменена по вертикали. Часто отображается как стрелки, указывающие вверх и вниз, разделённые горизонтальной чертой. n-resizeНекоторая граница должна быть перемещена. Например, курсор se-resizeиспользуется, когда перемещение начинается из юго-восточного угла рамки.
В некоторых средах отображается эквивалентный курсор двунаправленного изменения размера. Например,n-resizeиs-resizeэквивалентныns-resize.e-resizes-resizew-resizene-resizenw-resizese-resizesw-resizeew-resizeКурсор двунаправленного изменения размера. ns-resizenesw-resizenwse-resizeМасштабирование zoom-inНечто можно увеличить или уменьшить.
zoom-out
Формальное определение
| Начальное значение | auto |
|---|---|
| Применимо к | все элементы |
| Наследуется | да |
| Вычисленное значение | как указано, но значения <url> сделаны абсолютными |
| Тип анимации | дискретный |
Формальный синтаксис
cursor =
[ [ <url> | <url-set> ] [ <x> <y> ]? ]#? [ auto | default | none | context-menu | help | pointer | progress | wait | cell | crosshair | text | vertical-text | alias | copy | move | no-drop | not-allowed | grab | grabbing | 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 ]
<url> =
<url()> |
<src()>
<x> =
x
<y> =
y
<url()> =
url( <string> <url-modifier>* ) |
<url-token>
<src()> =
src( <string> <url-modifier>* )
Примечания по использованию
Пределы размера значка
Хотя спецификация не ограничивает размер изображения cursor, пользовательские агенты обычно ограничивают их, чтобы избежать потенциального злоупотребления. Например, в Firefox и Chromium изображения курсора по умолчанию ограничены 128x128 пикселями, но рекомендуется ограничить размер изображения курсора 32x32 пикселями. Изменения курсора с использованием изображений, размер которых превышает максимальный размер, поддерживаемый пользовательским агентом, обычно игнорируются.
Поддерживаемые форматы файлов изображений
Пользовательские агенты обязаны поддерживать файлы PNG, файлы SVG v1.1 в защищенном статическом режиме, содержащие естественный размер, и любые другие форматы файлов изображений без анимации, которые они поддерживают для изображений в других свойствах. Веб-браузеры настольных компьютеров также в основном поддерживают формат .cur.
Спецификация также указывает, что пользовательские агенты должны также поддерживать файлы SVG v1.1 в защищенном анимированном режиме, содержащие естественный размер, а также любые другие форматы файлов анимированных изображений, которые они поддерживают для изображений в других свойствах. Пользовательские агенты могут поддерживать как статические, так и анимированные изображения SVG, которые не содержат естественного размера.
iPadOS
iPadOS поддерживает указательные устройства, такие как трекпады и мыши. По умолчанию курсор iPad отображается как круг, и единственное поддерживаемое значение, которое изменит внешний вид указателя, — это text.
Другие заметки
Изменения курсора, которые пересекают области панели инструментов, обычно блокируются, чтобы избежать подделки.
Примеры
Установка типов курсора
.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 Level 4 # cursor |
Совместимость с браузерами
| Настольные | Мобильные | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | WebView Android | |
cursor |
1 | 12 | 1Начиная с Firefox 67, максимальный размер пользовательских курсоров ограничен 32x32 пикселями из-за злоупотребления курсорами некоторыми вредоносными сайтами. |
7 | 1.2 | 18 | 95 | 14 | 13.4["Этот свойство поддерживается только на iPad с внешним указательным устройством.", "Неподдерживаемые значения используютdefault курсор в качестве резервного варианта."] |
1.0 | 4.4 |
|---|---|---|---|---|---|---|---|---|---|---|---|
alias |
1 | 12 | 1.5 | 10.6 | 3 | 18 | 95 | 14 | НетЕсли это значение используется, iPad отобразитdefault курсор вместо этого. |
1.0 | 4.4 |
all-scroll |
1 | 12 | 1.5 | 10.6 | 3 | 18 | 95 | 14 | НетЕсли это значение используется, iPad отобразитdefault курсор вместо этого. |
1.0 | 4.4 |
auto |
1 | 12 | 1 | 7 | 1.2 | 18 | 95 | 14 | 13.4 | 1.0 | 4.4 |
cell |
1 | 12 | 1.5 | 10.6 | 3 | 18 | 95 | 14 | 13.4 | 1.0 | 4.4 |
col-resize |
1 | 12 | 1.5 | 10.6 | 3 | 18 | 95 | 14 | НетЕсли это значение используется, iPad отобразитdefault курсор вместо этого. |
1.0 | 4.4 |
context-menu |
1Этот курсор поддерживается только в macOS и Linux. |
12 | 1.5Этот курсор поддерживается только в macOS и Linux. |
10.6 | 3 | 18Этот курсор поддерживается только в macOS и Linux. |
95 | 14Этот курсор поддерживается только в macOS и Linux. |
НетЕсли это значение используется, iPad отобразитdefault курсор вместо этого. |
1.0Этот курсор поддерживается только в macOS и Linux. |
4.4Этот курсор поддерживается только в macOS и Linux. |
copy |
1 | 12 | 1.5 | 10.6 | 3 | 18 | 95 | 14 | НетЕсли это значение используется, iPad отобразитdefault курсор вместо этого. |
1.0 | 4.4 |
crosshair |
1 | 12 | 1 | 7 | 1.2 | 18 | 95 | 14 | НетЕсли это значение используется, iPad отобразитdefault курсор вместо этого. |
1.0 | 4.4 |
default |
1 | 12 | 1 | 7 | 1.2 | 18 | 95 | 14 | НетЕсли это значение используется, iPad отобразитdefault курсор вместо этого. |
1.0 | 4.4 |
e-resize |
1 | 12 | 1 | 7 | 1.2 | 18 | 95 | 14 | НетЕсли это значение используется, iPad отобразитdefault курсор вместо этого. |
1.0 | 4.4 |
ew-resize |
1 | 12 | 1.5 | 10.6 | 3 | 18 | 95 | 14 | НетЕсли это значение используется, iPad отобразитdefault курсор вместо этого. |
1.0 | 4.4 |
grab |
68Chrome также продолжает поддерживать префиксные версии.1Chrome 22 добавил поддержку Windows. |
14 | 271.5 |
55Opera также продолжает поддерживать префиксные версии.15Opera 22 добавил поддержку Windows. |
114 |
68Chrome также продолжает поддерживать префиксные версии.18Chrome 22 добавил поддержку Windows. |
95 |
48Opera также продолжает поддерживать префиксные версии.14Opera 22 добавил поддержку Windows. |
НетЕсли это значение используется, iPad отобразитdefault курсор вместо этого. |
10.01.0 |
68Chrome также продолжает поддерживать префиксные версии.4.4Chrome 22 добавил поддержку Windows. |
grabbing |
≤83 | 83 | ≤72 | 69 | ≤13.1 | 83 | 95 | 59 | НетЕсли это значение используется, iPad отобразитdefault курсор вместо этого. |
13.0 | 83 |
help |
1 | 12 | 1 | 7 | 1.2 | 18 | 95 | 14 | НетЕсли это значение используется, iPad отобразитdefault курсор вместо этого. |
1.0 | 4.4 |
move |
1 | 12 | 1 | 7 | 1.2 | 18 | 95 | 14 | НетЕсли это значение используется, iPad отобразитdefault курсор вместо этого. |
1.0 | 4.4 |
n-resize |
1 | 12 | 1 | 7 | 1.2 | 18 | 95 | 14 | НетЕсли это значение используется, iPad отобразитdefault курсор вместо этого. |
1.0 | 4.4 |
ne-resize |
1 | 12 | 1 | 7 | 1.2 | 18 | 95 | 14 | НетЕсли это значение используется, iPad отобразитdefault курсор вместо этого. |
1.0 | 4.4 |
nesw-resize |
1 | 12 | 1.5 | 10.6 | 3 | 18 | 95 | 14 | НетЕсли используется это значение, iPad будет отображать указательdefault вместо него. |
1.0 | 4.4 |
|---|---|---|---|---|---|---|---|---|---|---|---|
no-drop |
1 | 12 | 1.5 | 10.6 | 3 | 18 | 95 | 14 | НетЕсли используется это значение, iPad будет отображать указательdefault вместо него. |
1.0 | 4.4 |
none |
5 | 12 | 3 | 15 | 5 | 18 | 95 | 14 | НетЕсли используется это значение, iPad будет отображать указательdefault вместо него. |
1.0 | 4.4 |
not-allowed |
1 | 12 | 1.5 | 10.6 | 3 | 18 | 95 | 14 | НетЕсли используется это значение, iPad будет отображать указательdefault вместо него. |
1.0 | 4.4 |
ns-resize |
1 | 12 | 1.5 | 10.6 | 3 | 18 | 95 | 14 | НетЕсли используется это значение, iPad будет отображать указательdefault вместо него. |
1.0 | 4.4 |
nw-resize |
1 | 12 | 1 | 7 | 1.2 | 18 | 95 | 14 | НетЕсли используется это значение, iPad будет отображать указательdefault вместо него. |
1.0 | 4.4 |
nwse-resize |
1 | 12 | 1.5 | 10.6 | 3 | 18 | 95 | 14 | НетЕсли используется это значение, iPad будет отображать указательdefault вместо него. |
1.0 | 4.4 |
pointer |
1 | 12 | 1 | 7 | 1.2 | 18 | 95 | 14 | НетЕсли используется это значение, iPad будет отображать указательdefault вместо него. |
1.0 | 4.4 |
progress |
1 | 12 | 1 | 7 | 1.2 | 18 | 95 | 14 | НетЕсли используется это значение, iPad будет отображать указательdefault вместо него. |
1.0 | 4.4 |
row-resize |
1 | 12 | 1.5 | 10.6 | 3 | 18 | 95 | 14 | НетЕсли используется это значение, iPad будет отображать указательdefault вместо него. |
1.0 | 4.4 |
s-resize |
1 | 12 | 1 | 7 | 1.2 | 18 | 95 | 14 | НетЕсли используется это значение, iPad будет отображать указательdefault вместо него. |
1.0 | 4.4 |
se-resize |
1 | 12 | 1 | 7 | 1.2 | 18 | 95 | 14 | НетЕсли используется это значение, iPad будет отображать указательdefault вместо него. |
1.0 | 4.4 |
sw-resize |
1 | 12 | 1 | 7 | 1.2 | 18 | 95 | 14 | НетЕсли используется это значение, iPad будет отображать указательdefault вместо него. |
1.0 | 4.4 |
text |
1 | 12 | 1 | 7 | 1.2 | 18 | 95 | 14 | 13.4 | 1.0 | 4.4 |
url |
1 | 12 | 1.5В Firefox 4 добавлена поддержка macOS. |
15 | 3 | 18 | 95 | 14 | 13.4 | 1.0 | 4.4 |
url_positioning_syntax |
1 | 79 | 1.5В Firefox 4 добавлена поддержка macOS. |
15 | 3 | 18 | 95 | 14 | НетЕсли используется это значение, iPad будет отображать указательdefault вместо него. |
1.0 | 4.4 |
vertical-text |
1 | 12 | 1.5 | 10.6 | 3 | 18 | 95 | 14 | НетЕсли используется это значение, iPad будет отображать указательdefault вместо него. |
1.0 | 4.4 |
w-resize |
1 | 12 | 1 | 7 | 1.2 | 18 | 95 | 14 | НетЕсли используется это значение, iPad будет отображать указательdefault вместо него. |
1.0 | 4.4 |
wait |
1 | 12 | 1 | 7 | 1.2 | 18 | 95 | 14 | НетЕсли используется это значение, iPad будет отображать указательdefault вместо него. |
1.0 | 4.4 |
zoom-in |
371 | 12 | 241 | 2415–23 | 93 | 3718 | 95 | 2414–24 | НетЕсли используется это значение, iPad будет отображать указательdefault вместо него. |
3.01.0 | 374.4 |
zoom-out |
371 | 12 | 241 | 2415–23 | 93 | 3718 | 95 | 2414–24 | НетЕсли это значение используется, iPad отобразит указательdefault. |
3.01.0 | 374.4 |
|---|
См. также
pointer-events-
<url>тип
© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/CSS/cursor