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 dasar, panel tindakan menampilkan judul aktivitas di satu dan menu tambahan di sisi lainnya. Bahkan dalam bentuk dasar ini, bilah aplikasi menyediakan informasi yang berguna bagi pengguna dan memberikan tampilan serta nuansa yang konsisten bagi aplikasi Android.

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

Semua aktivitas yang menggunakan tema default memiliki ActionBar sebagai aplikasi . Fitur panel aplikasi ditambahkan ke ActionBar native melalui berbagai Rilis Android. Akibatnya, ActionBar native berperilaku berbeda tergantung pada versi Android yang digunakan perangkat.

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

Gunakan class Toolbar library AndroidX untuk mengimplementasikan aktivitas Anda panel aplikasi karena alasan ini. Menggunakan toolbar library AndroidX membuat perilaku yang konsisten di berbagai jenis perangkat.

Menambahkan Toolbar ke Aktivitas

Langkah-langkah ini menjelaskan cara menyiapkan Toolbar sebagai panel aplikasi aktivitas Anda:

1. Menambahkan library AndroidX ke project, seperti yang dijelaskan di Ringkasan AndroidX.
2. Pastikan aktivitas meluas AppCompatActivity:

   Kotlin

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

   Java

   public class MyActivity extends AppCompatActivity {
     // ...
   }
   

   Catatan: Lakukan perubahan ini untuk setiap aktivitas di aplikasi Anda yang menggunakan Toolbar sebagai panel aplikasi.
3. Dalam manifes aplikasi, setel atribut <application> untuk menggunakan salah satu NoActionBar tema, seperti yang ditunjukkan dalam contoh berikut. Menggunakan salah satu tema ini akan mencegah aplikasi dari 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 menambahkan Toolbar dan memberikan 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.

   Posisikan toolbar di bagian atas aktivitas layout, karena Anda menggunakan sebagai panel aplikasi.

5. Di aktivitas onCreate() , panggil metode setSupportActionBar() dan meneruskan toolbar aktivitas, seperti ditunjukkan dalam contoh berikut. Ini akan menyetel 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, seperti yang dijelaskan dalam Menambahkan dan menangani tindakan.

Menggunakan metode utilitas panel aplikasi

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

Untuk menggunakan metode utilitas ActionBar, panggil metode getSupportActionBar() . 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 bilah aplikasi, panggil ActionBar.hide().