Skip to content

tomknig/TOMSMorphingLabel

Repository files navigation

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.2.3"

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";

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

Author

Tom König @TomKnig

License

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

About

Configurable morphing transitions between text values of a label.

Resources

License

Stars

Watchers

Forks

Packages

No packages published