Listy: specyfikacje
Listy to ciągłe, pionowe zestawy elementów tekstowych i graficznych.
Warianty
Listy ekspresywne
Użyj wariantu listy ekspresywnej, aby uzyskać bardziej elastyczne możliwości stylowania, wyróżnione stany zaznaczenia oraz dostosowywane sloty.

Listy bazowe
Listy bazowe są nadal dostępne, ale nie oferują najnowszego stylu wizualnego, sposobu obsługi zaznaczenia ani funkcji slotów.
W implementacji internetowej listy ekspresywne bazują na listach bazowych.
Zobacz specyfikacje listy bazowej

| Warianty | M3 | M3 Expressive |
|---|---|---|
| Listy (ekspresywne) | -- | Dostępne |
| Listy (bazowe) | Dostępne | Niezalecane. Zamiast tego użyj list ekspresywnych. |
Konfiguracje
Style
Style standardowy i segmentowy są wyłącznie wyborem wizualnym i nie wpływają na zachowanie listy.

- Styl standardowy
- Styl segmentowy
Zaznaczanie elementów listy
Lista może jednocześnie używać tylko jednego trybu zaznaczania. Na przykład listę z pojedynczą akcją można przekształcić w listę wielokrotnego wyboru, ale nie może być jednocześnie oboma typami list.




Interakcje z listami
Listy umożliwiają:
Więcej o dostępności interakcji w listach

| Kategoria | Konfiguracja | M3 | M3 Expressive |
|---|---|---|---|
| Style | Standardowy | Dostępne | Dostępne |
| Segmentowy | -- | Dostępne | |
| Tryby zaznaczania | Pojedyncza akcja, wiele akcji, pojedynczy wybór, wielokrotny wybór | Dostępne | Dostępne |
| Interakcje | Rozwijanie, przesuwanie\* | Dostępne | Dostępne |
* Interakcje typu „przesuń, aby odsłonić” są dostępne tylko w widokach Androida (Android Views)
Tokeny i specyfikacje
Użyj menu w tabeli, aby wybrać zestaw tokenów. Zestaw common łączy tokeny bazowe z nowymi ekspresywnymi kształtami i rozmiarami. Zestaw expand zawiera tokeny obsługujące interakcję rozwijania. Dowiedz się więcej o tokenach projektowych
Lista – wspólne
Lista – rozwinięcie
Anatomia

Kontener i tekst etykiety są wymagane. Wszystkie pozostałe elementy są opcjonalne:
- Kontener
- Nadtytuł (overline)
- Tekst etykiety
- Tekst końcowy
- Tekst pomocniczy
- Ikona końcowa
- Separator
- Awatar wiodący
- Ikona wiodąca
- Wiodące multimedia: obraz lub wideo
Elastyczność i sloty
M3 Design Kit zawiera listy z niestandardowymi slotami umożliwiającymi projektowanie elastycznych układów elementów. Listę niestandardową można traktować jako kontener z trzema różnymi slotami: slotem wiodącym, slotem treści i slotem końcowym. Każdy slot może zawierać inny element.
Dostępność slotów
Sloty nie są domyślnie dostępne. Należy uwzględnić następujące kwestie:
- Elementy muszą przestrzegać reguł, struktury i wzorców interakcji właściwych dla list
- Stosuj standardowe odstępy wewnętrzne elementu listy
- Rozmiar obszaru dotykowego musi wynosić co najmniej 48x48dp
- Nie dodawaj elementów interaktywnych utrudniających nawigację po elemencie listy, zwłaszcza osobom korzystającym z czytników ekranu

- Slot wiodący
- Slot treści
- Slot końcowy
WARNING
Sloty wymagają wdrożenia niestandardowego kodu, który trzeba utworzyć i utrzymywać
Slot wiodący i slot końcowy muszą mieć mniejszą szerokość niż sekcja treści.
1. Sloty wiodące mogą zawierać:
- Elementy wizualne: awatar, ikona, obraz lub miniatura wideo
- Kontrolki zaznaczania: pole wyboru, przycisk radiowy lub przełącznik
- Modyfikacje: plakietka lub większy obraz
2. Sloty treści muszą być najszerszym slotem i mogą zawierać:
- Domyślna treść: tekst etykiety, tekst pomocniczy
- Opcjonalne dodatki: plakietka, ikona, etykieta wbudowana lub więcej elementów tekstowych
- Unikaj zbyt długich linii tekstu, aby zachować czytelność
3. Sloty końcowe mogą zawierać:
- Elementy akcji lub tekst: ikona, przycisk ikonowy lub tekst końcowy
- Kontrolki zaznaczania: pole wyboru, przycisk radiowy lub przełącznik

Listy z zaznaczaniem
W listach z zaznaczaniem używaj tylko jednej interakcji zaznaczania na element listy.


Kolor
Wartości kolorów są implementowane za pomocą tokenów projektowych. Dla projektantów oznacza to pracę z wartościami kolorów odpowiadającymi tokenom. W implementacji wartość koloru będzie tokenem odwołującym się do wartości. Dowiedz się więcej o tokenach projektowych

