Работаем с DOM структурой

Последовательности

Иногда требуется разделить последовательность нод на логические блоки, используя заголовок (лидирующую ноду логического блока) или подвал (завершающую ноду логического блока). Для этого можно использовать команду sequence. Это команда, в отличии от команды split, работает не с контентом, а с нодами текущего блока, поэтому как параметры туда передаются CSS-селекторы.

В команде используюся следующие параметры:

Параметр	Описание
selector	Селекторы для нод, которые должны быть выбраны в текущем блоке. Примите во внимание, что ноды, используемые как заголовок или подвал, также должны выбираться селекторами в этом параметре.
header	Селектор для нод, которые будут использоваться как заголовки логических блоков. При использовании этого параметра, параметр footer будет проигнорирован, если он передан.
footer	Селектор для нод, которые будут использоваться как подвал логических блоков. При использовании параметра header, этот параметр будет проигнорирован, если он передан.

В качестве примера возьмем следующий HTML код:

          <div>
    <h1>Some title</h1>
    <p>Some text 1</p>
    <p>Some text 1 - 1</p>
    <p class="footer">My footer</p>
    <h1>Some other title</h1>
    <p>Some text 2</p>
    <p class="footer">My other footer</p>
    <h1>Another title</h1>
    <p>Some text 2</p>
    <p>Final p</p>
    <p class="footer">My last footer</p>
</div>

Как вы можете заметить, в качестве лидирующей ноды для разделения на дополнительные блоки в этом примере мы можем взять тег h1 или в качестве подвала использовать тег p имеющий класс footer.

Теперь попробуем разбить общий блок div на ряд отдельных, независимых блоков.
Рассмотрим это более подробно на примерах:

Разбивка по заголовку
Разбивка по подвалу

              - find:
    path: div 
    do:
    - sequence:
        selector: p,h1
        header: h1

    # В ДАННЫЙ МОМЕНТ МЫ ПЕРЕЙДЕМ В НОВЫЙ БЛОК
    # СОЗДАННЫЙ КОМАНДОЙ `sequence` С HTML СОДЕРЖИМЫМ:
    # <div class="sequence element_0">
    #     <h1>Some title</h1>
    #     <p>Some text 1</p>
    #     <p>Some text 1 - 1</p>
    #     <p class="footer">My footer</p>
    # </div>
    # <div class="sequence element_1">
    #     <h1>Some other title</h1>
    #     <p>Some text 2</p>
    #     <p class="footer">My other footer</p>
    # </div>
    # <div class="sequence element_2">
    #     <h1>Another title</h1>
    #     <p>Some text 2</p>
    #     <p>Final p</p>
    #     <p class="footer">My last footer</p>
    # </div>

    # ВЫПОЛНИМ ПОИСК И НАЙДЕМ ЗАГОЛОВОК ПОСЛЕДНЕГО ЭЛЕМЕНТА
    - find:
        path: .sequence > h1
        slice: -1
        do:
        - parse
        # РЕГИСТР ТЕПЕРЬ СОДЕРЖИТ: Another title

              - find:
    path: div 
    do:
    - sequence:
        selector: p
        footer: p.footer

    # В ДАННЫЙ МОМЕНТ МЫ ПЕРЕЙДЕМ В НОВЫЙ БЛОК
    # СОЗДАННЫЙ КОМАНДОЙ `sequence` С HTML СОДЕРЖИМЫМ:
    # <div class="sequence element_0">
    #     <p>Some text 1</p>
    #     <p>Some text 1 - 1</p>
    #     <p class="footer">My footer</p>
    # </div>
    # <div class="sequence element_1">
    #     <p>Some text 2</p>
    #     <p class="footer">My other footer</p>
    # </div>
    # <div class="sequence element_2">
    #     <p>Some text 2</p>
    #     <p>Final p</p>
    #     <p class="footer">My last footer</p>
    # </div>

    # ВЫПОЛНИМ ПОИСК И НАЙДЕМ ПОДВАЛ ПОСЛЕДНЕГО ЭЛЕМЕНТА
    - find:
        path: .sequence > p.footer
        slice: -1
        do:
        - parse
        # РЕГИСТР СОДЕРЖИТ: My last footer

В следующей главе мы научимся создавать новый блок из содержимого регистра.