Element.setFocused()¶
Устанавливает значение, определяющее, установлен ли фокус ввода на элемент.
Description¶
Возможность установки фокуса ввода на элемент зависит от нескольких параметров. Во-первых, от значения соответствующего свойства, которое можно установить с помощью метода setFocusable(). Во-вторых, от текущего состояния элемента. Например, элемент может быть заблокирован или скрыт, либо находится внутри контейнера, который в свою очередь заблокирован или скрыт. Наконец, некоторые элементы на уровне реализации могут запрещать установку фокуса ввода.
Вызов метода setFocused() с параметром
true
учитывает все вышеперечисленные аспекты и пытается установить
фокус ввода на элемент. Если все проверки прошли успешно и элемент
получил фокус ввода, у соответствующего элемента возникает событие
onGotFocus. Следует отметить, что событие
onGotFocus также может возникать и
вследствие действий пользователя.
Установка фокуса ввода на элемент означает также то, что другой, ранее
сфокусированный элемент, теряет фокус ввода, что в свою очередь приводит
к тому, что у соответствующего элемента возникает событие
onLostFocus. Событие
onLostFocus также может спровоцировать
вызов метода setFocused() с параметром
false
, если на элемент был установлен фокус ввода.
Syntax¶
Element.setFocused(value)
Parameters¶
Name | Type | Description |
---|---|---|
value | Boolean |
Логическое значение, определяющее, установлен ли фокус ввода на элемент. Значение true означает, что фокус установлен, значение false - не установлен. |
Returns¶
Логическое значение, определяющее, успешность выполнения операции.
Значение true
означает, что метод выполнен успешно, значение
false
- не успешно.
Examples¶
var success = Element.setFocused(true);