Tạo ảnh động cho các thay đổi về bố cục bằng khung chuyển đổi

Thử cách dùng Compose
Jetpack Compose là bộ công cụ giao diện người dùng được đề xuất cho Android. Tìm hiểu cách sử dụng Ảnh động trong Compose.

Khung chuyển đổi của Android cho phép bạn tạo ảnh động cho mọi loại chuyển động trong giao diện người dùng bằng cách cung cấp bố cục bắt đầu và kết thúc. Bạn có thể chọn loại ảnh động mà bạn muốn (chẳng hạn như làm mờ hoặc làm rõ thành phần hiển thị hoặc thay đổi kích thước thành phần hiển thị) và khung chuyển đổi sẽ xác định cách tạo ảnh động từ bố cục bắt đầu đến bố cục kết thúc.

Khung chuyển đổi bao gồm các tính năng sau:

  • Ảnh động cấp nhóm: áp dụng hiệu ứng ảnh động cho tất cả thành phần hiển thị trong hệ phân cấp thành phần hiển thị.
  • Ảnh động tích hợp: sử dụng ảnh động được xác định trước cho các hiệu ứng phổ biến như làm mờ hoặc chuyển động.
  • Hỗ trợ tệp tài nguyên: tải hệ phân cấp khung hiển thị và ảnh động tích hợp sẵn từ các tệp tài nguyên bố cục.
  • Lệnh gọi lại trong vòng đời: nhận lệnh gọi lại cung cấp quyền kiểm soát đối với quá trình thay đổi ảnh động và hệ phân cấp.

Để biết mã mẫu tạo ảnh động giữa các thay đổi về bố cục, hãy xem phần BasicTransition.

Quy trình cơ bản để tạo ảnh động giữa hai bố cục như sau:

  1. Tạo đối tượng Scene cho bố cục bắt đầu và kết thúc. Tuy nhiên, cảnh của bố cục bắt đầu thường được xác định tự động từ bố cục hiện tại.
  2. Tạo đối tượng Transition để xác định loại ảnh động bạn muốn.
  3. Gọi TransitionManager.go() và hệ thống sẽ chạy ảnh động để hoán đổi bố cục.

Sơ đồ trong hình 1 minh hoạ mối quan hệ giữa các bố cục, cảnh, hiệu ứng chuyển đổi và ảnh động cuối cùng.

Hình 1. Hình minh hoạ cơ bản về cách khung chuyển đổi tạo ảnh động.

Tạo cảnh

Cảnh lưu trữ trạng thái của hệ phân cấp khung hiển thị, bao gồm tất cả khung hiển thị và giá trị thuộc tính của các khung hiển thị đó. Khung chuyển đổi có thể chạy ảnh động giữa cảnh bắt đầu và cảnh kết thúc.

Bạn có thể tạo cảnh từ tệp tài nguyên bố cục hoặc từ một nhóm thành phần hiển thị trong mã. Tuy nhiên, cảnh bắt đầu cho hiệu ứng chuyển đổi thường được xác định tự động từ giao diện người dùng hiện tại.

Một cảnh cũng có thể xác định các hành động riêng chạy khi bạn thay đổi cảnh. Tính năng này hữu ích trong việc dọn dẹp chế độ cài đặt chế độ xem sau khi bạn chuyển đổi sang một cảnh.

Tạo cảnh từ tài nguyên bố cục

Bạn có thể tạo một thực thể Scene ngay từ tệp tài nguyên bố cục. Hãy sử dụng kỹ thuật này khi hệ phân cấp khung hiển thị trong tệp hầu như là tĩnh. Cảnh thu được thể hiện trạng thái của hệ phân cấp khung hiển thị tại thời điểm bạn tạo thực thể Scene. Nếu bạn thay đổi hệ phân cấp thành phần hiển thị, hãy tạo lại cảnh. Khung này tạo cảnh từ toàn bộ hệ phân cấp chế độ xem trong tệp. Bạn không thể tạo cảnh từ một phần của tệp bố cục.

Để tạo một thực thể Scene từ tệp tài nguyên bố cục, hãy truy xuất gốc cảnh từ bố cục dưới dạng ViewGroup. Sau đó, hãy gọi hàm Scene.getSceneForLayout() bằng thư mục gốc của cảnh và mã nhận dạng tài nguyên của tệp bố cục chứa hệ phân cấp khung hiển thị cho cảnh đó.

