Cell¶

public final class Cell extends AbstractUiElement implements Clickable, KeyboardInput ¶: Added in version 1.1.0.

Added in version 1.1.3: Добавлена поддержка табличных представлений в карточном режиме. Добавлена поддержка чтения значений в GridDropDown.

Ячейка табличного представления. Предоставляет методы, позволяющие взаимодействовать с областью, образуемой на пересечении конкретных строки и столбца списка в табличном его представлении. В такой области отображается значение известного атрибута известной записи. Таким образом, класс позволяет своими методами симулировать действия пользователя, связанные с получением и изменением значений атрибутов.

See also

Grid

Row

Column

Constructors¶

Cell¶

Cell(Row parent, WebElement webElement, int columnIndex)¶

Methods¶

checkBox¶

public CellCheckBox checkBox()¶

Added in version 1.2.1.

Чекбокс ячейки. В отличие от value(), различает незаданное значение и выключенный чекбокс.

Returns:: чекбокс ячейки

field¶

public <F extends AbstractField> F field()¶

Added in version 1.1.3: Добавлена обработка попытки открытия редактора на нулевой колонке табличного представления в карточном режиме. Скорректирована последовательность симулируемых действий пользователя для открытия редактора в табличном представлении в карточном режиме.

Added in version 1.2.1: Открытие редактора повторяется, пока редактор не отрисован, вместо ожидания стабильности dom-модели.

Спровоцировать инъекцию поля ввода в ячейке и получить это поле (динамический редактор).

Parameters:

<F> – тип поля

Throws:

ElementNotFoundException – если выполнена попытка инъекции поля ввода в ячейку первой колонки табличного представления в карточном режиме, либо если редактор не появился в течении отведенного времени

Returns:

поле ввода

getAttributeValue¶

String getAttributeValue(EditorTypeEnum editorType)¶

Added in version 1.1.3.

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

Parameters:

editorType – тип редактора (EditorTypeEnum)

Returns:

строковое значение атрибута ячейки

getClickableWebElement¶

public WebElement getClickableWebElement()¶

getWebElement¶

public WebElement getWebElement()¶

Added in version 1.2.1.

Получить dom-элемент ячейки, пригодный для работы прямо сейчас. Табличное представление перерисовывает свою разметку, и раннее найденный dom-элемент ячейки при этом заменяется на новый, а сохраненная ссылка перестает работать. Метод проверяет ссылку и, если она больше не работает, находит ячейку заново по её месту в строке, а именно, по видимому индексу колонки. Строку, в свою очередь, точно так же находит заново она сама. Поэтому вызывающему функционалу не нужно ни отслеживать перерисовку, ни искать ячейку повторно.

Throws:

ElementNotFoundException – если ячейка не отрисована за отведённое время

Returns:

dom-элемент ячейки

grid¶

public Grid grid()¶

Added in version 1.2.1: Добавлен

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

Returns:: табличное представление

openedField¶

public <F extends AbstractField> F openedField()¶

Added in version 1.2.1.

Получить редактор ячейки, уже открытый пользовательским действием.

В отличие от field() не провоцирует открытие: подходит там, где редактор открыт иначе — например двойным кликом по ячейке.

Parameters:

<F> – тип поля

Throws:

ElementNotFoundException – если открытого поля ввода нет

Returns:

поле ввода

rightClick¶

public void rightClick()¶: Блокируем правый клик в ячейку.

row¶

public Row row()¶

Added in version 1.2.1: Добавлен

Получить строку табличного представления, которой принадлежит ячейка.

Returns:: строка табличного представления

value¶

public String value()¶

Added in version 1.1.3: Добавлена возможность получения текста ячейки в карточном режиме.

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

Исключительная ситуация: получение значения из ячейки первой колонки табличного представления в карточном режиме. В этом случае возвращается не значение атрибута, а заголовок атрибута.

Returns:: строковое представление значения ячейки

waitValue¶

public void waitValue(String expectedValue)¶

Added in version 1.2.1.

Дождаться, когда значение ячейки станет равным ожидаемому.

Parameters:

expectedValue – ожидаемое строковое представление значения ячейки

Throws:

AutomationException – если значение ячейки не стало ожидаемым за отведённое время