Macros usuelles

MDN fournit plusieurs macros pour former des liens entre les pages de référence, le glossaire, etc.

La macro Glossary crée un lien vers la page d'un terme du glossaire. Elle prend un argument obligatoire et un autre optionnel :

1. Le nom du terme (par exemple "HTML") : {{Glossary("HTML")}}
2. Un paramètre optionnel indiquant le texte à afficher à la place du terme : {{Glossary("CSS", "Cascading Style Sheets")}}

D'autres macros permettent de créer des liens vers des pages des différentes références de MDN : JavaScript, CSS, éléments HTML, SVG, etc.

Elles utilisent généralement un premier paramètre indiquant le nom de l'élément vers lequel lier. La plupart utilisent un deuxième argument qui permet de modifier le texte affiché.

Previous, Next, et PreviousNext permettent d'afficher des contrôles de navigation pour des articles qui forment une série.

Pour les deux premières macros, le seul paramètre nécessaire est l'emplacement de l'article cible.

Pour la macro PreviousNext, le premier paramètre correspond à la cible de l'article précédent dans la série et le deuxième paramètre correspond à la cible du prochain article.

• EmbedLiveSample permet d'embarquer le résultat d'un exemple de code de la page (voir les exemples intégrés).
• LiveSampleLink crée un lien vers une page contenant le résultat d'un exemple de code de la page (voir les exemples intégrés).
• EmbedGHLiveSample permet d'embarquer des exemples interactifs depuis des pages GitHub (voir exemples interactifs depuis GitHub).

Pour chaque grand ensemble de pages, on a des macros qui aident à la navigation sous la forme d'une barre à gauche. Elles permettent généralement de remonter à la page racine de la référence/du guide/du tutoriel et placent l'article dans la catégorie correspondante au sein de cette barre.

• CSSRef génère la barre latérale pour les pages de la référence CSS.
• HTMLSidebar génère la barre latérale pour les pages de la référence HTML.
• APIRef génère la barre latérale pour les pages des références des API web.

optional_inline et ReadOnlyInline sont utilisées dans les documentations d'API pour décrire la liste des propriétés d'un objet ou les paramètres d'une fonction.

Syntaxe

{{Optional_Inline}}

ou

{{ReadOnlyInline}}.

Exemples

isCustomObject Lecture seule

Un booléen qui indique, s'il vaut true, que l'objet est spécifique.

parameterX Facultatif

Bla bla bla…

Non-standard

non-standard_inline insère une marque sur la ligne, indiquant que l'API n'a pas été standardisée et n'est pas en voie de standardisation.

Syntaxe

{{Non-standard_Inline}}

Exemples

• Icône : Non standard

Expérimental

experimental_inline insère une marque sur la ligne, indiquant que l'API n'est pas largement implémentée et peut évoluer.

Syntaxe

{{Experimental_Inline}}

Exemples

• Icône : Expérimental

Dépréciation

deprecated_inline insère une marque sur la ligne, indiquant que l'API ne devrait pas être utilisée, car elle a officiellement été dépréciée ou supprimée.

Syntaxe

{{Deprecated_Inline}}

Exemples

• Icône : Obsolète

Les macros qui suivent possèdent la même sémantique que les équivalents en ligne abordés avant. Ces macros doivent être placées directement après le préambule de la page. On peut aussi les utiliser pour marquer une section donnée d'une page.

• non-standard_header. Exemple : {{Non-standard_Header}}

  Non standard: Cette fonctionnalité n'est ni standard, ni en voie de standardisation. Ne l'utilisez pas pour des sites accessibles sur le Web : elle ne fonctionnera pas pour tout utilisateur. Il peut également y avoir d'importantes incompatibilités entre les implémentations et son comportement peut être modifié dans le futur.

• SeeCompatTable devrait être utilisée sur les pages documentant des fonctionnalités expérimentales. Exemple : {{SeeCompatTable}}

  Expérimental: Cette fonction est expérimentale
  Puisque cette fonction est toujours en développement dans certains navigateurs, veuillez consulter le tableau de compatibilité pour les préfixes à utiliser selon les navigateurs.
  Il convient de noter qu'une fonctionnalité expérimentale peut voir sa syntaxe ou son comportement modifié dans le futur en fonction des évolutions de la spécification.

• deprecated_header. Exemple : {{Deprecated_Header}}

  Obsolète: Cette fonctionnalité a été supprimée des standards du Web. Bien que quelques navigateurs puissent encore la supporter, elle est en cours d'éradication. Ne l'utilisez ni dans d'anciens projets, ni dans de nouveaux. Les pages et applications Web l'utilisant peuvent cesser de fonctionner à tout moment.

• secureContext_header devrait être utilisée sur les pages principales des interfaces ou d'aperçu des API, mais pas sur les sous-pages décrivant les méthodes ou les propriétés. Exemple : {{SecureContext_Header}}

  Contexte sécurisé: Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.

La macro AvailableInWorkers insère une note localisée qui indique qu'une fonctionnalité est disponible dans le contexte d'un web worker. L'argument notservice peut être utilisé afin d'indiquer qu'une fonctionnalité est disponible pour les web workers mais pas pour les service workers.

Syntaxe

{{AvailableInWorkers}}
{{AvailableInWorkers("notservice")}}

Exemples