From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- .../macros/commonly-used_macros/index.html | 224 +++++++++++++++++++++ 1 file changed, 224 insertions(+) create mode 100644 files/fr/mdn/structures/macros/commonly-used_macros/index.html (limited to 'files/fr/mdn/structures/macros/commonly-used_macros') diff --git a/files/fr/mdn/structures/macros/commonly-used_macros/index.html b/files/fr/mdn/structures/macros/commonly-used_macros/index.html new file mode 100644 index 0000000000..39f5a08225 --- /dev/null +++ b/files/fr/mdn/structures/macros/commonly-used_macros/index.html @@ -0,0 +1,224 @@ +--- +title: Commonly-used macros +slug: MDN/Structures/Macros/Commonly-used_macros +translation_of: MDN/Structures/Macros/Commonly-used_macros +--- +
{{MDNSidebar}}
+ +

Cette page présente un grand nombre de macros à usage général créées pour une utilisation avec MDN. Pour avoir des informations sur l'utilisation de ces macros, voir Utilisation des macros et Utiliser les liens macros . Voir les autres macros pour avoir des informations sur les macros qui sont rarement utilisées, ou utilisées dans des contextes spécifiques, ou obsolètes. Il y a aussi une liste complète de toutes les macros MDN.

+ +

Voir aussi le Guide style CSS pour l'utilisation des styles disponibles.

+ +

Linking

+ +

Création d'un lien hypertexte unique

+ +

En général, vous ne devez pas utiliser des macros pour créer des liens arbitraires. Utilisez le Lien dans l'interface de l'éditeur pour créer des liens.

+ + + +

Liens vers des pages avec références

+ +

Il existe différentes macros pour des liens vers des pages dans les zones de référence spécifiques MDN.

+ + + +

Liens vers des bugs et des IRC

+ + + +

Aides à la navigation pour les guides multi-pages

+ +

{{TemplateLink("Previous")}}, {{TemplateLink("Next")}}, and {{TemplateLink("PreviousNext")}} provide navigation controls for articles which are part of sequences. For the single-way templates, the only parameter needed is the wiki location of the previous or next article in the sequence. For {{TemplateLink("PreviousNext")}}, the two parameters needed are the wiki locations of the appropriate articles. The first parameter is for the previous article and the second is for the next article.

+ +

Exemples de code

+ +

Live samples

+ + + +

Fichiers exemples attachés

+ + + +

Génération de sidebar (barre latérale)

+ +

Modèles pour presque toutes les grandes collection de pages. Ils permettent généralement de revenir à la page principale de référence/Guide/tutoriel et de mettre l'article dans la catégorie appropriée.

+ + + +

La mise en forme à usage général

+ +

Inline indicators for API documentation

+ +

{{TemplateLink("optional_inline")}} and {{TemplateLink("ReadOnlyInline")}} are used in API documentation, usually when describing the list of properties of an object or parameters of a function.

+ +

Usage: \{{optional_inline()}} or \{{ReadOnlyInline()}}. Example:

+ +
+
isCustomObject {{ReadOnlyInline()}}
+
Indicates, if true, that the object is a custom one.
+
parameterX {{ optional_inline() }}
+
Blah blah blah...
+
+ +

Status and compatibility indicators

+ +

Inline indicators with no additional parameters

+ +

Non-standard

+ +

{{TemplateLink("non-standard_inline")}} inserts an in-line mark indicating the API has not been standardized and is not on a standards track.

+ +
Syntax
+ +

\{{non-standard_inline}}

+ +
Examples
+ + + +

Experimental

+ +

{{TemplateLink("experimental_inline")}} inserts an in-line mark indicating the API is not widely implemented and may change in the future.

+ +
Syntax
+ +

\{{experimental_inline}}

+ +
Examples
+ + + +

Inline indicators that support specifying the technology

+ +

In these macros the parameter (when specified) should be one of the strings "html", "js", "css", or "gecko", followed by the version number.

+ +

Deprecated

+ +

{{TemplateLink("deprecated_inline")}} inserts an in-line deprecated mark to discourage the use of an API that is officially deprecated. Note: "Deprecated" means that the item should no longer be used, but still functions. If you mean that it no longer works at all, use the term "obsolete."

+ +

Don't use the parameter in any browser-agnostic area (HTML, APIs, JS, CSS, …).

+ +
Syntax
+ +

\{{deprecated_inline}} or \{{deprecated_inline("gecko5")}}

+ +
Examples
+ + + +

Obsolete

+ +

{{TemplateLink("obsolete_inline")}} inserts an in-line obsolete mark to prevent the use of, for example, a function, method or property which is officially obsolete.

+ +

Don't use the parameter in any browser-agnostic area (HTML, APIs, JS, CSS, …).

+ +
Syntax
+ +

\{{obsolete_inline}} or \{{obsolete_inline("js1.8.5")}}

+ +
Examples
+ + + +

Template badges

+ +

These macros are mostly used on the WebAPI page. See {{anch("Creating new badges")}} for information on creating a new badge.

+ +

Page or section header indicators

+ +

These templates have the same semantics as their inline counterparts described above. The templates should be placed directly underneath the main page title (or breadcrumb navigation if available) in the reference page. They can also be used to mark up a section on a page.

+ + + +

Indicating that a feature is available in web workers

+ +

The {{TemplateLink("AvailableInWorkers")}} macro inserts a localised note box indicating that a feature is available in a Web worker context.

+ +

Version information macros

+ +

These macros are used to indicate that content is relevant only to specific versions of a product.

+ + + +

These macros are not shown when the specified version is lower than current gecko release.

+ + + +
    +
+ +

 

+ +
    +
+ +

 

-- cgit v1.2.3-54-g00ecf