Snackbar

發行項
07/10/2023

重要

本文說明 處於公開預覽 狀態的功能和指引，而且可能會在正式推出之前大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

概觀

是具有CoordinatorLayout的自訂FrameLayout，做為子系，可用來做為列子系。 SnackbarContainer 此容器可折迭感知，而且可用於可折迭裝置，也可以用於一般裝置上。每一次畫面底部的畫面底部會從螢幕邊緣固定 25 圖元顯示訊息。

使用 WindowManager 的資訊，此容器會移動開發人員需要的第一個畫面、第二個畫面或整個畫面上的 CoordinatorLayout 子系。針對其他案例，您可以直接使用 Snackbar 。

如何將程式庫匯入您的專案中

請確定存放 mavenCentral() 庫位於最上層 build.gradle 檔案中：

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

將此相依性新增至模組層級 build.gradle 檔案：

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

如果您的專案是使用 JAVA 建立的，您必須將 kotlin-stdlib 相依性新增至模組層級 build.gradle 檔案 (這是因為使用 Kotlin) 建立的要庫。
```
dependencies {
   implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk8:$kotlin_version"
}
```

如何顯示雙螢幕巴巴

新增套件之後，請遵循下列步驟來實作雙螢幕的[老式] 列：

SnackbarContainer在或 Fragment 根檢視底部 Activity 新增：

<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>

使用的 SnackbarContainer 實例，您可以使用這個程式碼片段來顯示 Snackbar 。參數是的 SnackbarContainer 實例，參數 snackbarContainermessage 是要顯示的文字，而且 LENGTH_LONG 是顯示持續時間。函 show 式是擴充函式，用來在指定位置顯示 Snackbar 指定位置內的 SnackbarContainer 。
- 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)
```