motion-tab 0.2.0 → 0.2.1

data/README.md

@@ -1,4 +1,4 @@
-# Motion::Tab
+# MotionTab
 
 Easily create a UITabBar in a RubyMotion app.
 
@@ -18,7 +18,7 @@ Or install it yourself as:
 
 ## Usage
 
-Basic usage (more documentation is forthcoming):
+Basic usage (more documentation is forthcoming). In app/app_delegate.rb:
 
 ```ruby
 def application(application, didFinishLaunchingWithOptions:launchOptions)
@@ -33,7 +33,7 @@ def application(application, didFinishLaunchingWithOptions:launchOptions)
       title: "Custom",
       icon: "custom.png",
       navigationController: false,
-      viewController: CustomViewController
+      viewController: CustomViewController.alloc.initWithCustomInit(true)
     }, {
       title: "Settings",
       icon: "settings.png",
@@ -42,11 +42,27 @@ def application(application, didFinishLaunchingWithOptions:launchOptions)
     }
   ]
 
-  @window.rootViewController = MotionTab::TabBar.createTabBarControllerFromData(tabs)
+  tabBarController = MotionTab::TabBar.createTabBarControllerFromData(tabs)
+  MotionTab::TabBar.select(tabBarController, title: "Settings")
+  # MotionTab::TabBar.select(tabBarController, tag: 0) # Selects first tab
+
+  @window.rootViewController = tabBarController
   @window.makeKeyAndVisible
 end
 ```
 
+### Tab Options
+**systemIcon:** You can **not** customize the title if you use a system icon. You can find all of them here: http://developer.apple.com/library/ios/#documentation/userexperience/conceptual/mobilehig/UIElementGuidelines/UIElementGuidelines.html#pageNavigationLinks_bottom
+
+**icon:** Uses an image found in /resources.
+
+**title:** Custom title (only used if also using a custom icon). NOTE: setting self.title in a ViewController will override this value when you switch to that tab.
+
+**navigationController:** Boolean. If true, wraps **viewController** in a UINavigationController.
+
+**viewController:** The UIViewController class you want to load into the tab. You can also pass in an instantiated viewController.
+
+
 ## Contributing
 
 1. Fork it

data/lib/motion-tab/tab_bar.rb

@@ -2,17 +2,30 @@ module MotionTab
   class TabBar
     class << self
       def createTabBarControllerFromData(data)
+        data = self.setTags(data)
+
         tabBarController = UITabBarController.alloc.init
         tabBarController.viewControllers = self.tabControllersFromData(data)
 
         return tabBarController
       end
 
-      def tabBarIcon(icon, tag = 0)
+      def setTags(data)
+        tagNumber = 0
+        
+        data.each do |d|
+          d[:tag] = tagNumber
+          tagNumber += 1
+        end
+
+        return data
+      end
+
+      def tabBarIcon(icon, tag)
         return UITabBarItem.alloc.initWithTabBarSystemItem(icon, tag: tag)
       end
 
-      def tabBarIconCustom(title, imageName, tag = 0)
+      def tabBarIconCustom(title, imageName, tag)
         iconImage = UIImage.imageNamed(imageName)
         return UITabBarItem.alloc.initWithTitle(title, image:iconImage, tag:tag)
       end
@@ -31,7 +44,8 @@ module MotionTab
         tab[:badgeNumber] = 0 unless tab[:badgeNumber]
         tab[:tag] = 0 unless tab[:tag]
         
-        viewController = tab[:viewController].alloc.init
+        viewController = tab[:viewController]
+        viewController = tab[:viewController].alloc.init if tab[:viewController].respond_to?(:alloc)
         
         if tab[:navigationController]
           controller = UINavigationController.alloc.initWithRootViewController(viewController)
@@ -50,12 +64,25 @@ module MotionTab
         title = tab[:title] if tab[:title]
 
         tabBarItem = tabBarIcon(tab[:systemIcon], tab[:tag]) if tab[:systemIcon]
-        tabBarItem = tabBarIconCustom(title, tab[:icon]) if tab[:icon]
+        tabBarItem = tabBarIconCustom(title, tab[:icon], tab[:tag]) if tab[:icon]
         
         tabBarItem.badgeValue = tab[:badgeNumber].to_s unless tab[:badgeNumber].nil? || tab[:badgeNumber] <= 0
         
         return tabBarItem
       end
+
+      def select(tabBarController, title: title)
+        tabBarController.viewControllers.each do |vc|
+          if vc.tabBarItem.title == title
+            tabBarController.selectedIndex = vc.tabBarItem.tag
+            return
+          end
+        end
+      end
+
+      def select(tabBarController, tag: tag)
+        tabBarController.selectedIndex = tag
+      end
     end
   end
 end

data/lib/motion-tab/version.rb

@@ -1,3 +1,3 @@
 module MotionTab
-  VERSION = "0.2.0" unless defined?(MotionTab::VERSION)
+  VERSION = "0.2.1" unless defined?(MotionTab::VERSION)
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: motion-tab
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.1
   prerelease: 
 platform: ruby
 authors: