Bagikan melalui


Bilah makanan ringan

Penting

Artikel ini menjelaskan fungsionalitas dan panduan yang ada di pratinjau publik dan dapat dimodifikasi secara substansial sebelum tersedia secara umum. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Gambaran Umum

SnackbarContainer adalah FrameLayout kustom dengan CoordinatorLayout sebagai anak yang dapat digunakan sebagai pemegang snackbar. Kontainer ini sadar dapat dilipat, dan dapat digunakan pada perangkat yang dapat dilipat tetapi juga pada perangkat reguler. Pesan akan ditampilkan setiap kali di bagian bawah layar pada tetap 25 piksel dari tepi layar.

Dengan menggunakan informasi dari WindowManager, kontainer ini memindahkan anak CoordinatorLayout tempat pengembang membutuhkan, di layar pertama, layar kedua, atau seluruh layar. Untuk skenario lain, Anda dapat menggunakan secara Snackbar langsung.

Cara mengimpor pustaka ke dalam proyek Anda

  1. mavenCentral() Pastikan repositori berada di file build.gradle tingkat atas Anda:

     allprojects {
         repositories {
             google()
             mavenCentral()
          }
     }
    
  2. Tambahkan dependensi ini ke file build.gradle tingkat modul:

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

  1. Jika proyek Anda dibuat menggunakan Java, Anda harus menambahkan dependensi kotlin-stdlib ke file build.gradle tingkat modul Anda (ini karena pustaka Snackbar dibuat menggunakan Kotlin).

    dependencies {
       implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk8:$kotlin_version"
    }
    

Cara menampilkan Snackbar layar ganda

Setelah paket ditambahkan, ikuti langkah-langkah berikut untuk mengimplementasikan Snackbar layar ganda:

  1. SnackbarContainer Tambahkan di bagian Activity bawah tampilan akar atau 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>
    
  2. Menggunakan instans SnackbarContainer, Anda dapat menampilkan menggunakan cuplikan Snackbar kode ini. Parameter snackbarContainer adalah instans SnackbarContainer, message parameter adalah teks yang akan ditampilkan, dan LENGTH_LONG merupakan durasi tampilan. Fungsi ini show adalah fungsi ekstensi yang digunakan untuk menampilkan bagian Snackbar dalam yang diberikan SnackbarContainer pada posisi yang ditentukan.

    Snackbar
        .make(snackbarContainer.coordinatorLayout, message, LENGTH_LONG)
        .show(snackbarContainer, position) 
    

SnackbarPosition

Nilai yang position mungkin untuk parameter adalah:

  • SnackbarPosition.START
  • SnackbarPosition.END
  • SnackbarPosition.BOTH

Ini dijelaskan secara lebih rinci di bawah ini.

SnackbarPosition.START

Snackbar akan ditampilkan di bagian bawah area tampilan pertama:

START: snackbar on the first screen, portrait orientation

START: snackbar on the first screen, landscape orientation

SnackbarPosition.END

Snackbar akan ditampilkan pada area tampilan kedua:

END: snackbar on the second screen, portrait orientation

END: snackbar on the second screen, landscape orientation

SnackbarPosition.BOTH

Snackbar akan ditampilkan di bagian bawah seluruh area tampilan:

BOTH: snackbar on both screens, portrait orientation

BOTH: snackbar on both screens, landscape orientation

Sampel

Anda dapat melihat kode aplikasi sampel snackbar untuk melihat semua perilaku ini.