TOMSMorphingLabel

Configurable morphing transitions between text values of a label.

Code Quality Rank: L5

Programming language: Objective-C

License: MIT License

Tags: UI     Label    

Latest version: v0.5.1

README

TOMSMorphingLabel

Configurable morphing transitions between text values of a label. Triggering the animation is as easy as setting the labels text property.

Demo

[Screen1](demo.gif)

Installation with CocoaPods

TOMSMorphingLabel is available through CocoaPods. To install it, simply add the following line to your Podfile:

Podfile

platform :ios, '7.0'
pod "TOMSMorphingLabel", "~> 0.5"

Usage

Instantiate TOMSMorphingLabel as you would do with an UILabel results in a fully working thus morphing label.

TOMSMorphingLabel *label = [[TOMSMorphingLabel alloc] initWithFrame:CGRectMake(0, 42, self.view.frame.size.width, 42)];
[self.view addSubview:label];

Setting - and particularly changing - the labels text property will automatically morph the labels previous text to the new value.

label.text = @"Swift";

Setting the labels text property using setText:withCompletionBlock will morph the labels as well as triggering the completion block when the animation is finished.

[label setText:@"Swift" withCompletionBlock:^{
  NSLog(@"label.text is now 'Swift'");
}];

Note that the label will execute only one morph transition at a time. If the text value of the label changes during a transition - even if it changes multiple times - the label will invoke a transition to the youngest text value that was set.

Customization

TOMSMorphingLabel provides the possibility to configure the morphing transitions look and feel. The configurable properties are defined as follows:

configurable properties animationDuration: CGFloat Time that elapses between the setting of a new text value and the end of the morphing transition. Default: 0.37 characterAnimationOffset: CGFloat Spatial propagation speed of the character shrink and alpha effect. Default: 0.25 characterShrinkFactor: CGFloat Factor that the scale of a completely disappeared character is divided by. Default: 4 morphingEnabled: BOOL Defines whether the morphing transition between text values is enabled. Default: YES

Changelog

0.5.1

• made custom configurable properties accessible by Interface Builder

0.5.0

• broke a strong reference cycle between CADisplayLink and TOMSMorphingLabel
• added invokation of the completion block when setting text without animations
• respect the global [UIView areAnimationsEnabled] state

0.2.5

• fixed a textColor glitch
• introduced setText:withCompletionBlock:

0.2.3

• fixed a bug that caused a crash when setting text to nil

0.2.2

• added property to disable morphing

0.2.1

• added support for iOS6

0.2.0

• added unicode support

0.1.0

• initial version

Contribution & Contributors

I'd love to see your ideas for improving this library! The best way to contribute is by submitting a pull request or a new Github issue. :octocat:

• @andrebraga added support for iOS6 in version 0.2.1
• @stepanhruda added property to disable morphing in version 0.2.2
• @itouch2 fixed a bug that caused a crash when setting text to nil in version 0.2.3
• @waynehartman fixed text color-change glitch in version 0.2.5
• @cyril94440 added setText:withCompletionBlock: in version 0.2.5
• @wanderwaltz broke a strong reference cycle between CADisplayLink and TOMSMorphingLabel in version 0.5.0
• @wanderwaltz added invokation of the completion block when setting text without animations in version 0.5.0
• @wanderwaltz made TOMSMorphingLabel respect the global [UIView areAnimationsEnabled] state in version 0.5.0
• @fcanas made custom configurable properties accessible by Interface Builder

Author

Tom König @TomKnig

License

TOMSMorphingLabel is available under the MIT license. See the LICENSE file for more info.