Основной сайт хуманэмулятор.рф  |  Демо  |  Купить  |  API  |  Wiki



DOM / общее для всех DOM



get_number_by_href

get_number_by_href($href,$exactly=true,$frame=-1); - данная функция используется для получения номера элемента на странице (нумерация начинается с нуля), находя его по заданному href или его части. (Доступно с версии 4.6.3)

Функция на вход принимает параметры:

  • $href – href по которому мы находим необходимый нам элемент на странице (string). Чтобы узнать href элемента, можно воспользоваться либо инспектором элементов, либо контекстным меню, либо посмотреть его в списке элементов.
  • $exactly – точное соответствие href при поиске элемента (boolean), по умолчанию 1 - href элемента должен полностью совпадать с переданным параметром ($href), если этот параметр задан как 0, то будет найден первый элемент в href которого содержится заданная строка ($href). Начиная с версии 7.0.25 можно пердавать значение 2, тогда href будет восприниматься как регулярное выражение для функции Java Script String.search.
  • $frame – номер фрейма, в котором мы ищем элемент (string). Номера фреймов начинаются с нуля. По умолчанию -1 - элемент находится не во фрейме. Номер фрейма в котором находится нужный вам элемент можно узнать из инспектора задач, контекстного меню и панели списка элементов.
    С версии 4.6.41 достпуно: можно передавать вложенные фреймы, принцип такой же самый, передается строка с номерами фреймов, разделенных : например при передаче "1:0:5" - будет выбран фрейм с номером 1 в нем под фрейм с номером 0 и в нем подфрейм с номером 5
    С версии 7.0.38 достпуно: можно передавать "url=>XXX", тогда будет произведен поиск фрейма, который содержит заданнй src, или передавать "name=>XXX" - тогда будет поиск фрейма, по заданной части имени.

    После отработки функция возвращает результат своей работы в скрипт :
  • номер элемента – номер найденного элемента (нумерация элементов начинается с нуля), тип возвращаемого значения string
  • -1 – найти такой элемент не удалось (например нет вообще элементов, удовлетворяющих заданным критериям или нет такого фрейма), тип возвращаемого значения int

    Пример использования (PHP):
    ===============================================================