data:title - Blogger Data Documentation
- Description de la donnée
data:titleest une donnée Blogger des gadgets « Articles du blog » et « En-tête de la page » contenant le nom du blog.- Intégration dans le code XML
- Dans les nœuds enfants des gadgets Blog et Header.
- 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 : ExpérimentalPriorité indéfinieThème DynamiqueGarantie d'usage : AucuneAucune prioritéThème Version 3Garantie d'usage : ExpérimentalPriorité indéfinieThème Version 1Garantie d'usage : OuiPriorité faibleThème Version 2Garantie d'usage : OuiPriorité moyenneThème DynamiqueGarantie d'usage : AucuneAucune prioritéThème Version 3Garantie d'usage : OuiPriorité haute
- Disponibilité par défaut par type de pages
- Toutes les pages.
- Longueur maximum de la valeur
- 100 caractères.
- Set de réglages XML
- Disponible.
- Condition additionnelle
- Aucune.
Table des matières
Ressources
Échantillonnage des ressources
widget:
type: Blog|Header,
version: 1 | 2
,
this:
title: string,
size: number,
length: number,
escaped: string,
jsEscaped: string,
jsonEscaped: string,
cssEscaped: string
Caractéristiques et valeurs
Le titre du blog peut être personnalisé via le panneau de configuration de ce gadget :
- UI
- Mise en page
- Modifier gadget Header
- Titre du blog
Ou via le tableau de bord :
- UI
- Paramètres
- Général
- Titre
Implémentation de la donnée
Méthode de Référence Directe
<b:includable id='main'>
<!-- Tag -->
<data:title/>
<!-- Attribute value -->
<b:eval expr='data:title'/>
</b:includable>
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:includable id='main'>
<b:with value='data:title' var='element'>
<!-- Tag -->
<data:element/>
<!-- Attribute value -->
<b:eval expr='data:element'/>
</b:with>
</b:includable>
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’Instance du Gadget
<b:includable id='main' var='this'>
<!-- Tag -->
<data:this.title/>
<!-- Attribute value -->
<b:eval expr='data:this.title'/>
</b:includable>
La Gadget Instance Aliasing Method consiste à stocker l’instance du gadget en cours dans une variable temporaire définie dans la balise principale <b:includable>, afin de faciliter l’accès à ses données. Elle permet également de réutiliser les inclusions enfants (ou inclusions communes) qui partagent des jeux de données similaires, même lorsque les items ne sont pas situés 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 :
Longueur de la chaîne de caractères
<b:includable id='main'>
<!-- WITH SIZE -->
<data:title.size/>
<!-- WITH LENGTH -->
<data:title.length/>
</b:includable>
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
<b:includable id='main'>
<!-- HTML ESCAPED -->
<data:title.escaped/>
<!-- JS ESCAPED -->
<data:title.jsEscaped/>
<!-- JSON ESCAPED -->
<data:title.jsonEscaped/>
<!-- CSS ESCAPED -->
<data:title.cssEscaped/>
</b:includable>
La chaîne de caractères peut être échappée en utilisant les suffixes escaped, jsEscaped, jsonEscaped et cssEscaped.
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.
