Menyiapkan panel aplikasi

Coba cara Compose
Jetpack Compose adalah toolkit UI yang direkomendasikan untuk Android. Pelajari cara menambahkan komponen di Compose.

Dalam bentuknya yang paling dasar, panel tindakan menampilkan judul aktivitas di satu sisi dan menu tambahan di sisi lainnya. Bahkan dalam bentuk dasar ini, panel aplikasi memberikan informasi yang berguna kepada pengguna serta memberikan tampilan dan nuansa yang konsisten untuk aplikasi Android.

Gambar yang menampilkan panel aplikasi di aplikasi Now di 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 native melalui berbagai rilis Android. Akibatnya, ActionBar native berperilaku berbeda bergantung pada versi Android yang digunakan perangkat.

Di sisi lain, fitur ditambahkan ke versi Toolbar 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. Penggunaan toolbar library AndroidX membuat perilaku aplikasi Anda konsisten di berbagai perangkat.

Menambahkan Toolbar ke Aktivitas

Langkah-langkah ini 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 ini akan mencegah aplikasi menggunakan 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 memberikannya tampilan 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, karena Anda menggunakannya sebagai panel aplikasi.

  5. Dalam metode onCreate() aktivitas, panggil metode setSupportActionBar() aktivitas dan teruskan toolbar aktivitas, seperti yang ditunjukkan dalam contoh berikut. 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 Settings. Anda dapat menambahkan tindakan lainnya ke panel tindakan dan menu tambahan, seperti yang dijelaskan dalam Menambahkan dan menangani tindakan.

Menggunakan metode utilitas panel aplikasi

Setelah menetapkan toolbar sebagai panel aplikasi aktivitas, Anda memiliki akses ke metode utilitas yang disediakan oleh class ActionBar library AndroidX. Pendekatan ini memungkinkan Anda melakukan hal-hal yang 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 memiliki referensi tersebut, Anda dapat memanggil salah satu metode ActionBar untuk menyesuaikan panel aplikasi. Misalnya, untuk menyembunyikan panel aplikasi, panggil ActionBar.hide().