huangqiongbin/BannerLayout-1

Support unlimited picture rotation BannerLayout, the minimum implementation of the code banner

Download

Step 1. Add the JitPack repository to your build file

Add it in your root settings.gradle at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url 'https://jitpack.io' }
		}
	}

Add it in your settings.gradle.kts at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url = uri("https://jitpack.io") }
		}
	}

Add to pom.xml

	<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>

Add it in your build.sbt at the end of resolvers:

 
    resolvers += "jitpack" at "https://jitpack.io"

Add it in your project.clj at the end of repositories:

 
    :repositories [["jitpack" "https://jitpack.io"]]

Step 2. Add the dependency

	dependencies {
		implementation 'com.github.huangqiongbin:BannerLayout-1:'
	}
	dependencies {
		implementation("com.github.huangqiongbin:BannerLayout-1:")
	}
	<dependency>
	    <groupId>com.github.huangqiongbin</groupId>
	    <artifactId>BannerLayout-1</artifactId>
	    <version></version>
	</dependency>

                            
    libraryDependencies += "com.github.huangqiongbin" % "BannerLayout-1" % ""
        
        

                            
    :dependencies [[com.github.huangqiongbin/BannerLayout-1 ""]]

Readme

BannerLayoutSimple

BannerLayout for unlimited rotation of images

中文文档

##Support function

  • can be customized small dots (left center), title (left center), prompt bar (upper middle) position

  • you can customize small dots, and whether to automatically rotate to the next page and rotation time

  • support List, array two data formats (network local support)

  • support for click events and rotation speed and viewPager slide switch speed

  • whether to display a small dot, title, or the entire tip column

  • support for loading and loading fails to display custom pictures

  • supports pause to resume the rotation status

  • support for custom hints (not recommended)

  • support animation (random animation needs List animation collection)

  • support for custom Bean class, if only simple to use, you can use the system default BannerBean

  • support for vertical scrolling, using animation, so vertical scrolling can not be animated

####Effect

Simple only the first example of the default open carousel, the rest of the examples do not open the carousel, simple recording a bit dropped frames

##Basic Usage

gradle

compile 'com.ydevelop:bannerlayout:1.0.2'

Update log

1.0.2 ： Fix the animation Click the bug
...

If the network is loading pictures remember to add

<uses-permission android:name="android.permission.INTERNET" />

Simple to use

    holder.getBannerLayout()
            .initListResources(initImageModel())//initData
            .initTips(true, true, true, BannerTipsSite.TOP, null, null)//settings tips
            .start(true, 2000)

Details of the problem

Some TipsLayout settings such as font size, color and the like will be placed before initTips call,
1.x 0.x version of the manual removed on the basis of the call initAdapter (), on the initiative to call the data after the initialization,
Therefore, some methods of ViewPager will be placed before the initialization data call, such as sliding speed, whether the vertical sliding, custom prompt bar.

1.Array

Array is also used in the internal conversion into List data, click events and custom ImageLoaderManager are passed generic BannerModel

Object[] mImage = ;
String[] mTitle = ;
holder.getBannerLayout()
        .initArrayResources(mImage, mTitle)
        .initTips(true, true, true, BannerTipsSite.BOTTOM, BannerDotsSite.LEFT, BannerTitleSite.RIGHT);

2.ArrayList

List<BannerModel> mDatas = new ArrayList<>();
...
bannerLayout
        .initImageListResources(mDatas)
        .initTips()
        .start(true);

3.Click the event

If you do not pass generics, the return model is the current Bean class, strong turn can be recommended to pass generics

    bannerLayout
            .initListResources(initImageModel())
            .setOnBannerClickListener(new OnBannerClickListener<ImageModel>() {

                @Override
                public void onBannerClick(int position, ImageModel model) {
                    Toast.makeText(holder.getContext(), model.getTestText(), Toast.LENGTH_SHORT).show();
                }
            });

4.Tip column and small dots, title position changes

Want to change the position in the initTips () method to achieve several different states, do not need to pass directly to the null default parameters

BannerTipsSite               	 	The location of the tip bar in the layout，TOP,BUTTOM,CENTERED Three optional 
BannerDotsSite                		dots in the location of the prompt bar，LEFT,CENTERED,RIGHT Three optional
BannerTitleSite               		Title The location of the prompt bar，LEFT,CENTERED,RIGHT Three optional

5.Customize the Bean class

Because the built-in Bean class simply loads image and title, if the click event to pass the ID and the like parameters, then you can only customize a Bean class

Custom Bean class can be broadly divided into two cases:：
	1.The background parameters url and title is the built-in Bean's image, title. Named the same way, then you can directly use.
	2.ImageUrl and Title of background parameters As long as any of the names and built-in Bean is not the same, you must customize the ImageLoaderManage, because BannerLayout acquiescence acquires BannerModel inside the image and title, unless you and the background consultation, let him name Change it