Role kolorów listy używane w motywach jasnym i ciemnym:
- Powierzchnia
- Na powierzchni – wariant
- Na powierzchni
- Na powierzchni – wariant
- Na powierzchni – wariant
- Na powierzchni – wariant
- Kontur – wariant
- Kontener podstawowy
- Na kontenerze podstawowym
- Na powierzchni – wariant
Stany
Stany to wizualne reprezentacje informujące o stanie komponentu lub elementu interaktywnego. Dowiedz się więcej o stanach interakcji
Domyślne elementy listy

- Włączony
- Wyłączony
- Najechany
- W fokusie
- Wciśnięty
- Przeciągany
Zaznaczone elementy listy

- Włączony
- Wyłączony
- Najechany
- W fokusie
- Wciśnięty
- Przeciągany
Wymiary

Przekształcanie kształtu
Gdy element listy jest zaznaczony, kształt narożników zmienia się, aby wyróżnić aktywny element:
- Promień narożnika niezaznaczonego elementu: wewnętrzny 4dp, zewnętrzny 16dp
- Promień narożnika zaznaczonego elementu: 16dp


Lista (bazowa)
Wariant listy bazowej jest dostępny i nadal działa w istniejących produktach. Jednak w przypadku nowych projektów zalecany jest wariant listy ekspresywnej.
Tokeny i specyfikacje
Tokeny listy bazowej znajdują się w zestawie tokenów common.TIP
Ten zestaw zawiera również kilka tokenów ekspresywnych.
Kolor
Wartości kolorów są implementowane za pomocą tokenów projektowych. Dla projektantów oznacza to pracę z wartościami kolorów odpowiadającymi tokenom. W implementacji wartość koloru będzie tokenem odwołującym się do wartości. Dowiedz się więcej o tokenach projektowych

Role kolorów listy używane w motywach jasnym i ciemnym:
- Powierzchnia
- Na powierzchni
- Na powierzchni – wariant
- Na powierzchni – wariant
- Na powierzchni – wariant
- Kontur – wariant
- Kontener podstawowy
- Na kontenerze podstawowym
- Na powierzchni – wariant
Stany
Stany to wizualne reprezentacje informujące o stanie komponentu lub elementu interaktywnego.

- Włączony
- Wyłączony
- Najechany
- W fokusie
- Wciśnięty
- Przeciągany
Układ
Listy jednowierszowe


Listy dwuwierszowe


Listy trzywierszowe


| Atrybut | Wartość |
|---|---|
| Wyrównanie etykiety | Wyśrodkowane |
| Wyrównanie etykiety, gdy wysokość wynosi 88dp lub więcej | Do góry |
| Lewy odstęp wewnętrzny etykiety | 16dp |
| Wyrównanie w pionie elementu wiodącego | Wyśrodkowane |
| Wyrównanie w pionie elementu wiodącego, gdy wysokość wynosi 88dp lub więcej | Do góry |
| Lewy odstęp wewnętrzny elementu wiodącego | 16dp |
| Wyrównanie w pionie ikony wiodącej | Do góry |
| Górny odstęp wewnętrzny ikony wiodącej | 8dp |
| Górny odstęp wewnętrzny ikony wiodącej, gdy wysokość wynosi 88dp lub więcej | 12dp |
| Wyrównanie w pionie elementu końcowego | Wyśrodkowane |
| Wyrównanie w pionie elementu końcowego, gdy wysokość wynosi 88dp lub więcej | Do góry |
| Lewy odstęp wewnętrzny elementu końcowego | 16dp |
| Prawy odstęp wewnętrzny elementu końcowego | 24dp |
| Odstęp wewnętrzny nad i pod separatorem | 0dp |
| Obszary dotykowe | 48dp |
| Separator pełnej szerokości | 100% |
| Lewy odstęp wewnętrzny wciętego separatora | 16dp |
| Prawy odstęp wewnętrzny wciętego separatora | 24dp |
Konfiguracje
Awatar wiodący

- Z awatarem wiodącym
- Z awatarem wiodącym i końcowym polem wyboru
Wiodący obraz lub miniatura

- Z obrazem wiodącym
- Z obrazem wiodącym i końcowym polem wyboru
Wiodące wideo

- Z wiodącym wideo
- Z wiodącym wideo i końcowym polem wyboru
Ikona wiodąca

- Z ikoną wiodącą
- Z ikoną wiodącą i końcowym polem wyboru
Tylko tekst

- Tylko z tekstem
- Z tekstem i końcowym polem wyboru
Wiodące pole wyboru

- Z wiodącym polem wyboru
- Z wiodącym polem wyboru i tekstem końcowym
Wiodący przycisk radiowy

- Z wiodącym przyciskiem radiowym
- Z wiodącym przyciskiem radiowym i tekstem końcowym
Końcowy przełącznik

- Z końcowym przełącznikiem
- Z ikoną wiodącą i końcowym przełącznikiem