Skip to content

Commit

Permalink
fix: update toolbar examples and documentation
Browse files Browse the repository at this point in the history
  • Loading branch information
Mattia541993 committed Oct 15, 2024
1 parent adb17d6 commit a28eb1c
Showing 1 changed file with 58 additions and 45 deletions.
103 changes: 58 additions & 45 deletions docs/menu-di-navigazione/toolbar.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ toc: true
}
</style>

L'elemento Toolbar è un contenitore di link, pulsanti o dropdown. Consiste in un elenco `<ul>` con tanti elementi `<li>` quante sono le voci richieste.
L'elemento Toolbar è un contenitore di link, pulsanti o dropdown. Consiste in un elenco `<ul>` con tanti elementi `<li>` quante sono le voci richieste.

## Dimensioni

Expand All @@ -29,8 +29,8 @@ Per ottimizzare lo spazio disponibile l'elemento è fornito in tre versioni: gra

La versione predefinita dell'elemento è quella con icone grandi e label.

{% comment %}Example name: Grande{% endcomment %}
{% capture example %}
{% comment %}Example name: Grande{% endcomment %}
{% capture example %}
<nav class="toolbar">
<ul>
<li>
Expand Down Expand Up @@ -60,21 +60,22 @@ La versione predefinita dell'elemento è quella con icone grandi e label.
<li>
<a href="#" class="disabled" disabled aria-disabled="true">
<svg class="icon"><use href="{{ site.baseurl }}/dist/svg/sprites.svg#it-star-outline"></use></svg>
<span class="toolbar-label">preferiti<span class="visually-hidden">elemento disabilitato</span></span>
<span class="toolbar-label">preferiti</span>
</a>
</li>
</ul>
</nav>
{% endcapture %}{% include example.html content=example %}
{% endcapture %}
{% include example.html content=example %}

### Toolbar media

Applicando una classe aggiuntiva `.toolbar-medium` alla Toolbar si ottiene una versione di dimensioni medie.

In questo caso le label, nascoste visivamente, devono essere contenute in uno `<span>` con classe `.visually-hidden`, per rendere disponibile la descrizione agli screen reader.

{% comment %}Example name: Media{% endcomment %}
{% capture example %}
{% comment %}Example name: Media{% endcomment %}
{% capture example %}
<nav class="toolbar toolbar-medium">
<ul>
<li>
Expand Down Expand Up @@ -115,16 +116,17 @@ In questo caso le label, nascoste visivamente, devono essere contenute in uno `<
</li>
</ul>
</nav>
{% endcapture %}{% include example.html content=example %}
{% endcapture %}
{% include example.html content=example %}

### Toolbar piccola
### Toolbar piccola

Applicando una classe aggiuntiva `.toolbar-small` alla Toolbar si ottiene la versione più piccola.

Anche in questo caso le label, non visibile, devono essere contenute in uno `<span>` con classe `.visually-hidden`, per rendere disponibile la descrizione agli screen reader.

{% comment %}Example name: Piccola{% endcomment %}
{% capture example %}
{% comment %}Example name: Piccola{% endcomment %}
{% capture example %}
<nav class="toolbar toolbar-small">
<ul>
<li>
Expand Down Expand Up @@ -165,23 +167,24 @@ Anche in questo caso le label, non visibile, devono essere contenute in uno `<sp
</li>
</ul>
</nav>
{% endcapture %}{% include example.html content=example %}
{% endcapture %}
{% include example.html content=example %}

## Stato degli elementi

Al tag `<a>` dell'elemento attivo va applicata la classe `.active`.
Al tag `<a>` dell'elemento attivo va applicata la classe `.active`.

Gli elementi disabilitati avranno invece una classe `.disabled` con ulteriori accorgimenti relativi all'accessibilità a seconda della tipologia:

- **link, tag `<a>`:** aggiungere la proprietà HTML `disabled` al tag. Aggiungere uno span riservato agli screen reader all'interno della label. es.: `<span class="visually-hidden"> elemento disabilitato</span>`
- **dropdown button, tag `<button>`:** aggiungere l'attributo `aria-disabled="true"`.
- **link, tag `<a>`:** aggiungere la proprietà HTML `disabled` al tag.
- **dropdown button, tag `<button>`:** aggiungere l'attributo `aria-disabled="true"`.

## Divisori

Per aggiungere degli elementi divisori fra gli elementi utilizzare dei tag `<li>` con classe `.toolbar-divider`, aggiungendo il ruolo separatore `role="separator"` per indicarne la presenza agli screen reader e `aria-orientation="vertical"` per indicarne l'orientamento.

