Materiale di composizione 3
androidx.compose.material3
(Consulta la documentazione di riferimento API per tutti i pacchetti di scrittura)
Aggiornamento più recente | Release stabile | Candidato per la release | Versione beta | Release alpha |
---|---|---|---|---|
12 giugno 2024 | 1.2.1 | - | 1.3.0-beta03 | - |
Struttura
Compose è una combinazione di sette ID gruppo Maven all'interno di androidx
. Ogni gruppo contiene un sottoinsieme specifico di funzionalità, ciascuna con il proprio set di note di rilascio.
Questa tabella illustra i gruppi e fornisce i link a ciascun insieme di note di rilascio.
Raggruppa | Descrizione |
---|---|
compose.animation | Creare animazioni nelle applicazioni Jetpack Compose per arricchire l'esperienza utente. |
compose.compiler | Trasforma le funzioni @Composable e abilita le ottimizzazioni con un plug-in di compilazione Kotlin. |
compose.foundation | Scrivi applicazioni Jetpack Compose con componenti di base pronti all'uso ed estendi le basi per creare i componenti del tuo sistema di progettazione. |
compose.material | Crea UI di Jetpack Compose con componenti Material Design pronti per l'uso. Si tratta del punto di accesso di livello superiore di Compose, progettato per fornire componenti corrispondenti a quelli descritti su www.material.io. |
compose.material3 | Crea UI di Jetpack Compose con i componenti di Material Design 3, la prossima evoluzione di Material Design. Material 3 include temi e componenti aggiornati e funzionalità di personalizzazione di Material You, come il colore dinamico, ed è progettato per essere coerente con il nuovo stile visivo e la UI di sistema di Android 12. |
compose.runtime | Componenti di base fondamentali del modello di programmazione e della gestione dello stato di Compose, nonché del runtime di base per il plug-in di Compose Compiler da utilizzare come target. |
compose.ui | Componenti fondamentali dell'interfaccia utente di composizione necessari per interagire con il dispositivo, inclusi layout, disegno e input. |
Dichiarazione delle dipendenze
Per aggiungere una dipendenza su Compose, devi aggiungere il Repository Maven di Google al tuo progetto. Per ulteriori informazioni, consulta il Repository Maven di Google.
Aggiungi le dipendenze per gli artefatti necessari nel file build.gradle
per
l'app o il modulo:
trendy
dependencies { implementation "androidx.compose.material3:material3:1.2.1" implementation "androidx.compose.material3:material3-window-size-class:1.2.1" implementation "androidx.compose.material3:material3-adaptive-navigation-suite:1.3.0-beta03" } android { buildFeatures { compose true } composeOptions { kotlinCompilerExtensionVersion = "1.1.1" } kotlinOptions { jvmTarget = "1.8" } }
Kotlin
dependencies { implementation("androidx.compose.material3:material3:1.2.1") implementation("androidx.compose.material3:material3-window-size-class:1.2.1") implementation("androidx.compose.material3:material3-adaptive-navigation-suite:1.3.0-beta03") } android { buildFeatures { compose = true } composeOptions { kotlinCompilerExtensionVersion = "1.1.1" } kotlinOptions { jvmTarget = "1.8" } }
Per ulteriori informazioni sulle dipendenze, vedi Aggiungere dipendenze build.
Feedback
Il tuo feedback ci aiuta a migliorare Jetpack. Facci sapere se rilevi nuovi problemi o hai idee per migliorare la libreria. Dai un'occhiata ai problemi esistenti in questa libreria prima di crearne una nuova. Puoi aggiungere il tuo voto a un problema esistente facendo clic sul pulsante a forma di stella.
Per ulteriori informazioni, consulta la documentazione di Issue Tracker.
Compose Material3 Common Versione 1.0
Versione 1.0.0-alpha01
17 aprile 2024
androidx.compose.material3:material3-common:1.0.0-alpha01
, androidx.compose.material3:material3-common-android:1.0.0-alpha01
e androidx.compose.material3:material3-common-desktop:1.0.0-alpha01
vengono rilasciati. La versione 1.0.0-alpha01 contiene questi commit.
Nuove funzionalità
Componenti senza tema che possono essere utilizzati per creare componenti di Material Design:
- Tavolozza dei toni
- Icona
- Dimensioni del touch target
Compose Material3 Adaptive Navigation Suite versione 1.0
Versione 1.0.0-alpha07
1° maggio 2024
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha07
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha07
e androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha07
vengono rilasciati. La versione 1.0.0-alpha07 contiene questi commit.
Modifiche alle API
- Rendi le API della suite di navigazione non sperimentali (If62af)
Correzioni di bug
- Utilizza inserti per i contenuti per impostazione predefinita (50266df)
Versione 1.0.0-alpha06
17 aprile 2024
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha06
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha06
e androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha06
vengono rilasciati. La versione 1.0.0-alpha06 contiene questi commit.
Modifiche alle API
- Aggiungi
containerColor
econtentColor
aNavigationSuiteScaffoldDefaults
. (I64e3a, b/331993720). - Aggiunta della funzione
itemColors
aNavigationSuiteDefaults
in corso... (Idf719, b/328480012) - Rendi
NavigationSuiteScope
sigillato. (Iefa57).
Versione 1.0.0-alpha05
6 marzo 2024
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha05
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha05
e androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha05
vengono rilasciati. La versione 1.0.0-alpha05 contiene questi commit.
Modifiche alle API
- Imposta il costruttore
NavigationSuiteItemColors
come pubblico. (Ica83a, b/324886877).
Versione 1.0.0-alpha04
21 febbraio 2024
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha04
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha04
e androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha04
vengono rilasciati. La versione 1.0.0-alpha04 contiene questi commit.
Aggiornamenti delle dipendenze
- Aggiorna le dipendenze adattive Material3 ai nuovi percorsi dei moduli. (Ibc421)
- Esegui la migrazione per utilizzare la versione delle classi di dimensioni delle finestre in Gestione finestre. (I3794d)
Versione 1.0.0-alpha03
7 febbraio 2024
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha03
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha03
e androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha03
vengono rilasciati. La versione 1.0.0-alpha03 contiene questi commit.
Modifiche alle API
- Aggiorna il nome del pacchetto a suite di navigazione dalla suite di navigazione (I7eff7)
- I componenti Material3 che mostrano un valore
MutableInteractionSource
nell'API sono stati aggiornati in modo da ora esporre un valoreMutableInteractionSource
con valore null che per impostazione predefinita è null. Non ci sono modifiche semantiche qui: passare un valore null significa che non vuoi istruireMutableInteractionSource
, che verrà creato all'interno del componente, se necessario. La modifica a null consente ad alcuni componenti di non allocare mai unMutableInteractionSource
e ad altri componenti di creare un'istanza solo quando necessario, il che migliora le prestazioni di questi componenti. Se non stai utilizzando ilMutableInteractionSource
passato a questi componenti, si consiglia di passare il valore null. Ti consigliamo inoltre di apportare modifiche simili ai tuoi componenti. (I41abb, b/298048146)
Versione 1.0.0-alpha02
13 dicembre 2023
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha02
, androidx.compose.material3:material3-adaptive-navigation-suite-android:1.0.0-alpha02
e androidx.compose.material3:material3-adaptive-navigation-suite-desktop:1.0.0-alpha02
vengono rilasciati. La versione 1.0.0-alpha02 contiene questi commit.
Nuove funzionalità
- Aggiungi "Nessuno"
NavigationSuiteType
(If8cb1, b/313688598)
Correzioni di bug
- È stato risolto un problema che riempiva l'intero schermo del componente di navigazione quando la superficie principale presentava
modifier.fillMaxSize
. (c9cf250, b/312664933).
Versione 1.0.0-alpha01
15 novembre 2023
androidx.compose.material3:material3-adaptive-navigation-suite:1.0.0-alpha01
viene rilasciato. La versione 1.0.0-alpha01 contiene questi commit.
Nuove funzionalità
Compose Material3 Adaptive Versione 1.0
Versione 1.0.0-alpha06
7 febbraio 2024
androidx.compose.material3:material3-adaptive:1.0.0-alpha06
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha06
e androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha06
vengono rilasciati. La versione 1.0.0-alpha06 contiene questi commit.
Nuove funzionalità
- Sono state aggiunte ulteriori opzioni di comportamento per la navigazione a ritroso per
ThreePaneScaffoldNavigator
. (I858aa) - Sono stati aggiunti contenuti facoltativi della destinazione alla cronologia di navigazione. (Ibd7e6).
Versione 1.0.0-alpha05
24 gennaio 2024
androidx.compose.material3:material3-adaptive:1.0.0-alpha05
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha05
e androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha05
vengono rilasciati. La versione 1.0.0-alpha05 contiene questi commit.
Nuove funzionalità
- Supporta la consapevolezza della cronologia nella navigazione scaffold e nel calcolo del valore (I71d46)
Versione 1.0.0-alpha04
10 gennaio 2024
androidx.compose.material3:material3-adaptive:1.0.0-alpha04
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha04
e androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha04
vengono rilasciati. La versione 1.0.0-alpha04 contiene questi commit.
Nuove funzionalità
- Aggiunto supporto edge-to-edge nei impalcature dei riquadri (I1b462)
Modifiche alle API
- Proprietà dei limiti della cerniera spostate in Posture in un elenco di informazioni sulla cerniera (I24f90)
Correzioni di bug
- La correzione
AnimatedPane
non è stata ricomposta (c3f573d)
Versione 1.0.0-alpha03
13 dicembre 2023
androidx.compose.material3:material3-adaptive:1.0.0-alpha03
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha03
e androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha03
vengono rilasciati. La versione 1.0.0-alpha03 contiene questi commit.
Modifiche alle API
- Modifica i ruoli dello scaffold in alias di
ThreePaneScaffoldRole
. (I65bd1) - Crea una classe base per i ruoli scaffold (I4784d)
- Rimuovi il parametro non necessario dai contenuti di
AnimatedPane
(Ibc73b) - Rinomina
collectWindowSizeAsState
e restituisce invece i valori non elaborati (I480f4)
Versione 1.0.0-alpha02
29 novembre 2023
androidx.compose.material3:material3-adaptive:1.0.0-alpha02
, androidx.compose.material3:material3-adaptive-android:1.0.0-alpha02
e androidx.compose.material3:material3-adaptive-desktop:1.0.0-alpha02
vengono rilasciati. La versione 1.0.0-alpha02 contiene questi commit.
Modifiche alle API
- Suddividi le API di navigazione dalle API adattive scaffold. (Ic4045)
- Rimuovi corso
GutterSize
. (I785b3)
Correzioni di bug
- I riquadri di correzione non vengono scambiati quando non viene utilizzato
AnimatedPane
(d88f181)
Versione 1.0.0-alpha01
15 novembre 2023
androidx.compose.material3:material3-adaptive:1.0.0-alpha01
viene rilasciato. La versione 1.0.0-alpha01 contiene questi commit.
Nuove funzionalità
API delle condizioni adattive Material3:
API di direttiva scaffold per il riquadro adattivo Material3:
API scaffold per il riquadro adattivo Material3:
- API di base per Pane scaffold
Compose Material3 versione 1.3
Versione 1.3.0-beta03
12 giugno 2024
androidx.compose.material3:material3-*:1.3.0-beta03
viene rilasciato. La versione 1.3.0-beta03 contiene questi commit.
Contributi esterni
- Rendi disponibile
androidx.compose.material3.DropdownMenu
da un insieme di origini comune. (If62c0)
Versione 1.3.0-beta02
29 maggio 2024
androidx.compose.material3:material3-*:1.3.0-beta02
viene rilasciato. La versione 1.3.0-beta02 contiene questi commit.
Modifiche alle API
Modifier.pullToRefreshIndicator
supporta l'elevazione; aggiorna le API Pull To Update in modo che siano abilitate come un valore booleano anziché lambda. Supporto dell'allineamento dei contenuti inPullToRefreshBox
(I75679)- Fare in modo che
TooltipScope
sia un'interfaccia sigillata e creare un'implementazione interna da utilizzare inTooltipBox
ed Etichetta. (I3833e). - Sono stati aggiunti due nuovi modificatori a
CarouselItemScope
,maskClip
emaskBorder
, per aggiungere facilmente una forma e un bordo a qualsiasi elemento del carosello (Id67a1) TimePickerState
ora è un'interfaccia e consente di impostare l'ora (I88546)- API aggiornata per lo stile dei link: è stato spostato il
TextLinkStyles
inTextStyle
e rimosso ilTextDefaults
dal materiale. (I5477b)
Correzioni di bug
- Le icone di stato e della barra di navigazione di
ModalBottomSheet
ora rispondono allo stato del tema scuro. (Ie1fe7, b/338342149). - È stata aggiunta la semantica del foglio di chiusura allo scrim
ModalBottomSheet
. (0e61cb,b/328801864).
Contributi esterni
- Rendi
androidx.compose.material3.AlertDialog
disponibile da un set di origini comune (Ia33f5) - Rendi
ModalBottomSheet
disponibile da un insieme di origini comune (Id7cc7)
Versione 1.3.0-beta01
14 maggio 2024
androidx.compose.material3:material3-*:1.3.0-beta01
viene rilasciato. La versione 1.3.0-beta01 contiene questi commit.
Modifiche alle API
- Utilizzo di
DpSize
anzichéCaretProperties
. Rimozione diCaretProperties
in corso... RinominaCaretScope
inTooltipScope
. (Id9a76) - È stata aggiornata l'API per inserire nel testo i link a tema Material. In particolare, sono stati rimossi da
TextDefaults
i metodi per la creazione diLinkAnnotations
a tema e l'analisi dell'HTML con link a tema. È stata invece aggiunta una classeTextLinkStyles
che consente di definire lo stile dei link come parametro all'elemento componibile Testo. (I31b93)
Versione 1.3.0-alpha06
1° maggio 2024
androidx.compose.material3:material3-*:1.3.0-alpha06
viene rilasciato. La versione 1.3.0-alpha06 contiene questi commit.
Modifiche che provocano un errore
Nuove API pull-to-refresh:
- È stato semplificato
PullToRefreshState
per utilizzare valori frazionari al posto delle unità Dp. - Lo stato di
isRefreshing
è controllato dall'utente anziché daPullToRefreshState
. - È stata separata la connessione di scorrimento nidificata da
PullToRefreshState
. Viene gestito dal nuovoPullToRefreshBox
oModifier.pullToRefresh
. - Questo aggiornamento rappresenta una modifica che provoca un errore alle API sperimentali precedenti. (I0adeb, b/314496282, b/317177684, b/323787138, b/324573502, b/317177683).
- È stato semplificato
Modifiche alle API
RippleConfiguration#isEnabled
è stato rimosso eLocalRippleConfiguration
è stato reso nullo. Per disattivare un'eco, anziché fornire un valoreRippleConfiguration
conisEnabled = false
, forniscinull
aLocalRippleConfiguration
. (I22725)ModalBottomSheet
traccia in modo più preciso le strisce sulla barra di stato quando edge to edge è abilitato. I contenuti del riquadro inferiore modale ora possono utilizzare riquadri di finestre, consentendo di contenuti visibili sopra la barra di navigazione. Il parametroModalBottomSheet
windowInsets
è stato rinominato incontentWindowInsets
per specificare dove verranno applicati gli insiemi. Questi non sono più associati alla logica della finestra. Il tipo dicontentWindowInsets
è stato modificato in una funzione che restituisceWindowInsets
per consentirne la risoluzione nella nuova finestra. (I39630, b/274872542, b/300280229, b/290893168)PrimaryScrollableTabRow
eSecondaryScrollableTabRow
ora utilizzano il layout personalizzato invece della sottocomposizione, che dovrebbe migliorare le prestazioni. (I991e0).- Per i link di testo è stata selezionata l'opzione di stile per lo stato premuto, oltre allo stile normale, sono stati passati il mouse sopra i contenuti e ora è attivo. Ciascun metodo
TextDefaults
ha un argomentopressedStyle
a supporto di questo aspetto. (Ic473f, b/139312671).
Correzioni di bug
- Gli ancoraggi di trascinamento del riquadro di navigazione a scomparsa ora corrispondono alla larghezza di
drawerContent
. (Ibc72f, b/245355396). - La spaziatura interna superiore a
OutlinedTextField
per l'etichetta ora tiene conto delle dimensioni dei caratteri del sistema. (Idc781) - Posizione del pacchetto corretta per
CalendarLocale
. (Ifa235). - [Indietro predittivo] Aggiorna le animazioni predittive indietro per utilizzare la curva di interpolazione di (0.1, 0.1, 0, 1) (I2591a)
Versione 1.3.0-alpha05
17 aprile 2024
androidx.compose.material3:material3-*:1.3.0-alpha05
viene rilasciato. La versione 1.3.0-alpha05 contiene questi commit.
Nuove funzionalità
SearchBar
eDockedSearchBar
hanno nuovi sovraccarichi che utilizzano un parametro del campo di testo. In questo modo è possibile definire lo stile del campo di testo separatamente dal resto della barra di ricerca e trasferire campi di testo personalizzati. Il campo di testo dell'implementazione corrente è stato reso disponibile comeSearchBarDefaults.InputField
. (I50c73, b/275074248, b/278773336, b/326627700)- la lambda
drawTick
è stata aggiunta all'API pubblica per personalizzare i segni di graduazione, se necessario (I0c048)
Modifiche alle API
- Per i link di testo è stata attivata l'opzione di stile per lo stato premuto, oltre allo stile normale, è stata spostata il mouse sopra il video e messo a fuoco (I5f864, b/139312671)
- Aggiornamento di
CarouselItemInfo
aggiornato per esporre una maschera Rect che è oggetto di ritaglio dell'elemento (I785d8) BasicTooltipState
rimosso dall'API pubblica Material 3. La sua funzionalità viene combinata conTooltipState
fino a quando la metricaBasicTooltip
della fondazione non viene stabilizzata. (Icda29).- È stato aggiunto un oggetto
TextDefaults
che contiene metodi per creare una stringaLinkAnnotation
e analizzare la stringa con tag HTML che applicanoMaterialTheme
ai link (I98532, b/139312671). ExposedDropdownMenuBoxScope
non ammette più le sottoclassi. I menu a discesa esposti ora hanno unMenuAnchorType
che deve essere trasmesso amenuAnchor
per supportare un'esperienza migliore. Da utilizzare anziché passarefocusable
aExposedDropdownMenu
, che ora è deprecato.menuAnchor
ha un nuovo parametro per controllare lo stato dienabled
. (I55ee6, b/257209915, b/308840226).- È stato corretto il colore del bordo di
OutlinedButton
quando disattivato. Aggiunto un sovraccarico diButtonDefaults.outlinedButtonBorder("enabled")
che assume lo stato attivato. (Ie650b, b/318461363). - È stato aggiunto un nuovo corso
CarouselItemInfo
per aiutare i clienti a ottenere informazioni sulle dimensioni degli articoli. (I9070c) - Il costruttore
ColorScheme
senza container di superficie è ora deprecato. Esegui la migrazione al costruttore che include i container di superficie. (I35c11) - [Outline]
TextFieldDefaults
ContainerBox
rinominatoContainer
. (Ie8d3b).
Correzioni di bug
BottomSheetScaffold
non scorrerà più dallo scorrimento nidificato sesheetSwipeEnabled
è false. (I5e1c1, b/306464779).- Rimossa alcune annotazioni di attivazione di
ExperimentalMaterial3Api
inIconButtonSamples.kt
. (I111d1)
Versione 1.3.0-alpha04
3 aprile 2024
androidx.compose.material3:material3-*:1.3.0-alpha04
viene rilasciato. La versione 1.3.0-alpha04 contiene questi commit.
Nuove funzionalità
- Sono state aggiunte due versioni sperimentali del carosello Material3:
HorizontalMultiBrowseCarousel
eHorizontalUncontainedCarousel
(I88d64) - Aggiornamento del riquadro a scomparsa di Compose M3 (
ModalDrawerSheet
eDismissibleDrawerSheet
) per supportare il Indietro predittivo su U+ con attivazione (Ie5b0b) - È stata aggiunta una nuova API nell'icona per consentire il passaggio della tinta di colore come lambda per evitare la ricomposizione. (I5b5a2).
- Le principali API della barra delle app ora supportano altezze personalizzate per le sezioni fisse e comprimibili. (Ib8b0c, b/323403446).
Modifiche alle API
- Le principali API della barra delle app ora supportano altezze personalizzate per le sezioni fisse e comprimibili. Risolto il problema che causava la ricomposizione delle barre superiori delle app su una sola riga durante lo scorrimento dei contenuti. È stato risolto un problema per cui
MediumTopAppBar
troncava i titoli su dispositivi con impostazioni di visualizzazione e caratteri grandi. (Ib8b0c, b/323403446, b/300953236, b/286296147, b/330410290, b/308540676). SegmentedButton
e le API associate sono ora stabili (I8a158)SwipeToDismissBox
,SwipeToDismissBoxDefaults
,SwipeToDismissBoxState
eSwipeToDismissBoxValue
sono ora contrassegnati come stabili. (I5f000)- Rimosse le API e le enumerazioni
DismissDirection
eDismissValue
deprecate. (I89ccd) - È stato aggiunto un tag sperimentale all'oggetto companion
CarouselState
di Carousel. (I94154) - Ritira
LocalMinimumInteractiveComponentEnforcement
e introduciLocalMinimumInteractiveComponentSize
per sostituirlo. (I7a7ac) - Il costruttore
SearchBarColors
è ora pubblico. (I769ca) - Parametro
gesturesEnabled
aggiunto aSwipeToDismissBox
. (Idc59f, b/324170119). - Sono state rimosse le API dei campi di testo contrassegnate come deprecate e sperimentali. (I1305f)
Versione 1.3.0-alpha03
20 marzo 2024
androidx.compose.material3:material3-*:1.3.0-alpha03
viene rilasciato. La versione 1.3.0-alpha03 contiene questi commit.
Modifiche visive dirompenti
- Aggiorna l'overlay dello stato di messa a fuoco impostandolo su 0,1f per garantire un contrasto di colore sufficiente. (I7ea77)
- Piccole modifiche ai valori predefiniti dei colori di superficie e sfondo in
lightColorScheme
edarkColorScheme
. (I9db52)
Nuove funzionalità
- Parametri aggiunti per personalizzare
ExposedDropdownMenu
. In particolare, i menu ora hanno un parametrofocusable
(valore predefinito:true
) che deve essere impostato sufalse
quando si utilizzano campi di testo modificabili. (I4184c, b/323694447, b/278609042).
Modifiche alle API
- Il flag
ScaffoldSubcomposeInMeasureFix
è stato rimosso. (Ie2a4b) NavigationRailItemColors
è ora contrassegnato come@Immutable
. (If6112, b/327660613)NavigationBarItemColors
è ora contrassegnato come@Immutable
. (I42a30, b/298064514).- Riordina i parametri nel componibile Traccia di scorrimento. (I9f315).
ExposedDropdownMenu
è ora implementato utilizzandoPopup
. Il comportamento dovrebbe essere lo stesso, ad eccezione del fatto che i menu attivabili con campi di testo modificabili possono essere ignorati durante la digitazione sulla tastiera.
Correzioni di bug
- I ruoli di base dei container Superficie e Superficie sono stati leggermente modificati, fornendo una maggiore tonalità nei temi chiari e scuri. (I677a5)
- Sono stati aggiornati i colori del dispositivo di scorrimento e di
ProgressIndicator
per rispettare le nuove specifiche di contrasto per i contenuti non testuali. (I26807) - Aggiorna l'overlay dello stato di messa a fuoco impostandolo su 0,1f per garantire un contrasto di colore sufficiente. (I7ea77)
- Piccole modifiche ai valori predefiniti dei colori di superficie e sfondo in
lightColorScheme
edarkColorScheme
. (I9db52)
Versione 1.3.0-alpha02
6 marzo 2024
androidx.compose.material3:material3-*:1.3.0-alpha02
viene rilasciato. La versione 1.3.0-alpha02 contiene questi commit.
Modifiche alle API
- Rendo stabili gli stati del dispositivo di scorrimento. Stiamo di nuovo in cambio di un valore per
State.onValueChangeFinished
. Aggregazione dionValueChangeFinished
in unrememberUpdatedState
. (I82ab2, b/322269951). - I componenti di navigazione ora utilizzano i nuovi ruoli
SurfaceContainer
.DrawerDefaults
ora fornisce attributistandardContainerColor
emodalContainerColor
distinti.DrawerDefaults.ModalDrawerElevation
ora è0.dp
. (I7fbac) - Rimozione di
@Stable
dagli stati diSlider
in quanto stiamo modificandostate.onValueChangeFinished
invar
. (Ied34a, b/322269951). - La specifica dell'animazione
ModalBottomSheet
eStandardBottomSheet
è ora unTweenSpec
, aggiornata rispetto a un'animazione primaverile. Questo risolve il problema di un superamento visibile. I costruttoriSheetState
deprecati senza densità sono stati rimossi. (I7babc, b/285847707)
Correzioni di bug
SurfaceContainer
varianti sono ora utilizzate dai componenti. I componenti che calcolano formalmente il colore con Surface eTonalElevation
ora utilizzano i ruoliSurfaceContainer
per impostazione predefinita, che non sono interessati dall'elevazione tonale. (b/304584161)- È stato corretto il bug per cui il colore del contenitore disattivato e deselezionato di
ElevatedFilterChip
era nero. (I400e6, b/322407043). - Correggi l'indicatore di avanzamento indeterminato quando l'avanzamento è pari a 0 (Id6582)
- Risolto il problema con
Slider
eRangeSlider
su layout RTL (Iab0e1) - Aggiunta di
SliderRangeTolerance
per il calcolo dell'intervallo del cursore poiché l'arrotondamento in virgola mobile può non essere preciso. (Ic918a, b/324934900). - Assicurati che l'
DatePickerDialog
mostri i suoi pulsanti durante la nidificazione di unDateRangePicker
o quando si visualizza qualsiasi tipo di selettore della data su schermi piccoli con caratteri più grandi. (Ie4758, b/325107799, b/277768544) Menu
ora utilizza il ruoloSurfaceContainer
per il colore del contenitore.MenuDefaults.TonalElevation
ora è0.dp
. (I135b7)TextField
ora utilizza il ruoloSurfaceContainerHighest
per il colore del contenitore. (I4dced)- I chip con livelli elevati ora sfruttano il ruolo
SurfaceContainerLow
(I7cd2f) - Il colore del contenitore
DatePicker
ora èSurfaceContainerHigh
.DatePickerDefaults.TonalElevation
ora è0.dp
. (Ida753) - Aggiorna il colore del contenitore Fogli in basso e trascina il colore dell'handle. (I72a0a).
- Il colore del contenitore
RichTooltip
ora èSurfaceContainer
. (Ia8b45). - Il colore del contenitore
SearchBar
ora èSurfaceContainerHighest
.SearchBarDefaults.TonalElevation
ora è0.dp
. (I88604) - Opzione Aggiornamenti disattivata e tracce/icone deselezionate per utilizzare il ruolo colore
SurfaceContainerHighest
. (I7687a) - Il colore del contenitore
AlertDialog
ora èSurfaceContainerHigh
. (Ie0433) - Il colore del contenitore
BottomAppBar
ora èSurfaceContainer
. Il coloreTopAppBar
onScroll
ora èSurfaceContainer
. (I41630) - Il colore del contenitore
ElevatedCard
ora èSurfaceContainerLow
. Colore del contenitore diFilledCard
:SurfaceContainerHighest
. (I35141) - Il colore del contenitore
ElevatedButton
ora èSurfaceContainerLow
. Gli attributiFilledIconButton
deselezionati ora hanno il colore del contenitoreSurfaceContainerHighest
. (I792c9) - Aggiorna il ruolo del colore del contenitore
TimePicker
e del colore del quadrante orologio aSurfaceContainerHighest
. (I43b93)
Versione 1.3.0-alpha01
21 febbraio 2024
androidx.compose.material3:material3-*:1.3.0-alpha01
viene rilasciato. La versione 1.3.0-alpha01 contiene questi commit.
Nuove funzionalità
- Aggiorna Compose M3
ModalBottomSheet
per supportare il Indietro predittivo su U+ (Iccf32, b/281967264, b/304850357) - Aggiornamento di Compose M3
SearchBar
per supportare il Indietro predittivo su U+ (I657f8) - È stato aggiornato il dispositivo di scorrimento per migliorare l'accessibilità mediante l'aggiunta di un indicatore di intervallo e di interruzione. (I3058e).
- Aggiornamento di
ProgressIndicator
aggiornato per migliorare l'accessibilità con l'aggiunta di un indicatore di intervallo e di interruzione. (I21451) - Aggiungendo un cursore predefinito per una descrizione comando avanzata, la nuova API dettagliata della descrizione comando ora consente di tracciare il cursore personalizzato per l'ancoraggio
LayoutCoordinates
. (Ifd42c)
Modifiche del comportamento
- È stata eseguita la migrazione dei componenti del materiale per utilizzare le nuove API Ripple, in modo da non eseguire più query su
RippleTheme
.
Modifiche alle API
- Il divertimento
drawStopIndicator
ora è pubblico. (I3f59f) - Contrassegna la funzione
formatWithSkeleton
diDatePicker
come interna (Ic65dc) DropdownMenu
ora supporta colore, forma, elevazione e bordo personalizzati. (I8e981, b/289554448, b/301887035, b/283654243)- I componenti Material3 che mostrano un valore
MutableInteractionSource
nell'API sono stati aggiornati in modo da ora esporre un valoreMutableInteractionSource
con valore null che per impostazione predefinita ènull
. Non ci sono modifiche semantiche qui: passare un valore null significa che non vuoi istruireMutableInteractionSource
, che verrà creato all'interno del componente, se necessario. La modifica a null consente ad alcuni componenti di non allocare mai unMutableInteractionSource
e ad altri componenti di creare un'istanza solo quando necessario, il che migliora le prestazioni di questi componenti. Se non stai utilizzando ilMutableInteractionSource
passato a questi componenti, si consiglia di passare il valore null. Ti consigliamo inoltre di apportare modifiche simili ai tuoi componenti. (I41abb, b/298048146) - Aggiunge
RippleConfiguration
eLocalRippleConfiguration
per consentire la personalizzazione degli echi utilizzando valori fissi per componente / sottoalbero. Ad esempio, per cambiare il colore di un componente che non è sotto il tuo controllo o per disattivare un'eco per un componente. Nella maggior parte dei casi, devono essere utilizzati i valori predefiniti: queste API rappresentano un'alternativa per la personalizzazione di singoli componenti / sottoalbero limitati. Per modifiche più ampie e sistemi di progettazione personalizzati, dovresti invece creare la tua ondata utilizzandocreateRippleModifierNode
. (I7b5d6, b/298048146). - Aggiunge una nuova API Ripple in material3, che sostituisce la versione deprecata
rememberRipple
. Viene inoltre aggiunto un valoreCompositionLocal
temporaneo,LocalUseFallbackRippleImplementation
, per ripristinare i componenti material3 all'utilizzo delle APIrememberRipple
/RippleTheme
ritirate. Verrà rimosso nella prossima release stabile ed è destinato a essere un ausilio temporaneo alla migrazione solo nei casi in cui fornisci unRippleTheme
personalizzato. (I34cbc, b/298048146).
Correzioni di bug
- Rimossa la sottocomposizione all'interno di
ModalBottomSheet
per migliorare le prestazioni. Risolto il problema per cuiModalBottomSheet
potrebbe arrestarsi in modo anomalo in scenari specifici in combinazione conLookaheadScope
. (I2a198). - Rimossa la sottocomposizione all'interno di
BottomSheetScaffold
per migliorare le prestazioni. Risolto il problema per cuiBottomSheetScaffold
si arrestava in modo anomalo in scenari specifici in combinazione conLookaheadScope
. (Ie6401) - L'allineamento del badge viene regolato per essere più vicino al centro dei contenuti dell'ancoraggio rispetto all'angolo in alto a destra. (I18a28).
- Risolvi un problema di accessibilità relativo al
DateRangePicker
per cui il titolo testuale dell'anno precedente è stato trasmesso come utilizzabile dagli utenti dello screen reader, di Switch Access e di Voice Access. (I2ac55). - È stato corretto il bug relativo all'ordine dei parametri di
mediumTopAppBarColors
. (Ibe64a).
Versione 1.2
Versione 1.2.1
6 marzo 2024
androidx.compose.material3:material3-*:1.2.1
viene rilasciato. La versione 1.2.1 contiene questi commit.
Correzioni di bug
- Ripristina di nuovo gli stati del dispositivo di scorrimento. Stiamo di nuovo in cambio di un valore per
State.onValueChangeFinished
. Aggregazione dionValueChangeFinished
in unrememberUpdatedState
. (Ie8fd0, b/322269951). - Rimozione di
@Stable
dagli stati diSlider
in quanto stiamo modificandostate.onValueChangeFinished
invar
. (I82ba1, b/322269951). - Correggi i
NavigationBar
colori personalizzati per copiare i valori predefiniti. (80a779, b/326894020) - Correggi la regressione in
ExposedDropdownMenu
per renderla di nuovo attivabile (3fcec1, b/323694447) - Risolvere il problema di memorizzazione nella cache del colore del pulsante (3e5bbcb/327371655)
Versione 1.2.0
7 febbraio 2024
androidx.compose.material3:material3-*:1.2.0
viene rilasciato. La versione 1.2.0 contiene questi commit.
Problema noto
- In
PrimaryTabRow
è stato introdotto un bug di rendering dell'interoperabilità di View-Compose nell'ambito di una modifica al miglioramento delle prestazioni. La soluzione alternativa è utilizzareTabRow
conTabRowDefaults.PrimaryIndicator
Modifiche importanti dalla versione 1.1.0
Nuovi componenti di Material Design 3
- Tira per aggiornare.
- Pulsante segmentato
Miglioramenti ai componenti esistenti di Material Design 3.
- Barra dell'app in basso (allineamento RTL, nascondi automaticamente allo scorrimento)
- Aggiornamento della visualizzazione delle schede
- Badge (aggiornamento allineamento)
È stata promossa la versione stabile delle API sperimentali.
Miglioramenti delle prestazioni
- Consulta questo post del blog per ulteriori dettagli.
Versione 1.2.0-rc01
24 gennaio 2024
androidx.compose.material3:material3-*:1.2.0-rc01
viene rilasciato. La versione 1.2.0-rc01 contiene questi commit.
Correzioni di bug
- È stato corretto il bug relativo all'ordine dei parametri di
mediumTopAppBarColors
. (Ibe64a). - È stato corretto un bug introdotto in
1.2.0-beta02
inCardDefaults.cardColors
che non aggiornavacontentColor
in base al valore del parametrocontainerColor
. (Iee041, b/319671246). - Risolto un bug in
disabledContentColor
introdotto in1.2.0-beta02
e aggiunta una piccola ottimizzazione. (I6dda1, b/318428829).
Versione 1.2.0-beta02
10 gennaio 2024
androidx.compose.material3:material3-*:1.2.0-beta02
viene rilasciato. La versione 1.2.0-beta02 contiene questi commit.
Bug noto
- Per impostazione predefinita, un bug in
IconButtonColors
assegneràdisabledContentColor
a una versione alpha (0.38f) diLocalContentColor
anziché all'elementocontentColor
specificato dall'utente. La soluzione alternativa consiste nell'impostare esplicitamentedisabledContentColor
. Questo problema verrà risolto nella prossima release.
Modifiche alle API
- È stata aggiunta la possibilità di abilitare i cursori della descrizione comando per le API
Tooltip
normali. (Ibf767) SwipeToDismissState
,rememberSwipeToDismiss
eSwipeToDismissValue
sono stati tutti rinominati per avere_SwipeToDismissBox_
. (I68d6d).
Correzioni di bug
- Corretto il valore di spaziatura interna finale di
ListItem
per allinearlo alle specifiche (Ibd68b, b/305342674). - Il colore dei contorni per la scheda con contorni ora è mappato correttamente a
OutlineVariant
. (I75480, b/310979715) - Il colore dinamico ora viene estratto dai ruoli colore definiti dal sistema. Questo migliora il contrasto per i contenuti accessibili e allinea più fedelmente il colore dinamico alle specifiche del materiale. (I1de96)
- È stata corretta la gestione dell'indietro di
ModalBottomSheet
su Android T/13 e versioni successive quandoandroid:enableOnBackInvokedCallback="true"
. (I728dc, b/306196110)
Versione 1.2.0-beta01
13 dicembre 2023
androidx.compose.material3:material3-*:1.2.0-beta01
viene rilasciato. La versione 1.2.0-beta01 contiene questi commit.
Modifiche alle API
- Contrassegna
TabIndicatorScope
come sperimentale. (I45c88) - Rimozione delle API sperimentali deprecate per la descrizione comando. (I438cb)
- Modifica i nuovi sovraccarichi di
TabRow
in modo che non vengano utilizzate sottocomposizioni. Questo si traduce in un modo diverso di creare gli indicatoriTabRow
con i modificatori personalizzati forniti. (Ife741) - Ritira le API
DismissDirection
eDismissValue
. Questi valori sono stati uniti aSwipeToDismissValue
, i cui valori indicano sia la posizione che la direzione diSwipeToDismissBox
.DismissState.progress
ora è contrassegnato comeFloatRange
tra0.0
e1.0
.DismissState
di contenuti modifici e costruttori deprecati sono stati rimossi. Il componente, lo stato e l'oggetto predefinito diSwipeToDismiss
sono stati contrassegnati come sperimentali. (Ib54f2).
Correzioni di bug
- L'indicatore predefinito per
PullToRefresh
ora è una punta di freccia aperta anziché un triangolo pieno. (I67be3)
Versione 1.2.0-alpha12
29 novembre 2023
androidx.compose.material3:material3-*:1.2.0-alpha12
viene rilasciato. La versione 1.2.0-alpha12 contiene questi commit.
Modifiche alle API
RangeSlider
ora prende un intervallo Kotlin (ad es.0f..1f
) anziché una classe di valoreFloatRange
personalizzata.SnapFlingBehavior.kt
ora utilizza anche un intervallo Kotlin. (I025cb)- Contrassegna le funzioni di fabbrica di Modificatore come
@Stable
. (Ib109f)
Versione 1.2.0-alpha11
15 novembre 2023
androidx.compose.material3:material3-*:1.2.0-alpha11
viene rilasciato. La versione 1.2.0-alpha11 contiene questi commit.
Nuove funzionalità
- Implementa
PullToRefreshContainer
ePullToRefreshState
, che insieme forniscono un'implementazione pull per aggiornare in Material3. (I16456, b/261760718)
Modifiche alle API
- Contrassegna
SwipeToDismissBox
DismissDirection
eDismissValue
come sperimentali. (I517b0) - Rinomina
SwipeToDismiss
inSwipeToDismissBox
. Rinominabackground
inbackgroundContent
edismissContent
incontent
lambda finale. (I7f4d3). - Rendi pubblico il costruttore di
ChipElevation
eSelectableChipElevation
. (Ie0c48, b/308432421). - Aggiunta di
ModalBottomSheetProperties
in corso... Spostamento disecurePolicy
inModalBottomSheetProperties
in corso... Aggiunta diisFocusable
eshouldDismissOnBackPress
aModalBottomSheetProperties
in corso... Questi nuovi valori booleani aiutano a determinare in che modo il riquadro inferiore modale deve gestire gli eventi IME. (Iea56f, b/278216859). - Sono stati aggiornati gli stati
RangeSlider
eSlider
per rimuovereinitialOnValueChange
, i prefissi iniziali e i file kdocs appropriati. (I57d30). - Depreca la classe
ChipBorder
e le chiamate di funzione associate. È consigliabile utilizzare direttamenteBorderStroke
. (I89cc2) - Le API della descrizione comando di base ora sono
@ExperimentalFoundationApi
. (I30b0b) TabRow
eScrollableTabRow
non sono più deprecati. Le nuove varianti principali e secondarie sono contrassegnate come sperimentali. (I0def6)- I chip di filtro e di input ora usano direttamente
BorderStroke
. (I07a8d) SegmentedButton
ora utilizza direttamenteBorderStroke
. (I89b9b)- La funzione generica
AlertDialog
è stata rinominata inBasicAlertDialog
e ritira la funzione precedente. (Idbe52) - Rinomina le API di
SwipeToDismiss
inSwipeDismiss
e promuovi le nuove APISwipeDismiss
alla versione stabile. (I14cbe). - Aggiunta di
tonalElevation
eshadowElevation
alle API della descrizione comando. Inoltre, è stato spostato di nuovo le APITooltipBox
,PlainTooltip
eRichTooltip
alla versione sperimentale poiché sono state rilasciate accidentalmente come stabili. (If0f66, b/293939035). - Promuovi le API con chip sperimentali alla versione stabile. (Iea2c3).
- È stata rimossa l'annotazione
@ExperimentalMaterial3Api
dalle schede cliccabili di Material3. (I88dbf)
Correzioni di bug
- Risolto il problema per cui
SwipeToDismiss
si arrestava in modo anomalo in determinati scenari con layout Lookahead e Lazy nidificati. (Ica8d1, b/297226562).
Versione 1.2.0-alpha10
18 ottobre 2023
androidx.compose.material3:material3-*:1.2.0-alpha10
viene rilasciato. La versione 1.2.0-alpha10 contiene questi commit.
Modifiche alle API
- Promozione di
Badge
eBadgedBox
alla versione stabile. (I67f16, b/261565132) - Aggiunta di
securePolicy
come parametro aModalBottomSheet
, in modo che gli utenti possano definire il comportamento perWindowManager.LayoutParams.FLAG_SECURE
. (Icdac8, b/296250262). - Sono stati aggiunti nuovi sovraccarichi di
LinearProgressIndicator
eCircularProgressIndicator
che richiedonoprogress
come lambda. Dovrebbero essere più efficaci rispetto alle versioni precedenti. (I824e6, b/295616656). - Rinomina
StandardSizeClasses
inAllSizeClasses
. (I8cb07) - Combina le funzioni di calcolo delle classi di dimensioni delle finestre. (Iad935)
Correzioni di bug
- Correggi un arresto anomalo
DatePicker
quando fai clic rapidamente sui pulsanti Freccia di navigazione quando il mese visualizzato è al limite dell'intervallo di anni consentito. (I46f36, b/290954897, b/297002119). - [Barra/barra di navigazione] Supporto del colore trasparente per l'indicatore. (Ie0a9b, b/267289987).
Versione 1.2.0-alpha09
4 ottobre 2023
androidx.compose.material3:material3-*:1.2.0-alpha09
viene rilasciato. La versione 1.2.0-alpha09 contiene questi commit.
Modifiche alle API
- È stata eseguita la migrazione di
ModalNavigationDrawer
eDismissibleNavigationDrawer
per l'utilizzo delle nuove APIAnchoredDraggable
. Il valoreanimateTo
diDrawerState
è stato sostituito dai metodi di apertura e chiusura e l'offset è ora esposto come valore in virgola mobile anziché come oggetto di stato. Puoi accedere all'offset direttamente tramitecurrentOffset
. (I0a72c). - Sono state aggiunte funzioni non compatibili per la creazione diretta di
DatePickerState
eDateRangePickerState
. Queste funzioni possono essere utilizzate in alternativa alle funzioni componibilirememberDatePickerState
erememberDateRangePickerState
quando necessario. (I70326, b/291524052) - L'elemento
TabRows
fisso e scorrevole ora ha varianti primarie e secondarie. Questi vengono mappati correttamente al colore e al comportamento degli indicatori come definito in Material3. PrimaryScrollableTabRow
eSecondaryScrollableTabRow
ora espongono lo stato di scorrimento. (Iec8f5, b/260572337)- Aggiunta di un nuovo parametro
sheetMaxWidth
che gli sviluppatori possono impostare per specificare la larghezza massima consentita per il foglio. Dp.Non specificato può essere trasmesso per il parametro se si desidera un foglio che copre l'intera larghezza dello schermo. (Ifb7c9, b/266697696). - Aggiunta delle API
PlainTooltipBox
eRichTooltipBox
come metodi ritirati. (I246fa)
Correzioni di bug
- Correggi un arresto anomalo quando
DatePicker
viene inizializzato con unaDatePickerFormatter
con determinati scheletri di date che rimangono invariati quando vengono convertiti in pattern di date (ad esempio YY). (I01f29)
Versione 1.2.0-alpha08
20 settembre 2023
androidx.compose.material3:material3-*:1.2.0-alpha08
viene rilasciato. La versione 1.2.0-alpha08 contiene questi commit.
Cambiamento che provoca un'interruzione del comportamento
ColorScheme
ora è immutabile, rendendo meno efficienti gli aggiornamenti dei singoli colori, rendendo più efficiente l'uso più comune dei colori. Il ragionamento alla base di questa modifica è che la maggior parte delle app non prevede l'aggiornamento dei singoli colori come caso d'uso principale. Questo è ancora possibile, ma si ricomporrà più di prima, a sua volta diminuiremo in modo significativo la quantità di abbonamenti statali attraverso tutto il codice Material e influenzerà i costi di inizializzazione e runtime di casi d'uso più standard. (Ic447d, b/297212873).- L'elevazione tonale non si anima più in diversi stati di interazione per corrispondere alla specifica. (Icdd12)
Modifiche alle API
- È stato aggiunto un nuovo
BottomAppBar
che utilizza come parametroBottomAppBarScrollBehavior
per nasconderlo automaticamente quando si scorre i contenuti. È stato aggiunto ancheFabPosition.EndOverlay
, consentendo al FAB di sovrapporre la barra dell'app in basso nell'impalcatura anziché essere ancorata al di sopra. (Iecb47) - È stato aggiunto un componente Etichetta semplice, basato su
BasicTooltipBox
, che non si chiude quando tocchi al di fuori dei limiti dell'etichetta. (I821f9)
Correzioni di bug
- È stato rimosso l'utilizzo di
rememberSaveable
per le descrizioni comando. (Icc131, b/299500338) - È stato introdotto un flag temporaneo per controllare se Scaffold deve misurare i figli durante la misurazione o il posizionamento. Per impostazione predefinita, viene utilizzata la misurazione. Se stai riscontrando problemi con il nuovo comportamento, segnala un problema. (I0b354)
- È stato corretto l'assetto orizzontale in
BottomSheet
utilizzando la misurazione corretta per la larghezza dello schermo del dispositivo. (I1df0c, b/299058752). - È stato corretto un bug per cui
ModalBottomSheet
non chiamavaonDismissedRequest
quando lo chiudeva scorrendo verso il basso sul foglio. (Idfdd8)
Versione 1.2.0-alpha07
6 settembre 2023
androidx.compose.material3:material3-*:1.2.0-alpha07
viene rilasciato. La versione 1.2.0-alpha07 contiene questi commit.
Nuove funzionalità
- Il supporto delle icone di mirroring automatico è stato aggiunto in
compose material 1.6.0-alpha05
. Consulta le note di rilascio per i dettagli sulle icone di mirroring automatico.
Modifiche alle API
SliderState
implementaDraggableState
(I9b116)- Modifica la forma in modo che sia un parametro obbligatorio. Rinomina
position
inindex
nella funzione helper forma. (I34941) - Aggiorna
DatePicker
formatWithSkeleton
in modo da includere una mappa utilizzata come cache per migliorare le prestazioni. (I3195f) - È stato aggiunto
BasicTooltipBox
acompose.foundation
e aggiornatoPlainTooltipBox
eRichTooltipBox
per l'utilizzo diTooltipBox
con i nuovi componenti componibiliPlainTooltip
eRichTooltip
. (I79e1d).
Correzioni di bug
dynamicLightColorScheme
edynamicDarkColorScheme
ora restituiscono colori con crominanza più elevata per i ruoli di superficie esurfaceContainer
. (I5e901).- Risolto il problema per cui alcuni componenti che utilizzano una sottocomposizione (ad esempio
BottomSheetScaffold
) all'interno di un'impalcatura all'interno di unLookaheadScope
cercavano di leggere le dimensioni troppo presto. (I297b4, I871f1, b/295536718)
Versione 1.2.0-alpha06
23 agosto 2023
androidx.compose.material3:material3-*:1.2.0-alpha06
viene rilasciato. La versione 1.2.0-alpha06 contiene questi commit.
Correzioni di bug
- È stato corretto il calcolo di
offset
diDropdownMenu
, in modo che gli offset x dipendano esclusivamente dalla direzione del layout locale e gli offset y non verranno più invertiti quando il menu si trova nella parte inferiore dello schermo. (ICC74, b/294103942) - È stato corretto il calcolo di
offset
diDropdownMenu
, in modo che gli offset x dipendano esclusivamente dalla direzione del layout locale e gli offset y non verranno più invertiti quando il menu si trova nella parte inferiore dello schermo. (Ib87a2, b/294103942).
Versione 1.2.0-alpha05
9 agosto 2023
androidx.compose.material3:material3-*:1.2.0-alpha05
viene rilasciato. La versione 1.2.0-alpha05 contiene questi commit.
Modifiche alle API
- Aggiornamenti alla casella di controllo e ai colori
TriStateCheckbox
. L'elementodisabledUncheckedColor
CheckboxDefaults.colors()
ora influisce solo sul bordo della casella di controllo. I casi speciali che richiedono di impostare il colore della casella interna quando disattivato e deselezionato richiedono un'istanza di unCheckboxColors
creata personalizzata con i valori di colore desiderati. (I77d17, b/291943198)
Versione 1.2.0-alpha04
26 luglio 2023
androidx.compose.material3:material3-*:1.2.0-alpha04
viene rilasciato. La versione 1.2.0-alpha04 contiene questi commit.
Nuove funzionalità
- API Sperimentale Segmented Button (Ifc8fb)
- I divisori ora hanno un parametro per controllare l'orientamento in modo da supportare i divisori verticali. (I4c899, b/288438593).
Modifiche alle API
- Stiamo spostando la dipendenza relativa alla densità al livello di componente. Questo vale per i seguenti componenti:
SwipeToDismiss
e componenti basati su Fogli. Utilizza il nuovo sovraccarico fornito dove la densità è un parametro. (I1846e). - Annotazioni aggiuntive per specificare gli input consentiti per i componibili (Ief234)
- Aggiungi un parametro icona al pulsante segmentato, dividi la semantica in modo che i pulsanti segmentati possano essere selezionati per implementare la selezione singola e attivabili per implementare la selezione multipla, rispettivamente con
SelectableSegmentedButtonRow
eToggelableSegmentedButtonRow
. (I38740) - Divisore è stato rinominato in
HorizontalDivider
. FunzionalitàVerticalDivider
aggiunta. (I5975c) - Modifica l'utilizzo di
ClosedFloatingPointRange
per il peso più leggeroFloatRange
nelle API Material3 sperimentali per ridurre al minimo l'autoboxing. (I4aab5). - Aggiunto nuovo allineamento Inizio per
FabPosition
(Ib7aea, b/170592777)
Correzioni di bug
ModalBottomSheet
rispetta la direzione del layout locale. (Ib4f44, b/285628622).
Versione 1.2.0-alpha03
21 giu 2023
androidx.compose.material3:material3-*:1.2.0-alpha03
viene rilasciato. La versione 1.2.0-alpha03 contiene questi commit.
Modifiche del comportamento
includeFontPadding
ora èfalse
per impostazione predefinita nella tipografia Material 3. Anche lo stile predefinito dell'altezza della riga è stato modificato inTrim.None
eAlignment.Center
e il campolineHeight
esplicito (in sp) è stato aggiunto aiTextStyle
diTypography
. Se vuoi personalizzare questi valori, consulta la documentazione relativa all'API e consulta il post del blog per una spiegazione approfondita di queste modifiche. (I6266f, Icabc3)
Nuove funzionalità
- È stato aggiunto un sovraccarico per
RangeSlider
che è una versione stateful del componente. È stato creato un elementoRangeSliderState
che contiene tutte le informazioni per il canale attivo corrente, le misurazioni dei componenti delRangeSlider
e la logica di trascinamento e gesto. (I8c270) - La barra di ricerca ora supporta le ombre tramite il parametro
shadowElevation
appena aggiunto. (Ia5369, b/271040353) - Ora
ColorScheme
supporta nuoviSurfaceContainer
ruoli. - Ora è possibile disattivare l'overlay in elevazione tonale della superficie con la composizione
LocalTonalElevationEnabled
locale. (Ic203c, b/277774590).
Modifiche alle API
- Apri i costruttori dei colori dei componenti. (I8c4a6)
- Aggiunta del parametro attivabile a entrambe le API della descrizione comando, in modo che gli sviluppatori possano utilizzare o meno gli eventi touch nella descrizione comando. Fai attenzione, perché questo potrebbe interrompere l'attraversamento automatico del focus sull'accessibilità. (Ie32d8).
- Accessibilità ottimizzata per le prestazioni e le allocazioni della memoria. (Iede48).
- Esponi
DefaultSizeClasses
e creaStandardSizeClasses
perWindowSizeClasses
(I91838) - modifica
WindowWidth/HeightSizeClass
in classi di valori in virgola mobile (Ie686e)
Correzioni di bug
- Il parametro
contentWindowInsets
dell'impalcatura ora rispetta gli insiemi delle finestre consumate. Tieni presente che il comportamento della spaziatura interna dei contenuti in base ai parametritopBar
ebottomBar
rimane invariato quando vengono forniti questi parametri. (I08b73, b/264601542). - Correggi l'allineamento della barra dell'app in alto al centro per assicurarti che un titolo lungo non venga visualizzato sopra le icone delle azioni o di navigazione. (I4369f, b/236994621)
- Le posizioni delle schede ora applicano una larghezza minima dei contenuti di 24, dp. In questo modo viene fornito un touch target accessibile per gli indicatori delle schede. (Id8861)
- Le tavolozze dei colori dinamiche di
dynamicLightColorScheme
edynamicDarkColorScheme
ora supportano nuovi ruoli delle superfici. (I1252e). - Aggiornamento dell'allineamento delle notifiche del badge in modo che non sia possibile clip in caso di collisione con il bisnonno. (Idf75a)
Versione 1.2.0-alpha02
24 maggio 2023
androidx.compose.material3:material3-*:1.2.0-alpha02
viene rilasciato. La versione 1.2.0-alpha02 contiene questi commit.
Modifiche alle API
- Aggiungi parametro degli insiemi delle finestre a
ModalBottomSheet
.- Ora è possibile che lo scrim per
ModalBottomSheet
venga tracciato dietro la barra di stato conwindowInsets
impostato su zero - La funzionalità predefinita di
ModalBottomSheet
è stata aggiornata per non superare le barre di sistema, inclusa la navigazione - La gestione dei riquadri della barra di stato è fornita tramite l'handle di trascinamento in modalità edge-to-edge.
BottomSheetDefaults
include i riquadri di finestre perBottomSheetWindow
. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/126548b/26548)
- Ora è possibile che lo scrim per
- Depreca
Indicator
e aggiungiPrimary
/SecondaryIndicator
in modo che corrisponda alle specifiche M3.PrimaryIndicator
corrisponde alla larghezza dei contenuti della scheda, mentreSecondaryIndicator
copre l'intera larghezza disponibile.SecondaryIndicator
è equivalente all'ora deprecataIndicator
e può essere una sostituzione diretta. (I27604) - È stata aggiunta un'opzione per passare in un
ScrollState
durante la creazione di unDropdownMenu
o di unExposedDropdownMenu
per controllare lo stato di scorrimento verticale delle voci di menu visualizzate. (Ia0734, b/185304441) - È stato aggiunto un sovraccarico per
Slider
che è una versione stateful del componente. È stato creato un elementoSliderState
che contiene tutte le informazioni per il canale attivo corrente, le misurazioni dei componenti delSlider
e la logica di trascinamento e gesto. (I124a5). - Ridenominazione della proprietà semantica
isContainer
inisTraversalGroup
(I121f6) - È stato aggiunto l'elemento
TextStyle.merge(...)
ottimizzato con l'elenco completo dei parametri. (Iad234, b/246961787). - Le interfacce pubbliche
TooltipState
,RichTooltipState
ePlainTooltipState
sono state realizzate. AggiuntiRichTooltipStateImpl
ePlainTooltipStateImpl
per gli stati predefiniti. Sono state aggiunte le funzioniremember*State
per ottenere gli stati di implementazione.TooltipSync
rimosso a favore di unTooltipDefault.GlobalMutatorMutex
. (I7813d) - È stato aggiornato
DatePickerColors
per includere ulteriori opzioni di personalizzazione per i colori dei campi di selezione della data, navigazione e campi di immissione testo. (I1a685, b/274626815). DatePickerState
eDateRangePickerState
sono ora interfacce pubbliche con implementazioni predefinite che possono essere recuperate darememberDatePickerState
erememberDateRangePickerState
. (I71c52).- È stato rimosso il campo
dateValidator
daDatePicker
eDateRangePicker
e è stata introdotta un'interfacciaSelectableDates
che può essere impostata sullo stato per controllare quali date o anni sono selezionabili nell'interfaccia utente. (Ic2fc6) TimePicker
rimossa dall'API stabile; sono previste ulteriori modifiche nell'API di stato (I3f39a)ModalBottomSheet
spostato solo su Android. L'utilizzo diModalBottomSheet
non è consigliato per l'uso su computer e la sua funzionalità non è mantenuta attivamente. (Ib3778)
Correzioni di bug
- È stato corretto l'azione di chiusura di
AlertDialog
che veniva visualizzata sotto l'azione di conferma quando le azioni erano sovrapposte per adattarsi alla larghezza della finestra di dialogo. Questa correzione allinea l'implementazione alla specifica di Material Design (I029de, b/235454277). - È stato corretto il bug in
ListItem
relativo all'utilizzo della spaziatura interna non corretta per gli elementi a tre righe. (I6e235). - Ora
ModalBottomSheet
può visualizzare la tastiera IME (Idc508, b/262140644, b/268380384, b/272483584)
Versione 1.2.0-alpha01
10 maggio 2023
androidx.compose.material3:material3:1.2.0-alpha01
e androidx.compose.material3:material3-window-size-class:1.2.0-alpha01
vengono rilasciati. La versione 1.2.0-alpha01 contiene questi commit.
Versione 1.1
Versione 1.1.2
20 settembre 2023
androidx.compose.material3:material3:1.1.2
e androidx.compose.material3:material3-window-size-class:1.1.2
vengono rilasciati. La versione 1.1.2 contiene questi commit.
Correzioni di bug
- È stato corretto il passaggio errato del modificatore a due componibili. (b/282761472)
- La correzione
TimePickerState
restituisce ore errate quando viene inizializzata con 23 ore. (b/278242122) - Lo stato iniziale di attivazione/disattivazione per la convalida a mezzogiorno e minuti è stato corretto. (b/269768197, b/282790635)
- Risolto il problema di
state.hour
che restituiva un valore errato per le 23.00. (b/282761472, b/278242122)
Versione 1.1.1
21 giu 2023
androidx.compose.material3:material3:1.1.1
e androidx.compose.material3:material3-window-size-class:1.1.1
vengono rilasciati. La versione 1.1.1 contiene questi commit.
Correzioni di bug
- Aggiunge una chiamata per
ModalBottomSheet
senza il parametrowindowInset
per la compatibilità binaria. (Ib7959) - Aggiungi parametro degli insiemi delle finestre a
ModalBottomSheet
.- Ora è possibile che lo scrim per
ModalBottomSheet
venga tracciato dietro la barra di stato conwindowInsets
impostato su zero - La funzionalità predefinita di
ModalBottomSheet
è stata aggiornata per non superare le barre di sistema, inclusa la navigazione - La gestione dei riquadri della barra di stato è fornita tramite l'handle di trascinamento in modalità edge-to-edge.
BottomSheetDefaults
include i riquadri di finestre perBottomSheetWindow
. (I31200, b/274872542, b/272973615, b/272334475, b/268432129, b/275849044, b/126548b/26548)
- Ora è possibile che lo scrim per
Versione 1.1.0
10 maggio 2023
androidx.compose.material3:material3:1.1.0
e androidx.compose.material3:material3-window-size-class:1.1.0
vengono rilasciati. La versione 1.1.0 contiene questi commit.
Funzionalità principali della versione 1.1.0
Nuovi componenti di Material Design 3
- Fogli inferiori
- Selettori della data
- Ricerca
- Scorri per ignorare
- Selettori dell'ora
- Suggerimenti per gli strumenti
Miglioramenti ai componenti esistenti di Material Design 3.
È stata promossa la versione stabile delle API sperimentali.
Leggi questo post del blog per maggiori dettagli.
Versione 1.1.0-rc01
19 aprile 2023
androidx.compose.material3:material3:1.1.0-rc01
e androidx.compose.material3:material3-window-size-class:1.1.0-rc01
vengono rilasciati. La versione 1.1.0-rc01 contiene questi commit.
Modifiche alle API
TimePicker
rimossa dall'API stabile; sono previste ulteriori modifiche nell'API di stato (I3f39a)ModalBottomSheet
spostato solo su Android. L'utilizzo diModalBottomSheet
non è consigliato per l'uso su computer e la sua funzionalità non è mantenuta attivamente. (Ib3778)
Versione 1.1.0-beta02
5 aprile 2023
androidx.compose.material3:material3:1.1.0-beta02
e androidx.compose.material3:material3-window-size-class:1.1.0-beta02
vengono rilasciati. La versione 1.1.0-beta02 contiene questi commit.
Modifiche alle API
- Ora
SheetState
ha un parametro facoltativoskipHiddenState
- Ora
rememberStandardBottomSheetState
ha un parametro facoltativoskipHiddenState
BottomSheetScaffold
ora ha un ancoraggio nascosto definito, anche se è disattivato per impostazione predefinita.- La documentazione di
SheetState.requireOffset
è stata aggiornata BottomSheetDefaults.MinimizedShape
è stato rinominato comeBottomSheetDefaults.HiddenShape
(I839f4, b/273870234)
Correzioni di bug
- Non cambiare il quadrante da ora a minuto quando è attiva l'esplorazione al tocco. (I717d0)
- La semantica dell'handle di trascinamento
ModalBottomSheet
eBottomSheetScaffold
è ora unita. (I05afb). - Il modificatore
BottomSheetScaffold
, i parametricontainerColor
econtentColor
ora interessano solo i contenuti. (I992cb) BottomSheetScaffold nestedScroll
per i contenuti del foglio ora implementa le scorrimenti. (I992cb)
Versione 1.1.0-beta01
22 marzo 2023
androidx.compose.material3:material3:1.1.0-beta01
e androidx.compose.material3:material3-window-size-class:1.1.0-beta01
vengono rilasciati. La versione 1.1.0-beta01 contiene questi commit.
Modifiche alle API
- Aggiungi il parametro del tipo di layout a
TimePicker
componibile. Consente di utilizzare layout diversi, a seconda della configurazione dello schermo (Ia0e16) SearchBarDefaults
è stato contrassegnato come sperimentale. (I65561)- Elevazione ombra aggiunta a
BottomSheetScaffold
(I94e0f) - Aggiunto il supporto per la visualizzazione dei selettori della data senza la parte dell'intestazione. Modifiche all'API per consentire il passaggio di un titolo con valore null durante la creazione di un selettore della data. Ora puoi trasmettere titolo, titolo e
showToggleMode = false
null per visualizzare un selettore headless. (Id3f3a, b/266132421, b/267194809).
Correzioni di bug
- Le barre di ricerca ora eliminano automaticamente lo stato attivo quando non sono attive. (I22a7c, b/261444487).
- È stato aggiornato
DateRangePicker
per consentire la selezione di un intervallo con la stessa data di inizio e fine. (I16529, b/272882497) - I campi di testo ora posizionano correttamente gli elementi di testo quando le dimensioni dei caratteri sono inferiori a quanto previsto. Questo potrebbe comportare la modifica di alcuni pixel nelle app in base alle impostazioni dei caratteri e allo script. (I8b8d0)
- Le azioni semantiche nel riquadro inferiore ora hanno etichette. (I277b0)
Versione 1.1.0-alpha08
8 marzo 2023
androidx.compose.material3:material3:1.1.0-alpha08
e androidx.compose.material3:material3-window-size-class:1.1.0-alpha08
vengono rilasciati. La versione 1.1.0-alpha08 contiene questi commit.
Nuove funzionalità
- Aggiunto il supporto per
BottomSheetScaffold
eBottomSheetScaffoldState
. (I063d4)
Modifiche alle API
- È stata aggiunta una funzionalità a
DatePickerState
e aDateRangePickerState
per consentire l'impostazione delle date dopo la creazione iniziale dello stato, nonché la reimpostazione delle selezioni impostando timestamp nulli. L'impostazione manuale delle date deve essere eseguita con cautela e la nuova funzionesetSelection
genererà un'eccezione nel caso in cui una data specificata non soddisfi la condizione preliminare (vedi la documentazione). (Ifa645, b/268609314, b/270427389). - Rinomina il campo
SheetValue
compresso inPartiallyExpanded
per rappresentare in modo più accurato e flessibile il comportamento in questo stato. (Ia1491) - I nomi dei parametri
ListItem
sono stati aggiornati in _content anziché in _text. I getter predefiniti sono oraReadOnlyComposables
, laddove pertinenti. (I69a25) - Passa dalle API sperimentali alle API Surface interattive. (I90d59, b/261561812).
Correzioni di bug
- Risolto il problema per cui lo stato
HalfExpanded
diModalBottomSheet
veniva calcolato in modo errato e il foglio sembrava essere mobile. (I45e84, b/268411386). - Aggiungi un controllo di
confirmValueChange
per limitare il tocco perModalBottomSheet
. (I2311a, b/270425759) - Sposta le azioni
BottomSheet
semantiche per trascinare l'handle. (I158ba). - Ora
ModalBottomSheet
comanda lo stato attivo all'avvio e gestisce il pulsante Indietro. (I4d2ab). - Ora viene gestito anche
ModalBottomSheet onDismissRequest
durante le scorrimenti nidificati. (I655c5, b/268433166).
Versione 1.1.0-alpha07
22 febbraio 2023
androidx.compose.material3:material3:1.1.0-alpha07
e androidx.compose.material3:material3-window-size-class:1.1.0-alpha07
vengono rilasciati. La versione 1.1.0-alpha07 contiene questi commit.
Nuove funzionalità
- Aggiungi un componibile Time Input che funzioni con
rememberTimePickerState()
, che segue la specifica M3 per l'input del tempo (Ia4fab) - È stata aggiunta un'API
DateRangePicker
Material 3 per selezionare un intervallo di date. (I7a6c3, b/267194809). - È stato aggiunto il supporto della modalità di immissione Material 3 per la selezione degli intervalli di date tramite l'API
DateRangePicker
. (Ifdbc4) - I colori dei campi di testo ora consentono di personalizzare:
- I colori del campo di immissione e del testo segnaposto in base allo stato attivo e allo stato di errore. Il parametro
textColor
è stato rinominato inunfocusedTextColor
eplaceholderColor
è stato rinominato inunfocusedPlaceholderColor
. - Il colore del contenitore per i campi di testo compilati in base allo stato di errore con il nuovo parametro
errorContainerColor
.
- I colori del campo di immissione e del testo segnaposto in base allo stato attivo e allo stato di errore. Il parametro
- I colori dei campi di testo del menu a discesa esposti sono stati aggiornati con parametri per supportare la nuova API per prefisso e suffisso. (I9c8b4, b/254284181, b/264766350).
Modifiche alle API
- Ripristino di alcune versioni dell'API Slider e rimozione degli sovraccarichi ridondanti di Slider coperti dalla nuova versione sperimentale di Slider con miniatura e tracciamento personalizzati. Promozione della stabilità di
RangeSlider
. (Ie8fbd). defaultElevation
rinominata inelevation
nelle funzioni di elevazione del chip. (I0f872)- Le seguenti API dei campi di testo Material 3 non sono più sperimentali:
TextField
,OutlinedTextField
,textFieldWithLabelPadding
,textFieldWithoutLabelPadding
,outlinedTextFieldPadding
. (Ieb5c0, b/261561819). TimePickers
is24Hour
utilizza l'impostazione di sistema (I18856)- Rimossa annotazione sperimentale dall'API scaffold. (Ibb51e, b/261565765, b/261436953).
Correzioni di bug
- La forma predefinita di
ModalBottomSheet
ora è sempreSheetDefaults.ExpandedShape
. (I0dfca) - Miglioramenti all'accessibilità per Material 3
DatePicker
eDateRangePicker
. (I5087e). - Correggere il bug per cui il vincolo di altezza massima viene propagato e potrebbe arrestarsi in modo anomalo. (I30d8c).
- Rimosso i ruoli semantici dalle superfici cliccabili e selezionabili e i componenti aggiornati che li utilizzavano per impostare i ruoli utilizzando modificatore.semantics (I793d9)
Versione 1.1.0-alpha06
8 febbraio 2023
androidx.compose.material3:material3:1.1.0-alpha06
e androidx.compose.material3:material3-window-size-class:1.1.0-alpha06
vengono rilasciati. La versione 1.1.0-alpha06 contiene questi commit.
Nuove funzionalità
- I campi di testo ora supportano il testo del prefisso e del suffisso (Ia8578, b/179884561)
- È stata aggiunta una funzione
TimePicker
per mostrare un selettore di ora che segue la specifica di Material 3, utilizzata insieme aTimePickerState
e al metodo di convenienzarememberTimePickerState
(I71910) - L'inserimento della data è ora una modalità di visualizzazione a
DatePicker
. Aggiunto il supporto per il passaggio tra le modalità di selezione della data e di immissione della data. (Ieeff7) - API aggiunta per
RichTextTooltips
. (I58ef3) - Implementazione del riquadro inferiore modale per il Material 3, inclusi
ModalBottomSheet
eModalBottomSheetDefaults
. Introduce ancheSheetState
erememberSheetState
che possono essere utilizzati per i futuri componenti del foglio. (I0853a, b/244189383).
Modifiche alle API
- Stabilizza l'API
showSnackbar
(I195c2, b/261424370) - Stabilizzare le API per il chip di assistenza e il chip di suggerimento (Ibb67b, b/261424370)
- Promuove l'API
ListItem
,ListItemDefaults
eListItemColors
alla versione non sperimentale (I7e7fa, b/261438882) - Promozione di
SliderPositions
,SliderDefaults.Thumb
eSliderDefaults.Track
alla versione stabile e aggiunta di APISlider
eRangeSlider
non sperimentali che contengono miniature e tracciamento personalizzati. Ritiro anche delle APISlider
eRangeSlider
precedenti. (Ie5ea6, b/261566890). - Rendi pubblica la risorsa
Modifier.tooltipAnchor()
, in modo che gli sviluppatori possano passarla all'ancoraggio per indicare che con la pressione prolungata dovrebbe essere visualizzata una descrizione comando. L'APIPlainTooltipBox
è stata aggiornata per non rendere più nulloTooltipState
e ora ha un valore predefinito. (Ie2fb7). ProgressIndicatorDefaults.circularTrackColor
è stato contrassegnato come@Composable
per coerenza. (Id29cc)- Getter della proprietà
LocalMinimuTouchTargetEnforcement
ripristinato, contrassegna la proprietà come deprecata e reindirizza aLocalMinimumInteractiveComponentEnforcement
. (I60dd5).
Versione 1.1.0-alpha05
26 gennaio 2023
androidx.compose.material3:material3:1.1.0-alpha05
e androidx.compose.material3:material3-window-size-class:1.1.0-alpha05
vengono rilasciati. La versione 1.1.0-alpha05 contiene questi commit.
Nuove funzionalità
DatePickerDialog
e assistenza per l'accessibilità- Miniatura e traccia personalizzati aggiunti a
RangeSlider
.
Aggiornamenti delle dipendenze
Compose UI
eCompose Material
ora dipendono dal ciclo di vita 2.6.0.
Versione 1.1.0-alpha04
11 gennaio 2023
androidx.compose.material3:material3:1.1.0-alpha04
e androidx.compose.material3:material3-window-size-class:1.1.0-alpha04
vengono rilasciati. La versione 1.1.0-alpha04 contiene questi commit.
Nuove funzionalità
- API
DatePicker
iniziale per scegliere una singola data tramite un'interfaccia utente di calendario. Questa API è ancora in fase di modifica. (I722b9) - Aggiunto il supporto per le descrizioni comando semplici tramite
PlainTooltipBox
. (I0cdfb) - Barra di ricerca (Iad128)
SwipeToDismiss
(I458a8, b/242889540)
Modifiche alle API
- Aggiunta nella proprietà semantica di
IsContainer
sulle piattaforme. Questa proprietà verrà utilizzata in una modifica successiva che determina l'ordine di attraversamento in base al significato semantico di elementi come le superfici. (I63379) - Contrassegna le API correlate al riquadro di navigazione a scomparsa come stabili. (Iab01e, b/261439597).
- Sono stati aggiunti un parametro per il colore delle tracce per gli indicatori di avanzamento circolari e un parametro del limite del tratto per gli indicatori di avanzamento circolari e lineari. (Ie668c, b/216325962, b/222964817).
- Altro tipo di restituzione nulla delle funzioni deprecate nascoste (Ibf7b0)
- Aggiungi
Modifier.minimumInteractiveComponentSize
. Può essere utilizzato per prenotare una dimensione di almeno 48.dp per chiarire le interazioni di tocco nel caso in cui l'elemento misurasse un valore più piccolo. (I33f58, b/258495559) - È stata aggiunta l'API sperimentale per il componibile
AlertDialog
con un'area per i contenuti. (Iec4a2).
Correzioni di bug
- L'avanzamento degli indicatori di avanzamento è ora limitato correttamente all'intervallo previsto. (I8a7eb, b/262262727).
Problema noto
- Quando esegui l'aggiornamento da
androidx.compose.foundation:1.4.0-alpha03
aandroidx.compose.foundation:1.4.0-alpha04
, potresti riscontrare un errorejava.lang.NoSuchFieldError
. Qui è dove in origine era stato segnalato il problema. Una correzione è stata inviata e sarà disponibile nel prossimo aggiornamento di Compose. Per risolvere il problema, aggiorna le librerieandroidx.compose.material
eandroidx.compose.material3
all'ultima versione(1.1.0-alpha04) oppure esegui il downgrade diandroidx.compose.foundation
alla versione 1.4.0-alpha03.
Versione 1.1.0-alpha03
7 dicembre 2022
androidx.compose.material3:material3:1.1.0-alpha03
e androidx.compose.material3:material3-window-size-class:1.1.0-alpha03
vengono rilasciati. La versione 1.1.0-alpha03 contiene questi commit.
Modifiche alle API
consumedWindowInsets()
è stato rinominato inconsumeWindowInsets()
ewithConsumedWindowInsets()
inonConsumedWindowInsetsChanged()
e i modificatori sono stati resi pubblici. (Ie44e1).- Aggiungi una nuova spaziatura interna dei contenuti predefinita per il pulsante di testo con icona da utilizzare. (I8f662)
- Sono stati aggiunti i colori disattivati per la barra di navigazione e il binario. (Ia7892, b/258867034).
- È stata aggiunta un'API Modifier per eseguire query sulle informazioni di scorrimento dei predecessori. (I2ba9d, b/203141462)
- Utilizzato in
Clickable
per ritardare correttamente le interazioni con la pressione, quando i gesti potrebbero diventare eventi di scorrimento. - Risolto il problema di
Clickables
che non ritardava correttamente gli echi, se utilizzato all'interno di unScrollable ViewGroup
. - I cassetti e i fogli sono stati aggiornati per ritardare correttamente la pressione nel caso in cui i gesti possano diventare eventi di scorrimento.
Aggiornamenti delle dipendenze
Compose UI
eCompose Material
ora dipendono dal ciclo di vita 2.5.1. (I05ab0, b/258038814).
Versione 1.1.0-alpha02
9 novembre 2022
androidx.compose.material3:material3:1.1.0-alpha02
e androidx.compose.material3:material3-window-size-class:1.1.0-alpha02
vengono rilasciati. La versione 1.1.0-alpha02 contiene questi commit.
Modifiche alle API
awaitFirstDown
ewaitForUpOrCancellation
ora accettano unPointerEventPass
per una maggiore flessibilità (corregge ancheExposedDropdownMenuBox
che mostra un menu durante lo scorrimento).(I7579a, b/212091796)- Aggiunto il parametro
minLines
nei testi material3 e material3,TextField
eOutlinedTextField
che consente di impostare l'altezza minima del componente in termini di numero di righe (I4af1d) - Ritira la funzione
TopAppBarDefaults smallTopAppBarColors
in favore di una nuova funzionetopAppBarColors
da utilizzare durante la creazione di unTopAppBar
. (Ie6cb9). - Parametro
minLines
aggiunto aBasicText
eBasicTextField
. Consente di impostare l'altezza minima di questi componenti componibili in termini di numero di righe (I24294, b/122476634)
Correzioni di bug
- Ritaglia i contenuti di un elemento Material3
IconButton
eIconToggleBotton
alla forma a livello di stato del componente (ad esempio, forma circolare). (I9da8f). - Aggiorna le barre delle app superiori di Material3, Medium e Large, per applicare lo stesso colore di sfondo su tutta la superficie e per consentire l'impostazione che sostituisce i colori predefiniti con valori di colore trasparenti. (I67659, b/249688556, b/250838918)
Versione 1.1.0-alpha01
24 ottobre 2022
androidx.compose.material3:material3:1.1.0-alpha01
e androidx.compose.material3:material3-window-size-class:1.1.0-alpha01
vengono rilasciati. La versione 1.1.0-alpha01 contiene questi commit.
Correzioni di bug
- Correzioni alla barra dell'app in alto quando il titolo viene applicato con uno stile di testo e un pennello. (If667e).
Versione 1.0
Versione 1.0.1
9 novembre 2022
androidx.compose.material3:material3:1.0.1
e androidx.compose.material3:material3-window-size-class:1.0.1
vengono rilasciati. La versione 1.0.1 contiene questi commit.
Correzioni di bug
- Aggiorna le barre delle app superiori di Material3, Medium e Large, per applicare lo stesso colore di sfondo su tutta la superficie e per consentire l'impostazione che sostituisce i colori predefiniti con valori di colore trasparenti. (I67659, b/249688556, b/250838918)
Versione 1.0.0
24 ottobre 2022
androidx.compose.material3:material3:1.0.0
e androidx.compose.material3:material3-window-size-class:1.0.0
vengono rilasciati. La versione 1.0.0 contiene questi commit.
Funzionalità principali della versione 1.0.0
Questa è la prima release stabile di Compose Material 3.
Temi di Material Design 3 e colore dinamico di Material You
Componenti di Material Design 3
- Badge
- Barra dell'app in basso
- Tasti
- FAB e FAB esteso
- Schede
- Casella di controllo
- Chip
- Finestre di dialogo
- Spartitraffico
- Menu a discesa
- Elenco
- Barra di navigazione
- Riquadro di navigazione a scomparsa
- Binario di navigazione
- Indicatore di avanzamento
- Pulsante di opzione
- Cursore
- Cambia
- Schede
- Campi di testo
- Barra dell'app in alto
- Icona
- Testo
- Piattaforma
- Layout
- Colore dei contenuti
Classe di dimensione della finestra
material3-window-size-class
è una nuova libreria che supporta le classi di dimensioni delle finestre, ovvero un insieme di punti di interruzione dell'area visibile comprensibili con cui progettare, sviluppare e testare i layout delle applicazioni ridimensionabili. Puoi utilizzarecalculateWindowSizeClass
per recuperare un'istanza di classe della dimensione della finestra, che puoi utilizzare per determinare come dovrebbe apparire la tua UI, ad esempio mostrare una barra di navigazione anziché la navigazione in basso per finestre di dimensioni maggiori. Per ulteriori informazioni e per l'utilizzo di esempio, consulta la documentazione di riferimento dell'API perWindowSizeClass
.Leggi questo post del blog per maggiori dettagli.
Versione 1.0.0-rc01
5 ottobre 2022
androidx.compose.material3:material3:1.0.0-rc01
e androidx.compose.material3:material3-window-size-class:1.0.0-rc01
vengono rilasciati. La versione 1.0.0-rc01 contiene questi commit.
Modifiche alle API
- Parametro slot aggiunto per il supporto dell'API da testo a campo di testo (Iaac0d, b/227146125)
Versione 1.0.0-beta03
21 settembre 2022
androidx.compose.material3:material3:1.0.0-beta03
e androidx.compose.material3:material3-window-size-class:1.0.0-beta03
vengono rilasciati. La versione 1.0.0-beta03 contiene questi commit.
Modifiche alle API
ExposedDropdownMenuDefaults
ora espone un valore di spaziatura interna per le voci di menu. (I34ee1)- Ora
ExposedDropdownMenuBoxScope
ha un modificatoreModifier.menuAnchor()
che deve essere trasmesso al campo di testo per garantire un comportamento corretto dell'accessibilità. (I27fa3) - Aggiunta di due metodi di sovraccarico per l'API Slider corrente per consentire agli utenti di passare un pollice o una traccia per completare il cursore. (I21c00).
Correzioni di bug
- Mappatura dei colori del tema scuro per On Error Container aggiornata al tono 90 (Ic5612)
- Correzione per consentire l'impostazione di uno sfondo trasparente per le piccole barre delle app superiori di Material 3. (I645e2, b/245575782)
Versione 1.0.0-beta02
7 settembre 2022
androidx.compose.material3:material3:1.0.0-beta02
e androidx.compose.material3:material3-window-size-class:1.0.0-beta02
vengono rilasciati. La versione 1.0.0-beta02 contiene questi commit.
Modifiche alle API
- Gli insiemi dei componenti predefiniti introdotti nei componenti m3 nella versione beta01 non tengono più conto degli insiemi IME.
- Il componente Scaffold Material3 ora ha un parametro
contentWindowInsets
che consente di specificare la quantità di inserti da gestire per l'area dei contenuti. (Icf11a, b/243713323). - Depreca la funzione
SmallTopAppBar
sperimentale Material 3 e introduce una funzioneTopAppBar
equivalente. Esegui la migrazione del tuo utilizzo a quello nuovo. (I74404, b/226918634) - Aggiunge il controllo sui comportamenti di scorrimento e aggancio della barra delle app superiore. (I15c81)
- Rimuove startIndent da Divisore e sposta il colore all'ultimo parametro. (If7be2).
Correzioni di bug
- Fai in modo che le finestre di dialogo si identifichino per rispondere agli utenti annunciando la parola Finestra di dialogo quando vengono visualizzate. (I857ef)
Versione 1.0.0-beta01
24 agosto 2022
androidx.compose.material3:material3:1.0.0-beta01
e androidx.compose.material3:material3-window-size-class:1.0.0-beta01
vengono rilasciati. La versione 1.0.0-beta01 contiene questi commit.
Riferimento API
Per scoprire i temi, i componenti e gli altri componibili più recenti disponibili, consulta la panoramica di riferimento dell'API Compose Material 3.
Modifiche alle API
- Aggiornamento della barra superiore dell'app di Material 3 per agganciarsi allo stato completamente compresso e esteso. È stata inoltre aggiornata la funzione di comportamento di
TopAppBarDefaults
in modo che sia componibile e fornisca valori predefiniti per lo stato della barra dell'app principale e le specifiche di animazione. (I642b3) - Firme dei componenti FAB aggiornate in modo che corrispondano all'API della superficie (I3afaa)
- Aggiunti inserti Supporto integrato per barre delle app superiori, cassetti, barra di navigazione e guida. Questi componenti, se utilizzati separatamente o con impalcatura, gestiscono automaticamente gli inserti per gli sviluppatori. Nota: questa modifica non aggiunge la gestione automatica delle icone della barra di stato e la trasparenza delle barre di stato e di navigazione. Continua a farlo manualmente per garantire la migliore esperienza edge-to-edge. (I7e4e6, b/183161866).
- Sono state aggiornate le impostazioni predefinite dei componenti per ridurre la superficie API in modo da migliorare la flessibilità e le prestazioni in futuro. (I31820)
- Parametri del chip e del riquadro a scomparsa di navigazione riordinati per mantenere la coerenza all'interno dell'API (I45d0b)
startIndent
rimosso da Divisore e spostato il colore come ultimo parametro.(If7be2)
Versione 1.0.0-alpha16
10 agosto 2022
androidx.compose.material3:material3:1.0.0-alpha16
e androidx.compose.material3:material3-window-size-class:1.0.0-alpha16
vengono rilasciati. La versione 1.0.0-alpha16 contiene questi commit.
Nuove funzionalità
- Supporto che specifica una larghezza personalizzata in un riquadro di navigazione a scomparsa. (Ia7f10)
Modifiche alle API
- Parametri della scheda Riordina e dell'icona principale per mantenere la coerenza all'interno dell'API (Ie2637)
BadgeDefaults
contrassegnato come sperimentale. (I98ef3)- Rimuovi la funzione di navigazione a scomparsa deprecata. (I4f2db).
- Riordina i parametri del dispositivo di scorrimento nel materiale 3 per mantenere la coerenza all'interno dell'API (I0aee7)
- Riordina i parametri
NavigationBar
eNavigationRail
per mantenere la coerenza all'interno dell'API (I51cda) - Riordina i parametri in Material 3 per mantenere la coerenza in tutta l'API. (If4ae1).
- Riordina i parametri del dispositivo di scorrimento in Material 3 per mantenere la coerenza all'interno dell'API (I62673)
- Parametro delle icone rinominato in azioni, coerentemente con la barra delle app superiore (Id75be)
- Contrassegna
Badge
eBadgedBox
come sperimentali perché l'allineamento ancorato è ancora in corso. (I1712e, b/236524516). - Modifica
@ExperimentalMaterial3Api
annotazioni sulle varianti del pulsante icona in@OptIn
(I070b5) - Separato i contenuti di un riquadro di navigazione a scomparsa in un proprio componibile per supportare la specifica di una larghezza personalizzata. (Ia7f10)
- Rimuove
Divider
daMenuDefaults
eTabDefaults
(I4e33c)
Versione 1.0.0-alpha15
27 luglio 2022
androidx.compose.material3:material3:1.0.0-alpha15
e androidx.compose.material3:material3-window-size-class:1.0.0-alpha15
vengono rilasciati. La versione 1.0.0-alpha15 contiene questi commit.
Nuove funzionalità
- Consenti di trascinare la barra delle app in alto dalla barra stessa. (I65c00, b/205873416).
Modifiche alle API
- Aggiornamenti alle API
FilterChip
eElevatedFilterChip
per rimuovere lo slotselectedIcon
e promuovere il riutilizzo dileadingIcon
per la visualizzazione dello stato selezionato. (Ie5dc2) - Aggiungi i ruoli di colore delle varianti di scrim e contorno. (Id6d54)
- Correggi le convenzioni di denominazione per i valori predefiniti componibili. (I62b27)
- Contrassegna
ListItemDefaults
eListItemColors
come sperimentali. (I1f3ec). - Modifiche all'API della barra delle app principale per riflettere meglio il significato delle relative proprietà dello stato. Inoltre, contrassegna l'API della barra delle app principale come sperimentale. (Ic0ad8)
- I colori per la selezione del testo sono stati aggiunti a
TextFieldColors
per una migliore rilevabilità. (Iba1b8). - Aggiunta di
ButtonDefault.ButtonWithIconContentPadding
da utilizzare con pulsanti che contengono un'icona. (I2bf9c) - I campi di testo sono stati contrassegnati come sperimentali per consentire una maggiore flessibilità nelle future modifiche dell'API. (I127b5).
- L'annotazione
@ExperimentalMaterial3Api
è stata rimossa dalla funzioneCheckbox
. (I5eefc) - L'annotazione
@ExperimentalMaterial3Api
è stata rimossa dalla funzioneRadioButton
. (I17e2a). - È stata rimossa l'annotazione
@ExperimentalMaterial3Api
dalle schede non interattive. (I9bd49). - Aggiorna vari oggetti predefiniti dei componenti per includere colori, forme e così via (I96e11)
Correzioni di bug
- Sono state rimosse le icone finali non funzionanti dagli esempi di chip di input per evitare confusione per gli utenti nell'app Catalogo (I9846a).
Versione 1.0.0-alpha14
29 giugno 2022
androidx.compose.material3:material3:1.0.0-alpha14
e androidx.compose.material3:material3-window-size-class:1.0.0-alpha14
vengono rilasciati. La versione 1.0.0-alpha14 contiene questi commit.
Nuove funzionalità
- Aggiunta l'implementazione dell'elenco M3. Consulta la documentazione per l'utilizzo di esempio (Id7a20)
Modifiche alle API
- Modifica il nome del parametro da valori a valore in
RangeSlider
(I3b79a) - Modifiche dell'API all'implementazione
InputChip
per supportare uno stato selezionabile secondo le specifiche di Material Design. Supporto aggiuntivo per i coloriFilterChip
per lo stato disattivato selezionato. (I55244, b/235792432) - Aggiungi FAB predefinito di
BottomAppBar
(Ida4c8) ColorScheme.surfaceColorAtElevation
aggiunto (Id41af)- Le interfacce nelle librerie di scrittura ora vengono create utilizzando i metodi di interfaccia predefinita di jdk8 (I5bcf1)
WindowWidthSizeClass
eWindowHeightSizeClass
ora implementano Comparable, in modo da poter essere confrontati utilizzando gli operatori (<, <=, >=, >) e altre API. (I747d0)
Correzioni di bug
- Aggiorna il campione del badge per fornire una descrizione dei contenuti più significativa. (I10b9d)
- Aggiunge l'opzione per utilizzare la dimensione del carattere di sistema al selettore di temi del catalogo di Material 3. (I10605)
- Aggiunge un codice campione per il badge e gli indicatori di avanzamento indeterminato. (I8fbe0).
Versione 1.0.0-alpha13
1° giugno 2022
androidx.compose.material3:material3:1.0.0-alpha13
e androidx.compose.material3:material3-window-size-class:1.0.0-alpha13
vengono rilasciati. La versione 1.0.0-alpha13 contiene questi commit.
Modifiche alle API
- Supporta il mantenimento della posizione superiore della barra delle app in caso di modifica della configurazione. (I10459, b/216160958)
Versione 1.0.0-alpha12
18 maggio 2022
androidx.compose.material3:material3:1.0.0-alpha12
e androidx.compose.material3:material3-window-size-class:1.0.0-alpha12
vengono rilasciati. La versione 1.0.0-alpha12 contiene questi commit.
Correzioni di bug
- Ora il dispositivo di scorrimento principale può avere una larghezza pari a 0. (b/231707291)
Versione 1.0.0-alpha11
11 maggio 2022
androidx.compose.material3:material3:1.0.0-alpha11
e androidx.compose.material3:material3-window-size-class:1.0.0-alpha11
vengono rilasciati. La versione 1.0.0-alpha11 contiene questi commit.
Nuove funzionalità
- Aggiunta di
RangeSlider
a Material 3 (I18e38) - Aggiunge il supporto di Material3
AssistChip
eInputChip
(I0d25a) - Aggiunge il supporto
FilterChip
eSuggestionChip
di Material3 (I9fdf3)
Modifiche alle API
- Rinominato
TextFieldDefaults.BorderStroke
componibile che disegna un tratto del bordo inOutlinedTextField
inTextFieldDefaults.BorderBox
. (I5f295). - Modifiche visive di Switch M3 (Iab30e)
- Consente il passaggio dei colori ai pulsanti icona standard. (Ia2445)
Correzioni di bug
- Aggiungi il controllo di lint a material3/Scaffold per assicurarti che venga utilizzata la spaziatura interna interna (I72293, b/226951418)
Versione 1.0.0-alpha10
20 aprile 2022
androidx.compose.material3:material3:1.0.0-alpha10
e androidx.compose.material3:material3-window-size-class:1.0.0-alpha10
vengono rilasciati. La versione 1.0.0-alpha10 contiene questi commit.
Nuove funzionalità
material3-window-size-class
è una nuova libreria che supporta le classi di dimensioni delle finestre, ovvero un insieme di punti di interruzione dell'area visibile comprensibili con cui progettare, sviluppare e testare i layout delle applicazioni ridimensionabili. Puoi utilizzarecalculateWindowSizeClass
per recuperare un'istanza di classe della dimensione della finestra, che puoi utilizzare per determinare come dovrebbe apparire la tua UI, ad esempio mostrare una barra di navigazione anziché la navigazione in basso per finestre di dimensioni maggiori. Per ulteriori informazioni e per esempi di utilizzo, consulta la documentazione di riferimento dell'API perWindowSizeClass
. Per ulteriori informazioni sulle definizioni delle classi di dimensioni delle finestre, consulta le indicazioni pubbliche sul supporto di diverse dimensioni dello schermo.
Modifiche alle API
- Aggiunge l'elevazione FAB predefinita per
BottomAppBar
, rimuove lambda finale daBottomAppBar
con FAB. (I92c47). - Aggiunge Material3
FilledIconButton
,FilledTonalIconButton
eOutlinedIconButton
. (Ib2bda). - Aggiorna l'API Snackbar Material 3 per accettare i valori di colore per l'azione facoltativa e l'azione di chiusura. (Ibe4b4).
- Il consumo parziale (posizione abbassata OR) è stato ritirato in
PointerInputChange
. Puoi utilizzareconsume()
per completare la modifica. Puoi utilizzareisConsumed
per stabilire se qualcun altro ha già utilizzato la modifica. - Ora
PointerInputChange::copy()
crea sempre una copia superficiale. Significa che le copie diPointerInputChange
verranno consumate una volta esaurita una delle copie. Se vuoi creare un elementoPointerInputChange
non associato, utilizza invece il costruttore. (Ie6be4, b/225669674). - Modifiche all'API Cards per ricevere i colori del contenitore e dei contenuti tramite un'interfaccia
CardColors
e supportare lo stato disattivato per le schede cliccabili. (I927df) - Il parametro
backgroundColor
è stato rinominatocontainerColor
nei campi di testo Material 3 per una maggiore coerenza con altri componenti. (I6fbd9).
Correzioni di bug
- Aggiornamenti allo standard
IconButton
per allinearlo alle specifiche Material3 (I09eab) - Sposta l'altezza della barra superiore di material3. In questo modo, i contenuti vengono visualizzati sotto la barra dell'app in alto nella spaziatura interna. Se
PaddingValues
vengono ignorati, i contenuti potrebbero essere oscurati dalla barra superiore. (I83cbc, b/217776202)
Versione 1.0.0-alpha09
6 aprile 2022
androidx.compose.material3:material3:1.0.0-alpha09
viene rilasciato. La versione 1.0.0-alpha09 contiene questi commit.
Nuove funzionalità
- Aggiunta dell'API Material 3 Switch (I2c3ad)
Modifiche alle API
- Aggiunto il supporto per i menu a discesa con campi di testo ("menu a discesa esposti" o "caselle combinate"). (I1b832)
- È stato aggiunto il parametro di forma al sottosistema MaterialTheme e Shape. (I37426)
- È stato aggiunto un parametro espanso a
ExtendedFloatingActionButton
per controllare se il FAB viene espanso o compresso, con animazioni tra uno stato e l'altro. Aggiunto sovraccarico di FAB esteso per i FAB estesi con testo finale per i FAB estesi senza icona. (Iba7f1).
Versione 1.0.0-alpha08
23 marzo 2022
androidx.compose.material3:material3:1.0.0-alpha08
viene rilasciato. La versione 1.0.0-alpha08 contiene questi commit.
Nuove funzionalità
- Aggiunto il supporto per i campi di testo di Material 3. (I795cc, b/199377790)
Modifiche alle API
- Aggiungi un divisore predefinito per il menu (I01374)
- Parametro colore
surfaceTint
aggiunto alla classeColorScheme
. (I2f558)
Correzioni di bug
- Fissa il valore del pulsante Material3 per leggere il valore di stile di testo predefinito di MaterialTheme. (Ie62fc)
Versione 1.0.0-alpha07
9 marzo 2022
androidx.compose.material3:material3:1.0.0-alpha07
viene rilasciato. La versione 1.0.0-alpha07 contiene questi commit.
Modifiche alle API
- Aggiornamenti all'API Material 3 Surface che ripristina le funzioni sovraccaricate per le piattaforme cliccabili, oltre all'aggiunta di una funzione per supportare le piattaforme selezionabili e attivabili. (I4bf18)
LazyVerticalGrid
eLazyHorizontalGrid
sono ora stabili. (I307c0)LazyVerticalGrid/LazyHorizontalGrid
e tutte le API correlate sono state spostate nel sottopacchetto .grid. Aggiorna le importazioni da androidx.compose.foundation.lazy ad androidx.compose.foundation.lazy.grid. (I2d446).- È stata annullata la modifica precedente relativa all'utilizzo esclusivo di una vista per
WindowInsetsControllerCompat
; è stata inoltre richiesta una finestra, necessaria per la gestione di alcuni flag delle finestre. DeprecatoViewCompat.getWindowInsetsController
a favore diWindowCompat.getInsetsController
per garantire che venga utilizzata la finestra corretta (ad esempio se la vista è in una finestra di dialogo). (I660ae, b/219572936) - È stata aggiunta una nuova API
LazyVerticalGrid
per definire le dimensioni dell'asse trasversale (I17723)
Correzioni di bug
- Aggiornamenti all'API Card per seguire le modifiche dell'API Surface (I3c8b9)
Versione 1.0.0-alpha06
23 febbraio 2022
androidx.compose.material3:material3:1.0.0-alpha06
viene rilasciato. La versione 1.0.0-alpha06 contiene questi commit.
Modifiche alle API
- Viene aggiunto
NavigationDrawerItem
che rappresenta una singola destinazione all'interno dei cassetti (Ic396f, b/218286829) PermanentNavigationDrawer
eDismissibleNavigationDrawer
sono state aggiunte come API sperimentali. Questi cassetti sono perfetti per i dispositivi con schermi di grandi dimensioni. (I5f8ab, b/218286829).- Aggiunge il supporto della barra delle app inferiore di Material 3 (Ic432a)
NavigationDrawer
è stato rinominato inModalNavigationDrawer
(I1807d, b/218286829)- Sono stati aggiunti i token e la classe Slider di Material 3 (I1ccee)
- Aggiunta dell'implementazione delle schede. Consulta la documentazione per un esempio di utilizzo (Ie0146)
Correzioni di bug
- Risolto il problema per cui la navigazione lineare dello screen reader
TalkBack
selezionava un titolo della barra delle app superiore vuoto. (Id4690) - Elemento
IconSize
aggiunto alla raccoltaFloatingActionButtonDefaults
. (Ia71cf) - Correzione di bug per i pulsanti
AlertDialog
nascosti quando viene aggiunto un testo lungo con unLazyColumn
. (Ib2cc9, b/216663029).
Versione 1.0.0-alpha05
9 febbraio 2022
androidx.compose.material3:material3:1.0.0-alpha05
viene rilasciato. La versione 1.0.0-alpha05 contiene questi commit.
Nuove funzionalità
Sono stati aggiunti i componenti di Material Design 3
- Menu a discesa
- Schede
Modifiche alle API
- Funzione
Surface
deprecata che accetta un callback di YAML. Le piattaforme cliccabili devono essere create con unInteractionSource
e unModifier.clickable()
. (I211c6). - Aggiunto il supporto dell'elevazione premendo e focalizzato per FAB. (Ibb584).
- È stata modificata l'API
Surface
in modo da ricevere un InteractionSource che consente di controllarne l'aspetto in diversi stati. (Iafbc8).
Correzioni di bug
- Sono stati aggiunti colori terziari mancanti nelle combinazioni di colori dinamici (I456c4, b/214588434)
Versione 1.0.0-alpha04
26 gennaio 2022
androidx.compose.material3:material3:1.0.0-alpha04
viene rilasciato. La versione 1.0.0-alpha04 contiene questi commit.
Modifiche alle API
- È stato aggiunto
NonRestartableComposable
ai metodi che sono sovraccarichi di metodi esistenti senza logica complessa. In questo modo vengono ridotti i controlli di memorizzazione generati dal compilatore (uguale a) per tutti i parametri che vengono ripetuti nella funzione interna chiamata. (I90490) - Divisore Material 3 aggiunto. (Ica5fc).
- Contrassegna la casella di controllo e RadioButton con un'annotazione API sperimentale. (Ie44bb)
- Aggiunto il supporto per gli indicatori di avanzamento di Material 3. (Iff232, b/205023841).
Correzioni di bug
- Aggiorna un colore del contenitore
TextButton's
disattivato affinché sia trasparente (I6b248, b/213339737)
Versione 1.0.0-alpha03
12 gennaio 2022
androidx.compose.material3:material3:1.0.0-alpha03
viene rilasciato. La versione 1.0.0-alpha03 contiene questi commit.
Correzioni di bug
- Aggiungi
LocalIndication
alMaterialTheme
di Material 3. (I7ce4e). - Correggi il raggio d'angolo applicato alle caselle di controllo (I38b03, b/175198975, b/202309440)
Aggiornamenti delle dipendenze
- Ora dipende da Kotlin
1.6.10
.
Versione 1.0.0-alpha02
1° dicembre 2021
androidx.compose.material3:material3:1.0.0-alpha02
viene rilasciato. La versione 1.0.0-alpha02 contiene questi commit.
Nuove funzionalità
- Aggiungi il supporto per casella di controllo e pulsante di opzione.
- Aggiornato per essere compatibile con Kotlin
1.6.0
Modifiche alle API
- Rimuovi il cassetto dall'impalcatura del Materiale 3. (I04f51)
- Aggiunge il supporto di
Checkbox
di Material 3. (Id5542) - Aggiunge il supporto di
RadioButton
di Material 3. (I20334)
Correzioni di bug
- Riduci il raggio dell'ondulazione di
IconButton
da 40 dp a 20 dp. (I68bbe, b/206674345) - Il percorso rapido della stringa di porta per
Text
viene modificato dacompose.material
(I30b03) - Risolto, ma il pulsante impostato come hardcoded era sempre attivo. (Iea832, b/205335456).
Versione 1.0.0-alpha01
27 ottobre 2021
androidx.compose.material3:material3:1.0.0-alpha01
viene rilasciato. La versione 1.0.0-alpha01 contiene questi commit.
Nuove funzionalità
Temi di Material Design 3 e colore dinamico di Material You
Componenti di Material Design 3
- Tasti
- FAB e FAB esteso
- Finestre di dialogo
- Barra di navigazione
- Riquadro di navigazione a scomparsa
- Binario di navigazione
- Barra dell'app in alto
- Badge
- Icona
- Testo
- Piattaforma
- Layout
- Colore dei contenuti
Per ulteriori informazioni, consulta la sezione Material Design 3 e Material You nella guida ai temi dei materiali in Compose.