Guide de syntaxe XWiki
Modifié par Admin Xwiki le 2026/07/16 11:34
Syntaxe XWiki 2.1 » Programmer » Macros
Syntaxe XWiki 2.1: Macros
2.0 Macros
En syntaxe XWiki 2.0, il y a aussi deux types de macros:
- Les macros Velocity appelées en utilisant la syntaxe #macroname(param1 ... paramN) dans la Macro Velocity
- Les macros XWiki appelées en utilisant la syntaxe{{macroname param1="value1" ... paramN="valueN"}}
| Fonctionnalité | Syntaxe XWiki 2.1 | Résultat |
|---|---|---|
| Macro | {{code language="java"}}
System.out.println("Hello World!");
{{/code}}
| System.out.println("Hello World!"); |
Macros dans ce wiki
| Id | Nom | Catégories | Description | Visibilité |
|---|---|---|---|---|
| activity | Activité | Notifications | La macro Activity affiche l'activité récente des utilisateurs dans le wiki, elle fournit des information concernant les pages (création, édition, suppression) ainsi que sur les annotations, les commentaires et les pièces jointes. | Wiki courant |
| async | macro async | Contenu | Exécution asynchrone et/ou mise en cache du contenu de la macro. | Globale |
| attachmentGalleryPicker | Sélecteur de pièces jointes | Développement | Grille de sélection des pièces jointes. | Globale |
| attachmentSelector | Sélecteur de pièce jointe | Développement | Un contrôle à utiliser pour les propriétés de l'objet du document actuel qui sont censées contenir le nom d'une pièce jointe à partir du document courant (ou cible). Autorise le chargement de nouvelles pièces jointes, et la suppression des pièces jointes à partir du document cible. Si aucun document cible n'est spécifié, le document actuel sera utilisé. Les propriétés de l'objet ne sont enregistrées que dans le document actuel. | Wiki courant |
| awmkanban | Kanban board for AppWithinMinutes | Display XWiki Documents from an AWM as a Kanban board (see https://en.wikipedia.org/wiki/Kanban_board). | Globale | |
| blogpostcreate | Blog Post Create | The Blog Post Create macro is used to insert a post creation form. The macro takes a blog descriptor document as parameter. The new blog posts will belongs to the blog specified in the parameter. | Wiki courant | |
| blogPostLayoutCards | Cards Blog Post Layout | This macro is used to display a blog post using the 'Cards' layout | Wiki courant | |
| blogPostLayoutCompact | Blog Post Layout Compact | This macro is used to display a full blog post in a compact mode | Wiki courant | |
| blogPostLayoutFull | Blog Post Layout Full | This macro is used to display a full blog post | Wiki courant | |
| blogPostLayoutImage | Blog Post Layout Image | This macro is used to display a full blog post with a thumbnail image | Wiki courant | |
| blogPostLayoutLink | Blog Post Layout Link | This macro is used to display a blog post as a simple link | Wiki courant | |
| blogpostlist | Blog post list | The BlogPostMacro is used to search and display blog posts based on some parameters, the results can be displayed using customizable templates. | Wiki courant | |
| blogs | Livetable de tous les blogs | La macro «Blogs» est utilisée pour lister dans une livetable tous les blogs disponibles sur le wiki. | Wiki courant | |
| box | Boîte | Format | Affiche une boîte autour du contenu entré. | Globale |
| button | Macro bouton | Insérez un bouton visible et cliquable sur votre page XWiki pour mettre en évidence les liens et inciter à réaliser des actions ! | Globale | |
| cache | Cache | Développement | Contenu des caches. | Globale |
| chart | Graphique | Contenu | Affiche un graphique généré à partir d'une source de données | Globale |
| checkbox | Checkbox | Contenu | Affiche une simple case à cocher à côté d'un contenu textuel. | Globale |
| children | Enfants | Navigation | Affiche un arbre des pages enfants de la page courante | Wiki courant |
| code | Code | Format | Permet d'afficher des lignes de code dans un langage informatique donné | Globale |
| comment | Commentaire | Développement | Permet d'ajouter des commentaires dans le contenu source. Cette macro ne produit rien. | Globale |
| confluence_attachments | Confluence bridge for Attachments | Confluence | Confluence bridge for the Attachment macro | Wiki courant |
| confluence_children | Confluence bridge for Children | Confluence | Confluence bridge for the Children macro using the XWiki document tree macro. | Globale |
| confluence_column | Confluence bridge for Column | Confluence | Confluence bridge for the Column macro. | Wiki courant |
| confluence_contentbylabel | Confluence bridge for Content by label | Confluence Bridge for the Content by label macro | ||
| confluence_details | Confluence bridge for Details | Confluence Bridge for the Details (Page Properties) macro. It allows defining property key-value pairs in a table contained in the macro. | Globale | |
| confluence_detailssummary | Confluence bridge for Details Summary | Contenu | Confluence bridge for the Details Summary (Page Properties Report) macro to display properties attached to a page using the Details macro. | Globale |
| confluence_drawio | Confluence bridge for Drawio | Confluence | Confluence Bridge for the Drawio macro. By default it displays the PNG file used by the Drawio macro to preview the diagram. The user has the option to convert the diagram into an XWiki Diagram for being able to modify it. | Globale |
| confluence_favpages | Confluence bridge for Favorite Pages | Confluence | Confluence bridge for the Favorite Pages macro | Globale |
| confluence_float | Float macro | Confluence bridge for the Float macro using the XWiki box macro | Globale | |
| confluence_gallery | Confluence bridge for Gallery | Confluence | Confluence Bridge for the Gallery macro. | Globale |
| confluence_gliffy | Confluence bridge for Gliffy | Confluence | Confluence Bridge for the Gliffy macro. By default it displays the PNG file used by the Gliffy macro to preview the diagram. The user has the option to convert the diagram into an XWiki Diagram for being able to modify it. | Globale |
| confluence_htmlcomment | Confluence Bridge for HTML Comment | Confluence Bridge for HTML Comment macro. | Globale | |
| confluence_jirachart | Confluence Jira chart | Contenu | Confluence bridge macro for jira chart. | Globale |
| confluence_layout | Confluence bridge for Layout | Confluence | Confluence bridge macro for the Layout macro to define a layout, containing layout sections (using the confluence_layout-section macro). | Globale |
| confluence_layout-cell | Confluence bridge for Layout Cell | Confluence | Confluence bridge for the Layout Cell macro. It is used for defining a part a layout section, used inside the confluence_layout-section macro. | Globale |
| confluence_layout-section | Confluence bridge for Layout Section | Confluence | Confluence bridge for the Layout Section macro. It is used to define a section of a layout, used inside the layout macro and containing layout cells. | Wiki courant |
| confluence_mathblock | Confluence bridge for Mathblock | Confluence | Confluence bridge for the Mathblock macro (LaTeX math block expressions). | Globale |
| confluence_mathblock-ref | Confluence bridge for Mathblock Reference | Confluence | Confluence bridge macro for the Mathblock Reference macro | Globale |
| confluence_mathinline | Confluence bridge for Mathinline | Confluence | Confluence bridge macro for the Mathinline macro (LaTeX math inline expressions). | Globale |
| confluence_metadata-overview | Confluence Metadata Overview | Contenu | Confluence bridge macro for metadata-overview | Globale |
| confluence_mockup | Confluence bridge for Mockup | Confluence | Confluence Bridge for the Balsamiq Mockup macro. It only displays the image preview of the mockup. | Globale |
| confluence_multimedia | Confluence bridge for Multimedia | Confluence | Confluence Bridge for the Multimedia macro. | Globale |
| confluence_note | Confluence bridge for Note | Confluence | Confluence bridge for the Note macro to the XWiki Success macro | Globale |
| confluence_outgoing-links | Confluence Outgoing Links | Contenu | Confluence bridge macro for outgoing-links. | Globale |
| confluence_pagetree | Confluence bridge for Page Tree | Confluence | Confluence Bridge for the Confluence Page Tree macro to the XWiki documentTree macro. | Globale |
| confluence_paste-code-macro | Confluence bridge for Paste Code Macro | Confluence | Confluence bridge for the Confluence Paste Code macro to the XWiki Code macro | Globale |
| confluence_section | Confluence bridge for Section | Confluence | Confluence bridge for the Section macro | |
| confluence_time | Confluence bridge for Time | Confluence | Confluence bridge for the Time macro | Globale |
| confluence_tip | Confluence bridge for Tip | Confluence | Confluence bridge for the Tip macro to the XWiki Success macro | Globale |
| confluence_toc-zone | Confluence Toc Zone | Contenu | Confluence bridge macro for toc-zone. | Globale |
| confluence_wireframe | Confluence bridge for Balsamiq Wireframe | Confluence | Confluence Bridge for the Balsamiq Wireframe macro. It only displays the image preview of the wireframe. | Globale |
| container | Conteneur | Mise en page | Macro permettant de réunir plusieurs groupes et d'ajouter des décorations comme la mise en page. | Globale |
| content | Contenu | Contenu | Autorise tous les types de langages wiki dans le contenu | Globale |
| content-report-table | Content Report Table | Contenu | Fournit un rapport au format tableau, basé sur les tags. | Globale |
| context | Contexte | Développement | Execute le contenu dans le contexte du document passé en paramètre | Globale |
| contributors | Contributeurs | Contenu | Bridge Confluence Contributors pour afficher les contributeurs d'un document donné. | Globale |
| dashboard | Tableau de bord | Mise en page | Macro permettant de définir un tableau de bord à remplir avec des gadgets. | Globale |
| date | Date | Contenu | Utilisez la macro Date pour configurer et formater les dates échéances dans les macros tâches, et plus encore ! | Globale |
| diagram | Diagram | Contenu | Displays a diagram. | Globale |
| display | Affichage | Contenu | Affiche d'autres pages dans la page courante. | Globale |
| displayIcon | Icon | Contenu | Display an icon. | Globale |
| documents | Documents | Contenu | Affiche la liste des documents dans un tableau dynamique | Wiki courant |
| documentTree | Arborescence | Navigation | Affiche l'arborescence des pages XWiki. | Wiki courant |
| embed | Embed content | Contenu | Show in your wiki page many external content. Currently this support theses external services: * Youtube, * Dailymotion, * Vimeo, * x.com, * Google doc, sheets and slides, * Google calendar, * Google maps, * Facebook, * Linkedin, * Figma, * Spotify, * Prezi, * Flickr, * Viddler, * Aha! roadmaps, * Also play a video attached to your wiki page using Video.js library. mp4, webm and ogv formats are supported. | Wiki courant |
| embedDiagram | embedDiagram | Globale | ||
| error | Message d'erreur | Format | Permet d'afficher un message d'erreur. | Globale |
| example | Exemple | Format | Afficher un exemple et le code source correspondant. | Wiki courant |
| excerpt | Excerpt | Macro Excerpt. Elle marque une partie du contenu de la page pour être utilisé par d'autres macros. Elle est compatible avec la macro Confluence Excerpt. | Globale | |
| excerpt-include | Excerpt include | Contenu | Intègre un extrait provenant d'un autre document dans la page courante. Les pages incluses doivent contenir la macro simple "excerpt". | Globale |
| expand | Expand | Ajoutez la macro Expand à votre page pour fournir du contenu dans une section dépliable / repliable. Cette macro peut être utilisée pour réduire visuellement la quantité d'informations sur une page, répartir les processus ou les procédures en plusieurs étapes cliquables, ou cacher des informations de contexte ou obsolètes, tout en les maintenant dans la page pour référence ultérieure. | Wiki courant | |
| footnote | Note de bas de page | Contenu | Génère une note qui sera affichée en bas de page. | Globale |
| gallery | Galerie | Mise en page | Affiche les images trouvées dans le contenu fourni en mode présentation / galerie. | Globale |
| groovy | Groovy | Développement | Exécute un script Groovy. | Globale |
| hide-if | Hide if | Contenu | Hide the content of this macro if the condition set through the parameters is met. | Globale |
| html | HTML | Développement | Permet d'insérer du code HTML ou XHTML dans la page. | Globale |
| iconPicker | Sélecteur d'icônes | Développement | Sélectionnez une icône dans le set d'icônes XWiki. | Wiki courant |
| id | Ancre | Navigation | Permet d'insérer une ancre au sein d'une page. Elle permettra de créer un lien vers cet endroit précis de la page. | Globale |
| include | Inclure | Contenu | Permet d'inclure une autre page dans la page courante. | Globale |
| info | Message d'information | Format | Permet d'afficher un message d'information. | Globale |
| inlineDiagram | Inline Diagram | Globale | ||
| job | Job | Développement | Execute the macro content asynchronously and display progress. | Globale |
| jobprogress | Job Progress | Interne | Provide a UI to follow asynchronous job progression | Wiki courant |
| kanban | Kanban | Kanban macro allowing to display and edit a kanban | Wiki courant | |
| kanbanboard | Kanban board - Task Manager | Contenu | Display the tasks as a Kanban board (see https://en.wikipedia.org/wiki/Kanban_board). | Globale |
| liveData | Live Data | Contenu | Affiche des listes dynamiques de données. | Globale |
| locationSearch | Recherche par emplacement | Recherche à l'emplacement donné. | Wiki courant | |
| mathjax | MathJax | Contenu | Enter content supported by the MathJax javascript engine. | Wiki courant |
| mention | Mention Utilisateur | Notifications | Insert une mention utilisateur. | Wiki courant |
| menu | Menu | Navigation | Affiche un menu créé en utilisant une syntaxe wiki simple (listes imbriquées et liens). | Globale |
| missingLicenseMessage | Missing License Message | Interne | Display an error message when the extension does not have a valid license. | Wiki courant |
| msStream | Macro Microsoft Stream | Embarque un flux vidéo Microsoft dans une page en copiant simplement l'URL et tout paramètre de personnalisation. | Globale | |
| notifications | Notifications | Notifications | Affiche des notifications liées à l'activité du wiki. | Wiki courant |
| notificationsApplicationsPreferences | Préférences de notification | Notifications | Affiche les préférences de notification de l'utilisateur courant. | Wiki courant |
| notificationsAutoWatchPreferences | Préférences pour les notifications d'abonnement automatique | Notifications | Affiche les préférences de l'utilisateur pour les notifications d'abonnement automatique aux pages. | Wiki courant |
| notificationsCustomFiltersPreferences | Notifications Custom Filters Preferences | Notifications | Display the preferences of the given user about custom notification filters. | Wiki courant |
| notificationsEmailPreferences | Notifications Email Preferences | Notifications | Display the preferences of the current user about notification emails. | Wiki courant |
| notificationsFiltersPreferences | Notifications Filters Preferences (deprecated) | Notifications | Display the preferences of the current user about notification filters. This macro is now deprecated in favor of Custom Notifications Filters Preferences or System Notifications Filters Preferences. | Wiki courant |
| notificationsSystemFiltersPreferences | Notifications System Filters Preferences | Notifications | Display the preferences of the given user about system notification filters. | Wiki courant |
| office | Liseuse de Document Office | Contenu | Voir les pièces jointes office (doc, ppt, xls, odt, odp, ods etc.) au sein des pages wiki sans besoin de les télécharger ou de les importer. | Globale |
| panel | Macro Panel | Macro Panel pour afficher du contenu XWiki dans un panneau. | Wiki courant | |
| pdftoc | PDF Table of Contents | Interne | Generates the table of contents for the PDF export. | Globale |
| pdfviewer | PDF Viewer | Contenu | PDF Viewer basé sur Mozilla pdf.js | Globale |
| profile-picture | Photo de profil | Contenu | Affiche la photo de profil de l'utilisateur sélectionné | Globale |
| putFootnotes | Afficher les notes de bas de page | Contenu | Permet d'afficher toutes les notes de bas de page. Si manquant, les notes de bas de page sont affichées par défaut à la fin de la page. | Globale |
| python | Python | Développement | Exécute un script Python. | Globale |
| recently-updated | Mise à jour récemment | Contenu | Ajouter la macro récemment mise à jour à une page pour afficher une liste de pages, blogs, fichiers et commentaires qui ont été créés ou édités récemment. Ceci est idéal pour une page d'accueil d'un projet, des pages d'information, ou les pages d'accueil d'espace d'équipes. Il est très flexible, vous pouvez limiter la liste à des personnes spécifiques, des espaces, des types de contenu, et plus encore. | Wiki courant |
| script | Script | Développement | Exécute un script dans le langage indiqué. | Globale |
| show-if | Show if | Contenu | Show the content of this macro if the condition set through the parameters is met. | Globale |
| status | Status | Contenu | Insert une étiquette colorée dans le texte pour mettre en valeur le statut d'un item. | Globale |
| statuses | Statutes | content | Macro to manage status documents | Globale |
| success | Message en cas de succès | Format | Affiche un message en cas de succès. | Globale |
| tab | Tab | Contenu | Onglets pour la macro tab group. Attendu à être défini comme contenu de la macro tab-group. | Globale |
| tab-group | Tab group | Contenu | La macro principale qui regroupe les éléments de la macro tab | Globale |
| tagcloud | Nuage de tag | Contenu | Affiche le nuage de tags du wiki courant ou de l'espace spécifié. | Wiki courant |
| tagList | Tag list | Affiche une liste de toutes les macros de votre instance. | Globale | |
| task | Tâche | Contenu | Créer une tâche à laquelle vous pouvez assigner un utilisateur en utilisant la macro mention et définir une échéance en utilisant la macro date. | Globale |
| task-report | Macro Task report | Contenu | Créer un rapport personnalisé des tâches du wiki. | Globale |
| taskcard | Task card | Contenu | Display a task and its information as a card. | Globale |
| taskgantt | Gantt Diagram | Contenu | Display tasks from Task Manager Application in a Gantt diagram. | Globale |
| tasks | Tasks | Contenu | Display one or more tasks identified by their IDs. | Globale |
| tasks-report-macro | Legacy Confluence bridge for Tasks Report | Contenu | Legacy Confluence bridge for Tasks Report. | Globale |
| team | Team | Affiche les avatars des membres d'une équipe. | Wiki courant | |
| template | Template | Développement | Insérer un template. | Globale |
| toc | Table des matières | Navigation | Génère une table de matières. | Globale |
| translation | Traduction | Contenu | Affiche un message de traduction. | Globale |
| tree | Arbre | Navigation | Affiche une hiérarchie de l'arborescence définie par le contenu de la macro ou le paramètre source. | Wiki courant |
| uiextension | Extension UI | Développement | Insérez une extension UI. | Globale |
| uiextensions | Extensions UI | Développement | Insérer les extensions UI. | Globale |
| useravatar | Afficher la photo de profil | Contenu | Permet d'afficher l'avatar d'un utilisateur donné. | Globale |
| userList | User List | Contenu | Affiche une liste des utilisateurs avec personnalisation de la liste de leurs propriétés | Globale |
| userProfile | Profil utilisateur | Contenu | Affiche un profil utilisateur avec des propriétés personnalisables | Globale |
| velocity | Velocity | Développement | Exécute un script Velocity. | Globale |
| view-file | View file | Contenu | Affiche un fichier en utilisant les macros PDF ou Office Viewer. | Globale |
| warning | Message d'avertissement | Format | Permet d'afficher un message d'avertissement. | Globale |
| wikimacrocontent | WikiMacro Content | Développement | Display editable content of a wikimacro. | Globale |
| wikimacroparameter | WikiMacro Parameter | Développement | Display editable parameter of a wikimacro. | Globale |
| wikis | Wikis | Navigation | Liste de tous les wikis | Wiki courant |
| workspaces | Espaces de travail (obsolète) | Obsolète | Cette macro est dépréciée et ne doit plus être utilisée pour des raisons de compatibilité. Merci de la remplacer par un macro "wikis". | Wiki courant |