74 lines
2.2 KiB
Plaintext
74 lines
2.2 KiB
Plaintext
caption: transclude
|
|
created: 20130824142500000
|
|
modified: 20150622210004977
|
|
tags: Widgets
|
|
title: TranscludeWidget
|
|
type: text/vnd.tiddlywiki
|
|
|
|
! Introduction
|
|
|
|
Le TranscludeWidget 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 courant (par défaut "text"<<;>> si présent, a priorité sur l'attribut index) |
|
|
|index |L'index d'une propriété d'un [[Data Tiddler|DataTiddlers]] |
|
|
|subtiddler |Titre optionnel d'un SubTiddler quand le tiddler cible est un [[plugin|Plugins]] (voir infra) |
|
|
|mode |change le mode d'analyse par défaut du texte transclu à "block" ou à "inline" |
|
|
|
|
Le TranscludeWidget traite tout contenu avec les solutions 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 texte par deux modes<<:>>
|
|
|
|
* le mode ''inline'' reconnaît les formats de caractères comme l'emphase, les liens
|
|
* le mode ''bloc'' reconnaît tous les formats ''inline'', et le complète des formats bloc comme les tableaux, les listes et les rubriques
|
|
|
|
Habituellement, le mode, bloc ou en ligne, est déterminé automatiquement par le widget transclude lui-même au moment de l'analyse. Ceci peut être ajusté par l'attribut `mode`.
|
|
|
|
Par exemple, considérons un tiddler "A" avec ce contenu<<:>>
|
|
|
|
```
|
|
|
|
# Article un
|
|
#<$transclude tiddler="B"/>
|
|
# Article deux
|
|
```
|
|
|
|
Et un tiddler "B" avec ce contenu<<:>>
|
|
|
|
```
|
|
|
|
# Article un - a
|
|
# Article un - b
|
|
```
|
|
|
|
Le 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 deux
|
|
```
|
|
|
|
! Accès au SubTiddler
|
|
|
|
Le transclude widget permet l'accès aux tiddlers individuels mémorisés dans un [[plugin|Plugins]].
|
|
|
|
L'exemple suivant transclura la version initiale d'un tiddler noyau [[$:/DefaultTiddlers]] même si il a été modifié<<:>>
|
|
|
|
<<wikitext-example-without-html '
|
|
<$transclude tiddler="$:/core" subtiddler="$:/DefaultTiddlers"/>
|
|
|
|
'>>
|