hCard microformat

Правила обработки разметки

Ask AI about this page

2 мин чтения

Это правила, которые определяют, будет ли разметка прочитана так, как вы задумывали, и именно здесь допускает ошибки большинство реализаций hCard.

Связывание классов

Классы hCard можно свободно комбинировать с обычными CSS-классами как для корневого элемента, так и для свойств. Два ограничения:

Правила обработки разметки
  • A vcard корневой элемент не должен содержать другой класс hCard.
  • Не вкладывайте свойства друг в друга. A tel внутри adr может обрабатываться некорректно. Исключением является вложенность, которую стандарт разрешает явно: country-name, region, locality, street-address, extended-address и postal-code внутри adr; latitude и longitude внутри geo.

Правило вложенности легко нарушить случайно, так как визуальное оформление блока контактов часто помещает номер телефона внутрь абзаца с адресом.

Как извлекаются значения

Обычно значением является видимый текст внутри элемента. Два исключения охватывают весь практический метод:

  • <abbr> с title — значением является атрибут, а не текст. <abbr class="tel" title="+7 (890) 123-45-67">123-45-67</abbr> показывает локальный номер и публикует полный.
  • <a> с href для свойств со значением URL — url, email, logo, photo — где значением является цель ссылки.

Альтернатива разметке в целом

Яндекс заявляет, что отправка контактной информации через География сайта → Адреса и организации в консоли является эквивалентом разметки страниц: данные поступают в Яндекс Бизнес и в любом случае появляются в сервисах Яндекса. Две двери, одна база данных.

Правила обработки разметки — 2

Выбор между ними

Разметка сохраняет сайт в качестве единственного источника правды и автоматически обновляется при изменении страницы. Форма обеспечивает более быстрое обновление и видимый статус модерации. Для бизнеса, чьи данные меняются редко, форма требует меньше работы; для сети филиалов, которая часто меняется, разметка окупает себя.

Alien Road

Как мы это применяем

The nesting restriction is the one we check first on an existing implementation, because a phone number inside an address block is exactly how a designer would lay it out and exactly what Yandex warns against. The abbr-with-title trick is worth knowing beyond hCard: it is the clean way to publish a canonical machine value while showing a friendlier one to readers.

Связанные услуги

Поделиться