Google berkomitmen untuk mendorong terwujudnya keadilan ras bagi komunitas Kulit Hitam. Lihat caranya.

Menyiapkan 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 membantu memberikan tampilan serta nuansa yang konsisten untuk aplikasi Android.

Gambar 1. Panel aplikasi dengan judul aplikasi dan menu tambahan.

Mulai Android 3.0 (API level 11), seluruh aktivitas yang menggunakan tema default memiliki ActionBar sebagai panel aplikasi. Namun, fitur panel aplikasi secara bertahap telah ditambahkan ke ActionBar bawaan melalui berbagai rilis Android. Sebagai hasilnya, ActionBar bawaan berperilaku berbeda bergantung pada versi sistem Android yang digunakan perangkat. Sebaliknya, fitur terbaru ditambahkan ke support library versi Toolbar, dan mereka tersedia pada setiap perangkat yang dapat menggunakan support library.

Untuk alasan ini, Anda sebaiknya menggunakan support library class Toolbar untuk mengimplementasikan aktivitas panel aplikasi Anda. Penggunaan toolbar support library membantu memastikan agar aplikasi Anda memiliki perilaku yang konsisten di berbagai perangkat. Misalnya, widget Toolbar memberikan pengalaman desain material pada perangkat yang menjalankan Android 2.1 (API level 7) atau yang lebih baru, namun panel tindakan bawaan tidak mendukung desain material kecuali perangkat tersebut menjalankan Android 5.0 (API level 21) atau yang lebih baru.

Menambahkan Toolbar ke Aktivitas

Langkah-langkah ini menjelaskan cara menyiapkan Toolbar sebagai panel aplikasi aktivitas Anda:
  1. Tambahkan support library v7 appcompat ke project Anda, seperti yang dijelaskan dalam Penyiapan Support Library.
  2. Pastikan aktivitas mencakup AppCompatActivity:

    Kotlin

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

    Java

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

    Catatan: Lakukan perubahan ini pada setiap aktivitas dalam aplikasi Anda yang menggunakan Toolbar sebagai panel aplikasi.

  3. Dalam manifes aplikasi, tetapkan elemen <application> untuk menggunakan salah satu tema NoActionBar appcompat. Menggunakan satu dari tema ini mencegah aplikasi menggunakan class ActionBar bawaan untuk menyediakan panel aplikasi. Contoh:
        <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:
        <android.support.v7.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 ini. Metode ini menetapkan toolbar sebagai panel aplikasi untuk aktivitas tersebut. Contoh:

    Kotlin

        override fun onCreate(savedInstanceState: Bundle?) {
            super.onCreate(savedInstanceState)
            setContentView(R.layout.activity_my)
            // Note that 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 hanya berisi nama aplikasi dan menu tambahan. Awalnya, menu opsi hanya 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 berbagai metode utilitas yang disediakan oleh class ActionBar dari support library appcompat v7. Pendekatan ini memungkinkan Anda melakukan beberapa hal berguna, seperti menyembunyikan dan menampilkan panel aplikasi.

Untuk menggunakan metode utilitas ActionBar, panggil metode getSupportActionBar() aktivitas. Metode ini mengembalikan 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().