UDBarTrackballItem 1.0.0

UDBarTrackballItem 1.0.0

TestsTested
LangLanguage Obj-CObjective C
License MIT
ReleasedLast Release Dec 2014

Maintained by Unclaimed.


Downloads

Total7
Week0
Month0

Installs

Apps3
powered by Segment

GitHub

Stars45
Watchers3
Forks12
Issues0
Contributors1
Pull Requests0

Code

Files2
LOCLines of Code 99


  • By
  • Uwe Dauernheim

Overview

UDBarTrackballItem is a button view for iOS which can position the text cursor (caret) and define the text selection of a text view in parallel to its touch drag movement. The user interaction pattern is similar to a Thinkpad TrackPoint.

The intention was to create a text navigation component for text editor apps that makes the task of frequent text positioning and selection more convenient. The default way of positioning and selection requires a touch down delay to distinguish view scrolling and editing mode as well as the magnifying glass which distract the precise positioning more that it helps. The tradeoff is a decrease in view real-estate for the input accessory view bar (which is quite common in text editors nowadays).

It is implemented as a UIBarButtonItem subclass to control the caret movement and text selection of a UITextView and intended to be use inside a InputAccessoryView (UIToolbar).

Screencast of the sample project example

Screenshot of the sample project example

Features

  • Single tap dragging cursor (caret) positioning
  • Double tap dragging text selection
  • Auto scrolling of text view when positioning out of bound
  • Auto popup editing menu after positioning or selection
  • Horizontal side-to-side reach distance without re-tap
  • Horizontal and vertial layout orientations
  • Uses ARC and targets iOS 5.0+

Installation

To use UDBarTrackballItem in your own project:

  • Import UDBarTrackballItem.h and UDBarTrackballItem.m and all png image files into your project
  • Include UDBarTrackballItem.h (#import "UDBarTrackballItem.h") where needed, or in your precompiled header
  • Initialize the new UDBarTrackballItem for a UITextView

This project uses ARC and targets iOS 5.0+.

Usage

UDBarTrackballItem *trackballItem = [[UDBarTrackballItem alloc] initForTextView:_textView];
[_toolbar setItems:@[trackballItem] animated:YES];

Credits

Write app for the innovative inspiration for and first-time appearance of this component.

License

This code is distributed under the terms and conditions of the MIT license. Review the full LICENSE for all the details.

Support/Contact

Think you found a bug or just have a feature request? Just post it as an issue, but make sure to review the existing issues first to avoid duplicates. You can also hit me up at @uwe_ for anything else, or to let me know how you're using this component. Thanks!