Android 指向性高亮按钮

前言

本文章,是对于github上开源库的介绍使用, 简单记载方便查看。
https://github.com/hongyangAndroid/Highlight
为了以后使用时候方便查阅。
效果图:

01.png

看到效果图就知道要做的是什么了?
像“账户信息移到这里了,点击查看”,就是高亮View的提示文字。

思考

假设如图所示有四个按钮要弄成高亮的,那么必须要考虑一下问题:
(1)这四个按钮一起展示出来还是一个一个的展示?
(2)这些高亮按钮是点击背景消失,还是点击某些提示文字才可以消失
上述提到的问题,不同的相互组合,就是不同的效果。

初步介绍

 mHighLight = new HighLight(MainActivity.this) 
                .addHighLight(R.id.Text_1, R.layout.info_gravity_left_down, new OnRightPosCallback(), new RectLightShape())
                .addHighLight(R.id.Text_2, R.layout.info_gravity_left_down, new OnLeftPosCallback(), new RectLightShape())
                .addHighLight(R.id.Text_3, R.layout.info_gravity_left_down, new OnTopPosCallback(), new CircleLightShape())
                .addHighLight(R.id.Text_4, R.layout.info_gravity_left_down, new MySelfPosCallback(), new CircleLightShape());
mHighLight.show();

上述代码,实现了,一次性展示四个高亮按钮,用户点击背景就可以都取消。

(1)addHighLight()方法

参数一:你想高亮的View的控件
参数二:提示文字,你希望在高亮按钮傍边展示什么,是以布局形式,可以随便自定义
参数三:设置提示文字在高亮按钮的什么位置,这个库中已经提供了上下左右,如果不满意,可以自己定义,如图,MyselfPosCallBack就是我自己自定义:

public class MySelfPosCallback extends OnBaseCallback {

    public MySelfPosCallback() {
    }

    public MySelfPosCallback(float offset) {
        super(offset);
    }

    @Override
    public void getPosition(float rightMargin, float bottomMargin, RectF rectF, HighLight.MarginInfo marginInfo) {
        marginInfo.rightMargin = rightMargin+rectF.width()+offset;
        marginInfo.topMargin = rectF.top-200;
    }
}

参数四:用什么样式包裹高亮的View,效果看图,这个库中提供了矩形、圆形、椭圆,当然也支持自定义。

 .addHighLight(R.id.text_4,R.layout.info_known,new OnRightPosCallback(5),new BaseLightShape(TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_DIP,5,getResources().getDisplayMetrics()), TypedValue.applyDimension(TypedValue.COMPLEX_UNIT_DIP,5,getResources().getDisplayMetrics()),0) {
                    @Override
                    protected void resetRectF4Shape(RectF viewPosInfoRectF, float dx, float dy) {
                        //缩小高亮控件范围
                        viewPosInfoRectF.inset(dx,dy);
                    }

                    @Override
                    protected void drawShape(Bitmap bitmap, HighLight.ViewPosInfo viewPosInfo) {
                        //custom your hight light shape 自定义高亮形状
                        Canvas canvas = new Canvas(bitmap);
                        Paint paint = new Paint(Paint.ANTI_ALIAS_FLAG);
                        paint.setDither(true);
                        paint.setAntiAlias(true);
                        //blurRadius必须大于0
                        if(blurRadius>0){
                            paint.setMaskFilter(new BlurMaskFilter(blurRadius, BlurMaskFilter.Blur.SOLID));
                        }
                        RectF rectF = viewPosInfo.rectF;
                        canvas.drawOval(rectF, paint);
                    }
                })

另外,方法是addxxxx,那么说明是支持可以无限添加的,这个是随意的,但是需要主要的是,你添加的顺序就是展示的顺序,当然了这个战士的顺序是基于一个一个出现才能看到,否则只能看到一下子全部展示出来。

autoRemove()

这个方法默认是ture,就是说,你点击背景就可以取消高亮View。
如果你设置了false,那么就不能取消高亮View。

