# Titanium.UI

> The main [Titanium.UI](https://titaniumsdk.com/docs/sdk/Titanium.UI.md) module.

- Source: https://titaniumsdk.com/docs/sdk/13.0.0/Titanium.UI
- Titanium SDK version: 13.0.0
- Kind: module
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 0.4
- Extends: Titanium.Module
- Inheritance: Titanium.Module > Titanium.Proxy

The UI module is responsible for native user-interface components and interaction inside
Titanium.  The goal of the UI module is to provide a native experience along with native
performance by compiling Javascript code into their native counterparts as part of the
build process.

#### Design

The UI module is broken down into 3 major area:

* **Views** - [Views](https://titaniumsdk.com/docs/sdk/Titanium.UI.View.md) are containers that host visual elements such as
controls or other views.  Views can have their properties customized, such as their border color
and radius, can fire events such as swipe events or touches, and can optionally contain a
hierarchy or other views as children. In Titanium, most views are specialized to perform both a
visual function and set of interaction behaviors such as [Table View](https://titaniumsdk.com/docs/sdk/Titanium.UI.TableView.md) or
[Coverflow View](https://titaniumsdk.com/docs/sdk/Titanium.UI.iOS.CoverFlowView.md).  Views are always named with the suffix `View`.

* **Controls** - controls, or sometimes referred as widgets, are visual elements such as
[sliders](https://titaniumsdk.com/docs/sdk/Titanium.UI.Slider.md),  [buttons](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md) and [switches](https://titaniumsdk.com/docs/sdk/Titanium.UI.Switch.md).
They provide a visual element which has a defined behavior and typical have special
configuration and special events.  Controls themselves are views and also inherit a views
properties, functions and events.

* **Windows** - [Windows](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md) are typically top-level visual constructs that are
the main part of your interface. An application will always have at least one window and windows
can take different shapes and sizes, can have display and interaction properties such as
fullscreen or modal and can be customized, such as changing their opacity or background color.
Windows themselves are views and also inherit a views properties, functions and events. There
are a few specialization of Windows such as a [Tab Group](https://titaniumsdk.com/docs/sdk/Titanium.UI.TabGroup.md) which offer
additional behavior beyond the basic Window. It is considered a best practice to use a
[NavigationWindow](https://titaniumsdk.com/docs/sdk/Titanium.UI.NavigationWindow.md) as the root of your application.

Titanium uses the [Factory Pattern](http://en.wikipedia.org/wiki/Factory_method_pattern) for
constructing objects and a general naming pattern for APIs.  For example, to construct a
[Alert Dialog](https://titaniumsdk.com/docs/sdk/Titanium.UI.AlertDialog.md), you call the method [Titanium.UI.createAlertDialog](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#createAlertDialog).
To create a [TextArea](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md), you call the method [Titanium.UI.createTextArea](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#createTextArea).
Once an object is created, it will be available until it goes out of scope.

#### Optimizations

UI objects are optimized by Titanium to not be realized into the drawing context and placed into
the device UI surface until needed.  That means that you can create UI objects, set their
properties and add them to their hierarchy without much worry about memory or performance.
When the native drawing surface needs to render a specific view or control, Titanium will
automatically create the view as needed.  Additionally, Titanium is optimized to also release
memory once the view is no longer needed, on screen or in low memory situations.  However, it's
a good idea to help Titanium along in certain cases where you are no longer using objects.  For
example, you should call `close` on a [Window](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md) instance when you are no
longer using it.  You can safely call `open` on the window again to re-open it.

#### Global Context

Prior to the release of Titanium SDK `9.0.0.GA` any variable declared in `app.js` or `alloy.js`
was added to a global scope. This however is no longer the case since `9.0.0.GA`. However
it is still possible to add variables to a global scope by adding `global.` in front of any
variabled declared in `app.js` or `alloy.js`. However you should be careful with adding variables
to global context because anything added to the global context will not be garbage-collected.

In Alloy the recommended way to add global context is `Alloy.Globals`.

#### Portability

Titanium components are designed to be portable across as many platforms as it supports.
However, there are cases where a device either does not support a specific feature or capability
or where it support additional functionality. For cases where the device OS supports
capabilities that other platforms do not, we attempt to place those capabilities in a separate
namespace, such as [Titanium.UI.iOS](https://titaniumsdk.com/docs/sdk/Titanium.UI.iOS.md). However, in cases where the control is in a common
namespace and support additional features, we continue to place that functionality directly on
the object.

#### Events

Event listeners must be defined before their respective events are likely to be fired, otherwise
they are not guaranteed to be called. The open and focus [Window](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md) event
listeners, for instance, must be defined before the window is opened.

Evaluating events as late as possible while bearing the above consideration in mind, however,
can significantly improve application responsiveness. For example, an event listener for a
click event may be defined after the parent window has been opened.

Adding `eventListeners` in Alloy makes sure they are bound before they are fired.

#### Colors

Many UI components have properties that control their color.

Colors may be specified as a hex triplet to determine the red, green and blue channels. Thus,
`'#000000'` is specified for black, `'#ff0000'` for red, `'#00ff00'` for green, `'#0000ff'` for
blue, and `'#ffffff'` for white, etc. A channel may be abbreviated when its two hex digits are
identical, such as `'#000'`, `'#f00'`, `'#0f0#'`, `'#00f'` and `'#fff'` for the above colors,
respectively.

An additional alpha channel is supported as a prefix to the hex triplet (ARGB or AARRGGBB). So, to make
the purple-like color `'#ff00ff'` semi-opaque, you could use an alpha value of `'55'`, giving,
`'#55ff00ff'` or `'#5f0f'`. Please note that both iOS and Android use ARGB format, while typical CSS supports RGBA.

Note that while the pound symbol, `#`, is not mandatory on iOS when using the hex triplet format,
it is recommended to include it to provide compatibility with other platforms.

iOS and Android also accept colors specified in the form, `rgb(R,G,B)` and `rgba(R,G,B,A)`, with the color
channels inside the parethesis represented by integer numbers between `0` and `255` and the
alpha channel by a float number between `0` and `1.0` (transparent to opaque, respectively).
For example, an opaque purple could be obtained using `'rgb(255,0,255)'` and a semi-opaque purple
using `'rgba(255,0,255,0.3)'`. Note that although this format will work if the `rgb` or `rgba`
prefix is omitted, this is not officially supported and thus not recommended.

Alternatively, the following set of color names are recognized.

`'aqua'`, `'black'`, `'blue'`, `'brown'`, `'cyan'`, `'darkgray'`, `'fuchsia'`, `'gray'`,
`'green'`, `'lightgray'`, `'lime'`, `'magenta'`, `'maroon'`, `'navy'`, `'olive'`, `'orange'`,
`'pink'`, `'purple'`, `'red'`, `'silver'`, `'teal'`, `'white'`, `'yellow'`.

All color properties also accept a value of `'transparent'`.

On Android, if you want to create a semi-transparent window, set the `opacity`
property **before** opening the window.

On iOS, you can set a global tinting using [Titanium.UI.tintColor](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#tintColor). All child views will inherit
the tint color by default and are able to override the color using `tintColor` on their own views.
The default `tintColor` on iOS is the blue (system-color).

If a color property is undefined, the default color of the particular UI element is applied.
If a color value is not valid on iOS, the default color is applied, whereas, on Android, the
color yellow is applied.

On iOS, you may use named system colors. See the [Titanium.UI.Color](https://titaniumsdk.com/docs/sdk/Titanium.UI.Color.md) documentation for more details.

#### Dark Mode

In iOS 13 Apple introduced support for users to adopt a system-wide Dark Mode setting where the screens, view, menus, and controls use a darker color palette. You can read more about this in the Apple Human Interface Guidelines.

There are two aspects to dark mode that can be specified for your app, colors and images.

##### Specifying Dark Mode colors

To specify colors for dark mode, also known as semantic colors, first create a file called `semantic.colors.json` in the Resources directory for classic applications, or in the assets directory for Alloy applications. Then you can specify color names in the following format:

``` json
  {
    "textColor": { // the name for your color
      "dark": {
        "color": "#ff85e2", // hex color code to be set
        "alpha": "50" // can be set from a range of 0.0-100.0, integer or float
      },
      "light": "#ff1f1f" // can be a hex color (with alpha via ARGB/AARRGGBB)
    }
  }
```

To reference these colors in your application use the [Titanium.UI.fetchSemanticColor](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#fetchSemanticColor) API, this is a cross platform API that on iOS 13 and above will use the native method that checks the users system-wide setting, and in all other instances will check the [Titanium.UI.semanticColorType](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#semanticColorType) property and return the correct color for the current setting.

You may also directly use the named of the colors as values to any color properties on UI elements.

##### Specifying Dark Mode images

Note: Dark Mode images are iOS only.

To specify dark mode images, use the `-dark` suffix on the image name. When building your app the images are set as the dark mode variant, then refer to images as normal and iOS will select the correct image dependent on the users system-wide setting.

For example given an image `logo.png` with `@2x` and `@3x` variants, the following dark mode images should exist:

  * logo-dark.png
  * logo-dark@2x.png
  * logo-dark@3x.png

And you would reference the image as before using `logo-dark.png`

Android:
You can use the native `app/assets/android/images/res-night` folder (extend them with e.g. `res-night-xxhdpi` if needed) for dark-mode images.

## Example: Color Demo

The following example demonstrates all the color formats, and color names, that are intended
to be supported by Titanium. See the [description](Titanium.UI) section for details.

``` js
var colorArray = [
  '#ff00ff', '#f0f', 'rgb(255,0,255)',
  'transparent', '#55ff00ff', '#5f0f', 'rgba(255,0,255,0.3)',
  'aqua', 'black', 'blue', 'brown', 'cyan', 'darkgray', 'fuchsia', 'gray', 'green',
  'lightgray', 'lime', 'magenta', 'maroon', 'navy', 'olive', 'orange', 'pink',
  'purple', 'red', 'silver', 'teal', 'white', 'yellow',
];
var win = Ti.UI.createWindow({
  backgroundColor: 'black',
  exitOnClose: true,
  fullscreen: false,
  layout: 'vertical',
  title: 'Color Demo'
});
var rows = [];
var row;
for (var i=0, ilen = colorArray.length; i < ilen; i++){
  row = Ti.UI.createTableViewRow({
    color:'black',
    backgroundColor: colorArray[i],
    title: colorArray[i],
    height: 40
  });
  rows.push(row);
}
var table = Ti.UI.createTableView({
  data: rows,
  backgroundColor: 'white'
});
win.add(table);
win.open();
```

## Properties

### ANIMATION_CURVE_EASE_IN

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK Android 8.0.0, iPhone 0.9, iPad 0.9
- Permission: read-only

Use with [Animation.curve](https://titaniumsdk.com/docs/sdk/Titanium.UI.Animation.md#curve) to specify an animation that starts
slowly and speeds up.

### ANIMATION_CURVE_EASE_IN_OUT

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK Android 8.0.0, iPhone 0.9, iPad 0.9
- Permission: read-only

Use with [Animation.curve](https://titaniumsdk.com/docs/sdk/Titanium.UI.Animation.md#curve) to specify an animation that starts
slowly, and speeds up, then slows down at the end of the animation.

### ANIMATION_CURVE_EASE_OUT

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK Android 8.0.0, iPhone 0.9, iPad 0.9
- Permission: read-only

Use with [Animation.curve](https://titaniumsdk.com/docs/sdk/Titanium.UI.Animation.md#curve) to specify an animation that starts
quickly, then slows down at the end of the animation.

### ANIMATION_CURVE_LINEAR

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK Android 8.0.0, iPhone 0.9, iPad 0.9
- Permission: read-only

Use with [Animation.curve](https://titaniumsdk.com/docs/sdk/Titanium.UI.Animation.md#curve) to specify an animation that proceeds
at a constant rate.

### ATTRIBUTE_BACKGROUND_COLOR

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 3.6.0
- Permission: read-only

Use with [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) to specify a background color.

Use a color name or hex value for [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value).

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_BASELINE_OFFSET

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK iPhone 3.6.0, iPad 3.6.0, Android 7.0.0
- Permission: read-only

Use with [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) to apply a different baseline to the text.

Set [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value) to a number to specify how many pixels to raise or lower the text.

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_EXPANSION

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.6.0
- Permission: read-only

Use with [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) to stretch the text horizontally.

Set [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value) to a float value to specify how much to stretch the text.

For iOS, the default value is 0.0 and has no minimum/maximum range specified.
For Windows, the default value is 0.0 and the valid range is between 0.5 and 1.0.

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_FONT

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 3.6.0
- Permission: read-only

Use with [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) to specify a font.

Use a [Font](https://titaniumsdk.com/docs/sdk/Font.md) dictionary for [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value).

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_FOREGROUND_COLOR

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 3.6.0
- Permission: read-only

Use with [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) to specify a font color.

Use a color name or hex value for [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value).

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_KERN

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.6.0
- Permission: read-only

Use with [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) to specify kerning (space between characters).

Set [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value) to a float value specifying how many pixels to increase the character
spacing.

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_LETTERPRESS_STYLE

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.6.0
- Permission: read-only

Use with [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value) to use a letterpress text effect.

Use this constant when [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) is
[Titanium.UI.ATTRIBUTE_TEXT_EFFECT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#ATTRIBUTE_TEXT_EFFECT).

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_LIGATURE

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.6.0
- Permission: read-only

Use with [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) to enable or disable ligatures.

Set [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value) to `1` to enable ligatures, else `0` to disable.
Ligatures are only supported on certain fonts.

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_LINE_BREAK

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 5.0.0
- Permission: read-only
- DEPRECATED since 7.5.0. Use [ParagraphAttribute.lineBreakMode](ParagraphAttribute.lineBreakMode) instead.

Use with [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) to wrap and truncate the text.

Set [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value) to a `Titanium.UI.ATTRIBUTE_LINE_BREAK_*` constant.

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information on type modes.

### ATTRIBUTE_LINE_BREAK_BY_CHAR_WRAPPING

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 5.0.0
- Permission: read-only

Use with [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value) to wrap words at word boundaries.

Use this constant when [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) is
[Titanium.UI.ATTRIBUTE_LINE_BREAK](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#ATTRIBUTE_LINE_BREAK).

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_LINE_BREAK_BY_CLIPPING

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 5.0.0
- Permission: read-only

Use with [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value) to set lines to not draw past the edge of the text container.

Use this constant when [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) is
[Titanium.UI.ATTRIBUTE_LINE_BREAK](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#ATTRIBUTE_LINE_BREAK).

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_LINE_BREAK_BY_TRUNCATING_HEAD

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 5.0.0
- Permission: read-only

Use with [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value) to use ellipsis glyph at the beginning of the line for missing text.

Use this constant when [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) is
[Titanium.UI.ATTRIBUTE_LINE_BREAK](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#ATTRIBUTE_LINE_BREAK).

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_LINE_BREAK_BY_TRUNCATING_MIDDLE

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 5.0.0
- Permission: read-only

Use with [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value) to use ellipsis glyph at the middle of the line for missing text.

Use this constant when [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) is
[Titanium.UI.ATTRIBUTE_LINE_BREAK](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#ATTRIBUTE_LINE_BREAK).

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_LINE_BREAK_BY_TRUNCATING_TAIL

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 5.0.0
- Permission: read-only

Use with [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value) to use ellipsis glyph at the end of the line for missing text.

Use this constant when [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) is
[Titanium.UI.ATTRIBUTE_LINE_BREAK](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#ATTRIBUTE_LINE_BREAK).

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_LINE_BREAK_BY_WORD_WRAPPING

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 5.0.0
- Permission: read-only

Use with [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value) to wrap words at word boundaries.

Use this constant when [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) is
[Titanium.UI.ATTRIBUTE_LINE_BREAK](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#ATTRIBUTE_LINE_BREAK).

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_LINK

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 3.6.0
- Permission: read-only

Use with [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) to create a link.

Set [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value) to a URL.

Use the Label's [link](https://titaniumsdk.com/docs/sdk/Titanium.UI.Label.md#link) event to determine when the user triggers a
long press (not a click) event on the linked text.

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_OBLIQUENESS

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.6.0
- Permission: read-only

Use with [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) to skew the text.

Set [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value) to a float value to specify how much to skew the text.

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_PARAGRAPH_STYLE

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 7.5.0
- Permission: read-only

Use with [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) to manages the behaviour of string set.

Use [ParagraphAttribute](https://titaniumsdk.com/docs/sdk/ParagraphAttribute.md) for the 'value' property in the attribute dictionary.
Range for this should be whole string.
See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information on type modes.

### ATTRIBUTE_SHADOW

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.6.0
- Permission: read-only

Use with [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) to display a shadow behind the text.

Set [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value) to a [Shadow](https://titaniumsdk.com/docs/sdk/shadowDict.md) dictionary.

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_STRIKETHROUGH_COLOR

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.6.0
- Permission: read-only

Use with [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) to change the color of the horizontal line.

Use a color name or hex value for [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value).

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_STRIKETHROUGH_STYLE

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 3.6.0
- Permission: read-only

Use with [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) to place a horizontal line through the text.

Set the `value` property to a `Titanium.UI.ATTRIBUTE_UNDERLINE_*` constant.

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_STROKE_COLOR

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.6.0
- Permission: read-only

Use with [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) to specify a color for the stroke text.

Use a color name or hex value for the `value` property in the attributes dictionary.

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information on type modes.

### ATTRIBUTE_STROKE_WIDTH

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.6.0
- Permission: read-only

Use with [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) to specify the width of the stroke text.

Set [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value) to a float value specifying the size of stroke width as a percentage of the
font size. A positive value displays an outline of the charater, while a negative value
fills the character.

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_SUBSCRIPT_STYLE

- Type: Number
- Platforms: Android
- Since: Titanium SDK 6.1.0
- Permission: read-only

Use with [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) to place the text in a lower position.

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_SUPERSCRIPT_STYLE

- Type: Number
- Platforms: Android
- Since: Titanium SDK 6.1.0
- Permission: read-only

Use with [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) to place the text in an upper position.

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_TEXT_EFFECT

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.6.0
- Permission: read-only

Use with [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) to apply a text effect.

Set [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value) to `Titanium.UI.ATTRIBUTE_LETTERPRESS_STYLE` to apply a
letterpress effect to the text.

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_UNDERLINE_BY_WORD

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.6.0
- Permission: read-only

Use with [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value) to draw a line only underneath or through words.

Use this constant when [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) is either
[Titanium.UI.ATTRIBUTE_UNDERLINES_STYLE](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#ATTRIBUTE_UNDERLINES_STYLE) or
[Titanium.UI.ATTRIBUTE_STRIKETHROUGH_STYLE](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#ATTRIBUTE_STRIKETHROUGH_STYLE).

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_UNDERLINE_COLOR

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK iPhone 3.6.0, iPad 3.6.0, Android 10.0.0
- Permission: read-only

Use with [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) to change the color of the horizontal line.

Use a color name or hex value for [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value).

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_UNDERLINE_PATTERN_DASH

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.6.0
- Permission: read-only

Use with [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value) to draw a dashed line.

Use this constant when [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) is either
[Titanium.UI.ATTRIBUTE_UNDERLINES_STYLE](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#ATTRIBUTE_UNDERLINES_STYLE) or
[Titanium.UI.ATTRIBUTE_STRIKETHROUGH_STYLE](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#ATTRIBUTE_STRIKETHROUGH_STYLE).

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_UNDERLINE_PATTERN_DASH_DOT

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.6.0
- Permission: read-only

Use with [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value) to draw an alternating line of dashes and dots.

Use this constant when [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) is either
[Titanium.UI.ATTRIBUTE_UNDERLINES_STYLE](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#ATTRIBUTE_UNDERLINES_STYLE) or
[Titanium.UI.ATTRIBUTE_STRIKETHROUGH_STYLE](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#ATTRIBUTE_STRIKETHROUGH_STYLE).

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_UNDERLINE_PATTERN_DASH_DOT_DOT

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.6.0
- Permission: read-only

Use with [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value) to draw an alternating line of dashes and two dots.

Use this constant when [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) is either
[Titanium.UI.ATTRIBUTE_UNDERLINES_STYLE](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#ATTRIBUTE_UNDERLINES_STYLE) or
[Titanium.UI.ATTRIBUTE_STRIKETHROUGH_STYLE](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#ATTRIBUTE_STRIKETHROUGH_STYLE).

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_UNDERLINE_PATTERN_DOT

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.6.0
- Permission: read-only

Use with [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value) to draw a dotted line.

Use this constant when [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) is either
[Titanium.UI.ATTRIBUTE_UNDERLINES_STYLE](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#ATTRIBUTE_UNDERLINES_STYLE) or
[Titanium.UI.ATTRIBUTE_STRIKETHROUGH_STYLE](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#ATTRIBUTE_STRIKETHROUGH_STYLE).

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_UNDERLINE_PATTERN_SOLID

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.6.0
- Permission: read-only

Use with [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value) to draw a solid line.

Use this constant when [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) is either
[Titanium.UI.ATTRIBUTE_UNDERLINES_STYLE](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#ATTRIBUTE_UNDERLINES_STYLE) or
[Titanium.UI.ATTRIBUTE_STRIKETHROUGH_STYLE](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#ATTRIBUTE_STRIKETHROUGH_STYLE).

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_UNDERLINE_STYLE_DOUBLE

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.6.0
- Permission: read-only

Use with [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value) to draw a double line.

Use this constant when [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) is either
[Titanium.UI.ATTRIBUTE_UNDERLINES_STYLE](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#ATTRIBUTE_UNDERLINES_STYLE) or
[Titanium.UI.ATTRIBUTE_STRIKETHROUGH_STYLE](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#ATTRIBUTE_STRIKETHROUGH_STYLE).

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_UNDERLINE_STYLE_NONE

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.6.0
- Permission: read-only

Use with [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value) to not draw a line.

Use this constant when [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) is either
[Titanium.UI.ATTRIBUTE_UNDERLINES_STYLE](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#ATTRIBUTE_UNDERLINES_STYLE) or
[Titanium.UI.ATTRIBUTE_STRIKETHROUGH_STYLE](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#ATTRIBUTE_STRIKETHROUGH_STYLE).

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_UNDERLINE_STYLE_SINGLE

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.6.0
- Permission: read-only

Use with [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value) to draw a single line.

Use this constant when [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) is either
[Titanium.UI.ATTRIBUTE_UNDERLINES_STYLE](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#ATTRIBUTE_UNDERLINES_STYLE) or
[Titanium.UI.ATTRIBUTE_STRIKETHROUGH_STYLE](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#ATTRIBUTE_STRIKETHROUGH_STYLE).

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_UNDERLINE_STYLE_THICK

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.6.0
- Permission: read-only

Use with [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value) to draw a thick line.

Use this constant when [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) is either
[Titanium.UI.ATTRIBUTE_UNDERLINES_STYLE](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#ATTRIBUTE_UNDERLINES_STYLE) or
[Titanium.UI.ATTRIBUTE_STRIKETHROUGH_STYLE](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#ATTRIBUTE_STRIKETHROUGH_STYLE).

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_UNDERLINES_STYLE

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 3.6.0
- Permission: read-only

Use with [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) to place a horizontal line under the text.

Set the `value` property to a `Titanium.UI.ATTRIBUTE_UNDERLINE_*` constant.

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_WRITING_DIRECTION

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.6.0
- Permission: read-only

Use with [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) to control the direction of the text.

Set [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value) to a `Titanium.UI.ATTRIBUTE_WRITING_DIRECTION_*` constant.

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information on type modes.

### ATTRIBUTE_WRITING_DIRECTION_EMBEDDING

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.6.0
- Permission: read-only

Use with [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value) to use the embedded text direction.

Use this constant when [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) is
[Titanium.UI.ATTRIBUTE_WRITING_DIRECTION](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#ATTRIBUTE_WRITING_DIRECTION).

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_WRITING_DIRECTION_LEFT_TO_RIGHT

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.6.0
- Permission: read-only

Use with [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value) to write text left to right.

Use this constant when [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) is
[Titanium.UI.ATTRIBUTE_WRITING_DIRECTION](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#ATTRIBUTE_WRITING_DIRECTION).

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_WRITING_DIRECTION_NATURAL

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.6.0
- Permission: read-only

Use with [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value) to use the
[Unicode Bidirection Algorithm rules P2 and P3](http://www.unicode.org/reports/tr9/#The_Paragraph_Level)
to determine which direction to use.

Use this constant when [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) is
[Titanium.UI.ATTRIBUTE_WRITING_DIRECTION](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#ATTRIBUTE_WRITING_DIRECTION).

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_WRITING_DIRECTION_OVERRIDE

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.6.0
- Permission: read-only

Use with [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value) to override the text direction.

Use this constant when [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) is
[Titanium.UI.ATTRIBUTE_WRITING_DIRECTION](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#ATTRIBUTE_WRITING_DIRECTION).

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### ATTRIBUTE_WRITING_DIRECTION_RIGHT_TO_LEFT

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.6.0
- Permission: read-only

Use with [Attribute.value](https://titaniumsdk.com/docs/sdk/Attribute.md#value) to write text right to left.

Use this constant when [Attribute.type](https://titaniumsdk.com/docs/sdk/Attribute.md#type) is
[Titanium.UI.ATTRIBUTE_WRITING_DIRECTION](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#ATTRIBUTE_WRITING_DIRECTION).

See [Attribute](https://titaniumsdk.com/docs/sdk/Attribute.md) for more information.

### AUTOFILL_TYPE_ADDRESS

- Type: String
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 6.3.0
- Requires: Android 8.0+
- Permission: read-only

Specifies the expectation of an address.

### AUTOFILL_TYPE_ADDRESS_CITY

- Type: String
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 6.3.0
- Permission: read-only

Specifies the expectation of a city name.

### AUTOFILL_TYPE_ADDRESS_CITY_STATE

- Type: String
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 6.3.0
- Permission: read-only

Specifies the expectation of a city name combined with a state name.

### AUTOFILL_TYPE_ADDRESS_LINE1

- Type: String
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 6.3.0
- Permission: read-only

Specifies the expectation of the first line of a street address.

### AUTOFILL_TYPE_ADDRESS_LINE2

- Type: String
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 6.3.0
- Permission: read-only

Specifies the expectation of the second line of a street address.

### AUTOFILL_TYPE_ADDRESS_STATE

- Type: String
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 6.3.0
- Permission: read-only

Specifies the expectation of a state name.

### AUTOFILL_TYPE_CARD_EXPIRATION_DATE

- Type: String
- Platforms: Android
- Since: Titanium SDK 6.3.0
- Requires: Android 8.0+
- Permission: read-only

Specifies the expectation of a card expiration date.

### AUTOFILL_TYPE_CARD_EXPIRATION_DAY

- Type: String
- Platforms: Android
- Since: Titanium SDK 6.3.0
- Requires: Android 8.0+
- Permission: read-only

Specifies the expectation of a card expiration day.

### AUTOFILL_TYPE_CARD_EXPIRATION_MONTH

- Type: String
- Platforms: Android
- Since: Titanium SDK 6.3.0
- Requires: Android 8.0+
- Permission: read-only

Specifies the expectation of a card expiration month.

### AUTOFILL_TYPE_CARD_EXPIRATION_YEAR

- Type: String
- Platforms: Android
- Since: Titanium SDK 6.3.0
- Requires: Android 8.0+
- Permission: read-only

Specifies the expectation of a card expiration year.

### AUTOFILL_TYPE_CARD_NUMBER

- Type: String
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 6.3.0
- Requires: Android 8.0+
- Permission: read-only

Specifies the expectation of a card number.

### AUTOFILL_TYPE_CARD_SECURITY_CODE

- Type: String
- Platforms: Android
- Since: Titanium SDK 6.3.0
- Requires: Android 8.0+
- Permission: read-only

Specifies the expectation of a card security code.

### AUTOFILL_TYPE_COUNTRY_NAME

- Type: String
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 6.3.0
- Permission: read-only

Specifies the expectation of a country name.

### AUTOFILL_TYPE_EMAIL

- Type: String
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 6.3.0
- Requires: Android 8.0+
- Permission: read-only

Specifies the expectation of an email address.

### AUTOFILL_TYPE_FAMILY_NAME

- Type: String
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 6.3.0
- Permission: read-only

Specifies the expectation of a family name.

### AUTOFILL_TYPE_GIVEN_NAME

- Type: String
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 6.3.0
- Permission: read-only

Specifies the expectation of a given name.

### AUTOFILL_TYPE_JOB_TITLE

- Type: String
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 6.3.0
- Permission: read-only

Specifies the expectation of a job title.

### AUTOFILL_TYPE_LOCATION

- Type: String
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 6.3.0
- Permission: read-only

Specifies the expectation of a location, such as a point of interest, an address, or another way to identify a location.

### AUTOFILL_TYPE_MIDDLE_NAME

- Type: String
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 6.3.0
- Permission: read-only

Specifies the expectation of a middle name.

### AUTOFILL_TYPE_NAME

- Type: String
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 6.3.0
- Requires: Android 8.0+
- Permission: read-only

Specifies the expectation of a name.

### AUTOFILL_TYPE_NAME_PREFIX

- Type: String
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 6.3.0
- Permission: read-only

Specifies the expectation of a prefix or title, such as 'Dr.'

### AUTOFILL_TYPE_NAME_SUFFIX

- Type: String
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 6.3.0
- Permission: read-only

Specifies the expectation of a suffix, such as 'Jr.'

### AUTOFILL_TYPE_NEW_PASSWORD

- Type: String
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 7.4.0
- Permission: read-only

Specifies the expectation of a new password.

### AUTOFILL_TYPE_NICKNAME

- Type: String
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 6.3.0
- Permission: read-only

Specifies the expectation of a nickname.

### AUTOFILL_TYPE_ONE_TIME_CODE

- Type: String
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 7.4.0
- Permission: read-only

Specifies the expectation of a single-factor SMS login code.

### AUTOFILL_TYPE_ORGANIZATION_NAME

- Type: String
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 6.3.0
- Permission: read-only

Specifies the expectation of an organization name.

### AUTOFILL_TYPE_PASSWORD

- Type: String
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 6.3.0
- Requires: Android 8.0+
- Permission: read-only

Specifies the expectation of a password.

### AUTOFILL_TYPE_PHONE

- Type: String
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 6.3.0
- Requires: Android 8.0+
- Permission: read-only

Specifies the expectation of a telephone number.

### AUTOFILL_TYPE_POSTAL_CODE

- Type: String
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 6.3.0
- Requires: Android 8.0+
- Permission: read-only

Specifies the expectation of a postal code.

### AUTOFILL_TYPE_SUBLOCALITY

- Type: String
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 6.3.0
- Permission: read-only

Specifies the expectation of a sublocality.

### AUTOFILL_TYPE_URL

- Type: String
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 6.3.0
- Permission: read-only

Specifies the expectation of a URL.

### AUTOFILL_TYPE_USERNAME

- Type: String
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 6.3.0
- Requires: Android 8.0+
- Permission: read-only

Specifies the expectation of an account or login name.

### AUTOLINK_ALL

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 3.0.0
- Permission: read-only

Converts all detectable types of data into clickable links.

Two or more autolink constants can be combined using bitwise or.
On iOS:
   Use with the [Titanium.UI.TextArea.autoLink](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#autoLink) property.

On Android:
   Use with [Titanium.UI.TextArea.autoLink](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#autoLink), [Titanium.UI.TextField.autoLink](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#autoLink), and [Titanium.UI.Label.autoLink](https://titaniumsdk.com/docs/sdk/Titanium.UI.Label.md#autoLink) properties.

### AUTOLINK_CALENDAR

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.0.0
- Permission: read-only

Converts strings formatted as calendar events into clickable links.

Use with the [Titanium.UI.TextArea.autoLink](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#autoLink) property. Two or more autolink constants can be combined using bitwise or.

### AUTOLINK_EMAIL_ADDRESSES

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 3.0.0
- Permission: read-only

Converts strings formatted as email addresses into clickable links.

Two or more autolink constants can be combined using bitwise or.
On iOS:
   Use with the [Titanium.UI.TextArea.autoLink](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#autoLink) property. This property will also convert strings formatted
   as URLs into clickable links.

On Android:
   Use with [Titanium.UI.TextArea.autoLink](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#autoLink), [Titanium.UI.TextField.autoLink](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#autoLink), and [Titanium.UI.Label.autoLink](https://titaniumsdk.com/docs/sdk/Titanium.UI.Label.md#autoLink) properties.

### AUTOLINK_FLIGHT_NUMBER

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 12.0.0
- Permission: read-only

An option to detect strings with the format of a flight number from an airline.

Two or more autolink constants can be combined using bitwise or.
Use with the [Titanium.UI.TextArea.autoLink](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#autoLink) property.

### AUTOLINK_LOOKUP_SUGGESTION

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 12.0.0
- Permission: read-only

An option to detect strings with the format of information that the user might want to look up.

Two or more autolink constants can be combined using bitwise or.
Use with the [Titanium.UI.TextArea.autoLink](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#autoLink) property.

### AUTOLINK_MAP_ADDRESSES

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 3.0.0
- Permission: read-only

Converts strings formatted as addresses into clickable links.

Two or more autolink constants can be combined using bitwise or.
On iOS:
   Use with the [Titanium.UI.TextArea.autoLink](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#autoLink) property.

On Android:
   Use with [Titanium.UI.TextArea.autoLink](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#autoLink), [Titanium.UI.TextField.autoLink](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#autoLink), and [Titanium.UI.Label.autoLink](https://titaniumsdk.com/docs/sdk/Titanium.UI.Label.md#autoLink) properties.

### AUTOLINK_MONEY

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 12.0.0
- Requires: iOS 16.0+
- Permission: read-only

An option to detect strings with the format of money amounts.

Two or more autolink constants can be combined using bitwise or.
Use with the [Titanium.UI.TextArea.autoLink](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#autoLink) property.

### AUTOLINK_NONE

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 3.0.0
- Permission: read-only

Disables converting strings into clickable links.

Two or more autolink constants can be combined using bitwise or.
On iOS:
   Use with the [Titanium.UI.TextArea.autoLink](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#autoLink) property.

On Android:
   Use with [Titanium.UI.TextArea.autoLink](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#autoLink), [Titanium.UI.TextField.autoLink](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#autoLink), and [Titanium.UI.Label.autoLink](https://titaniumsdk.com/docs/sdk/Titanium.UI.Label.md#autoLink) properties.

### AUTOLINK_PHONE_NUMBERS

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 3.0.0
- Permission: read-only

Converts strings formatted as phone numbers into clickable links.

Two or more autolink constants can be combined using bitwise or.
On iOS:
   Use with the [Titanium.UI.TextArea.autoLink](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#autoLink) property.

On Android:
   Use with [Titanium.UI.TextArea.autoLink](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#autoLink), [Titanium.UI.TextField.autoLink](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#autoLink), and [Titanium.UI.Label.autoLink](https://titaniumsdk.com/docs/sdk/Titanium.UI.Label.md#autoLink) properties.

### AUTOLINK_PHYSICAL_VALUE

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 12.0.0
- Requires: iOS 16.0+
- Permission: read-only

An option to detect strings with the format of physical values (length, temperatures, etc...)

Two or more autolink constants can be combined using bitwise or.
Use with the [Titanium.UI.TextArea.autoLink](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#autoLink) property.

### AUTOLINK_SHIPMENT_TRACKING_NUMBER

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 12.0.0
- Permission: read-only

An option to detect strings with the format of a tracking number from a package delivery company.

Two or more autolink constants can be combined using bitwise or.
Use with the [Titanium.UI.TextArea.autoLink](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#autoLink) property.

### AUTOLINK_URLS

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 3.0.0
- Permission: read-only

Converts strings formatted as URLs into clickable links.

Two or more autolink constants can be combined using bitwise or.
On iOS:
   Use with the [Titanium.UI.TextArea.autoLink](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#autoLink) property. This property will also convert strings formatted
   as email addresses into clickable links.

On Android:
   Use with [Titanium.UI.TextArea.autoLink](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#autoLink), [Titanium.UI.TextField.autoLink](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#autoLink), and [Titanium.UI.Label.autoLink](https://titaniumsdk.com/docs/sdk/Titanium.UI.Label.md#autoLink) properties.

### availableSystemFontFamilies

- Type: Array<String>
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 12.1.0
- Permission: read-only

Returns a list of font families that are provided by the system.

### backgroundColor

- Type: String | Titanium.UI.Color
- Platforms: Android, iPhone, iPad, macOS

Sets the background color of the master view (when there are no windows or other top-level
controls displayed).

The default background color may also show through if you use semi-transparent
windows.

### backgroundImage

- Type: String
- Platforms: Android, iPhone, iPad, macOS

Local path or URL to an image file for setting a background for the master view (when there
are no windows or other top-level controls displayed).

The default background image may also show through if you use semi-transparent
windows.

### BLEND_MODE_CLEAR

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 7.3.0
- Permission: read-only

Use with [MaskedImage.mode](https://titaniumsdk.com/docs/sdk/Titanium.UI.MaskedImage.md#mode) to specify a blend mode.

### BLEND_MODE_COLOR

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 7.3.0
- Permission: read-only

Use with [MaskedImage.mode](https://titaniumsdk.com/docs/sdk/Titanium.UI.MaskedImage.md#mode) to specify a blend mode.

### BLEND_MODE_COLOR_BURN

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 7.3.0
- Permission: read-only

Use with [MaskedImage.mode](https://titaniumsdk.com/docs/sdk/Titanium.UI.MaskedImage.md#mode) to specify a blend mode.

### BLEND_MODE_COLOR_DODGE

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 7.3.0
- Permission: read-only

Use with [MaskedImage.mode](https://titaniumsdk.com/docs/sdk/Titanium.UI.MaskedImage.md#mode) to specify a blend mode.

### BLEND_MODE_COPY

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 7.3.0
- Permission: read-only

Use with [MaskedImage.mode](https://titaniumsdk.com/docs/sdk/Titanium.UI.MaskedImage.md#mode) to specify a blend mode.

### BLEND_MODE_DARKEN

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 7.3.0
- Permission: read-only

Use with [MaskedImage.mode](https://titaniumsdk.com/docs/sdk/Titanium.UI.MaskedImage.md#mode) to specify a blend mode.

### BLEND_MODE_DESTINATION_ATOP

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 7.3.0
- Permission: read-only

Use with [MaskedImage.mode](https://titaniumsdk.com/docs/sdk/Titanium.UI.MaskedImage.md#mode) to specify a blend mode.

### BLEND_MODE_DESTINATION_IN

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 7.3.0
- Permission: read-only

Use with [MaskedImage.mode](https://titaniumsdk.com/docs/sdk/Titanium.UI.MaskedImage.md#mode) to specify a blend mode.

### BLEND_MODE_DESTINATION_OUT

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 7.3.0
- Permission: read-only

Use with [MaskedImage.mode](https://titaniumsdk.com/docs/sdk/Titanium.UI.MaskedImage.md#mode) to specify a blend mode.

### BLEND_MODE_DESTINATION_OVER

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 7.3.0
- Permission: read-only

Use with [MaskedImage.mode](https://titaniumsdk.com/docs/sdk/Titanium.UI.MaskedImage.md#mode) to specify a blend mode.

### BLEND_MODE_DIFFERENCE

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 7.3.0
- Permission: read-only

Use with [MaskedImage.mode](https://titaniumsdk.com/docs/sdk/Titanium.UI.MaskedImage.md#mode) to specify a blend mode.

### BLEND_MODE_EXCLUSION

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 7.3.0
- Permission: read-only

Use with [MaskedImage.mode](https://titaniumsdk.com/docs/sdk/Titanium.UI.MaskedImage.md#mode) to specify a blend mode.

### BLEND_MODE_HARD_LIGHT

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 7.3.0
- Permission: read-only

Use with [MaskedImage.mode](https://titaniumsdk.com/docs/sdk/Titanium.UI.MaskedImage.md#mode) to specify a blend mode.

### BLEND_MODE_HUE

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 7.3.0
- Permission: read-only

Use with [MaskedImage.mode](https://titaniumsdk.com/docs/sdk/Titanium.UI.MaskedImage.md#mode) to specify a blend mode.

### BLEND_MODE_LIGHTEN

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 7.3.0
- Permission: read-only

Use with [MaskedImage.mode](https://titaniumsdk.com/docs/sdk/Titanium.UI.MaskedImage.md#mode) to specify a blend mode.

### BLEND_MODE_LUMINOSITY

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 7.3.0
- Permission: read-only

Use with [MaskedImage.mode](https://titaniumsdk.com/docs/sdk/Titanium.UI.MaskedImage.md#mode) to specify a blend mode.

### BLEND_MODE_MULTIPLY

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 7.3.0
- Permission: read-only

Use with [MaskedImage.mode](https://titaniumsdk.com/docs/sdk/Titanium.UI.MaskedImage.md#mode) to specify a blend mode.

### BLEND_MODE_NORMAL

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 7.3.0
- Permission: read-only

Use with [MaskedImage.mode](https://titaniumsdk.com/docs/sdk/Titanium.UI.MaskedImage.md#mode) to specify a blend mode.

### BLEND_MODE_OVERLAY

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 7.3.0
- Permission: read-only

Use with [MaskedImage.mode](https://titaniumsdk.com/docs/sdk/Titanium.UI.MaskedImage.md#mode) to specify a blend mode.

### BLEND_MODE_PLUS_DARKER

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 7.3.0
- Permission: read-only

Use with [MaskedImage.mode](https://titaniumsdk.com/docs/sdk/Titanium.UI.MaskedImage.md#mode) to specify a blend mode.

### BLEND_MODE_PLUS_LIGHTER

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 7.3.0
- Permission: read-only

Use with [MaskedImage.mode](https://titaniumsdk.com/docs/sdk/Titanium.UI.MaskedImage.md#mode) to specify a blend mode.

### BLEND_MODE_SATURATION

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 7.3.0
- Permission: read-only

Use with [MaskedImage.mode](https://titaniumsdk.com/docs/sdk/Titanium.UI.MaskedImage.md#mode) to specify a blend mode.

### BLEND_MODE_SCREEN

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 7.3.0
- Permission: read-only

Use with [MaskedImage.mode](https://titaniumsdk.com/docs/sdk/Titanium.UI.MaskedImage.md#mode) to specify a blend mode.

### BLEND_MODE_SOFT_LIGHT

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 7.3.0
- Permission: read-only

Use with [MaskedImage.mode](https://titaniumsdk.com/docs/sdk/Titanium.UI.MaskedImage.md#mode) to specify a blend mode.

### BLEND_MODE_SOURCE_ATOP

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 7.3.0
- Permission: read-only

Use with [MaskedImage.mode](https://titaniumsdk.com/docs/sdk/Titanium.UI.MaskedImage.md#mode) to specify a blend mode.

### BLEND_MODE_SOURCE_IN

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 7.3.0
- Permission: read-only

Use with [MaskedImage.mode](https://titaniumsdk.com/docs/sdk/Titanium.UI.MaskedImage.md#mode) to specify a blend mode.

### BLEND_MODE_SOURCE_OUT

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 7.3.0
- Permission: read-only

Use with [MaskedImage.mode](https://titaniumsdk.com/docs/sdk/Titanium.UI.MaskedImage.md#mode) to specify a blend mode.

### BLEND_MODE_XOR

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 7.3.0
- Permission: read-only

Use with [MaskedImage.mode](https://titaniumsdk.com/docs/sdk/Titanium.UI.MaskedImage.md#mode) to specify a blend mode.

### BREAK_BALANCED

- Type: Number
- Platforms: Android
- Since: Titanium SDK 12.3.0
- Permission: read-only

Line breaking strategy balances line lengths.

### BREAK_HIGH_QUALITY

- Type: Number
- Platforms: Android
- Since: Titanium SDK 12.3.0
- Permission: read-only

Line breaking uses high-quality strategy, including hyphenation.

### BREAK_SIMPLE

- Type: Number
- Platforms: Android
- Since: Titanium SDK 12.3.0
- Permission: read-only

Line breaking uses simple strategy.

### BUTTON_STYLE_FILLED

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 10.0.0
- Permission: read-only

Use with [Button.style](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#style) to show a solid filled button.

This is not supported on iOS and will show [BUTTON_STYLE_TEXT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#BUTTON_STYLE_TEXT) instead.

### BUTTON_STYLE_OPTION_NEGATIVE

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 10.0.0
- Permission: read-only

Use with [Button.style](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#style) to show a negative themed escape button.

This is a text-only button without a background. It is intended to be used in conjunction with
[BUTTON_STYLE_OPTION_POSITIVE](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#BUTTON_STYLE_OPTION_POSITIVE) and
[BUTTON_STYLE_OPTION_NEUTRAL](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#BUTTON_STYLE_OPTION_NEUTRAL) to show an
escape button to exit a window or dialog such as "Cancel", "No", etc.

This is not supported on iOS and will use [BUTTON_STYLE_TEXT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#BUTTON_STYLE_TEXT) instead.

On Android, this can be customized by the `buttonBarNegativeButtonStyle` attribute. By default,
Android's built-in themes will style this button the same as
[BUTTON_STYLE_OPTION_NEUTRAL](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#BUTTON_STYLE_OPTION_NEUTRAL) and
[BUTTON_STYLE_TEXT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#BUTTON_STYLE_TEXT).

### BUTTON_STYLE_OPTION_NEUTRAL

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 10.0.0
- Permission: read-only

Use with [Button.style](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#style) to show a normal themed option button.

This is a text-only button without a background. It is intended to be used in conjunction with
[BUTTON_STYLE_OPTION_POSITIVE](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#BUTTON_STYLE_OPTION_POSITIVE) and
[BUTTON_STYLE_OPTION_NEGATIVE](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#BUTTON_STYLE_OPTION_NEGATIVE) to show
a normal informational button.

This is not supported on iOS and will use [BUTTON_STYLE_TEXT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#BUTTON_STYLE_TEXT) instead.

On Android, this can be customized by the `buttonBarNeutralButtonStyle` attribute. By default,
Android's built-in themes will style this button the same as
[BUTTON_STYLE_OPTION_NEGATIVE](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#BUTTON_STYLE_OPTION_NEGATIVE) and
[BUTTON_STYLE_TEXT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#BUTTON_STYLE_TEXT).

### BUTTON_STYLE_OPTION_POSITIVE

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 10.0.0
- Permission: read-only

Use with [Button.style](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#style) to show a positive themed accept button.

This is a text-only button without a background. It is intended to be used in conjunction with
[BUTTON_STYLE_OPTION_NEGATIVE](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#BUTTON_STYLE_OPTION_NEGATIVE) and
[BUTTON_STYLE_OPTION_NEUTRAL](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#BUTTON_STYLE_OPTION_NEUTRAL) to show an an accept button
before closing a window or dialog such as "OK", "Yes", "Done", etc. It is typically colored
differently than a [BUTTON_STYLE_TEXT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#BUTTON_STYLE_TEXT) themed button on iOS.

On Android, this can be customized by the `buttonBarPositiveButtonStyle` attribute.

By default, the Android material theme does not style this button differently than any other
text-only button. Only the holo theme will style it differently.

### BUTTON_STYLE_OUTLINED

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 10.0.0
- Permission: read-only

Use with [Button.style](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#style) to show an unfilled rounded border button.

This is not supported on iOS and will show [BUTTON_STYLE_TEXT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#BUTTON_STYLE_TEXT) instead.

### BUTTON_STYLE_TEXT

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 10.0.0
- Permission: read-only

Use with [Button.style](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#style) to show a text-only button without a background.

### CLIPBOARD_OPTION_EXPIRATION_DATE

- Type: String
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 5.5.0
- Permission: read-only

Specifies the time and date that you want the system to remove the clipboard items from the clipboard.

Note that on macOS, setting a date in the past does not appear to invalidate items immediately, while on iOS it does.

### CLIPBOARD_OPTION_LOCAL_ONLY

- Type: String
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 5.5.0
- Permission: read-only

Specifies that the clipboard items should not be available to other devices through Handoff.

### cutoutSize

- Type: CutoutSize
- Platforms: Android
- Since: Titanium SDK 12.1.0
- Permission: read-only

Returns the position and shape of the Android notch. Read more about the notch [here](https://developer.android.com/develop/ui/views/layout/display-cutout).

Using Android 9+ it will return the bounding box of the Android notch. It will return `top`,`left, `width` and `height`.

### DATE_PICKER_STYLE_AUTOMATIC

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 10.0.1
- Requires: iOS 13.4+
- Permission: read-only

Displays a [Titanium.UI.Picker](https://titaniumsdk.com/docs/sdk/Titanium.UI.Picker.md) using the best visual style on the current platform for date/time selection.

On Android and iOS, a picker with this style will be shown in compatct form,
where the picker will be a read-only text field which opens a selection dialog when tapped on.

Note: Prior to iOS 14, this property is only used on iOS Catalyst apps.

### DATE_PICKER_STYLE_COMPACT

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 10.0.1
- Requires: iOS 13.4+
- Permission: read-only

Displays a [Titanium.UI.Picker](https://titaniumsdk.com/docs/sdk/Titanium.UI.Picker.md) as a read-only text field which opens a selection dialog when tapped on.

Note: Prior to iOS 14, this property is only used on iOS Catalyst apps.

### DATE_PICKER_STYLE_INLINE

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 10.0.1
- Requires: iOS 14.0+
- Permission: read-only

Displays a [Titanium.UI.Picker](https://titaniumsdk.com/docs/sdk/Titanium.UI.Picker.md) as a large calendar or clock view for date/time selection.

On iOS, an inlined "time" picker will appear as a text field with spinners for hours and minutes.

### DATE_PICKER_STYLE_WHEELS

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 10.0.1
- Requires: iOS 13.4+
- Permission: read-only

Displays a [Titanium.UI.Picker](https://titaniumsdk.com/docs/sdk/Titanium.UI.Picker.md) as spinner wheels for date/time selection.

### EXTEND_EDGE_ALL

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.1.3
- Permission: read-only

Specifies that all the edges of the window can extend.

One of the group of constants for the [Titanium.UI.Window.extendEdges](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md#extendEdges) property.

### EXTEND_EDGE_BOTTOM

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.1.3
- Permission: read-only

Specifies that the bottom edge of the window can extend.

One of the group of constants for the [Titanium.UI.Window.extendEdges](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md#extendEdges) property.

### EXTEND_EDGE_LEFT

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.1.3
- Permission: read-only

Specifies that the left edge of the window can extend.

One of the group of constants for the [Titanium.UI.Window.extendEdges](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md#extendEdges) property.

### EXTEND_EDGE_NONE

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.1.3
- Permission: read-only

Specifies that none of the edges of the window can extend.

One of the group of constants for the [Titanium.UI.Window.extendEdges](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md#extendEdges) property.

### EXTEND_EDGE_RIGHT

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.1.3
- Permission: read-only

Specifies that the right edge of the window can extend.

One of the group of constants for the [Titanium.UI.Window.extendEdges](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md#extendEdges) property.

### EXTEND_EDGE_TOP

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.1.3
- Permission: read-only

Specifies that the top edge of the window can extend.

One of the group of constants for the [Titanium.UI.Window.extendEdges](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md#extendEdges) property.

### FACE_DOWN

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Constant value for face-down orientation.

One of the group of orientation constants for the [Titanium.Gesture](https://titaniumsdk.com/docs/sdk/Titanium.Gesture.md) module,
[Titanium.UI.PORTRAIT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#PORTRAIT),
[Titanium.UI.UPSIDE_PORTRAIT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#UPSIDE_PORTRAIT),
[Titanium.UI.LANDSCAPE_LEFT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#LANDSCAPE_LEFT),
[Titanium.UI.LANDSCAPE_RIGHT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#LANDSCAPE_RIGHT),
[Titanium.UI.FACE_UP](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#FACE_UP),
[Titanium.UI.FACE_DOWN](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#FACE_DOWN),
and [Titanium.UI.UNKNOWN](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#UNKNOWN).

### FACE_UP

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Constant value for face-up orientation.

One of the group of orientation constants for the [Titanium.Gesture](https://titaniumsdk.com/docs/sdk/Titanium.Gesture.md) module,
[Titanium.UI.PORTRAIT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#PORTRAIT),
[Titanium.UI.UPSIDE_PORTRAIT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#UPSIDE_PORTRAIT),
[Titanium.UI.LANDSCAPE_LEFT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#LANDSCAPE_LEFT),
[Titanium.UI.LANDSCAPE_RIGHT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#LANDSCAPE_RIGHT),
[Titanium.UI.FACE_UP](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#FACE_UP),
[Titanium.UI.FACE_DOWN](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#FACE_DOWN),
and [Titanium.UI.UNKNOWN](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#UNKNOWN).

### FILL

- Type: String
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 2.0.0
- Permission: read-only

FILL behavior for UI layout.

The FILL behavior means the view will grow its size to fill its parent.

### HIDDEN_BEHAVIOR_GONE

- Type: Number
- Platforms: Android
- Since: Titanium SDK 6.1.0
- Permission: read-only

Release free space when hiding an object.

### HIDDEN_BEHAVIOR_INVISIBLE

- Type: Number
- Platforms: Android
- Since: Titanium SDK 6.1.0
- Permission: read-only

Keeps free space when hiding an object.

### HINT_TYPE_ANIMATED

- Type: Number
- Platforms: Android
- Permission: read-only

Use when creating a TextField to specify the hintType as animated.

### HINT_TYPE_STATIC

- Type: Number
- Platforms: Android
- Permission: read-only

Use when creating a TextField to specify the hintType as static.

### HYPHEN_FULL

- Type: Number
- Platforms: Android
- Since: Titanium SDK 12.3.0
- Permission: read-only

Standard amount of hyphenation, useful for running text and for screens with limited space for text.

### HYPHEN_FULL_FAST

- Type: Number
- Platforms: Android
- Since: Titanium SDK 12.3.0
- Permission: read-only

Same to hyphenationFrequency="full" but using faster algorithm for measuring hyphenation break points.

### HYPHEN_NONE

- Type: Number
- Platforms: Android
- Since: Titanium SDK 12.3.0
- Permission: read-only

No hyphenation.

### HYPHEN_NORMAL

- Type: Number
- Platforms: Android
- Since: Titanium SDK 12.3.0
- Permission: read-only

Less frequent hyphenation, useful for informal use cases, such as chat messages.

### HYPHEN_NORMAL_FAST

- Type: Number
- Platforms: Android
- Since: Titanium SDK 12.3.0
- Permission: read-only

Same to hyphenationFrequency="normal" but using faster algorithm for measuring hyphenation break points.

### INPUT_BORDERSTYLE_BEZEL

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Use a bezel-style border on the input field.

Use with the [Titanium.UI.TextField.borderStyle](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#borderStyle) property.

On Android, this can also be used by the [Titanium.UI.TextArea.borderStyle](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#borderStyle) property.

Android does not support this style and will use
[INPUT_BORDERSTYLE_LINE](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#INPUT_BORDERSTYLE_LINE) instead.

### INPUT_BORDERSTYLE_FILLED

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 10.0.0
- Permission: read-only

Show an enclosed border with a filled background on the input field.

This is the default Android material theme on Android.

Use with the [Titanium.UI.TextField.borderStyle](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#borderStyle) and [Titanium.UI.TextArea.borderStyle](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#borderStyle) properties.

iOS does not support this style and will use
[INPUT_BORDERSTYLE_BEZEL](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#INPUT_BORDERSTYLE_BEZEL) instead.

### INPUT_BORDERSTYLE_LINE

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Use a simple line border on the input field.

Use with the [Titanium.UI.TextField.borderStyle](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#borderStyle) property.

On Android, this can also be used by the [Titanium.UI.TextArea.borderStyle](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#borderStyle) property.

### INPUT_BORDERSTYLE_NONE

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Use no border on the input field.

Use with the [Titanium.UI.TextField.borderStyle](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#borderStyle) property.

On Android, this can also be used by the [Titanium.UI.TextArea.borderStyle](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#borderStyle) property.

### INPUT_BORDERSTYLE_ROUNDED

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Use a rounded-rectangle border on the input field.

Use with the [Titanium.UI.TextField.borderStyle](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#borderStyle) property.

On Android, this can also be used by the [Titanium.UI.TextArea.borderStyle](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#borderStyle) property.

### INPUT_BORDERSTYLE_UNDERLINED

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 10.0.0
- Permission: read-only

Show an underline instead of a border around the input field.

Use with the [Titanium.UI.TextField.borderStyle](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#borderStyle) and [Titanium.UI.TextArea.borderStyle](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#borderStyle) properties.

iOS does not support this style and will use
[INPUT_BORDERSTYLE_LINE](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#INPUT_BORDERSTYLE_LINE) instead.

### INPUT_BUTTONMODE_ALWAYS

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Always show buttons on the input field.

Use with the [Titanium.UI.TextField.clearButtonMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#clearButtonMode),
[Titanium.UI.TextField.leftButtonMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#leftButtonMode),
and [Titanium.UI.TextField.rightButtonMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#rightButtonMode) properties.

### INPUT_BUTTONMODE_NEVER

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Never show buttons on the input field.

Use with the [Titanium.UI.TextField.clearButtonMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#clearButtonMode),
[Titanium.UI.TextField.leftButtonMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#leftButtonMode),
and [Titanium.UI.TextField.rightButtonMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#rightButtonMode) properties.

### INPUT_BUTTONMODE_ONBLUR

- Type: Number
- Platforms: iPhone, iPad, macOS
- Permission: read-only

Show buttons on the input field when it loses focus.

Use with the [Titanium.UI.TextField.clearButtonMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#clearButtonMode),
[Titanium.UI.TextField.leftButtonMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#leftButtonMode),
and [Titanium.UI.TextField.rightButtonMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#rightButtonMode) properties.

### INPUT_BUTTONMODE_ONFOCUS

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Show buttons on the input field when it gains focus.

Use with the [Titanium.UI.TextField.clearButtonMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#clearButtonMode),
[Titanium.UI.TextField.leftButtonMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#leftButtonMode),
and [Titanium.UI.TextField.rightButtonMode](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#rightButtonMode) properties.

### INPUT_TYPE_CLASS_NUMBER

- Type: Number
- Platforms: Android
- Permission: read-only

Use a keyboard with a number pad only, with the pad keyboard layout. Accepts only numbers.

Use with the [Titanium.UI.TextField.inputType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#inputType) properties. This overrides any changes [Titanium.UI.TextField.keyboardType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#keyboardType)
does to the inputType of the Android device.

### INPUT_TYPE_CLASS_TEXT

- Type: Number
- Platforms: Android
- Permission: read-only

Use an ASCII keyboard, with the standard keyboard layout.

Use with the [Titanium.UI.TextField.inputType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#inputType) properties. This overrides any changes [Titanium.UI.TextField.keyboardType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#keyboardType)
does to the inputType of the Android device.

### KEYBOARD_APPEARANCE_DARK

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 5.2.0
- Permission: read-only

Use the platform-specific dark keyboard appearance.

### KEYBOARD_APPEARANCE_DEFAULT

- Type: Number
- Platforms: iPhone, iPad, macOS
- Permission: read-only

Use the platform-specific default keyboard appearance.

### KEYBOARD_APPEARANCE_LIGHT

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 5.2.0
- Permission: read-only

Use the platform-specific light keyboard appearance.

### KEYBOARD_TYPE_ASCII

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 5.2.0
- Permission: read-only

Use a keyboard supporting all characters except emoji. Defaults to English letters layout on iOS.

This keyboard type allows the end-user to enter numbers, symbols, and non-English letters too.
It just launches with the English letters keyboard layout when shown.
This type will not allow the end-user to display an emoji keyboard.

Android keyboards will typically ignore this setting and show the default language keyboard instead,
but will still not allow the end-user to enter emoji characters like iOS.

Use with the [Titanium.UI.TextField.keyboardType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#keyboardType) and [Titanium.UI.TextArea.keyboardType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#keyboardType)
properties.

### KEYBOARD_TYPE_DECIMAL_PAD

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 5.2.0
- Permission: read-only

Use a number pad keyboard layout showing only numbers, decimal separator, and sign character.

Use with the [Titanium.UI.TextField.keyboardType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#keyboardType) and [Titanium.UI.TextArea.keyboardType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#keyboardType)
properties.

On iPad, this behaves the same as [Titanium.UI.KEYBOARD_TYPE_DEFAULT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#KEYBOARD_TYPE_DEFAULT).
type: Number

### KEYBOARD_TYPE_DEFAULT

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 5.2.0
- Permission: read-only

Use the default keyboard, depending on the platform.

Use with the [Titanium.UI.TextField.keyboardType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#keyboardType) and [Titanium.UI.TextArea.keyboardType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#keyboardType)
properties.

### KEYBOARD_TYPE_EMAIL

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 5.2.0
- Permission: read-only

Use a keyboard suitable for composing email, with the standard keyboard layout.

Use with the [Titanium.UI.TextField.keyboardType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#keyboardType) and [Titanium.UI.TextArea.keyboardType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#keyboardType)
properties.

### KEYBOARD_TYPE_NAMEPHONE_PAD

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 5.2.0
- Permission: read-only

Use a keyboard suitable for entering names and phone numbers, with the pad keyboard layout.

Use with the [Titanium.UI.TextField.keyboardType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#keyboardType) and [Titanium.UI.TextArea.keyboardType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#keyboardType)
properties.

### KEYBOARD_TYPE_NUMBER_PAD

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 5.2.0
- Permission: read-only

Use a number pad keyboard layout only showing numbers for entering positive integers.

Use with the [Titanium.UI.TextField.keyboardType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#keyboardType) and [Titanium.UI.TextArea.keyboardType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#keyboardType)
properties.

On iPad, this behaves the same as [Titanium.UI.KEYBOARD_TYPE_NUMBERS_PUNCTUATION](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#KEYBOARD_TYPE_NUMBERS_PUNCTUATION).

### KEYBOARD_TYPE_NUMBERS_PUNCTUATION

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 5.2.0
- Permission: read-only

Use a keyboard supporting all characters except emoji, defaulting to numbers layout on iOS.

On iOS, this will default to showing the "Numbers and Punctuation" side of the keyboard,
but still allows the end-user to switch to other keyboards for entering letters as well.
This type will not allow the end-user to display an emoji keyboard.

On Android, this type displays a normal keyboard defaulting to the letter side,
but will not allow the end-user to enter emoji characters like iOS.

Use with the [Titanium.UI.TextField.keyboardType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#keyboardType) and [Titanium.UI.TextArea.keyboardType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#keyboardType)
properties.

### KEYBOARD_TYPE_PHONE_PAD

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 5.2.0
- Permission: read-only

Use a keyboard with a phone-style number pad, with the pad keyboard layout.

Use with the [Titanium.UI.TextField.keyboardType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#keyboardType) and [Titanium.UI.TextArea.keyboardType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#keyboardType)
properties.

On iPad, this behaves the same as [Titanium.UI.KEYBOARD_TYPE_NUMBERS_PUNCTUATION](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#KEYBOARD_TYPE_NUMBERS_PUNCTUATION).

### KEYBOARD_TYPE_TWITTER

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 5.2.0
- Permission: read-only

Use a keyboard optimized for twitter text entry, with easy access to the @ and

Use with the [Titanium.UI.TextField.keyboardType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#keyboardType) and [Titanium.UI.TextArea.keyboardType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#keyboardType)
properties.

### KEYBOARD_TYPE_URL

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 5.2.0
- Permission: read-only

Use a keyboard optimized for entering URLs, with the standard keyboard layout.

Use with the [Titanium.UI.TextField.keyboardType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#keyboardType) and [Titanium.UI.TextArea.keyboardType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#keyboardType)
properties.

### KEYBOARD_TYPE_WEBSEARCH

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 5.2.0
- Permission: read-only

Use a keyboard optimized for web search terms and URL entry.

Use with the [Titanium.UI.TextField.keyboardType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#keyboardType) and [Titanium.UI.TextArea.keyboardType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#keyboardType)
properties. This type features the space and . characters prominently.

Note: This keyboard automatically sets the return key to "Go" (localized).

### LANDSCAPE_LEFT

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Standard landscape orientation (home button on left).

One of the group of orientation constants for the [Titanium.Gesture](https://titaniumsdk.com/docs/sdk/Titanium.Gesture.md) module,
[Titanium.UI.PORTRAIT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#PORTRAIT),
[Titanium.UI.UPSIDE_PORTRAIT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#UPSIDE_PORTRAIT),
[Titanium.UI.LANDSCAPE_LEFT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#LANDSCAPE_LEFT),
[Titanium.UI.LANDSCAPE_RIGHT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#LANDSCAPE_RIGHT),
[Titanium.UI.FACE_UP](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#FACE_UP),
[Titanium.UI.FACE_DOWN](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#FACE_DOWN),
and [Titanium.UI.UNKNOWN](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#UNKNOWN).

### LANDSCAPE_RIGHT

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Reverse landscape orientation (home button on right).

One of the group of orientation constants for the [Titanium.Gesture](https://titaniumsdk.com/docs/sdk/Titanium.Gesture.md) module,
[Titanium.UI.PORTRAIT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#PORTRAIT),
[Titanium.UI.UPSIDE_PORTRAIT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#UPSIDE_PORTRAIT),
[Titanium.UI.LANDSCAPE_LEFT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#LANDSCAPE_LEFT),
[Titanium.UI.LANDSCAPE_RIGHT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#LANDSCAPE_RIGHT),
[Titanium.UI.FACE_UP](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#FACE_UP),
[Titanium.UI.FACE_DOWN](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#FACE_DOWN),
and [Titanium.UI.UNKNOWN](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#UNKNOWN).

### LIST_ACCESSORY_TYPE_CHECKMARK

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 3.1.0
- Permission: read-only

Displays a checkmark on the right side of an item in a list view.

Use to indicate an item in a list is selected.

### LIST_ACCESSORY_TYPE_DETAIL

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 3.1.0
- Permission: read-only

Displays a detail disclosure button on the right side of an item in a list view.

Use to indicate that selecting this item results in the display of a detailed view of that item.

### LIST_ACCESSORY_TYPE_DISCLOSURE

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 3.1.0
- Permission: read-only

Displays a disclosure indicator on the right side of an item in a list view.

Use to indicate that selecting this item results in the display of another list, reflecting
the next level in the data model hierarchy.

### LIST_ACCESSORY_TYPE_NONE

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 3.1.0
- Permission: read-only

Do not display anything on the right side of an item in a list view.

### LIST_ITEM_TEMPLATE_CONTACTS

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.1.0
- Permission: read-only

A built-in style for an item with a right-aligned title label on the left side of the cell,
which is next to a left-aligned subtitle label.

The title label value and subtitle label value bind to the `title` and `subtitle`
properties, respectively, of the data item. If a property is not set, that element is not
displayed.

### LIST_ITEM_TEMPLATE_DEFAULT

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 3.1.0
- Permission: read-only

A built-in style for an item with an image view and left-aligned title label.

The text label value and image value bind to the `title` and `image` properties, respectively,
of the data item. If a property is not set, that element is not displayed.

On Android, the image appears on the right side of the cell, and on iOS, the image appears
on the left side of the cell.

### LIST_ITEM_TEMPLATE_SETTINGS

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.1.0
- Permission: read-only

A built-in style for a item with an image view; a left-aligned title label; and a
right-aligned subtitle label.

The title label value, subtitle label value and image value bind to the `title`, `subtitle`
and `image` properties, respectively, of the data item. If a property is not set, that
element is not displayed.

### LIST_ITEM_TEMPLATE_SUBTITLE

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.1.0
- Permission: read-only

A built-in style for an item with an image view; a black, left-aligned title label across the
top of the cell and a subtitle label below it.

The title label value, subtitle label value and image value bind to the `title`, `subtitle`
and `image` properties, respectively, of the data item. If a property is not set, that
element is not displayed.

### NOTIFICATION_DURATION_LONG

- Type: Number
- Platforms: Android
- Permission: read-only

Specifies a long duration for an Android Toast notification ([Titanium.UI.Notification](https://titaniumsdk.com/docs/sdk/Titanium.UI.Notification.md)).

### NOTIFICATION_DURATION_SHORT

- Type: Number
- Platforms: Android
- Permission: read-only

Specifies a short duration for an Android Toast notification ([Titanium.UI.Notification](https://titaniumsdk.com/docs/sdk/Titanium.UI.Notification.md)).

### overrideUserInterfaceStyle

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 10.0.1
- Requires: iOS 13.0+
- Default: `Titanium.UI.USER_INTERFACE_STYLE_UNSPECIFIED`

Forces the app to used assigned theme instead of the system theme.

When set to [USER_INTERFACE_STYLE_DARK](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#USER_INTERFACE_STYLE_DARK) or
[USER_INTERFACE_STYLE_LIGHT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#USER_INTERFACE_STYLE_LIGHT), the app will ignore
the system's current theme and use the theme assigned to this property instead.

When set to [USER_INTERFACE_STYLE_UNSPECIFIED](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#USER_INTERFACE_STYLE_UNSPECIFIED),
the app will use the system's current theme. To determine what the system's current theme is,
you must read the [userInterfaceStyle](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#userInterfaceStyle) property.

See [UI_MODE_NIGHT_MASK](https://developer.android.com/reference/android/content/res/Configuration.html#UI_MODE_NIGHT_MASK).

Accepts: `Titanium.UI.USER_INTERFACE_STYLE_DARK`, `Titanium.UI.USER_INTERFACE_STYLE_LIGHT`, `Titanium.UI.USER_INTERFACE_STYLE_UNSPECIFIED`

### PICKER_TYPE_COUNT_DOWN_TIMER

- Type: Number
- Platforms: iPhone, iPad, macOS
- Permission: read-only

Use a picker with a countdown timer appearance, showing hours and minutes.

For an actual countdown timer, the application is responsible for setting a timer
to update the picker values.

### PICKER_TYPE_DATE

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Use a date picker.

### PICKER_TYPE_DATE_AND_TIME

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Use a date and time picker.

### PICKER_TYPE_PLAIN

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Use a plain picker (for values other than date or time).

### PICKER_TYPE_TIME

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Use a time picker.

### PORTRAIT

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Orientation constant for portrait mode orientation.

One of the group of orientation constants for the [Titanium.Gesture](https://titaniumsdk.com/docs/sdk/Titanium.Gesture.md) module,
[Titanium.UI.PORTRAIT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#PORTRAIT),
[Titanium.UI.UPSIDE_PORTRAIT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#UPSIDE_PORTRAIT),
[Titanium.UI.LANDSCAPE_LEFT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#LANDSCAPE_LEFT),
[Titanium.UI.LANDSCAPE_RIGHT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#LANDSCAPE_RIGHT),
[Titanium.UI.FACE_UP](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#FACE_UP),
[Titanium.UI.FACE_DOWN](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#FACE_DOWN),
and [Titanium.UI.UNKNOWN](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#UNKNOWN).

### RETURNKEY_CONTINUE

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 5.2.0
- Permission: read-only

Set the return key text to "Continue".

Use with the [Titanium.UI.TextField.returnKeyType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#returnKeyType) and
[Titanium.UI.TextArea.returnKeyType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#returnKeyType) properties.

Note: This constant is only available on iOS devices running iOS 9 or later. Older iOS
devices will display [Titanium.UI.RETURNKEY_DEFAULT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#RETURNKEY_DEFAULT).

### RETURNKEY_DEFAULT

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Use the default return key on the virtual keyboard.

Use with the [Titanium.UI.TextField.returnKeyType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#returnKeyType) and
[Titanium.UI.TextArea.returnKeyType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#returnKeyType) properties.

On Android devices, the default return key displays a graphical arrow.

### RETURNKEY_DONE

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Set the return key text to "Done".

Use with the [Titanium.UI.TextField.returnKeyType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#returnKeyType) and
[Titanium.UI.TextArea.returnKeyType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#returnKeyType) properties.

### RETURNKEY_EMERGENCY_CALL

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Set the return key text to "Emergency Call".

Use with the [Titanium.UI.TextField.returnKeyType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#returnKeyType) and
[Titanium.UI.TextArea.returnKeyType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#returnKeyType) properties.

### RETURNKEY_GO

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Set the return key text to "Go".

Use with the [Titanium.UI.TextField.returnKeyType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#returnKeyType) and
[Titanium.UI.TextArea.returnKeyType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#returnKeyType) properties.

### RETURNKEY_GOOGLE

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Set the return key text to "Google".

Use with the [Titanium.UI.TextField.returnKeyType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#returnKeyType) and
[Titanium.UI.TextArea.returnKeyType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#returnKeyType) properties.

### RETURNKEY_JOIN

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Set the return key text to "Join".

Use with the [Titanium.UI.TextField.returnKeyType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#returnKeyType) and
[Titanium.UI.TextArea.returnKeyType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#returnKeyType) properties.

### RETURNKEY_NEXT

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Set the return key text to "Next".

Use with the [Titanium.UI.TextField.returnKeyType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#returnKeyType) and
[Titanium.UI.TextArea.returnKeyType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#returnKeyType) properties.

### RETURNKEY_ROUTE

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Set the return key text to "Route".

Use with the [Titanium.UI.TextField.returnKeyType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#returnKeyType) and
[Titanium.UI.TextArea.returnKeyType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#returnKeyType) properties.

### RETURNKEY_SEARCH

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Set the return key text to "Search".

Use with the [Titanium.UI.TextField.returnKeyType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#returnKeyType) and
[Titanium.UI.TextArea.returnKeyType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#returnKeyType) properties.

### RETURNKEY_SEND

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Set the return key text to "Send".

Use with the [Titanium.UI.TextField.returnKeyType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#returnKeyType) and
[Titanium.UI.TextArea.returnKeyType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#returnKeyType) properties.

### RETURNKEY_YAHOO

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Set the return key text to "Yahoo".

Use with the [Titanium.UI.TextField.returnKeyType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#returnKeyType) and
[Titanium.UI.TextArea.returnKeyType](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#returnKeyType) properties.

### SELECTION_STYLE_DEFAULT

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 10.1.0
- Permission: read-only

Set the selection style to system default.

Use with the <Titanium.UI.ListView.selectionStyle> and
<Titanium.UI.TableView.selectionStyle> properties.

### SELECTION_STYLE_NONE

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 10.1.0
- Permission: read-only

Set the selection style to none.

Use with the <Titanium.UI.ListView.selectionStyle> and
<Titanium.UI.TableView.selectionStyle> properties.

### SEMANTIC_COLOR_TYPE_DARK

- Type: String
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 8.2.0
- Permission: read-only
- Value: `"dark"`
- DEPRECATED since 9.1.0. Use [USER_INTERFACE_STYLE_DARK](Titanium.UI.USER_INTERFACE_STYLE_DARK) instead.

The value returned by [Titanium.UI.semanticColorType](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#semanticColorType) when the device is in dark/night mode.

### SEMANTIC_COLOR_TYPE_LIGHT

- Type: String
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 8.2.0
- Permission: read-only
- Value: `"light"`
- DEPRECATED since 9.1.0. Use [USER_INTERFACE_STYLE_LIGHT](Titanium.UI.USER_INTERFACE_STYLE_LIGHT) instead.

The value returned by [Titanium.UI.semanticColorType](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#semanticColorType) when the device is in light/normal mode.

### semanticColorType

- Type: String
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 8.2.0
- DEPRECATED since 9.1.0. Use [userInterfaceStyle](Titanium.UI.userInterfaceStyle) instead.

The current mode for the device (corresponding to night/dark or light/normal)

Accepts: `Titanium.UI.SEMANTIC_COLOR_TYPE_DARK`, `Titanium.UI.SEMANTIC_COLOR_TYPE_LIGHT`

### SIZE

- Type: String
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 2.0.0
- Permission: read-only

SIZE behavior for UI layout.

The SIZE behavior means the view will constrain its size fit its contents.

### statusBarHeight

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 12.1.0
- Permission: read-only

The total height of the status bar including safe area padding.

Use this property to determine an absolute spacing to the top in full screen windows. Note: For a more flexible approach, e.g.
when allowing rotation, we recommend using the [Titanium.UI.Window.safeAreaPadding](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md#safeAreaPadding) property of the related window.

### SWITCH_STYLE_CHECKBOX

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 10.0.0
- Permission: read-only

Use with [Switch.style](https://titaniumsdk.com/docs/sdk/Titanium.UI.Switch.md#style) to show a checkbox.

This is supported by Android and macOS apps running on Big Sur (v11) or higher. iOS devices do not
support this style and will use [SWITCH_STYLE_SLIDER](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#SWITCH_STYLE_SLIDER) instead.

### SWITCH_STYLE_CHIP

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 10.0.0
- Permission: read-only

Use with [Switch.style](https://titaniumsdk.com/docs/sdk/Titanium.UI.Switch.md#style) to show a material design checkable chip widget.

This style is only supported on Android.
On iOS, this will use [SWITCH_STYLE_SLIDER](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#SWITCH_STYLE_SLIDER) instead.

### SWITCH_STYLE_SLIDER

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 10.0.0
- Permission: read-only

Use with [Switch.style](https://titaniumsdk.com/docs/sdk/Titanium.UI.Switch.md#style) to show a slidable button.

### SWITCH_STYLE_TOGGLE_BUTTON

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 10.0.0
- Permission: read-only

Use with [Switch.style](https://titaniumsdk.com/docs/sdk/Titanium.UI.Switch.md#style) to show a toggleable button.

This style is only supported on Android.
On iOS, this will use [SWITCH_STYLE_SLIDER](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#SWITCH_STYLE_SLIDER) instead.

### TABLE_VIEW_SEPARATOR_STYLE_NONE

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 5.2.0
- Permission: read-only

The row divider is hidden.

### TABLE_VIEW_SEPARATOR_STYLE_SINGLE_LINE

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 5.2.0
- Permission: read-only

The row divider is shown as a single line.

### TABS_STYLE_BOTTOM_NAVIGATION

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 8.0.0
- Permission: read-only

Bottom navigation style.

### TABS_STYLE_DEFAULT

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 8.0.0
- Permission: read-only

Default tab style.

### TEXT_ALIGNMENT_CENTER

- Type: Number | String
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Center align text.

Use with the [Titanium.UI.TextField.textAlign](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#textAlign), [Titanium.UI.Button.textAlign](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#textAlign) and
[Titanium.UI.TextArea.textAlign](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#textAlign) properties.

This constant is a string on Android, and a number on iOS.

### TEXT_ALIGNMENT_JUSTIFY

- Type: Number | String
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK Android 10.0.0, iPhone 6.1.0, iPad 6.1.0
- Requires: Android 8.0+
- Permission: read-only

Justify align text.

Use with the [Titanium.UI.TextField.textAlign](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#textAlign), [Titanium.UI.Button.textAlign](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#textAlign) and
[Titanium.UI.TextArea.textAlign](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#textAlign) properties.

This constant is a number on iOS and a string on Android.

### TEXT_ALIGNMENT_LEFT

- Type: Number | String
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Left align text.

Use with the [Titanium.UI.TextField.textAlign](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#textAlign), [Titanium.UI.Button.textAlign](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#textAlign) and
[Titanium.UI.TextArea.textAlign](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#textAlign) properties.

This constant is a string on Android, and a number on iOS.

### TEXT_ALIGNMENT_RIGHT

- Type: Number | String
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Right align text.

Use with the [Titanium.UI.TextField.textAlign](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#textAlign), [Titanium.UI.Button.textAlign](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md#textAlign) and
[Titanium.UI.TextArea.textAlign](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#textAlign) properties.

This constant is a string on Android, and a number on iOS.

### TEXT_AUTOCAPITALIZATION_ALL

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Auto-capitalize all text in the input field.

Use with the [Titanium.UI.TextField.autocapitalization](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#autocapitalization) and
[Titanium.UI.TextArea.autocapitalization](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#autocapitalization) properties.

### TEXT_AUTOCAPITALIZATION_NONE

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Do not auto-capitalize.

Use with the [Titanium.UI.TextField.autocapitalization](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#autocapitalization) and
[Titanium.UI.TextArea.autocapitalization](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#autocapitalization) properties.

### TEXT_AUTOCAPITALIZATION_SENTENCES

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Use sentence-style auto-capitalization in the input field.

Use with the [Titanium.UI.TextField.autocapitalization](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#autocapitalization) and
[Titanium.UI.TextArea.autocapitalization](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#autocapitalization) properties.

### TEXT_AUTOCAPITALIZATION_WORDS

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Auto-capitalize the first letter of each word in the input field.

Use with the [Titanium.UI.TextField.autocapitalization](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#autocapitalization) and
[Titanium.UI.TextArea.autocapitalization](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#autocapitalization) properties.

### TEXT_ELLIPSIZE_TRUNCATE_CHAR_WRAP

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 6.0.0
- Permission: read-only

Add ellipses before the first character that doesnt fit.

One of the group of constants for the [Titanium.UI.Label.ellipsize](https://titaniumsdk.com/docs/sdk/Titanium.UI.Label.md#ellipsize) property.

### TEXT_ELLIPSIZE_TRUNCATE_CLIP

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 6.0.0
- Permission: read-only

Lines are simply not drawn past the edge of the text container.

One of the group of constants for the [Titanium.UI.Label.ellipsize](https://titaniumsdk.com/docs/sdk/Titanium.UI.Label.md#ellipsize) property.

### TEXT_ELLIPSIZE_TRUNCATE_END

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 4.1.0
- Permission: read-only

Add ellipses at the end of the label if the text is too large to fit.

One of the group of constants for the [Titanium.UI.Label.ellipsize](https://titaniumsdk.com/docs/sdk/Titanium.UI.Label.md#ellipsize) property.

### TEXT_ELLIPSIZE_TRUNCATE_MARQUEE

- Type: Number
- Platforms: Android
- Since: Titanium SDK 4.1.0
- Permission: read-only

Turns on a marquee effect of the label if the text is too large to fit. (This requires [Titanium.UI.Label.focusable](https://titaniumsdk.com/docs/sdk/Titanium.UI.Label.md#focusable) to be true)

One of the group of constants for the [Titanium.UI.Label.ellipsize](https://titaniumsdk.com/docs/sdk/Titanium.UI.Label.md#ellipsize) property.

### TEXT_ELLIPSIZE_TRUNCATE_MIDDLE

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 4.1.0
- Permission: read-only

Add ellipses in the middle of the label if the text is too large to fit.

One of the group of constants for the [Titanium.UI.Label.ellipsize](https://titaniumsdk.com/docs/sdk/Titanium.UI.Label.md#ellipsize) property.

### TEXT_ELLIPSIZE_TRUNCATE_NONE

- Type: Number
- Platforms: Android
- Since: Titanium SDK 6.0.0
- Permission: read-only

Disables ellipsizing of the label. The text will be cut off if it is too long.

One of the group of constants for the [Titanium.UI.Label.ellipsize](https://titaniumsdk.com/docs/sdk/Titanium.UI.Label.md#ellipsize) property.

### TEXT_ELLIPSIZE_TRUNCATE_START

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 4.1.0
- Permission: read-only

Add ellipses at the beginning of the label if the text is too large to fit.

One of the group of constants for the [Titanium.UI.Label.ellipsize](https://titaniumsdk.com/docs/sdk/Titanium.UI.Label.md#ellipsize) property.

### TEXT_ELLIPSIZE_TRUNCATE_WORD_WRAP

- Type: Number
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 6.0.0
- Permission: read-only

Add ellipses at word boundaries, unless the word itself doesn't fit on a single line.

One of the group of constants for the [Titanium.UI.Label.ellipsize](https://titaniumsdk.com/docs/sdk/Titanium.UI.Label.md#ellipsize) property.

### TEXT_STYLE_BODY

- Type: String
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.2.0
- Permission: read-only

The font used for body texts.

One of the group of textStyle constants for the [Font](https://titaniumsdk.com/docs/sdk/Font.md) Object.

### TEXT_STYLE_CALLOUT

- Type: String
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 6.0.0
- Permission: read-only

The font used for callouts.

One of the group of textStyle constants for the [Font](https://titaniumsdk.com/docs/sdk/Font.md) Object.

### TEXT_STYLE_CAPTION1

- Type: String
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.2.0
- Permission: read-only

The font used for standard captions.

One of the group of textStyle constants for the [Font](https://titaniumsdk.com/docs/sdk/Font.md) Object.

### TEXT_STYLE_CAPTION2

- Type: String
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.2.0
- Permission: read-only

The font used for alternate captions.

One of the group of textStyle constants for the [Font](https://titaniumsdk.com/docs/sdk/Font.md) Object.

### TEXT_STYLE_FOOTNOTE

- Type: String
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.2.0
- Permission: read-only

The font used in footnotes.

One of the group of textStyle constants for the [Font](https://titaniumsdk.com/docs/sdk/Font.md) Object.

### TEXT_STYLE_HEADLINE

- Type: String
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.2.0
- Permission: read-only

The font used for headings.

One of the group of textStyle constants for the [Font](https://titaniumsdk.com/docs/sdk/Font.md) Object.

### TEXT_STYLE_LARGE_TITLE

- Type: String
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 8.1.0
- Permission: read-only

Specifies the text style for the [Font](https://titaniumsdk.com/docs/sdk/Font.md) Object.

One of the group of textStyle constants for the [Font](https://titaniumsdk.com/docs/sdk/Font.md) Object.

### TEXT_STYLE_SUBHEADLINE

- Type: String
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 3.2.0
- Permission: read-only

The font used for subheadings.

One of the group of textStyle constants for the [Font](https://titaniumsdk.com/docs/sdk/Font.md) Object.

### TEXT_STYLE_TITLE1

- Type: String
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 6.0.0
- Permission: read-only

The font used for first level hierarchical headings.

One of the group of textStyle constants for the [Font](https://titaniumsdk.com/docs/sdk/Font.md) Object.

### TEXT_STYLE_TITLE2

- Type: String
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 6.0.0
- Permission: read-only

The font used for second level hierarchical headings.

One of the group of textStyle constants for the [Font](https://titaniumsdk.com/docs/sdk/Font.md) Object.

### TEXT_STYLE_TITLE3

- Type: String
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 6.0.0
- Permission: read-only

The font used for third level hierarchical headings.

One of the group of textStyle constants for the [Font](https://titaniumsdk.com/docs/sdk/Font.md) Object.

### TEXT_VERTICAL_ALIGNMENT_BOTTOM

- Type: Number | String
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Align text to the bottom of the view.

Use with the [Titanium.UI.TextField.verticalAlign](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#verticalAlign) and
[Titanium.UI.TextArea.verticalAlign](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#verticalAlign) properties.

This constant is a string on Android, and a number on iOS.

### TEXT_VERTICAL_ALIGNMENT_CENTER

- Type: Number | String
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Vertically align text to the center of the view.

Use with the [Titanium.UI.TextField.verticalAlign](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#verticalAlign) and
[Titanium.UI.TextArea.verticalAlign](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#verticalAlign) properties.

This constant is a string on Android, and a number on iOS.

### TEXT_VERTICAL_ALIGNMENT_TOP

- Type: Number | String
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Align text to the top of the view.

Use with the [Titanium.UI.TextField.verticalAlign](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md#verticalAlign) and
[Titanium.UI.TextArea.verticalAlign](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md#verticalAlign) properties.

This constant is a string on Android, and a number on iOS.

### tintColor

- Type: String | Titanium.UI.Color
- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 6.0.0

Sets the global tint color of the application. It is inherited by the child views and can be
overwritten by them using the `tintColor` property.

### UNIT_CM

- Type: String
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 2.0.0
- Permission: read-only

Unit constant representing units in centimeters.

### UNIT_DIP

- Type: String
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 2.0.0
- Permission: read-only

Unit constant representing units in density-independent pixels.

### UNIT_IN

- Type: String
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 2.0.0
- Permission: read-only

Unit constant representing units in inches.

### UNIT_MM

- Type: String
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 2.0.0
- Permission: read-only

Unit constant representing units in millimeters.

### UNIT_PX

- Type: String
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 2.0.0
- Permission: read-only

Unit constant representing units in pixels.

### UNKNOWN

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Orientation constant representing an unknown orientation.

One of the group of orientation constants for the [Titanium.Gesture](https://titaniumsdk.com/docs/sdk/Titanium.Gesture.md) module,
[Titanium.UI.PORTRAIT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#PORTRAIT),
[Titanium.UI.UPSIDE_PORTRAIT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#UPSIDE_PORTRAIT),
[Titanium.UI.LANDSCAPE_LEFT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#LANDSCAPE_LEFT),
[Titanium.UI.LANDSCAPE_RIGHT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#LANDSCAPE_RIGHT),
[Titanium.UI.FACE_UP](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#FACE_UP),
[Titanium.UI.FACE_DOWN](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#FACE_DOWN),
and [Titanium.UI.UNKNOWN](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#UNKNOWN).

### UPSIDE_PORTRAIT

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Permission: read-only

Orientation constant for inverted portait orientation.

One of the group of orientation constants for the [Titanium.Gesture](https://titaniumsdk.com/docs/sdk/Titanium.Gesture.md) module,
[Titanium.UI.PORTRAIT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#PORTRAIT),
[Titanium.UI.UPSIDE_PORTRAIT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#UPSIDE_PORTRAIT),
[Titanium.UI.LANDSCAPE_LEFT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#LANDSCAPE_LEFT),
[Titanium.UI.LANDSCAPE_RIGHT](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#LANDSCAPE_RIGHT),
[Titanium.UI.FACE_UP](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#FACE_UP),
[Titanium.UI.FACE_DOWN](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#FACE_DOWN),
and [Titanium.UI.UNKNOWN](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#UNKNOWN).

### URL_ERROR_AUTHENTICATION

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 3.0.0
- Permission: read-only

Authentication error code reported via [Titanium.UI.WebView.error](https://titaniumsdk.com/docs/sdk/Titanium.UI.WebView.md#error).

### URL_ERROR_BAD_URL

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 3.0.0
- Permission: read-only

Bad url error code reported via [Titanium.UI.WebView.error](https://titaniumsdk.com/docs/sdk/Titanium.UI.WebView.md#error).

### URL_ERROR_CONNECT

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 3.0.0
- Permission: read-only

Error code reported via [Titanium.UI.WebView.error](https://titaniumsdk.com/docs/sdk/Titanium.UI.WebView.md#error) for a failure to connect to host.

### URL_ERROR_FILE

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 3.0.0
- Permission: read-only

Error code reported via [Titanium.UI.WebView.error](https://titaniumsdk.com/docs/sdk/Titanium.UI.WebView.md#error) for a failure to access a file resource on a host, except "file not found", which has its own constant.

### URL_ERROR_FILE_NOT_FOUND

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 3.0.0
- Permission: read-only

Error code reported via [Titanium.UI.WebView.error](https://titaniumsdk.com/docs/sdk/Titanium.UI.WebView.md#error) when a requested file does not exist on the host.

### URL_ERROR_HOST_LOOKUP

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 3.0.0
- Permission: read-only

Error code reported via [Titanium.UI.WebView.error](https://titaniumsdk.com/docs/sdk/Titanium.UI.WebView.md#error) when a host name cannot be resolved, such as via a DNS lookup error.

### URL_ERROR_REDIRECT_LOOP

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 3.0.0
- Permission: read-only

Error code reported via [Titanium.UI.WebView.error](https://titaniumsdk.com/docs/sdk/Titanium.UI.WebView.md#error) when a redirect loop is detected.

### URL_ERROR_SSL_FAILED

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 3.0.0
- Permission: read-only

Error code reported via [Titanium.UI.WebView.error](https://titaniumsdk.com/docs/sdk/Titanium.UI.WebView.md#error) for an SSL failure.

### URL_ERROR_TIMEOUT

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 3.0.0
- Permission: read-only

Error code reported via [Titanium.UI.WebView.error](https://titaniumsdk.com/docs/sdk/Titanium.UI.WebView.md#error) when a timeout occurs.

### URL_ERROR_UNKNOWN

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 3.0.0
- Permission: read-only

Error code reported via [Titanium.UI.WebView.error](https://titaniumsdk.com/docs/sdk/Titanium.UI.WebView.md#error) when an unknown error occurs.

### URL_ERROR_UNSUPPORTED_SCHEME

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 3.0.0
- Permission: read-only

Error code reported via [Titanium.UI.WebView.error](https://titaniumsdk.com/docs/sdk/Titanium.UI.WebView.md#error) when a url contains an unsupported scheme.

### USER_INTERFACE_STYLE_DARK

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 9.1.0
- Requires: iOS 13.0+
- Permission: read-only

A dark interface style.

Used in the `userInterfaceStyle` property. Value indicating that night/dark mode has been set.
See [UI_MODE_NIGHT_YES](https://developer.android.com/reference/android/content/res/Configuration.html#UI_MODE_NIGHT_YES)

### USER_INTERFACE_STYLE_LIGHT

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 9.1.0
- Requires: iOS 13.0+
- Permission: read-only

A light interface style.

Used in the `userInterfaceStyle` property. Value indicating that light/normal mode has been set.
See [UI_MODE_NIGHT_NO](https://developer.android.com/reference/android/content/res/Configuration.html#UI_MODE_NIGHT_NO)

### USER_INTERFACE_STYLE_UNSPECIFIED

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 9.1.0
- Requires: iOS 13.0+
- Permission: read-only

An unspecified interface style.

Used in the `userInterfaceStyle` property. Value indicating that no mode has been set.
See [UI_MODE_NIGHT_UNDEFINED](https://developer.android.com/reference/android/content/res/Configuration.html#UI_MODE_NIGHT_UNDEFINED)

### userInterfaceStyle

- Type: Number
- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 9.1.0
- Requires: iOS 13.0+
- Permission: read-only

The style associated with the user interface.

Use this property to determine whether your interface should be configured with a dark or light appearance.
The default value of this trait is set to the corresponding appearance setting on the user's device.

See [UI_MODE_NIGHT_MASK](https://developer.android.com/reference/android/content/res/Configuration.html#UI_MODE_NIGHT_MASK).

Accepts: `Titanium.UI.USER_INTERFACE_STYLE_DARK`, `Titanium.UI.USER_INTERFACE_STYLE_LIGHT`, `Titanium.UI.USER_INTERFACE_STYLE_UNSPECIFIED`

## Methods

### convertUnits

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 2.0.0

Converts one type of unit to another using the metrics of the main display.

As this method does not support percentages, `0` is returned if they are specified.

Parameters:

- `convertFromValue` (String): Measurement and optional unit to convert from, i.e. 160, "120dip". Percentages are not accepted.
- `convertToUnits` (Number): Desired unit for the conversion result.

Returns: Number

### createActivityIndicator

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 0.8

Creates and returns an instance of [Titanium.UI.ActivityIndicator](https://titaniumsdk.com/docs/sdk/Titanium.UI.ActivityIndicator.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.ActivityIndicator>, optional): Properties to set on a new object, including any defined by [Titanium.UI.ActivityIndicator](https://titaniumsdk.com/docs/sdk/Titanium.UI.ActivityIndicator.md) except those marked not-creation or read-only.

Returns: Titanium.UI.ActivityIndicator

### createAlertDialog

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 0.8

Creates and returns an instance of [Titanium.UI.AlertDialog](https://titaniumsdk.com/docs/sdk/Titanium.UI.AlertDialog.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.AlertDialog>, optional): Properties to set on a new object, including any defined by [Titanium.UI.AlertDialog](https://titaniumsdk.com/docs/sdk/Titanium.UI.AlertDialog.md) except those marked not-creation or read-only.

Returns: Titanium.UI.AlertDialog

### createAnimation

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 0.9

Creates and returns an instance of [Titanium.UI.Animation](https://titaniumsdk.com/docs/sdk/Titanium.UI.Animation.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.Animation>, optional): Properties to set on a new object, including any defined by [Titanium.UI.Animation](https://titaniumsdk.com/docs/sdk/Titanium.UI.Animation.md) except those marked not-creation or read-only.

Returns: Titanium.UI.Animation

### createAttributedString

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 3.6.0

Creates and returns an instance of [Titanium.UI.AttributedString](https://titaniumsdk.com/docs/sdk/Titanium.UI.AttributedString.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.AttributedString>, optional): Properties to set on a new object, including any defined by [Titanium.UI.AttributedString](https://titaniumsdk.com/docs/sdk/Titanium.UI.AttributedString.md) except those marked not-creation or read-only.

Returns: Titanium.UI.AttributedString

### createButton

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 0.8

Creates and returns an instance of [Titanium.UI.Button](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.Button>, optional): Properties to set on a new object, including any defined by [Titanium.UI.Button](https://titaniumsdk.com/docs/sdk/Titanium.UI.Button.md) except those marked not-creation or read-only.

Returns: Titanium.UI.Button

### createButtonBar

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK Android 10.0.0, iPhone 0.8, iPad 0.8, macOS 9.2.0

Creates and returns an instance of [Titanium.UI.ButtonBar](https://titaniumsdk.com/docs/sdk/Titanium.UI.ButtonBar.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.ButtonBar>, optional): Properties to set on a new object, including any defined by [Titanium.UI.ButtonBar](https://titaniumsdk.com/docs/sdk/Titanium.UI.ButtonBar.md) except those marked not-creation or read-only.

Returns: Titanium.UI.ButtonBar

### createColor

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 9.1.0

Creates and returns an instance of [Titanium.UI.Color](https://titaniumsdk.com/docs/sdk/Titanium.UI.Color.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.Color>, optional): Properties to set on a new object, including any defined by [Titanium.UI.Color](https://titaniumsdk.com/docs/sdk/Titanium.UI.Color.md) except those marked not-creation or read-only.

Returns: Titanium.UI.Color

### createDashboardItem

- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 1.2

Creates and returns an instance of [Titanium.UI.DashboardItem](https://titaniumsdk.com/docs/sdk/Titanium.UI.DashboardItem.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.DashboardItem>, optional): Properties to set on a new object, including any defined by [Titanium.UI.DashboardItem](https://titaniumsdk.com/docs/sdk/Titanium.UI.DashboardItem.md) except those marked not-creation or read-only.

Returns: Titanium.UI.DashboardItem

### createDashboardView

- Platforms: iPhone, iPad, macOS
- Since: Titanium SDK 1.2

Creates and returns an instance of [Titanium.UI.DashboardView](https://titaniumsdk.com/docs/sdk/Titanium.UI.DashboardView.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.DashboardView>, optional): Properties to set on a new object, including any defined by [Titanium.UI.DashboardView](https://titaniumsdk.com/docs/sdk/Titanium.UI.DashboardView.md) except those marked not-creation or read-only.

Returns: Titanium.UI.DashboardView

### createEmailDialog

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 0.8

Creates and returns an instance of [Titanium.UI.EmailDialog](https://titaniumsdk.com/docs/sdk/Titanium.UI.EmailDialog.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.EmailDialog>, optional): Properties to set on a new object, including any defined by [Titanium.UI.EmailDialog](https://titaniumsdk.com/docs/sdk/Titanium.UI.EmailDialog.md) except those marked not-creation or read-only.

Returns: Titanium.UI.EmailDialog

### createImageView

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 0.9

Creates and returns an instance of [Titanium.UI.ImageView](https://titaniumsdk.com/docs/sdk/Titanium.UI.ImageView.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.ImageView>, optional): Properties to set on a new object, including any defined by [Titanium.UI.ImageView](https://titaniumsdk.com/docs/sdk/Titanium.UI.ImageView.md) except those marked not-creation or read-only.

Returns: Titanium.UI.ImageView

### createLabel

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 0.8

Creates and returns an instance of [Titanium.UI.Label](https://titaniumsdk.com/docs/sdk/Titanium.UI.Label.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.Label>, optional): Properties to set on a new object, including any defined by [Titanium.UI.Label](https://titaniumsdk.com/docs/sdk/Titanium.UI.Label.md) except those marked not-creation or read-only.

Returns: Titanium.UI.Label

### createListSection

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 3.1.0

Creates and returns an instance of [Titanium.UI.ListSection](https://titaniumsdk.com/docs/sdk/Titanium.UI.ListSection.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.ListSection>, optional): Properties to set on a new object, including any defined by [Titanium.UI.ListSection](https://titaniumsdk.com/docs/sdk/Titanium.UI.ListSection.md) except those marked not-creation or read-only.

Returns: Titanium.UI.ListSection

### createListView

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 3.1.0

Creates and returns an instance of [Titanium.UI.ListView](https://titaniumsdk.com/docs/sdk/Titanium.UI.ListView.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.ListView>, optional): Properties to set on a new object, including any defined by [Titanium.UI.ListView](https://titaniumsdk.com/docs/sdk/Titanium.UI.ListView.md) except those marked not-creation or read-only.

Returns: Titanium.UI.ListView

### createMaskedImage

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK Android 7.3.0, iPhone 0.8, iPad 0.8

Creates and returns an instance of [Titanium.UI.MaskedImage](https://titaniumsdk.com/docs/sdk/Titanium.UI.MaskedImage.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.MaskedImage>, optional): Properties to set on a new object, including any defined by [Titanium.UI.MaskedImage](https://titaniumsdk.com/docs/sdk/Titanium.UI.MaskedImage.md) except those marked not-creation or read-only.

Returns: Titanium.UI.MaskedImage

### createMatrix2D

- Platforms: Android, iPhone, iPad, macOS

Creates and returns an instance of [Titanium.UI.Matrix2D](https://titaniumsdk.com/docs/sdk/Titanium.UI.Matrix2D.md).

Parameters:

- `parameters` (Matrix2DCreationDict, optional): Initial transformation of the matrix.

Returns: Titanium.UI.Matrix2D

### createMatrix3D

- Platforms: Android, iPhone, iPad, macOS

Creates and returns an instance of [Titanium.UI.Matrix3D](https://titaniumsdk.com/docs/sdk/Titanium.UI.Matrix3D.md).

Parameters:

- `parameters` (Matrix3DCreationDict, optional): Initial transformation of the matrix.

Returns: Titanium.UI.Matrix3D

### createNavigationWindow

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 8.0.0

Creates and returns an instance of [Titanium.UI.NavigationWindow](https://titaniumsdk.com/docs/sdk/Titanium.UI.NavigationWindow.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.NavigationWindow>, optional): Properties to set on a new object, including any defined by [Titanium.UI.NavigationWindow](https://titaniumsdk.com/docs/sdk/Titanium.UI.NavigationWindow.md) except those marked not-creation or read-only.

Returns: Titanium.UI.NavigationWindow

### createNotification

- Platforms: Android
- Since: Titanium SDK 0.8

Creates and returns an instance of [Titanium.UI.Notification](https://titaniumsdk.com/docs/sdk/Titanium.UI.Notification.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.Notification>, optional): Properties to set on a new object, including any defined by [Titanium.UI.Notification](https://titaniumsdk.com/docs/sdk/Titanium.UI.Notification.md) except those marked not-creation or read-only.

Returns: Titanium.UI.Notification

### createOptionBar

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 10.0.0

Creates and returns an instance of [Titanium.UI.OptionBar](https://titaniumsdk.com/docs/sdk/Titanium.UI.OptionBar.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.OptionBar>, optional): Properties to set on a new object, including any defined by [Titanium.UI.OptionBar](https://titaniumsdk.com/docs/sdk/Titanium.UI.OptionBar.md) except those marked not-creation or read-only.

Returns: Titanium.UI.OptionBar

### createOptionDialog

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 0.8

Creates and returns an instance of [Titanium.UI.OptionDialog](https://titaniumsdk.com/docs/sdk/Titanium.UI.OptionDialog.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.OptionDialog>, optional): Properties to set on a new object, including any defined by [Titanium.UI.OptionDialog](https://titaniumsdk.com/docs/sdk/Titanium.UI.OptionDialog.md) except those marked not-creation or read-only.

Returns: Titanium.UI.OptionDialog

### createPicker

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 0.8

Creates and returns an instance of [Titanium.UI.Picker](https://titaniumsdk.com/docs/sdk/Titanium.UI.Picker.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.Picker>, optional): Properties to set on a new object, including any defined by [Titanium.UI.Picker](https://titaniumsdk.com/docs/sdk/Titanium.UI.Picker.md) except those marked not-creation or read-only.

Returns: Titanium.UI.Picker

### createPickerColumn

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 0.9

Creates and returns an instance of [Titanium.UI.PickerColumn](https://titaniumsdk.com/docs/sdk/Titanium.UI.PickerColumn.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.PickerColumn>, optional): Properties to set on a new object, including any defined by [Titanium.UI.PickerColumn](https://titaniumsdk.com/docs/sdk/Titanium.UI.PickerColumn.md) except those marked not-creation or read-only.

Returns: Titanium.UI.PickerColumn

### createPickerRow

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 0.9

Creates and returns an instance of [Titanium.UI.PickerRow](https://titaniumsdk.com/docs/sdk/Titanium.UI.PickerRow.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.PickerRow>, optional): Properties to set on a new object, including any defined by [Titanium.UI.PickerRow](https://titaniumsdk.com/docs/sdk/Titanium.UI.PickerRow.md) except those marked not-creation or read-only.

Returns: Titanium.UI.PickerRow

### createProgressBar

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 0.8

Creates and returns an instance of [Titanium.UI.ProgressBar](https://titaniumsdk.com/docs/sdk/Titanium.UI.ProgressBar.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.ProgressBar>, optional): Properties to set on a new object, including any defined by [Titanium.UI.ProgressBar](https://titaniumsdk.com/docs/sdk/Titanium.UI.ProgressBar.md) except those marked not-creation or read-only.

Returns: Titanium.UI.ProgressBar

### createRefreshControl

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK Android 6.2.0, iPhone 3.2.0, iPad 3.2.0

Creates and returns an instance of [Titanium.UI.RefreshControl](https://titaniumsdk.com/docs/sdk/Titanium.UI.RefreshControl.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.RefreshControl>, optional): Properties to set on a new object, including any defined by [Titanium.UI.RefreshControl](https://titaniumsdk.com/docs/sdk/Titanium.UI.RefreshControl.md) except those marked not-creation or read-only.

Returns: Titanium.UI.RefreshControl

### createScrollableView

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 0.8

Creates and returns an instance of [Titanium.UI.ScrollableView](https://titaniumsdk.com/docs/sdk/Titanium.UI.ScrollableView.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.ScrollableView>, optional): Properties to set on a new object, including any defined by [Titanium.UI.ScrollableView](https://titaniumsdk.com/docs/sdk/Titanium.UI.ScrollableView.md) except those marked not-creation or read-only.

Returns: Titanium.UI.ScrollableView

### createScrollView

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 0.9

Creates and returns an instance of [Titanium.UI.ScrollView](https://titaniumsdk.com/docs/sdk/Titanium.UI.ScrollView.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.ScrollView>, optional): Properties to set on a new object, including any defined by [Titanium.UI.ScrollView](https://titaniumsdk.com/docs/sdk/Titanium.UI.ScrollView.md) except those marked not-creation or read-only.

Returns: Titanium.UI.ScrollView

### createSearchBar

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 0.8

Creates and returns an instance of [Titanium.UI.SearchBar](https://titaniumsdk.com/docs/sdk/Titanium.UI.SearchBar.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.SearchBar>, optional): Properties to set on a new object, including any defined by [Titanium.UI.SearchBar](https://titaniumsdk.com/docs/sdk/Titanium.UI.SearchBar.md) except those marked not-creation or read-only.

Returns: Titanium.UI.SearchBar

### createShortcut

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK Android 9.1.0, iPhone 9.1.0, iPad 9.1.0, macOS 9.2.0

Creates and returns an instance of [Titanium.UI.Shortcut](https://titaniumsdk.com/docs/sdk/Titanium.UI.Shortcut.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.Shortcut>, optional): Properties to set on a new object, including any defined by [Titanium.UI.Shortcut](https://titaniumsdk.com/docs/sdk/Titanium.UI.Shortcut.md) except those marked not-creation or read-only.

Returns: Titanium.UI.Shortcut

### createShortcutItem

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK Android 7.5.0, iPhone 9.1.0, iPad 9.1.0

Creates and returns an instance of [Titanium.UI.ShortcutItem](https://titaniumsdk.com/docs/sdk/Titanium.UI.ShortcutItem.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.ShortcutItem>, optional): Properties to set on a new object, including any defined by [Titanium.UI.ShortcutItem](https://titaniumsdk.com/docs/sdk/Titanium.UI.ShortcutItem.md) except those marked not-creation or read-only.

Returns: Titanium.UI.ShortcutItem

### createSlider

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 0.8

Creates and returns an instance of [Titanium.UI.Slider](https://titaniumsdk.com/docs/sdk/Titanium.UI.Slider.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.Slider>, optional): Properties to set on a new object, including any defined by [Titanium.UI.Slider](https://titaniumsdk.com/docs/sdk/Titanium.UI.Slider.md) except those marked not-creation or read-only.

Returns: Titanium.UI.Slider

### createSwitch

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 0.8

Creates and returns an instance of [Titanium.UI.Switch](https://titaniumsdk.com/docs/sdk/Titanium.UI.Switch.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.Switch>, optional): Properties to set on a new object, including any defined by [Titanium.UI.Switch](https://titaniumsdk.com/docs/sdk/Titanium.UI.Switch.md) except those marked not-creation or read-only.

Returns: Titanium.UI.Switch

### createTab

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 0.8

Creates and returns an instance of [Titanium.UI.Tab](https://titaniumsdk.com/docs/sdk/Titanium.UI.Tab.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.Tab>, optional): Properties to set on a new object, including any defined by [Titanium.UI.Tab](https://titaniumsdk.com/docs/sdk/Titanium.UI.Tab.md) except those marked not-creation or read-only.

Returns: Titanium.UI.Tab

### createTabbedBar

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK iPhone 0.8, iPad 0.8, Android 8.0.0

Creates and returns an instance of [Titanium.UI.TabbedBar](https://titaniumsdk.com/docs/sdk/Titanium.UI.TabbedBar.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.TabbedBar>, optional): Properties to set on a new object, including any defined by [Titanium.UI.TabbedBar](https://titaniumsdk.com/docs/sdk/Titanium.UI.TabbedBar.md) except those marked not-creation or read-only.

Returns: Titanium.UI.TabbedBar

### createTabGroup

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 0.9

Creates and returns an instance of [Titanium.UI.TabGroup](https://titaniumsdk.com/docs/sdk/Titanium.UI.TabGroup.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.TabGroup>, optional): Properties to set on a new object, including any defined by [Titanium.UI.TabGroup](https://titaniumsdk.com/docs/sdk/Titanium.UI.TabGroup.md) except those marked not-creation or read-only.

Returns: Titanium.UI.TabGroup

### createTableView

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 0.8

Creates and returns an instance of [Titanium.UI.TableView](https://titaniumsdk.com/docs/sdk/Titanium.UI.TableView.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.TableView>, optional): Properties to set on a new object, including any defined by [Titanium.UI.TableView](https://titaniumsdk.com/docs/sdk/Titanium.UI.TableView.md) except those marked not-creation or read-only.

Returns: Titanium.UI.TableView

### createTableViewRow

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 0.9

Creates and returns an instance of [Titanium.UI.TableViewRow](https://titaniumsdk.com/docs/sdk/Titanium.UI.TableViewRow.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.TableViewRow>, optional): Properties to set on a new object, including any defined by [Titanium.UI.TableViewRow](https://titaniumsdk.com/docs/sdk/Titanium.UI.TableViewRow.md) except those marked not-creation or read-only.

Returns: Titanium.UI.TableViewRow

### createTableViewSection

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 0.9

Creates and returns an instance of [Titanium.UI.TableViewSection](https://titaniumsdk.com/docs/sdk/Titanium.UI.TableViewSection.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.TableViewSection>, optional): Properties to set on a new object, including any defined by [Titanium.UI.TableViewSection](https://titaniumsdk.com/docs/sdk/Titanium.UI.TableViewSection.md) except those marked not-creation or read-only.

Returns: Titanium.UI.TableViewSection

### createTextArea

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 0.8

Creates and returns an instance of [Titanium.UI.TextArea](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.TextArea>, optional): Properties to set on a new object, including any defined by [Titanium.UI.TextArea](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextArea.md) except those marked not-creation or read-only.

Returns: Titanium.UI.TextArea

### createTextField

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 0.8

Creates and returns an instance of [Titanium.UI.TextField](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.TextField>, optional): Properties to set on a new object, including any defined by [Titanium.UI.TextField](https://titaniumsdk.com/docs/sdk/Titanium.UI.TextField.md) except those marked not-creation or read-only.

Returns: Titanium.UI.TextField

### createToolbar

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 6.2.0

Creates and returns an instance of [Titanium.UI.Toolbar](https://titaniumsdk.com/docs/sdk/Titanium.UI.Toolbar.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.Toolbar>, optional): Properties to set on a new object, including any defined by [Titanium.UI.Toolbar](https://titaniumsdk.com/docs/sdk/Titanium.UI.Toolbar.md) except those marked not-creation or read-only.

Returns: Titanium.UI.Toolbar

### createView

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 0.9

Creates and returns an instance of [Titanium.UI.View](https://titaniumsdk.com/docs/sdk/Titanium.UI.View.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.View>, optional): Properties to set on a new object, including any defined by [Titanium.UI.View](https://titaniumsdk.com/docs/sdk/Titanium.UI.View.md) except those marked not-creation or read-only.

Returns: Titanium.UI.View

### createWebView

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 0.8

Creates and returns an instance of [Titanium.UI.WebView](https://titaniumsdk.com/docs/sdk/Titanium.UI.WebView.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.WebView>, optional): Properties to set on a new object, including any defined by [Titanium.UI.WebView](https://titaniumsdk.com/docs/sdk/Titanium.UI.WebView.md) except those marked not-creation or read-only.

Returns: Titanium.UI.WebView

### createWindow

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 0.9

Creates and returns an instance of [Titanium.UI.Window](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md).

Parameters:

- `parameters` (Dictionary<Titanium.UI.Window>, optional): Properties to set on a new object, including any defined by [Titanium.UI.Window](https://titaniumsdk.com/docs/sdk/Titanium.UI.Window.md) except those marked not-creation or read-only.

Returns: Titanium.UI.Window

### fetchSemanticColor

- Platforms: Android, iPhone, iPad, macOS
- Since: Titanium SDK 8.2.0

Fetches the correct color to be used with a UI element dependent on the users current dark mode setting on iOS 13 and above, or the [Titanium.UI.semanticColorType](https://titaniumsdk.com/docs/sdk/Titanium.UI.md#semanticColorType) setting in other instances.
Will return a valid string value to be used for color properties on Android. This may be a hex string or an `rgba()` function.

Parameters:

- `colorName` (String): Name of the semantic color defined in the applications colorset.

Returns: Titanium.UI.Color

## Events

### userinterfacestyle

- Platforms: Android, iPhone, iPad, macOS
- Requires: iOS 13.0+

Fired when the `userInterfaceStyle` changes.

Event properties:

- `value` (Number): The new userInterfaceStyle value.

## Inherited members

7 members are inherited. Each is documented on the type that declares it.

- [Titanium.Proxy](https://titaniumsdk.com/docs/sdk/13.0.0/Titanium.Proxy.md): `addEventListener`, `apiName`, `applyProperties`, `bubbleParent`, `fireEvent`, `lifecycleContainer`, `removeEventListener`

---

- This corpus documents Titanium SDK 13.4.1. Anything here that does not name a version describes 13.4.1.
- Titanium is maintained by TiDev. The Appcelerator toolchain is retired: there is no `appc` CLI, no Appcelerator Studio and no hosted build service. The supported CLI is `titanium` on npm, invoked as `ti`.