1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
|
---
title: border-image
slug: Web/CSS/border-image
tags:
- CSS
- Propriété
- Propriété raccourcie
- Reference
translation_of: Web/CSS/border-image
---
<div>{{CSSRef}}</div>
<p>La propriété <strong><code>border-image</code></strong> dessine une image sur la bordure d'un élément. C'est <a href="/fr/docs/Web/CSS/Propri%C3%A9t%C3%A9s_raccourcies">une propriété raccourcie</a> 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")}}.</p>
<div>{{EmbedInteractiveExample("pages/css/border-image.html")}}</div>
<p class="hidden">Le code source de cet exemple interactif est disponible dans un dépôt GitHub. Si vous souhaitez contribuez à ces exemples, n'hésitez pas à cloner <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> et à envoyer une <em>pull request</em> !</p>
<p>Cela permet d'obtenir des effets de dessin complexes sans avoir à complexifier l'utilisation des boîtes CSS. La propriété <code>border-image</code> sera utilisée plutôt que le style défini via la propriété {{cssxref("border-style")}}. Selon la spécification, <code>border-style</code> <strong>doit</strong> être présente si <code>border-image</code> est utilisée.</p>
<div class="note">
<p><strong>Note :</strong> Si <a href="/fr/docs/Web/CSS/Valeur_calculée">la valeur calculée</a> de {{cssxref("border-image-source")}} vaut <code>none</code> (via <code>border-image-source</code> ou via la propriété raccourcie <code>border-image</code>), ce sera le style indiqué par {{cssxref("border-style")}} qui sera utilisé.</p>
</div>
<h2 id="Syntaxe">Syntaxe</h2>
<pre class="brush: css no-line-numbers">/* source | slice */
border-image: linear-gradient(red, blue) 27;
/* source | slice | repeat */
border-image: url("/images/border.png") 27 space;
/* source | slice | width */
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;
</pre>
<p>La propriété <code>border-image</code> peut être définie avec une à cinq valeurs parmi celles définies ci-après.</p>
<div class="note">
<p><strong>Note :</strong> Si la <a href="/fr/docs/Web/CSS/Valeur_calculée">valeur calculée</a> de {{cssxref("border-image-source")}} vaut <code>none</code> ou si l'image ne peut pas être affichée, c'est le {{cssxref("border-style")}} correspondant qui sera affiché.</p>
</div>
<h3 id="Valeurs">Valeurs</h3>
<dl>
<dt><code>border-image-source</code></dt>
<dd>L'image source. Voir {{cssxref("border-image-source")}}.</dd>
<dt><code>border-image-slice</code></dt>
<dd>La façon dont l'image est découpée en zones (jusqu'à 4). Voir {{cssxref("border-image-slice")}}.</dd>
<dt><code>border-image-width</code></dt>
<dd>La largeur de la bordure avec l'image. Voir {{cssxref("border-image-width")}}.</dd>
<dt><code>border-image-outset</code></dt>
<dd>La distance entre la bordure et le bord de l'élément. Voir {{cssxref("border-image-outset")}}.</dd>
<dt><code>border-image-repeat</code></dt>
<dd>La façon dont l'image source est adaptée afin de correspondre aux dimensions de la bordure. Voir {{cssxref("border-image-repeat")}}.</dd>
</dl>
<h3 id="Syntaxe_formelle">Syntaxe formelle</h3>
{{csssyntax}}
<h2 id="Exemples">Exemples</h2>
<h3 id="Utiliser_une_image_matricielle_étirée">Utiliser une image matricielle étirée</h3>
<p>On découpe l'image et on la répète pour remplir la zone entre les bordures.</p>
<h4 id="CSS">CSS</h4>
<pre class="brush:css">#bitmap {
border: 30px solid transparent;
padding: 20px;
border-image: url("https://mdn.mozillademos.org/files/4127/border.png") 30;
}
</pre>
<h4 id="HTML">HTML</h4>
<pre class="brush: html"><div id="bitmap">
L'image est étirée pour remplir l'espace.
</div>
</pre>
<h4 id="Résultat">Résultat</h4>
<p>{{EmbedLiveSample('Utiliser_une_image_matricielle_répétée')}}</p>
<h3 id="Utiliser_un_dégradé">Utiliser un dégradé</h3>
<h4 id="CSS_2">CSS</h4>
<pre class="brush:css">#gradient {
border: 30px solid;
border-image: linear-gradient(red, yellow) 10;
padding: 20px;
}
</pre>
<h4 id="HTML_2">HTML</h4>
<pre class="brush: html"><div id="gradient">
L'image formée par le gradient est étirée pour remplir la zone.
</div>
</pre>
<h4 id="Résultat_2">Résultat</h4>
<p>{{EmbedLiveSample('Utiliser_un_dégradé')}}</p>
<h2 id="Accessibilité">Accessibilité</h2>
<p>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.</p>
<ul>
<li><a href="/fr/docs/Web/Accessibility/Understanding_WCAG/Perceivable#Guideline_1.1_%E2%80%94_Providing_text_alternatives_for_non-text_content">Comprendre les règles WCAG 1.1</a></li>
<li><a href="https://www.w3.org/TR/2016/NOTE-UNDERSTANDING-WCAG20-20161007/text-equiv-all.html" rel="noopener"><em>Understanding Success Criterion 1.1.1 - Understanding WCAG 2.0</em> (en anglais)</a></li>
</ul>
<h2 id="Spécifications">Spécifications</h2>
<table class="standard-table">
<thead>
<tr>
<th scope="col">Spécification</th>
<th scope="col">État</th>
<th scope="col">Commentaires</th>
</tr>
</thead>
<tbody>
<tr>
<td>{{SpecName('CSS3 Backgrounds', '#the-border-image', 'border-image')}}</td>
<td>{{Spec2('CSS3 Backgrounds')}}</td>
<td>Définition initiale.</td>
</tr>
</tbody>
</table>
<p>{{cssinfo}}</p>
<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2>
<div class="hidden">Ce tableau de compatibilité a été généré à partir de données structurées. Si vous souhaitez contribuer à ces données, n'hésitez pas à envoyer une <em>pull request</em> sur <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a>.</div>
<p>{{Compat("css.properties.border-image")}}</p>
<h2 id="Voir_aussi">Voir aussi</h2>
<ul>
<li>{{cssxref("border")}}</li>
<li>{{cssxref("outline")}}</li>
<li>{{cssxref("box-shadow")}}</li>
<li>{{cssxref("background-image")}}</li>
<li>{{cssxref("url()", "url()")}}</li>
<li>Fonctions pour les dégradés
<ul>
<li>{{CSSxRef("conic-gradient")}}</li>
<li>{{CSSxRef("linear-gradient")}}</li>
<li>{{CSSxRef("repeating-linear-gradient")}}</li>
<li>{{CSSxRef("radial-gradient")}}</li>
<li>{{CSSxRef("repeating-radial-gradient")}}</li>
</ul>
</li>
</ul>
|
