[TIMOB-18515] Support icon insets in Ti.UI.Tab

apidoc/Titanium/UI/Tab.yml

@@ -220,6 +220,16 @@ properties:
          otherwise.
     type: String
 
+  - name: iconInsets
+    summary: The icon inset or outset for each edge.
+    description: | 
+        Use this property for example to center an icon without providing a title. To do that, set the
+        insets to `{top:6, bottom:-6, right:0, left:0}`.
+    since: "5.2.0"
+    default: All insets are zero.
+    type: TabIconInsets
+    platforms: [iphone,ipad]
+
   - name: iconIsMask
     summary: Defines if the icon property of the tab must be used as a mask. This property is applicable on iOS 7 and greater. 
     description: |
@@ -381,3 +391,26 @@ examples:
                     </Tab>
                  </TabGroup>
             </Alloy>
+
+---
+name: TabIconInsets
+summary: Dictionary to specify edge insets for <Titanium.UI.Tab.iconInsets>.
+since: "5.2.0"
+platforms: [iphone, ipad]
+properties:
+  - name: top 
+    summary: Top inset.
+    type: Number
+
+  - name: left
+    summary: Left inset.
+    type: Number
+
+  - name: right
+    summary: Right inset.
+    type: Number
+
+  - name: bottom
+    summary: Bottom inset.
+    type: Number
+

iphone/Classes/TiUITabProxy.h

@@ -43,6 +43,7 @@
 -(void)setIcon:(id)title;
 -(void)setBadge:(id)title;
 -(void)setActive:(id)value;
+-(void)setIconInsets:(id)args;
 
 - (void)handleWillBlur;
 - (void)handleDidBlur:(NSDictionary *)event;

iphone/Classes/TiUITabProxy.m

@@ -217,6 +217,7 @@ -(UINavigationController*)controller
 		[self setTitle:[self valueForKey:@"title"]];
 		[self setIcon:[self valueForKey:@"icon"]];
 		[self setBadge:[self valueForKey:@"badge"]];
+		[self setIconInsets:[self valueForKey:@"iconInsets"]];
 		controllerStack = [[NSMutableArray alloc] init];
 		[controllerStack addObject:[self rootController]];
 		[controller.interactivePopGestureRecognizer addTarget:self action:@selector(popGestureStateHandler:)];
@@ -486,6 +487,7 @@ -(void)updateTabBarItem
 
     UIViewController* rootController = [rootWindow hostingController];
 	id badgeValue = [TiUtils stringValue:[self valueForKey:@"badge"]];
+	id iconInsets = [self valueForKey:@"iconInsets"];
 	id icon = [self valueForKey:@"icon"];
 
 	if ([icon isKindOfClass:[NSNumber class]])
@@ -555,6 +557,13 @@ -(void)updateTabBarItem
     if (activeTitleColor != nil) {
         [ourItem setTitleTextAttributes:[NSDictionary dictionaryWithObjectsAndKeys:[activeTitleColor color], NSForegroundColorAttributeName, nil] forState:UIControlStateSelected];
     }
+
+    if (iconInsets != nil) {
+        if(UIEdgeInsetsEqualToEdgeInsets([TiUtils contentInsets:iconInsets], [ourItem imageInsets]) == NO) {
+            [ourItem setImageInsets:[TiUtils contentInsets:iconInsets]];
+        }
+    }
+
     [ourItem setBadgeValue:badgeValue];
     [rootController setTabBarItem:ourItem];
 }
@@ -591,6 +600,14 @@ -(void)setIcon:(id)icon
 	[self updateTabBarItem];
 }
 
+-(void)setIconInsets:(id)args
+{
+    ENSURE_SINGLE_ARG(args, NSDictionary);
+    [self replaceValue:args forKey:@"iconInsets" notification:NO];
+
+    [self updateTabBarItem];
+}
+
 -(void)setIconIsMask:(id)value
 {
     [self replaceValue:value forKey:@"iconIsMask" notification:NO];