1
0
mirror of https://github.com/Jermolene/TiddlyWiki5 synced 2024-12-26 01:50:28 +00:00
TiddlyWiki5/editions/fr-FR/tiddlers/TranscludeWidget.tid

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"/>
'>>