aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/selection/collapse/index.html
blob: 97e9a4c4aecfccca64d13f1a8d62bd79cfcf7d10 (plain)
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
---
title: Selection.collapse()
slug: Web/API/Selection/collapse
tags:
  - API
  - Edition HTML
  - Experimental
  - Method
  - Reference
  - Selection
translation_of: Web/API/Selection/collapse
---
<div>{{ApiRef("DOM")}}{{SeeCompatTable}}</div>

<p>La méthode <strong><code>Selection.collapse()</code></strong> positionne la sélection en cours en un seul point. Le document n'est pas modifié. Si le focus est sur le contenu et est modifiable, le curseur d'édition s'y positionnera et sera visible.</p>

<h2 id="Syntaxe">Syntaxe</h2>

<pre class="syntaxbox"><var>sel</var>.collapse(<var>parentNode</var>, <var>offset</var>);
</pre>

<h3 id="Paramètres">Paramètres</h3>

<dl>
 <dt><em><code>parentNode</code></em></dt>
 <dd>Le curseur d'édition sera placé à l'intérieur de ce noeud.</dd>
</dl>

<dl>
 <dt><em><code>offset</code></em></dt>
 <dd>Indique la position du curseur d'édition dans <code>parentNode</code>.</dd>
</dl>

<h2 id="Exemples">Exemples</h2>

<pre class="brush: js">/* Positionner le curseur au début de l'élément body d'un document HTML. */
var body = document.getElementsByTagName("body")[0];
window.getSelection().collapse(body,0);
</pre>

<h2 id="Spécifications">Spécifications</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Spécification</th>
   <th scope="col">Statut</th>
   <th scope="col">Commentaires</th>
  </tr>
  <tr>
   <td>{{SpecName('Selection API', '#widl-Selection-collapse-void-Node-node-unsigned-long-offset', 'Selection.collapse()')}}</td>
   <td>{{Spec2('Selection API')}}</td>
   <td> </td>
  </tr>
  <tr>
   <td>{{SpecName('HTML Editing', '#dom-selection-collapse', 'Selection.collapse()')}}</td>
   <td>{{Spec2('HTML Editing')}}</td>
   <td>Définition initiale</td>
  </tr>
 </tbody>
</table>

<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2>

<p>{{Compat("api.Selection.collapse")}}</p>

<h2 id="See_also">Voir aussi</h2>

<ul>
  <li>{{domxref("Selection")}}, l'interface à laquelle collapse appartient.</li>
</ul>