Xác định bố cục cho cảnh

Các đoạn mã trong phần còn lại của phần này cho biết cách tạo hai cảnh khác nhau với cùng một phần tử gốc của cảnh. Các đoạn mã này cũng minh hoạ rằng bạn có thể tải nhiều đối tượng Scene không liên quan mà không ngụ ý rằng các đối tượng này liên quan với nhau.

Ví dụ này bao gồm các định nghĩa sau đây về bố cục:

  • Bố cục chính của một hoạt động có nhãn văn bản và một FrameLayout con.
  • ConstraintLayout cho cảnh đầu tiên với hai trường văn bản.
  • ConstraintLayout cho cảnh thứ hai với cùng hai trường văn bản theo thứ tự khác nhau.

Ví dụ này được thiết kế để tất cả ảnh động đều xuất hiện trong bố cục con của bố cục chính của hoạt động. Nhãn văn bản trong bố cục chính vẫn ở dạng tĩnh.

Bố cục chính cho hoạt động được xác định như sau:

res/layout/activity_main.xml

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/master_layout">
    <TextView
        android:id="@+id/title"
        ...
        android:text="Title"/>
    <FrameLayout
        android:id="@+id/scene_root">
        <include layout="@layout/a_scene" />
    </FrameLayout>
</LinearLayout>

Định nghĩa bố cục này chứa một trường văn bản và một FrameLayout con cho gốc cảnh. Bố cục cho cảnh đầu tiên nằm trong tệp bố cục chính. Điều này cho phép ứng dụng hiển thị bố cục đó như một phần của giao diện người dùng ban đầu và cũng tải bố cục đó vào một cảnh, vì khung chỉ có thể tải toàn bộ tệp bố cục vào một cảnh.

Bố cục cho cảnh đầu tiên được xác định như sau:

res/layout/a_scene.xml

<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/scene_container"
    android:layout_width="match_parent"
    android:layout_height="match_parent" >
    
    
</androidx.constraintlayout.widget.ConstraintLayout>

Bố cục của cảnh thứ hai chứa hai trường văn bản giống nhau (có cùng mã nhận dạng) được đặt theo thứ tự khác nhau. Phương thức này được xác định như sau:

res/layout/another_scene.xml

<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/scene_container"
    android:layout_width="match_parent"
    android:layout_height="match_parent" >
    
    
</androidx.constraintlayout.widget.ConstraintLayout>

Tạo cảnh từ bố cục

Sau khi tạo định nghĩa cho hai bố cục ràng buộc, bạn có thể lấy một cảnh cho mỗi bố cục. Điều này cho phép bạn chuyển đổi giữa hai cấu hình giao diện người dùng. Để có được một cảnh, bạn cần tham chiếu đến thư mục gốc của cảnh và mã nhận dạng tài nguyên bố cục.

Đoạn mã sau đây cho biết cách tham chiếu đến thư mục gốc của cảnh và tạo hai đối tượng Scene từ các tệp bố cục:

Kotlin

val sceneRoot: ViewGroup = findViewById(R.id.scene_root)
val aScene: Scene = Scene.getSceneForLayout(sceneRoot, R.layout.a_scene, this)
val anotherScene: Scene = Scene.getSceneForLayout(sceneRoot, R.layout.another_scene, this)

Java

Scene aScene;
Scene anotherScene;

// Create the scene root for the scenes in this app.
sceneRoot = (ViewGroup) findViewById(R.id.scene_root);

// Create the scenes.
aScene = Scene.getSceneForLayout(sceneRoot, R.layout.a_scene, this);
anotherScene =
    Scene.getSceneForLayout(sceneRoot, R.layout.another_scene, this);

Trong ứng dụng, hiện có hai đối tượng Scene dựa trên hệ phân cấp khung hiển thị. Cả hai cảnh đều sử dụng thư mục gốc của cảnh do phần tử FrameLayout xác định trong res/layout/activity_main.xml.

Tạo một cảnh trong đoạn mã

Bạn cũng có thể tạo một thực thể Scene trong mã của mình từ đối tượng ViewGroup. Hãy sử dụng kỹ thuật này khi bạn sửa đổi hệ phân cấp khung hiển thị ngay trong mã hoặc khi tạo hệ phân cấp theo phương thức động.

