Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Rimozione dei riferimenti a "elemento disabilitato" nella Toolbar sugli elementi disabilitati #1251

Draft
wants to merge 1 commit into
base: main
Choose a base branch
from
Draft
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
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 %}
Loading