# Titanium.UI.Picker

Will disable the "double tap and hold for long press" message when selecting an item.

On iOS this is a direct analog of the accessibilityElementsHidden property defined in the UIAccessibility Protocol.

On Android, setting accessibilityHidden calls the native View.setImportantForAccessibility method. The native method is only available in Android 4.1 (API level 16/Jelly Bean) and later; if this property is specified on earlier versions of Android, it is ignored.

On iOS this is a direct analog of the accessibilityHint property defined in the UIAccessibility Protocol. On Android, it is concatenated together with accessibilityLabel and accessibilityValue in the order: accessibilityLabel, accessibilityValue, accessibilityHint. The concatenated value is then passed as the argument to the native View.setContentDescription method.

On iOS this is a direct analog of the accessibilityLabel property defined in the UIAccessibility Protocol. On Android, it is concatenated together with accessibilityValue and accessibilityHint in the order: accessibilityLabel, accessibilityValue, accessibilityHint. The concatenated value is then passed as the argument to the native View.setContentDescription method. Defaults to Title or label of the control.

On iOS this is a direct analog of the accessibilityValue property defined in the UIAccessibility Protocol. On Android, it is concatenated together with accessibilityLabel and accessibilityHint in the order: accessibilityLabel, accessibilityValue, accessibilityHint. The concatenated value is then passed as the argument to the native View.setContentDescription method. Defaults to State or value of the control.

The value of this property is the fully qualified name of the API. For example, Titanium.UI.Button returns Ti.UI.Button.

For information about color values, see the "Colors" section of Titanium.UI.

Android: If you want to change the backgroundColor you have to set the borderStyle to Ti.UI.INPUT_BORDERSTYLE_ROUNDED or Ti.UI.INPUT_BORDERSTYLE_NONE

For information about color values, see the "Colors" section of Titanium.UI.

Defaults to the normal background color of this view (Android), black (iOS).

Each corner is rounded using an arc of a circle. Values for each corner can be specified. For example, '20px 20px' will set both left and right corners to 20px. Specifying '20px 20px 20px 20px' will set top-left, top-right, bottom-right and bottom-left corners in that order.

If you have issues with dark artifacts on Android you can try to disable Hardware acceleration by setting a backgroundColor with a small amount of transparency: backgroundColor:"rgba(255,255,255,254)".

This is an Android only property which only applies to pickers of type:

• PICKER_TYPE_DATE or PICKER_TYPE_TIME that also have datePickerStyle set to DATE_PICKER_STYLE_COMPACT.

• PICKER_TYPE_PLAIN that also have property useSpinner set false to show a drop-down picker.

If borderColor is set without borderWidth, this value will be changed to 1 of the unit declared as 'ti.ui.defaultunit' in tiapp.xml descriptor.

This position is relative to the view's parent. Exact interpretation depends on the parent view's layout property. Can be either a float value or a dimension string (for example, '50%' or '10px').

This is an input property for specifying where the view should be positioned, and does not represent the view's calculated position.

Defaults to undefined.

Some proxies (most commonly views) have a relationship to other proxies, often established by the add() method. For example, for a button added to a window, a click event on the button would bubble up to the window. Other common parents are table sections to their rows, table views to their sections, and scrollable views to their views. Set this property to false to disable the bubbling to the proxy's parent.

If 'calendarViewShown' is 'true', the calenderView is visible

Setting this to CLIP_MODE_ENABLED enforces all child views to be clipped to this views bounds. Setting this to CLIP_MODE_DISABLED allows child views to be drawn outside the bounds of this view. When set to CLIP_MODE_DEFAULT or when this property is not set, clipping behavior is inferred. See section on iOS Clipping Behavior in Titanium.UI.View.

Defaults to undefined. Behaves as if set to CLIP_MODE_DEFAULT.

You can only set columns for the plain picker. If you set the type to anything else except Titanium.UI.PICKER_TYPE_PLAIN, you cannot modify the columns.

