Ce sont les règles qui déterminent si le balisage est lu comme vous l’aviez prévu — et c’est là que la plupart des implémentations hCard échouent.
Combinaison de classes
Les classes hCard peuvent être combinées librement avec des classes CSS ordinaires, à la fois sur l’élément racine et sur les propriétés. Deux restrictions :
- A
vcardl’élément racine ne doit pas porter d’autre classe hCard. - Ne pas imbriquer les propriétés. A
telà l’intérieur d’unadrpeut être mal traité. L’exception est l’imbrication que le standard autorise explicitement :country-name,region,locality,street-address,extended-addressetpostal-codeà l’intérieuradr;latitudeetlongitudeà l’intérieurgeo.
La règle d’imbrication est facile à enfreindre par accident, car la disposition visuelle d’un bloc de contact place souvent le numéro de téléphone dans le paragraphe de l’adresse.
Comment les valeurs sont extraites
Normalement, la valeur est le texte visible à l’intérieur de l’élément. Deux exceptions portent toute la technique pratique :
<abbr>avectitle— la valeur est l’attribut, pas le texte.<abbr class="tel" title="+7 (890) 123-45-67">123-45-67</abbr>affiche un numéro local et publie le numéro complet.<a>avechrefpour les propriétés de type URL —url,email,logo,photo— où la valeur est la cible du lien.
L’alternative au balisage complet
Yandex indique que la soumission d’informations de contact via Géographie du site → Adresses et organisations dans la console est équivalent au balisage des pages: les données vont à Yandex Business et apparaissent dans les services Yandex dans les deux cas. Deux portes, une base de données.
Choisir entre les deux
Le balisage maintient le site comme source unique de vérité et se met à jour automatiquement lorsque la page change. Le formulaire offre des mises à jour plus rapides et un statut de modération visible. Pour une entreprise dont les coordonnées changent rarement, le formulaire demande moins de travail ; pour un réseau d’agences qui change souvent, le balisage est rentabilisé.
Comment nous l'appliquons
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.
Services associés