Latest 1.0.1
Homepage https://github.com/afishhhhh/YUSegment
License MIT
Platforms ios 8.0, requires ARC
Frameworks UIKit
Authors

[Pod Version]()
Carthage compatible
[Pod Platform]()
[Pod License]()

中文文档

A customizable segmented control for iOS.

YUSegment-demo

Features

  • Supports both (Attributed)text and image
  • Supports show separator
  • Supports hide indicator
  • Indicator could be located at the top and bottom
  • YUSegment works on iOS 8.0+ and is compatible with ARC projects

Installation

Cocoapods

  1. Add a pod entry to your Podfile pod 'YUSegment'
  2. Running pod install
  3. #import <YUSegment/YUSegment.h> where you need

Carthage

github "afishhhhh/YUSegment"

Usage

YUSegmentedControl inherits from UIControl, supports Target-Action.

YUSegmentedControl *segmentedControl = [[YUSegmentedControl alloc] initWithTitles:@[@"健身", @"摄影", @"科技", @"美食", @"旅行"]];
[self.view addSubview:segmentedControl];
[segmentedControl addTarget:self action:@selector(segmentedControlTapped:) forControlEvents:UIControlEventValueChanged];

By default, the background color of segmented control is whiteColor, the color of indicator is darkGrayColor, the height of indicator is 3.0, the color of separator is #e7e7e7.

APIs

Methods

- (instancetype)initWithTitles:(NSArray <NSString *> *)titles;
- (instancetype)initWithImages:(NSArray <UIImage *> *)images;
- (instancetype)initWithImages:(NSArray <UIImage *> *)images
                selectedImages:(nullable NSArray <UIImage *> *)selectedImages;

You can use selectedImages if you want to show different images when a specific segment selected.

- (nullable NSString *)titleAtIndex:(NSUInteger)index;
- (nullable UIImage *)imageAtIndex:(NSUInteger)index;

You can get the corresponding text or image based on a specific index.

- (void)showBadgeAtIndexes:(NSArray <NSNumber *> *)indexes;
- (void)hideBadgeAtIndex:(NSUInteger)index;

example:

[segmentedControl show BadgeAtIndexes:@[@1, @2]];

- (void)setTextAttributes:(nullable NSDictionary *)attributes 
                 forState:(YUSegmentedControlState)state;

The attributes for text. For a list of attributes that you can include in this dictionary, see Character Attributes.
The value of state could be YUSegmentedControlNormal and YUSegmentedControlSelected.

example:

[segmentedControl setTextAttributes:@{
  NSFontAttributeName: [UIFont systemFontOfSize:20.0 weight:UIFontWeightLight],
  NSForegroundColorAttributeName: [UIColor blackColor]
} forState:YUSegmentedControlNormal];

Properties

  • numberOfSegments(NSUInteger, readonly)

     return the number of segments in a segmented control.

  • selectedSegmentIndex(NSUInteger, readonly)

    The index number identifying the selected segment. Default is 0.

  • horizontalPadding

    Default is 0.

    padding-0

     If assign it to 32.0.

    padding-32

  • showsTopSeparator

    A Boolean value that controls whether the top separator is visible. Default is YES.

  • showsBottomSeparator

    A Boolean value that controls whether the bottom separator is visible. Default is YES.

  • showsVerticalDivider

    A Boolean value that controls whether the vertical divider is visible. Default is NO.

  • showsIndicator

    A Boolean value that controls whether the indicator is visible. Default is YES.

  • backgroundColor(YUSegmentedControl)

    The background color of segmented control. Default is white.

  • height(YUSegmentedControlIndicator)

    The height of indicator. Default is 3.0.
    You should use this property like this:

    segment.indicator.height = 3.0;
  • locate(YUSegmentedControlIndicator)

    The vertical alignment of indicator. Default is YUSegmentedControlIndicatorLocateBottom. Also could be YUSegmentedControlIndicatorLocateTop
    You should use this property like this:

    segment.indicator.locate = YUSegmentedControlIndicatorLocateTop;
  • backgroundColor(YUSegmentedControlIndicator)

    The background color of indicator. Default is dark gray.
    You should use this property like this:

    segment.indicator.backgroundColor = [UIColor whiteColor];

License

This code is distributed under the terms and conditions of the MIT license.

Latest podspec

{
    "name": "YUSegment",
    "version": "1.0.1",
    "summary": "A customizable Segmented Control for iOS. Supports text and image.",
    "description": "#YUSegmentnnA customizable **Segmented Control** for iOS. Supports text and image.nn##RequirementsnnYUSegment works on iOS 8.0 and later version and is compatible with ARC projects.",
    "homepage": "https://github.com/afishhhhh/YUSegment",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    },
    "authors": {
        "afishhhhh": "[email protected]"
    },
    "platforms": {
        "ios": "8.0"
    },
    "source": {
        "git": "https://github.com/afishhhhh/YUSegment.git",
        "tag": "1.0.1"
    },
    "source_files": [
        "Pod",
        "Pod/**/*.{h,m}"
    ],
    "frameworks": "UIKit",
    "requires_arc": true
}

Pin It on Pinterest

Share This