zhpanvip/bannerviewpager

🚀 An awesome banner view for Android,Based on ViewPager2. 这可能是全网最好用的ViewPager轮播图。简单、高效,一行代码实现循环轮播,一屏三页任意变,指示器样式任你挑。

View on GitHub ↗Jump to charts ↓

Summary Information

Updated 2 minutes ago
Added to GitGenius on September 18th, 2026
Created on March 28th, 2017
Open Issues & Pull Requests: 15 (+0)
GitHub issues: Enabled
Number of forks: 466
Total Stargazers: 3,779 (+0)
Total Subscribers: 35 (+0)

Repository Insights (GitGenius)

Median issue/PR response: 24.2 days
Mean response time: 153.8 days
90th percentile: 541.7 days
Tracked items: 33

Most active contributors

Sign in to see contributor activity.

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 12
New in 7 days: 0
Closed in 7 days: 0
Avg open age: 441 days
Stale 30+ days: 12
Stale 90+ days: 11

Recent activity

Opened in 7 days: 0
Closed in 7 days: 0
Comments in 7 days: 0
Events in 7 days: 0

Top labels

  • bug (2)
  • duplicate (1)

Most active issues this week

No issue events were indexed in the last 7 days.

Detailed Description

BannerViewPager is an Android banner carousel library built on ViewPager2 that handles looping image galleries with customizable page layouts and indicator styles.

The library solves the problem of implementing carousel banners in Android applications by providing a ViewPager2-based solution that handles infinite looping automatically. It supports displaying multiple pages simultaneously on screen with configurable reveal widths, allowing developers to show partial views of adjacent pages. The approach includes built-in support for various page styles such as multi-page, multi-page with scaling, and multi-page with overlap effects, along with multiple indicator style options and slide modes.

Developers should choose this tool if they need a production-ready banner implementation that matches patterns used in major applications. It suits projects requiring flexible carousel layouts where showing multiple pages at once is desired, or where standard single-page-at-a-time carousels are insufficient. The library works with ViewBinding and DataBinding, supports multiple view types within a single carousel, and allows custom indicator implementations. The indicator functionality has been separated into a dedicated library for those who need indicator components independently.

The project shows active maintenance with regular updates and comprehensive documentation organized through a wiki structure covering quick starts, API reference, multiple view types, data binding integration, and custom indicator creation. The codebase includes sample implementations demonstrating various page styles and indicator configurations, with downloadable demo applications available for testing different versions.