Comparaison de révisions

<a>

Changer de révision

Révision 238875 :

Révision 238875 par FredB le

Révision 316867 :

Révision 316867 par BenoitL le

Titre :
a Redirection 1
a
Identifiant d'URL :
HTML/Element/a
HTML/Element/a
Contenu :

Révision 238875
Révision 316867
t7    REDIRECT <a class="redirect" href="/fr/docs/HTML/Element/">a<t7    <p>
>/a> 
8      {{ Traduction_en_cours("HTML/Element/a") }}
9    </p>
10    <h2 id="Summary">
11      Résumé
12    </h2>
13    <p>
14      L'élément d'ancre HTML (<code>&lt;a&gt;</code>) définit un 
 >hyperlien, une cible de destination dommée pour un hyperlien, ou 
 >les deux à la fois.
15    </p>
16    <h2 id="Usage_Context">
17      Contexte d'utilisation
18    </h2>
19    <table class="standard-table">
20      <tbody>
21        <tr>
22          <td>
23            Contenu permis
24          </td>
25          <td>
26            <a href="/en-US/docs/HTML/Content_categories#Transpar
 >ent_content_model" title="en-US/docs/HTML/Content_categories#Tran
 >sparent_content_model">Transparent</a>, containing either <a href
 >="/en-US/docs/HTML/Content_categories#Flow_content" title="en-US/
 >docs/HTML/Content_categories#Flow_content">flow content</a> or <a
 > href="/en-US/docs/HTML/Content_categories#Phrasing_content" titl
 >e="en-US/docs/HTML/Content_categories#Phrasing_content">phrasing 
 >content</a>.
27          </td>
28        </tr>
29        <tr>
30          <td>
31            Omission de balise
32          </td>
33          <td>
34            None, must have both a start tag and an end tag
35          </td>
36        </tr>
37        <tr>
38          <td>
39            Éléments parents autorisés
40          </td>
41          <td>
42            Any element that accepts <a href="/en-US/docs/HTML/Co
 >ntent_categories#Phrasing_content" title="en-US/docs/HTML/Content
 >_categories#Phrasing_content">phrasing content</a>, or any elemen
 >t that accepts <a href="/en-US/docs/HTML/Content_categories#Flow_
 >content" title="en-US/docs/HTML/Content_categories#Flow_content">
 >flow content</a>.
43          </td>
44        </tr>
45        <tr>
46          <td>
47            Documentation normative
48          </td>
49          <td>
50            <a class="external" href="http://www.w3.org/TR/html5/
 >text-level-semantics.html#the-a-element" title="http://www.w3.org
 >/TR/html5/text-level-semantics.html#the-a-element">HTML 5, sectio
 >n 4.6.1</a>; <a class="external" href="http://www.w3.org/TR/html4
 >01/struct/links.html#h-12.2" title="http://www.w3.org/TR/html401/
 >struct/links.html#h-12.2">HTML 4.01, section 12.2</a>
51          </td>
52        </tr>
53      </tbody>
54    </table>
55    <h2 id="Attributes">
56      Attributs
57    </h2>
58    <p>
59      Like all other HTML elements, this element has the <a href=
 >"/en-US/docs/HTML/Global_attributes" title="en-US/docs/HTML/Globa
 >l attributes">global attributes</a>.
60    </p>
61    <dl>
62      <dt>
63        {{ htmlattrdef("charset") }} {{ obsoleteGeneric("inline",
 >"HTML5") }}
64      </dt>
65      <dd>
66        This attribute defines the character encoding of the link
 >ed resource. The value is a space- and/or comma-delimited list of
 > character sets as defined in <a class="external" href="http://to
 >ols.ietf.org/html/rfc2045" title="http://tools.ietf.org/html/rfc2
 >045">RFC 2045</a>. The default value is ISO-8859-1.
67        <div class="note">
68          <p>
69            <strong>Usage note:</strong> This attribute is obsole
 >te in HTML5 and <strong>should not be used by authors</strong>. T
 >o achieve its effect, use the HTTP Content-Type header on the lin
 >ked resource.
70          </p>
71        </div>
72      </dd>
73      <dt>
74        {{ htmlattrdef("coords") }} {{ HTMLVersionInline(4) }} on
 >ly, {{ obsoleteGeneric("inline","HTML5") }}