Để tạo một cảnh từ hệ phân cấp thành phần hiển thị trong mã, hãy sử dụng hàm khởi tạo Scene(sceneRoot, viewHierarchy). Việc gọi hàm khởi tạo này tương đương với việc gọi hàm Scene.getSceneForLayout() khi bạn đã tăng cường tệp bố cục.

Đoạn mã sau đây minh hoạ cách tạo một thực thể Scene từ phần tử gốc của cảnh và hệ phân cấp thành phần hiển thị cho cảnh trong mã:

Kotlin

val sceneRoot = someLayoutElement as ViewGroup
val viewHierarchy = someOtherLayoutElement as ViewGroup
val scene: Scene = Scene(sceneRoot, viewHierarchy)

Java

Scene mScene;

// Obtain the scene root element.
sceneRoot = (ViewGroup) someLayoutElement;

// Obtain the view hierarchy to add as a child of
// the scene root when this scene is entered.
viewHierarchy = (ViewGroup) someOtherLayoutElement;

// Create a scene.
mScene = new Scene(sceneRoot, mViewHierarchy);

Tạo hành động trong cảnh

Khung này cho phép bạn xác định các thao tác với cảnh tuỳ chỉnh mà hệ thống chạy khi vào hoặc thoát khỏi một cảnh. Trong nhiều trường hợp, bạn không cần xác định thao tác cảnh tuỳ chỉnh vì khung sẽ tự động tạo ảnh động cho sự thay đổi giữa các cảnh.

Thao tác trong cảnh rất hữu ích để xử lý những trường hợp sau:

  • Để tạo ảnh động cho các thành phần hiển thị không thuộc cùng một hệ phân cấp. Bạn có thể tạo ảnh động cho các thành phần hiển thị của cảnh bắt đầu và kết thúc bằng cách sử dụng các thao tác thoát và nhập cảnh.
  • Để tạo ảnh động cho các thành phần hiển thị mà khung chuyển đổi không thể tự động tạo ảnh động, chẳng hạn như các đối tượng ListView. Để biết thêm thông tin, hãy xem phần các hạn chế.

Để cung cấp các thao tác tuỳ chỉnh cho cảnh, hãy xác định các thao tác của bạn dưới dạng đối tượng Runnable và truyền các thao tác đó đến hàm Scene.setExitAction() hoặc Scene.setEnterAction(). Khung này gọi hàm setExitAction() trên cảnh bắt đầu trước khi chạy ảnh động chuyển đổi và hàm setEnterAction() trên cảnh kết thúc sau khi chạy ảnh động chuyển đổi.

Áp dụng hiệu ứng chuyển đổi

Khung chuyển đổi thể hiện kiểu ảnh động giữa các cảnh bằng đối tượng Transition. Bạn có thể tạo bản sao Transition bằng các lớp con tích hợp sẵn, chẳng hạn như AutoTransitionFade, hoặc xác định hiệu ứng chuyển đổi của riêng bạn. Sau đó, bạn có thể chạy ảnh động giữa các cảnh bằng cách truyền Scene kết thúc và Transition đến TransitionManager.go().

Vòng đời chuyển đổi tương tự như vòng đời hoạt động và đại diện cho các trạng thái chuyển đổi mà khung theo dõi giữa thời điểm bắt đầu và hoàn tất ảnh động. Ở các trạng thái quan trọng trong vòng đời, khung này sẽ gọi các hàm gọi lại mà bạn có thể triển khai để điều chỉnh giao diện người dùng ở các giai đoạn chuyển đổi.

Tạo hiệu ứng chuyển cảnh

Phần trước cho biết cách tạo các cảnh thể hiện trạng thái của nhiều hệ phân cấp thành phần hiển thị. Sau khi xác định cảnh bắt đầu và kết thúc mà bạn muốn thay đổi, hãy tạo một đối tượng Transition xác định ảnh động. Khung này cho phép bạn chỉ định một hiệu ứng chuyển đổi tích hợp sẵn trong tệp tài nguyên và tăng cường nó trong mã hoặc tạo một thực thể của hiệu ứng chuyển đổi tích hợp trực tiếp trong mã.

Bảng 1. Các loại hiệu ứng chuyển đổi tích hợp sẵn.

