Seznamy: Specifikace
Seznamy jsou vertikálně uspořádané, souvislé indexy textu a obrázků.
Varianty
Expresivní seznamy
Použijte expresivní variantu seznamu pro flexibilnější stylování, výraznější stavy výběru a přizpůsobitelné sloty.

Základní seznamy
Základní seznamy lze stále používat, ale nemají nejnovější vizuální styl, způsob zobrazení výběru ani funkčnost slotů.
Expresivní seznamy na webu vycházejí ze základních seznamů.
Viz specifikace základního seznamu

| Varianty | M3 | M3 Expressive |
|---|---|---|
| Seznamy (expresivní) | -- | K dispozici |
| Seznamy (základní) | K dispozici | Nedoporučeno. Použijte místo toho expresivní seznamy. |
Konfigurace
Styly
Standardní a segmentované styly jsou pouze vizuální volbou a neovlivňují chování seznamu.

- Standardní
- Segmentovaný
Výběr v seznamu
Seznam může mít v daném okamžiku pouze jeden režim výběru. Například seznam s jednou akcí se může změnit na seznam s vícenásobným výběrem, ale nemůže oba režimy používat současně.




Interakce se seznamem
Seznamy podporují:
Více o přístupnosti interakcí v seznamu

| Kategorie | Konfigurace | M3 | M3 Expressive |
|---|---|---|---|
| Styly | Standardní | K dispozici | K dispozici |
| Segmentovaný | -- | K dispozici | |
| Režimy výběru | Jedna akce, více akcí, jeden výběr, vícenásobný výběr | K dispozici | K dispozici |
| Interakce | Rozbalení, odhalení přejetím\* | K dispozici | K dispozici |
* Interakce odhalení přejetím jsou dostupné pouze v Android Views
Tokeny a specifikace
V nabídce tabulky zvolte sadu tokenů. Společná sada kombinuje základní tokeny s novými expresivními tvary a velikostmi. Sada rozbalení obsahuje tokeny pro interakci rozbalení. Více o designových tokenech
Seznam - společná sada
Seznam - sada rozbalení
Anatomie

Kontejner a text popisku jsou povinné. Všechny ostatní prvky jsou volitelné:
- Kontejner
- Text nad popiskem
- Text popisku
- Koncový text
- Podpůrný text
- Koncová ikona
- Oddělovač
- Úvodní avatar
- Úvodní ikona
- Úvodní médium – obrázek nebo video
Flexibilita a sloty
M3 Design Kit obsahuje seznamy s vlastními sloty pro navrhování flexibilních rozvržení položek. Seznam s vlastními sloty si představte jako kontejner se třemi sloty: úvodním, obsahovým a koncovým. Každý slot může obsahovat jiný prvek.
Přístupnost slotů
Sloty nejsou ve výchozím nastavení přístupné. Vezměte v úvahu následující:
- Prvky musí dodržovat pravidla, strukturu a vzory interakce seznamů
- Používejte standardní odsazení položek seznamu
- Velikost dotykového cíle musí být alespoň 48x48dp
- Nepřidávejte interaktivní prvky, které ztěžují navigaci v položce seznamu, zejména uživatelům čteček obrazovky

- Úvodní slot
- Obsahový slot
- Koncový slot
WARNING
Sloty vyžadují vlastní implementaci v kódu, kterou je nutné vytvořit a udržovat
Úvodní a koncové pozice slotů musí být užší než obsahová část.
1. Úvodní sloty mohou obsahovat:
- Vizuální prvky: avatar, ikona, obrázek nebo miniatura videa
- Ovládací prvky výběru: zaškrtávací políčko, radiotlačítko nebo přepínač
- Přizpůsobení: odznak nebo větší obrázek
2. Obsahové sloty musí mít největší šířku a mohou obsahovat:
- Výchozí obsah: text popisku, podpůrný text
- Volitelné doplňky: odznak, ikona, vložený popisek nebo další textové prvky
- Vyhněte se příliš dlouhým řádkům textu, abyste zachovali čitelnost
3. Koncové sloty mohou obsahovat:
- Akční prvky nebo text: ikona, tlačítko s ikonou nebo koncový text
- Ovládací prvky výběru: zaškrtávací políčko, radiotlačítko nebo přepínač

Výběrové seznamy
U výběrových seznamů používejte pouze jednu interakci výběru na položku seznamu.


Barvy
Barvy se implementují prostřednictvím designových tokenů. Pro designéry to znamená pracovat s hodnotami barev, které odpovídají tokenům. Při implementaci je barva vyjádřena tokenem, který odkazuje na hodnotu barvy. Více o designových tokenech

