# 在螢幕之間動畫顯示元件

> 如何將元件從一個螢幕動畫到另一個螢幕



<?code-excerpt path-base="cookbook/navigation/hero_animations"?>

當使用者在應用程式中從一個螢幕切換到另一個螢幕時，引導他們的操作通常會很有幫助。一個常見的技巧是將元件 (Widget) 從一個螢幕動畫到下一個螢幕。這樣可以在兩個螢幕之間建立一個視覺上的連結。

使用 [`Hero`][] 元件
可以將元件從一個螢幕動畫到另一個螢幕。
本教學將依照以下步驟進行：

  1. 建立兩個顯示相同圖片的螢幕。
  2. 在第一個螢幕加入 `Hero` 元件。
  3. 在第二個螢幕加入 `Hero` 元件。

## 1. 建立兩個顯示相同圖片的螢幕

在這個範例中，會在兩個螢幕上顯示相同的圖片。
當使用者點擊圖片時，將圖片從第一個螢幕動畫到第二個螢幕。目前先建立視覺結構，動畫的處理會在後續步驟說明。

:::note
本範例基於
[Navigate to a new screen and back][]
以及 [Handle taps][] 教學。
:::

<?code-excerpt "lib/main_original.dart"?>
```dart
import 'package:flutter/material.dart';

class MainScreen extends StatelessWidget {
  const MainScreen({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Main Screen')),
      body: GestureDetector(
        onTap: () {
          Navigator.push(
            context,
            MaterialPageRoute<void>(
              builder: (context) {
                return const DetailScreen();
              },
            ),
          );
        },
        child: Image.network('https://picsum.photos/250?image=9'),
      ),
    );
  }
}

class DetailScreen extends StatelessWidget {
  const DetailScreen({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: GestureDetector(
        onTap: () {
          Navigator.pop(context);
        },
        child: Center(
          child: Image.network('https://picsum.photos/250?image=9'),
        ),
      ),
    );
  }
}
```

## 2. 在第一個螢幕加入 `Hero` 元件

為了用動畫將兩個螢幕連接起來，請將兩個螢幕上的 `Image` 元件都包裹在 `Hero` 元件內。
`Hero` 元件需要兩個參數：

`tag`
: 一個用來識別 `Hero` 的物件。
  這個值在兩個螢幕上必須相同。

`child`
: 要在螢幕間執行動畫的元件。


<?code-excerpt "lib/main.dart (Hero1)" replace="/^child: //g;/^\),$/)/g"?>
```dart
Hero(
  tag: 'imageHero',
  child: Image.network('https://picsum.photos/250?image=9'),
)
```

## 3. 在第二個螢幕加入 `Hero` 元件

為了完成與第一個螢幕的連結，
請將第二個螢幕上的 `Image` 包裹在一個 `Hero` 元件中，
並且這個元件要有與第一個螢幕上 `Hero` 相同的 `tag`。

當你在第二個螢幕套用 `Hero` 元件後，
兩個螢幕之間的動畫就會自動運作。


<?code-excerpt "lib/main.dart (Hero2)" replace="/^child: //g;/^\),$/)/g"?>
```dart
Hero(
  tag: 'imageHero',
  child: Image.network('https://picsum.photos/250?image=9'),
)
```


:::note
這段程式碼與你在第一個螢幕上的內容相同。
作為最佳實踐，建議建立可重複使用的元件，
而不是重複撰寫程式碼。為了簡化說明，本範例在兩個
元件中都使用了相同的程式碼。
:::

## 互動式範例

<?code-excerpt "lib/main.dart"?>
```dartpad title="Flutter Hero animation hands-on example in DartPad" run="true"
import 'package:flutter/material.dart';

void main() => runApp(const HeroApp());

class HeroApp extends StatelessWidget {
  const HeroApp({super.key});

  @override
  Widget build(BuildContext context) {
    return const MaterialApp(title: 'Transition Demo', home: MainScreen());
  }
}

class MainScreen extends StatelessWidget {
  const MainScreen({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Main Screen')),
      body: GestureDetector(
        onTap: () {
          Navigator.push(
            context,
            MaterialPageRoute<void>(
              builder: (context) {
                return const DetailScreen();
              },
            ),
          );
        },
        child: Hero(
          tag: 'imageHero',
          child: Image.network('https://picsum.photos/250?image=9'),
        ),
      ),
    );
  }
}

class DetailScreen extends StatelessWidget {
  const DetailScreen({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      body: GestureDetector(
        onTap: () {
          Navigator.pop(context);
        },
        child: Center(
          child: Hero(
            tag: 'imageHero',
            child: Image.network('https://picsum.photos/250?image=9'),
          ),
        ),
      ),
    );
  }
}
```

<noscript>
  <img src="/assets/images/docs/cookbook/hero.webp" alt="Hero 範例展示" class="site-mobile-screenshot" />
</noscript>


[Handle taps]: /cookbook/gestures/handling-taps
[`Hero`]: https://api.flutter.dev/flutter/widgets/Hero-class.html
[Navigate to a new screen and back]: /cookbook/navigation/navigation-basics

