# XRCarouselView

**Repository Path**: nash33/XRCarouselView

## Basic Information

- **Project Name**: XRCarouselView
- **Description**: 史上最简单的图片轮播，可左右滚动与淡入淡出，秒集成，支持gif图片，自带缓存，不依赖任何第三方库
- **Primary Language**: Objective-C
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2018-08-03
- **Last Updated**: 2020-12-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# XRCarouselView
The easiest way to use image circulate

超简单好用的图片轮播框架，两个imageView实现

使用过程中发现bug请先下载最新版，若bug依旧存在，请及时反馈，谢谢

实现原理[请看这里](http://www.jianshu.com/p/ef03ec7f23b2)

______

# XRCarouselView的优点
1.文件少，代码简洁

2.同时支持本地图片及网络图片

3.自带图片下载与缓存，不依赖任何第三方库

4.两种轮播方式，滚动与淡入淡出

5.性能好，占用内存少，轮播流畅

# 如何集成XRCarouselView
### 导入
###### 方式一：手动导入
将XRCarouselView文件夹中的所有文件添加到项目中
###### 方式二：cocoapods导入
pod 'XRCarouselView'

### 创建
###### 方式一：代码创建
1.导入主头文件 XRCarouselView.h

2.创建XRCarouselView，设置所需属性

3.将XRCarouselView添加到要展示到view上面
###### 方式二：直接添加到xib\sb
1.添加一个view到xib\sb上

2.设置view的class为XRCarouselView

3.拖线到.m文件中，设置所需属性

### 说明
要想正常使用，图片数组imageArray必须设置

控件的frame必须设置，xib\sb创建的可不设置
 
其他属性都有默认值，可不设置
 
# XRCarouselView的常用属性方法

1.imageArray：要轮播的图片数组，可传本地图片或网络图片路径

2.changeMode：图片切换方式，有轮播滚动与淡入淡出两种

3.describeArray：图片描述的字符串数组，应与图片顺序对应

4.time：设置每页的停留时间

5.void(^imageClickBlock)(NSInteger index)：图片被点击后要执行的代码

6.clearDiskCache：清除沙盒中的图片缓存

# 效果演示
###### 轮播滚动
![](http://upload-images.jianshu.io/upload_images/1429074-44e752365ba34885.gif?imageMogr2/auto-orient/strip)
###### 淡入淡出
![](http://ww2.sinaimg.cn/large/b68232a1gw1f3ck6l40yqg20a904yu0x.gif)