User Tools

Site Tools


Sidebar



en:objects:common:get_other:get_numbers_child_by_attribute

get_numbers_child_by_attribute

get_numbers_child_by_attribute($attr_name, $attr_value, $exactly = true, $element_type = "",$frame = -1,$include_subchildren = false); - this function is used to get the numbers of elements that are children of a given element on the page, finding it by the value of the specified attribute or part of it.

the input Function accepts parameters:

  • $attr_name – name of the attribute whose value we will search for the element on the page (string). To find out the attribute names of an element, you can use either the element inspector, the context menu, or view it in the list of elements.
  • $attr_value – the value of the attribute that we will use to search for the element on the page (string). To find out the value of a given attribute for an element, you can use either the element inspector, the context menu, or view it in the list of elements.
  • $exactly – exact match of the value of the specified attribute when searching for an element (boolean), by default 1 - the value of the specified element attribute must completely match the passed parameter ($attr_value). if this parameter is set as 0, the first element will be found where the specified attribute value contains the specified string ($attr_value).Starting from version 7.0.25, you can fart the value 2, then attr_value will be interpreted as a regular expression for the Java Script String.search function.
  • $element_type – the type of child elements whose numbers we need to get (string). By default, an empty string (all types). It can be passed "anchor", "btn" , "button", etc., i.e. a string with the type of object to get the numbers for. Moreover, the numbers will be obtained for the specified type and using the numbering of the specified type.
  • $include_subchildren – also search for all child subelements. (available from version 7.0.23)
  • $frame – the number of the frame in which we are looking for the element (string). Frame numbers start from zero. By default, -1 - the element is not in the frame. You can find out the number of the frame that contains the item you need from the task inspector, the context menu, and the item list panel.
    With version 4.6.41 of postpone: you can pass nested frames, the principle is the same, a string is numbered frames separated by : for example, if you transfer "1:0:5" - will the selected frame number 1 in it under the frame with the number 0 and the subframe number 5
    Since version 7.0.38, you can pass "url=>XXX", then search for the frame that contains the specified src, or pass "name=>XXX" - then the frame will be searched by the specified part of the name.

    After the function returns the result of their work in the script :
  • item numbers is a string with the numbers of child elements separated by <br> (or the empty string if the element contains no child elements), the type of the return value string
  • false to find this element failed (e.g. no items that meet the specified criteria or not this frame)

    PHP example:

    <?php $xhe_host = "127.0.0.1:7013";
     
    //connect the object to control the emulator, if not already connected
    if(!isset($path))
      $path = "../../../Templates/xweb_human_emulator.php";
    require($path);
     
    //Start
    echo "<hr> <font color = blue> form->".basename(__FILE__)."</font> <hr>";
     
    //1
    echo("1.Let's go to the polygon:");
    echo($browser->navigate("humanemulator.net/poligon/btn.html")."<br>");
     
    //2
    echo("<br> 2.Get the numbers of all elements in the form with the number id = form1: <br> <br>");
    echo($form->get_numbers_child_by_attribute("id", "form1", true));
     
    //3
    echo("<br> <br> 3.Get the numbers of all elements in the form with id = form1(including subelements): <br> <br>");
    echo($form->get_numbers_child_by_attribute("id", "form1", true, "", - 1, true));
     
    //4
    echo("<br> <br> 4.Get the numbers of all input buttons in the form with an id containing form1: <br> <br>");
    echo($form->get_numbers_child_by_attribute("id", "form1", false, "input"));
     
    //five
    echo("<br> <br> 5.Get the numbers of all input buttons in the form with an id containing form1 in a zero frame: <br> <br>");
    echo($form->get_numbers_child_by_attribute("id", "form1", false, "input", "0"));
     
    //end
    echo "<hr> <br>";
     
    //Quit
    $app->quit();
    ?>

    Python example:

    # Additional paths
    import sys
    sys.path.insert(0, '../../../Templates PY/')
     
    xhe_host = "127.0.0.1:7024"
    from xweb_human_emulator import *
     
    # Start
    echo("<hr> <font color = blue> common.get_numbers_child_by_attribute </font> <hr>")
     
    # 1
    echo("1.Let's go to the polygon:")
    echo(browser.navigate("www.humanemulator.net/poligon/btn.html"), "<br>")
     
    # 2
    echo("<br> 2.Get the numbers of all elements in the form with id = form1: <br> <br>")
    echo(form.get_numbers_child_by_attribute("id", "form1", true))
     
    # 3
    echo("<br> <br> 3.Get the numbers of all buttons in the form with an id containing form1: <br> <br>")
    echo(form.get_numbers_child_by_attribute("id", "form1", false, "btn"))
     
    # 3
    echo("<br> <br> 3.Get the numbers of all inputs in a form with an id containing form1 in a zero frame: <br> <br>")
    echo(form.get_numbers_child_by_attribute("id", "form1", false, "input", "0"))
     
    # end
    echo("<hr> <br>")
     
    # Quit
    app.quit()

    C# example:

    #region using
     
    using System;
    using System.Diagnostics;
    using System.Collections.Generic;
    using System.Linq;
    using System.IO;
    using System.Text;
    using System.Threading;
     
    using XHE;
    using XHE.XHE_DOM;
    using XHE.XHE_System;
    using XHE.XHE_Window;
    using XHE.XHE_Web;
     
    #endregion
     
     class Program: XHEScript
     {
    static void Main(string [] args)
    {
    //init XHE
    server = "127.0.0.1:7024";
    InitXHE();
     
    //Start
    echo("<hr> <font color = blue> get_numbers_child_by_attribute </font> <hr>");
     
    //1 step
    echo("1.Let's go to the polygon for the shape:");
    echo(browser.navigate("www.humanemulator.net/poligon/btn.html") + "<br>");
     
    //step 2
    echo("<br> 2.Get the numbers of all elements in the form with the number id = form1: <br> <br>");
    echo(form.get_numbers_child_by_attribute("id", "form1", true));
     
    //step 3
    echo("<br> 3.Get the numbers of all elements in the form with id = form1(including subelements): <br> <br>");
    echo(form.get_numbers_child_by_attribute("id", "form1", true, "", "- 1", true));
     
    //step 4
    echo("<br> <br> 3.Get the numbers of all input buttons in the form with an id containing form1: <br> <br>");
    echo(form.get_numbers_child_by_attribute("id", "form1", false, "input"));
     
    //step 5
    echo("<br> <br> 3.Get the numbers of all input buttons in a form with an id containing form1 in a zero frame: <br> <br>");
    echo(form.get_numbers_child_by_attribute("id", "form1", false, "input", "0"));
     
    //end
    echo("<hr> <br>");
     
    app.quit();
    }
    }

    Java Script example:

    //connect the object to control the emulator, if not already connected
    xhe_host = "127.0.0.1:7024";
    echo = require("../../../Templates JS/xweb_human_emulator.js");
     
    //Start
    echo("<hr> <font color = blue> form.get_numbers_child_by_attribute </font> <hr>");
     
    //1 step
    echo("1.Let's go to the polygon:");
    echo(browser.navigate("www.humanemulator.net/poligon/btn.html") + "<br>");
     
    //step 2
    echo("2.Get the numbers of all elements in the form with id = form1:");
    echo(form.get_numbers_child_by_attribute("id", "form1", true));
     
    //step 3
    echo("<br> 3.Get the numbers of all elements in the form with id = form1(including subelements):");
    echo(form.get_numbers_child_by_attribute("id", "form1", true, "", - 1, true));
     
    //step 4
    echo("<br> 4.Get the numbers of all input buttons in the form with an id containing form1:");
    echo(form.get_numbers_child_by_attribute("id", "form1", false, "input"));
     
    //step 5
    echo("<br> 5.Get the numbers of all input buttons in the form with an id containing frm1 in a zero frame:");
    echo(form.get_numbers_child_by_attribute("id", "form1", false, "input", "0"));
     
    //end
    echo("<hr> <br>");
     
    //Quit
    app.quit();
  • en/objects/common/get_other/get_numbers_child_by_attribute.txt · Last modified: 2026/08/05 22:34 (external edit)