[翻译] UPCardsCarousel
UPCardsCarousel
UPCardsCarousel
is a carousel with a cards based UI for iOS.
UPCardsCarousel是一个旋转木马效果的UI控件.
UPCardsCarousel
Requirements
UPCardsCarousel
uses ARC and requires iOS 7.0+.
需要ARC,iSO7.0以上.
Works for iPhone.
只针对iPhone开发.
Installation
CocoaPods
UPCardsCarousel is available through CocoaPods. To install it, simply add the following line to your Podfile:
你可以通过 CocoaPods 来安装.执行以下一段话即可.
pod "UPCardsCarousel"
Manual
Simply copy the folder UPCardsCarousel
to your project and import it in XCode.
你只需要将UPCardsCarousel文件夹复制到你的项目中即可.
Usage
Start by importing the header file:
一开始,先引入头文件:
#import "UPCardsCarousel.h"
Now, you can create a UPCardsCarousel
object by giving it a frame:
然后,你可以创建出UPCardsCarousel实体,然后给定一个frame值:
UPCardsCarousel *carousel = [[UPCardsCarousel alloc] initWithFrame:aFrame];
Then you need to assign to it:
之后,你需要设定代理以及给代理提供数据:
- a
delegate
object that conforms to theUPCardsCarouselDelegate
protocol - a
dataSource
object that conforms to theUPCardsCarouselDataSource
protocol
Data Source
The data source informs the carousel about the total number of cards and the content of each card through two self-explanatory methods:
数据源是给carousel提供有多少张卡片,以及每张图片上面的内容:
- (NSUInteger)numberOfCardsInCarousel:(UPCardsCarousel *)carousel
(required)- (UIView *)carousel:(UPCardsCarousel *)carousel viewForCardAtIndex:(NSUInteger)index
(required)
The labels in the banner are given with an optional method. If the data source doesn't implement this method, the label banner will not be displayed.
以下方法是可选方法,用来给卡片提供标题的,如果没有实现,默认是不会显示出来的.
- (NSString *)carousel:(UPCardsCarousel *)carousel labelForCardAtIndex:(NSUInteger)index
(optional)
Delegate
The delegate is optional and will be notified when some events occur:
代理方法是非必须的,用以提示事件发生的时机:
- (void)carousel:(UPCardsCarousel *)carousel didTouchCardAtIndex:(NSUInteger)index
- (void)carousel:(UPCardsCarousel *)carousel willDisplayCardAtIndex:(NSUInteger)index
- (void)carousel:(UPCardsCarousel *)carousel willHideCardAtIndex:(NSUInteger)index
- (void)carousel:(UPCardsCarousel *)carousel didDisplayCardAtIndex:(NSUInteger)index
- (void)carousel:(UPCardsCarousel *)carousel didHideCardAtIndex:(NSUInteger)index
Methods
Method | Description |
---|---|
reloadData | Reloads the carousel data and recreates the visible cards and moves to the top of the cards deck |
reloadDataWithCurrentIndex:(NSUInteger)index | Reloads the carousel data and recreates the visible cards and moves to the specified index in the cards deck |
reloadNumberOfCards | Reloads only the number of cards in the carousel and doesn't change the visible cards |
reloadCardAtIndex:(NSUInteger)index | Recreates the card at the specified index |
cardAtIndex:(NSUInteger)index | Return the card view at the specified index |
Customization
Cards Deck
Usually, the carousel will not display all the cards supplied by the data source at once. It will handle a infinite scrolling process by destroying and creating cards at both ends. The number of visible cards is given and can be customized through the following property:
通常情况下,carousel不会一下子显示出所有的图片.他有重用机制,并支持无限滑滚.可见的卡片数由以下方法提供:
maxVisibleCardsCount
(default is 6)
You can customize the duration of the card movement between the hidden deck and the visible deck, with this property:
你可以定制每张卡片的移动时间,默认是0.4秒:
movingAnimationDuration
(defaut is 0.4 seconds)
By default, the carousel will return to the top of the deck when making a double-tap on the first hidden card.
默认情况下,双击carousel会返回第一张显示的图片.
You can disable this behaviour by setting the doubleTapToTop
property to NO
.
你可以禁用双击功能.
Labels Banner
You can customize the text font and color of the banner through these two methods:
你可以通过以下两个方法来定制横幅:
- (void)setLabelFont:(UIFont *)font
(default is system font)- (void)setLabelTextColor:(UIColor*)color
(default is[UIColor blackColor]
)
You can choose between two locations for the banner through the labelBannerPosition
property:
你可以通过labelBannerPosition属性来设置位移值:
UPCardsCarouselLabelBannerLocation_bottom
- the banner will be located below the cards deck (default)UPCardsCarouselLabelBannerLocation_top
- the banner will be located above the cards deck
Finally, you also have access to the banner view object through the labelBanner
property so you can customize it as you want.
当然,你也可以写你自己的横幅view.给labelBanner赋值即可.
License
The MIT License (MIT)
Copyright (c) 2014 Paul Ulric
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
[翻译] UPCardsCarousel的更多相关文章
- 《Django By Example》第五章 中文 翻译 (个人学习,渣翻)
书籍出处:https://www.packtpub.com/web-development/django-example 原作者:Antonio Melé (译者@ucag注:大家好,我是新来的翻译, ...
- 《Django By Example》第四章 中文 翻译 (个人学习,渣翻)
书籍出处:https://www.packtpub.com/web-development/django-example 原作者:Antonio Melé (译者注:祝大家新年快乐,这次带来<D ...
- [翻译]开发文档:android Bitmap的高效使用
内容概述 本文内容来自开发文档"Traning > Displaying Bitmaps Efficiently",包括大尺寸Bitmap的高效加载,图片的异步加载和数据缓存 ...
- 【探索】机器指令翻译成 JavaScript
前言 前些时候研究脚本混淆时,打算先学一些「程序流程」相关的概念.为了不因太枯燥而放弃,决定想一个有趣的案例,可以边探索边学. 于是想了一个话题:尝试将机器指令 1:1 翻译 成 JavaScript ...
- 《Django By Example》第三章 中文 翻译 (个人学习,渣翻)
书籍出处:https://www.packtpub.com/web-development/django-example 原作者:Antonio Melé (译者注:第三章滚烫出炉,大家请不要吐槽文中 ...
- 《Django By Example》第二章 中文 翻译 (个人学习,渣翻)
书籍出处:https://www.packtpub.com/web-development/django-example 原作者:Antonio Melé (译者注:翻译完第一章后,发现翻译第二章的速 ...
- 《Django By Example》第一章 中文 翻译 (个人学习,渣翻)
书籍出处:https://www.packtpub.com/web-development/django-example 原作者:Antonio Melé (译者注:本人目前在杭州某家互联网公司工作, ...
- 【翻译】Awesome R资源大全中文版来了,全球最火的R工具包一网打尽,超过300+工具,还在等什么?
0.前言 虽然很早就知道R被微软收购,也很早知道R在统计分析处理方面很强大,开始一直没有行动过...直到 直到12月初在微软技术大会,看到我软的工程师演示R的使用,我就震惊了,然后最近在网上到处了解和 ...
- ASP.NET MVC with Entity Framework and CSS一书翻译系列文章之第一章:创建基本的MVC Web站点
在这一章中,我们将学习如何使用基架快速搭建和运行一个简单的Microsoft ASP.NET MVC Web站点.在我们马上投入学习和编码之前,我们首先了解一些有关ASP.NET MVC和Entity ...
随机推荐
- Java并发编程笔记之LongAdder和LongAccumulator源码探究
一.LongAdder原理 LongAdder类是JDK1.8新增的一个原子性操作类.AtomicLong通过CAS算法提供了非阻塞的原子性操作,相比受用阻塞算法的同步器来说性能已经很好了,但是JDK ...
- json对象按时间排序
//正序var data = {"rows": [{"name": "张三","time": "2011/4/ ...
- ruby文件操作
Ruby代码 1.#读文件 2.f = File.open("myfile.txt", "r") 3.f.each_line do|line| 4.puts & ...
- Beta阶段——Scrum 冲刺博客第一天
一.当天站立式会议照片一张 二.每个人的工作 (有work item 的ID),并将其记录在码云项目管理中 昨天已完成的工作 今日是Beta冲刺第一天,昨日没有完成的工作 今天计划完成的工作 实现对i ...
- 存储树形的数据表转为Json
/// <summary> /// 根据DataTable生成Json树结构 /// </summary> /// <param name="tabel&quo ...
- Feign性能优化注意事项--超时
Caused by: java.lang.IllegalStateException: PathVariable annotation was empty on param 1. at feign ...
- c# 键值对照表
虚拟键值表 虚拟键 十六进制值 十进制值 相应键盘或鼠标键 VK_LBUTTON 1 1 鼠标左键 VK_RBUTTON 2 2 鼠标右键 VK_CANCEL 3 3 Ctrl-Break键 VK_M ...
- [转]ASP.NET cache缓存的用法
本文转自:https://blog.csdn.net/mss359681091/article/details/51076712 本文导读:在.NET运用中经常用到缓存(Cache)对象.有HttpC ...
- @Html.Raw()用法和Html.ActionLink的用法总结
@Html.Raw() 方法输出带有html标签的字符串, 如:@Html.Raw("<div style='color:red'>输出字符串</div>" ...
- C# 实现二叉树各种排序
1. 引言 在实际的项目中,树还是用的比较多的一种,尤其是对于具有层次结构的数据.相信很多人都学过树的遍历,比如先序遍历,后序遍历等,利用递归还是很容易理解的. 今天给大家介绍下二叉树的几种遍历算法, ...