Popup articles или всплывающие статьи представляют собой механизм разметки перевода так, чтобы при нажатии на элемент статьи можно было часть контента отобразить во всплывающем окне (актуально для десктопов и планшетов, т.е. платформ, где достаточно экранного места). Зачастую применяется для отображения расшифровки аббревиатур.
Фактически, открываемый в отдельном окне текст всплывающей статьи является самостоятельной статьей, а сам <popup_article> – подвидом ссылки
Примеры блоков:
<popup_article list_entry_id="eid_abbreviation_1" title="example" label="short"><part_of_speech>adv.</part_of_speech></popup_article>
...
<popup_article title="example" dictid="5555" listidx="0" key="abbrev."><part_of_speech>abbrev.</part_of_speech></popup_article>Атрибуты всплывающих статей:
- list_entry_id – id записи списка (атрибута “id” у <article>), перевод которой нужно будет отобразить при нажатии на текст внутри popup_article
- title – атрибут, позволяющий сделать аннотацию к контенту внутри popup_article (т.к. в общем случае там не просто текст, а просто часть вёрстки, которая может, например, иметь картинки); на практике не использовался
- label – метка, к которой нужно в момент загрузки подмотать текст открываемой статьи
- dictid – DictID (4-символьный, т.е. без расширения “.sdc”) словарной базы, из которой нужно взять перевод для отображения всплывающей статьи; несовместимо с атрибутом list_entry_id (т.к. тот напротив указывает на необходимость использовать текущую базу как источник данных)
- listidx – индекс списка слов, в котором нужно искать статью для отображения контента всплывающего окна по ключу (описание ниже)
- key – текстовый ключ, по которому нужно в словарной базе с DictID в списке с индексом listidx поискать статью и получить ее перевод для отображения во всплывающем окне. Предполагается, что значение ключа бинарно (посимвольно) совпадает с текстом одного из заголовков в этом списке
На контент внутри <popup_article> накладываются следующие ограничения:
- как и в случае других метаданных, это не может быть непосредственно текст – он должен быть обёрнут в отдельный стиль (как “part_of_speech” на примере выше)
- как и в случае других метаданных, подобных ссылкам, не допускается размещения одних ссылок внутри других (например, <popup_article> внутри <link> или <url>), т.к. это привело бы к неопределенности при нажатии на текст (непонятно, обрабатывать нажатие как переход по ссылке или как отображение во всплывающем окне)