Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/afishhhhh/YUSegment
A customizable Segmented Control for iOS. Supports text and image.
https://github.com/afishhhhh/YUSegment
Last synced: 6 days ago
JSON representation
A customizable Segmented Control for iOS. Supports text and image.
- Host: GitHub
- URL: https://github.com/afishhhhh/YUSegment
- Owner: afishhhhh
- License: mit
- Created: 2016-11-17T11:37:13.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2019-05-29T04:59:02.000Z (over 5 years ago)
- Last Synced: 2024-11-18T05:40:33.520Z (24 days ago)
- Language: Objective-C
- Homepage:
- Size: 1.37 MB
- Stars: 111
- Watchers: 3
- Forks: 22
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ios - YUSegment - A customizable segmented control for iOS. Supports both text and image. (UI / Segmented Control)
- awesome-ios-star - YUSegment - A customizable segmented control for iOS. Supports both text and image. (UI / Segmented Control)
README
# YUSegment
[]()
[](https://github.com/Carthage/Carthage)
[]()
[]()
[中文文档](https://afishhhhh.github.io/2017/04/05/yusegment-doc/)
A customizable segmented control for iOS.
## 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 ` where you need
### Carthage
`github "afishhhhh/YUSegment"`
## Usage
`YUSegmentedControl` inherits from `UIControl`, supports `Target-Action`.
```objective-c
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
```objective-c
- (instancetype)initWithTitles:(NSArray *)titles;
- (instancetype)initWithImages:(NSArray *)images;
- (instancetype)initWithImages:(NSArray *)images
selectedImages:(nullable NSArray *)selectedImages;
```
You can use `selectedImages` if you want to show different images when a specific segment selected.
```objective-c
- (nullable NSString *)titleAtIndex:(NSUInteger)index;
- (nullable UIImage *)imageAtIndex:(NSUInteger)index;
```
You can get the corresponding text or image based on a specific index.
```objectve-c
- (void)showBadgeAtIndexes:(NSArray *)indexes;
- (void)hideBadgeAtIndex:(NSUInteger)index;
```
example:
```objective-c
[segmentedControl show BadgeAtIndexes:@[@1, @2]];
```
```objective-c
- (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](https://developer.apple.com/reference/foundation/nsattributedstring/character_attributes).
The value of `state` could be `YUSegmentedControlNormal` and `YUSegmentedControlSelected`.
example:
```objective-c
[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.
If assign it to 32.0.
* 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:
```objective-c
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:
```objective-c
segment.indicator.locate = YUSegmentedControlIndicatorLocateTop;
```
* backgroundColor(YUSegmentedControlIndicator)
The background color of indicator. Default is dark gray.
You should use this property like this:
```objective-c
segment.indicator.backgroundColor = [UIColor whiteColor];
```
## License
This code is distributed under the terms and conditions of the [MIT license](LICENSE).