{% comment %}Example name: Con divisori{% endcomment %}
{% capture example %}
{% comment %}Example name: Con divisori{% endcomment %}
{% capture example %}
<nav class="toolbar">
<ul>
<li>
Expand Down Expand Up @@ -218,7 +221,8 @@ Per aggiungere degli elementi divisori fra gli elementi utilizzare dei tag `<li>
</li>
</ul>
</nav>
{% endcapture %}{% include example.html content=example %}
{% endcapture %}
{% include example.html content=example %}

## Toolbar con Badge

Expand All @@ -228,8 +232,8 @@ I Badge possono essere utilizzati per indicare contenuti non letti o alert di va

Nella versione grande i Badge possono contenere dei numeri. Il numero dei contenuti non letti o nuovi va indicato anche all'interno della label in uno `<span>` con classe `.visually-hidden` riservato agli screen reader.

{% comment %}Example name: Grande con badge{% endcomment %}
{% capture example %}
{% comment %}Example name: Grande con badge{% endcomment %}
{% capture example %}
<nav class="toolbar">
<ul>
<li>
Expand Down Expand Up @@ -266,14 +270,15 @@ Nella versione grande i Badge possono contenere dei numeri. Il numero dei conten
</li>
</ul>
</nav>
{% endcapture %}{% include example.html content=example %}
{% endcapture %}
{% include example.html content=example %}

### Media con Badge

Nella versione media i Badge non contengono numeri ma possono essere usati come alert generici. Il numero dei contenuti non letti o nuovi va indicato all'interno della label con classe `.visually-hidden` riservata agli screen reader.

{% comment %}Example name: Media con badge{% endcomment %}
{% capture example %}
{% comment %}Example name: Media con badge{% endcomment %}
{% capture example %}
<nav class="toolbar toolbar-medium">
<ul>
<li>
Expand Down Expand Up @@ -322,14 +327,15 @@ Nella versione media i Badge non contengono numeri ma possono essere usati come
</li>
</ul>
</nav>
{% endcapture %}{% include example.html content=example %}
{% endcapture %}
{% include example.html content=example %}

### Piccola con Badge

Nella versione piccola i Badge non contengono numeri ma possono essere usati come alert generici. Il numero dei contenuti non letti o nuovi va indicato all'interno della label con classe `.visually-hidden` riservata agli screen reader.

{% comment %}Example name: Piccola con badge{% endcomment %}
{% capture example %}
{% comment %}Example name: Piccola con badge{% endcomment %}
{% capture example %}
<nav class="toolbar toolbar-small">
<ul>
<li>
Expand Down Expand Up @@ -378,16 +384,17 @@ Nella versione piccola i Badge non contengono numeri ma possono essere usati com
</li>
</ul>
</nav>
{% endcapture %}{% include example.html content=example %}
{% endcapture %}
{% include example.html content=example %}

## Toolbar con Dropdown

All'interno della Toolbar è possibile implementare dei pulsanti dropdown con relativo sottomenù.

### Grande con Dropdown

{% comment %}Example name: Grande con dropdown{% endcomment %}
{% capture example %}
{% comment %}Example name: Grande con dropdown{% endcomment %}
{% capture example %}
<nav class="toolbar">
<ul>
<li>
Expand Down Expand Up @@ -479,12 +486,13 @@ All'interno della Toolbar è possibile implementare dei pulsanti dropdown con re
</li>
</ul>
</nav>
{% endcapture %}{% include example.html content=example %}
{% endcapture %}
{% include example.html content=example %}

### Media con Dropdown

{% comment %}Example name: Media con dropdown{% endcomment %}
{% capture example %}
{% comment %}Example name: Media con dropdown{% endcomment %}
{% capture example %}
<nav class="toolbar toolbar-medium">
<ul>
<li>
Expand Down Expand Up @@ -599,12 +607,13 @@ All'interno della Toolbar è possibile implementare dei pulsanti dropdown con re
</li>
</ul>
</nav>
{% endcapture %}{% include example.html content=example %}
{% endcapture %}
{% include example.html content=example %}

### Piccola con Dropdown

{% comment %}Example name: Piccola con dropdown{% endcomment %}
{% capture example %}
{% comment %}Example name: Piccola con dropdown{% endcomment %}
{% capture example %}
<nav class="toolbar toolbar-small">
<ul>
<li>
Expand Down Expand Up @@ -719,16 +728,17 @@ All'interno della Toolbar è possibile implementare dei pulsanti dropdown con re
</li>
</ul>
</nav>
{% endcapture %}{% include example.html content=example %}
{% endcapture %}
{% include example.html content=example %}

## Toolbar verticale

Applicando una classe aggiuntiva `.toolbar-vertical` alla Toolbar gli elementi vengono visualizzati in colonna.

### Grande verticale

{% comment %}Example name: Grande verticale{% endcomment %}
{% capture example %}
{% comment %}Example name: Grande verticale{% endcomment %}
{% capture example %}
<nav class="toolbar toolbar-vertical">
<ul>
<li>
Expand Down Expand Up @@ -777,12 +787,13 @@ Applicando una classe aggiuntiva `.toolbar-vertical` alla Toolbar gli elementi v
</li>
</ul>
</nav>
{% endcapture %}{% include example.html content=example %}
{% endcapture %}
{% include example.html content=example %}

### Media verticale

{% comment %}Example name: Media verticale{% endcomment %}
{% capture example %}
{% comment %}Example name: Media verticale{% endcomment %}
{% capture example %}
<nav class="toolbar toolbar-medium toolbar-vertical">
<ul>
<li>
Expand Down Expand Up @@ -837,12 +848,13 @@ Applicando una classe aggiuntiva `.toolbar-vertical` alla Toolbar gli elementi v
</li>
</ul>
</nav>
{% endcapture %}{% include example.html content=example %}
{% endcapture %}
{% include example.html content=example %}

### Piccola verticale

{% comment %}Example name: Piccola verticale{% endcomment %}
{% capture example %}
{% comment %}Example name: Piccola verticale{% endcomment %}
{% capture example %}
<nav class="toolbar toolbar-small toolbar-vertical">
<ul>
<li>
Expand Down Expand Up @@ -903,4 +915,5 @@ Applicando una classe aggiuntiva `.toolbar-vertical` alla Toolbar gli elementi v
</li>
</ul>
</nav>
{% endcapture %}{% include example.html content=example %}
{% endcapture %}
{% include example.html content=example %}

0 comments on commit a28eb1c

Please sign in to comment.