nor

NORosettaView

Circle arc based control with selected number of leafs (pizza style).

Showing:

Popularity

Downloads/wk

0

GitHub Stars

38

Maintenance

Last Commit

6yrs ago

Contributors

1

Package

Dependencies

0

License

Apache 2.0

Categories

Readme

Version Platform License

NORosettaView

Circle arc based control with selected number of leaves (like a pizza).

Examples:

NORosettaView NORosettaView

Customisable outlook:

  • set the angle where to start drawing (eg draw from top),
  • set the total angle of the drawing (eg 180 degrees, so half of the circle),
  • set number of arcs to display,
  • change size of the margin between arcs,
  • customise the background color of selected and not selected arc,
  • change the thickness of the drawing (draw full arc to the middle of the circle or just the border),
  • add text on each arc (round label),
  • customise details like shadows,
  • respond to tap on each leaf (take advantage of blocks).

NORosettaView img1 NORosettaView img1 NORosettaView img1

Implementation:

Please refer to the demo for more in depth examples or check out source code.

NORVView

  • actionBlock - Allows to react to user interaction (taps).
[rosettaView setActionBlock:^(NORVView *view, NSUInteger selectedIndex) {
    [view setSelectedIndex:selectedIndex];
    [weakSelf updateView:view withSelectedIndex:selectedIndex];
}];
  • selectedIndex - Determines the index of selected arc in the circle.
[rosettaView setSelectedIndex:selectedIndex];
[rosettaView setLeaves:@[leaf1, leaf2, leaf3]];
  • startAngle - Determines the position where to start drawing the arcs. Default 180 degrees, which is left middle.
 [rosettaView setStartAngle:45.f];
  • totalAngle - Determines the angle on which all arcs should be drawn. Eg 180 will make half of the circle filled with arcs, rest will be empty.
 [rosettaView setTotalAngle:90.f];
  • marginAngle - Determines the angle between arcs on the outer side of the circle.
 [rosettaView setMarginAngle:5.f];
  • thickness - Determines the width which should be filled with color. 1 causes a border, radius causes full fill with the color.
[rosettaView setThickness:70.f];
  • shadowWidth - Determines the width of shadow around the elements.
 [rosettaView setShadowWidth:5];
  • shadowColor - Determines the color of shadow around the elements.
 [rosettaView setShadowColor:[UIColor blackColor]];

NORVLeaf

  • rosettaLeafWithColor:selectedColor:circleTextView: - Convenience initializer for leaf objects, with basic setup.
[NORVLeaf rosettaLeafWithColor:[UIColor grayColor]
                                         selectedColor:[UIColor blackColor]
                                        circleTextView:[NORVCircleTextView rosettaCircleText:@"Button" withTextAttributes:nil]];
  • color - Determines the color of not selected element.
 [leaf setColor:[UIColor blackColor]];
  • selectedColor - Determines the color of the selected element.
 [leaf setSelectedColor:[UIColor blackColor]];
  • circleTextView - Determines the label with rounded text.
 [leaf.circleTextView setTextAttributes:(i == selectedIndex) ? selectedTextAttributes : textAttributes];

NORVCircleTextView

Inherits from XMCircleTypeView (credits: XMCircleType). Is used to display the text on each leaf.

  • rosettaCircleText:withTextAttributes: - Convenience initializer for text with attrubutes.
[NORVCircleTextView rosettaCircleText:NSLocalizedString(@"Quite Long Button", nil)
                                                                       withTextAttributes:nil];

Installation:

Installation with CocoaPods

CocoaPods is a dependency manager for Objective-C, which automates and simplifies the process of using 3rd-party libraries.

pod "NORosettaView"

Submodule

In your projects git folder type:

git submodule init
git submodule add --copy link to the repo--
git submodule update

Copy all files from NORosettaView/RosettaView folder.

Just download & attach

This is strongly misadvised as you won't be able to see code updates. Clone or download the source, copy all files from RosettaView folder.

ChangeLog

  • 0.1 Added basic project, configured styling, added first cocoapod.

Author

Natalia Osiecka, osiecka.n@gmail.com

License

Available under the Apache 2.0 license. See the LICENSE file for more info.

Requirements

Requires Xcode 6, targeting either iOS 6.0 or higher.

Bitdeli Badge

Rate & Review

Great Documentation0
Easy to Use0
Performant0
Highly Customizable0
Bleeding Edge0
Responsive Maintainers0
Poor Documentation0
Hard to Use0
Slow0
Buggy0
Abandoned0
Unwelcoming Community0
100