Spec-Zone.ru › CSS

курсор

Свойство 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 wide arrow pointing up and to the left Курсор по умолчанию, зависящий от платформы. Обычно стрелка.
none Курсор не отображается.
Ссылки & статус context-menu wide arrow pointing up and to the left slightly obscuring a menu icon Доступно контекстное меню.
help wide arrow pointing up and to the left next to a question mark Доступна справочная информация.
pointer right hand with an index finger pointing up Курсор — указатель, указывающий на ссылку. Обычно изображение руки, указывающей.
progress wide arrow and hour glass Программа выполняет фоновые задачи, но пользователь по-прежнему может взаимодействовать с интерфейсом (в отличие от wait).
wait hour glass Программа выполняет задачи, и пользователь не может взаимодействовать с интерфейсом (в отличие от progress). Иногда изображение песочных часов или часов.
Выделение cell wide plus symbol Ячейка или набор ячеек таблицы могут быть выделены.
crosshair plus symbol composed of two thin lines. Перекрестный курсор, часто используется для обозначения выделения в растровом изображении.
text vertical i-beam Текст можно выделить. Обычно имеет форму I-луча.
vertical-text horizontal i-beam Вертикальный текст можно выделить. Обычно имеет форму I-луча, повернутого на бок.
Перетаскивание alias wide arrow pointing up and to the left partially obscuring a smaller folder icon with a curved arrow pointing up and to the right Создается псевдоним или ярлык.
copy wide arrow pointing up and to the left partially obscuring a smaller folder icon with a plus sign Нечто копируется.
move plus sign made of two thin lines. The four points are small arrows facing out Нечто перемещается.
no-drop pointer icon and a not allowed icon Элемент не может быть помещён в текущее место.
Ошибка Firefox 275173: В Windows и macOS no-drop эквивалентно not-allowed.
not-allowed Not allowed icon, which is a circle with a line through it Запрошенное действие не будет выполнено.
grab fully opened hand icon Нечто можно взять (перетащить для перемещения).
grabbing closed hand icon, of the back of the hand Нечто берётся (перетаскивается для перемещения).
Изменение размера & прокрутка all-scroll icon of a medium size dot with four triangles around it. Нечто можно прокрутить в любом направлении (перемещать).
Ошибка Firefox 275174: В Windows all-scroll эквивалентно move.
col-resize col-resize.gif Элемент/колонка может быть изменена по горизонтали. Часто отображается как стрелки, указывающие влево и вправо, разделённые вертикальной чертой.
row-resize two narrow parallel horizontal lines with a small arrow pointing up and another pointing down Элемент/строка может быть изменена по вертикали. Часто отображается как стрелки, указывающие вверх и вниз, разделённые горизонтальной чертой.
n-resize thin long arrow pointing towards the top Некоторая граница должна быть перемещена. Например, курсор se-resize используется, когда перемещение начинается из юго-восточного угла рамки.
В некоторых средах отображается эквивалентный курсор двунаправленного изменения размера. Например, n-resize и s-resize эквивалентны ns-resize.
e-resize thin long arrow pointing towards the right
s-resize thin long arrow pointing down
w-resize thin long arrow pointing towards the left
ne-resize thin long arrow pointing top-right
nw-resize thin long arrow pointing top-left
se-resize thin long arrow pointing bottom-right
sw-resize thin long arrow pointing bottom-left
ew-resize thin long arrow pointing left and right Курсор двунаправленного изменения размера.
ns-resize thin long arrow pointing up and down
nesw-resize thin long arrow pointing both to the top-right and bottom-left
nwse-resize thin long arrow pointing both to the top-left and bottom-right
Масштабирование zoom-in magnifying glass with a plus sign

Нечто можно увеличить или уменьшить.

zoom-out magnifying glass with a minus sign

Формальное определение

Начальное значение 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>* )

Примечания по использованию

END_OF_DOCUMENT_MARKER

Пределы размера значка

Хотя спецификация не ограничивает размер изображения 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API