====== get_by_properties ======

**Каноническая страница:** [[https://humanemulator.net/objects/DOM/a_common/get_dom/get_by_properties.php|https://humanemulator.net/objects/DOM/a_common/get_dom/get_by_properties.php]]

[[objects:start|← Objects]]

----

Справка Human Emulator общее DOM: get_by_properties

Общие функции"; ?>

get_by_properties

get_by_properties($properties,$frame=-1);
- данная функция используется для получения DOM интерфейса элемента страницы, находя его по одному или нескольким его свойствам (аттрибуты,координаты, размеры тексты)

Доступна с версии 4.10.10

* $properties – строка со условием поиска свойств (string).

Каждое условие в строке состоит из 3 подстрок разделенных ; "свойство;значение_свойста;условие" :

* свойство - может быть именеем аттрибута либо x,y,width,height - размерами и коррдинатами , либо inner_text.inner_html,outer_text,outer_html - текстами

* значение_свойства - значение свойтсва для сравнения через условие

* условие  - условие сравнения :

* 0 - содержится значение

* 1 - значение совпадает

* 2 - Значение не совпадает

* 3 - Значение больше заданного

* 4 - Значение меньше заданного

Например:

* "id;list;1" - первый элемент у котрого аттрибут id=list.

* "inner_text;DOM;1;x;200;3;y;500;3" - первый элеменгт с текстом DOM  и x>200 y>500:

* "inner_text;DOM;0;x;200;4;y;500;4" - первый элеменгт с текстом который содержит DOM  и x