<commit_before>---
name: Titanium.UI.ButtonBar
summary: An iOS button bar component.
description: |
    The button bar is a set of buttons joined into a single control. Each button in a
    button bar can have a text label or an icon, but not both. 

    The [TabbedBar](Titanium.UI.iOS.TabbedBar) control is a button bar where the 
    last selected button mantains a pressed or selected state. The following discussion
    applies to both button bar and tabbed bar.
    
    The buttons share a common style, defined by the `style` property. This can be 
    set to one of the constants defined in 
    [Titanium.UI.iPhone.SystemButtonStyle](Titanium.UI.iPhone.SystemButtonStyle):

    * `PLAIN`. Default style for `ButtonBar` and `TabbedBar`.
    * `BORDERED`. Creates a bar like the `PLAIN` bar, but with a heavier border.
    * `BAR`. Creates a more compact bar with
            translucent buttons that allow the bar's background color to show through.

    If you want the background color or background gradient of the button bar itself 
    to show through, the style must be set to <Titanium.UI.iPhone.SystemButtonStyle.BAR>.

    Note that you cannot style individual buttons in a button bar. If you want to give a
    distinct visual style to individual buttons, to use an icon and text on the same button,
    or to use a button-bar type component on a platform other than iOS, you can use a set 
    of individual [Button](Titanium.UI.Button) controls wrapped in a
    [View](Titanium.UI.View) to create the appearance of a button bar.

    Use the <Titanium.UI.createButtonBar> method to create a button bar.
extends: Titanium.UI.View
since: "0.8"
platforms: [iphone, ipad]
excludes: { events: [ 'touchstart', 'touchmove', 'touchend', 'touchcancel', 'dblclick',
'doubletap', 'longclick', 'singletap', 'swipe', 'twofingertap' ]
    }
events: 
  - name: click
    summary: Fired when a button is clicked.
    properties: 
      - name: index
        summary: Index of the clicked button. 
        type: Number
properties:
  - name: index
    summary: Index of the currently selected button.
    type: Number
  - name: labels
    summary: Array of labels for the button bar. 
    description: |
        The labels can be specified either using an array of strings, in which case
        each string defines the title for a button, or using an array of simple
        dictionary objects, <BarItemType>, which can specify title, image, width and
        enabled state for each button.
    type: [Array<String>, Array<BarItemType>]
  - name: style
    summary: Style of the button bar.
    description: |
        Specify one of the constants defined in
        [Titanium.UI.iPhone.SystemButtonStyle](Titanium.UI.iPhone.SystemButtonStyle),
        either `PLAIN`, `BORDERED`, or `BAR`.

        The `BAR` style specifies a more compact style and allows the bar's background
        color or gradient to show through.
    type: Number
    default: Titanium.UI.iPhone.SystemButtonStyle.PLAIN
examples:
  - title: Simple 3 button button bar
    example: |
        
            var bb1 = Titanium.UI.createButtonBar({
            	labels:['One', 'Two', 'Three'],
            	backgroundColor:'#336699',
            	top:50,
            	style:Titanium.UI.iPhone.SystemButtonStyle.BAR,
            	height:25,
            	width:200
            });
            win.add(bb1);

  - title: Ally XML Markup
    example: |
        Previous example as an Alloy view.

            <Alloy>
                <Window id="win">
                    <ButtonBar id="bb1" platform="ios" backgroundColor="#369" top="50" height="25" width="200">

                        <!-- The Labels tag sets the ButtonBar.labels property -->
                        <Labels>

                            <!-- Specify text with node text or the title attribute. -->
                            <!-- Can also specify the enabled, image and width attributes. -->

                            <Label>One</Label>
                            <Label>Two</Label>
                            <Label>Three</Label>

                        </Labels>

                        <!-- Place additional views for the ButtonBar here. -->

                    </ButtonBar>
                </Window>
            </Alloy>
