Android?Compose狀態(tài)改變動畫animateXxxAsState使用詳解
前言
上一篇文章我們探索了 Compose 中屬性動畫的使用，發(fā)現(xiàn)屬性動畫確實是可以在 Compose 中使用的，雖然使用方式跟傳統(tǒng) Android 開發(fā)中有所區(qū)別，但也不難用，甚至對于已經(jīng)熟悉了屬性動畫的我們來說學(xué)習(xí)成本更低，那么為什么 Compose 又要單獨搞一套 動畫 Api 呢？為了搞清楚這個問題，首先我們得先學(xué)會 Compose 動畫的使用。
實踐是檢驗真理的唯一標準，我們將從這一篇開始一步步深入學(xué)習(xí) Compose 動畫的使用，看看它到底好不好用。本篇將首先從animateXxxAsState這一組動畫 Api 開始進入 Compose 的動畫世界。
animateXxxAsState
在 Compose 中提供了一系列動畫 API，其中有一類 API 跟屬性動畫非常類似，它就是 animateXxxAsState，我翻譯成狀態(tài)改變動畫，其中 Xxx對應(yīng)的是 Dp、Float、Int、Size、Offset、Rect、IntOffset、IntSize、Color等數(shù)據(jù)類型，即當(dāng)狀態(tài)改變時觸發(fā)對應(yīng)數(shù)據(jù)類型的值的發(fā)生改變，從而執(zhí)行數(shù)據(jù)從當(dāng)前值到目標值變化的動畫。
對應(yīng) Api 如圖：
接下來就看看這些 Api 到底是如何使用的。
基礎(chǔ)使用
我們首先以 animateDpAsState為例來看一下 animateXxxAsState 動畫到底如何使用。
Dp是 Compose 提供的一個封裝數(shù)據(jù)類型，作用跟在傳統(tǒng) Android 開發(fā)中 xml 使用的 dp單位是一樣的，是與屏幕像素密度相關(guān)的抽象單位。Compose 中為其提供了基礎(chǔ)數(shù)據(jù)類型的擴展，可以直接使用數(shù)值.dp進行使用，如：10.dp、12.5.dp等。
在 Compose 中跟長度相關(guān)的參數(shù)類型基本上都是 Dp，如寬高、圓角、間距等等。
animateDpAsState的定義如下：
fun animateDpAsState(
targetValue: Dp,
animationSpec: AnimationSpec<Dp> = dpDefaultSpring,
finishedListener: ((Dp) -> Unit)? = null
): State<Dp>
參數(shù)說明：
- targetValue：目標值
- animationSpec：動畫規(guī)格
- finishedListener：動畫完成監(jiān)聽
返回值是一個 State 對象，即當(dāng)其內(nèi)部 value 值發(fā)生改變時會觸發(fā) Compose 的重組，從而刷新界面。
前面說了 animateXxxAsState 跟屬性動畫類似，但是好像不對呀，這里參數(shù)只有一個 targetValue即目標值，熟悉屬性動畫的都知道，屬性動畫的數(shù)值參數(shù)是一個可變參數(shù)，當(dāng)為 1 個的時候，初始值為屬性當(dāng)前值，目標值為傳入?yún)?shù)值，多個參數(shù)時初始值為第一個參數(shù)值，那這里只有一個 targetValue參數(shù)是不是也是初始值是從組件中獲取呢？
我們來試試，創(chuàng)建一個 Box 通過改變其左邊距實現(xiàn)向右移動的動畫：
val startPadding = animateDpAsState(10.dp)
Box(Modifier
.padding(start = startPadding.value, top = 10.dp)
.size(100.dp, 100.dp)
.background(Color.Blue)
)
因為需要對左邊距進行改變，所以將 padding 的 start 提取為 startPadding 變量，如上面的代碼，但是這樣的話那初始值就是 animateDpAsState傳入的值，也就是這里的 10.dp ，先運行一下看看是不是這樣：
運行效果確實是這樣，那怎么實現(xiàn)動畫效果呢？是修改 startPadding 的值么？我們給 Box 添加一個點擊事件修改 startPadding 的值看看：
val startPadding = animateDpAsState(10.dp)
Box(Modifier
.padding(start = startPadding.value, top = 10.dp)
.size(100.dp, 100.dp)
.background(Color.Blue)
// 添加點擊事件
.clickable {
// 修改值 報錯
startPadding.value = 100.dp
}
)
這樣寫編輯器直接報錯了，錯誤信息如下：
說 val 變量不能重新賦值，是因為 startPadding 變量定義成了 val 所以不能修改么？并不是，因為我們重新賦值的不是 startPadding 變量，而是其內(nèi)部的 value，而 startPadding 是 State 類型，State 內(nèi)部的 value 是 val 的，定義如下：
interface State<out T> {
val value: T
}
所以并不能通過重新賦值修改 animateDpAsState創(chuàng)建的 State 的 value 值，那么怎么修改這個值讓其產(chǎn)生動畫呢？
前面說了 animateXxxAsState 是依賴狀態(tài)改變而產(chǎn)生值的變化，所以實際上我們這里還需要定義一個額外的狀態(tài)變量，targetValue 參數(shù)根據(jù)這個狀態(tài)傳入不同的值，修改上面代碼如下：
@Composable
fun DpAnimationBox(){
// 是否移動到右邊
var moveToRight by remember { mutableStateOf(false) }
//根據(jù) moveToRight 變量傳入?yún)?shù)，true 代表在右邊則傳入 100.dp，false 在左邊則傳入 10.dp
val startPadding = animateDpAsState(if (moveToRight) 100.dp else 10.dp)
Box(Modifier
.padding(start = startPadding.value, top = 10.dp)
.size(100.dp, 100.dp)
.background(Color.Blue)
.clickable {
// 改變 moveToRight 狀態(tài)，這里直接取反
moveToRight = !moveToRight
}
)
}
修改點如下：
- 使用 mutableStateOf 創(chuàng)建 moveToRight 變量，內(nèi)部值為 Boolean 類型，即 MutableState，因為是在 Compose 函數(shù)中使用，需要用 remember 函數(shù)包裹，防止重組時重復(fù)創(chuàng)建
- 修改 animateDpAsState 傳入?yún)?shù)的固定值為根據(jù) moveToRight 傳入，即
if (moveToRight) 100.dp else 10.dp - 修改點擊事件處理，修改 moveToRight 的值
運行看一下效果：
終于有效果了。所以實際是根據(jù) moveToRight 的值改變導(dǎo)致傳入 animateDpAsState 的 targetValue 參數(shù)的值發(fā)生改變，而動畫執(zhí)行的就是之前舊的值到當(dāng)前設(shè)置最新值的動畫效果。
上面的 moveToRight 是 MutableState 類型， 內(nèi)部的 value 是 Boolean 類型，那是不是只能是 Boolean 類型呢，當(dāng)然不是，可以是任何類型，只要在傳入 animateDpAsState 的參數(shù)值時根據(jù)這個類型的值進行自定義條件判斷傳入不同的數(shù)據(jù)即可，比如定義一個枚舉類型，根據(jù)不同類型傳入不同的參數(shù)，如下：
enum class CustomState{
STATE1,
STATE2,
STATE3,
}
var customState by remember { mutableStateOf(CustomState.STATE1) }
val paddingValue = when(customState){
CustomState.STATE1 -> 0.dp
CustomState.STATE2 -> 100.dp
CustomState.STATE3 -> 200.dp
}
val startPadding = animateDpAsState(paddingValue)
甚至你可以直接創(chuàng)建一個跟動畫值相同的數(shù)據(jù)類型，比如這里可以直接創(chuàng)建一個 Dp 類型的狀態(tài)變量，然后在點擊時直接改變其值來驅(qū)動動畫執(zhí)行，如下：
@Composable
fun DpAnimationBox(){
// 動畫目標值
var startPaddingValue by remember { mutableStateOf(10.dp) }
// 蔣其設(shè)置給 animateDpAsState
val startPadding = animateDpAsState(startPaddingValue)
Box(Modifier
.padding(start = startPadding.value, top = 10.dp)
.size(100.dp)
.background(Color.Blue)
.clickable {
// 改變動畫目標值
if(startPaddingValue == 10.dp){
startPaddingValue = 100.dp
}else{
startPaddingValue = 10.dp
}
}
)
}
上面代碼同樣能實現(xiàn)跟之前一樣的效果。使用還是相當(dāng)靈活的，開發(fā)中可以根據(jù)實際的需求定義不同的狀態(tài)來完成我們想要的動畫效果。
動畫監(jiān)聽
animateXxxAsState提供了動畫完成時的監(jiān)聽 finishedListener，可以通過監(jiān)聽動畫完成進行自定義的業(yè)務(wù)處理，比如修改界面的顯示狀態(tài)或者開啟下一個動畫等。
比如 animateDpAsState的finishedListener 定義如下：
(Dp) -> Unit
有一個 Dp 類型的參數(shù)，即動畫完成時的目標值，使用如下：
val startPadding = animateDpAsState(if (moveToRight) 100.dp else 10.dp) {
//TODO: do something
}
比如我們想在上面的動畫結(jié)束時再讓方塊移動回去，那我們可以這么寫：
val startPadding = animateDpAsState(if (moveToRight) 100.dp else 10.dp) {
if(it == 100.dp){
moveToRight = false
}
}
效果如下：
或者我們想讓這個方塊往返重復(fù)執(zhí)行，可以這么寫：
val startPadding = animateDpAsState(if (moveToRight) 100.dp else 10.dp) {
moveToRight = !moveToRight
}
效果如下：
通過對 animateXxxAsState動畫的監(jiān)聽我們可以實現(xiàn)界面狀態(tài)的刷新或進行動畫的組合等自定義操作。
使用示例
前面講了 animateDpAsState動畫的使用，其他 animateXxxAsStateapi 的使用基本一樣，只是動畫作用的數(shù)據(jù)類型不一樣，下面將通過一個個簡單示例來看看其他幾個 api 的使用。
animateFloatAsState
animateFloatAsState作用于 Float 類型數(shù)據(jù)的動畫，比如 alpha 值，通過改變控件的 alpha 值可實現(xiàn)元素的顯示與隱藏，使用示例如下：
@Composable
fun FloatAnimationBox() {
var show by remember { mutableStateOf(true) }
val alpha by animateFloatAsState(if (show) 1f else 0f)
Box(Modifier
.padding(10.dp)
.size(100.dp)
.alpha(alpha)
.background(Color.Blue)
.clickable {
show = !show
}
)
}
動畫效果：
animateIntAsState
animateIntAsState作用于 Int 數(shù)據(jù)類型，上面的 animateDpAsState實現(xiàn)的動畫也可以使用 animateIntAsState實現(xiàn)，如下：
@Composable
fun IntAnimationBox() {
var moveToRight by remember { mutableStateOf(false) }
val startPadding by animateIntAsState(if (moveToRight) 100 else 10)
Box(Modifier
.padding(start = startPadding.dp, top = 10.dp)
.size(100.dp)
.background(Color.Blue)
.clickable {
moveToRight = !moveToRight
}
)
}
效果跟使用 animateDpAsState 實現(xiàn)的一樣：
animateColorAsState
animateColorAsState是作用于 Color 上，可實現(xiàn)顏色的過渡動畫，比如將上面的方塊顏色從藍色變?yōu)榧t色，代碼如下：
@Composable
fun ColorAnimationBox() {
var toRed by remember { mutableStateOf(false) }
val color by animateColorAsState(if (toRed) Color.Red else Color.Blue)
Box(Modifier
.padding(10.dp)
.size(100.dp)
.background(color)
.clickable {
toRed = !toRed
}
)
}
效果如下：
animateSizeAsState/animateIntSizeAsState
animateSizeAsState作用于 Size 上，看到這個我們一下就想到了用于控件的 size 上，比如上面的 Modifier.size()上，但實際上 Modifier.size()的參數(shù)并不是 Size 類型，而是 Dp 類型或者 DpSize，而 DpSize 并不是 Size 的子類，所以不能直接將 Size 類型的數(shù)據(jù)直接傳入 Modifier.size()中，而是需要轉(zhuǎn)換一下：
@Composable
fun SizeAnimationBox() {
var changeSize by remember { mutableStateOf(false) }
// 定義 Size 動畫
val size by animateSizeAsState(if (changeSize) Size(200f, 50f) else Size(100f, 100f))
Box(Modifier
.padding(10.dp)
// 設(shè)置 Size 值
.size(size.width.dp, size.height.dp)
.background(Color.Blue)
.clickable {
changeSize = !changeSize
}
)
}
效果如下：
animateIntSizeAsState 跟 animateSizeAsState幾乎一樣，只是它作用于 IntSize，跟 Size 的唯一區(qū)別就是參數(shù)是 Int 類型而不是 Float 類型，如下：
val size by animateIntSizeAsState(if (changeSize) IntSize(200, 50) else IntSize(100, 100))
animateOffsetAsState/animateIntOffsetAsState
animateOffsetAsState作用于 Offset 類型數(shù)據(jù)，用于控制偏移量，同樣的它不能直接用于 Modifier.offset()上，因為 Modifier.offset()接收的也是 Dp 類型參數(shù)，所以也需要進行轉(zhuǎn)換，如下：
@Composable
fun OffsetAnimationBox() {
var changeOffset by remember { mutableStateOf(false) }
// 定義 offset 動畫
val offset by animateOffsetAsState(if (changeOffset) Offset(100f, 100f) else Offset(0f, 0f))
Box(Modifier
// 設(shè)置 offset 數(shù)值
.offset(offset.x.dp, offset.y.dp)
.padding(10.dp)
.size(100.dp)
.background(Color.Blue)
.clickable {
changeOffset = !changeOffset
}
)
}
效果如下：
animateIntOffsetAsState則作用于 IntOffset類型數(shù)據(jù)，使用方法與上面一致，只是將 Float 類型換成 Int 類型：
val intOffset by animateIntOffsetAsState(if (changeOffset) IntOffset(100, 100) else IntOffset(0, 0))
Modifier.offset()提供了一個返回 IntOffset 的函數(shù)參數(shù)，可以如下使用：
Modifier.offset { intOffset }
animateRectAsState
animateRectAsState作用于 Rect數(shù)據(jù)，即可以同時控制位置和大小，通過 animateRectAsState可實現(xiàn)上面方塊的位置和大小變化的動畫，使用如下：
@Composable
fun RectAnimationBox() {
var changeRect by remember { mutableStateOf(false) }
// 定義 rect
val rect by animateRectAsState(if (changeRect) Rect(100f, 100f, 310f, 150f) else Rect(10f, 10f, 110f, 110f))
Box(Modifier
// 設(shè)置位置偏移
.offset(rect.left.dp, rect.top.dp)
// 設(shè)置大小
.size(rect.width.dp, rect.height.dp)
.background(Color.Blue)
.clickable {
changeRect = !changeRect
}
)
}
效果如下：
實戰(zhàn)
上面講了 animateXxxAsState動畫 api 的基本使用，下面就用這些 api 來完成一個實戰(zhàn)效果，還是上一篇《Compose 中屬性動畫的使用》的效果：
前面說了animateXxxAsState是依賴于狀態(tài)的動畫，分析上面的動畫一共存在 4 個狀態(tài)：
- 默認狀態(tài)：顯示藍色矩形按鈕，文字為 Upload
- 開始上傳狀態(tài)：按鈕變?yōu)閳A形且中間為白色，邊框為灰色，文字消失
- 上傳中狀態(tài)：邊框根據(jù)進度變?yōu)樗{色
- 上傳完成狀態(tài)：按鈕從圓形回到圓角矩形，且顏色變?yōu)榧t色，文字變?yōu)?Success
實現(xiàn)原理如下：
首先通過一個枚舉定義上述四種狀態(tài)：
enum class UploadState {
Normal,
Start,
Uploading,
Success
}
然后實現(xiàn)默認狀態(tài)的界面展示：
@Composable
fun UploadAnimation() {
val originWidth = 180.dp
val circleSize = 48.dp
var uploadState by remember { mutableStateOf(UploadState.Normal) }
var text by remember { mutableStateOf("Upload") }
val textAlpha by animateFloatAsState(1f)
val backgroundColor by animateColorAsState(Color.Blue)
val boxWidth by animateDpAsState(originWidth)
val progressAlpha by animateFloatAsState(0f)
val progress by animateIntAsState(0)
// 界面布局
Box(
modifier = Modifier
.padding(start = 10.dp, top = 10.dp)
.width(originWidth),
contentAlignment = Alignment.Center
) {
// 按鈕
Box(
modifier = Modifier
.clip(RoundedCornerShape(circleSize / 2))
.background(backgroundColor)
.size(boxWidth, circleSize)
.clickable {
// 點擊時修改狀態(tài)為開始上傳
uploadState = UploadState.Start
},
contentAlignment = Alignment.Center,
) {
// 進度
Box(
modifier = Modifier.size(circleSize).clip(ArcShape(progress))
.alpha(progressAlpha).background(Color.Blue)
)
// 白色蒙版
Box(
modifier = Modifier.size(40.dp).clip(RoundedCornerShape(20.dp))
.alpha(progressAlpha).background(Color.White)
)
// 文字
Text(text, color = Color.White, modifier = Modifier.alpha(textAlpha))
}
}
}
然后根據(jù)上傳按鈕的狀態(tài)定義不同狀態(tài)時的數(shù)據(jù)值：
var textAlphaValue = 1f
var backgroundColorValue = Color.Blue
var boxWidthValue = originWidth
var progressAlphaValue = 0f
var progressValue = 0
when (uploadState) {
// 默認狀態(tài)不處理
UploadState.Normal -> {}
// 開始上傳
UploadState.Start -> {
// 文字透明度變?yōu)?
textAlphaValue = 0f
// 按鈕背景顏色變?yōu)榛疑?
backgroundColorValue = Color.Gray
// 按鈕寬度變?yōu)閳A的寬度
boxWidthValue = circleSize
// 中間進度的透明度變?yōu)?1
progressAlphaValue = 1f
}
// 上傳中狀態(tài)
UploadState.Uploading -> {
textAlphaValue = 0f
backgroundColorValue = Color.Gray
boxWidthValue = circleSize
progressAlphaValue = 1f
// 進度值變?yōu)?100
progressValue = 100
}
// 上傳完成
UploadState.Success -> {
// 文字透明度變?yōu)?1
textAlphaValue = 1f
// 顏色變?yōu)榧t色
backgroundColorValue = Color.Red
// 按鈕寬度變化默認時的原始寬度
boxWidthValue = originWidth
// 進度透明度變?yōu)?0f
progressAlphaValue = 0f
}
}
val textAlpha by animateFloatAsState(textAlphaValue)
val backgroundColor by animateColorAsState(backgroundColorValue)
val boxWidth by animateDpAsState(boxWidthValue)
val progressAlpha by animateFloatAsState(progressAlphaValue)
val progress by animateIntAsState(progressValue)
此時運行后點擊按鈕效果如下：
點擊后只有開始上傳的動畫，沒有后續(xù)的動畫效果，這是因為我們在點擊的時候只是將狀態(tài)變?yōu)榱?UploadState.Start 而沒有進行后續(xù)狀態(tài)的改變，所以需要監(jiān)聽動畫完成然后繼續(xù)改變按鈕的狀態(tài)來實現(xiàn)完整的動畫效果，代碼修改如下：
val boxWidth by animateDpAsState(boxWidthValue){
// 按鈕寬度變化完成監(jiān)聽，當(dāng)狀態(tài)為 Start 則修改為 Uploading
if(uploadState == UploadState.Start){
uploadState = UploadState.Uploading
}
}
val progress by animateIntAsState(progressValue){
// 進度完成監(jiān)聽，當(dāng)狀態(tài)為 Uploading 則修改為 Success
if(uploadState == UploadState.Uploading){
uploadState = UploadState.Success
// 文字內(nèi)容修改為 Success
text = "Success"
}
}
分別給按鈕寬度變化動畫和進度動畫進行監(jiān)聽并修改其狀態(tài)，這樣就將整個動畫串聯(lián)起來了，最終效果如下：
最后
關(guān)于 animateXxxAsState的基本使用就講得差不多了，并通過一系列 api 完成了上一篇使用屬性動畫實現(xiàn)的效果，細心的同學(xué)會發(fā)現(xiàn)關(guān)于 animateXxxAsState 其實還有兩個知識點是沒有介紹到的：
animateXxxAsState還有一個 apianimateValueAsStateanimateXxxAsState的參數(shù)animationSpec參數(shù)
其中 animateValueAsState是 animateXxxAsState 的底層 api，上面介紹的一系列 animateXxxAsState 最終都是調(diào)用 animateValueAsState 來實現(xiàn)，關(guān)于 animateValueAsState 我們將在下一篇進行詳細介紹。animationSpec是對動畫進行更詳細的配置，比如動畫的時間、速度曲線等，將在后續(xù)文章中詳細介紹
以上就是Android Compose狀態(tài)改變動畫animateXxxAsState使用詳解的詳細內(nèi)容，更多關(guān)于Android Compose狀態(tài)改變動畫的資料請關(guān)注腳本之家其它相關(guān)文章！
相關(guān)文章
Notification，俗稱通知，是一種具有全局效果的通知，它展示在屏幕的頂端，首先會表現(xiàn)為一個圖標的形式，當(dāng)用戶向下滑動的時候，展示出通知具體的內(nèi)容2016-01-01
這篇文章主要介紹了Android串口操作方法實例,本文共分5個步驟講解了Android串口操作方法,并給出代碼實例,需要的朋友可以參考下2015-04-04
Android獲取所在時區(qū)正確時間的方式有兩種,通過wifi獲取時間和通過通過GPS獲取時間這兩種方式,文中通過代碼示例給大家的介紹的非常詳細,需要的朋友可以參考下2024-04-04
Flutter?的圖片選擇插件很多，包括了官方的?image_picker，multi_image_picker（基于2.0出了?multi_image_picker2）等等。本文將利用這些插件實現(xiàn)圖片選擇和圖片上傳，需要的可以參考一下2022-03-03
Android編程實現(xiàn)設(shè)置TabHost當(dāng)中字體的方法
這篇文章主要介紹了Android編程實現(xiàn)設(shè)置TabHost當(dāng)中字體的方法,涉及Android針對TabHost屬性操作的相關(guān)技巧,非常簡單實用,需要的朋友可以參考下2015-12-12
Android EditText監(jiān)聽回車鍵并處理兩次回調(diào)問題
這篇文章主要介紹了Android EditText監(jiān)聽回車鍵并處理兩次回調(diào)問題,小編覺得挺不錯的，現(xiàn)在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2018-08-08
這篇文章主要介紹了Android中Socket的應(yīng)用,結(jié)合實例形式分析了Android中socket通信的實現(xiàn)技巧與相關(guān)注意事項,需要的朋友可以參考下2016-10-10
Android?ViewStub使用方法學(xué)習(xí)
這篇文章主要為大家介紹了Android?ViewStub使用方法學(xué)習(xí)，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進步，早日升職加薪2022-11-11
Android編程判斷當(dāng)前應(yīng)用是否在后臺運行的方法示例
這篇文章主要介紹了Android編程判斷當(dāng)前應(yīng)用是否在后臺運行的方法,涉及Android針對當(dāng)前程序運行狀態(tài)相關(guān)屬性操作與判定技巧,需要的朋友可以參考下2018-03-03
Android 實現(xiàn)定時器的四種方式總結(jié)及實現(xiàn)實例
這篇文章主要介紹了Android 實現(xiàn)定時器的四種方式總結(jié)及實現(xiàn)實例的相關(guān)資料,這里對定時器進行詳解，并附實例代碼，需要的朋友可以參考下2016-12-12