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

Событие Swipe

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

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

Описание​

Данный экшен позволяет эмулировать движения пальцем по экрану (свайп).

Как добавить действие в проект?​

Через контекстное меню: Добавить действие → Табы → Событие Swipe

image-20200816-113705

Где это используется?​

  • В эмуляции телефона или любого другого устройства с сенсорным экраном,
  • Для качественной имитации человека при автоматических действиях.

Принцип работы​

Перед началом работы нужно включить Запись и в Окне браузера переключить Режим ввода на Touch.

Режим ввода

image-20200816-113838

Выбор события​

  • Свайп до элемента — листать страницу, пока элемент не станет видимым.
  • Простой свайп — Вверх/Вниз/Влево/Вправо.

Поиск элемента​

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

существует два способа поиска элементов — классический и с помощью 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 (нумерация с нуля).

Координаты​

В рамках указанных координат будет совершено нажатие.

image-20200816-110654

  • Какая вкладка:
    • Активная
    • Первая
    • По имени
    • По номеру
  • Координаты — необходимо вписать диапазон координат X и Y.
    Можно использовать переменные проекта: { -Variable.example_var- }

Вкладка «Дополнительно»​

Подождать перед выполнением​

Указываем интервал времени в секундах, который шаблон будет ждать перед нажатием.

Ждать элемент не более​

Если по истечении указанного времени в секундах элемент не появился на странице, то экшен завершит работу с ошибкой.

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

Это действие отлично сочетается с Событием Touch. То есть сначала выполняете Swipe до элемента, а потом Touch.

Помимо этого, оно может пригодиться для эмуляции живого скроллинга страницы или пролистывания фотографий.

Пример свайпа на C#.

Полезные ссылки​