iT邦幫忙

2024 iThome 鐵人賽

DAY 25
0
Mobile Development

Jetpack Compose 從心開始系列 第 25

Jetpack Compose 從心開始 Day25 - 使用可組合項預覽預覽 UI

  • 分享至 

  • xImage
  •  

前言

    可組合項預覽 是一個強大的功能,讓開發者能在 Android Studio 中直接預覽 Jetpack Compose 所建立的 UI,無需執行整個應用程式。

如何使用可組合項預覽

建立可組合函式:

定義一個可組合函式,這個函式將代表你想要預覽的 UI 部分。
使用 @Composable 注解標記這個函式。

@Composable
fun Greeting3(name: String, modifier: Modifier = Modifier) {
    Text(
        text = "Hello $name!",
        modifier = modifier
    )
}

添加 @Preview 注解:

在可組合函式的上方添加 @Preview 注解,以指定預覽的配置。

@Preview
@Composable
fun GreetingPreview4() {
        Greeting3("Compose Preview")
}

在 Android Studio 中查看預覽

Android Studio 會自動偵測到帶有 @Preview 注解的可組合函式,並在設計編輯器中顯示預覽。
https://ithelp.ithome.com.tw/upload/images/20241005/201216432vnfOYCm7w.png

自訂預覽

設定裝置和系統:

  • 使用 @Preview 注解的參數 showBackground = true 來顯示背景。
  • 使用 device = Devices.PIXEL_4 來指定預覽的裝置。
  • 使用 uiMode = Configuration.UI_MODE_NIGHT_YES 來模擬夜間模式。
@Preview(showBackground = true, device = Devices.PIXEL_4, uiMode = Configuration.UI_MODE_NIGHT_YES)
@Composable
fun GreetingPreview4() {
        Greeting3("Compose Preview")
}

多個預覽:

可以為同一個可組合函式定義多個 @Preview 注解,以查看不同配置下的效果。

動態參數:

可以使用 @PreviewParameter 注解來提供動態的參數值,以測試不同輸入下的 UI 行為。

執行結果

https://ithelp.ithome.com.tw/upload/images/20241005/20121643aTODYv0yL4.png

心得

善用 @Preview 可以讓開發時就可以所看及所得,還可以同時看到不同條件的UI ,是不是很方便呢?


上一篇
Jetpack Compose 從心開始 Day24 - 配合不同的螢幕大小進行調整
下一篇
Jetpack Compose 從心開始 Day26 - 開發與偵錯
系列文
Jetpack Compose 從心開始30
圖片
  直播研討會
圖片
{{ item.channelVendor }} {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言