In an Alloy application you can specify this property with a <PickerColumn> (or <Column>) element that contains one or more <PickerRow> (or <Row>) elements, as shown below:

<Alloy>
    <Window>
        <Picker useSpinner="true">
            <PickerColumn id="column1">
                <PickerRow title="Bananas"/>
                <PickerRow title="Strawberries"/>
                <PickerRow title="Mangos"/>
            </PickerColumn>
            <!-- Picker shorthand notation -->
            <Column id="column2">
                <Row title="red"/>
                <Row title="green"/>
                <Row title="blue"/>
            </Column>
        </Picker>
    </Window>
</Alloy>

Applicable to PICKER_TYPE_COUNT_DOWN_TIMER picker types.

Used to display the picker has calendar/clock view, as wheel spinners, or as a field which displays selection dialog when tapped on.

This property is ignored if the type property is set to PICKER_TYPE_PLAIN.

Applicable to PICKER_TYPE_TIME and PICKER_TYPE_DATE_AND_TIME picker types. The picker type PICKER_TYPE_DATE does not support text customizing as stated in the UIKit User Interface Catalog.

Important: On iOS 14+, you also have to set the datePickerStyle to DATE_PICKER_STYLE_WHEELS in order to use this property.

The elevation of a view determines the appearance of its shadow. Higher elevations produce larger and softer shadows.

Note: The elevation property only works on Titanium.UI.View objects. Many Android components have a default elevation that cannot be modified. For more information, see Google design guidelines: Elevation and shadows.

This is a security feature to protect an app from "tapjacking", where a malicious app can use a system overlay to intercept touch events in your app or to trick the end-user to tap on UI in your app intended for the overlay.

Setting this property to true causes touch related events (including "click") to not be fired if a system overlay overlaps the view.

Only applicable to PICKER_TYPE_DATE and PICKER_TYPE_TIME picker types for android. For PICKER_TYPE_PLAIN, refer to Titanium.UI.PickerColumn for android, and Titanium.UI.PickerRow for iphone / ipad.

Only applcable to pickers of type PICKER_TYPE_TIME.

When this property is set true, a time picker is displayed with hours 0 through 23. When set false, hours will be 1 through 12 with am/pm controls.

Defaults to: If undefined, defaults to either FILL or SIZE depending on the view. See "View Types and Default Layout Behavior" in Transitioning to the New UI Layout System.

Can be either a float value or a dimension string (for example, '50%' or '40dp'). Can also be one of the following special values:

• SIZE. The view should size itself to fit its contents.
• FILL. The view should size itself to fill its parent.
• 'auto'. Represents the default sizing behavior for a given type of view. The use of 'auto' is deprecated, and should be replaced with the SIZE or FILL constants if it is necessary to set the view's behavior explicitly.

This is an input property for specifying the view's height dimension. To determine the view's size once rendered, use the rect or size properties.

If setting hiddenBehavior to HIDDEN_BEHAVIOR_GONE it will automatically release the space the view occupied. For example: in a vertical layout the views below the object will move up when you hide an object with hiddenBehavior:Titanium.UI.HIDDEN_BEHAVIOR_GONE.

• HIDDEN_BEHAVIOR_INVISIBLE. Keeps the space and just hides the object (default).
• HIDDEN_BEHAVIOR_GONE. Releases the space and hides the object.

Defaults to Titanium.UI.HIDDEN_BEHAVIOR_INVISIBLE.

This is an Android only property which only applies to pickers of type:

• PICKER_TYPE_DATE or PICKER_TYPE_TIME that also have datePickerStyle set to DATE_PICKER_STYLE_COMPACT.

• PICKER_TYPE_PLAIN that also have property useSpinner set false to show a drop-down picker.

Note that the parallax effect only happens by tilting the device so results can not be seen on Simulator. To clear all motion effects, use the <Titanium.UI.clearMotionEffects> method.

