Skip to content

GuidView

xuexiangjys edited this page Apr 26, 2022 · 6 revisions

引导控件的目的是引导用户使用应用的新功能,增强应用的用户体验。引导控件包括首次安装引导,开机引导以及引导朦层。

SimpleGuideBanner

简单的首次安装引导页,支持切换的动画自定义。

常用方法

  • 设置数据源: T setSource(List list)
  • 设置指示器选中动画:T setSelectAnimClass(Class<? extends BaseAnimator> selectAnimClass)
  • 设置页面切换动画: T setTransformerClass(Class<? extends ViewPager.PageTransformer> transformerClass)
  • 设置点击跳转的监听:setOnJumpClickL(OnJumpClickL onJumpClickL)

【注】可继承使用BaseGuideActivity快速实现首次安装引导页的效果。同理,也可继承使用BaseSplashActivity快速实现开机引导的效果。

GuideCaseView

引导朦层组件,支持列表聚焦、控件聚焦、自定义聚焦、文字提示、图片提示、自定义布局提示、自定义聚焦动画、聚焦队列等。

  • 演示效果

  • 使用案例
new GuideCaseView.Builder(getActivity())
        .picture(R.drawable.img_guidecaseview_gain_speed_gesture)
        .build()
        .show();
        
new GuideCaseView.Builder(getActivity())
        .focusOn(view)
        .focusCircleRadiusFactor(1.5)
        .title("一个巨大的圆形聚焦")
        .focusBorderColor(Color.GREEN)
        .titleStyle(0, Gravity.BOTTOM | Gravity.CENTER)
        .fitWindowsAuto()
        .build()
        .show();
        
new GuideCaseView.Builder(getActivity())
        .title("坐标聚焦")
        .focusRectAtPosition(600, 120, 800, 140)
        .roundRectRadius(60)
        .build()
        .show();       

常用方法

  • 设置标题文字:title(String title)
  • 设置图片资源:picture(int pictureResId)
  • 设置聚焦边框的颜色:focusBorderColor(int focusBorderColor)
  • 设置聚焦边框的粗细:focusBorderSize(int focusBorderSize)
  • 设置聚焦的控件:focusOn(View view)
  • 设置引导朦层的背景颜色:backgroundColor(int backgroundColor)
  • 设置自定义引导朦层布局:customView(int layoutResource, OnViewInflateListener listener)
  • 设置进入动画:enterAnimation(Animation enterAnimation)
  • 设置退出动画:exitAnimation(Animation exitAnimation)
  • 设置聚焦的形状,默认是圆形:focusShape(FocusShape focusShape)
  • 自定义聚焦的矩形区域:focusRectAtPosition(int positionX, int positionY, int positionWidth, int positionHeight)
  • 自定义聚焦的环形区域:focusCircleAtPosition(int positionX, int positionY, int radius)
  • 设置引导朦层消失的监听:dismissListener(DismissListener dismissListener) 【注】使用GuideCaseQueue,将需要展示的GuideCaseView加入进去,可实现引导朦层点执行效果。
Clone this wiki locally