Passa al contenuto principale

5. The Link Header Field (Il campo header Link)

Il campo header Link fornisce un mezzo per serializzare i collegamenti negli header HTTP.

Panoramica

Equivalenza semantica:

  • Equivalente all'elemento HTML <LINK>
  • Equivalente all'elemento Atom atom:link a livello di feed

Sintassi ABNF

Link           = "Link" ":" #link-value
link-value = "<" URI-Reference ">" *( ";" link-param )
link-param = ( ( "rel" "=" relation-types )
| ( "anchor" "=" <"> URI-Reference <"> )
| ( "hreflang" "=" Language-Tag )
| ( "media" "=" ( MediaDesc | ( <"> MediaDesc <"> ) ) )
| ( "title" "=" quoted-string )
| ( "title*" "=" ext-value )
| ( "type" "=" ( media-type | quoted-mt ) ) )

Componenti

5.1. IRI di destinazione

  • Trasmesso come URI-Reference tra parentesi angolari <>
  • Gli URI relativi vengono risolti secondo RFC 3986

5.2. IRI di contesto

  • Predefinito: IRI della risorsa richiesta
  • Override: Utilizzare il parametro anchor

5.3. Tipo di relazione

  • Specificato nel parametro rel
  • Non deve (MUST NOT) apparire più di una volta per link-value
  • Parametro rev: DEPRECATO

5.4. Attributi di destinazione

ParametroDescrizione
hreflangSuggerimento di lingua per la risorsa di destinazione
mediaMedia/medium previsto per informazioni di stile
titleEtichetta leggibile dall'uomo
title*Etichetta codificata (RFC 5987)
typeSuggerimento di tipo di media

5.5. Esempi

Navigazione semplice:

Link: `http://example.com/TheBook/chapter2`; rel="previous";
title="capitolo precedente"

Collegamenti multipli:

Link: </TheBook/chapter2>; rel="previous"; title*=UTF-8'it'precedente,
</TheBook/chapter4>; rel="next"; title*=UTF-8'it'successivo