如何让其一个一个的展示

 mHighLight = new HighLight(MainActivity.this)
                .addHighLight(R.id.Text_1, R.layout.info_gravity_left_down, new OnRightPosCallback(), new RectLightShape())
                .addHighLight(R.id.Text_2, R.layout.info_gravity_left_down, new OnLeftPosCallback(), new RectLightShape())
                .addHighLight(R.id.Text_3, R.layout.info_gravity_left_down, new OnTopPosCallback(), new CircleLightShape())
                .addHighLight(R.id.Text_4, R.layout.info_gravity_left_down, new MySelfPosCallback(), new CircleLightShape())
                .autoRemove(false)//如果设置为true,那么就是自动移除,那么mHighLight对象就会自动移除了,会出现空指针错误。
                .enableNext()
                .setClickCallback(new HighLightInterface.OnClickCallback() {
                    @Override
                    public void onClick() {
                        Toast.makeText(MainActivity.this,"请点击下一个",Toast.LENGTH_SHORT).show();
                        mHighLight.next();//必须要这个,要不然只展示一个指示性高亮的,就不往下走了
                    }
                });
        mHighLight.setOnNextCallback(new HighLightInterface.OnNextCallback() {
            @Override
            public void onNext(HightLightView hightLightView, View targetView, View tipView) {
                Log.d("xljxjlx","zoule de shi onNextCallback");
                //和onClickCallback可以一起回调;
            }
        });
        mHighLight.show();

其中,enableNext()是关键,作用是开始mHighLight.next()
这两个属性配合就可以完成了一个一个展示高亮,所以这个一个一个出现是要手动调用next()方法的。
需要注意,autoRemove必须设置为false,否则在使用一个一个出现时候会出现空指针,因为autoRemove会移除mHighLight。

一些监听介绍

前面提到的有

(1)setClickCallback()

点击背景时候就会触发。

(2)setOnNextCallback()

当enableNext()出现,执行一次,当next()方法执行一次,就会回调一次。

setOnRemoveCallback()

当HighLight中所有设置的高亮按钮移除的时候,就会自动调用

setOnShowCallback()

当HighLight开始出现的时候,就会自动调用

需要注意

前面所有的监听 ,都是这个库本身提供的源码如下:

 if (intercept) {
            hightLightView.setOnClickListener(new View.OnClickListener() {
                @Override
                public void onClick(View v) {
                    //added autoRemove by isanwenyu@163.com
                    if (autoRemove) remove();

                    sendClickMessage();
                }
            });
        }

提到了一个关键属相intercept,默认的是true,
所以这些监听方法才有效果。
如果设置了intercept = false ,那么监听方法会失效,具体实践试试,但好处是,如果你界面有一个滑动的布局,那么就不会影响它滑动,一般默认的情况下,他是不可以滑动的。

不想通过点击背景来使得高亮View消失

可以通过在提示文字布局中添加一个View,比如“我知道了”但是要在相应的acitivy中重写这个“我知道了”的点击事件,将autoRemove设置为 false就可以了。

 public void clickKnown(View view) {
        if(mHighLight.isShowing() && mHighLight.isNext())//如果开启next模式
        {
            mHighLight.next();
        }else
        {
            mHighLight.remove();
        }
    }

实现这个点击事件,也是在里面完成HighLight的操作。next()针对于下一个,remove()针对于移除给HighLight添加的高亮View.

不在Activity中使用

如果不在Activity中使用,需要调用方法

 .anchor(findViewById(R.id.id_container))//如果是Activity上增加引导层,不需要设置anchor

其中anchor参数是想添加高亮View的跟布局的id 填充的布局。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,723评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,485评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,998评论 0 344
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,323评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,355评论 5 374
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,079评论 1 285
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,389评论 3 400
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,019评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,519评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,971评论 2 325
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,100评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,738评论 4 324
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,293评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,289评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,517评论 1 262
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,547评论 2 354
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,834评论 2 345