/
BaseSliderView.java
328 lines (274 loc) · 8.18 KB
/
BaseSliderView.java
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
package com.daimajia.slider.library.SliderTypes;
import android.content.Context;
import android.os.Bundle;
import android.view.View;
import android.widget.ImageView;
import com.daimajia.slider.library.R;
import com.squareup.picasso.Callback;
import com.squareup.picasso.Picasso;
import com.squareup.picasso.RequestCreator;
import java.io.File;
/**
* When you want to make your own slider view, you must extends from this class.
* BaseSliderView provides some useful methods.
* I provide two example: {@link com.daimajia.slider.library.SliderTypes.DefaultSliderView} and
* {@link com.daimajia.slider.library.SliderTypes.TextSliderView}
* if you want to show progressbar, you just need to set a progressbar id as @+id/loading_bar.
*/
public abstract class BaseSliderView {
protected Context mContext;
private Bundle mBundle;
/**
* Error place holder image.
*/
private int mErrorPlaceHolderRes;
/**
* Empty imageView placeholder.
*/
private int mEmptyPlaceHolderRes;
private String mUrl;
private File mFile;
private int mRes;
protected OnSliderClickListener mOnSliderClickListener;
private boolean mErrorDisappear;
private ImageLoadListener mLoadListener;
private String mDescription;
private Picasso mPicasso;
/**
* Scale type of the image.
*/
private ScaleType mScaleType = ScaleType.Fit;
public enum ScaleType{
CenterCrop, CenterInside, Fit, FitCenterCrop
}
protected BaseSliderView(Context context) {
mContext = context;
}
/**
* the placeholder image when loading image from url or file.
* @param resId Image resource id
* @return
*/
public BaseSliderView empty(int resId){
mEmptyPlaceHolderRes = resId;
return this;
}
/**
* determine whether remove the image which failed to download or load from file
* @param disappear
* @return
*/
public BaseSliderView errorDisappear(boolean disappear){
mErrorDisappear = disappear;
return this;
}
/**
* if you set errorDisappear false, this will set a error placeholder image.
* @param resId image resource id
* @return
*/
public BaseSliderView error(int resId){
mErrorPlaceHolderRes = resId;
return this;
}
/**
* the description of a slider image.
* @param description
* @return
*/
public BaseSliderView description(String description){
mDescription = description;
return this;
}
/**
* set a url as a image that preparing to load
* @param url
* @return
*/
public BaseSliderView image(String url){
if(mFile != null || mRes != 0){
throw new IllegalStateException("Call multi image function," +
"you only have permission to call it once");
}
mUrl = url;
return this;
}
/**
* set a file as a image that will to load
* @param file
* @return
*/
public BaseSliderView image(File file){
if(mUrl != null || mRes != 0){
throw new IllegalStateException("Call multi image function," +
"you only have permission to call it once");
}
mFile = file;
return this;
}
public BaseSliderView image(int res){
if(mUrl != null || mFile != null){
throw new IllegalStateException("Call multi image function," +
"you only have permission to call it once");
}
mRes = res;
return this;
}
/**
* lets users add a bundle of additional information
* @param bundle
* @return
*/
public BaseSliderView bundle(Bundle bundle){
mBundle = bundle;
return this;
}
public String getUrl(){
return mUrl;
}
public boolean isErrorDisappear(){
return mErrorDisappear;
}
public int getEmpty(){
return mEmptyPlaceHolderRes;
}
public int getError(){
return mErrorPlaceHolderRes;
}
public String getDescription(){
return mDescription;
}
public Context getContext(){
return mContext;
}
/**
* set a slider image click listener
* @param l
* @return
*/
public BaseSliderView setOnSliderClickListener(OnSliderClickListener l){
mOnSliderClickListener = l;
return this;
}
/**
* When you want to implement your own slider view, please call this method in the end in `getView()` method
* @param v the whole view
* @param targetImageView where to place image
*/
protected void bindEventAndShow(final View v, ImageView targetImageView){
final BaseSliderView me = this;
v.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
if(mOnSliderClickListener != null){
mOnSliderClickListener.onSliderClick(me);
}
}
});
if (targetImageView == null)
return;
if (mLoadListener != null) {
mLoadListener.onStart(me);
}
Picasso p = (mPicasso != null) ? mPicasso : Picasso.with(mContext);
RequestCreator rq = null;
if(mUrl!=null){
rq = p.load(mUrl);
}else if(mFile != null){
rq = p.load(mFile);
}else if(mRes != 0){
rq = p.load(mRes);
}else{
return;
}
if(rq == null){
return;
}
if(getEmpty() != 0){
rq.placeholder(getEmpty());
}
if(getError() != 0){
rq.error(getError());
}
switch (mScaleType){
case Fit:
rq.fit();
break;
case CenterCrop:
rq.fit().centerCrop();
break;
case CenterInside:
rq.fit().centerInside();
break;
}
rq.into(targetImageView,new Callback() {
@Override
public void onSuccess() {
if(v.findViewById(R.id.loading_bar) != null){
v.findViewById(R.id.loading_bar).setVisibility(View.INVISIBLE);
}
}
@Override
public void onError() {
if(mLoadListener != null){
mLoadListener.onEnd(false,me);
}
if(v.findViewById(R.id.loading_bar) != null){
v.findViewById(R.id.loading_bar).setVisibility(View.INVISIBLE);
}
}
});
}
public BaseSliderView setScaleType(ScaleType type){
mScaleType = type;
return this;
}
public ScaleType getScaleType(){
return mScaleType;
}
/**
* the extended class have to implement getView(), which is called by the adapter,
* every extended class response to render their own view.
* @return
*/
public abstract View getView();
/**
* set a listener to get a message , if load error.
* @param l
*/
public void setOnImageLoadListener(ImageLoadListener l){
mLoadListener = l;
}
public interface OnSliderClickListener {
public void onSliderClick(BaseSliderView slider);
}
/**
* when you have some extra information, please put it in this bundle.
* @return
*/
public Bundle getBundle(){
return mBundle;
}
public interface ImageLoadListener{
public void onStart(BaseSliderView target);
public void onEnd(boolean result,BaseSliderView target);
}
/**
* Get the last instance set via setPicasso(), or null if no user provided instance was set
*
* @return The current user-provided Picasso instance, or null if none
*/
public Picasso getPicasso() {
return mPicasso;
}
/**
* Provide a Picasso instance to use when loading pictures, this is useful if you have a
* particular HTTP cache you would like to share.
*
* @param picasso The Picasso instance to use, may be null to let the system use the default
* instance
*/
public void setPicasso(Picasso picasso) {
mPicasso = picasso;
}
}