Titanium.UI.iOS.Stepper

viewiPhoneiPadmacOSsince iPhone 5.4.0, iPad 5.4.0, macOS 9.2.0

A widget used to increment and decrement a value.

Default	Custom

A Stepper displays its selected state while it is being pressed. You can specify background images for each state on iOS. Use the Titanium.UI.iOS.createStepper method or a <Stepper> Alloy element to create a stepper (see the "Examples" section details).

When assigning a custom image to the backgroundImage property, the image must be partially or wholly transparent for the background color or background gradient to be visible.
Similarly, for an assigned background gradient to show through, the backgroundColor may need to be set to 'transparent'.
Note that the stepper cannot be re-sized.

Examples

Simple Stepper Example

var win = Ti.UI.createWindow({
    backgroundColor: '#fff'
});

var stepper = Ti.UI.iOS.createStepper({
    tintColor: "green",
    steps: 3,
    maximum: 30,
    minimum: 0
});

stepper.addEventListener("change", function(e) {
    Ti.API.info(e.value);
});

win.add(stepper);
win.open();

Alloy XML Markup

Previous example as an Alloy view.

stepper.xml:

<Alloy>
    <Window id="window">
        <Stepper id="stepper" onClick="doClick" tintColor="green" steps="3" />
    </Window>
</Alloy>

stepper.js:

function doClick(e) {
    alert(e.value);
}

$.window.open();

Properties 57

accessibilityHidden

Booleansince 3.0.0

Parameters	Type	Description
name	String	Name of the event.
callback	Callback<Titanium.Event>	Callback function to invoke when the event is fired. 4 fields bubbles Boolean True if the event will try to bubble up if possible. cancelBubble Boolean Set to true to stop the event from bubbling. source Object Source object that fired the event. type String Name of the event fired.

Parameters	Type	Description
animation	Titanium.UI.Animation \| Dictionary<Titanium.UI.Animation>	Either a dictionary of animation properties or an Animation object.
callback?	Callback<Object>	Function to be invoked upon completion of the animation.

Parameters	Type	Description
point	Point	A point in this view's coordinate system. If this argument is missing an `x` or `y` property, or the properties can not be converted into numbers, an exception will be raised.
destinationView	Titanium.UI.View	View that specifies the destination coordinate system to convert to. If this argument is not a view, an exception will be raised.

Parameters	Type	Description
callback?	Callback<Titanium.Blob>	Function to be invoked upon completion. If non-null, this method will be performed asynchronously. If null, it will be performed immediately.
honorScaleFactor?	Boolean	Determines whether the image is scaled based on scale factor of main screen. (iOS only) When set to true, image is scale factor is honored. When set to false, the image in the blob has the same dimensions for retina and non-retina devices.

Event properties	Type	Description
value	Number	The current value of the stepper.
minimum	Number	The minimum value of the stepper.
maximum	Number	The maximum value of the stepper.

Event properties	Type	Description
x	Number	X coordinate of the event from the `source` view's coordinate system.
y	Number	Y coordinate of the event from the `source` view's coordinate system.
obscured	Boolean	Returns `true` if the click passed through an overlapping window belonging to another app. 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.

Examples

Simple Stepper Example

Alloy XML Markup

Properties 57

Linear and Radial Gradients

Methods 12

Events 7