AdaptiveController is module for adding custom states to Native or Custom UI elements. The UI elements evolve over time as the user becomes accustomed to them. An example AdaptiveTabBar is provided.
- First, drag and drop the AdaptiveController project file into your project or select "add existing file" and choose the AdaptiveController project
- Add AdaptiveController to your Target Dependences in the Build Phase of your project.
- Add the AdaptiveController framework in Link Binary With Libraries in Build Phases
- Import AdaptiveController where needed.
First, you should set the install date, current date, count of days to transition to small text state, and count of days to transition to big image state. The AdaptiveDateState object automatically determines what UI state to show:
var installDate = NSDate(dateString:"2014-09-18")
var adaptiveState = AdaptiveDateState(installDate: installDate, currentDate:NSDate(), countDaysToSmallTextState:countDaysToSmallTextState, countDaysToImageState:countDaysToImageState)Or count of launches for different state:
var curentCountLaunches = 6
var adaptiveState = AdaptiveLaunchesState(curentCountLaunches:curentCountLaunches, countLaunchesToSmallTextState:5, countLaunchesToImageState:7)And then you should setup an array of appearances. You should setup button images for each state for each apperance object:
var buttonsAppearances = buttonsAppearancesGenerate() //func butonsAppearancesGenerate() -> [AdaptiveButtonApperance]And then you should setup an array of items Appearance object. You should set the button's image for each state for each appearance object.
First, you should setup a dictionary for the extension of the image for each UI state:
var imageExtensionsForStates:Dictionary = [ kSmallTitleAdaptiveState:"_smalltitle", kImageAdaptiveState:"_bigimage", kSmallTitleAdaptiveState+selected :"_smalltitle", kImageAdaptiveState+selected:"_bigimage" ]Then you should set the Appearance for each UITabBarItem title for each state, fonts for each state, a default image if you describe an extension for each state, or if you do not describe an extension, you should setup each image for each state.
First, init the appearance object and setup the text for each state. If the text is the same for each state, you can set text for the default state:
var watchAppearance = AdaptiveButtonAppearance();
watchAppearance.setButonTitle("watch", state: kDefaultAdaptiveState)
watchAppearance.setButonTitle("watch", state: kSmallTitleAdaptiveState)
watchAppearance.setButonTitle("", state: kImageAdaptiveState)Then you should setup your fonts for each state:
watchAppearance.setButonTitleFontForState(yourDefaultFont, state: kDefaultAdaptiveState)
watchAppearance.setButonTitleFontForState(yourDefaultSmallTitleModeFont, state: kSmallTitleAdaptiveState)Then you should set the default image and extensions for each state a function which automaticaly sets images for each state:
watchAppearance.setImageNamesForStatesImageExtesions("watch", imageExtensionsForState:imageExtensionsForStates)Then you should setup the appearance insets for each state:
watchAppearance.setImageInsets(defaultInsets, state: kDefaultAdaptiveState);
watchAppearance.setImageInsets(defaultSmallTitleModeImageInsets, state: kSmallTitleAdaptiveState)
watchAppearance.setTitleOffset(defaultOffset, state: kDefaultAdaptiveState)
watchAppearance.setImageInsets(defaultImageModeInsets, state: kImageAdaptiveState);Then you should setup ัustom UITabBarItems which conform to the AdaptiveButtonsProtocol:
var arrayButtons = tabBar.items as [AdaptiveTabBarItem]In your custom tab item, you should implement these methods from the protocol:
@objc protocol AdaptiveApperanceProtocol {
optional func setFontToAdaptiveButton(font: UIFont)
optional func setTitleToAdaptiveButton(text: NSString)
optional func setImageToAdaptiveButton(image: UIImage?)
optional func setHighlightedToAdaptiveButton(image: UIImage?)
optional func setBackgroundImageToAdaptiveButton(image: UIImage?)
optional func setSelectedImageToAdaptiveButton(image: UIImage?)
optional func setImageInsetsToAdaptiveButton(insets: UIEdgeInsets)
optional func setTitleOffsetToAdaptiveButton(offset: UIOffset)
optional func setTitleColorToAdaptiveButton(titleColor: UIColor)
}An example implemetation of a protocol method from our custom tab bar item:
func setTitleToAdaptiveButton(text: NSString) {
self.title = text
}Finally, you should init Adaptive State Manager with the objects you've setup:
AdaptiveButtonsStateManager(state: adaptiveState, buttonsAray:arrayButtons, buttonsAppearance:butonsAppearances)##Using Custom States For AdaptiveController
Like UITabBar for different custom applications states
We have a default AdaptiveState and with the help of inheritance, we can add new custom states to our state class. The new class in our situation is named AdaptiveDateState
In AdaptiveDateState, we can add new custom states like this:
let kSmallTitleAdaptiveState = "kImageAdaptiveState"
let kImageAdaptiveState = "kNormalImageAdaptiveState"And add methods which decide how the state relates to input parameters:
var adaptiveState = AdaptiveDateState(installDate: installDate,currentDate:NSDate(),countDaysToSmallTextState:countDaysToSmallTextState,countDaysToImageState:countDaysToImageState)In AdaptiveDateState, we add custom init methods which decided what states have the Adaptive state object according to the input parameters:
private func stateRemainDays(remainDays:Int, countDaysToSmallTextState:Int, countDaysToImageState:Int)->String {
var mode:String = kDefaultAdaptiveState
print(" DAYS \(remainDays) ")
if remainDays > countDaysToSmallTextState && remainDays < countDaysToImageState{
mode = kSmallTitleAdaptiveState
} else if remainDays > countDaysToImageState {
mode = kImageAdaptiveState
}
print(mode)
return mode
}You can customize different UI components if they adopt to the AdaptiveApperanceProtocol.
Adaptive Tab Bar is released under the MIT license. See LICENSE for details.
This library is a part of a selection of our best UI open-source projects.
If you use the open-source library in your project, please make sure to credit and backlink to www.ramotion.com
Try this UI component and more like this in our iOS app. Contact us if interested.
