zhiquan911/lstabs

LSTabs for iOS is a small collection of well-documented classes to create tinted buttons, compound buttons with a badge (tabs) or manage collections of tabs in horizontal or vertical layout

LSTabs

LSTabs for iOS is a small collection of well-documented classes that provides:

• An easy way to apply a tint color to a UIButton.
• A base class to construct compound controls (such as colored buttons with badges or more complex components) and provides a common interface to bind the view to a data model
• A base class to create static or scrollable collections of controls, add/remove items to the collection, animate the insertion or removal of items, receive notifications when an item changes its state
• A basic interface to display the items of a collection in a vertical or horizontal layout

See the demo project for more details.

Available classes

• LSTintedButton: a UIButton which is able to color its background image with a tint color. Separate tints can be applied to each button's state
• LSTabControl: a UIControl subclass which basically aggregate a button with a badge view and bind it with a model class (LSTabItem)
• LSTabItem: basic data model used to encapsulate informations about an LSTabControl subclass and receive delegate messages when something in the model is changed
• LSTabBarView: view to manage a collection of LSTabControl items. Provides a basic interface to change the layout polices
• LSScrollTabBarView: makes the previous class scrollable in horizontal direction. Other layout sample implementations are available in the demo project (see for examples the classes VerticalScrollTabBarView or TestVerticalScrollTabBarView)

Adding LSTabs to your project

Just drag and drop the required .h and .m files onto your project (make sure to select "Copy items into destination group's folder" when required). You should only copy those files you plan to use in your project.

Requirements

LSTabs works from iOS 4.3 to the latest versions (the last tested version is 6.0.2).

Works both with ARC and non-ARC projects (remember to add the "-fno-objc-arc" option to each .m files if your project is ARC).

It depends on the following Apple frameworks:

• Foundation.framework
• UIKit.framework
• CoreGraphics.framework

Limitations

• LSTabBarView currently is NOT able to handle contentMode = UIViewContentModeScaleToFill. It has to be implemented!
• in LSScrollTabBarView the overflowLeft/overflowRight views handling needs to be completed and tested

License

This code is distributed under the terms and conditions of the MIT license.

Copyright (c) 2012 Marco Mussini - Lucky Software

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.