get_y_by_attribute

get_y_by_attribute($attr_name,$attr_value,$exactly=true,$frame=-1); - this function is used to get the y-coordinate of the upper-left corner of an element, finding it by the specified attribute value 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 function String.search.

$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 :

y-coordinate – the y coordinate of the upper left corner of the element relative to the upper left corner of the browser + the elements of the containers, if any, the return type of string

-1 to find this element failed (e.g. no items that meet the specified criteria or not this frame), return type int

PHP example:

  anchor->".basename(__FILE__)." ";

//1
echo "1.Let's go to the polygon:";
echo $browser->navigate("http://humanemulator.net/poligon/anchor.html")."
";

//2
echo "2.get Y element with 'alt' attribute equal to 'list':";
echo $anchor->get_y_by_attribute("alt", "list")."
";

//3
echo "3.get the Y element containing 'ist' in the 'alt' attribute:";
echo $anchor->get_y_by_attribute("alt", "ist", false)."
";

//4
echo "4.get Y of a nonexistent link:";
if($anchor->get_y_by_attribute("alt", "list1ee3111") == - 1)
  echo "no such element 
";

//five
echo "5.get the Y element containing 'ist' in the 'alt' attribute in frame zero:";
echo $anchor->get_y_by_attribute("alt", "ist", false, 0)."
";

//6
echo "6.get Y of a nonexistent link in a zero frame:";
if($anchor->get_y_by_attribute("alt", "list1ee3111", false, 0) == - 1)
  echo "no such element 
";

//7
echo "7.get Y links in a nonexistent frame:";
if($anchor->get_y_by_attribute("alt", "ist", false, 100500) == - 1)
  echo "no such frame 
";

//end
echo "
 
";

//Quit
$app->quit();
?>

Python example:

# Additional paths
import sys
sys.path.insert(0, '../../../Templates PY/')

xhe_host = "127.0.0.1:7010"
from xweb_human_emulator import *

# Start
echo("
  common.xxxxxxxxx  ")

# 1
echo("1.Let's go to the polygon:")
echo(browser.navigate("http://www.humanemulator.net/poligon/anchor.html"), "
")

# 2
echo("2.get Y element with 'alt' attribute equal to 'list':")
echo(anchor.get_y_by_attribute("alt", "list"), "
")

# 3
echo("3.get the Y element containing 'ist' in the 'alt' attribute:")
echo(anchor.get_y_by_attribute("alt", "ist", false), "
")

# 4
echo("4.get Y of a nonexistent link:")
if anchor.get_y_by_attribute("alt", "list1ee3111") == - 1:
  echo("no such item 
")

# five
echo("5.get the Y element containing 'ist' in the 'alt' attribute in frame zero:")
echo(anchor.get_y_by_attribute("alt", "ist", false, 0), "
")

# 6
echo("6.get Y of a nonexistent reference in a zero frame:")
if anchor.get_y_by_attribute("alt", "list1ee3111", false, 0) == - 1:
  echo("no such item 
")

# 7
echo("7.get Y links in a nonexistent frame:")
if anchor.get_y_by_attribute("alt", "ist", false, 100500) == - 1:
  echo("no such frame 
")

# end
echo("
 
")

# 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:7010";
InitXHE();

//Start
echo("
  get_y_by_attribute  ");

//1 step
echo("1.Let's go to the polygon:");
echo(browser.navigate("www.humanemulator.net/poligon/anchor.html") + "
");

//step 2
echo("2.get y for element with 'alt' attribute equal to 'list':");
echo(anchor.get_y_by_attribute("alt", "list") + "
");
browser.wait(1);

//step 3
echo("3.get y for the element containing 'list' in the 'alt' attribute:");
echo(anchor.get_y_by_attribute("alt", "list", false) + "
");
browser.wait(1);

//4 step for the frame
echo("4.get y for the element containing 'list' in the 'alt' attribute in frame 0:");
echo(anchor.get_y_by_attribute("alt", "list", false, "0") + "
");

//step 5
echo("5.get y for element with 'alt' attribute equal to 'list1ee3111':");
if(anchor.get_y_by_attribute("alt", "list1ee3111") == - 1)
echo("link not found 
");

//end
echo("
 
");

app.quit();
}
}

Java Script example:

//IE + Chrom

//connect the object to control the emulator, if not already connected
xhe_host = "127.0.0.1:7010";
echo = require("../../../Templates JS/xweb_human_emulator.js");

//Start
echo("
  anchor.get_y_by_attribute  ");

//1 step
echo("1.Let's go to the polygon:");
echo(browser.navigate("http://www.humanemulator.net/poligon/anchor.html") + "
");

//step 2
echo("2.get Y element with 'alt' attribute equal to 'list':");
echo(anchor.get_y_by_attribute("alt", "list") + "
");

//step 3
echo("3.get Y element containing 'ist' in 'alt' attribute:");
echo(anchor.get_y_by_attribute("alt", "ist", false) + "
");

//step 4
echo("4.get Y of a nonexistent link:");
if(anchor.get_y_by_attribute("alt", "list1ee3111") == - 1)
  echo("no such element 
");

//step 5
echo("5.get the Y element containing 'ist' in the 'alt' attribute in frame zero:");
echo(anchor.get_y_by_attribute("alt", "ist", false, 0) + "
");

//step 6
echo("6.get Y of a nonexistent reference in a zero frame:");
if(anchor.get_y_by_attribute("alt", "list1ee3111", false, 0) == - 1)
  echo("no such element 
");

//step 7
echo("7.get Y links in a nonexistent frame:");
if(anchor.get_y_by_attribute("alt", "ist", false, 100500) == - 1)
  echo("no such frame 
");

//end
echo("
 
");

//Quit
app.quit();