click_by_name - справка по click_by

click_by_name(name, frame=-1, wait_browser=true); - данная функция используется для эмуляции клика мышки по элементу страницы, находя его по заданному имени.

Функция на вход принимает параметры:

name – имя по которому мы находим необходимый нам элемент на странице (string). Чтобы узнать имя элемента, можно воспользоваться либо инспектором элементов, либо контекстным меню, либо посмотреть его в списке элементов.

wait_browser – проверять и ждать окончания навигации

frame – номер фрейма, в котором мы ищем элемент (string). Номера фреймов начинаются с нуля. По умолчанию -1 - элемент находится не во фрейме. Номер фрейма в котором находится нужный вам элемент можно узнать из инспектора задач, контекстного меню и панели списка элементов.
С версии 4.6.41 доступно: можно передавать вложенные фреймы, принцип такой же самый, передается строка с номерами фреймов, разделенных : например при передаче "1:0:5" - будет выбран фрейм с номером 1 в нем под фрейм с номером 0 и в нем подфрейм с номером 5
С версии 7.0.38 доступно: можно передавать "url=>XXX", тогда будет произведен поиск фрейма, который содержит заданный src, или передавать "name=>XXX" - тогда будет поиск фрейма, по заданной части имени.

После отработки функция возвращает результат своей работы в робот (тип возвращаемого значения boolean):

true – выполнили успешно

false – найти такой элемент не удалось (например нет вообще элементов, удовлетворяющих заданным критериям или нет такого фрейма)

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

<?php $xhe_host = "127.0.0.1:7024";
 
// подключим объект для управления RPAbot, если еще не подключен
if (!isset($path))
  $path="../../../Templates/init.php";
require($path);
 
// начало
echo "<hr><font color=blue>anchor->".basename (__FILE__)."</font><hr>";
 
// 1 
echo "1. Перейдем на полигон: ";
echo $browser->navigate("http://rbot.biz-apps.ru/poligon/anchor.html")."<br>";
 
// 2 
echo "2. Кликнем на элементе с именем list: ";
echo $anchor->click_by_name("onclick")."<br>";
 
// 3  
echo "3. Кликнем на элементе с несуществующим именем: ";
if (!$anchor->click_by_name("list_ret"))
  echo "нет такого элемента<br>";
 
// 4 
echo "4. Перейдем на полигон: ";
echo $browser->navigate("http://rbot.biz-apps.ru/poligon/anchor.html")."<br>";
 
// 5 
echo "5. Кликнем на элементе с именем txt1 в нулевом фрейме: ";
echo $anchor->click_by_name("list", 0)."<br>";
 
// 6 
echo "6. Кликнем на несуществующем элементе в нулевом фрейме: ";
if (!$anchor->click_by_name("list_ret", 0))
  echo "нет такого элемента<br>";
 
// 7  
echo "7. Кликнем на элементе в несуществующем фрейме: ";
if (!$anchor->click_by_name("list", 4))
  echo "нет такого фрейма<br>";
 
// окончание примера
echo "<hr><br>";
 
// Quit
$app->quit();
?>


ФИО*
Отзыв*