Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 4 Next »

Оглавление

 Нажмите здесь, чтобы развернуть оглавление

Описание

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


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

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

Либо воспользуйтесь умным поиском.


Где это можно применить?

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

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


Как работать с экшеном?

Необходимо включить “Запись“ и режим ввода “Touch“ в окне браузера, чтобы все действия, выполненные в браузере, автоматически записывались, как Touch-события.

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

  • Touch - нажатие (клик/прикосновение);

  • Long Touch - длительное зажатие (ПКМ)

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

Прежде чем провзаимодействовать с элементом на странице его надо найти. В экшенах Получение значения , Установка значения , Выполнить событие , Событие Touch , Событие Swipe существует два способа поиска элементов - классический и с помощью XPath.


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

 

 

 

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

 

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

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

  • Активная вкладка

  • Первая

  • По имени - при выборе данного пункта появится поле ввода для названия вкладки.

  • По номеру - в поле ввода надо будет ввести порядковый номер вкладки (нумерация начинается с нуля!)

Документ

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

Форма

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

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

Пример: на странице 3 формы - поиск, регистрация, заказ товара. Нам надо кликнуть в форме заказа по кнопке и мы выбрали в качестве значения поля “Форма” - 2 (два) (нумерация с нуля). Спустя какое-то время на сайте появляется новая форма, для входа, и вставлена она перед формой заказа. Под номером 2 теперь будет форма входа и наш шаблон либо выдаст ошибку о том, что кнопка не найдена, либо (что гораздо хуже) будет кликать в другой форме по другой кнопке.

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

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

Собственно HTML тэг у которого нужно получить  значение.

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

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

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

  2. Атрибут - атрибут HTML тэга по которому производится поиск.

  3. Тип поиска:

    1. text - поиск по полному либо частичному вхождению текста;

    2. notext - поиск элементов в которых не будет указанного текста;

    3. regexp - поиск с помощью регулярных выражений
      По умолчанию поиск регистронезависимый. Чтобы при поиске с помощью регулярного выражения учитывался регистр добавьте в самом начале выражения (?-i)(это означает отключение регистронезависимого поиска)

  4. Значение - значение атрибута HTML тега

  5. № совпадения - порядковый номер найденного элемента (нумерация с нуля!). В этом поле можно использовать диапазоны и макросы переменных.

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

Для поиска нужного элемента может использоваться несколько условий.

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

Координаты

Выполнить событие Touch в рамках указанных координат

  1. Какая вкладка - Активная / Первая / По имени / По номеру

  2. Координаты - необходимо вписать диапазон координат X и Y. Можно использовать переменные проекта - {-Variable.example_var-}.


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

Возьмем за пример наш ресурс, где можно потренироваться делать простые клики - https://lessons.zennolab.com/ru/index. Для реализации воспользуемся Конструктором действий.

Переходим на страницу в ProjectMaker’e.

Опускаемся ниже и находим поле для нажатия и выбора ОС. Нажимаем на место для “галочки” правой кнопкой мыши и выбираем “В конструктор действий”.

Выбираем действие Rise , Событие touch. Нажимаем на кнопку Тестировать для проверки.

Если клик совершился успешно, то нажимаем Добавить в проект


Примеры работы на C#

Начиная с версии 7.1.4.0, в CommandCenter.Tab добавлено свойство Touch с набором методов. В свойстве Touch есть базовые методы: TouchStartTouchEndTouchMoveTouchCancel, а так же комплексные методы с перегрузками TouchSwipeIntoViewSwipeBetween и другие.

Эмуляция тач-нажатия

 Click here to expand...
var tab = instance.ActiveTab;
var init = tab.FindElementByXPath("/html/body/button", 0); // Ищем HTML элемент через XPath
tab.Touch.Touch(init); // Жмём по нему

 


Скролл

 Click here to expand...
var tab = instance.ActiveTab;
HtmlElement init = tab.FindElementByXPath(".//button", 0); // Ищем HTML элемент через XPath
tab.Touch.SwipeIntoView(init); // Скроллим экран тачами до нужного HTML элемента

 


Свайп вправо

 Click here to expand...
var tab = instance.ActiveTab;

// Будем делать свайп внутри HTML элемента. Составим XPath выражение.
var canvas = tab.FindElementByXPath(@"//*[@id=""canvas""]", 0);

// Получаем его размеры: ширину и высоту
var width = canvas.BoundingClientWidth;
var height = canvas.BoundingClientHeight;

// Определяем координаты первого касания по оси X, и последнего - когда отпускаем палец
var offsetX = width / 4;
var minX = canvas.DisplacementInBrowser.X + offsetX;
var maxX = minX + width - 2*offsetX;

// Определяем координаты первого касания по оси Y, и последнего - когда отпускаем палец
var offsetY = height / 4;
var minY = canvas.DisplacementInBrowser.Y + offsetY;
var maxY = minY;

// Делаем свайп вправо
tab.Touch.SwipeBetween(minX, minY, maxX, maxY);

Настройки

Тут отображена только часть настроек. Полный список Вы можете найти в документации.

 Нажмите здесь, чтобы развернуть

По умолчанию учитывается и рандомизируется ряд параметров: скорость, ускорение, кривая движения и другие. Все перемещения будут максимально естественными уже из «коробки», но если вам потребуется внести коррективы в поведение тач-событий – такая возможность тоже есть.

var tab = instance.ActiveTab;
var parameters = tab.Touch.GetCopyOfTouchEmulationParameters(); // Получаем текущие настройки тача
// Дальше пишем "parameters." и после точки syntax editor подскажет доступны поля этого объекта.

////////////////////////
// Некоторые примеры
////////////////////////
parameters.Acceleration = 1.2f; // Поставим ускорение посильнее

parameters.MinCurvature = 0; // Пусть минимальная кривизна - прямая линия
parameters.MaxCurvature = 1; // А максимальная кривизна - очень сильный изгиб

// Изгиб кривой ближе к начальной точке
parameters.MinCurvePeakShift = 0f;
parameters.MaxCurvePeakShift = 0.2f;

parameters.MinStep = 1; // Начальная скорость пониже
parameters.MaxStep = 60; // А финальная - выше

parameters.RightThumbProbability = 0.7f; // В 70% случаев будет использоваться правый палец, а в 30% - левый.

tab.Touch.SetTouchEmulationParameters(parameters); // ВАЖНО: ПРИМЕНЯЕМ НАСТРОЙКИ - ИНАЧЕ НИЧЕГО НЕ ИЗМЕНИТСЯ

// Ещё больше настроек здесь: https://help.zennolab.com/en/v7/zennoposter/7.1.4/webframe.html#topic951.html
// instance.ActiveTab.Touch.SetTouchEmulationParameters(new TouchEmulationParameters()); // Устанавливаем настройки по умолчанию


 Демонстрационный проект

Скачать проект


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


  • No labels