For more information, see the discussion of horizontal layout mode in the description of the layout property.

The id property of the Ti.UI.View represents the view's identifier. The identifier string does not have to be unique. You can use this property with getViewById method.

When true the screen will not power down. Note: enabling this feature will use more power, thereby adversely affecting run time when on battery. For iOS look at idleTimerDisabled.

This position is relative to the view's parent. Exact interpretation depends on the parent view's layout property. Can be either a float value or a dimension string (for example, '50%' or '10px').

This is an input property for specifying where the view should be positioned, and does not represent the view's calculated position.

Defaults to undefined.

If this property is set to a Window or TabGroup, then the corresponding Activity lifecycle event callbacks will also be called on the proxy. Proxies that require the activity lifecycle will need this property set to the appropriate containing Window or TabGroup.

Applicable to PICKER_TYPE_DATE, PICKER_TYPE_TIME and PICKER_TYPE_DATE_AND_TIME picker types.

Locale must be represented as a combination of ISO 2-letter language and country codes. For example, en-US or en-GB. See the ISO 639-1 and ISO 3166-1 alpha-2 sections of wikipedia for reference.

On iOS, the system locale is always used.

Applicable to PICKER_TYPE_DATE and PICKER_TYPE_DATE_AND_TIME picker types.

For JavaScript files, use a JavaScript Date object.

For Alloy XML and TSS files, use a date string that can be parsed by the moment.js constructor, which includes ISO-8601 and RFC2822 dates.

This property is ignored when maxDate is less than minDate.

Applicable to PICKER_TYPE_DATE and PICKER_TYPE_DATE_AND_TIME picker types.

For JavaScript files, use a JavaScript Date object.

For Alloy XML and TSS files, use a date string that can be parsed by the moment.js constructor, which includes ISO-8601 and RFC2822 dates.

This property is ignored when maxDate is less than minDate.

Applicable to PICKER_TYPE_TIME and PICKER_TYPE_DATE_AND_TIME picker types.

The minimum permitted value is 1 and maximum is 30. If the value cannot be evenly divided into 60, the default value is used.

This property is intended to be used by time picker types.

If true, Android will show hour, minute, and am/pm spinners like iOS.

If false, Android will display a clock view.

If undefined with Titanium 10.0.1 or higher, the datePickerStyle property is used.

As of Titanium 10.0.1, this property has the same effect as the useSpinner property which also shows a native spinner.

const picker = Ti.UI.createPicker({
    type: Ti.UI.PICKER_TYPE_TIME,
    nativeSpinner: true,
    format24: false,
    minuteInterval: 4,
    minDate: new Date(2018, 5, 24),
    maxDate: new Date(2020, 5, 24),
    value: new Date(2019, 5, 24)
});

If this property is set to false, the animate call is ignored if the view is currently being animated.

Defaults to undefined but behaves as false

When set to USER_INTERFACE_STYLE_DARK or USER_INTERFACE_STYLE_LIGHT, the picker will ignore the system's current theme and use the theme assigned to this property instead.

When set to USER_INTERFACE_STYLE_UNSPECIFIED, the picker will use the system's current theme.

Preview context to present the "Peek and Pop" of a view. Use an configured instance of Titanium.UI.iOS.PreviewContext here.

Note: This property can only be used on devices running iOS9 or later and supporting 3D-Touch. It is ignored on older devices and can manually be checked using forceTouchSupported.

The view's bounding box is defined by its size and position.

The view's size is rect.width x rect.height. The view's top-left position relative to its parent is (rect.x , rect.y).

On Android it will also return rect.absoluteX and 'rect.absoluteY' which are relative to the main window.

The correct values will only be available when layout is complete. To determine when layout is complete, add a listener for the postlayout event.

This position is relative to the view's parent. Exact interpretation depends on the parent view's layout property. Can be either a float value or a dimension string (for example, '50%' or '10px').

This is an input property for specifying where the view should be positioned, and does not represent the view's calculated position.

