android 半浮层框架,GitHub - Jodragon/AnyLayer: Android稳定高效的浮层创建管理框架
AnyLayer
Android穩(wěn)定高效的浮層創(chuàng)建管理框架。
可取代系統(tǒng)自帶Dialog/Popup/BottomSheet等彈窗，可實現(xiàn)單Activity架構(gòu)的Toast提示，可定制任意樣式的Guide引導層，可實現(xiàn)依附Activity的Float懸浮按鈕。
簡介
同時兼容support和androidx
鏈式調(diào)用
支持自由擴展
實現(xiàn)幾種常用效果
Dialog效果
占用區(qū)域不會超過當前Activity避免導航欄遮擋
支持自定義大小和顯示位置
支持自定義數(shù)據(jù)綁定
支持自定義進出場動畫
支持自定義背景顏色/圖片/高斯模糊
支持在Activity的onCreate生命周期彈出
支持從ApplicationContext中彈出
Popup效果
擁有Dialog效果特性
支持跟隨目標View移動
Toast效果
支持自定義圖標和文字
支持自定義顯示時長
支持自定義位置
支持自定義背景資源和顏色
支持自定義透明度
支持自定義進出場動畫
Guide效果
引導層效果待開發(fā)
Float效果
懸浮按鈕效果待開發(fā)
說明
詳細原理和使用說明本人會在后續(xù)補上，但因個人開發(fā)，時間不定，請諒解。
或有大佬在看過源碼后，愿意寫下分析文章或使用說明來分享的，歡迎聯(lián)系本人。寫得比較詳細的本人將會放到README中供大家查閱，提前謝過。
當然也歡迎加好友共同探討，共同進步。
QQ：302833254
QQ群：147715512(愛Android)
截圖
截圖效果較差且版本較老，建議下載Demo體驗最新功能
使用說明
集成
添加jitpack庫
// build.gradle(Project:)
allprojects {
repositories {
...
maven { url 'https://www.jitpack.io' }
}
}
添加依賴
引用時需注意版本號，從2.3.1版本開始，版本號前不加v。
通用庫為在2.4.0版本新增，有效引用為2.4.0~2.5.0之間版本。
從3.0.0版本開始，框架重構(gòu)，刪除通用庫。因重構(gòu)代碼變化較大，不建議使用較多的老項目升級，保持2.5.0版即可，在實現(xiàn)Dialog/Popup等效果上無本質(zhì)差別。
從3.1.0版本開始移除對support-v7的依賴，可同時兼容support和androidx
// build.gradle(Module:)
dependencies {
// 完整引入
implementation 'com.github.goweii:AnyLayer:3.2.0'
// 基礎庫
// implementation 'com.github.goweii.AnyLayer:anylayer:2.5.0'
// 通用彈窗(依賴基礎庫)
// 從3.0.0版本暫時刪除
// implementation 'com.github.goweii.AnyLayer:anylayer-common:2.5.0'
}
類間關(guān)系
類說明
AnyLayer
一個工廠效果的工具類，與Layer類族的關(guān)系就像Executors于Executor的關(guān)系這樣。
只是提供了靜態(tài)方法方便調(diào)用，不用new來new去的。
/**
* 初始化高斯模糊，可在用到高斯模糊背景的Activity的onCreate方法調(diào)用
* 其實不調(diào)用也沒關(guān)系，第一次顯示的時候也會初始化的，只是這樣第一次顯示就會比后面顯示稍微慢一點
*/
public static void initBlurred(Context context)
/**
* 回收高斯模糊內(nèi)存占用，可在用到高斯模糊背景的Activity的onDestroy方法調(diào)用，也可以在內(nèi)存不足時調(diào)用
*/
public static void recycleBlurred()
/**
* 創(chuàng)建一個DialogLayer
* 這個Context不能是ApplicationContext
*/
public static DialogLayer dialog(Context context)
/**
* 創(chuàng)建一個DialogLayer
* 依附的是當前顯示的Activity
*/
public static DialogLayer dialog()
/**
* 創(chuàng)建一個DialogLayer
* 依附的是特定Class的Activity實例，這個Activity必須是已經(jīng)啟動的
*/
public static DialogLayer dialog(Class clazz)
/**
* 創(chuàng)建一個DialogLayer
* 會啟動一個新的全透明Activity依附
*/
public static void dialog(LayerActivity.OnLayerCreatedCallback callback)
/**
* 創(chuàng)建一個PopupLayer
*/
public static PopupLayer popup(View targetView)
/**
* 創(chuàng)建一個ToastLayer
* 依附的是當前顯示的Activity
*/
public static ToastLayer toast()
/**
* 創(chuàng)建一個ToastLayer
* 這個Context不能是ApplicationContext
*/
public static ToastLayer toast(Context context)
ViewManager
這個就不介紹了吧？一般用的時候也用不到，后面原理剖析的時候再說吧！
Layer
上面類間關(guān)系簡單描述了一下
對ViewManager的包裝，實現(xiàn)進出場動畫邏輯和事件監(jiān)聽，規(guī)范接口形式，分離出ViewHolder/ListenerHolder/Config三大內(nèi)部類
可以看出這個類是所有效果的基類，有以下幾個特定：
對ViewManager的包裝
可以自由指定父布局和子布局，可以通過繼承在onGetParent和onCreateChild中返回，也可以通過parent()和child()方法設置。
其次是幾個生命周期回調(diào)方法
onAttach(View剛被添加到父布局)
onPreDraw(View開始繪制前，這里開始執(zhí)行進場動畫)
onShow(View顯示，進場動畫結(jié)束)
onPreRemove(View準備移除時，這里開始執(zhí)行出場動畫)
onDetach(View已被移除，出場動畫結(jié)束)
實現(xiàn)進出場動畫邏輯
在onPreDraw和onPreRemove中實現(xiàn)了進出場動畫的流程。可通過繼承在onCreateInAnimator和onCreateOutAnimator中返回，也可以通過animator()方法設置。
其中AnimatorCreator為創(chuàng)建自定義進出場動畫的接口
事件監(jiān)聽
有幾個常用的事件監(jiān)聽，在ListenerHolder中統(tǒng)一管理
DataBinder(綁定數(shù)據(jù))
OnClickListener(點擊事件監(jiān)聽)
OnShowListener(顯示動畫開始和結(jié)束監(jiān)聽)
OnDismissListener(消失時動畫開始和結(jié)束監(jiān)聽)
OnVisibleChangeListener(顯示隱藏狀態(tài)改變的監(jiān)聽)
分離出ViewHolder/ListenerHolder/Config三大內(nèi)部類
這個看名字應該就知道了，就不介紹了。
常用方法
/**
* 一組控制顯示隱藏的方法
*/
public void show()
public void show(boolean withAnim)
public void dismiss()
public void dismiss(boolean withAnim)
/**
* 判斷當前顯示隱藏狀態(tài)
*/
public boolean isShow()
/**
* 根據(jù)ID獲取對應View
*/
public V getView(int id)
/**
* 指定父布局
*/
public Layer parent(ViewGroup parent)
/**
* 指定子布局
*/
public Layer child(View child)
/**
* 自定義進出場動畫
*/
public Layer animator(AnimatorCreator creator)
/**
* 是否攔截物理按鍵，為true時cancelableOnKeyBack才有效
*/
public Layer interceptKeyEvent(boolean intercept)
/**
* 是否可點擊返回鍵關(guān)閉浮層，interceptKeyEvent為true才有效
*/
public Layer cancelableOnKeyBack(boolean cancelable)
/**
* 一組事件監(jiān)聽，見上面介紹
*/
public Layer bindData(DataBinder dataBinder)
public Layer onVisibleChangeListener(OnVisibleChangeListener onVisibleChangeListener)
public Layer onShowListener(OnShowListener onShowListener)
public Layer onDismissListener(OnDismissListener onDismissListener)
/**
* 點擊某些控件關(guān)閉浮層
*/
public Layer onClickToDismiss(OnClickListener listener, int... viewIds)
public Layer onClickToDismiss(int... viewIds)
/**
* 對控件綁定點擊事件
*/
public Layer onClick(OnClickListener listener, int... viewIds)
DecorLayer
繼承自Layer，強制父布局為DecorView。主要就是引入了Layer層級概念。
而這個層級就是由兩個靜態(tài)內(nèi)部類實現(xiàn)的
LayerLayout
繼承自FrameLayout，是各個層級浮層的容器，直接添加進DecorView。
LevelLayout
繼承自FrameLayout，定義了Level概念，是每個浮層的父布局，也就是在外面包了一層，用來控制浮層上下層級的容器。這個是直接添加進LayerLayout的。
好了就這么多了。更多了細節(jié)還是看源碼吧。
DialogLayer
這個就是模仿傳說中Dialog效果的浮層。用上面的描述就是：
規(guī)范子布局層級，加入背景層，分離動畫為背景動畫和內(nèi)容動畫
一個一個來看。
規(guī)范子布局層級，加入背景層
從DecorLayer的介紹中可以知道LevelLayout是該類浮層的直接父布局。但它并不是DialogLayer中contentView的直接父布局。就是因為又加了一個ViewGroup把contextView和background包裹起來。布局文件是這樣子的。
android:id="@+id/fl_container"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:clickable="true">
android:id="@+id/iv_background"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:scaleType="centerCrop"/>
android:id="@+id/fl_content_wrapper"
android:layout_width="match_parent"
android:layout_height="match_parent" />
contentView其實是直接添加至fl_content_wrapper中的。
分離動畫為背景動畫和內(nèi)容動畫
因為有了contextView和background的概念，原來的動畫就不好用了。所以從寫了動畫的創(chuàng)建邏輯，分離了背景和前景應用不同的動畫。
最后看下常用的方法。
/**
* 設置自定義布局View/資源ID
*/
public DialogLayer contentView(View contentView)
public DialogLayer contentView(int contentViewId)
/**
* 設置自定義布局文件中狀態(tài)欄的占位View
* 該控件高度將設置為狀態(tài)欄高度，可用來使布局整體下移，避免狀態(tài)欄遮擋
*/
public DialogLayer asStatusBar(int statusBarId)
/**
* 設置避開狀態(tài)欄
*/
public DialogLayer avoidStatusBar(boolean avoid)
/**
* 設置子布局的gravity
* 可直接在布局文件指定layout_gravity屬性，作用相同
*/
public DialogLayer gravity(int gravity)
/**
* 自定義浮層的進入和退出動畫
*/
public DialogLayer contentAnimator(AnimatorCreator contentAnimatorCreator)
/**
* 自定義背景的進入和退出動畫
*/
public DialogLayer backgroundAnimator(AnimatorCreator backgroundAnimatorCreator)
/**
* 設置背景高斯模糊/圖片/顏色
*/
public DialogLayer backgroundBlurRadius(float radius)
public DialogLayer backgroundBlurPercent(float percent)
public DialogLayer backgroundBlurScale(float scale)
public DialogLayer backgroundBitmap(Bitmap bitmap)
public DialogLayer backgroundDimAmount(float dimAmount)
public DialogLayer backgroundResource(int resource)
public DialogLayer backgroundDrawable(Drawable drawable)
public DialogLayer backgroundColorInt(int colorInt)
public DialogLayer backgroundColorRes(int colorRes)
/**
* 設置點擊浮層以外區(qū)域是否可關(guān)閉
*/
public DialogLayer cancelableOnTouchOutside(boolean cancelable)
/**
* 設置點擊返回鍵是否可關(guān)閉
*/
public DialogLayer cancelableOnClickKeyBack(boolean cancelable)
算了，再看下調(diào)用代碼湊湊字數(shù)把。
AnyLayer.dialog(this)
.contentView(R.layout.dialog_test_2)
.backgroundColorRes(R.color.dialog_bg)
.gravity(Gravity.CENTER)
.cancelableOnTouchOutside(true)
.cancelableOnClickKeyBack(true)
.bindData(new Layer.DataBinder() {
@Override
public void bindData(Layer layer) {
// TODO 綁定數(shù)據(jù)
}
})
.onClickToDismiss(R.id.fl_dialog_no)
.show();
PopupLayer
因為繼承自DialogLayer，所以可以使用定義過的方法(這不是廢話嗎)。
主要就是加入了可依據(jù)錨點View定位。
這個效果可能還要重構(gòu)，暫時就不介紹了。
看下其他新增方法。
/**
* 設置浮層外部是否攔截觸摸
* 默認為true，false則事件有activityContent本身消費
*/
public PopupLayer outsideInterceptTouchEvent(boolean intercept)
/**
* 是否裁剪contentView至包裹邊界
*/
public PopupLayer contentClip(boolean clip)
/**
* 是否偏移背景對齊目標控件
*/
public PopupLayer backgroundAlign(boolean align)
/**
* 背景應用offset設置
*/
public PopupLayer backgroundOffset(boolean offset)
/**
* 當以target方式創(chuàng)建時為參照View位置顯示
* 可自己指定浮層相對于參照View的對齊方式
*/
public PopupLayer align(Align.Direction direction,
Align.Horizontal horizontal,
Align.Vertical vertical,
boolean inside)
/**
* 指定浮層相對于參照View的對齊方式
*/
public PopupLayer direction(Align.Direction direction)
/**
* 指定浮層相對于參照View的對齊方式
*/
public PopupLayer horizontal(Align.Horizontal horizontal)
/**
* 指定浮層相對于參照View的對齊方式
*/
public PopupLayer vertical(Align.Vertical vertical)
/**
* 指定浮層是否強制位于屏幕內(nèi)部
*/
public PopupLayer inside(boolean inside)
/**
* X軸偏移
*/
public PopupLayer offsetX(float offsetX, int unit)
public PopupLayer offsetXdp(float dp)
public PopupLayer offsetXpx(float px)
/**
* Y軸偏移
*/
public PopupLayer offsetY(float offsetY, int unit)
public PopupLayer offsetYdp(float dp)
public PopupLayer offsetYpY(float px)
國際慣例，最后看下調(diào)用代碼湊湊字數(shù)。
AnyLayer.popup(targetView)
.contentView(R.layout.dialog_test_4)
.backgroundColorRes(R.color.dialog_bg)
.direction(Align.Direction.VERTICAL)
.horizontal(Align.Horizontal.CENTER)
.vertical(Align.Vertical.BELOW)
.inside(true)
.contentAnim(new LayerManager.IAnim() {
@Override
public Animator inAnim(View content) {
return AnimHelper.createTopInAnim(content);
}
@Override
public Animator outAnim(View content) {
return AnimHelper.createTopOutAnim(content);
}
})
.show();
ToastLayer
累了，這個寫簡單點，就看下調(diào)用代碼算了。
AnyLayer.toast()
.duration(3000)
.icon(isSucc ? R.drawable.ic_success : R.drawable.ic_fail)
.message(isSucc ? "哈哈，成功了" : "哎呀，失敗了")
.show();
GuideLayer
待實現(xiàn)
FloatLayer
待實現(xiàn)
總結(jié)
以上是生活随笔為你收集整理的android 半浮层框架,GitHub - Jodragon/AnyLayer: Android稳定高效的浮层创建管理框架的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： android平板交互,安卓平板就应该如
- 下一篇： 如何给Android添加可视化工具,可视