User Tools

Site Tools


Sidebar

en:objects:common:change_attributes:add_attribute_by_number

add_attribute_by_number

add_attribute_by_number($number,$name_attr,$value_attr,$frame=-1); - this function is used to add a new attribute with a value to a page element, finding it by the specified number.

the input Function accepts parameters:

  • $number – the number by which we find the element we need on the page (int) . Element numbers start with 0 and different types of elements have their own numbering.To find out the item number, you can use either the item inspector or the context menu, or view it in the list of items.
  • $name_attr – name of the attribute to be added (string). If the attribute name matches an existing attribute for an element, the value of this attribute will simply be changed.
  • $value_attr – the attribute value that will be set to the added attribute (string).
  • $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 (the return value type is boolean):
  • true – executed successfully
  • 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:7016";
     
    //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> anchor->".basename(__FILE__)."</font> <hr>";
     
    //1
    echo "1.Let's go to the polygon:";
    echo $browser->navigate("http://humanemulator.net/poligon/anchor.html")."<br> <br>";
     
    //2
    echo "2.Get all the attributes of the element with number 0: <br> <br>";
    echo $anchor->get_all_attributes_by_number(0)."<br> <br>";
     
    //3
    echo "3.Add the target1 = value1 attribute to element 0:";
    echo $anchor->add_attribute_by_number(0, "target1", "value1")."<br> <br>";
     
    //4
    echo "4.Get all the attributes of the element with number 0: <br> <br>";
    echo $anchor->get_all_attributes_by_number(0)."<br> <br>";
     
    //five
    echo "5.Add an attribute to a nonexistent element:";
    if(!$anchor->add_attribute_by_number(100500, "target1", "value1"))
    echo "no such element <br> <br>";
     
    //6
    echo "6.Get all the attributes of the element with number 0 in the zero frame: <br> <br>";
    echo $anchor->get_all_attributes_by_number(0,0)."<br> <br>";
     
    //7
    echo "7.Add the target3 = value1 attribute in the zero frame to element 0:";
    echo $anchor->add_attribute_by_number(0, "target3", "value1", 0)."<br> <br>";
     
    //8
    echo "8.Get all the attributes of the element with number 0 in the zero frame: <br> <br>";
    echo $anchor->get_all_attributes_by_number(0,0)."<br> <br>";
     
    //nine
    echo "9.Add an attribute to a nonexistent element in the zero frame:";
    if(!$anchor->add_attribute_by_number(100500, "target1", "value1", 0))
    echo "no such element <br> <br>";
     
    //ten
    echo "10.Add an attribute to an element in a non-existent frame:";
    if(!$anchor->add_attribute_by_number(1, "target2", "value2", 5))
    echo "no such frame";
     
    //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:7013"
    from xweb_human_emulator import *
     
    # Start
    echo("<hr> <font color = blue> common.add_attribute_by_number </font> <hr>")
     
    # 1
    echo("1.Let's go to the polygon:")
    echo(browser.navigate("http://www.humanemulator.net/poligon/anchor.html"), "<br> <br>")
     
    # 2
    echo("2.Get all the attributes of the element with number 0: <br> <br>")
    echo(anchor.get_all_attributes_by_number(0), "<br> <br>")
     
    # 3
    echo("3.Add target1 = value1:" attribute to element number 0)
    echo(anchor.add_attribute_by_number(0, "target1", "value1"), "<br> <br>")
     
    # 4
    echo("4.Get all the attributes of the element with number 0: <br> <br>")
    echo(anchor.get_all_attributes_by_number(0), "<br> <br>")
     
    # five
    echo("5.Add an attribute to a nonexistent element:")
    if not anchor.add_attribute_by_number(100500, "target1", "value1"):
    echo("no such element <br> <br>")
     
    # 6
    echo("6.Get all the attributes of the element with number 0 in the zero frame: <br> <br>")
    echo(anchor.get_all_attributes_by_number(0,0), "<br> <br>")
     
    # 7
    echo("7.Add the target3 = value1 attribute in the zero frame to element 0:")
    echo(anchor.add_attribute_by_number(0, "target3", "value1", 0), "<br> <br>")
     
    # 8
    echo("8.Get all the attributes of the element with number 0 in the zero frame: <br> <br>")
    echo(anchor.get_all_attributes_by_number(0,0), "<br> <br>")
     
    # nine
    echo("9.Add attribute to nonexistent element in frame zero:")
    if not anchor.add_attribute_by_number(100500, "target1", "value1", 0):
    echo("no such element <br> <br>")
     
    # ten
    echo("10.Add an attribute to an element in a nonexistent frame:")
    if not anchor.add_attribute_by_number(1, "target2", "value2", 5):
    echo("no such frame")
     
    # 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:7013";
    InitXHE();
     
    //Start
    echo("<hr> <font color = blue> add_attribute_by_number </font> <hr>");
     
    //1 step
    echo("1.Let's go to the polygon:");
    echo(browser.navigate("www.humanemulator.net/poligon/anchor.html") + "<br> <br>");
     
    //step 2
    echo("2.Get all the attributes of the element with number 0: <br> <br>");
    echo(anchor.get_all_attributes_by_number(0) + "<br> <br>");
     
    //step 3
    echo("3.Add the target1 = value1:" attribute to element number 0);
    echo(anchor.add_attribute_by_number(0, "target1", "value1") + "<br> <br>");
     
    //step 4
    echo("4.Get all the attributes of the element with number 0: <br> <br>");
    echo(anchor.get_all_attributes_by_number(0) + "<br> <br>");
     
    //step 5
    echo("5.Add an attribute to a nonexistent element:");
    if(!anchor.add_attribute_by_number(100500, "target1", "value1"))
    echo("no such element <br> <br>");
     
    //6 step
    echo("6.Get all the attributes of the element with number 0 in the zero frame: <br> <br>");
    echo(anchor.get_all_attributes_by_number(0, "0") + "<br> <br>");
     
    //step 7
    echo("7.Add the target1 = value1 attribute in the zero frame to the element with number 0:");
    echo(anchor.add_attribute_by_number(0, "target1", "value1", "0") + "<br> <br>");
     
    //step 8
    echo("8.Get all the attributes of the element with number 0 in the zero frame: <br> <br>");
    echo(anchor.get_all_attributes_by_number(0, "0") + "<br> <br>");
     
    //step 9
    echo("9.Add an attribute to a nonexistent element in a zero frame:");
    if(!anchor.add_attribute_by_number(100500, "target1", "value1", "0"))
    echo("no such element <br> <br>");
     
    //step 10
    echo("10.Add an attribute to an element in a non-existent frame:");
    if(!anchor.add_attribute_by_number(1, "target2", "value2", "5"))
    echo("no such frame");
     
    //end
    echo("<hr> <br>");
     
    app.quit();
    }
    }

    Java Script example:

    //IE + Chrom
     
    //connect the object to control the emulator, if not already connected
    xhe_host = "127.0.0.1:7031";
    echo = require("../../../Templates JS/xweb_human_emulator.js");
     
    //Start
    echo("<hr> <font color = blue> anchor.add_attribute_by_number </font> <hr>");
     
    //1 step
    echo("1.Let's go to the polygon:");
    echo(browser.navigate("http://www.humanemulator.net/poligon/anchor.html") + "<br> <br>");
     
    //step 2
    echo("2.Get all the attributes of the element with number 0: <br> <br>");
    echo(anchor.get_all_attributes_by_number(0) + "<br> <br>");
     
    //step 3
    echo("3.Add the target1 = value1:" attribute to element number 0);
    echo(anchor.add_attribute_by_number(0, "target1", "value1") + "<br> <br>");
     
    //step 4
    echo("4.Get all the attributes of the element with number 0: <br> <br>");
    echo(anchor.get_all_attributes_by_number(0) + "<br> <br>");
     
    //step 5
    echo("5.Add an attribute to a nonexistent element:");
    if(!anchor.add_attribute_by_number(100500, "target1", "value1"))
    echo("no such element <br> <br>");
     
    //step 6
    echo("6.Get all the attributes of the element with number 0 in the zero frame: <br> <br>");
    echo(anchor.get_all_attributes_by_number(0,0) + "<br> <br>");
     
    //step 7
    echo("7.Add target3 = value1 attribute in frame zero to element 0:");
    echo(anchor.add_attribute_by_number(0, "target3", "value1", 0) + "<br> <br>");
     
    //step 8
    echo("8.Get all the attributes of the element with number 0 in the zero frame: <br> <br>");
    echo(anchor.get_all_attributes_by_number(0,0) + "<br> <br>");
     
    //step 9
    echo("9.Add an attribute to a nonexistent element in a zero frame:");
    if(!anchor.add_attribute_by_number(100500, "target1", "value1", 0))
    echo("no such element <br> <br>");
     
    //step 10
    echo("10.Add an attribute to an element in a non-existent frame:");
    if(!anchor.add_attribute_by_number(1, "target2", "value2", 5))
    echo("no such frame");
     
    //end
    echo("<hr> <br>");
     
    //Quit
    app.quit();
  • en/objects/common/change_attributes/add_attribute_by_number.txt · Last modified: 2026/08/05 22:33 (external edit)