Lớp Thẻ Hiệu ứng
AutoTransition <autoTransition/> Hiệu ứng chuyển đổi mặc định. Làm mờ, di chuyển, đổi kích thước và làm mờ các thành phần hiển thị theo thứ tự đó.
ChangeBounds <changeBounds/> Di chuyển và đổi kích thước thành phần hiển thị.
ChangeClipBounds <changeClipBounds/> Ghi lại View.getClipBounds() trước và sau khi cảnh thay đổi, đồng thời tạo ảnh động cho những thay đổi đó trong quá trình chuyển đổi.
ChangeImageTransform <changeImageTransform/> Ghi lại ma trận của ImageView trước và sau khi cảnh thay đổi, đồng thời tạo ảnh động cho ma trận đó trong quá trình chuyển đổi.
ChangeScroll <changeScroll/> Thu thập các thuộc tính cuộn của mục tiêu trước và sau khi cảnh thay đổi và tạo ảnh động cho mọi thay đổi.
ChangeTransform <changeTransform/> Ghi lại tỷ lệ và độ xoay của các thành phần hiển thị trước và sau khi thay đổi cảnh, đồng thời tạo ảnh động cho những thay đổi đó trong quá trình chuyển đổi.
Explode <explode/> Theo dõi các thay đổi đối với chế độ hiển thị của thành phần hiển thị mục tiêu trong cảnh bắt đầu và kết thúc, đồng thời di chuyển các thành phần hiển thị vào hoặc ra khỏi các cạnh của cảnh.
Fade <fade/> fade_in làm mờ các thành phần hiển thị.
fade_out làm mờ các thành phần hiển thị.
fade_in_out (mặc định) thực hiện fade_out, theo sau là fade_in.
Slide <slide/> Theo dõi các thay đổi đối với chế độ hiển thị của thành phần hiển thị mục tiêu trong cảnh bắt đầu và kết thúc, đồng thời di chuyển thành phần hiển thị vào hoặc ra khỏi một trong các cạnh của cảnh.

Tạo một thực thể chuyển đổi từ tệp tài nguyên

Kỹ thuật này cho phép bạn sửa đổi định nghĩa chuyển đổi mà không cần thay đổi mã của hoạt động. Kỹ thuật này cũng hữu ích khi tách riêng các định nghĩa hiệu ứng chuyển đổi phức tạp khỏi mã xử lý ứng dụng của bạn, như minh hoạ trong phần về chỉ định nhiều hiệu ứng chuyển đổi.

Để chỉ định một hiệu ứng chuyển đổi tích hợp sẵn trong tệp tài nguyên, hãy làm theo các bước sau:

  • Thêm thư mục res/transition/ vào dự án.
  • Tạo một tệp tài nguyên XML mới bên trong thư mục này.
  • Thêm một nút XML cho một trong các hiệu ứng chuyển đổi tích hợp.

Ví dụ: tệp tài nguyên sau đây chỉ định hiệu ứng chuyển đổi Fade:

res/transition/fade_transition.xml

<fade xmlns:android="http://schemas.android.com/apk/res/android" />

Đoạn mã sau đây cho biết cách tăng cường một thực thể Transition bên trong hoạt động của bạn từ một tệp tài nguyên:

Kotlin

var fadeTransition: Transition =
    TransitionInflater.from(this)
                      .inflateTransition(R.transition.fade_transition)

Java

Transition fadeTransition =
        TransitionInflater.from(this).
        inflateTransition(R.transition.fade_transition);

Tạo một thực thể chuyển đổi trong mã

Kỹ thuật này hữu ích để tạo các đối tượng chuyển đổi một cách linh động nếu bạn chỉnh sửa giao diện người dùng trong mã và để tạo các thực thể chuyển đổi tích hợp đơn giản với ít hoặc không có tham số.

Để tạo một thực thể của hiệu ứng chuyển đổi tích hợp, hãy gọi một trong các hàm khởi tạo công khai trong các lớp con của lớp Transition. Ví dụ: đoạn mã sau đây tạo một phiên bản của quá trình chuyển đổi Fade:

Kotlin

var fadeTransition: Transition = Fade()

Java

Transition fadeTransition = new Fade();

Áp dụng hiệu ứng chuyển đổi