<commit_msg>Fix typo Ally->Alloy<commit_after>---
name: Titanium.UI.ButtonBar
summary: An iOS button bar component.
description: |
    The button bar is a set of buttons joined into a single control. Each button in a
    button bar can have a text label or an icon, but not both. 

    The [TabbedBar](Titanium.UI.iOS.TabbedBar) control is a button bar where the 
    last selected button mantains a pressed or selected state. The following discussion
    applies to both button bar and tabbed bar.
    
    The buttons share a common style, defined by the `style` property. This can be 
    set to one of the constants defined in 
    [Titanium.UI.iPhone.SystemButtonStyle](Titanium.UI.iPhone.SystemButtonStyle):

    * `PLAIN`. Default style for `ButtonBar` and `TabbedBar`.
    * `BORDERED`. Creates a bar like the `PLAIN` bar, but with a heavier border.
    * `BAR`. Creates a more compact bar with
            translucent buttons that allow the bar's background color to show through.

    If you want the background color or background gradient of the button bar itself 
    to show through, the style must be set to <Titanium.UI.iPhone.SystemButtonStyle.BAR>.

    Note that you cannot style individual buttons in a button bar. If you want to give a
    distinct visual style to individual buttons, to use an icon and text on the same button,
    or to use a button-bar type component on a platform other than iOS, you can use a set 
    of individual [Button](Titanium.UI.Button) controls wrapped in a
    [View](Titanium.UI.View) to create the appearance of a button bar.

    Use the <Titanium.UI.createButtonBar> method to create a button bar.
extends: Titanium.UI.View
since: "0.8"
platforms: [iphone, ipad]
excludes: { events: [ 'touchstart', 'touchmove', 'touchend', 'touchcancel', 'dblclick',
'doubletap', 'longclick', 'singletap', 'swipe', 'twofingertap' ]
    }
events: 
  - name: click
    summary: Fired when a button is clicked.
    properties: 
      - name: index
        summary: Index of the clicked button. 
        type: Number
properties:
  - name: index
    summary: Index of the currently selected button.
    type: Number
  - name: labels
    summary: Array of labels for the button bar. 
    description: |
        The labels can be specified either using an array of strings, in which case
        each string defines the title for a button, or using an array of simple
        dictionary objects, <BarItemType>, which can specify title, image, width and
        enabled state for each button.
    type: [Array<String>, Array<BarItemType>]
  - name: style
    summary: Style of the button bar.
    description: |
        Specify one of the constants defined in
        [Titanium.UI.iPhone.SystemButtonStyle](Titanium.UI.iPhone.SystemButtonStyle),
        either `PLAIN`, `BORDERED`, or `BAR`.

        The `BAR` style specifies a more compact style and allows the bar's background
        color or gradient to show through.
    type: Number
    default: Titanium.UI.iPhone.SystemButtonStyle.PLAIN
examples:
  - title: Simple 3 button button bar
    example: |
        
            var bb1 = Titanium.UI.createButtonBar({
            	labels:['One', 'Two', 'Three'],
            	backgroundColor:'#336699',
            	top:50,
            	style:Titanium.UI.iPhone.SystemButtonStyle.BAR,
            	height:25,
            	width:200
            });
            win.add(bb1);

  - title: Alloy XML Markup
    example: |
        Previous example as an Alloy view.

            <Alloy>
                <Window id="win">
                    <ButtonBar id="bb1" platform="ios" backgroundColor="#369" top="50" height="25" width="200">

                        <!-- The Labels tag sets the ButtonBar.labels property -->
                        <Labels>

                            <!-- Specify text with node text or the title attribute. -->
                            <!-- Can also specify the enabled, image and width attributes. -->

                            <Label>One</Label>
                            <Label>Two</Label>
                            <Label>Three</Label>

                        </Labels>

                        <!-- Place additional views for the ButtonBar here. -->

                    </ButtonBar>
                </Window>
            </Alloy>

{'fraction_non_alphanumeric': 0.08321678321678322, 'fraction_numerical': 0.00675990675990676, 'mean_word_length': 2.1970938897168404, 'pattern_counts': {'":': 0, '<': 49, '<?xml version=': 0, '>': 50, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6937368', 'n_tokens_mistral': 2372, 'n_tokens_neox': 2223, 'n_words': 934}