In both cases, custom Bean must inherit the BannerModel class, otherwise BannerLayout will not recognize it. As for custom ImageLoaderManage, see article 6

If the title bar text is not named title, then the realization of OnBannerTitleListener, can return to the specific title

A complete example of a custom Bean class：

 bannerLayout
            .setImageLoaderManager(new ImageManager())
            .addOnBannerTitleListener(new OnBannerTitleListener() {
                @Override
                public String getTitle(int newPosition) {
                    return initBannerBean().get(newPosition).getThisTitle();
                }
            })
            .initImageListResources(initBannerBean())
            .initTips(true, true, true);

6.Use the Custom Load Picture frame

BannerLayout internal reference Glide3.7.0, if you do not want to use this version of your project, please exclude it with exclusion, and then use your version

The default is to use Glide to load the image if you do not like the inheritance of ImageLoaderManage and then setImageLoaderManage in the code.

 bannerLayout
            .initImageListResources(mBanner)
            .setImageLoaderManage(new ImageLoader()) //Own definition of loading pictures
            .initTips(true, true, false)
            .start(true);

public class ImageManager implements ImageLoaderManager<BannerBean> {

    @Override
    public void display(Context context, ImageView imageView, BannerBean model) {
        Picasso.with(context)
                .load(model.getImageUrl())
                .placeholder(R.mipmap.ic_launcher)
                .error(R.mipmap.ic_launcher)
                .into(imageView);
    }
}

7.Toggle animation and speed

a vertical scrolling animation

Viewpager vertical Here is the use of animation, so long as the choice of vertical scrolling, setting animation invalid

Animation built-in ViewPagerTransforms，Thank the author

If you want to customize the animation, please inherit ABaseTransformer or BannerTransformer ;

        bannerLayout
                .initImageListResources(list) //Customize the model class
                .initTips()
                .setBannerTransformer(new FlipVerticalTransformer())  //Toggle animations
                .setBannerTransformerList(transformers) //Open random animation, set here, then there is no need to set the switch animation, the need for a list of animation collection
                .setDuration(3000) //Switching speed
                .start();

If you only want to use the built-in animation can use BANNER_ANIMATION to choose

simple：

	   bannerLayout
                .initImageListResources(list) //Customize the model class
                .initTips()
                .setBannerTransformer(BANNER_ANIMATION.CUBE_IN)
                .start();

8.Animation collection：

>Customize the animation collection

        List<BannerTransformer> transformers = new ArrayList<>();
       
		bannerLayout.setBannerTransformerList(transformers);

>A collection of system animations

		 List<BANNER_ANIMATION> enumTransformer = new ArrayList<>();

		bannerLayout..setBannerSystemTransformerList(enumTransformer);

9.Customize the tip bar

Custom tip bar is not recommended, so there is no quick set of features please mention lssues

bannerLayout
        .initImageListResources(mDatas)
        .addOnBannerPageChangeListener(new BannerOnPage())
        .addPromptBar(new PromptBarView(getBaseContext())) 
        .start(true);

 /**
 * Take over the onPage method of the viewpager
 */
public class BannerOnPage implements OnBannerPageChangeListener {

    @Override
    public void onPageScrolled(int position, float positionOffset, int positionOffsetPixels) {

    }

    @Override
    public void onPageSelected(int position) {
    }

    @Override
    public void onPageScrollStateChanged(int state) {

    }
}

BannerLayout has provided a method that can be used to determine whether a carousel is active or not in the appropriate lifecycle, either by pausing or resuming rotation (if autoplay is enabled) The user can directly call it

Custom parameters explained in detail

The property name |Description |The attribute value --- |--- |--- delay_time |Rotation time |default 2s start_rotation |Whether to turn on automatic rotation |True on, the default is not open view_pager_touch_mode |Whether the viewpager can be manually swiped |True to prohibit sliding, false can slide, the default can slide banner_duration |ViewPager switch speed |default 800，The bigger the slower banner_isVertical |The viewPager scrolls vertically |The default is not vertical scrolling, true on dots_visible |Whether to display small dots |default display dots_selector |Small Dot State Selector |Can refer to their own dots_left_margin |The dots are marginLeft |default 10 dots_right_margin |The dots are marginRight |default 10 dots_width |The width of the dots |default 15 dots_height |The height of the dots |default 15 is_tips_background |Whether to display the background of the prompt control |True display, the default is not displayed tips_background |BannerRound Background color |default translucent tips_width |BannerRound width |default wrap_content tips_height |BannerRound height |default 50 glide_error_image |Glide Load error placeholder |defaultandroid Comes with icons glide_place_image |Placeholder in Glide loading |defaultandroid Comes with icons title_visible |Whether title is displayed |default not displayed title_size |font size |default 12 title_color |font color |default yellow title_width |font width |default wrap_content title_height |font height |default wrap_content title_left_margin |title marginLeft |default 10 title_right_margin |title marginRight |default 10

License

Copyright (C) 2016 yuezhaoyang7449@163.com

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.