diff --git a/docs/componenti/timeline.md b/docs/componenti/timeline.md index 607c3892e..c150eeb9c 100644 --- a/docs/componenti/timeline.md +++ b/docs/componenti/timeline.md @@ -11,13 +11,32 @@ Contiene un elenco di `.timeline-element`. Ogni `.timeline-element` contiene: -- **PIN**: ogni pin contiene un icona, ed una label indicante la data dell'evento. +- **PIN**: ogni pin è un elemento contenitore `.it-pin-wrapper` di tipo heading `h` che contiene un0icona (`.pin-icon`) e una label (`.pin-text`) indicante la data dell'evento. -Il **PIN** ha tre varianti di classe per il suo contenitore `.it-pin-wrapper`: +Il **PIN** ha tre varianti di colore: - `.it-evidence` : per indicare nella timeline eventi del passato (colore blu scuro) - `.it-now` : per indicare nella timeline eventi collocati nel presente (azzurro) -- Nessuna classe aggiuntiva: per collocare gli eventi nel futuro. (azzurro chiaro) +- Nessuna classe aggiuntiva: per collocare gli eventi nel futuro (bianco) + +{% capture callout %} +#### Accessibilità + +- L'elemento contenitore del pin `.it-pin-wrapper`, nell'esempio un `h3`, dovrà avere il livello intestazione corretto a seconda della gerarchia in pagina. Così come il titolo della card `.it-card-title`, nell'esempio un `h4`. +- Se le icone svg `.pin-icon` non veicolassero significato, è possibile nasconderle alle tecnologie assistive aggiungendo a queste l'attributo `aria-hidden="true"`; in questo caso è possibile rimuovere `role="img"` e l'elemento ``. +{% endcapture %}{% include callout.html content=callout type="accessibility" %} + +{% capture callout %} +#### Breaking feature dalla versione **2.x.y** + +Il codice markup è stato rivisto in chiave accessibilità e robustezza. In particolare cosa cambia: + - L'elemento `.pin-wrapper` è ora implementato come heading `h` e non semplice `div`. Dovrà avere il livello intestazione corretto a seconda della gerarchia in pagina. + - L'elemento `.pin-icon`, se semanticamente rilevante, deve avere attributo `role="img"` e contenere un tag `title` che lo descriva. + - Gli elementi categoria e data hanno ora tag `span` `visually-hidden` che ne descrivono lo scopo. + - L'elemento `.card-title` è ora implementato con heading `h4` per rispettare la gerarchia attuale. Dovrà avere il livello intestazione corretto a seconda della gerarchia in pagina. +{% endcapture %}{% include callout.html content=callout type="danger" %} + + ## Esempio @@ -27,20 +46,20 @@ Il **PIN** ha tre varianti di classe per il suo contenitore `.it-pin-wrapper`: <div class="row"> <div class="col-12"> <div class="timeline-element"> - <div class="it-pin-wrapper it-evidence"> + <h3 class="it-pin-wrapper it-evidence no_toc"> <div class="pin-icon"> - <svg class="icon"><use href="{{ site.baseurl }}/dist/svg/sprites.svg#it-code-circle"></use></svg> + <svg class="icon" role="img"><title>Segnaposto
maggio {{'now' | date: "%Y"}}
- +
+

Lorem ipsum dolor sit amet

- Categoria - 10/12/{{'now' | date: "%Y"}} + Categoria evento: Categoria + Data evento: 10/12/{{'now' | date: "%Y"}}
-
Lorem ipsum dolor sit amet, consectetur adipiscing elit…

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

di Federico De Paolis @@ -54,16 +73,16 @@ Il **PIN** ha tre varianti di classe per il suo contenitore `.it-pin-wrapper`:
-
+

- + Segnaposto
giugno {{'now' | date: "%Y"}}
-

+
-
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor…
+

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

@@ -72,25 +91,25 @@ Il **PIN** ha tre varianti di classe per il suo contenitore `.it-pin-wrapper`:
-
+

- + Risultato
luglio {{'now' | date: "%Y"}}
-

+
+

Lorem ipsum dolor sit amet, consectetur adipiscing elit

-
Lorem ipsum dolor sit amet, consectetur adipiscing elit…

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

di Federico De Paolis Leggi di più - su Lorem ipsum dolor sit amet, consectetur adipiscing elit… + su Lorem ipsum dolor sit amet, consectetur adipiscing elit
@@ -101,16 +120,16 @@ Il **PIN** ha tre varianti di classe per il suo contenitore `.it-pin-wrapper`:
Oggi -
+

- + Successo
agosto {{'now' | date: "%Y"}}
-

+
-
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor…
+

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

@@ -119,25 +138,25 @@ Il **PIN** ha tre varianti di classe per il suo contenitore `.it-pin-wrapper`:
-
+

- + Evento
settembre {{'now' | date: "%Y"}}
-

+
+

Lorem ipsum dolor sit amet, consectetur adipiscing elit

- Categoria - 10/12/{{'now' | date: "%Y"}} + Categoria evento: Categoria + Data evento: 10/12/{{'now' | date: "%Y"}}
-
Lorem ipsum dolor sit amet, consectetur adipiscing elit…

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

di Federico De Paolis Leggi di più - su Lorem ipsum dolor sit amet, consectetur adipiscing elit… + su Lorem ipsum dolor sit amet, consectetur adipiscing elit
@@ -147,16 +166,16 @@ Il **PIN** ha tre varianti di classe per il suo contenitore `.it-pin-wrapper`:
-
+

- + Successo
ottobre {{'now' | date: "%Y"}}
-

+
-
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor…
+

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

@@ -165,25 +184,25 @@ Il **PIN** ha tre varianti di classe per il suo contenitore `.it-pin-wrapper`:
-
+

- + Milestone
novembre {{'now' | date: "%Y"}}
-

+
+

Lorem ipsum dolor sit amet, consectetur adipiscing elit

- Categoria - 10/12/{{'now' | date: "%Y"}} + Categoria evento: Categoria + Data evento: 10/12/{{'now' | date: "%Y"}}
-
Lorem ipsum dolor sit amet, consectetur adipiscing elit…

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

di Federico De Paolis Leggi di più - su Lorem ipsum dolor sit amet, consectetur adipiscing elit… + su Lorem ipsum dolor sit amet, consectetur adipiscing elit
@@ -193,16 +212,16 @@ Il **PIN** ha tre varianti di classe per il suo contenitore `.it-pin-wrapper`:
-
+

- + Milestone
dicembre {{'now' | date: "%Y"}}
-

+
-
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor…
+

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.

diff --git a/src/scss/custom/_timeline.scss b/src/scss/custom/_timeline.scss index e04b08247..42aaea0d1 100644 --- a/src/scss/custom/_timeline.scss +++ b/src/scss/custom/_timeline.scss @@ -62,6 +62,8 @@ background: $timeline-pin-background; border-radius: $border-radius; font-family: $font-family-monospace; + font-size: var(--bs-body-font-size); + line-height: var(--bs-body-line-height); span { padding: $v-gap * 0.5 $v-gap * 2;