Thông thường, bạn sẽ áp dụng một hiệu ứng chuyển đổi để thay đổi giữa các hệ phân cấp thành phần hiển thị khác nhau nhằm phản hồi một sự kiện, chẳng hạn như hành động của người dùng. Ví dụ: hãy xem xét một ứng dụng tìm kiếm: khi người dùng nhập một cụm từ tìm kiếm và nhấn vào nút tìm kiếm, ứng dụng sẽ thay đổi thành một cảnh thể hiện bố cục kết quả trong khi áp dụng hiệu ứng chuyển đổi làm mờ nút tìm kiếm và làm mờ kết quả tìm kiếm.

Để thay đổi cảnh trong khi áp dụng hiệu ứng chuyển đổi nhằm phản hồi một sự kiện trong hoạt động, hãy gọi hàm lớp TransitionManager.go() có cảnh kết thúc và thực thể chuyển đổi để sử dụng cho ảnh động, như minh hoạ trong đoạn mã sau:

Kotlin

TransitionManager.go(endingScene, fadeTransition)

Java

TransitionManager.go(endingScene, fadeTransition);

Khung này thay đổi hệ phân cấp thành phần hiển thị bên trong thư mục gốc của cảnh bằng hệ phân cấp thành phần hiển thị từ cảnh kết thúc trong khi chạy ảnh động do thực thể chuyển đổi chỉ định. Cảnh bắt đầu là cảnh kết thúc của hiệu ứng chuyển đổi gần đây nhất. Nếu không có quá trình chuyển đổi trước đó, cảnh bắt đầu sẽ được xác định tự động từ trạng thái hiện tại của giao diện người dùng.

Nếu bạn không chỉ định một thực thể chuyển đổi, thì trình quản lý chuyển đổi có thể áp dụng một chuyển đổi tự động thực hiện một số thao tác hợp lý trong hầu hết các trường hợp. Để biết thêm thông tin, hãy xem tài liệu tham khảo API cho lớp TransitionManager.

Chọn các chế độ xem mục tiêu cụ thể

Theo mặc định, khung này áp dụng hiệu ứng chuyển đổi cho tất cả thành phần hiển thị trong cảnh bắt đầu và kết thúc. Trong một số trường hợp, bạn chỉ muốn áp dụng ảnh động cho một nhóm nhỏ thành phần hiển thị trong một cảnh. Khung này cho phép bạn chọn các thành phần hiển thị cụ thể mà bạn muốn tạo ảnh động. Ví dụ: khung không hỗ trợ tạo ảnh động cho các thay đổi đối với đối tượng ListView, vì vậy, đừng cố tạo ảnh động cho các thay đổi đó trong quá trình chuyển đổi.

Mỗi thành phần hiển thị mà hiệu ứng chuyển đổi tạo ảnh động được gọi là mục tiêu. Bạn chỉ có thể chọn các mục tiêu thuộc hệ phân cấp thành phần hiển thị được liên kết với một cảnh.

Để xoá một hoặc nhiều thành phần hiển thị khỏi danh sách mục tiêu, hãy gọi phương thức removeTarget() trước khi bắt đầu quá trình chuyển đổi. Để chỉ thêm các thành phần hiển thị mà bạn chỉ định vào danh sách mục tiêu, hãy gọi hàm addTarget(). Để biết thêm thông tin, hãy xem tài liệu tham khảo API cho lớp Transition.

Chỉ định nhiều hiệu ứng chuyển đổi

Để ảnh động có tác động lớn nhất, hãy so khớp ảnh động với loại thay đổi xảy ra giữa các cảnh. Ví dụ: nếu bạn đang xoá một số thành phần hiển thị và thêm các thành phần hiển thị khác giữa các cảnh, thì ảnh động mờ dần hoặc mờ dần sẽ cho biết rõ rằng một số thành phần hiển thị không còn hoạt động nữa. Nếu bạn đang di chuyển các thành phần hiển thị đến nhiều điểm trên màn hình, tốt hơn hết bạn nên tạo ảnh động cho chuyển động để người dùng nhận thấy vị trí mới của các thành phần hiển thị.

Bạn không nhất thiết phải chọn một ảnh động, vì khung chuyển đổi cho phép bạn kết hợp các hiệu ứng ảnh động trong một nhóm chuyển đổi chứa một nhóm các hiệu ứng chuyển đổi tuỳ chỉnh hoặc tích hợp riêng lẻ.

