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

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

Обработка карточки Яндексом осуществляется согласно правилам, определенным в спецификации формата.

Требования к структуре данных

Классы, предусмотренные форматом hCard, можно произвольным образом комбинировать с другими CSS-классами. Так, атрибут class корневого элемента карточки может содержать, помимо имени класса vcard, любой набор имен классов, не являющихся hCard-классами, например:

<div class="vcard footer">...</div>

То же самое относится к элементам, являющимся свойствами карточки.

При этом существуют ограничения на комбинирование hCard-классов между собой. Недопустимо помечать элемент класса vcard другим hCard-классом. Настоятельно не рекомендуется также вкладывать одно свойство в другое, например помещать элемент с классом 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>
  

  В браузере отображается значение «123-45-67», а значением свойства tel является «+ 7 (890) 123-45-67».

• Элемент <a> с атрибутом href для URL-свойств (то есть свойств, значением которых является URL, а именно свойств url, email, logo и photo): значением свойства является значение атрибута href.

  Пример:

  <a class="fn org url" href="http://www.cafe.com">Кафе Ромашка</a>
  

  Значением свойства url является «http://www.cafe.com».

  Значением свойства fn и свойства org, которые не относятся к URL-свойствам, является «Кафе Ромашка».

• Элемент <img> с атрибутом src для URL-свойств: значением свойства является значение атрибута src.

• Элемент <img> с атрибутом alt для свойств, НЕ являющихся URL-свойствами: значением свойства является значение атрибута alt.

  Пример:

  <img class="logo fn org" alt="Кафе Ромашка" src="images/logo.gif">
  

  Значением свойства logo является «images/logo.gif», значением свойства fn и свойства org является «Кафе Ромашка».

Кроме того, можно специально пометить часть видимого текста элемента как значение свойства. Для этого в элемент добавляется вложенный элемент с классом value.

Пример:

<div class="tel">Справочная: <span class="value">+7 (890) 123-45-67</span></div>

В этом случае значением свойства tel является «+7 (890) 123-45-67».

Если требуется сделать значение свойства невидимым для посетителей сайта (отображать на странице вместо значения другой текст или вообще ничего не отображать), можно использовать вложенный элемент класса value-title с атрибутом title. В этом случае значением свойства является значение атрибута title.

Примеры:

<div class="tel">
  <span class="value-title" title="+7 (890) 123-45-67">123-45-67</span>
</div>

<div class="tel">
  <span class="value-title" title="+7 (890) 123-45-67"> </span> 123-45-67
</div>

В обоих примерах значением свойства tel является «+7 (890) 123-45-67». Второй вариант позволяет избежать появления всплывающей подсказки с «настоящим» значением свойства при наведении указателя мыши на номер телефона.