data:blog.locale - Blogger Data Documentation
- Description de la donnée
data:blog.localeest une donnée universelle Blogger contenant les informations en rapport avec la langue du blog (Langue, pays/territoire, etc...).- Intégration dans le code XML
- Dans les nœuds enfants de la balise
<html>, excepté à l'intérieur des marqueurs<![CDATA[ ]]>. - Directives d'usage et niveau de priorité de mise à jour
-
Thème Version 1Garantie d'usage : AbandonnéPriorité indéfinieThème Version 2Garantie d'usage : OuiPriorité moyenneThème DynamiqueGarantie d'usage : OuiPriorité moyenneThème Version 3Garantie d'usage : OuiPriorité haute
- Disponibilité par défaut par type de pages
- Indéfini.
- Longueur maximum de la valeur
- Indéfini.
- Set de réglages XML
- Disponible.
- Condition additionnelle
- Aucune.
- Donnée universelle similaire
blog.localeUnderscoreDelimited- Données de gadget similaires
languageCodepageLanguage
Table des matières
Ressources
Échantillonnage des ressources
blog:
locale: locale,
name: string,
language: string,
country: string,
variant: string,
languageDirection: string,
languageAlignment: string,
size: number,
length: number,
escaped: string,
jsEscaped: string,
jsonEscaped: string,
cssEscaped: string
Parenté - Enfant de :
- Global
bloglocale
Caractéristiques et valeurs
| Langue | Territoire | Valeur |
|---|---|---|
| Français | France | fr |
| Français | Canada | fr-CA |
| Anglais | États-Unis | en |
| Anglais | Royaume-Uni | en-UK |
| Espagnol | Amérique Latine | es-419 |
| Espagnol | Espagne | es |
| Portugais | Brésil | pt-BR |
| Portugais | Portugal | pt-PT |
| Indonésien | Indonésie | id |
| Vietnamien | Vietnam | vi |
Les résultats dépendent principalement de 2 facteurs, le premier étant le réglage via l'interface qui défini la langue/pays du blog par défaut.
- UI
- Paramètres
- Général
- Langue du blog
Le second facteur est le paramètre hl ajouté à l'url de la page courante :
https://BLOG_NAME.blogspot.com?hl=values
Le paramètre hl attend ces valeurs : langue-territoire-variante.
https://BLOG_NAME.blogspot.com?hl=fr-BE-wa
Implémentation de la donnée
Méthode de Référence Directe
<!-- Tag -->
<data:blog.locale/>
<!-- Attribute Value -->
<b:eval expr='data:blog.locale'/>
La Direct Reference Method est la méthode la plus simple et la plus directe pour accéder à une donnée. Elle consiste à insérer la donnée telle quelle dans le code XML, sans alias ni encapsulation. Cette approche est adaptée aux données primitives du schéma de données, celles qui peuvent être appelées directement sans transformation ni boucle.
Méthode d'Aliasing de l'Item
<b:with value='data:blog.locale' var='locale'>
<!-- Tag -->
<data:locale/>
<!-- Attribute value -->
<b:eval expr='data:locale'/>
</b:with>
L’Alias Item Method permet de stocker un item unique dans une variable temporaire à l’aide de <b:with>. Cette approche améliore la lisibilité du code et réduit la redondance lorsque la même valeur est utilisée plusieurs fois.
Méthode d'Aliasing de l'Objet
<b:with value='data:blog' var='b'>
<!-- Tag -->
<data:b.locale/>
<!-- Attribute value -->
<b:eval expr='data:b.locale'/>
</b:with>
L’Alias Object Method consiste à stocker un objet entier dans une variable temporaire à l’aide de <b:with>. Cette approche permet d’accéder facilement à plusieurs propriétés de l’objet sans répéter son chemin d’accès.
Réglages de la donnée
Les réglages sont des items contenus dans l'objet de la donnée qui renvoient une nouvelle valeur. Ils s'ajoutent à la suite de la donnée.
Introduction aux réglages des données
Les réglages autorisés pour cette donnée sont :
Localisation
<!-- NAME -->
<data:blog.locale.name/>
<!-- LANGUAGE -->
<data:blog.locale.language/>
<!-- VARIANT -->
<data:blog.locale.variant/>
<!-- COUNTRY -->
<data:blog.locale.country/>
Les informations de localisation peuvent obtenues individuellement en utilisant les suffixes name, language, variant et country.
Sens de lecture et alignement
<!-- LANGUAGE DIRECTION -->
<data:blog.locale.languageDirection/>
<!-- LANGUAGE ALIGNMENT -->
<data:blog.locale.languageAlignment/>
Selon la langue, le sens de lecture peut varier. Ces indications peuvent être obtenues en utilisant les suffixes languageDirection et languageAlignment.
Longueur de la chaîne de caractères
<!-- WITH SIZE -->
<data:blog.locale.size/>
<!-- WITH LENGTH -->
<data:blog.locale.length/>
Le nombre de caractères de la chaîne peut être obtenu en utilisant les suffixes size ou length.
Échappements de la chaîne de caractères
<!-- HTML ESCAPED -->
<data:blog.locale.escaped/>
<!-- JS ESCAPED -->
<data:blog.locale.jsEscaped/>
<!-- JSON ESCAPED -->
<data:blog.locale.jsonEscaped/>
<!-- CSS ESCAPED -->
<data:blog.locale.cssEscaped/>
La chaîne de caractères peut être échappée en utilisant les suffixes escaped, jsEscaped, jsonEscaped et cssEscaped.
Exemple d'utilisation
Proposer aux lecteurs de visualiser le blog sous une autre langue.
<b:if cond='data:blog.locale.language != "fr"'>
<a expr:href='data:view.url params { hl: "fr" }'>
Voir ce blog en Français
</a>
</b:if>
<b:if cond='data:blog.locale.language != "en"'>
<a expr:href='data:view.url params { hl: "en" }'>
View this blog in English
</a>
</b:if>
Alias dans le modèle
Cette section permet d'identifier les emplacements dans le fichier XML où la donnée est implémentée sous différents alias. L’alias peut être identique à la clé d’origine ou être une adaptation spécifique à une ou plusieurs inclusions.
Dans le tableau ci-dessous, nous ne mentionnons que les assignations directes sans manipulation de la valeur, à l'exception des réglages appliqués par suffixe.
| Alias | ID Inclusion | Balisage |
|---|---|---|
blog.locale |
googlePlusBootstrap |
Original |
blog.locale.languageAlignment |
behindImageStyle |
Original |
blog.locale.language |
content |
Original |
blog.locale |
<html> |
Simple
Picture Window
Awesome Inc.
Watermark
Ethereal
Travel
Dynamic
Contempo
Emporio
Essential
Notable
Soho
|
