• Stars
    star
    195
  • Rank 199,374 (Top 4 %)
  • Language
    Objective-C
  • License
    MIT License
  • Created over 5 years ago
  • Updated almost 3 years ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

A segmented control in the style of iOS 13 compatible with previous versions of iOS.

TOSegmentedControl

TOSegmentedControl

CI Version Carthage compatible GitHub license Platform PayPal Twitch

As part of the visual improvements featured in iOS 13, UISegmentedControl was completely redesigned, featuring a much rounder, cleaner, and slightly more skeuomorphic appearance.

TOSegmentedControl is a subclass of of UIControl that completely re-implements the look and feel of the new UISegmentedControl component, allowing developers to adopt its look even in previous versions of iOS they support.

Features

  • Recreates the new look of UISegmentedControl, making it available on previous versions of iOS.
  • Supports both text and images as segment types.
  • Support for @IBDesignable and @IBInspectable.
  • Configurable to dynamically add or remove items after its creation.
  • Written in Objective-C, but provides full compatibility with Swift.
  • Provides both a block, or UIControlEvents to receive when the control is tapped.
  • Light and dark mode support for iOS 13.
  • A reversible mode where tapping the same item twice flips its direction.

Sample Code

TOSegmentedControl has been written to follow the interface of UISegmentedControl as closely as possible. This should make it very intuitive to work with.

Swift

In Swift, the class is renamed to SegmentedControl. Creating a new instance is very similar to UISegmentedControl.

// Create a new instance
let segmentedControl = SegmentedControl(items: ["First", "Second", "Third"])

// Add a closure that will be called each time the selected segment changes
segmentedControlsegmentTappedHandler = { segmentIndex, reversed in
   print("Segment \(segmentIndex) was tapped!")
}

// Add a new item to the end
segmentedControl.addSegment(withTitle: "Fourth")

// Insert a new item at the beginning
segmentedControl.insertSegment(withTitle: "Zero", at: 0)

// Remove all segments
segmentedControl.removeAllSegments()

Objective-C

NSArray *items = @[@"First", @"Second", @"Third"];

// Create a new instance
TOSegmentedControl *segmentedControl = [[TOSegmentedControl alloc] initWithItems:items]];

// Add a block that will be called each time the selected segment changes
segmentedControl.segmentTappedHandler = ^(NSInteger index, BOOL reversed) {
    NSLog(@"Segment %d was tapped!", index);
};

// Add a new item to the end
[segmentedControl addSegmentWithTitle:@"Fourth"];

// Insert a new item at the beginning
[segmentedControl insertSegmentWithTitle:@"Zero" atIndex:0];

// Remove all segments
[segmentedControl removeAllSegments];

System Requirements

iOS 9.0 or above

Installation

CocoaPods

Add the following to your Podfile:

pod 'TOSegmentedControl'
Carthage
  1. Add the following to your Cartfile:
github "TimOliver/TOSegmentedControl"
  1. Run carthage update

  2. From the Carthage/Build folder, import the TOSegmentedControl.framework.

  3. Follow the remaining steps on Getting Started with Carthage to finish integrating the framework.

Manual Installation

All of the necessary source files located in the TOSegmentedControl folder. Simply drag that folder into your Xcode project.

Credits

TOSegmentedControl was created by Tim Oliver as a component for iComics.

iOS device mockup by Pixeden.

License

TOSegmentedControl is available under the MIT license. Please see the LICENSE file for more information. analytics

More Repositories

1

TOCropViewController

A view controller for iOS that allows users to crop portions of UIImage objects
Objective-C
4,571
star
2

TOWebViewController

A view controller class for iOS that allows users to view web pages directly within an app.
Objective-C
1,490
star
3

TORoundedButton

A high-performance button control with rounded corners for iOS.
Objective-C
481
star
4

PassKit-Business-Card

A template for iOS Wallet passes that can be used like business cards.
Objective-C
387
star
5

TOPasscodeViewController

A modal passcode input and validation view controller for iOS
Objective-C
383
star
6

TONavigationBar

Replicating the 'clear' navigation bar style of the iOS 12 Apple TV app.
Objective-C
248
star
7

TOStatusBarSimulator

Replaces the iOS system status bar with a configurable mockup for the purpose of marketing screenshots.
Objective-C
199
star
8

TOGlintyStringView

A non-App Store safe re-implementation of the 'slide to unlock' visual effect on iOS.
Objective-C
186
star
9

TOSMBClient

An Objective-C binding around the libDSM SMB client library.
Objective-C
177
star
10

TOActionSheet

A custom-designed reimplementation of the UIActionSheet control for iOS
Objective-C
173
star
11

TORoundedTableView

A subclass of UITableView that styles it like Settings.app on iPad
Objective-C
160
star
12

RealmBrowser-iOS

A native iOS debugging framework for introspecting Realm files on device
Objective-C
148
star
13

TOSearchBar

A basic reimplementation of UISearchBar with easier theming, and nicer animation.
Objective-C
104
star
14

TOScrollBar

An interactive scroll bar for traversing comically massive scroll views.
Objective-C
91
star
15

PHP-Framework-Classes

A collection of PHP classes I've developed for personal projects.
PHP
83
star
16

TOInsetGroupedTableView

An iOS 11 back-port of the grouped inset table view style in iOS 13.
Objective-C
79
star
17

TODocumentPickerViewController

An open-source implementation for picking files/folders out of an online API
Objective-C
78
star
18

WebPKit

A framework that extends a variety of Cocoa APIs with capabilities for encoding and decoding WebP files for all of Apple's platforms.
Swift
67
star
19

TOSplitViewController