75      </dt>
76      <dd>
77        For use with object shapes, this attribute uses a comma-s
 >eparated list of numbers to define the coordinates of the object 
 >on the page.
78      </dd>
79      <dt>
80        {{ htmlattrdef("datafld") }} {{ Non-standard_inline() }}
81      </dt>
82      <dd>
83        This attribute specifies the column name from that data s
 >ource object that supplies the bound data.
84        <div class="note">
85          <p>
86            <strong>Usage note:</strong> This attribute is non-st
 >andard and <strong>should not be used by authors</strong>. To ach
 >ieve its effect, use scripting and a mechanism such as <a href="/
 >en-US/docs/nsIXMLHttpRequest" title="en-US/docs/XMLHttpRequest">X
 >MLHttpRequest</a> to populate the page dynamically
87          </p>
88        </div>
89        <table class="fullwidth-table">
90          <tbody>
91            <tr>
92              <td rowspan="2">
93                Support
94              </td>
95              <td>
96                Gecko
97              </td>
98              <td>
99                Presto
100              </td>
101              <td>
102                WebKit
103              </td>
104              <td>
105                Trident
106              </td>
107            </tr>
108            <tr>
109              <td>
110                Not implemented
111              </td>
112              <td>
113                Not implemented
114              </td>
115              <td>
116                Not implemented
117              </td>
118              <td>
119                IE4, IE5, IE6, IE7 (Removed in IE8)
120              </td>
121            </tr>
122            <tr>
123              <td>
124                Normative document
125              </td>
126              <td colspan="4">
127                <a class="external" href="http://msdn.microsoft.c
 >om/en-us/library/ms533703%28VS.85%29.aspx">Microsoft's Data Bindi
 >ng: dataFld Property (MSDN)</a>
128              </td>
129            </tr>
130          </tbody>
131        </table>
132      </dd>
133      <dt>
134        {{ htmlattrdef("datasrc") }} {{ Non-standard_inline() }}
135      </dt>
136      <dd>
137        This attribute indicates the ID of the data source object
 > that supplies the data that is bound to this element.
138        <div class="note">
139          <p>
140            <strong>Usage note:</strong> This attribute is non-st
 >andard and <strong>should not be used by authors</strong>. To ach
 >ieve its effect, use scripting and a mechanism such as <a href="/
 >en-US/docs/nsIXMLHttpRequest" title="en/XMLHttpRequest">XMLHttpRe
 >quest</a> to populate the page dynamically.
141          </p>
142        </div>
143        <table class="fullwidth-table">
144          <tbody>
145            <tr>
146              <td rowspan="2">
147                Support
148              </td>
149              <td>
150                Gecko
151              </td>
152              <td>
153                Presto
154              </td>
155              <td>
156                WebKit
157              </td>
158              <td>
159                Trident
160              </td>
161            </tr>
162            <tr>
163              <td>
164                Not implemented
165              </td>
166              <td>
167                Not implemented
168              </td>
169              <td>
170                Not implemented
171              </td>
172              <td>
173                IE4, IE5, IE6, IE7 (Removed in IE8)
174              </td>
175            </tr>
176            <tr>
177              <td>
178                Normative document
179              </td>
180              <td colspan="4">
181                <a class="external" href="http://msdn.microsoft.c
 >om/en-us/library/ms533709(VS.85).aspx" title="http://msdn.microso
 >ft.com/en-us/library/ms533709(VS.85).aspx">Microsoft's Data Bindi
 >ng: dataSrc Property (MSDN)</a>
182              </td>
183            </tr>
184          </tbody>
185        </table>
186      </dd>
187      <dt>
188        {{ htmlattrdef("download") }} {{ HTMLVersionInline(5) }}
189      </dt>
190      <dd>
191        This attribute, if present, indicates that the author int
 >ends the hyperlink to be used for downloading a resource. If the 
 >attribute has a value, the browser should interpret that as the d
 >efault filename that the author recommends for use in labeling th
 >e resource in a local file system. There are no restrictions on a
 >llowed values, but you should consider that most file systems hav
 >e limitations with regard to what punctuation is supported in fil
 >e names, and browsers are likely to adjust file names accordingly
 >.
