adr-ru

adr

Микроформат adr — это простой формат для разметки информации об адресах; подходит для внедрения в (X)HTML, Atom, RSS, XML. Данный формат является точной копией свойства adr из стандарта vCard, которое было таким образом портировано в HTML. Формат adr — один из многих других микроформатов. Помимо этого, данный микроформат является свойством hCard.

Авторство и правовые вопросы

Ниже расположена информация об авторах данного микроформата и правах, по которым он доступен.

Авторы

Автор

Tantek Çelik (Technorati, Inc)

Права

Автор указал, что данная работа является работой под лицензией Public Domain. Все редакторы данной страницы соглашаются с тем, что их правки также будут распространяться под Public Domain. Редакторы могут выразить своё согласие, вставив шаблон на свою страницу (инструкции). В противном случае все правки могут быть отменены или удалены.

Патенты

Данная спецификация — субъект политики патентования. См. подробнее:

• Политика патентования W3C
• RFC 3667 и RFC 3668

История

На конференции Where 2.0 в июне 2005 года сообщество обсуждало вопрос о необходимости разработки нового способа представления информации об адресах, которую можно было бы легко извлечь из контекста и легко визуально воспринимать. Сильным толчком к обсуждению было всё увеличивающееся количество блогов и других сайтов, которые публикуют разнообразную адресную информацию. Сообщество решило не изобретать что-то новое, а, в соответствии с принципами микроформатов, использовать уже существующий формат: adr из vCard/hCard.

Данная спецификация представляет микроформат adr.

Авторы могут внедрять адреса adr напрямую в собственные Web-страницы или RSS-ленты, однако если такие адреса уже существуют, их можно просто разметить микроформатом adr.

Если автор знает и публикует имя местоположения в дополнение к его адресу, то он должен использовать hCard, а не adr.

Формат

Одиночные свойства

См. описание hCard для информации об одиночных свойств adr.

Доступность для человека и машины

Если для разметки свойства используется элемент <abbr>, то не содержимое данного элемента, а его атрибут title является значением данного свойства. Содержимое элемента в данном случае содержит удобочитаемые для человека данные.

Аналогично, если элемент <img> используется для разметки свойств, он должен распознаваться следующим образом:

1. Для свойства PHOTO и других свойств, которые принимают URL как собственное значение, атрибут src и является этим значением.
2. Для других свойств значением будет являться значение атрибута alt.

Частичные значения

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

Корневое имя класса

Корневым именем класса для микроформата adr является класс adr. The root class name for an adr address is adr.

Список свойств

• post-office-box
• extended-address
• street-address
• locality
• region
• postal-code
• country-name

Подсвойство type было исключено, так как без контекста оно не имеет значения.

XMDP-профиль

См. описание hCard для информации о XMDP-профиле hCard, который содержит информацию о вышеописанных свойствах.

Информация об обработке

См. обработку hCard: обработка adr отличается от обработки hCard только именем корневого класса.

Примеры

Данный раздел является информативным.

Простой пример adr

<div class="adr">
 <div class="street-address">665 3rd St.</div>
 <div class="extended-address">Suite 207</div>
 <span class="locality">San Francisco</span>,
 <span class="region">CA</span>
 <span class="postal-code">94107</span>
 <div class="country-name">U.S.A.</div>
</div>

Который будет отображён браузером как:

665 3rd St.

Suite 207

San Francisco, CA 94107

U.S.A.

Другие примеры

См. примеры adr в hCard (англ.).

См. дополнительные примеры adr (англ.).

Ссылки

Нормативные

• hCard

Информативные

• vCard (RFC)
• XHTML 1.0 SE

Схожие работы

• geo
• hCalendar
• XOXO

Обсуждения

• См. поиск по Technorati.