aboutsummaryrefslogtreecommitdiff
path: root/files/fr/web/api/selection/collapse/index.html
blob: 9eff106240afaa295c4a1c94a9b79cc9856a9039 (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
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
---
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="Compatibilité">Compatibilité</h2>

<div>{{CompatibilityTable}}</div>

<div id="compat-desktop">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Fonctionnalité</th>
   <th>Chrome</th>
   <th>Firefox (Gecko)</th>
   <th>Internet Explorer</th>
   <th>Opera</th>
   <th>Safari (WebKit)</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>9.0</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
 </tbody>
</table>
</div>

<div id="compat-mobile">
<table class="compat-table">
 <tbody>
  <tr>
   <th>Fonctionnalité</th>
   <th>Android</th>
   <th>Firefox Mobile (Gecko)</th>
   <th>Firefox OS</th>
   <th>IE Phone</th>
   <th>Opera Mobile</th>
   <th>Safari Mobile</th>
  </tr>
  <tr>
   <td>Basic support</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatVersionUnknown}}</td>
   <td>1.0</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
   <td>{{CompatUnknown}}</td>
  </tr>
 </tbody>
</table>
</div>

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

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