get_all_by_properties
get_all_by_properties($properties,$frame=-1); - this function is used to get a list of DOM interfaces of page elements, finding them by the specified properties. (Available from version 4.10.12)
$properties – string with the property search condition (string).
Each condition in a string consists of 3 substrings separated by ; "property;value_property;condition" :
- property - can be named attribute either x,y,width,height - dimensions and correlates , or inner_text.inner_html,outer_text,outer_html - texts
- value_property - value of the property for comparison via the
- condition - comparison condition :
- 0 - contains the value
- 1 - the value matches
- 2 - the Value does not match
- 3 - the Value is greater than the specified
- 4 - Less than the specified value
For example:
- "id;list;1" - the first element with the attribute id=list.
- "inner_text;DOM;1;x;200;3;y;500;3" - the first element with the text DOM and x>200 y>500:
- "inner_text;DOM;0;x;200;4;y;500;4" - the first element with text that contains DOM and x<200 y<500:
$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 testing, the function returns the result of its work to the script :
list of DOM interfaces of elements – an object that allows you to quickly perform any operations with all found elements (in fact, an array of interfaces to DOM elements that allows you to perform all operations together, which can be performed separately), the return value type XHEInterfaces