Snackbar

Artigo
07/10/2023

Importante

Este artigo descreve funcionalidades e diretrizes que estão em versão prévia pública e podem ser modificadas substancialmente antes de passarem para a disponibilidade geral. A Microsoft não faz nenhuma garantia, expressa ou implícita, com relação às informações fornecidas aqui.

Visão geral

O SnackbarContainer é um FrameLayout personalizado com um CoordinatorLayout como um filho que pode ser usado como um suporte para o Snackbar. Esse contêiner tem reconhecimento de dobra e pode ser usado em dispositivos dobráveis e também em dispositivos regulares. A mensagem será exibida sempre na parte inferior da tela com 25 pixels fixos nas bordas da tela.

Usando as informações do WindowManager, esse contêiner move o filho CoordinatorLayout para onde o desenvolvedor precisa, seja na primeira tela, na segunda tela ou na tela inteira. Para outros cenários, você pode usar o Snackbar diretamente.

Como importar a biblioteca para seu projeto

Verifique se o repositório mavenCentral() está no arquivo build.gradle de nível superior:

 allprojects {
     repositories {
         google()
         mavenCentral()
      }
 }

Adicione esta dependência ao arquivo de nível de módulo build.gradle:

dependencies {
     implementation "com.microsoft.device.dualscreen:snackbar:1.0.0-alpha2"
}

Se o projeto for criado usando Java, você precisará adicionar uma dependência kotlin-stdlib ao arquivo build.gradle no nível do módulo (isso ocorre porque a biblioteca Snackbar foi criada usando o Kotlin).
```
dependencies {
   implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk8:$kotlin_version"
}
```

Como mostrar um Snackbar de tela dupla

Depois que o pacote for adicionado, siga estas etapas para implementar o Snackbar de tela dupla:

Adicione o SnackbarContainer na parte inferior do modo de exibição raiz Activity ou Fragment:

<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android" 
    xmlns:app="http://schemas.android.com/apk/res-auto" 
    android:layout_width="match_parent" 
    android:layout_height="match_parent" 

    <com.microsoft.device.dualscreen.snackbar.SnackbarContainer 
        android:id="@+id/snackbar_container" 
        android:layout_width="match_parent" 
        android:layout_height="wrap_content" 
        app:layout_constraintBottom_toBottomOf="parent" 
        app:layout_constraintEnd_toEndOf="parent" 
        app:layout_constraintStart_toStartOf="parent" /> 

</androidx.constraintlayout.widget.ConstraintLayout>

Usando uma instância do SnackbarContainer, você pode exibir o Snackbar usando este snippet de código. O parâmetro snackbarContainer é uma instância de SnackbarContainer, o parâmetro message é o texto a ser exibido e LENGTH_LONG é a duração de exibição. A função show é uma função de extensão usada para exibir o Snackbar dentro do SnackbarContainer determinado na posição especificada.
- Kotlin
- Java
```
Snackbar
    .make(snackbarContainer.coordinatorLayout, message, LENGTH_LONG)
    .show(snackbarContainer, position) 
```
```
Snackbar snackbar = Snackbar.make(snackbarContainer.getCoordinatorLayout(), message, LENGTH_LONG);
SnackbarKt.show(snackbar, snackbarContainer, position)
```