05图片轮播控件开发文档

为何要再写图片轮播控件

当然图片轮播控件这种东西真是被写烂了,这里再写一次的原因有三点:一是目前已知的图片轮播控件都在重复同样的功能点(类似于简书客户端的轮播),其实开发者对于图片轮播控件还有很多其它的需求;二是目前我并没有看到比较好的代码,同时基于开发者对于轮播控件的复杂需求,代码也会变得复杂起来(上千行的代码实现);三是我在学校里组织的兴趣小组打算同时编写iOS、Android、Web(基于JS)三个平台的代码,提供一致的特性和服务,并将其开源。三个平台的代码均会在对应作者的博客中进行详细讲解,代码作者的详细信息如下:

说明

该文档由梁志鹏编写,如有问题请直接在评论中回复或邮件联系mingjiameng@sina.com。文档主要描述了用户需求、规范了接口及控制变量。文档中的示例均基于iOS平台,仅供参考。在具体的代码实现中,请注意后期的优化(提高安全性、鲁棒性、性能等,具体请参照),并在接口中提供详细的注释。把文档直接当一篇文章写的目的有两个:一是将来任何一个人都可以参照这个文档尝试实现图片轮播控件;二是这个文档正好可以作为控件的使用手册。

用户需求

待更。。。话说切图真的好麻烦啊。。。

0.1版本应该实现的功能点

输入:控件的frame(位置及大小)、图片数组(images)
输出:一个图片轮播组件,该组件带有指示器(组件内部下方的小圆点),能够定时切换图片并更新指示器。注意轮播的含义是播放到最后一张图片后,又重新开始播放第一张图片,这两张图片之间的切换效果应该和其它图片之间的切换效果相同。具体的效果图参照知乎日报或者简书的图片轮播组件。

接口:(以iOS为例)

@property (nonatomic, strong, nonnull, readonly) NSArray *images; // image array that you use to initialize this instance.

/*
 * you are supposed to use this initializer to get an instance.
 * if you try to get an instance by system initializer, you will fail.
 * param 'images' should contain only UIImage object, or you will receive a nil instance.
 * if array 'images' contain no object, you will receive a nil instance. 
 */
- (nullable instancetype)initWithFrame:(CGRect)frame andImages:(nonnull NSArray *)images;

用户通过该方法得到一个控件的实例,同时在使用过程中可以访问images数组,但不能修改。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,319评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,801评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,567评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,156评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 61,019评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,090评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,500评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,192评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,474评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,566评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,338评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,212评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,572评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,890评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,169评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,478评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,661评论 2 335

推荐阅读更多精彩内容

  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,050评论 25 707
  • 发现 关注 消息 iOS 第三方库、插件、知名博客总结 作者大灰狼的小绵羊哥哥关注 2017.06.26 09:4...
    肇东周阅读 11,943评论 4 60
  • 从答辩时间确定到突发奇想去迪士尼花了一个小时,从想到开始实施旅行计划花了两个小时,怎么说也算是第一次说走...
    younger柯阅读 329评论 2 3
  • 1.那时候,人们在示拿建城造塔,说一种语言 2.耶和华把人从那里分散到全地上,使他们的语言混乱 3.闪的后代:闪 ...
    瓦登之湖阅读 2,326评论 0 0
  • 各位家长朋友们下午好,欢迎来到高一十五班,虽然和各位第一次见面,其实大家早在微信中和qq群中相熟已久,许多家长也都...
    心如美玉阅读 1,367评论 2 7