Android图片标签组件——TagViewGroup使用指南

1. 项目介绍

TagViewGroup 是一个针对Android平台的开源库，模仿了小红书风格的图片标签功能。它不仅支持标签的动态显示效果，如平滑的动画过渡、响应式的水波纹效果，还允许用户自定义标签样式，包括编辑和布局控制。这个组件简化了在应用程序中添加和管理美观标签的流程，并提供了丰富的交互体验。

2. 项目快速启动

添加依赖

首先，在你的项目的根build.gradle文件中添加JitPack仓库：

allprojects {
    repositories {
        ...
        maven { url 'https://jitpack.io' }
    }
}

然后，在app模块的build.gradle文件里添加TagViewGroup的依赖：

dependencies {
    implementation 'com.github.shellljx:TagViewGroup:latest.version'
}

替换 latest.version 为你实际获取到的最新版本号。

使用示例

在XML布局中添加TagViewGroup:

<com.shellljx.tagview.TagViewGroup
    android:id="@+id/tagViewGroup"
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    app:inner_radius="4dp"
    app:line_width="1dp"
    app:radius="8dp"
    app:ripple_alpha="100"
    app:ripple_radius="20dp"
    app:tilt_distance="20dp"/>

或者在Java代码中创建：

TagViewGroup tagViewGroup = new TagViewGroup(getContext());

配置并设置数据：

tagViewGroup.setTagAdapter(new TagAdapter() {
    @Override
    public int getCount() {
        return model.getTags().size();
    }

    @Override
    public ITagView getItem(int position) {
        return makeTagTextView(model.getTags().get(position));
    }
});
tagViewGroup.setPercent(model.getPercentX(), model.getPercentY());
tagViewGroup.notifyDataSetChanged();

3. 应用案例和最佳实践

要实现特定的交互效果，比如点击事件处理，可以这样设置监听器：

tagViewGroup.setOnTagGroupClickListener(new TagViewGroup.OnTagGroupClickListener() {
    @Override
    public void onCircleClick(TagViewGroup container) {
        // 处理点击白色圆圈的逻辑
    }

    @Override
    public void onTagClick(TagViewGroup container, ITagView tag, int position) {
        // 处理单个标签被点击的逻辑
    }

    @Override
    public void onLongPress(TagViewGroup container) {
        // 长按事件处理
    }
});

为了提升用户体验，你可以利用动画属性定制标签的显示和隐藏效果，以及通过实现自定义的ITagView接口来扩展标签视图的功能性。

4. 典型生态项目

虽然该文档主要聚焦于TagViewGroup本身，但实际上，结合其他UI组件和架构模式（如MVVM），TagViewGroup可以在各种社交应用、博客平台或产品展示页面中扮演关键角色，为用户提供直观且互动性强的标签选择体验。开发者可以根据自己的需求，将其集成到基于RecyclerView或ViewPager的流式布局，或是任何需要标签展示和交互的场景中，以此增强应用的内容分类和筛选功能。

---

以上即为TagViewGroup的简明使用指南，希望对您的项目开发有所助益。记得适时查阅项目GitHub主页以获取最新的文档和版本更新信息。