/TOMSMorphingLabel

Configurable morphing transitions between text values of a label.

Primary LanguageObjective-CMIT LicenseMIT

TOMSMorphingLabel

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

Demo

Screen1

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.