Основной сайт хуманэмулятор.рф  |  Демо  |  Купить  |  API  |  Wiki



DOM / общее для всех DOM



run_js_by_attribute

run_js_by_attribute($attr_name,$attr_value,$exactly,$js,$frame="-1"); - Выполнить JS для DOM элемента, который найти по атрибуту

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

  • $attr_name – Название атрибута для поиска
  • $attr_value – Значение атрибута для поиска
  • $exactly – Требуется точное соответствие атрибута? Да/Нет
  • $js – Скрипт JS
  • $frame – Номер фрэйма или строка с номерами фреймов, разделенных двоеточием, если фрэйм вложенный или запрос на поиск фрэйма по атрибуту

    После выполнения функции возвращаемое значение будет равно одному из двух :
  • результат – Результат
  • пусто / null – ошибка

    Пример использования
    <?php
    // Scenario: Examples of using run_js_by_attribute function to execute JavaScript on DOM elements by their attributes
    // Path to init.php file for connecting to XHE API
    $xhe_host = getenv("RPABOT_HOST_URL");
    if (!isset($path)){
        // Path to the init.php file for connecting to the XHE API
        $path = "../../../Templates/init.php";
        // Including init.php grants access to all classes and functionality for working with the XHE API
        require($path);
    }
    
    // Navigate to a webpage with various elements
    WEB::$browser->navigate(TEST_POLYGON_URL . "form.html");
    
    echo "\n\n=== Examples of using run_js_by_attribute function ===\n\n";
    
    // Example 1: Execute simple JavaScript on element with specific ID
    $attr_name = "id";
    $attr_value = "form1_username";
    $js_script = "element.tagName;";
    $result = DOM::$input->run_js_by_attribute($attr_name, $attr_value, true, $js_script);
     if ($result) {
    	echo "\n\nResult of executing JS '{$js_script}' on element with {$attr_name}='{$attr_value}'";
    }
    else
    {
    	echo "Could not execut executing JS '{$js_script}' on element with {$attr_name}='{$attr_value}'\n";
    }
    
    // Example 2: Execute JavaScript to change element style by name attribute
    $attr_name = "name";
    $attr_value = "passwd";
    $js_script = "element.style.backgroundColor = 'yellow';";
    $result = DOM::$input->run_js_by_attribute($attr_name, $attr_value, true, $js_script);
    if ($result) {
    	echo "\n\nResult of executing JS set style change on element with {$attr_name}='{$attr_value}'";
    }
    else
    {
    	echo "Could not executing style change on element with {$attr_name}='{$attr_value}': {$result}\n";
    }
    
    // Example 3: Execute JavaScript to get element attributes by form name
    $attr_name = "name";
    $attr_value = "Form1";
    $js_script = "var attrs = element.attributes; var result = ''; for (var i = 0; i < attrs.length; i++) { result += attrs[i].name + '=' + attrs[i].value + '; '; } \nresult;";
    $result = DOM::$form->run_js_by_attribute($attr_name, $attr_value, true, $js_script);
    if ($result) {
    	echo("\n\nExecuting JS to show all attributes of element with {$attr_name}='{$attr_value}': {$result}\n");
    }
    else
    {
    	echo "Could not executing get attributes of element with {$attr_name}='{$attr_value}'\n";
    }
    
    
    // Quit the application
    WINDOW::$app->quit();
    ?>

    =============================================
    a_common    Объекты    DOM  System  Vision  Web  Window        
    =============================================
    Если что-то непонятно или необходимо узнать или считаете что надо добавить по работе этой функции, пишите в комментарии или на наш форум.

    PS: В тестовом примере приведена работа с конкретным объектом DOM, но данная функция есть во всех DOM объектах, т.е она существует у всех объектов из категории DOM.