Thiết lập thanh ứng dụng

Ở dạng cơ bản nhất, thanh thao tác hiển thị tiêu đề của hoạt động ở một bên và trình đơn mục bổ sung ở bên kia. Ngay cả ở dạng cơ bản này, thanh ứng dụng vẫn cung cấp thông tin hữu ích cho người dùng và mang lại giao diện nhất quán cho các ứng dụng Android.

Tất cả hoạt động sử dụng giao diện mặc định đều có ActionBar làm thanh ứng dụng. Các tính năng của thanh ứng dụng được thêm vào ActionBar gốc trên nhiều bản phát hành Android. Do đó, ActionBar gốc sẽ hoạt động theo cách khác nhau tuỳ thuộc vào phiên bản Android mà thiết bị đang sử dụng.

Mặt khác, các tính năng được thêm vào phiên bản Toolbar của thư viện AndroidX AppCompat, nghĩa là các tính năng đó có trên các thiết bị sử dụng thư viện AndroidX.

Vì lý do này, hãy sử dụng lớp Toolbar của thư viện AndroidX để triển khai thanh ứng dụng của các hoạt động. Việc sử dụng thanh công cụ của thư viện AndroidX giúp hành vi của ứng dụng nhất quán trên nhiều thiết bị nhất.

Thêm Thanh công cụ vào một Hoạt động

Các bước sau đây mô tả cách thiết lập Toolbar làm thanh ứng dụng của hoạt động:

1. Thêm thư viện AndroidX vào dự án của bạn như mô tả trong bài viết Tổng quan về AndroidX.
2. Đảm bảo hoạt động mở rộng AppCompatActivity:

   Kotlin

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

   Java

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

3. Trong tệp kê khai ứng dụng, hãy đặt phần tử <application> để sử dụng một trong các giao diện NoActionBar của AppCompat, như minh hoạ trong ví dụ sau. Việc sử dụng một trong các giao diện này sẽ ngăn ứng dụng sử dụng lớp ActionBar gốc để cung cấp thanh ứng dụng.

   <application
       android:theme="@style/Theme.AppCompat.Light.NoActionBar"
       />

4. Thêm Toolbar vào bố cục của hoạt động. Ví dụ: mã bố cục sau đây thêm một Toolbar và tạo cho thành phần này giao diện nổi trên hoạt động:

   <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"/>

   Xem thông số kỹ thuật của Material Design để biết các đề xuất về độ cao của thanh ứng dụng.

   Đặt thanh công cụ ở đầu bố cục của hoạt động vì bạn đang sử dụng thanh công cụ này làm thanh ứng dụng.

5. Trong phương thức onCreate() của hoạt động, hãy gọi phương thức setSupportActionBar() của hoạt động và chuyển thanh công cụ của hoạt động như minh hoạ trong ví dụ sau. Phương thức này đặt thanh công cụ làm thanh ứng dụng cho hoạt động.

   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);
   }

Ứng dụng của bạn hiện có một thanh thao tác cơ bản. Theo mặc định, thanh thao tác chứa tên của ứng dụng và một trình đơn mục bổ sung, ban đầu chứa mục Cài đặt. Bạn có thể thêm các thao tác khác vào thanh thao tác và trình đơn mục bổ sung, như mô tả trong phần Thêm và xử lý thao tác.

Sử dụng các phương thức tiện ích của thanh ứng dụng

Sau khi đặt thanh công cụ làm thanh ứng dụng của một hoạt động, bạn sẽ có quyền truy cập vào các phương thức tiện ích do lớp ActionBar của thư viện AndroidX cung cấp. Phương pháp này cho phép bạn thực hiện những việc hữu ích, chẳng hạn như ẩn và hiện thanh ứng dụng.

Để sử dụng các phương thức tiện ích ActionBar, hãy gọi phương thức getSupportActionBar() của hoạt động. Phương thức này trả về một tệp tham chiếu đến đối tượng ActionBar AppCompat. Sau khi có tham chiếu đó, bạn có thể gọi bất kỳ phương thức ActionBar nào để điều chỉnh thanh ứng dụng. Ví dụ: để ẩn thanh ứng dụng, hãy gọi ActionBar.hide().