EN RU
Форум

Методология

Технологии

Инструментарий

Библиотеки

Учебные материалы

DocumentationJSDocSource

checkbox

Используется для управления параметром выбора с двумя состояниями – «включено» и «выключено».

Обзор блока

Модификаторы блока

Модификатор Допустимые значения Способы использования Описание
type 'button' BEMJSON Тип чекбокса.
checked true BEMJSON, JS Выбор чекбокса.
disabled true BEMJSON, JS Неактивное состояние.
focused true BEMJSON, JS Фокус на блоке.
hovered true Наведение курсором.
theme 'islands' BEMJSON Стилевое оформление.
size 'm', 'l' BEMJSON Размер чекбокса. Используется для чекбоксов с модификатором theme в значении islands.

Специализированные поля блока

Поле Тип Описание
name String Уникальное имя чекбокса.
val String, Number Значение чекбокса, которое будет отправлено на сервер, если он выбран.
text String Текст подписи к чекбоксу.
icon BEMJSON Иконка. Формируется блоком icon. Используется для чекбокса с модификатором type в значении button.
title String Текст всплывающей подсказки. Используется для чекбокса с модификатором type в значении button.
tabIndex Number Последовательность перехода между контролами при нажатии на Tab.

Описание блока

Примечание HTML-атрибут autocomplete принудительно переведен в состояние off для обеспечения корректной работы блока.

Модификаторы блока

Модификатор type

Допустимое значение: 'button'.

Способ использования: BEMJSON.

Используется для изменения внешнего вида блока на кнопочный. В таком случае выбор чекбокса происходит нажатием на кнопку.

Open in a new window

Модификатор checked

Допустимое значение: true.

Способы использования: BEMJSON, JS.

Используется для выбора чекбокса.

Open in a new window
Open in a new window

Модификатор disabled

Допустимое значение: true.

Способы использования: BEMJSON, JS.

Отвечает за неактивное состояние, при котором блок виден, но недоступен для действий пользователя.

Open in a new window
Open in a new window

Модификатор focused

Допустимое значение: true.

Способы использования: BEMJSON, JS.

Отвечает за наличие фокуса на блоке.

Выставляется автоматически при получении блока фокуса.

{
    block : 'button',
    mods : { theme : 'islands', size : 'm', focused : true },
    text : 'В фокусе'
}

Способ установки фокуса на блок определяет выбор модификатора: focused или focused-hard. Читать подробности.

Модификатор hovered

Допустимое значение: true.

Способы использования: – .

Выставляется блоку автоматически, когда курсор мыши находится в пределах контрола.

Модификатор theme

Допустимое значение: 'islands'.

Способ использования: BEMJSON.

Отвечает за стилевое оформление блока.

Необходимо использовать с модификатором size.

Open in a new window

Модификатор size

Допустимые значения для темы islands: 'm', 'l'.

Способ использования: BEMJSON.

Задает размер блока.

Необходимо использовать с модификатором theme в значении islands.

m

Open in a new window
Open in a new window

l

Open in a new window
Open in a new window

Специализированные поля блока

Поле name

Тип: String.

Определяет уникальное имя чекбокса.

Open in a new window

Поле val

Тип: String, Number.

Значение чекбокса, которое будет отправлено на сервер.

Open in a new window

Поле text

Тип: String.

Определяет текст подписи к чекбоксу или текст кнопки, если указан модификатор type в значении button.

Open in a new window
Open in a new window

Поле icon

Тип: BEMJSON.

Определяет иконку, которая отображается с помощью блока icon.

Используется только для чекбокса с модификатором type в значении button.

Open in a new window

Поле title

Тип: String.

Определяет содержание всплывающей подсказки. Вид такой подсказки зависит от браузера, настроек операционной системы и не может быть изменен с помощью HTML-кода или стилей.

Используется только для чекбокса с модификатором type в значении button.

Open in a new window

Поле tabIndex

Тип: Number.

Определяет порядок получения фокуса при переходе между контролами с помощью клавиши Tab.

Open in a new window

Block checkbox

Augments:control