Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/overboming/ZCAnimatedLabel

UILabel replacement with fine-grain appear/disappear animation
https://github.com/overboming/ZCAnimatedLabel

Last synced: about 1 month ago
JSON representation

UILabel replacement with fine-grain appear/disappear animation

Host: GitHub
URL: https://github.com/overboming/ZCAnimatedLabel
Owner: overboming
License: mit
Created: 2015-03-11T09:14:32.000Z (almost 10 years ago)
Default Branch: master
Last Pushed: 2021-02-16T16:12:49.000Z (almost 4 years ago)
Last Synced: 2024-04-24T14:49:59.204Z (9 months ago)
Language: Objective-C
Homepage:
Size: 66.4 KB
Stars: 2,290
Watchers: 43
Forks: 222
Open Issues: 20
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

awesome-ios - ZCAnimatedLabel - UILabel replacement with fine-grain appear/disappear animation (UI / Label)
awesome-ios-star - ZCAnimatedLabel - UILabel replacement with fine-grain appear/disappear animation (UI / Label)
Awesome-iOS - ZCAnimatedLabel - UILabel replacement with fine-grain appear/disappear animation (UI Components)

README

        # ZCAnimatedLabel

UILabel-like view with easy to extend appear/disappear animation

# Features

* Rich text support (with NSAttributedString)

* Group aniamtion by character/word/line

* Customizable animation start delay for each text block

* Great performance, only changed area is redrawn

* Optional layer-based implementation

* 3D/Geometry transform support (layer based only)

* iOS 5+ compatibility

# Demo

* Default 

![image](http://zippy.gfycat.com/LimitedWigglyGermanshepherd.gif)

* Fall

 

![image](http://zippy.gfycat.com/FantasticGargantuanHog.gif)

* Duang/Spring 

![image](http://zippy.gfycat.com/GrippingMeanJavalina.gif)

* Flyin 

![image](http://zippy.gfycat.com/JampackedCompetentGerbil.gif)

* Focus 

![image](http://zippy.gfycat.com/FeistyShockingGermanshepherd.gif)

* Shapeshift  

![image](http://zippy.gfycat.com/ForkedScalyKagu.gif)

* Reveal 

![image](http://zippy.gfycat.com/GrouchyLastingGrizzlybear.gif)

 

* Thrown

 ![image](http://zippy.gfycat.com/RashDecimalImperatorangel.gif)

* Transparency 

![image](http://zippy.gfycat.com/NeighboringSlightJumpingbean.gif)

* Spin 

![image](http://zippy.gfycat.com/UnderstatedBoldAlpineroadguidetigerbeetle.gif)

* Dash 

![image](http://zippy.gfycat.com/DeadlyUnlinedJunco.gif)

* More to come

# How to use

`ZCAnimatedLabel` is available via CocoaPods. If you don't need all the effect subclasses, simply drag `ZCAnimatedLabel.(h|m)`, `ZCCoreTextLayout.(h|m)` and `ZCEasingUtil.(h|m)` into your project and start customizing your own.

# Subclassing

`ZCAnimatedLabel` has two modes: non-layer based and layer based. In the first mode, `ZCAnimatedLabel` is a flat `UIView`, every stage of animation is drawn using Core Graphics, you can customize redraw area for your animation for better performance. Following methods can be overriden:

* `- (void) textBlockAttributesInit: (ZCTextBlock *) textBlock;`

* `- (void) appearStateDrawingForRect: (CGRect) rect textBlock: (ZCTextBlock *) textBlock;`

* `- (void) disappearStateDrawingForRect: (CGRect) rect textBlock: (ZCTextBlock *) textBlock;`

* `- (CGRect) redrawAreaForRect: (CGRect) rect textBlock: (ZCTextBlock *) textBlock;`

Second option is layer based, where each text block is a simple `CALayer`, 3D tranform is possible in this mode by setting layer's `transform` property, if redraw area is bigger and not too many text blocks, this can achive a performance gain. Set `self.layerBased` to `YES` and override following methods for customization:

* `- (void) textBlockAttributesInit: (ZCTextBlock *) textBlock;`

* `- (void) appearStateLayerChangesForTextBlock: (ZCTextBlock *) textBlock;`

* `- (void) disappearLayerStateChangesForTextBlock: (ZCTextBlock *) textBlock;`

# Todo

* Merge CALayers no longer animating into a single backing store and reuse CALayer for animating layers. (Even better performance for layerBased implementation)

* More Effects, possily glyph related ones

* Use core animation emmiter

# Thanks to

* [`LTMorhpingLabel`](https://github.com/lexrus/LTMorphingLabel) for heavy inspiration. If you like `ZCAnimatedLabel`, you should definitely this one out. 

* [`AGGeometryKit`](https://github.com/hfossli/AGGeometryKit) for arbitrary shape 3D transform code piece used in `ZCDashLabel`