data:blog.locale - Blogger Data Documentation

Blogger - data:blog.locale
Data Type Gadget Version 1 Gadget Version 2
locale Global Global
Description de la donnée
data:blog.locale est 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 1
Garantie d'usage : Abandonné
Priorité indéfinie
Thème Version 2
Garantie d'usage : Oui
Priorité moyenne
Thème Dynamique
Garantie d'usage : Oui
Priorité moyenne
Thème Version 3
Garantie d'usage : Oui
Priorité 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
languageCode
pageLanguage


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
  • blog
  • locale


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.

Exemple
https://BLOG_NAME.blogspot.com?hl=fr-BE-wa


Implantation de la donnée

Syntaxe basique

<!-- Tag -->
<data:blog.locale/>

<!-- Attribute value -->
<b:eval expr='data:blog.locale'/>

Syntaxe d'uniformisation

<b:with value='data:blog' var='this'>

  <!-- Tag -->
  <data:this.locale/>

  <!-- Attribute value -->
  <b:eval expr='data:this.locale'/>

</b:with>

La syntaxe d'uniformisation est une méthode qui consiste à inclure l'item dans un objet afin d'obtenir la formule object.item. Cette méthode permet de faciliter la réutilisation d'inclusions contenant les mêmes jeux de données, même si les items ne sont pas dans le même nœud ou dans le même dictionnaire.



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.

Paramètres de localisation

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.

Paramètres sens de lecture et alignement

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.

Longueur de la chaîne de caractères

É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.

Échappements de la chaîne de caractères



Exemple d'utilisation

Proposer aux lecteurs de visualiser le blog sous une autre langue.
XML
<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>


Récipients dans le thème

Cette section répertorie les emplacements des récipients qui accueillent cette donnée.

ID Inclusion Balisage
googlePlusBootstrap
Original
behindImageStyle
Original
content
Original
<html>
Simple
Picture Window
Awesome Inc.
Watermark
Ethereal
Travel
Dynamic
Contempo
Emporio
Essential
Notable
Soho


Spotlight

Populaires cette semaine