В качестве имени события может быть указано одно из значений start, end, text, comment, declaration, process или default. Чаще всего применяются первые три события. Событие start активизируется при обнаружении синтаксическим анализатором начального тега, такого как <strong>. Событие end активизируется при обнаружении синтаксическим анализатором конечного тега, такого как </strong>, а события text возникают при появлении текста, заключенного между тегами. Таким текстом может стать содержимое сайта StarCraft 2 - скачать через торрент игру . Событие comment активизируется при появлении комментариев HTML, а события declaration и process в основном относятся к элементам разметки XML. И наконец, событие default представляет собой универсальную ловушку для тех элементов, которые явно не обрабатываются где-то в другом месте.
Параметр $args представляет собой строку, содержащую разграниченный запятыми список информационных элементов, который должен быть передан обработчику событий синтаксическим анализатором. Эта информация передается в виде параметров поя программы точно в таком же порядке, в каком они указаны в списке $args. Число возможных параметров очень велико. Ниже перечислены наиболее часто применяемые.
tagname. Имя тега.
text. Полный текст элемента, активизировавшего событие, включая ограничители разметки.
dtext. Декодированный текст, в котором удалена разметка, а символьные компоненты преобразованы в обычные символы.
attr. Ссылка на хеш, содержащий атрибуты и значения тега.
self . Копия самого объекта HTML::Parser.
string. Литеральная строка (одинарные или двойные кавычки являются обязательными!).