Defaults to undefined.

Translation values are applied to the static post layout value.

Translation values are applied to the static post layout value.

Translation values are applied to the static post layout value.

Translation values are applied to the static post layout value.

Translation values are applied to the static post layout value.

As of Titanium 10.0.1, this property will be ignored and Android will always show an indicator.

If true, selection will open when setSelectedRow is called.

If false, selection will not open when setSelectedRow is called.

Although property returns a Dimension dictionary, only the width and height properties are valid. The position properties--x and y--are always 0.

To find the position and size of the view, use the rect property instead.

The correct values will only be available when layout is complete. To determine when layout is complete, add a listener for the postlayout event.

Assigning a value to this property causes the tool tip to be displayed for the view. Setting the property to null cancels the display of the tool tip for the view. Note: This property is only used for apps targeting macOS Catalyst.

This position is relative to the view's parent. Exact interpretation depends on the parent view's layout property. Can be either a float value or a dimension string (for example, '50%' or '10px').

This is an input property for specifying where the view should be positioned, and does not represent the view's calculated position.

If false, will forward the events to peers.

Touch feedback is only applied to a view's background. It is never applied to the view's foreground content such as a Titanium.UI.ImageView's image.

For Titanium versions older than 9.1.0, touch feedback only works if you set the backgroundColor property to a non-transparent color.

Defaults to provided theme color.

Android only supports Matrix2D transforms.

Name should be unique in the View hierarchy.

Translation values are applied to the static post layout value.

Translation values are applied to the static post layout value.

Translation values are applied to the static post layout value.

You can only set columns for the plain picker. If you set the type to anything else except Titanium.UI.PICKER_TYPE_PLAIN, you cannot modify the columns.

PICKER_TYPE_DATE_AND_TIME is only available for iOS. PICKER_TYPE_COUNT_DOWN_TIMER is only available for iOS.

This property is intended to be used by plain picker types. When set on date/time pickers, this property will override the datePickerStyle property.

If true, Android will show spinners for each column like iOS.

If false, Android will display the 1st column as a drop-down list picker and all other columns will be ignored.

As of Titanium 10.0.1, this property shows a native Android spinner widget like how the nativeSpinner property worked in older versions. On older Titanium versions, this property shows a non-native custom spinner view.

Applicable to PICKER_TYPE_DATE, PICKER_TYPE_TIME and PICKER_TYPE_DATE_AND_TIME picker types.

For JavaScript files, use a JavaScript Date object.

For Alloy XML and TSS files, use a date string that can be parsed by the moment.js constructor, which includes ISO-8601 and RFC2822 dates.

Note that the parallax effect only happens by tilting the device so results can not be seen on Simulator. To clear all motion effects, use the <Titanium.UI.clearMotionEffects> method.

iOS Defaults to undefined. Behaves as if transparent. Android default is black. On Android you can set <item name="android:ambientShadowAlpha">0.5</item> and <item name="android:spotShadowAlpha">0.5</item> in your theme to change the opacity.

Defaults to undefined. Behaves as if set to (0,-3)

Defaults to undefined. Behaves as if set to 3. Accepts density units as of 10.0.1.

The spinner-style Android picker shows 5 rows by default; one selected in the middle and 2 above and below. Set to an odd number to ensure the selected row is in the middle.

Defaults to: If undefined, defaults to either FILL or SIZE depending on the view. See "View Types and Default Layout Behavior" in Transitioning to the New UI Layout System.

Can be either a float value or a dimension string (for example, '50%' or '40dp'). Can also be one of the following special values:

• SIZE. The view should size itself to fit its contents.
• FILL. The view should size itself to fill its parent.
• 'auto'. Represents the default sizing behavior for a given type of view. The use of 'auto' is deprecated, and should be replaced with the SIZE or FILL constants if it is necessary to set the view's behavior explicitly.

This is an input property for specifying the view's width dimension. To determine the view's size once rendered, use the rect or size properties.