前言
本文章,是对于github上开源库的介绍使用, 简单记载方便查看。
https://github.com/hongyangAndroid/Highlight
为了以后使用时候方便查阅。
效果图:
看到效果图就知道要做的是什么了?
像“账户信息移到这里了,点击查看”,就是高亮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 填充的布局。