Menyiapkan panel aplikasi

Mencoba cara Compose
Jetpack Compose adalah toolkit UI yang direkomendasikan untuk Android. Pelajari cara menambahkan komponen di Compose.
Panel Aplikasi →

Dalam bentuknya yang paling sederhana, panel tindakan menampilkan judul aktivitas di satu sisi dan menu tambahan di sisi yang lain. Meskipun bentuknya sederhana, panel aplikasi mampu menyajikan informasi yang berguna bagi pengguna, dan memberikan tampilan serta nuansa yang konsisten untuk aplikasi Android.

Gambar yang menampilkan panel aplikasi di aplikasi Now in Android
Gambar 1. Panel aplikasi dengan ikon tindakan di aplikasi "Now in Android".

Semua aktivitas yang menggunakan tema default memiliki ActionBar sebagai panel aplikasi. Fitur panel aplikasi ditambahkan ke ActionBar bawaan melalui berbagai rilis Android. Akibatnya, ActionBar bawaan berperilaku berbeda-beda, bergantung pada versi Android yang digunakan perangkat.

Di sisi lain, fitur ditambahkan ke Toolbar versi library AndroidX AppCompat, yang berarti fitur tersebut tersedia di perangkat yang menggunakan library AndroidX.

Karena alasan ini, gunakan class Toolbar library AndroidX untuk mengimplementasikan panel aplikasi aktivitas Anda. Menggunakan toolbar library AndroidX membuat perilaku aplikasi Anda konsisten di berbagai perangkat.

Menambahkan Toolbar ke Aktivitas

Langkah-langkah berikut menjelaskan cara menyiapkan Toolbar sebagai panel aplikasi aktivitas Anda:
  1. Tambahkan library AndroidX ke project Anda, seperti yang dijelaskan dalam Ringkasan AndroidX.
  2. Pastikan aktivitas memperluas AppCompatActivity:

    Kotlin

    class MyActivity : AppCompatActivity() {
  // ...
}

    Java

    public class MyActivity extends AppCompatActivity {
  // ...
}
  3. Dalam manifes aplikasi, tetapkan elemen <application> untuk menggunakan salah satu tema NoActionBar AppCompat, seperti yang ditunjukkan dalam contoh berikut. Penggunaan salah satu tema tersebut akan mencegah aplikasi agar tidak memakai class ActionBar native untuk menyediakan panel aplikasi. 
    <application
    android:theme="@style/Theme.AppCompat.Light.NoActionBar"
    />
  4. Tambahkan Toolbar ke tata letak aktivitas. Misalnya, kode tata letak berikut menambahkan Toolbar dan memberikan penampilan yang mengambang di atas aktivitas: 
    <androidx.appcompat.widget.Toolbar
   android:id="@+id/my_toolbar"
   android:layout_width="match_parent"
   android:layout_height="?attr/actionBarSize"
   android:background="?attr/colorPrimary"
   android:elevation="4dp"
   android:theme="@style/ThemeOverlay.AppCompat.ActionBar"
   app:popupTheme="@style/ThemeOverlay.AppCompat.Light"/>

    Lihat Spesifikasi Desain Material untuk mendapatkan rekomendasi terkait elevasi panel aplikasi.

    Tempatkan toolbar di bagian atas tata letak aktivitas layout, karena Anda menggunakannya sebagai panel aplikasi.

  5. Dalam metode aktivitas, panggil metode aktivitas dan teruskan toolbar aktivitas, seperti yang ditunjukkan dalam contoh berikut.onCreate()setSupportActionBar() Metode ini menetapkan toolbar sebagai panel aplikasi untuk aktivitas tersebut.

    Kotlin

    override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_my)
    // The Toolbar defined in the layout has the id "my_toolbar".
    setSupportActionBar(findViewById(R.id.my_toolbar))
}

    Java

    @Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_my);
    Toolbar myToolbar = (Toolbar) findViewById(R.id.my_toolbar);
    setSupportActionBar(myToolbar);
}

Kini aplikasi Anda memiliki panel tindakan dasar. Secara default, panel tindakan berisi nama aplikasi dan menu tambahan, yang awalnya berisi item Setelan. Anda dapat menambahkan tindakan lainnya ke panel tindakan dan menu tambahan, sebagaimana dijelaskan dalam Menambahkan dan menangani tindakan.

Menggunakan metode utilitas panel aplikasi

Setelah Anda menetapkan toolbar sebagai panel aplikasi aktivitas ini, Anda memiliki akses ke metode utilitas yang disediakan oleh class ActionBar library AndroidX. Pendekatan ini memungkinkan Anda melakukan hal-hal berguna, seperti menyembunyikan dan menampilkan panel aplikasi.

Untuk menggunakan metode utilitas ActionBar, panggil metode getSupportActionBar() aktivitas. Metode ini menampilkan referensi ke objek ActionBar AppCompat. Setelah Anda memiliki referensi tersebut, Anda dapat memanggil metode ActionBar untuk menyesuaikan panel aplikasi. Misalnya, untuk menyembunyikan panel aplikasi, panggil ActionBar.hide().