TOMSMorphingLabel 0.5.1

Maintained by Tom König.

You want to add pod 'TOMSMorphingLabel', '~> 0.5' similar to the following to your Podfile:

target 'MyApp' do
  pod 'TOMSMorphingLabel', '~> 0.5'
end

Then run a pod install inside your terminal, or from CocoaPods.app.

Alternatively to give it a test run, run the command:

pod try TOMSMorphingLabel

TOMSMorphingLabel 0.5.1

By
TomKnig
TomKnig

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

Demo

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 configureable properties are defined as follows:

configureable 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 configureable 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.

@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 configureable 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.