getInternalLink

Получает элемент - внутреннюю ссылку документа из всех, удовлетворяющих условиям

Синтаксис

getInternalLink = function(aIndex, aAttributes, aValues, Strong,
  aAntiAttributes, aAntiValues, aAntiStrong);

Параметры

  • aIndex
    • назначение: индекс искомого элемента
  • aAttributes
    • назначение: массив атрибутов искомого элемента
  • aValues
    • назначение: массив значений атрибутов, соответствующий массиву атрибутов искомого элемента
  • aStrong
    • назначение: флаг точности совпадения значений атрибутов
  • aAntiAttributes
    • назначение: массив исключающих атрибутов
  • aAntiValues
    • назначение: массив значений исключающих атрибутов
  • aAntiStrong
    • назначение: флаг точности совпадения значений исключающих атрибутов

Возвращаемое значение

  • назначение: структура, содержащая параметры найденного элемента

Замечания

  • При поиске элемента скрипт перебирает все элементы, которые имеют значения aValues атрибутов aAttributes. Из этих элементов скрипт выбирает те элементы, которые не имеют значения aAntiValues атрибутов aAntiAttributes. Если флаг aStrong равен true, то будет найден элемент, значения aValues свойств aAttributes которого строго равны указанным (регистр при поиске не учитывается). В противном случае будет найден элемент, в значения свойств aAttributes которого входят соответствующие значения aValues. Аналогично и с флагом aAntiStrong.
  • Если индекс искомого элемента aIndex равен -1, то будет получен случайный элемент из найденных
  • Если элемент не найден, то поля результирующей структуры будут пусты.
  • Найденный элемент будет подсвечен пунктирной рамкой
  • Внутренняя ссылка - ссылка, ссылающаяся на один из документов загруженного сайта

Примеры

  1. //Получаем случайный элемент из всех внутренних ссылок страницы,
    //имеющих значение атрибута "class" равным "decorated"
    var link = getInternalLink(-1,['class'],['decorated'],true);