Curtain for Android : 一个更简洁好用的高亮蒙层库

Curtain

一个更简洁好用的高亮蒙层库：

• 一行代码完成某个View,或者多个View的高亮展现
• 支持基于AapterView(如ListView、GridView) 和RecyclerView 的item以及item中元素的高亮
• 自动识别圆角背景,也能够自定义高亮形状
• 高亮区域支持自定义大小、操做灵活
• 顺应变化,基于Android X
• 配置简单，导入方便

Installation：

dependencies {
    implementation 'com.qw:curtain:0.0.5'
}

复制代码

Usage：

• 仅仅是高亮某个View

private void showCurtain(){
        new Curtain(MainActivity.this)
                .with(findViewById(R.id.textView))
                .show();
    }
复制代码

• 若是你但愿那个view的蒙层区域更大一些:

private void showCurtain(){
        new Curtain(MainActivity.this)
                .with(findViewById(R.id.textView))
                .withPadding(findViewById(R.id.textView),24)
                .show();
    }

复制代码

• 也能够同时高亮多个View:

private void showCurtain(){
        new Curtain(MainActivity.this)
                .with(findViewById(R.id.textView))
                .with(findViewById(R.id.imageView))
                .show();
    }
复制代码

• 若是你在蒙层上加上一些其余的元素,能够额外传入View布局:

private void showCurtain(){
        new Curtain(MainActivity.this)
                .with(findViewById(R.id.textView))
                .setTopView(R.layout.nav_header_main)
                .show();
    }
复制代码

• 若是你想监听蒙层的展现或者消失的回调:

private void showCurtain(){
        new Curtain(MainActivity.this)
                .with(findViewById(R.id.imageView))
                .setCallBack(new Curtain.CallBack() {
                    @Override
                    public void onShow(IGuide iGuide) {

                    }

                    @Override
                    public void onDismiss(IGuide iGuide) {

                    }
                }).show();
    }
复制代码

• 默认会识别View的背景而生成相关高亮区域的形状,也能够自定形状:

private void showThirdGuide() {
        new Curtain(SimpleGuideActivity.this)
                .with(findViewById(R.id.btn_shape_custom))
                //圆角
                .withShape(findViewById(R.id.btn_shape_custom), new RoundShape(12))
                //椭圆形
// .withShape(findViewById(R.id.btn_shape_custom),new CircleShape())
                // 也可继承自 Shape 本身实现形状
// .withShape(findViewById(R.id.btn_shape_custom), new Shape() {
// @Override
// public void drawShape(Canvas canvas, Paint paint, HollowInfo info) {
                //draw your shape here
// }
// })
                .show();
    }
复制代码

• 在ListView 或者GridView 中使用:

/** * 高亮item */
    private void showGuideInItem() {
        View item1 = ViewGetter.getFromAdapterView(listView, 5);
        View item2 = ViewGetter.getFromAdapterView(listView, 2);
        //若是你的View的位置不在屏幕中，返回值为null 须要判空处理
        if (null == item1 || null == item2) {
            return;
        }
        new Curtain(this)
                .with(item1)
                .with(item2)
                .show();
    }

    /** * 高亮item中的元素 */
    private void showGuideInItemChild() {
        View item1 = ViewGetter.getFromAdapterView(listView, 1);
        View item2 = ViewGetter.getFromAdapterView(listView, 3);
        //若是你的View的位置不在屏幕中，返回值为null 须要判空处理
        if (null == item1 || null == item2) {
            return;
        }
        new Curtain(this)
                .withShape(item1.findViewById(R.id.image), new CircleShape())
                .with(item2.findViewById(R.id.tv_text))
                .show();
    }
复制代码

• 其余一些功能介绍:

private void showCurtain() {
        new Curtain(MainActivity.this)
                .with(findViewById(R.id.imageView))
                //是否容许回退关闭蒙层
                .setCancelBackPressed(false)
                // 设置蒙层背景颜色
                .setCurtainColor(0x88000000)
                // 设置蒙层出现的动画 默认渐隐
                .setAnimationStyle(R.style.testAnimation)
                .show();
    }
复制代码

demo 截图:

Github地址