Das sind die Regeln, die darüber entscheiden, ob das Markup so gelesen wird, wie Sie es beabsichtigt haben — und hier machen die meisten hCard-Implementierungen Fehler.
Klassen kombinieren
hCard-Klassen können sowohl im Stammverzeichnis als auch bei Eigenschaften frei mit gewöhnlichen CSS-Klassen kombiniert werden. Zwei Einschränkungen:
- A
vcardDas Stammelement darf keine andere hCard-Klasse enthalten. - Verschachteln Sie keine Eigenschaften. A
telinnerhalb einesadrwird möglicherweise falsch verarbeitet. Die Ausnahme ist die Verschachtelung, die der Standard ausdrücklich erlaubt:country-name,region,locality,street-address,extended-addressundpostal-codeinnerhalbadr;latitudeundlongitudeinnerhalbgeo.
Die Verschachtelungsregel lässt sich leicht aus Versehen brechen, da das visuelle Layout eines Kontaktblocks die Telefonnummer oft in den Adressabsatz setzt.
Wie Werte extrahiert werden
Normalerweise ist der Wert der sichtbare Text innerhalb des Elements. Zwei Ausnahmen tragen die gesamte praktische Technik:
<abbr>mittitle— der Wert ist das Attribut, nicht der Text.<abbr class="tel" title="+7 (890) 123-45-67">123-45-67</abbr>zeigt eine lokale Nummer und veröffentlicht die vollständige.<a>mithreffür URL-basierte Eigenschaften —url,email,logo,photo— wobei der Wert das Link-Ziel ist.
Die Alternative zum reinen Markup
Yandex gibt an, dass das Einreichen von Kontaktinformationen über Site-Geografie → Adressen und Organisationen in der Konsole äquivalent zum Auszeichnen der Seiten ist: Die Daten gehen an Yandex Business und erscheinen in beiden Fällen in den Yandex-Diensten. Zwei Türen, eine Datenbank.
Die Wahl zwischen beiden
Markup hält die Website als einzige Quelle der Wahrheit und aktualisiert sich automatisch, wenn sich die Seite ändert. Das Formular bietet schnellere Aktualisierungen und einen sichtbaren Moderationsstatus. Für ein Unternehmen, dessen Details sich selten ändern, macht das Formular weniger Arbeit; für ein Filialnetz, das sich oft ändert, zahlt sich das Markup aus.
So setzen wir das um
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.
Verwandte Leistungen