Introduction
Le Widget Transclude importe dynamiquement le contenu d'un autre tiddler.
Attributs
| Attribut | Description |
|---|---|
| tiddler | Le titre du tiddler à transclure (par défaut le tiddler courant) |
| field | Le nom du champ du tiddler (par défaut "text" ; si présent, a priorité sur l'attribut index) |
| index | L'index d'une propriété d'un Tiddler Data |
| subtiddler | Titre optionnel d'un sous-tiddler quand le tiddler cible est un plugin (voir infra) |
| mode | Force le mode d'analyse du texte transclus à "block" ou à "inline" (voir infra) |
Le Widget Transclude traite son propre contenu comme cible par défaut si la cible de transclusion n'est pas complètement définie (ex : un tiddler ou un champ manquant)
Modes d'analyse
TiddlyWiki analyse le WikiTexte dans deux modes :
- le mode « en ligne » (inline) reconnaît les formats de caractères, tels que l'emphase, les liens
- le mode « bloc » (block) reconnaît tous les formats en ligne, et ajoute les formats de blocs comme les tableaux, les listes et les titres
Habituellement, le mode bloc ou en ligne est déduit automatiquement du mode dans lequel le Widget Transclude lui-même a été analysé. Il peut toutefois être ajusté avec l'attribut mode.
Par exemple, considérons un tiddler « A » avec ce contenu :
# Article un
#<$transclude tiddler="B"/>
# Article deuxEt un tiddler « B » avec ce contenu :
# Article un - a
# Article un - bLe résultat donnera quelque chose comme :
- Article un
- # Article un - a # Article un - b
- Article deux
Cela peut être corrigé en modifiant le tiddler « A » :
# Article un
#<$transclude tiddler="B" mode="block"/>
# Article deuxVoir aussi ces autres exemples.
Accès aux sous-tiddlers
Le Widget Transclude permet l'accès aux tiddlers individuels inclus dans un plugin.
L'exemple suivant transclura la version initiale du tiddler noyau $:/DefaultTiddlers même s'il a été modifié :