BGABanner-Android

BGABanner is a composite custom view that extends RelativeLayout. Instead of inheriting from ViewPager, it uses a composition pattern to wrap a BGAViewPager (a custom ViewPager) along with other UI elements like indicators, text tips, and placeholder images. This design allows indicators and text to be positioned freely as sibling views within the RelativeLayout container without interfering with the ViewPager logic.

Core Components:

• BGAViewPager: A custom ViewPager that handles auto-play callbacks, user scroll permissions, and custom transition durations.
• mPointContainerRl: A RelativeLayout container for indicators (dots or numbers) and text tips (mTipTv).
• mPlaceholderIv: An ImageView used as a placeholder while network images are loading.
• BGAPageTransformer: An abstract class used to define custom page transition animations.
• BGAOnNoDoubleClickListener: A utility used to prevent double-click events on banner items.

There are three primary ways to provide data to the banner depending on your use case:

1. Using an Adapter (Best for network images or infinite loop with < 3 pages): Pass a data model and an adapter to handle item binding (e.g., using Glide).
2. Using a View collection (Best for custom layouts): Pass a list of pre-inflated Views.
3. Using Image Resources (Best for simple image-only banners): Pass resource IDs and a BGALocalImageSize object.

// Method 1: Adapter with data models (e.g., for Glide)
mContentBanner.setAdapter(new BGABanner.Adapter<ImageView, String>() {
    @Override
    public void fillBannerItem(BGABanner banner, ImageView itemView, String model, int position) {
        Glide.with(MainActivity.this)
                .load(model)
                .placeholder(R.drawable.holder)
                .error(R.drawable.holder)
                .centerCrop()
                .dontAnimate()
                .into(itemView);
    }
});
mContentBanner.setData(Arrays.asList("URL1", "URL2"), Arrays.asList("Text1", "Text2"));

// Method 2: Direct View list
List<View> views = new ArrayList<>();
views.add(View.inflate(context, R.layout.layout_guide_one, null));
mContentBanner.setData(views);

// Method 3: Image Resource IDs
BGALocalImageSize localImageSize = new BGALocalImageSize(720, 1280, 320, 640);
mContentBanner.setData(localImageSize, ImageView.ScaleType.CENTER_CROP, 
        R.drawable.img1, R.drawable.img2);

To use BGABanner, add the view to your XML layout and then configure the adapter and data in your Activity or Fragment. The setData method is the primary entry point for populating the banner.

1. XML Layout:

<cn.bingoogolapple.bgabanner.BGABanner
    android:id="@+id/banner"
    android:layout_width="match_parent"
    android:layout_height="180dp" />

2. Java Implementation: Set an adapter to handle how each item is rendered (e.g., using Glide to load images) and then call setData with your data list and optional tip strings.

// 1. In your layout, place BGABanner
// <cn.bingoogolapple.bgabanner.BGABanner
//     android:id="@+id/banner"
//     android:layout_width="match_parent"
//     android:layout_height="180dp" />

// 2. Populate data in code
List<String> tips = Arrays.asList("提示一", "提示二", "提示三");
banner.setAdapter(new BGABanner.Adapter<ImageView, String>() {
    @Override
    public void fillBannerItem(BGABanner banner, ImageView itemView, String model, int position) {
        // Use Glide or similar to load network images into itemView
    }
});
banner.setData(Arrays.asList("url1", "url2", "url3"), tips);

Custom animations are implemented using the PageTransformer interface. The transformPage(View page, float position) method provides a position value that drives the animation:

• position == 0: The page currently being displayed.
• position < 0: The page to the left.
• position > 0: The page to the right.
• position in range [-1, 1]: The page is within the visible viewport.

To create a custom effect, implement the BGAPageTransformer abstract class and override methods like handleLeftPage, handleRightPage, or handleInvisiblePage. Use the position value to map to properties like alpha, scale, rotation, or translation.

public void handleRightPage(View view, float position) {
    // Example: Fade out and scale down as the page moves right
    ViewCompat.setAlpha(view, 1 - position);
    float scale = mMinScale + (1 - mMinScale) * (1 - position);
    ViewCompat.setScaleX(view, scale);
    ViewCompat.setScaleY(view, scale);
}