192        <div class="note">
193          <p>
194            <strong>Note:</strong> You can use this with <code>da
 >ta:</code>, <code>blob:</code> and <code>filesystem:</code> URLs,
 > to make it easy for users to download programmatically generated
 > content.
195          </p>
196        </div>
197      </dd>
198      <dt>
199        {{ htmlattrdef("href") }}
200      </dt>
201      <dd>
202        This is the single required attribute for anchors definin
 >g a hypertext source link. It indicates the link target, either a
 > URL or a URL fragment. A URL fragment is a name preceded by a ha
 >sh mark (#), which specifies an internal target location (an <a h
 >ref="/en-US/docs/HTML/Global_attributes#attr-id" title="Global at
 >tributes#attr-id">ID</a>) within the current document. URLs are n
 >ot restricted to Web (HTTP)-based documents. URLs might use any p
 >rotocol supported by the browser. For example, <code>file</code>,
 > <code>ftp</code>, and <code>mailto</code> work in most user agen
 >ts.
203        <div class="note">
204          <p>
205            <strong>Note:</strong> You can use the special fragme
 >nt "top" to create a link back to the top of the page; for exampl
 >e <code>&lt;a href="#top"&gt;Return to top&lt;/a&gt;</code>. This
 > behavior is specified by HTML5.
206          </p>
207        </div>
208      </dd>
209      <dt>
210        {{ htmlattrdef("hreflang") }}
211      </dt>
212      <dd>
213        This attribute indicates the language of the linked resou
 >rce. It is purely advisory. Allowed values are determined by <a c
 >lass="external" href="http://www.ietf.org/rfc/bcp/bcp47.txt" titl
 >e="http://www.ietf.org/rfc/bcp/bcp47.txt">BCP47</a> for HTML5 and
 > by <a class="external" href="http://www.ietf.org/rfc/rfc1766.txt
 >" title="http://www.ietf.org/rfc/rfc1766.txt">RFC1766</a> for HTM
 >L4. Use this attribute only if the {{ htmlattrxref("href", "a") }
 >} attribute is present.
214      </dd>
215      <dt>
216        {{ htmlattrdef("media") }} {{ HTMLVersionInline(5) }}
217      </dt>
218      <dd>
219        This attribute specifies the media which the linked resou
 >rce applies to. Its value must be a <a href="/en-US/docs/CSS/Medi
 >a_queries" title="en-US/docs/CSS/Media queries">media query</a>. 
 >This attribute is mainly useful when linking to external styleshe
 >ets by allowing the user agent to pick the best adapted one for t
 >he device it runs on.<br>
220        <div class="note">
221          <p>
222            <strong>Usage note:</strong>
223          </p>
224          <ul>
225            <li>In HTML 4, only simple white-space-separated list
 > of media description literals, i.e. <a href="/en-US/docs/CSS/@me
 >dia" title="https://developer.mozilla.org/en-US/docs/CSS/@media">
 >media types and groups</a>, where defined and allowed as values f
 >or this attribute, like <code>print</code>, <code>screen</code>, 
 ><code>aural</code>, <code>braille</code>, ... HTML 5 extended thi
 >s to any kind of <a href="/en-US/docs/CSS/Media_queries" title="e
 >n-US/docs/CSS/Media queries">media queries</a>, which are a super
 >set of the allowed values of HTML 4.
226            </li>
227            <li>Browsers not supporting the <a href="/en-US/docs/
 >CSS/Media_queries" title="en-US/docs/CSS/Media queries">CSS3 Medi
 >a Queries</a> won't necessarilly recognize the adequate link; do 
 >not forget to set fallback links, the restricted set of media que
 >ries defined in HTML 4.
228            </li>
229          </ul>
230        </div>
231      </dd>
232      <dt>
233        {{ htmlattrdef("methods") }} {{ Non-standard_inline() }}
234      </dt>
235      <dd>
236        The value of this attribute provides information about th
 >e functions that might be performed on an object. The values gene
 >rally are given by the HTTP protocol when it is used, but it migh
 >t (for similar reasons as for the title attribute) be useful to i
 >nclude advisory information in advance in the link. For example, 
 >the browser might choose a different rendering of a link as a fun
 >ction of the methods specified; something that is searchable migh
 >t get a different icon, or an outside link might render with an i
 >ndication of leaving the current site. This attribute is not well
 > understood nor supported, even by the defining browser, Internet
 > Explorer 4. <a class="external" href="http://msdn.microsoft.com/
 >en-us/library/ms534168(VS.85).aspx">Methods Property (MSDN)</a>
237      </dd>
238      <dt>
239        {{ htmlattrdef("name") }} {{ HTMLVersionInline(4) }} only
 >, {{ obsoleteGeneric("inline","HTML5") }}
240      </dt>
241      <dd>
242        This attribute is required in an anchor defining a target
 > location within a page. A value for <strong>name</strong> is sim
 >ilar to a value for the <strong>id</strong> core attribute and sh
 >ould be an alphanumeric identifier unique to the document. Under 
 >the HTML 4.01 specification, <strong>id</strong> and <strong>name
 ></strong> both can be used with the &lt;a&gt; element as long as 
 >they have identical values.
243        <div class="note">
244          <p>
245            <strong>Usage note:</strong> This attribute is obsole
 >te in HTML5, use <a href="/en-US/docs/HTML/Global_attributes#id" 
 >title="en-US/docs/HTML/Global attributes#id">global attribute <st
 >rong>id</strong></a> instead.
246          </p>
247        </div>
248      </dd>
249      <dt>
250        {{ htmlattrdef("ping") }} {{ HTMLVersionInline(5) }}
251      </dt>
252      <dd>
253        The support for "ping" was disabled starting with Firefox
 > 3 beta 3. {{ Bug(415168) }}
254      </dd>
255      <dt>
256        {{ htmlattrdef("rel") }}
257      </dt>
258      <dd>
259        For anchors containing the <strong>href</strong> attribut
 >e, this attribute specifies the relationship of the target object
 > to the link object. The value is a space-separated list of relat
 >ionship values. The values and their semantics will be registered
 > by some authority that might have meaning to the document author
 >. The default relationship, if no other is given, is void. Use th
 >is attribute only if the <strong>href</strong> attribute is prese
 >nt.
260      </dd>
261      <dt>
262        {{ htmlattrdef("rev") }} {{ HTMLVersionInline(4) }} only,
 > {{ obsoleteGeneric("inline","HTML5") }}
263      </dt>
264      <dd>
265        This attribute specifies a reverse link, the inverse rela
 >tionship of the <strong>rel</strong> attribute. It is useful for 
 >indicating where an object came from, such as the author of a doc
 >ument.
266      </dd>
267    </dl>
268    <div class="note">
269      <em>Note</em>: It is advisable to use the <strong>usemap</s
 >trong> attribute for the {{ HTMLElement("img") }} element and the
 > associated {{ HTMLElement("map") }} element to define hotspots i
 >nstead of the <strong>shape</strong> attribute.
270    </div>
271    <dl>
272      <dt>
273        {{ htmlattrdef("shape") }} {{ HTMLVersionInline(4) }} onl
 >y, {{ obsoleteGeneric("inline","HTML5") }}
274      </dt>
275      <dd>
276        This attribute is used to define a selectable region for 
 >hypertext source links associated with a figure to create an imag
 >e map. The values for the attribute are <code>circle</code>, <cod
 >e>default</code>, <code>polygon</code>, and <code>rect</code>. Th
 >e format of the <strong>coords</strong> attribute depends on the 
 >value of shape. For <code>circle</code>, the value is <code>x,y,r
 ></code> where <code>x</code> and <code>y</code> are the pixel coo
 >rdinates for the center of the circle and <code>r</code> is the r
 >adius value in pixels. For <code>rect</code>, the <strong>coords<
 >/strong> attribute should be <code>x,y,w,h</code>. The <code>x,y<
 >/code> values define the upper-left-hand corner of the rectangle,
 > while <code>w</code> and <code>h</code> define the width and hei
 >ght respectively. A value of <code>polygon</code> for <strong>sha
 >pe</strong> requires <code>x1,y1,x2,y2,...</code> values for <str
 >ong>coords</strong>. Each of the <code>x,y</code> pairs defines a
 > point in the polygon, with successive points being joined by str
 >aight lines and the last point joined to the first. The value <co
 >de>default</code> for shape requires that the entire enclosed are
 >a, typically an image, be used.
277      </dd>
278      <dt>
279        {{ htmlattrdef("target") }}
280      </dt>
281      <dd>
282        This attribute specifies where to display the linked reso
 >urce. In HTML4, this is the name of, or a keyword for, a frame. I
 >n HTML5, it is a name of, or keyword for, a <em>browsing context<
 >/em> (for example, tab, window, or inline frame). The following k
 >eywords have special meanings:
283        <ul>
284          <li>
285            <code>_self</code>: Load the response into the same H
 >TML4 frame (or HTML5 browsing context) as the current one. This v
 >alue is the default if the attribute is not specified.
286          </li>
287          <li>
288            <code>_blank</code>: Load the response into a new unn
 >amed HTML4 window or HTML5 browsing context.
289          </li>
290          <li>
291            <code>_parent</code>:&nbsp;Load the response into the
 > HTML4 frameset parent of the current frame or HTML5 parent brows
 >ing context of the current one. If there is no parent, this optio
 >n behaves the same way as <code>_self</code>.
292          </li>
293          <li>
294            <code>_top</code>: In HTML4: Load the response into t
 >he full, original window, canceling all other frames. In HTML5: L
 >oad the response into the top-level browsing context (that is, th
 >e browsing context that is an ancestor of the current one, and ha
 >s no parent). If there is no parent, this option behaves the same
 > way as <code>_self</code>.
295          </li>
296        </ul>Use this attribute only if the <strong>href</strong>
 > attribute is present.
297      </dd>
298      <dt>
299        {{ htmlattrdef("type") }}
300      </dt>
301      <dd>
302        This attribute specifies the media type in the form of a 
 >MIME type for the link target. Generally, this is provided strict
 >ly as advisory information; however, in the future a browser migh
 >t add a small icon for multimedia types. For example, a browser m
 >ight add a small speaker icon when type is set to audio/wav. For 
 >a complete list of recognized MIME types, see <a class="linkifica
 >tion-ext external" href="http://www.w3.org/TR/html4/references.ht
 >ml#ref-MIMETYPES" title="Linkification: http://www.w3.org/TR/html
 >4/references.html#ref-MIMETYPES">http://www.w3.org/TR/html4/refer
 >ences.html#ref-MIMETYPES</a>. Use this attribute only if the <str
 >ong>href</strong> attribute is present.
303      </dd>
304      <dt>
305        {{ htmlattrdef("urn") }} {{ Non-standard_inline() }}
306      </dt>
307      <dd>
308        This supposedly Microsoft-supported attribute relates a u
 >niform resource name (URN) with the link. While it is based on st
 >andards work years back, the meaning of URNs is still not well de
 >fined, so this attribute is meaningless. <a class="external" href
 >="http://msdn.microsoft.com/en-us/library/ms534710(VS.85).aspx">u
 >rn Property (MSDN)</a>
309      </dd>
310    </dl>
311    <h2 id="DOM_Interface">
312      Interface DOM
313    </h2>
314    <p>
315      This element implements the <code><a href="/en-US/docs/DOM/
 >HTMLAnchorElement" title="en-US/docs/DOM/HTMLAnchorElement">HTMLA
 >nchorElement</a></code> interface.
316    </p>
317    <h2 id="Example">
318      Exemple
319    </h2>
320    <pre class="brush: xml">
321&lt;!-- anchor linking to external file --&gt;
322&lt;a href="<a class="linkification-ext" href="http://www.mozilla
 >.com/" title="Linkification: http://www.mozilla.com/">http://www.
 >mozilla.com/</a>"&gt;
323External Link
324&lt;/a&gt;
325</pre>
326    <h3 id="Result" name="Result">
327      Résultat
328    </h3>
329    <p>
330      <a class="external" href="http://www.mozilla.com/">External
 > Link</a>
331    </p>
332    <h2 id="Browser_compatibility">
333      Compatibilité des navigateurs
334    </h2>
335    <p>
336      {{ CompatibilityTable() }}
337    </p>
338    <div id="compat-desktop">
339      <table class="compat-table">
340        <tbody>
341          <tr>
342            <th>
343              Feature
344            </th>
345            <th>
346              Chrome
347            </th>
348            <th>
349              Firefox (Gecko)
350            </th>
351            <th>
352              Internet Explorer
353            </th>
354            <th>
355              Opera
356            </th>
357            <th>
358              Safari
359            </th>
360          </tr>
361          <tr>
362            <td>
363              Basic support
364            </td>
365            <td>
366              {{ CompatVersionUnknown() }}
367            </td>
368            <td>
369              {{ CompatGeckoDesktop("1.0") }}
370            </td>
371            <td>
372              {{ CompatVersionUnknown() }}
373            </td>
374            <td>
375              {{ CompatVersionUnknown() }}
376            </td>
377            <td>
378              {{ CompatVersionUnknown() }}
379            </td>
380          </tr>
381          <tr>
382            <td>
383              <code>href="#top"</code>
384            </td>
385            <td>
386              {{ CompatVersionUnknown() }}
387            </td>
388            <td>
389              {{ CompatGeckoDesktop("10.0") }}
390            </td>
391            <td>
392              {{ CompatVersionUnknown() }}
393            </td>
394            <td>
395              {{ CompatVersionUnknown() }}
396            </td>
397            <td>
398              {{ CompatVersionUnknown() }}
399            </td>
400          </tr>
401        </tbody>
402      </table>
403    </div>
404    <div id="compat-mobile">
405      <table class="compat-table">
406        <tbody>
407          <tr>
408            <th>
409              Feature
410            </th>
411            <th>
412              Android
413            </th>
414            <th>
415              Firefox Mobile (Gecko)
416            </th>
417            <th>
418              IE Mobile
419            </th>
420            <th>
421              Opera Mobile
422            </th>
423            <th>
424              Safari Mobile
425            </th>
426          </tr>
427          <tr>
428            <td>
429              Basic support
430            </td>
431            <td>
432              {{ CompatVersionUnknown() }}
433            </td>
434            <td>
435              {{ CompatGeckoMobile("1.0") }}
436            </td>
437            <td>
438              {{ CompatVersionUnknown() }}
439            </td>
440            <td>
441              {{ CompatVersionUnknown() }}
442            </td>
443            <td>
444              {{ CompatVersionUnknown() }}
445            </td>
446          </tr>
447          <tr>
448            <td>
449              <code>href="#top"</code>
450            </td>
451            <td>
452              {{ CompatVersionUnknown() }}
453            </td>
454            <td>
455              {{ CompatGeckoMobile("10.0") }}
456            </td>
457            <td>
458              {{ CompatVersionUnknown() }}
459            </td>
460            <td>
461              {{ CompatVersionUnknown() }}
462            </td>
463            <td>
464              {{ CompatVersionUnknown() }}
465            </td>
466          </tr>
467        </tbody>
468      </table>
469    </div>
470    <h2 id="Notes">
471      Notes
472    </h2>
473    <p>
474      The following are reserved browser key bindings for the two
 > major browsers and should not be used as values to accesskey: a,
 > c, e, f, g, h, v, left arrow, and right arrow.
475    </p>
476    <p>
477      HTML 3.2 defines only <strong>name</strong>, <strong>href</
 >strong>, <strong>rel</strong>, <strong>rev</strong>, and <strong>
 >title</strong>.
478    </p>
479    <p>
480      The <strong>target</strong> attribute is not defined in bro
 >wsers that do not support frames, such as Netscape 1 generation b
 >rowsers. Furthermore, target is not allowed under strict variants
 > of <a href="/en-US/docs/XHTML" title="en-US/docs/XHTML">XHTML</a
 >> but is limited to frameset or transitional forms.
481    </p>
482    <h3 id="JavaScript_recommendations">
483      Recommendations JavaScript
484    </h3>
485    <p>
486      It is often the case that an anchor tag is used with the <c
 >ode>onclick</code> event. In order to prevent the page from refre
 >shing, <strong>href</strong> is often set to either "#" or "javas
 >cript:void(0)". Both of these values can lead to some unexpected 
 >errors when copying links and opening links in a new tab and/or w
 >indow. Be aware of this for usability reasons, and when users do 
 >use anchor tags and you prevent default behavior.
487    </p>
488    <p>
489      {{ HTML:Element_Navigation() }}
490    </p>

Retour à l'historique