motion-tab 0.1.2 → 0.2.0

data/README.md

@@ -1,6 +1,6 @@
 # Motion::Tab
 
-TODO: Write a gem description
+Easily create a UITabBar in a RubyMotion app.
 
 ## Installation
 
@@ -18,7 +18,34 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+Basic usage (more documentation is forthcoming):
+
+```ruby
+def application(application, didFinishLaunchingWithOptions:launchOptions)
+  @window = UIWindow.alloc.initWithFrame(UIScreen.mainScreen.bounds)
+
+  tabs = [
+    {
+      systemIcon: UITabBarSystemItemContacts,
+      navigationController: true,
+      viewController: ContactsViewController
+    }, {
+      title: "Custom",
+      icon: "custom.png",
+      navigationController: false,
+      viewController: CustomViewController
+    }, {
+      title: "Settings",
+      icon: "settings.png",
+      navigationController: true,
+      viewController: SettingsViewController
+    }
+  ]
+
+  @window.rootViewController = MotionTab::TabBar.createTabBarControllerFromData(tabs)
+  @window.makeKeyAndVisible
+end
+```
 
 ## Contributing
 

data/lib/motion-tab/tab_bar.rb

@@ -2,39 +2,59 @@ module MotionTab
   class TabBar
     class << self
       def createTabBarControllerFromData(data)
+        tabBarController = UITabBarController.alloc.init
+        tabBarController.viewControllers = self.tabControllersFromData(data)
+
+        return tabBarController
+      end
+
+      def tabBarIcon(icon, tag = 0)
+        return UITabBarItem.alloc.initWithTabBarSystemItem(icon, tag: tag)
+      end
+
+      def tabBarIconCustom(title, imageName, tag = 0)
+        iconImage = UIImage.imageNamed(imageName)
+        return UITabBarItem.alloc.initWithTitle(title, image:iconImage, tag:tag)
+      end
+
+      def tabControllersFromData(data)
         mt_tab_controllers = []
 
         data.each do |tab|
-          tab[:badgeNumber] = 0 unless tab[:badgeNumber]
-          tab[:tag] = 0 unless tab[:tag]
-          
-          viewController = tab[:viewController].alloc.init
-          viewController.tabBarItem = tabBarIcon(tab[:systemIcon], tab[:tag]) if tab[:systemIcon]
-          viewController.tabBarItem.badgeValue = tab[:badgeNumber].to_s unless tab[:badgeNumber].nil? || tab[:badgeNumber] <= 0
-          
-          if tab[:navigationController]
-            controller = UINavigationController.alloc.initWithRootViewController(viewController)
-          else
-            controller = viewController
-          end
-
-          if tab[:title]
-            controller.tabBarItem.title = tab[:title]
-          else
-            controller.tabBarItem.title = viewController.title
-          end
-
-          mt_tab_controllers << controller
+          mt_tab_controllers << self.controllerFromTabData(tab)
         end
 
-        tabBarController = UITabBarController.alloc.init
-        tabBarController.viewControllers = mt_tab_controllers
+        return mt_tab_controllers
+      end
 
-        return tabBarController
+      def controllerFromTabData(tab)
+        tab[:badgeNumber] = 0 unless tab[:badgeNumber]
+        tab[:tag] = 0 unless tab[:tag]
+        
+        viewController = tab[:viewController].alloc.init
+        
+        if tab[:navigationController]
+          controller = UINavigationController.alloc.initWithRootViewController(viewController)
+        else
+          controller = viewController
+        end
+
+        controller.tabBarItem = self.tabBarItem(tab)
+        controller.tabBarItem.title = controller.title unless tab[:title]
+
+        return controller
       end
 
-      def tabBarIcon(icon, tag = 0)
-        return UITabBarItem.alloc.initWithTabBarSystemItem(icon, tag: tag)
+      def tabBarItem(tab)
+        title = "Untitled"
+        title = tab[:title] if tab[:title]
+
+        tabBarItem = tabBarIcon(tab[:systemIcon], tab[:tag]) if tab[:systemIcon]
+        tabBarItem = tabBarIconCustom(title, tab[:icon]) if tab[:icon]
+        
+        tabBarItem.badgeValue = tab[:badgeNumber].to_s unless tab[:badgeNumber].nil? || tab[:badgeNumber] <= 0
+        
+        return tabBarItem
       end
     end
   end

data/lib/motion-tab/version.rb

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

metadata

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