Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/onekiloparsec/kpcjumpbarcontrol
A macOS jump bar similar to Xcode's allowing to navigate accross a tree of objects
https://github.com/onekiloparsec/kpcjumpbarcontrol
control jumpbar macos swift swift3
Last synced: about 12 hours ago
JSON representation
A macOS jump bar similar to Xcode's allowing to navigate accross a tree of objects
- Host: GitHub
- URL: https://github.com/onekiloparsec/kpcjumpbarcontrol
- Owner: onekiloparsec
- License: mit
- Created: 2016-05-01T15:25:06.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2019-12-22T13:41:47.000Z (almost 5 years ago)
- Last Synced: 2024-09-24T20:34:31.941Z (about 16 hours ago)
- Topics: control, jumpbar, macos, swift, swift3
- Language: Swift
- Homepage: http://www.onekiloparsec.dev/kpcjumpbarcontrol
- Size: 265 KB
- Stars: 57
- Watchers: 5
- Forks: 6
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
KPCTabsControl •
KPCJumpBarControl •
KPCSplitPanes •
KPCAppTermination •
KPCSearchableOutlineView •
KPCImportSheetController-------
KPCJumpBarControl
==============![](https://img.shields.io/badge/Swift-3.0-blue.svg?style=flat)
[![Build Status](http://img.shields.io/travis/onekiloparsec/KPCJumpBarControl.svg?style=flat)](https://travis-ci.org/onekiloparsec/KPCJumpBarControl)
![Version](https://img.shields.io/cocoapods/v/KPCJumpBarControl.svg?style=flat)
![License](https://img.shields.io/cocoapods/l/KPCJumpBarControl.svg?style=flat)
![Platform](https://img.shields.io/cocoapods/p/KPCJumpBarControl.svg?style=flat)
[![Carthage compatible](https://img.shields.io/badge/Carthage-compatible-4BC51D.svg?style=flat)](https://github.com/Carthage/Carthage)A jump bar similar to Xcode's allowing to easily display and navigate across a tree of objects.
![Demo Jump Bar Screenshot](http://onekilopars.ec/wp-content/uploads/2018/11/KPCJumpBarControlScreenshot2.png)
![Demo JumpBar](http://onekilopars.ec/wp-content/uploads/2018/11/KPCJumpBarControlDemo.gif)
Installation
------------Using [Carthage](https://github.com/Carthage/Carthage): add `github "onekiloparsec/KPCJumpBarControl"` to your `Cartfile` and then run `carthage update`.
Using [CocoaPods](http://cocoapods.org/): `pod 'KPCJumpBarControl'`
Usage
-----KPCJumpBarControl is designed for you to use only the `JumpBarControl` class, and fill it with a tree of object
conforming to `JumpBarItem`. A helper class `JumpBarSegment` is here for that, if you need one.
Simply place a `NSView` in a storyboard or xib, where you need a jump bar, change its class to `JumpBarControl` and
that's it. To react when the jumbpar selection change, implement the `JumpBarControlDelegate` methods.For instance:
```swift
let rootSegment = JumpBarItem(withTitle:"level 0", icon:NSImage(named:"Oval"))
let segment1Item0 = JumpBarItem(withTitle:"level 1.0", icon:NSImage(named:"Polygon"))
let segment1Item1 = JumpBarItem(withTitle:"level 1.1", icon:NSImage(named:"Rectangle"))
rootSegment.children = [segment1Item0, segment1Item1]
self.jumpBar?.useItemsTree([rootSegment])
self.jumpBar?.delegate = self
```Highlighting
------------The jump bar control support the possibility to be highlighted. This is useful when you have multiple subviews, for instance using KPCSplitPanes, each with jump bars, and you need to indicate to the user which subview is actually 'active'.
Author
------[Cédric Foellmi](https://github.com/onekiloparsec) ([@onekiloparsec](https://twitter.com/onekiloparsec))
LICENSE & NOTES
---------------KPCJumpBarControl is licensed under the MIT license and hosted on GitHub at https://github.com/onekiloparsec/KPCJumpBarControl/
Fork the project and feel free to send pull requests with your changes!