Перейти к основному содержимому

Поиск элементов на странице

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

🔗 Оригинальная страница — Источник данного материала

Описание​

Прежде чем провзаимодействовать с элементом на странице его надо найти. Для экшенов:

существует два способа поиска элементов — классический и с помощью XPath.

Классический​

Поиск по параметрам HTML элемента: тэг, атрибут и его значение.

image-20200805-202115

XPath​

Поиск с помощью XPath выражений. Он позволяет реализовать более универсальный и устойчивый к изменениям вёрстки способ поиска данных в сравнении с классическим поиском или регулярными выражениями.

image-20200805-202209

Доступные параметры​

Какая вкладка​

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

Возможные значения:​

  • Активная вкладка;
  • Первая;
  • По имени — при выборе данного пункта появится поле ввода для названия вкладки;
  • По номеру — в поле ввода надо будет ввести порядковый номер вкладки (нумерация начинается с нуля!).

Документ​

Рекомендуется ставить значение -1 (поиск во всех документах на странице). 

Форма​

Тоже лучше ставить -1 (поиск по всем формам на странице). При выборе такого значения шаблон будет более универсальным.

Почему лучше ставить -1 ?

Пример. На странице размещены три формы: форма поиска, форма регистрации и форма оформления заказа. Для клика по кнопке в форме заказа в настройках действия указано значение поля «Форма» — 2 (нумерация начинается с нуля).

Со временем на сайте появляется новая форма — форма входа, которая добавляется перед формой заказа. В результате форма заказа смещается, и под индексом 2 теперь оказывается форма входа.

В такой ситуации шаблон либо выдаст ошибку о том, что нужная кнопка не найдена, либо — что гораздо опаснее — выполнит клик по другой кнопке в другой форме, приводя к некорректной работе шаблона.

Примечание​

В настройках программы можно включить два параметра: «Искать во всех формах на странице» и «Искать во всех документах на странице». При их активации при добавлении элемента в Конструктор действий значения полей «Номер документа» и «Номер формы» автоматически устанавливаются в -1, что означает поиск элемента по всей странице без привязки к конкретному документу или форме.

Тэг (только классический поиск)​

image-20210525-095347

Это HTML тэг, у которого нужно получить значение.

Можно указать сразу несколько тегов через ; (точка с запятой)

Условия (только классический поиск)​

image-20210525-100053

Для удаления условия поиска

Нужно кликнуть ЛКМ по полю слева от него (на скриншоте выделено синим цветом) и нажать кнопку DELETE на клавиатуре.

1. Группа — это параметр, определяющий приоритет условия поиска. Чем меньше значение группы, тем выше приоритет условия.

Поиск выполняется последовательно: сначала проверяются условия с наивысшим приоритетом. Если элемент по ним не найден, система переходит к условиям со следующим приоритетом и продолжает поиск до тех пор, пока элемент не будет найден или не закончатся все условия.

Допускается добавление нескольких условий с одинаковым приоритетом. В этом случае поиск выполняется одновременно по всем условиям, относящимся к одной группе.
2. Атрибут — атрибут HTML тэга по которому производится поиск.
3. Тип поиска:

  • text — поиск по полному либо частичному вхождению текста;
  • notext — поиск элементов в которых не будет указанного текста;
  • regexp — поиск с использованием регулярных выражений. По умолчанию поиск выполняется без учёта регистра символов.
    Если необходимо учитывать регистр, добавьте в начало регулярного выражения конструкцию (?-i), которая отключает регистронезависимый режим поиска.
  1. Значение — значение атрибута HTML тега.
  2. № совпадения — порядковый номер найденного элемента (нумерация с нуля!). В этом поле можно использовать диапазоны и макросы переменных.
Для поиска нужного элемента можно использовать несколько условий.

Всегда важно стараться подбирать условия поиска таким образом, чтоб оставался только один элемент, т.е. порядковый номер был 0 (нумерация с нуля).