Latest 0.1.1
Homepage https://github.com/matthewcheok/MCNumberLabel
License MIT
Platforms ios 7.0, requires ARC
Authors

Drop-in label control with the ability to animate digits.

Screenshot

Screenshot

Installation

Add the following to your CocoaPods Podfile

pod 'MCNumberLabel'

or clone as a git submodule,

or just copy files in the MCNumberLabel folder into your project.

Using MCNumberLabel

Simply call methods -setValue:animated: or -setValue:duration: to animate digits.

[self.numberLabel setValue:@(100) animated:YES];

or

[self.numberLabel setValue:@(100) duration:0.5];

Configuring the NSNumberFormatter

You can specify more granular options for displaying numbers using the formatter property on MCNumberLabel.

An example for configuring a thousands separator is as follows:

self.numberLabel.formatter.usesGroupingSeparator = YES;
self.numberLabel.formatter.groupingSeparator = @",";
self.numberLabel.formatter.groupingSize = 3;

Using Proportional Numbers

You can present more readable digits by using proportional numbers. The following snippet from WWDC 2013 Session 223 would configure such fonts:

UIFont *const existingFont = [UIFont preferredFontForTextStyle:UIFontTextStyleBody];
UIFontDescriptor *const existingDescriptor = [existingFont fontDescriptor];

NSDictionary *const fontAttributes = @{
    // Here comes that array of dictionaries each containing UIFontFeatureTypeIdentifierKey
    // and UIFontFeatureSelectorIdentifierKey that the reference mentions.
    UIFontDescriptorFeatureSettingsAttribute: @[
        @{
            UIFontFeatureTypeIdentifierKey: @(kNumberSpacingType),
            UIFontFeatureSelectorIdentifierKey: @(kProportionalNumbersSelector)
        },
        @{
            UIFontFeatureTypeIdentifierKey: @(kCharacterAlternativesType),
            UIFontFeatureSelectorIdentifierKey: @(1)
        }]
};

UIFontDescriptor *const proportionalDescriptor = [existingDescriptor fontDescriptorByAddingAttributes:fontAttributes];
UIFont *const proportionalFont = [UIFont fontWithDescriptor:proportionalDescriptor size:64];
self.numberLabel.font = proportionalFont;

License

MCNumberLabel is under the MIT license.

Latest podspec

{
    "name": "MCNumberLabel",
    "version": "0.1.1",
    "platforms": {
        "ios": "7.0"
    },
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    },
    "summary": "Drop-in label control with the ability to animate digits.",
    "homepage": "https://github.com/matthewcheok/MCNumberLabel",
    "authors": {
        "Matthew Cheok": "[email protected]"
    },
    "requires_arc": true,
    "source": {
        "git": "https://github.com/matthewcheok/MCNumberLabel.git",
        "branch": "master",
        "tag": "0.1.1"
    },
    "source_files": "MCNumberLabel/*.{h,m}",
    "public_header_files": "MCNumberLabel/MCNumberLabel.h"
}

Pin It on Pinterest

Share This