Để xác định một nhóm chuyển đổi từ một tập hợp chuyển đổi trong XML, hãy tạo một tệp tài nguyên trong thư mục res/transitions/ và liệt kê các chuyển đổi trong phần tử TransitionSet. Ví dụ: Đoạn mã sau đây cho biết cách chỉ định một tập hợp chuyển đổi có cùng hành vi với lớp AutoTransition:

<transitionSet xmlns:android="http://schemas.android.com/apk/res/android"
    android:transitionOrdering="sequential">
    <fade android:fadingMode="fade_out" />
    <changeBounds />
    <fade android:fadingMode="fade_in" />
</transitionSet>

Để tăng cường hiệu ứng chuyển đổi thành đối tượng TransitionSet trong mã, hãy gọi hàm TransitionInflater.from() trong hoạt động. Lớp TransitionSet mở rộng từ lớp Transition, vì vậy, bạn có thể sử dụng lớp này với trình quản lý chuyển đổi giống như mọi thực thể Transition khác.

Áp dụng hiệu ứng chuyển đổi mà không cần cảnh

Thay đổi hệ phân cấp thành phần hiển thị không phải là cách duy nhất để sửa đổi giao diện người dùng. Bạn cũng có thể thực hiện thay đổi bằng cách thêm, sửa đổi và xoá thành phần hiển thị con trong hệ phân cấp hiện tại.

Ví dụ: bạn có thể triển khai một lượt tương tác tìm kiếm bằng một bố cục duy nhất. Bắt đầu với bố cục hiển thị trường nhập nội dung tìm kiếm và biểu tượng tìm kiếm. Để thay đổi giao diện người dùng để hiển thị kết quả, hãy xoá nút tìm kiếm khi người dùng nhấn vào nút đó bằng cách gọi hàm ViewGroup.removeView() và thêm kết quả tìm kiếm bằng cách gọi hàm ViewGroup.addView().

Bạn có thể sử dụng phương pháp này nếu phương án thay thế là có hai hệ phân cấp gần giống hệt nhau. Thay vì tạo và duy trì hai tệp bố cục riêng biệt cho một sự khác biệt nhỏ trong giao diện người dùng, bạn có thể có một tệp bố cục chứa hệ phân cấp khung hiển thị mà bạn sửa đổi trong mã.

Nếu thực hiện các thay đổi trong hệ phân cấp thành phần hiển thị hiện tại theo cách này, bạn không cần tạo cảnh. Thay vào đó, bạn có thể tạo và áp dụng hiệu ứng chuyển đổi giữa hai trạng thái của hệ phân cấp khung hiển thị bằng cách sử dụng quá trình chuyển đổi bị trì hoãn. Tính năng này của khung chuyển đổi bắt đầu bằng trạng thái hệ phân cấp thành phần hiển thị hiện tại, ghi lại các thay đổi mà bạn thực hiện đối với các thành phần hiển thị và áp dụng một hiệu ứng chuyển đổi tạo ảnh động cho các thay đổi đó khi hệ thống vẽ lại giao diện người dùng.

Để tạo hiệu ứng chuyển đổi bị trì hoãn trong một hệ thống phân cấp thành phần hiển thị, hãy làm theo các bước sau:

  1. Khi sự kiện kích hoạt quá trình chuyển đổi xảy ra, hãy gọi hàm TransitionManager.beginDelayedTransition(), cung cấp thành phần hiển thị gốc của tất cả thành phần hiển thị mà bạn muốn thay đổi và quá trình chuyển đổi sẽ sử dụng. Khung này lưu trữ trạng thái hiện tại của thành phần hiển thị con và giá trị thuộc tính của các thành phần đó.
  2. Chỉnh sửa thành phần hiển thị con theo yêu cầu của trường hợp sử dụng. Khung này sẽ ghi lại những thay đổi bạn thực hiện đối với thành phần hiển thị con và các thuộc tính tương ứng.
  3. Khi hệ thống vẽ lại giao diện người dùng theo các thay đổi của bạn, khung sẽ tạo ảnh động cho các thay đổi giữa trạng thái ban đầu và trạng thái mới.

Ví dụ sau đây cho biết cách tạo ảnh động cho việc thêm thành phần hiển thị văn bản vào hệ phân cấp thành phần hiển thị bằng cách sử dụng hiệu ứng chuyển đổi bị trì hoãn. Đoạn mã đầu tiên cho thấy tệp định nghĩa bố cục:

res/layout/activity_main.xml