Barevné role seznamu používané pro světlé a tmavé motivy:
- Povrch
- Varianta na povrchu
- Na povrchu
- Varianta na povrchu
- Varianta na povrchu
- Varianta na povrchu
- Varianta obrysu
- Primární kontejner
- Na primárním kontejneru
- Varianta na povrchu
Stavy
Stavy jsou vizuální znázornění používaná ke sdělení stavu komponenty nebo interaktivního prvku. Více o stavech interakce
Výchozí položky seznamu

- Povolený
- Zakázaný
- Najetí kurzorem
- Fokus
- Stisknutí
- Tažení
Vybrané položky seznamu

- Povolený
- Zakázaný
- Najetí kurzorem
- Fokus
- Stisknutí
- Tažení
Rozměry

Přeměna tvaru
Při výběru položky seznamu se změní poloměry rohů, aby byla aktivní položka zvýrazněna:
- Poloměr rohů nevybrané položky: vnitřní 4dp, vnější 16dp
- Poloměr rohů vybrané položky: 16dp


Seznam (základní)
Základní varianta seznamu je dostupná a nadále funguje ve stávajících produktech. Pro nové návrhy se však doporučuje expresivní varianta seznamu.Tokeny a specifikace
Základní tokeny seznamu jsou součástí společné sady tokenů.
TIP
Tato sada také obsahuje několik expresivních tokenů.
Barvy
Barvy se implementují prostřednictvím designových tokenů. Pro designéry to znamená pracovat s hodnotami barev, které odpovídají tokenům. Při implementaci je barva vyjádřena tokenem, který odkazuje na hodnotu barvy. Více o designových tokenech

Barevné role seznamu používané pro světlé a tmavé motivy:
- Povrch
- Na povrchu
- Varianta na povrchu
- Varianta na povrchu
- Varianta na povrchu
- Varianta obrysu
- Primární kontejner
- Na primárním kontejneru
- Varianta na povrchu
Stavy
Stavy jsou vizuální znázornění používaná ke sdělení stavu komponenty nebo interaktivního prvku.

- Povolený
- Zakázaný
- Najetí kurzorem
- Fokus
- Stisknutí
- Tažení
Rozvržení
Jednořádkové seznamy


Dvouřádkové seznamy


Třířádkové seznamy


| Vlastnost | Hodnota |
|---|---|
| Zarovnání popisku | Na střed |
| Zarovnání popisku při výšce 88dp a více | Nahoře |
| Odsazení popisku vlevo | 16dp |
| Zarovnání úvodního prvku (svislé) | Na střed |
| Zarovnání úvodního prvku (svislé) při výšce 88dp a více | Nahoře |
| Odsazení úvodního prvku vlevo | 16dp |
| Zarovnání úvodní ikony (svislé) | Nahoře |
| Horní odsazení úvodní ikony | 8dp |
| Horní odsazení úvodní ikony při výšce 88dp a více | 12dp |
| Zarovnání koncového prvku (svislé) | Na střed |
| Zarovnání koncového prvku (svislé) při výšce 88dp a více | Nahoře |
| Odsazení koncového prvku vlevo | 16dp |
| Odsazení koncového prvku vpravo | 24dp |
| Odsazení nad a pod oddělovačem | 0dp |
| Dotykový cíl | 48dp |
| Oddělovač v plné šířce | 100% |
| Vnitřní odsazení oddělovače vlevo | 16dp |
| Vnitřní odsazení oddělovače vpravo | 24dp |
Konfigurace
Úvodní avatar

- S úvodním avatarem
- S úvodním avatarem a koncovým zaškrtávacím políčkem
Úvodní obrázek nebo miniatura

- S úvodním obrázkem
- S úvodním obrázkem a koncovým zaškrtávacím políčkem
Úvodní video

- S úvodním videem
- S úvodním videem a koncovým zaškrtávacím políčkem
Úvodní ikona

- S úvodní ikonou
- S úvodní ikonou a koncovým zaškrtávacím políčkem
Pouze text

- Pouze s textem
- S textem a koncovým zaškrtávacím políčkem
Úvodní zaškrtávací políčko

- S úvodním zaškrtávacím políčkem
- S úvodním zaškrtávacím políčkem a koncovým textem
Úvodní radiotlačítko

- S úvodním radiotlačítkem
- S úvodním radiotlačítkem a koncovým textem
Koncový přepínač

- S koncovým přepínačem
- S úvodní ikonou a koncovým přepínačem