diff options
Diffstat (limited to 'files/fr/web/css/cursor/index.md')
| -rw-r--r-- | files/fr/web/css/cursor/index.md | 336 |
1 files changed, 336 insertions, 0 deletions
diff --git a/files/fr/web/css/cursor/index.md b/files/fr/web/css/cursor/index.md new file mode 100644 index 0000000000..2931c1851a --- /dev/null +++ b/files/fr/web/css/cursor/index.md @@ -0,0 +1,336 @@ +--- +title: cursor +slug: Web/CSS/cursor +tags: + - Arrow + - CSS + - CSS Property + - Cursor + - Custom Cursor + - Reference + - UI + - mouse + - pointer + - recipe:css-property +translation_of: Web/CSS/cursor +browser-compat: css.properties.cursor +--- +<div>{{CSSRef}}</div> + +<p>La propriété CSS <strong><code>cursor</code></strong> définit la forme du curseur (s'il y en a un) lorsque le pointeur est au-dessus de l'élément.</p> + +<div>{{EmbedInteractiveExample("pages/css/cursor.html")}}</div> + +<h2 id="syntax">Syntaxe</h2> + +<pre class="brush: css no-line-numbers">/* Valeurs avec un mot-clé */ +cursor: pointer; +cursor: auto; + +/* Une valeur d'URL avec un mot-clé par défaut */ +cursor: url(hand.cur), pointer; + +/* Une valeur d'URL avec des coordonnées et un mot-clé par défaut */ +cursor: url(cursor1.png) 4 12, auto; +cursor: url(cursor2.png) 2 2, pointer; + +/* Valeurs globales */ +cursor: inherit; +cursor: initial; +cursor: unset; +</pre> + +<p>La propriété <code>cursor</code> peut être définie grâce à zéro ou plusieurs valeurs <code><a href="#url"><url></a></code> séparées par des virgules et suivi par un unique <a href="#mot-clé">mot-clé obligatoire</a>. Chaque <code><url></code> doit pointer vers un fichier image. Le navigateur essaiera de télécharger la première image indiquée et passera à la suivante s'il ne peut pas. Si aucune image ne fonctionne, il utilisera le mot-clé final.</p> + +<p>Chaque <code><url></code> peut éventuellement être suivi par un couple de nombres séparés par un espace qui représente les coordonnées (abscisse puis ordonnée) <code><a href="#xy"><x><y></a></code> Ces coordonnées permettent de paramétrer le point d'action (<em>hotspot</em>) du curseur par rapport au coin en haut à gauche de l'image.</p> + +<p>Par exemple, on peut indiquer deux images grâce à deux valeurs <code><url></code> et fournir des coordonnées <code><x><y></code> pour la deuxième. Si aucune des images n'a pu être chargée, on recourt au mot-clé <code>progress</code> :</p> + +<pre class="brush: css">cursor: url(one.svg), url(two.svg) 5 5, progress;</pre> + +<h3 id="values">Valeurs</h3> + +<dl> + <dt><code><url></code></dt> + <dd>Une <code>url(…)</code> ou une liste d'URL séparées par des virgules <code>url(…), url(…), …</code> pointant vers un fichier image. On peut utiliser plusieurs <a href="/fr/docs/Web/CSS/url()"><code>url()</code></a>, au cas où certains types d'images ne sont pas pris en charge. Il est <em>obligatoire</em> qu'une valeur non-URL soit présente à la fin de cette liste.</dd> + <dt><code><x></code> <code><y></code> {{experimental_inline}}</dt> + <dd>Des coordonnées en abscisses et en ordonnées sans unité, inférieures à 32.</dd> + <dt>Valeurs utilisant un mot-clé</dt> + <dd> + <p><strong>Vous pouvez déplacer votre souris au-dessus de chaque ligne pour tester.</strong></p> + + <table class="standard-table"> + <thead> + <tr> + <th>Catégorie</th> + <th>Valeur CSS</th> + <th>Rendu</th> + <th>Description</th> + </tr> + </thead> + <tbody> + <tr style="cursor: auto;"> + <td rowspan="3">Général</td> + <td><code>auto</code></td> + <td></td> + <td>Le navigateur détermine le curseur à afficher en fonction du contexte (par exemple, l'effet sera équivalent à <code>text</code> lors du survol du texte).</td> + </tr> + <tr style="cursor: default;"> + <td><code>default</code></td> + <td><img alt="default.gif" src="default.gif"></td> + <td>Le curseur par défaut de la plateforme (qui est généralement une flèche).</td> + </tr> + <tr style="cursor: none;"> + <td><code>none</code></td> + <td></td> + <td>Aucun curseur n'est affiché.</td> + </tr> + <tr style="cursor: context-menu;"> + <td rowspan="5" style="cursor: auto;">Liens & états</td> + <td><code>context-menu</code></td> + <td><img alt="context-menu.png" src="context-menu.png"></td> + <td>Un menu contextuel est disponible sous le curseur. Seul IE 10 et les versions supérieures ont implémenté cette valeur Bur Windows : <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=258960">bug 258960</a>.</td> + </tr> + <tr style="cursor: help;"> + <td><code>help</code></td> + <td><img alt="help.gif" src="help.gif"></td> + <td>Le pointeur indique qu'une aide est disponible.</td> + </tr> + <tr style="cursor: pointer;"> + <td><code>pointer</code></td> + <td><img alt="pointer.gif" src="pointer.gif"></td> + <td>Le curseur est un pointeur qui indique un lien ; généralement c'est une main.</td> + </tr> + <tr style="cursor: progress;"> + <td><code>progress</code></td> + <td><img alt="progress.gif" src="progress.gif"></td> + <td>Le programme est occupé en arrière-plan mais l'utilisateur peut toujours interagir avec l'interface (à la différence de <code>wait</code>).</td> + </tr> + <tr style="cursor: wait;"> + <td><code>wait</code></td> + <td><img alt="wait.gif" src="wait.gif"></td> + <td>Le programme est occupé, empêchant toute interaction.</td> + </tr> + <tr style="cursor: cell;"> + <td rowspan="4" style="cursor: auto;">Sélection</td> + <td><code>cell</code></td> + <td><img alt="cell.gif" src="cell.gif"></td> + <td>Le pointeur indique que la ou les cellules du tableau peuvent être sélectionnées.</td> + </tr> + <tr style="cursor: crosshair;"> + <td><code>crosshair</code></td> + <td><img alt="crosshair.gif" src="crosshair.gif"></td> + <td>Un curseur en forme de croix, généralement utilisé pour indiquer une sélection sur une image.</td> + </tr> + <tr style="cursor: text;"> + <td><code>text</code></td> + <td><img alt="text.gif" class="default" src="text.gif"></td> + <td>Le pointeur indique que le texte peut être sélectionné.</td> + </tr> + <tr style="cursor: vertical-text;"> + <td><code>vertical-text</code></td> + <td><img alt="vertical-text.gif" src="vertical-text.gif"></td> + <td>Le pointeur indique que du texte vertical peut être sélectionné.</td> + </tr> + <tr style="cursor: alias;"> + <td rowspan="7" style="cursor: auto;">Glisser/déposer</td> + <td><code>alias</code></td> + <td><img alt="alias.gif" src="alias.gif"></td> + <td>Le pointeur indique qu'un alias ou qu'un raccourci sera créé.</td> + </tr> + <tr style="cursor: copy;"> + <td><code>copy</code></td> + <td><img alt="copy.gif" class="default" src="copy.gif"></td> + <td>Le pointeur indique que quelque chose devra être copié.</td> + </tr> + <tr style="cursor: move;"> + <td><code>move</code></td> + <td><img alt="move.gif" src="move.gif"></td> + <td>L'objet survolé devra être déplacé.</td> + </tr> + <tr style="cursor: no-drop;"> + <td><code>no-drop</code></td> + <td><img alt="no-drop.gif" class="lwrap" src="no-drop.gif" style="float: left;"></td> + <td>Le curseur indique qu'on ne peut pas déposer d'élément à cet endroit. <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=B75173">bug 275173</a> pour Windows et Mac OS X, « <code>no-drop</code> a le même effet que <code>not-allowed</code> ».</td> + </tr> + <tr style="cursor: -moz-grab; cursor: -webkit-grab; cursor: grab;"> + <td><code>grab</code></td> + <td><img alt="grab.gif" class="default" src="grab.gif"></td> + <td rowspan="2" style="cursor: auto;"> + <p>Le pointeur indique que le contenu peut être accroché/attrapé ou est accroché/attrapé pour être glissé et déposé quelque part.</p> + </td> + </tr> + <tr style="cursor: -moz-grabbing; cursor: -webkit-grabbing; cursor: grabbing;"> + <td><code>grabbing</code></td> + <td><img alt="grabbing.gif" class="default" src="grabbing.gif"></td> + </tr> + <tr style="cursor: not-allowed;"> + <td><code>not-allowed</code></td> + <td><img alt="not-allowed.gif" src="not-allowed.gif"></td> + <td>Le curseur indique que quelque chose ne peut pas être fait.</td> + </tr> + <tr style="cursor: all-scroll;"> + <td rowspan="15" style="cursor: auto;">Redimensionnement & défilement</td> + <td><code>all-scroll</code></td> + <td><img alt="all-scroll.gif" src="all-scroll.gif"></td> + <td>Le curseur indique qu'on peut faire défiler le contenu dans n'importe quelle direction. <a href="https://bugzilla.mozilla.org/show_bug.cgi?id=275174">Bug 275174</a> pour Windows, « <code>all-scroll</code> a le même effet que <code>move</code>".</td> + </tr> + <tr style="cursor: col-resize;"> + <td><code>col-resize</code></td> + <td><img alt="col-resize.gif" src="col-resize.gif"></td> + <td>L'élément ou la colonne peut être redimensionné horizontalement.</td> + </tr> + <tr style="cursor: row-resize;"> + <td><code>row-resize</code></td> + <td><img alt="row-resize.gif" src="row-resize.gif"></td> + <td>L'élément ou la ligne peut être redimensionné verticalement.</td> + </tr> + <tr style="cursor: n-resize;"> + <td><code>n-resize</code></td> + <td><img alt="Exemple de redimensionnement vers le haut" src="n-resize.gif" style="border-style: solid; border-width: 0px;"></td> + <td rowspan="8" style="cursor: auto;"> + <p>Un bord peut être déplacé. Par exemple, le curseur <code>se-resize</code> peut être utilisé lorsqu'on redimensionne une boîte à partir de son coin sud-est.</p> + + <p>Dans certains environnements, un curseur bidirectionnel équivalent est affiché (ex. <code>n-resize</code> et <code>s-resize</code> sont synonymes de <code>ns-resize</code>).</p> + </td> + </tr> + <tr style="cursor: e-resize;"> + <td><code>e-resize</code></td> + <td><img alt="Example of a resize towards the right cursor" src="e-resize.gif"></td> + </tr> + <tr style="cursor: s-resize;"> + <td><code>s-resize</code></td> + <td><img alt="Example of a resize towards the bottom cursor " src="s-resize.gif"></td> + </tr> + <tr style="cursor: w-resize;"> + <td><code>w-resize</code></td> + <td><img alt="Example of a resize towards the left cursor" src="w-resize.gif"></td> + </tr> + <tr style="cursor: ne-resize;"> + <td><code>ne-resize</code></td> + <td><img alt="Example of a resize towards the top-right corner cursor" src="ne-resize.gif"></td> + </tr> + <tr style="cursor: nw-resize;"> + <td><code>nw-resize</code></td> + <td><img alt="Example of a resize towards the top-left corner cursor" src="nw-resize.gif"></td> + </tr> + <tr style="cursor: se-resize;"> + <td><code>se-resize</code></td> + <td><img alt="Example of a resize towards the bottom-right corner cursor" src="se-resize.gif"></td> + </tr> + <tr style="cursor: sw-resize;"> + <td><code>sw-resize</code></td> + <td><img alt="Example of a resize towards the bottom-left corner cursor" src="sw-resize.gif"></td> + </tr> + <tr style="cursor: ew-resize;"> + <td><code>ew-resize</code></td> + <td><img alt="3-resize.gif" class="default" src="3-resize.gif"></td> + <td rowspan="4" style="cursor: auto;">Le pointeur indique un redimensionnement bidirectionnel.</td> + </tr> + <tr style="cursor: ns-resize;"> + <td><code>ns-resize</code></td> + <td><img alt="6-resize.gif" class="default" src="6-resize.gif"></td> + </tr> + <tr style="cursor: nesw-resize;"> + <td><code>nesw-resize</code></td> + <td><img alt="1-resize.gif" class="default" src="1-resize.gif"></td> + </tr> + <tr style="cursor: nwse-resize;"> + <td><code>nwse-resize</code></td> + <td><img alt="4-resize.gif" class="default" src="4-resize.gif"></td> + </tr> + <tr style="cursor: -webkit-zoom-in; cursor: zoom-in;"> + <td rowspan="2">Zoom</td> + <td><code>zoom-in</code></td> + <td><img alt="zoom-in.gif" class="default" src="zoom-in.gif"></td> + <td rowspan="2" style="cursor: auto;"> + <p>Le pointeur indique qu'on peut zoomer/dézoomer sur le contenu.</p> + </td> + </tr> + <tr style="cursor: -webkit-zoom-out; cursor: zoom-out;"> + <td><code>zoom-out</code></td> + <td><img alt="zoom-out.gif" class="default" src="zoom-out.gif"></td> + </tr> + </tbody> + </table> + </dd> +</dl> + +<h3 id="formal_syntax">Syntaxe formelle</h3> + +{{csssyntax}} + +<h2 id="usage_notes">Notes d'utilisation</h2> + +<p>Bien que la spécification ne définisse aucune limite de taille pour les curseurs, chaque navigateur/agent utilisateur pourra imposer la sienne. Les images de curseur utilisées qui dépassent les limites prises en charge seront généralement ignorées.</p> + +<p>Pour plus d'informations, voir le tableau de compatibilité ci-après.</p> + +<h2 id="examples">Exemples</h2> + +<h3 id="CSS">CSS</h3> + +<pre class="brush:css">.toto { + cursor: crosshair; +} + +/* On utilise la valeur préfixée */ +/* si "zoom-in" n'est pas prise en */ +/* charge */ +.truc { + cursor: -webkit-zoom-in; + cursor: zoom-in; +} +</pre> + +<h3 id="HTML">HTML</h3> + +<pre class="brush: html"><p class="toto"> + On dirait qu'on pourrait sélectionner une zone. +</p> + +<p class="truc"> + Et là on peut zoomer. +</p></pre> + +<h3 id="result">Résultat</h3> + +<p>{{EmbedLiveSample("examples")}}</p> + +<h2 id="specifications">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 Basic UI', '#cursor', 'cursor')}}</td> + <td>{{Spec2('CSS3 Basic UI')}}</td> + <td>Ajout de plusieurs mots-clés et de la syntaxe de positionnement pour <code>url()</code>.</td> + </tr> + <tr> + <td>{{SpecName('CSS2.1', 'ui.html#cursor-props', 'cursor')}}</td> + <td>{{Spec2('CSS2.1')}}</td> + <td>Définition initiale.</td> + </tr> + </tbody> +</table> + +<p>{{cssinfo}}</p> + +<h2 id="browser_compatibility">Compatibilité des navigateurs</h2> + +<div>{{Compat}}</div> + +<h2 id="see_also">Voir aussi</h2> + +<ul> + <li><a href="/fr/docs/Web/CSS/CSS_Basic_User_Interface/Using_URL_values_for_the_cursor_property">Utiliser des valeurs URL pour <code>cursor</code></a></li> + <li><a href="/fr/docs/Web/CSS/pointer-events"><code>pointer-events</code></a></li> + <li>La fonction CSS {{cssxref("url()", "url()")}}</li> +</ul> |