<androidx.constraintlayout.widget.ConstraintLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/mainLayout"
    android:layout_width="match_parent"
    android:layout_height="match_parent" >
    <EditText
        android:id="@+id/inputText"
        android:layout_alignParentLeft="true"
        android:layout_alignParentTop="true"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintEnd_toEndOf="parent" />
    ...
</androidx.constraintlayout.widget.ConstraintLayout>

Đoạn mã tiếp theo hiển thị mã tạo ảnh động cho việc thêm khung hiển thị văn bản:

MainActivity

Kotlin

setContentView(R.layout.activity_main)
val labelText = TextView(this).apply {
    text = "Label"
    id = R.id.text
}
val rootView: ViewGroup = findViewById(R.id.mainLayout)
val mFade: Fade = Fade(Fade.IN)
TransitionManager.beginDelayedTransition(rootView, mFade)
rootView.addView(labelText)

Java

private TextView labelText;
private Fade mFade;
private ViewGroup rootView;
...
// Load the layout.
setContentView(R.layout.activity_main);
...
// Create a new TextView and set some View properties.
labelText = new TextView(this);
labelText.setText("Label");
labelText.setId(R.id.text);

// Get the root view and create a transition.
rootView = (ViewGroup) findViewById(R.id.mainLayout);
mFade = new Fade(Fade.IN);

// Start recording changes to the view hierarchy.
TransitionManager.beginDelayedTransition(rootView, mFade);

// Add the new TextView to the view hierarchy.
rootView.addView(labelText);

// When the system redraws the screen to show this update,
// the framework animates the addition as a fade in.

Xác định lệnh gọi lại trong vòng đời chuyển đổi

Vòng đời chuyển đổi tương tự như vòng đời hoạt động. Nó thể hiện các trạng thái chuyển đổi mà khung theo dõi trong khoảng thời gian từ lúc gọi hàm TransitionManager.go() đến khi hoàn tất ảnh động. Ở các trạng thái quan trọng trong vòng đời, khung sẽ gọi các lệnh gọi lại do giao diện TransitionListener xác định.

Lệnh gọi lại vòng đời chuyển đổi rất hữu ích, ví dụ: để sao chép giá trị thuộc tính khung hiển thị từ hệ phân cấp khung hiển thị bắt đầu sang hệ phân cấp khung hiển thị kết thúc trong khi thay đổi cảnh. Bạn không thể chỉ sao chép giá trị từ khung hiển thị bắt đầu sang khung hiển thị trong hệ phân cấp khung hiển thị kết thúc, vì hệ phân cấp khung hiển thị kết thúc sẽ chưa được tăng cường cho đến khi quá trình chuyển đổi hoàn tất. Thay vào đó, bạn cần lưu trữ giá trị trong một biến, sau đó sao chép giá trị đó vào hệ phân cấp thành phần hiển thị kết thúc khi khung đã hoàn tất quá trình chuyển đổi. Để được thông báo khi quá trình chuyển đổi hoàn tất, hãy triển khai hàm TransitionListener.onTransitionEnd() trong hoạt động của bạn.

Để biết thêm thông tin, hãy xem tài liệu tham khảo API cho lớp TransitionListener.

Các điểm hạn chế

Phần này liệt kê một số hạn chế đã biết của khung chuyển đổi:

  • Ảnh động áp dụng cho SurfaceView có thể không xuất hiện chính xác. Các thực thể SurfaceView được cập nhật từ một luồng không phải giao diện người dùng, vì vậy, các bản cập nhật có thể không đồng bộ với ảnh động của các thành phần hiển thị khác.
  • Một số loại chuyển đổi cụ thể có thể không tạo ra hiệu ứng ảnh động mong muốn khi áp dụng cho TextureView.
  • Các lớp mở rộng AdapterView (chẳng hạn như ListView) quản lý các khung hiển thị con theo cách không tương thích với khung chuyển đổi. Nếu bạn cố gắng tạo ảnh động cho một thành phần hiển thị dựa trên AdapterView, màn hình thiết bị có thể ngừng phản hồi.
  • Nếu bạn cố gắng đổi kích thước TextView bằng ảnh động, thì văn bản sẽ bật đến một vị trí mới trước khi đối tượng được đổi kích thước hoàn toàn. Để tránh vấn đề này, đừng tạo ảnh động đổi kích thước cho các thành phần hiển thị chứa văn bản.