Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/gmarm/bettersegmentedcontrol

An easy to use, customizable replacement for UISegmentedControl & UISwitch.
https://github.com/gmarm/bettersegmentedcontrol

carthage cocoa cocoapods ios segmentedcontrol swift swift-3 swift-4 swift-package-manager swift4 swift4-1 swift5 swift5-1 switch ui ui-element uisegmentedcontrol uiswitch

Last synced: 2 days ago
JSON representation

An easy to use, customizable replacement for UISegmentedControl & UISwitch.

Host: GitHub
URL: https://github.com/gmarm/bettersegmentedcontrol
Owner: gmarm
License: mit
Created: 2016-04-03T07:10:24.000Z (over 8 years ago)
Default Branch: master
Last Pushed: 2023-04-11T22:16:40.000Z (over 1 year ago)
Last Synced: 2024-10-29T15:28:39.907Z (about 2 months ago)
Topics: carthage, cocoa, cocoapods, ios, segmentedcontrol, swift, swift-3, swift-4, swift-package-manager, swift4, swift4-1, swift5, swift5-1, switch, ui, ui-element, uisegmentedcontrol, uiswitch
Language: Swift
Size: 4.23 MB
Stars: 2,214
Watchers: 25
Forks: 280
Open Issues: 34
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        # BetterSegmentedControl

![](https://img.shields.io/badge/Swift-5.1-blue.svg?style=flat)

![](https://app.bitrise.io/app/1d06a34a06589be2/status.svg?token=i0xHqYqUAjHGkzToH5FVOg&branch=master)

[![Version](https://img.shields.io/cocoapods/v/BetterSegmentedControl.svg?style=flat)](http://cocoapods.org/pods/BetterSegmentedControl)

[![License](https://img.shields.io/cocoapods/l/BetterSegmentedControl.svg?style=flat)](http://cocoapods.org/pods/BetterSegmentedControl)

[![Platform](https://img.shields.io/cocoapods/p/BetterSegmentedControl.svg?style=flat)](http://cocoapods.org/pods/BetterSegmentedControl)









  






`BetterSegmentedControl` is an easy to use, customizable replacement for

`UISegmentedControl` and `UISwitch` written in Swift.

## Features

- [x] Can be used as a segmented control or switch

- [x] Plethora of customizable options from colors to insets, radii and

animations

- [x] Use text or icons as segments, or add your own custom segments

- [x] Designable straight in Interface Builder

- [x] Accessibility support

- [x] iPad cursor support

- [x] Customizable behavior

- [x] Right-to-left languages support

- [x] Fully tested

Check the latest release notes [here][release-notes]!

[release-notes]: https://github.com/gmarm/BetterSegmentedControl/releases/tag/2.0.1

## Examples

#### iOS

![Demo](Assets/demo_main.gif)

#### iPad cursor

![Demo](Assets/demo_ipad_cursor.gif)

## Requirements

- iOS 9.0+

- Xcode 8+

## Installation

### Swift Package Manager

BetterSegmentedControl is available through Swift Package Manager. To install

it, simply go to Xcode under `File > Swift Packages > Add Package Dependency...`

### CocoaPods

BetterSegmentedControl is available through [CocoaPods](http://cocoapods.org).

To install it, simply add the following line to your Podfile:

```ruby

# Swift 5.1

pod 'BetterSegmentedControl', '~> 2.0'

# Swift 4

pod 'BetterSegmentedControl', '1.0'

# Swift 3 / Objective-C

pod 'BetterSegmentedControl', '0.8'

```

### Manually

If you prefer not to use CocoaPods or Swift Package Manager, you can integrate

BetterSegmentedControl into your project manually.

## Usage

```swift

let control = BetterSegmentedControl(frame: CGRect(x: 16.0,

                                                   y: 0,

                                                   width: view.bounds.width - 32.0,

                                                   height: 44.0))

view.addSubview(control)

```

You can find several ways of using it, such as by designing it in a Storyboard

file or creating it in code in the example project.

To run the example project, clone the repo, and run `pod install` from the

Example directory first.

## Contribution

Feel free to submit Pull Requests or send me your feedback and suggestions!

Logo by [Guillaume Galante][guillaume-dribble].

[guillaume-dribble]: https://dribbble.com/guillaumegalante

## Author

George Marmaridis

- https://github.com/gmarm

- https://twitter.com/gmarmas

- https://www.linkedin.com/in/gmarm

- [email protected]

## License

BetterSegmentedControl is available under the MIT license. See the LICENSE file

for more info.