一分鐘實現Android遮罩引導視圖
一分鐘實現Android遮罩引導視圖,供大家參考,具體內容如下
先看一下效果圖

主角GuideView登場!
GuideView是一種基于DialogFragment實現的引導遮罩浮層視圖的輕量級解決方案,它具備以下的特性:
- 響應導航按鈕的動作(因為引導浮層本質是一個dialog);
- 鏈式引導層,支持設定一組的引導遮罩視圖,通過點擊切換下一個試圖,快讀與業(yè)務進行解藕;
- 自動繪制半透明浮層、透明核心區(qū)以及確保目標視圖和引導視圖的位置。
實現說明
頁面的結構如下圖所示:

核心類
GuideViewBundle
引導視圖的配置項類,每一頁引導視圖對應一個配置項。在GuideView內部通過這個配置項去構造GuideView的實例,并通過GuideViewFragment顯示在界面上。
其中的屬性都通過構造器的模式,通過靜態(tài)內部類Builder進行構建,屬性說明如下:
targetView
引導視圖需要顯示附著的目標視圖
hintView
引導視圖(不包含半透明浮層以及透明焦點區(qū))
transparentSpaceXXX
默認的情況下,透明焦點區(qū)的大小跟目標視圖的大小保持一致,如果需要加大透明區(qū)域的大小,可以通過設置這組屬性,指定上下左右的額外的空白區(qū)域
hintViewMarginXXX
引導視圖(hintView)相對于目標視圖(targetView)的邊距
hasTransparentLayer
是否顯示透明焦點區(qū)域,默認顯示??梢赃x擇不繪制透明焦點區(qū)域而只有半透明的浮層
hintViewDirection
引導視圖(hintView)相對于目標視圖(targetView)的位置方向,目前可以定義上(上方左對齊)、下(下方左對齊)、左(左方上對齊)、右(右方上對齊)四個方向。如果需要在位置之余有不一樣的對齊效果,可以使用hintViewMarginXXX屬性
outlineType
透明焦點區(qū)的輪廓類型,有圓形(橢圓)輪廓和方形輪廓兩種
maskColor
半透明遮罩浮層的顏色
isDismissOnClicked
全局點擊可以關閉引導視圖,默認為true。如果設置false,則需要手動設置點擊hintView的特定位置關閉視圖
GuideView
界面實際展示的視圖對象,根據GuideViewBundle設置的屬性,由GuideViewFragment創(chuàng)建并添加到齊視圖容器中,對外部業(yè)務完全透明無感知到一個類
GuideViewFragment
實際顯示引導視圖的彈窗。其內部加載了一個FrameLayout容器,通過在容器中添加GuideView的實例實現顯示引導視圖層。一個GuideViewFragment可以設定一組引導視圖,完成一組引導序列。請使用其靜態(tài)內部類Builder構建其實例,并使用Builder#addGuidViewBundle(bundle)方法添加引導視圖的配置項。
如果需要自定義點擊關閉的動作(GuideViewBundle.Builder#setDismissOnClicked(false)的情況下),可以使用下面的方法
void onNext()
如果還存在沒有顯示的引導視圖,這個方法會繼續(xù)顯示下一張,否則會關閉彈窗
添加依賴
1.在根目錄的build.gradle文件中添加jitpack倉庫
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
2.添加GuideView依賴
dependencies {
compile 'com.github.easilycoder:GuideView:0.0.1'
}
使用示例
GuideViewFragment.Builder()
.addGuidViewBundle(GuideViewBundle.Builder()
.setTargetView(tvContent)
.setHintView(hintViewLeft)
.setDismissOnClicked(false)
.setHintViewMargin(0, -160, 0, 0)
.setTransparentSpace(space, space, space, space)
.setOutlineType(TYPE_RECT)
.setHintViewParams(params)
.setHintViewDirection(LEFT).build())
.addGuidViewBundle(GuideViewBundle.Builder()
.setTargetView(tvContent)
.setOutlineType(TYPE_OVAL)
.setHintView(hintViewTop)
.setDismissOnClicked(false)
.setHintViewParams(params)
.setHintViewMargin(-dp2px(this, 55f), 0, 0, 0)
.setTransparentSpace(space, space, space, space)
.setHintViewDirection(TOP)
.build())
.addGuidViewBundle(GuideViewBundle.Builder()
.setTargetView(tvContent)
.setOutlineType(TYPE_OVAL)
.setHintView(hintViewRight)
.setDismissOnClicked(false)
.setHintViewParams(params)
.setHintViewMargin(0, -160, 0, 0)
.setTransparentSpace(space, space, space, space)
.setHintViewDirection(RIGHT)
.build())
.addGuidViewBundle(GuideViewBundle.Builder()
.setTargetView(tvContent)
.setOutlineType(TYPE_OVAL)
.setHintViewParams(params)
.setHintViewMargin(-dp2px(this, 55f), 0, 0, 0)
.setHintView(hintViewBottom)
.setTransparentSpace(space, space, space, space)
.setHintViewDirection(BOTTOM)
.build())
.setCancelable(false)
.build().show(supportFragmentManager, "hit")
具體實例以及設計實現可以參考我的GitHub倉庫:GuideView
以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支持腳本之家。
相關文章
Android 使用jarsigner給apk簽名的方法詳細介紹
這篇文章主要介紹了Android 使用jarsigner給apk簽名的方法詳細介紹的相關資料,APP 完成需要在一些APP 商店進行上傳審核,供用戶下載使用,APP 需要簽名認證,需要的朋友可以參考下2016-12-12
Android開發(fā)EditText禁止輸入監(jiān)聽及InputFilter字符過濾
這篇文章主要為大家介紹了Android開發(fā)EditText禁止輸入監(jiān)聽及InputFilter字符過濾示例詳解,有需要的朋友可以借鑒參考下,希望能夠有所幫助,祝大家多多進步,早日升職加薪2022-06-06
解決AndroidStudio無法運行java中的mian方法問題
這篇文章主要介紹了解決AndroidStudio無法運行java中的mian方法問題,本文通過圖文并茂的形式給大家介紹的非常詳細,對大家的學習或工作具有一定的參考借鑒價值,需要的朋友可以參考下2020-10-10
Android源碼系列之深入理解ImageView的ScaleType屬性
Android源碼系列第一篇,這篇文章主要從源碼的角度深入理解ImageView的ScaleType屬性,感興趣的小伙伴們可以參考一下2016-06-06