A split view controller that can display up to three view controllers at once.
Objective-C
60
star
20

Beeline

An extremely lean implementation on the classic iOS router pattern.
Swift
59
star
21

TOFileSystemObserver

A bullet-proof mechanism for detecting any changes made to the contents of a folder in iOS and macOS.
Objective-C
38
star
22

TOAlertViewController

A modern looking modal popup UI component for iOS and iPadOS.
Objective-C
24
star
23

TOAppSettings

An object wrapper for storing properties in NSUserDefaults.
Objective-C
24
star
24

TOAppRater

A very small library to provide a classier way of requesting app reviews.
Objective-C
21
star
25

TOBrowserActivityKit

A set of UIActivity subclasses for opening NSURL objects in Chrome or Safari.
Objective-C
20
star
26

TOReachability

A lightweight, unit-tested class that detects network status changes on iOS.
Objective-C
20
star
27

WebP-Cocoa

An unofficial collection of precompiled WebP binaries for all of Apple's current platforms.
Shell
18
star
28

BuildingHighPerformanceListsAndCollectionViews

A mirror of Apple's sample code for high performance collection views in iOS 15.
Swift
18
star
29

TOBadgeView

A badge view that can be used to accessorize other UI elements in iOS.
Objective-C
16
star
30

TOPagingView

A paging scroll view that can handle arbitrary numbers of page views at run-time.
Objective-C
14
star
31

TOBorderView

A flexible container view featuring a solid background with rounded corners.
Objective-C
14
star
32

TOGridView

A lightweight collection view for iOS
Objective-C
13
star
33

TORevealViewController

An alternative to UISplitViewController on both iPhone and iPad
Objective-C
11
star
34

TORoundedWindow

A UIWindow overlay that adds rounded corners to an iOS app display region
Objective-C
10
star
35

TOSegmentedTabBarController

A splittable tab bar controller controlled by a segmented control view.
Objective-C
9
star
36

TOWebContentViewController

A view controller to quickly render arbitrary local HTML content.
Objective-C
9
star
37

TODocumentsDirectoryWatcher

Automatically observes an iOS app's Documents directory for file changes.
Objective-C
8
star
38

TOPagerView

A UIScrollView subclass that allows paged horizontal swiping with a re-use mechansim similar to UITableView.
Objective-C
8
star
39

TOSegmentedSplitViewController

A split view controller that is controlled by a segmented control on small devices
Objective-C
8
star
40

TOFileKit

Not ambitious at all.
Objective-C
7
star
41

AVRecorder

A mirror of the AVRecorder sample app for macOS by Apple
Objective-C
7
star
42

TOTabBarController

A tab bar controller that mimics the vertical tool bar style of Tweetbot 4.
Objective-C
7
star
43

PhotoSorter

A quick and dirty CLI tool for sorting my photo library
Swift
7
star
44

YozoraRedux

My personal color theme I use in Xcode. Tweaked from Yozora and Sublime Text.
7
star
45

LargeImageDownsizing

Mirror of Apple's sample code for partially decoding regions of images into memory
Objective-C
6
star
46

RLMFastImage

A prototype for storing raw pixel data in Realm.
Objective-C
6
star
47

WebServerKit

A fork of the #1 HTTP server for iOS, macOS & tvOS
Objective-C
5
star
48

TOFileAttributes

A Realm-like dynamic property wrapper that maps to APFS extended file attributes.
Objective-C
5
star
49

BTLE-Transfer

A mirror of the Apple sample code that demonstrates how to work with Core Bluetooth
Objective-C
5
star
50

Spackle

A collection of convenience properties and extensions for laying out views in UIKit
Swift
5
star
51

UIColor-LegacySemanticColors

A UIColor category that backports the new semantic colors of iOS 13 to iOS 12.
Objective-C
5
star
52

SLVolumeButtonListener

A class for iOS that lets apps intercept events from the device's volume buttons
Objective-C
4
star
53

TimOliver

My GitHub README.md repository. Feel free to copy and re-use this as a template for your own GitHub account! 😁
4
star
54

TOLocalServiceDiscovery

A wrapper for detecting accessible devices locally via Bonjour.
Objective-C
4
star
55

AnimeLabPiP

A Safari Extension to enable Picture-in-Picture with AnimeLab's web player.
JavaScript
4
star
56

TOTARArchive

A basic library to allow streaming data out of TAR files
Objective-C
3
star
57

TOStackView

A barebones container view for UIKit that stacks collections of subviews
Objective-C
3
star
58

icomics.co

The source code to the official iComics website.
PHP
3
star
59

CI

A central repo for the build scripts used for testing and deploying my projects
Ruby
3
star
60

TOPropertyAccessor

Swift Property Wrappers, but in Objective-C. And done horribly.
Objective-C
3
star
61

simple-iphone-image-processing

Automatically exported from code.google.com/p/simple-iphone-image-processing
Objective-C++
2
star
62

CloudKit-PHP

For server-to-server comms from PHP to CloudKit.
PHP
2
star
63

UIDevice-UserInterfaceExtendedIdiom

An Objective-C category to allow easier detection of newer iOS device UI idioms (such as iPhone 5).
Objective-C
2
star
64

vCard

The source code to my online vCard site.
PHP
2
star
65

Dexter

An extensible encyclopedia engine
1
star
66

rchat

Swift
1
star
67

SteamAppCatalog

A dump of all of the JSON files extracted from Steam's store
1
star
68

SteamLibraryDatabase

A small utility to copy the entire Steam game library to a Realm database.
Objective-C
1
star
69

ObjC-WebPImage

An Objective-C framework for encoding and decoding WebP image files
Objective-C
1
star