diff options
Diffstat (limited to 'files/fr/web/css/border-image')
| -rw-r--r-- | files/fr/web/css/border-image/index.md | 126 |
1 files changed, 68 insertions, 58 deletions
diff --git a/files/fr/web/css/border-image/index.md b/files/fr/web/css/border-image/index.md index b9a0348850..b4a7ba63ad 100644 --- a/files/fr/web/css/border-image/index.md +++ b/files/fr/web/css/border-image/index.md @@ -5,13 +5,21 @@ translation_of: Web/CSS/border-image --- {{CSSRef}} -La propriété **`border-image`** dessine une image sur la bordure d'un élément. C'est [une propriété raccourcie](/fr/docs/Web/CSS/Propri%C3%A9t%C3%A9s_raccourcies) qui permet de définir {{cssxref("border-image-source")}}, {{cssxref("border-image-width")}}, {{cssxref("border-image-repeat")}}, {{cssxref("border-image-slice")}}, {{cssxref("border-image-outset")}}. +La propriété **`border-image`** dessine une image sur la bordure d'un élément. {{EmbedInteractiveExample("pages/css/border-image.html")}} -Cela permet d'obtenir des effets de dessin complexes sans avoir à complexifier l'utilisation des boîtes CSS. La propriété `border-image` sera utilisée plutôt que le style défini via la propriété {{cssxref("border-style")}}. Selon la spécification, `border-style` **doit** être présente si `border-image` est utilisée. +> **Note :** Il est préférable d'indiquer un style de bordure distinct avec [`border-style`](/fr/docs/Web/CSS/border-style) dans le cas où l'image ne chargerait pas. Bien que la spécification ne le nécessite pas, certains navigateurs n'affichent pas l'image de bordure si [`border-style`](/fr/docs/Web/CSS/border-style) vaut `none` ou si [`border-width`](/fr/docs/Web/CSS/border-width) vaut `0`. -> **Note :** Si [la valeur calculée](/fr/docs/Web/CSS/Valeur_calculée) de {{cssxref("border-image-source")}} vaut `none` (via `border-image-source` ou via la propriété raccourcie `border-image`), ce sera le style indiqué par {{cssxref("border-style")}} qui sera utilisé. +## Propriétés détaillées correspondantes + +C'est [une propriété raccourcie](/fr/docs/Web/CSS/Shorthand_properties) qui permet de définir : + +- [`border-image-outset`](/fr/docs/Web/CSS/border-image-outset) +- [`border-image-repeat`](/fr/docs/Web/CSS/border-image-repeat) +- [`border-image-source`](/fr/docs/Web/CSS/border-image-source) +- [`border-image-slice`](/fr/docs/Web/CSS/border-image-slice) +- [`border-image-width`](/fr/docs/Web/CSS/border-image-width) ## Syntaxe @@ -27,26 +35,43 @@ border-image: linear-gradient(red, blue) 27 / 35px; /* source | slice | width | outset | repeat */ border-image: url("/images/border.png") 27 23 / 50px 30px / 1rem round space; + +/* Valeurs globales */ +border-image: inherit; +border-image: initial; +border-image: revert; +border-image: unset; ``` La propriété `border-image` peut être définie avec une à cinq valeurs parmi celles définies ci-après. -> **Note :** Si la [valeur calculée](/fr/docs/Web/CSS/Valeur_calculée) de {{cssxref("border-image-source")}} vaut `none` ou si l'image ne peut pas être affichée, c'est le {{cssxref("border-style")}} correspondant qui sera affiché. +> **Note :** Si la [valeur calculée](/fr/docs/Web/CSS/computed_value) de [`border-image-source`](/fr/docs/Web/CSS/border-image-source) vaut `none` ou si l'image ne peut pas être affichée, c'est le [`border-style`](/fr/docs/Web/CSS/border-style) correspondant qui sera affiché. ### Valeurs - `border-image-source` - - : L'image source. Voir {{cssxref("border-image-source")}}. + - : L'image source. Voir [`border-image-source`](/fr/docs/Web/CSS/border-image-source). - `border-image-slice` - - : La façon dont l'image est découpée en zones (jusqu'à 4). Voir {{cssxref("border-image-slice")}}. + - : La façon dont l'image est découpée en zones (jusqu'à 4). Voir [`border-image-slice`](/fr/docs/Web/CSS/border-image-slice). - `border-image-width` - - : La largeur de la bordure avec l'image. Voir {{cssxref("border-image-width")}}. + - : La largeur de la bordure avec l'image. Voir [`border-image-width`](/fr/docs/Web/CSS/border-image-width). - `border-image-outset` - - : La distance entre la bordure et le bord de l'élément. Voir {{cssxref("border-image-outset")}}. + - : La distance entre la bordure et le bord de l'élément. Voir [`border-image-outset`](/fr/docs/Web/CSS/border-image-outset). - `border-image-repeat` - - : La façon dont l'image source est adaptée afin de correspondre aux dimensions de la bordure. Voir {{cssxref("border-image-repeat")}}. + - : La façon dont l'image source est adaptée afin de correspondre aux dimensions de la bordure. Voir [`border-image-repeat`](/fr/docs/Web/CSS/border-image-repeat). + +## Accessibilité + +Les technologies d'assistance ne peuvent pas analyser les images de bordure. Si l'image contient des informations essentielles au sens de la page, mieux vaut décrire ces informations dans le contenu sémantique du document. + +- [Comprendre les règles WCAG 1.1](/fr/docs/Web/Accessibility/Understanding_WCAG/Perceivable#Guideline_1.1_%E2%80%94_Providing_text_alternatives_for_non-text_content) +- [Comprendre les critères pour 1.1.1 | Comprendre WCAG 2.0 (en anglais)](https://www.w3.org/TR/2016/NOTE-UNDERSTANDING-WCAG20-20161007/text-equiv-all.html) + +## Définition formelle -### Syntaxe formelle +{{cssinfo}} + +## Syntaxe formelle {{csssyntax}} @@ -56,82 +81,67 @@ La propriété `border-image` peut être définie avec une à cinq valeurs parmi On découpe l'image et on la répète pour remplir la zone entre les bordures. +#### HTML + +```html +<div id="bitmap">L'image est étirée pour remplir l'espace.</div> +``` + #### CSS ```css #bitmap { border: 30px solid transparent; - padding: 20px; - border-image: url("https://mdn.mozillademos.org/files/4127/border.png") 30; + padding: 20px; + border-image: url("border.png") 30; } ``` -#### HTML - -```html -<div id="bitmap"> - L'image est étirée pour remplir l'espace. -</div> -``` - #### Résultat -{{EmbedLiveSample('Utiliser_une_image_matricielle_étirée')}} +{{EmbedLiveSample('')}} ### Utiliser un dégradé +#### HTML + +```html +<div id="gradient">L'image formée par le dégradé est étirée pour remplir la zone.</div> +``` + #### CSS ```css #gradient { - border: 30px solid; - border-image: linear-gradient(red, yellow) 10; - padding: 20px; + border: 30px solid; + border-image: linear-gradient(red, yellow) 10; + padding: 20px; } ``` -#### HTML - -```html -<div id="gradient"> - L'image formée par le gradient est étirée pour remplir la zone. -</div> -``` - #### Résultat -{{EmbedLiveSample('Utiliser_un_dégradé')}} - -## Accessibilité - -Les technologies d'assistance ne peuvent pas analyser les images de bordure. Si l'image contient des informations essentielles au sens de la page, mieux vaut décrire ces informations dans le contenu sémantique du document. - -- [Comprendre les règles WCAG 1.1](/fr/docs/Web/Accessibility/Understanding_WCAG/Perceivable#Guideline_1.1_%E2%80%94_Providing_text_alternatives_for_non-text_content) -- [_Understanding Success Criterion 1.1.1 - Understanding WCAG 2.0_ (en anglais)](https://www.w3.org/TR/2016/NOTE-UNDERSTANDING-WCAG20-20161007/text-equiv-all.html) +{{EmbedLiveSample('')}} ## Spécifications -| Spécification | État | Commentaires | -| -------------------------------------------------------------------------------------------- | ---------------------------------------- | -------------------- | -| {{SpecName('CSS3 Backgrounds', '#the-border-image', 'border-image')}} | {{Spec2('CSS3 Backgrounds')}} | Définition initiale. | - -{{cssinfo}} +{{Specifications}} ## Compatibilité des navigateurs -{{Compat("css.properties.border-image")}} +{{Compat}} ## Voir aussi -- {{cssxref("border")}} -- {{cssxref("outline")}} -- {{cssxref("box-shadow")}} -- {{cssxref("background-image")}} -- {{cssxref("url()", "url()")}} -- Fonctions pour les dégradés - - - {{CSSxRef("conic-gradient")}} - - {{CSSxRef("linear-gradient")}} - - {{CSSxRef("repeating-linear-gradient")}} - - {{CSSxRef("radial-gradient")}} - - {{CSSxRef("repeating-radial-gradient")}} +- [`border`](/fr/docs/Web/CSS/border) +- [`outline`](/fr/docs/Web/CSS/outline) +- [`box-shadow`](/fr/docs/Web/CSS/box-shadow) +- [`background-image`](/fr/docs/Web/CSS/background-image) +- La fonction [`url()`](/fr/docs/Web/CSS/url()) +- Fonctions pour les dégradés : + + - [`conic-gradient()`](/fr/docs/Web/CSS/gradient/conic-gradient()) + - [`linear-gradient()`](/fr/docs/Web/CSS/gradient/linear-gradient()) + - [`repeating-linear-gradient()`](/fr/docs/Web/CSS/gradient/repeating-linear-gradient()) + - [`radial-gradient()`](/fr/docs/Web/CSS/gradient/radial-gradient()) + - [`repeating-radial-gradient()`](/fr/docs/Web/CSS/gradient/repeating-radial-gradient()) |