一分钟实现Android遮罩引导视图

一分钟实现android遮罩引导视图，供大家参考，具体内容如下

先看一下效果图

主角guideview登场！

guideview是一种基于dialogfragment实现的引导遮罩浮层视图的轻量级解决方案，它具备以下的特性：

• 响应导航按钮的动作（因为引导浮层本质是一个dialog）；
• 链式引导层，支持设定一组的引导遮罩视图，通过点击切换下一个试图，快读与业务进行解藕；
• 自动绘制半透明浮层、透明核心区以及确保目标视图和引导视图的位置。
  

实现说明

页面的结构如下图所示：

核心类

guideviewbundle

引导视图的配置项类，每一页引导视图对应一个配置项。在guideview内部通过这个配置项去构造guideview的实例，并通过guideviewfragment显示在界面上。

其中的属性都通过构造器的模式，通过静态内部类builder进行构建，属性说明如下：

targetview

引导视图需要显示附着的目标视图

hintview

引导视图（不包含半透明浮层以及透明焦点区）

transparentspacexxx

默认的情况下，透明焦点区的大小跟目标视图的大小保持一致，如果需要加大透明区域的大小，可以通过设置这组属性，指定上下左右的额外的空白区域

hintviewmarginxxx

引导视图（hintview）相对于目标视图（targetview）的边距

hastransparentlayer

是否显示透明焦点区域，默认显示。可以选择不绘制透明焦点区域而只有半透明的浮层

hintviewdirection

引导视图（hintview）相对于目标视图（targetview）的位置方向，目前可以定义上（上方左对齐）、下（下方左对齐）、左（左方上对齐）、右（右方上对齐）四个方向。如果需要在位置之余有不一样的对齐效果，可以使用hintviewmarginxxx属性

outlinetype

透明焦点区的轮廓类型，有圆形（椭圆）轮廓和方形轮廓两种

maskcolor

半透明遮罩浮层的颜色

isdismissonclicked

全局点击可以关闭引导视图，默认为true。如果设置false，则需要手动设置点击hintview的特定位置关闭视图

guideview

界面实际展示的视图对象，根据guideviewbundle设置的属性，由guideviewfragment创建并添加到齐视图容器中，对外部业务完全透明无感知到一个类

guideviewfragment

实际显示引导视图的弹窗。其内部加载了一个framelayout容器，通过在容器中添加guideview的实例实现显示引导视图层。一个guideviewfragment可以设定一组引导视图，完成一组引导序列。请使用其静态内部类builder构建其实例，并使用builder#addguidviewbundle(bundle)方法添加引导视图的配置项。

如果需要自定义点击关闭的动作（guideviewbundle.builder#setdismissonclicked(false)的情况下），可以使用下面的方法

void onnext()

如果还存在没有显示的引导视图，这个方法会继续显示下一张，否则会关闭弹窗

添加依赖

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

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持。