@maccesar/titools 4.4.0 → 4.5.0

package/skills/ti-api/references/api-ui-extras.md

@@ -24,21 +24,13 @@
 > Extends Ti.Proxy
 > Platforms: both
 
-An animation object describes the properties of an animation. At its most basic, an animation
-object represents a single-phase animation with an end state and a duration.
+An animation object describes the properties of an animation. At its most basic, an animation object represents a single-phase animation with an end state and a duration.
 
-When [animate](Titanium.UI.View.animate) is called on a [View](Titanium.UI.View), the view is
-animated from its current state to the state described by the animation object. The properties
-that can be animated include the view's position, size, colors, transformation matrix and opacity.
+When [animate](Titanium.UI.View.animate) is called on a [View](Titanium.UI.View), the view is animated from its current state to the state described by the animation object. The properties that can be animated include the view's position, size, colors, transformation matrix and opacity.
 
-You can also specify an animation curve or *easing function* to control the pace of the
-animation. To use an easing function, set the animation's `curve` property to one of the
-`ANIMATION_CURVE` constants defined in <Titanium.UI>. For example,
-[ANIMATION_CURVE_EASE_IN](Titanium.UI.ANIMATION_CURVE_EASE_IN) specifies an animation that
-starts slowly and then speeds up.
+You can also specify an animation curve or *easing function* to control the pace of the animation. To use an easing function, set the animation's `curve` property to one of the `ANIMATION_CURVE` constants defined in <Titanium.UI>. For example, [ANIMATION_CURVE_EASE_IN](Titanium.UI.ANIMATION_CURVE_EASE_IN) specifies an animation that starts slowly and then speeds up.
 
-Animations can be set to reverse themselves automatically on completion, and to repeat a given
-number of times. For more complicated effects, multiple animations can be combined in sequence,
+Animations can be set to reverse themselves automatically on completion, and to repeat a given number of times. For more complicated effects, multiple animations can be combined in sequence,
 
 *(See full overview in titanium-docs)*
 
@@ -100,8 +92,7 @@ number of times. For more complicated effects, multiple animations can be combin
 > Extends Ti.Proxy
 > Platforms: both
 
-A 2D matrix is used to rotate, scale, translate, or skew the objects in a two-dimensional space.
-A 2D affine transformation can be  represented by a 3 by 3 matrix:
+A 2D matrix is used to rotate, scale, translate, or skew the objects in a two-dimensional space. A 2D affine transformation can be  represented by a 3 by 3 matrix:
 
 ### Properties (unique: 6/9)
 | Property | Type | Default | Platform | Description |
@@ -131,12 +122,9 @@ A 2D affine transformation can be  represented by a 3 by 3 matrix:
 > Extends Ti.Proxy
 > Platforms: ios
 
-The 3D Matrix is created by <Titanium.UI.createMatrix3D>. A 3D transform is
-used to rotate, scale, translate, or skew the objects in three-dimensional
-space. A 3D transform  is represented by a 4 by 4 matrix.
+The 3D Matrix is created by <Titanium.UI.createMatrix3D>. A 3D transform is used to rotate, scale, translate, or skew the objects in three-dimensional space. A 3D transform  is represented by a 4 by 4 matrix.
 
-You create an `identity matrix` by creating a 3D Matrix with an empty
-constructor.
+You create an `identity matrix` by creating a 3D Matrix with an empty constructor.
 
 ### Properties (unique: 16/18)
 | Property | Type | Default | Platform | Description |
@@ -178,16 +166,13 @@ constructor.
 
 Use the <Titanium.UI.createWebView> method or **`<WebView>`** Alloy element to create a web view.
 
-Web views are more expensive to create than other native views because of the requirement to
-load the HTML browser into memory.
+Web views are more expensive to create than other native views because of the requirement to load the HTML browser into memory.
 
-The web view content can be any valid web content such as HTML, PDF, SVG or other WebKit supported
-content types.
+The web view content can be any valid web content such as HTML, PDF, SVG or other WebKit supported content types.
 
 ### JavaScript Context in WebViews--Local vs. Remote Content
 
-JavaScript in the web view executes in its own context.  The web view can interact with this
-content, but most of this functionality is limited to local content.
+JavaScript in the web view executes in its own context.  The web view can interact with this content, but most of this functionality is limited to local content.
 
 **Local Scripts**
 
@@ -295,27 +280,90 @@ content, but most of this functionality is limited to local content.
 #### BackForwardList
 > The object returned to the <Titanium.UI.WebView.backForwardList> method.
 
-| Property | Type | Description |
-|----------|------|-------------|
-| currentItem | BackForwardListItem | The current item. |
-| backItem | BackForwardListItem | The item immediately preceding the current item. |
-| forwardItem | BackForwardListItem | The item immediately following the current item. |
-| backList | Array<BackForwardListItem> | The portion of the list preceding the current item. |
-| forwardList | Array<BackForwardListItem> | The portion of the list following the current item. |
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| currentItem | BackForwardListItem | ios | The current item. |
+| backItem | BackForwardListItem | ios | The item immediately preceding the current item. |
+| forwardItem | BackForwardListItem | ios | The item immediately following the current item. |
+| backList | Array<BackForwardListItem> | ios | The portion of the list preceding the current item. |
+| forwardList | Array<BackForwardListItem> | ios | The portion of the list following the current item. |
+
+#### BackForwardListItem
+> The object represents a webpage in the back-forward of a web view.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| url | String | ios | The URL of the webpage represented by this item. |
+| initialUrl | String | ios | The URL of the initial request that created this item. |
+| title | String | ios | The title of the webpage represented by this item. |
+
+#### DataCreationResult
+> The parameter passed to the <Titanium.UI.WebView.createPDF> or <Titanium.UI.WebView.createWebArchive>callback.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| data | Ti.Blob | ios | The created data. |
+| success | Boolean | ios | Indicates if the data creation successful or not. |
+| error | String | ios | Error message, if any returned. |
+
+#### DataCreationResultAndroid
+> Success callback in <Titanium.UI.WebView.createPDF>.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| data | Ti.Blob | android | The created data. |
+
+#### OnLinkURLResponse
+> An object returned when the <Titanium.UI.WebView.onlink> callback is fired.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| url | String | both | The URL of the link that should be navigated to. |
 
-#### Dictionary
-> Plain JavaScript object.
+#### SearchResult
+> The parameter passed to the <Titanium.UI.WebView.findString>.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| success | Boolean | ios | Indicates if string found or not. |
+| error | String | ios | Error message, if any returned. |
+
+#### setHtmlOptions
+> Options used by <Titanium.UI.WebView.setHtml>
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| baseURL | String | both | Sets the URL that the web content's paths will be relative to. |
+| mimeType | String | both | Sets the MIME type for the content. Defaults to "text/html" if not specified. |
+
+#### SnapshotResult
+> The parameter passed to the <Titanium.UI.WebView.takeSnapshot> callback.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| snapshot | Ti.Blob | ios | The snapshot image. |
+| success | Boolean | ios | Indicates if the snapshot taken. |
+| error | String | ios | Error message, if any returned. |
 
 #### StringSearchOptions
 > The optional options to pass to the <Titanium.UI.WebView.findString>. Pass a dictionary with one or more of the following string-keys:     * `caseSensitive` (Boolean value)     * `backward` (Boolean value)     * `wraps` (Boolean value)
 
-| Property | Type | Description |
-|----------|------|-------------|
-| caseSensitive | Boolean | Whether or not the search should be case sensitive. |
-| backward | Boolean | The direction to search from the current selection. The search will respect the… |
-| wraps | Boolean | Whether the search should start at the beginning of the document once it reache… |
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| caseSensitive | Boolean | both | Whether or not the search should be case sensitive. |
+| backward | Boolean | both | The direction to search from the current selection. The search will respect the… |
+| wraps | Boolean | both | Whether the search should start at the beginning of the document once it reache… |
+
+#### UserScriptParams
+> Dictionary of options for the <Titanium.UI.WebView.addUserScript> method.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| source | String | ios | A script that can be injected into a webpage. |
+| injectionTime | Number | ios | The time when the script should be injected into the webpage. |
+| mainFrameOnly | Boolean | ios | A Boolean value indicating whether the script should be injected only into the … |
 
-*Plus 2 more types: *
+Also referenced by this API, documented elsewhere: `Dictionary`.
 
 ---
 
@@ -326,19 +374,14 @@ content, but most of this functionality is limited to local content.
 
 A `Toolbar` is created by the <Titanium.UI.createToolbar> factory method or **`<Toolbar>`** Alloy element.
 
-To provide spacing between items in the toolbar, on iOS you can use the special system button types,
-[FIXED_SPACE](Titanium.UI.iOS.SystemButton.FIXED_SPACE) and
-[FLEXIBLE_SPACE](Titanium.UI.iOS.SystemButton.FLEXIBLE_SPACE).
+To provide spacing between items in the toolbar, on iOS you can use the special system button types, [FIXED_SPACE](Titanium.UI.iOS.SystemButton.FIXED_SPACE) and [FLEXIBLE_SPACE](Titanium.UI.iOS.SystemButton.FLEXIBLE_SPACE).
 
-Note that toolbars are positioned like other views (using the `top` and `bottom` properties,
-for example), but the [iOS Human Interface Guidelines](https://developer.apple.com/ios/human-interface-guidelines/overview/themes/#//apple_ref/doc/uid/TP40006556-CH12-SW4)
-have specific requirements for placing toolbars, specifically:
+Note that toolbars are positioned like other views (using the `top` and `bottom` properties, for example), but the [iOS Human Interface Guidelines](https://developer.apple.com/ios/human-interface-guidelines/overview/themes/#//apple_ref/doc/uid/TP40006556-CH12-SW4) have specific requirements for placing toolbars, specifically:
 
 * On the iPhone and Android, a toolbar should be at the bottom of the window.
 * On the iPad, a toolbar should appear at the top or bottom of a window.
 
-Due to an iOS limitation, the buttons in the toolbar only support the `click` event.
-The native object underlying a toolbar button does not generate standard view events,
+Due to an iOS limitation, the buttons in the toolbar only support the `click` event. The native object underlying a toolbar button does not generate standard view events,
 
 *(See full overview in titanium-docs)*
 
@@ -393,15 +436,11 @@ The native object underlying a toolbar button does not generate standard view ev
 | ------- | --- |
 | ![Android](./buttonbar_android.png) |  |
 
-The button bar is a set of buttons joined into a single control.
-On iOS, you can set up the buttons with either a title or image, but not both.
-On Android, you can set up the buttons with a title, image, or both.
+The button bar is a set of buttons joined into a single control. On iOS, you can set up the buttons with either a title or image, but not both. On Android, you can set up the buttons with a title, image, or both.
 
 Use the <Titanium.UI.createButtonBar> method or **`<ButtonBar>`** Alloy element to create a button bar.
 
-The [TabbedBar](Titanium.UI.iOS.TabbedBar) control is a button bar where the
-last selected button maintains a pressed or selected state. The following discussion
-applies to both button bar and tabbed bar.
+The [TabbedBar](Titanium.UI.iOS.TabbedBar) control is a button bar where the last selected button maintains a pressed or selected state. The following discussion applies to both button bar and tabbed bar.
 
 ### Properties (unique: 5/76)
 | Property | Type | Default | Platform | Description |
@@ -426,11 +465,7 @@ applies to both button bar and tabbed bar.
 > Extends Ti.UI.View
 > Platforms: both
 
-A tabbed bar is a button bar that
-maintains a state (visually distinguished as a pressed or selected look).
-It is closely related to the `ButtonBar` control. See the description of
-[ButtonBar](Titanium.UI.ButtonBar) for information on styling tabbed bars and buttons
-bars.
+A tabbed bar is a button bar that maintains a state (visually distinguished as a pressed or selected look). It is closely related to the `ButtonBar` control. See the description of [ButtonBar](Titanium.UI.ButtonBar) for information on styling tabbed bars and buttons bars.
 
 Use the <Titanium.UI.createTabbedBar> method to create a Tabbed Bar.
 
@@ -465,11 +500,9 @@ Use the <Titanium.UI.createTabbedBar> method to create a Tabbed Bar.
 
 This is a view which shows a list of options where only 1 option is selectable by the user.
 
-On iOS, this displays a
-[segmented control](https://developer.apple.com/design/human-interface-guidelines/ios/controls/segmented-controls/).
+On iOS, this displays a [segmented control](https://developer.apple.com/design/human-interface-guidelines/ios/controls/segmented-controls/).
 
-On Android, this displays a
-[toggle button group](https://material.io/components/buttons/android#toggle-button).
+On Android, this displays a [toggle button group](https://material.io/components/buttons/android#toggle-button).
 
 Use the <Titanium.UI.createOptionBar> method to create a Option Bar.
 
@@ -498,11 +531,9 @@ Use the <Titanium.UI.createOptionBar> method to create a Option Bar.
 > Extends Ti.Proxy
 > Platforms: both
 
-Allows the creation of application shortcuts, which can be detected using
-the `click` event from <Titanium.UI.Shortcut>.
+Allows the creation of application shortcuts, which can be detected using the `click` event from <Titanium.UI.Shortcut>.
 
-On iOS, shortcuts are only supported on a 3D Touch compatible device.
-Use the <Titanium.UI.iOS.forceTouchSupported> property to see if it's supported.
+On iOS, shortcuts are only supported on a 3D Touch compatible device. Use the <Titanium.UI.iOS.forceTouchSupported> property to see if it's supported.
 
 ### Properties (unique: 2/5)
 | Property | Type | Default | Platform | Description |
@@ -531,15 +562,12 @@ Use the <Titanium.UI.iOS.forceTouchSupported> property to see if it's supported.
 > Extends Ti.Proxy
 > Platforms: both
 
-Allows the creation of dynamic application shortcut items which can be set in the app to 
-offer a dynamic behavior at runtime.
+Allows the creation of dynamic application shortcut items which can be set in the app to offer a dynamic behavior at runtime.
 
-Use the <Titanium.UI.createShortcutItem> method to create a shortcut item and pass it to
-the <Titanium.UI.Shortcut.add> method to add it to the application.
+Use the <Titanium.UI.createShortcutItem> method to create a shortcut item and pass it to the <Titanium.UI.Shortcut.add> method to add it to the application.
 
 ### Android Static Shortcuts
-Google documents how to add static shortcuts
-[here](https://developer.android.com/guide/topics/ui/shortcuts/creating-shortcuts#static).
+Google documents how to add static shortcuts [here](https://developer.android.com/guide/topics/ui/shortcuts/creating-shortcuts#static).
 
 In the `tiapp.xml` file, you will need to add a shortcuts `<meta-data/>` element to your main activity.
 
@@ -573,9 +601,7 @@ In the `tiapp.xml` file, you will need to add a shortcuts `<meta-data/>` element
 | ------- | --- |
 | ![Android](./emaildialog_android.png) | ![iOS](./emaildialog_ios.png) |
 
-The Email Dialog is created with the <Titanium.UI.createEmailDialog> method. The user needs to
-register an e-mail account on the device in order to open the dialog.  The dialog will not
-open when there is not a registered e-mail account.
+The Email Dialog is created with the <Titanium.UI.createEmailDialog> method. The user needs to register an e-mail account on the device in order to open the dialog.  The dialog will not open when there is not a registered e-mail account.
 
 **iOS Platform Notes**
 
@@ -624,20 +650,13 @@ On iOS, you cannot test the e-mail dialog on the iOS Simulator. Test the email d
 > Extends Ti.UI.View
 > Platforms: ios
 
-The DashboardView is created using the <Titanium.UI.createDashboardView> method or **`<DashboardView>`** 
-Alloy element.
+The DashboardView is created using the <Titanium.UI.createDashboardView> method or **`<DashboardView>`** Alloy element.
 
-Dashboard view's edit mode may be activated by a longpress of a <Titanium.UI.DashboardItem> item, 
-unless this behavior has been disabled by the [editable](Titanium.UI.DashboardView.editable) 
-property. As a dashboard view does not inherently provide a way to exit edit mode, this must be 
-explicitly defined.
+Dashboard view's edit mode may be activated by a longpress of a <Titanium.UI.DashboardItem> item, unless this behavior has been disabled by the [editable](Titanium.UI.DashboardView.editable) property. As a dashboard view does not inherently provide a way to exit edit mode, this must be explicitly defined.
 
-When edit mode has been activated, the item icons wobble by default to act as a visual cue. 
-This behavior may be disabled using the [wobble](Titanium.UI.DashboardView.wobble) property.
+When edit mode has been activated, the item icons wobble by default to act as a visual cue. This behavior may be disabled using the [wobble](Titanium.UI.DashboardView.wobble) property.
 
-If a dashboard contains more than 9 items, it will be paged into screens in a 3 x 3 formation 
-using its built-in scrollable view. A paging control is added to the bottom of the view to 
-indicate the active page.
+If a dashboard contains more than 9 items, it will be paged into screens in a 3 x 3 formation using its built-in scrollable view. A paging control is added to the bottom of the view to indicate the active page.
 
 
 *(See full overview in titanium-docs)*

package/skills/ti-api/references/api-ui-lists.md

@@ -25,9 +25,7 @@
 
 Use the <Titanium.UI.createListView> method or **`<ListView>`** Alloy element to create a `ListView`.
 
-A `ListView` object is a container for [ListSection](Titanium.UI.ListSection)
-objects that are, in turn, containers for [ListItem](Titanium.UI.ListItem) objects. This is
-easily visualized as an Alloy view:
+A `ListView` object is a container for [ListSection](Titanium.UI.ListSection) objects that are, in turn, containers for [ListItem](Titanium.UI.ListItem) objects. This is easily visualized as an Alloy view:
 
 
 ### Properties (unique: 54/122)
@@ -133,22 +131,54 @@ easily visualized as an Alloy view:
 #### AnimatedOptions
 > A JavaScript object holding an `animated` property. Used for many UI methods as a means of specifying some transition should be animated.
 
-| Property | Type | Description |
-|----------|------|-------------|
-| animated | Boolean | If `true`, animate a transition for the method/value change. Note that for most… |
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| animated | Boolean | both | If `true`, animate a transition for the method/value change. Note that for most… |
 
 #### AnimatedWithDurationOptions
 > A JavaScript object holding `animated` and `duration` properties. Used on iOS For [TableView](Titanium.UI.TableView) and [ListView](Titanium.UI.ListView) content offset transitions.
 
-| Property | Type | Description |
-|----------|------|-------------|
-| animated | Boolean | If `true`, animate a transition for the method/value change. Note that for most… |
-| duration | Number | The duration in `milliseconds` for animation |
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| animated | Boolean | both | If `true`, animate a transition for the method/value change. Note that for most… |
+| duration | Number | both | The duration in `milliseconds` for animation |
+
+#### ListItemEventType
+> The arguments for the <Titanium.UI.ListView.prefetch> and <Titanium.UI.ListView.cancelprefetch> events.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| section | Ti.UI.ListSection | ios | List section if the item is contained in a list section. |
+| sectionIndex | Number | ios | Section index. |
+| itemIndex | Number | ios | Item index. |
+| itemId | String | ios | The item ID bound to the list item that generated the event. |
+
+#### ListViewIndexEntry
+> A simple object that represents an index entry in a `ListView`.
 
-#### Dictionary
-> Plain JavaScript object.
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| title | String | ios | Title to display in the index bar. |
+| index | Number | ios | Section index associated with this title. |
 
-*Plus 6 more types: ListViewMarkerProps, Padding, Point, SelectedItem*
+#### ListViewMarkerProps
+> The parameter for [setMarker](Titanium.UI.ListView.setMarker) and [addMarker](Titanium.UI.ListView.addMarker) methods.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| sectionIndex | Number | both | The sectionIndex of the reference item. |
+| itemIndex | Number | both | The itemIndex of the reference item. |
+
+#### SelectedItem
+> The arguments for the <Titanium.UI.ListView.itemsselected> event.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| section | Ti.UI.ListSection | both | List section if the item is contained in a list section. |
+| sectionIndex | Number | both | Section index. |
+| itemIndex | Number | both | Item index. |
+
+Also referenced by this API, documented elsewhere: `Dictionary`, [HorizontalInsets](#horizontalinsets), [ListViewAnimationProperties](#listviewanimationproperties), [Padding](api-ui-windows-navigation.md#padding), [Point](api-ui-extras.md#point).
 
 ---
 
@@ -157,16 +187,11 @@ easily visualized as an Alloy view:
 > Extends Ti.Proxy
 > Platforms: both
 
-A list item is a combination of a <ListDataItem> and <ItemTemplate>.  The list data item
-represents the actual data, while the item template represents the style elements of the item.
+A list item is a combination of a <ListDataItem> and <ItemTemplate>.  The list data item represents the actual data, while the item template represents the style elements of the item.
 
-You should not create `ListItem` objects with a JavaScript factory method, as you do other Titanium proxies.
-Instead, you should pass a <ListDataItem> array to the `setItems` method of a `ListSection`. The list data items
-contain the data you want to display in the list.
+You should not create `ListItem` objects with a JavaScript factory method, as you do other Titanium proxies. Instead, you should pass a <ListDataItem> array to the `setItems` method of a `ListSection`. The list data items contain the data you want to display in the list.
 
-Alloy applications can use **`<ListItem>`** elements to create `ListItem` objects. `<ListItem>` elements
-must be nested inside a **`<ListSection>`** element, which itself is nested in a `<ListView>` element,
-as shown below:
+Alloy applications can use **`<ListItem>`** elements to create `ListItem` objects. `<ListItem>` elements must be nested inside a **`<ListSection>`** element, which itself is nested in a `<ListView>` element, as shown below:
 
 
 ### Properties (unique: 26/28)
@@ -238,8 +263,7 @@ as shown below:
 
 Use the <Titanium.UI.createListSection> method or **`<ListSection>`** Alloy element to create a `ListSection`.
 
-List sections are used to manipulate and organize list items contained within it. For examples 
-of using list sections, see the examples in <Titanium.UI.ListView> and <Titanium.UI.ListItem>.
+List sections are used to manipulate and organize list items contained within it. For examples of using list sections, see the examples in <Titanium.UI.ListView> and <Titanium.UI.ListItem>.
 
 ### Properties (unique: 7/9)
 | Property | Type | Default | Platform | Description |
@@ -308,8 +332,7 @@ of using list sections, see the examples in <Titanium.UI.ListView> and <Titanium
 | ------- | --- |
 | ![Android](./tableview_android.png) | ![iOS](./tableview_ios.png) |
 
-A `TableView` object is a container for [TableViewSection](Titanium.UI.TableViewSection)
-objects that are, in turn, containers for [TableViewRow](Titanium.UI.TableViewRow) objects.
+A `TableView` object is a container for [TableViewSection](Titanium.UI.TableViewSection) objects that are, in turn, containers for [TableViewRow](Titanium.UI.TableViewRow) objects.
 
 Use the <Titanium.UI.createTableView> method or **`<TableView>`** Alloy element to create a `TableView`.
 
@@ -431,27 +454,62 @@ There are few approaches to creating and using `TableView` object.
 #### AnimatedOptions
 > A JavaScript object holding an `animated` property. Used for many UI methods as a means of specifying some transition should be animated.
 
-| Property | Type | Description |
-|----------|------|-------------|
-| animated | Boolean | If `true`, animate a transition for the method/value change. Note that for most… |
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| animated | Boolean | both | If `true`, animate a transition for the method/value change. Note that for most… |
 
 #### AnimatedWithDurationOptions
 > A JavaScript object holding `animated` and `duration` properties. Used on iOS For [TableView](Titanium.UI.TableView) and [ListView](Titanium.UI.ListView) content offset transitions.
 
-| Property | Type | Description |
-|----------|------|-------------|
-| animated | Boolean | If `true`, animate a transition for the method/value change. Note that for most… |
-| duration | Number | The duration in `milliseconds` for animation |
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| animated | Boolean | both | If `true`, animate a transition for the method/value change. Note that for most… |
+| duration | Number | both | The duration in `milliseconds` for animation |
 
 #### HorizontalInsets
 > Dictionary object of parameters for horizontal-only insets applied to [Table](Titanium.UI.TableView) and [List](Titanium.UI.ListView) views. Only `left` and `right` properties are used (see <Padding>).
 
-| Property | Type | Description |
-|----------|------|-------------|
-| left | Number | Left padding/inset |
-| right | Number | Right padding/inset |
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| left | Number | both | Left padding/inset |
+| right | Number | both | Right padding/inset |
+
+#### SelectedRowObject
+> The arguments for the <Titanium.UI.TableView.rowsselected> event.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| index | Number | both | Row index. |
+| row | Ti.UI.TableViewRow | both | Table view row object. |
+| rowData | Dictionary<Titanium.UI.TableViewRow> | both | Properties of the row. Use this property rather than `row` to access any custom… |
+| section | Ti.UI.TableViewSection | both | Table view section object, if the clicked row is contained in a section. |
+
+#### Size
+> A simple object consisting of size measurements.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| height | Number | both | The height measurement. |
+| width | Number | both | The width measurement. |
+
+#### TableViewAnimationProperties
+> A simple object for specifying the animation properties to use when inserting or deleting rows, or scrolling the table.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| animated | Boolean | both | Whether this table change should be animated. Ignored if any `animationStyle` v… |
+| animationStyle | Number | both | Type of animation to use for row insertions and deletions. |
+| position | Number | both | Specifies what position to scroll the selected row to. |
+
+#### TableViewIndexEntry
+> A simple object that represents an index entry in a `TableView`.
+
+| Property | Type | Platform | Description |
+|----------|------|----------|-------------|
+| title | String | both | Title to display in the index bar for this item. |
+| index | Number | both | Row index associated with this item. |
 
-*Plus 5 more types: SelectedRowObject, Size, TableViewAnimationProperties*
+Also referenced by this API, documented elsewhere: `Dictionary`, [Padding](api-ui-windows-navigation.md#padding), [Point](api-ui-extras.md#point).
 
 ---
 
@@ -460,20 +518,15 @@ There are few approaches to creating and using `TableView` object.
 > Extends Ti.UI.View
 > Platforms: both
 
-Use the <Titanium.UI.createTableViewRow> method or **`<TableViewRow>`** Alloy element to create
-a table view row.
+Use the <Titanium.UI.createTableViewRow> method or **`<TableViewRow>`** Alloy element to create a table view row.
 
-These may be explicitly added to [TableViewSection](Titanium.UI.TableViewSection) objects, which are applied
-to a [TableView](Titanium.UI.TableView). If a table section is not specified, one will be
-automatically created.
+These may be explicitly added to [TableViewSection](Titanium.UI.TableViewSection) objects, which are applied to a [TableView](Titanium.UI.TableView). If a table section is not specified, one will be automatically created.
 
-A row's contents can be as simple as a single line of text, or comprised of a completely
-customized layout of child views.
+A row's contents can be as simple as a single line of text, or comprised of a completely customized layout of child views.
 
 ### Creating Table View Rows
 
-Rows may be created using the properties directly available on the `TableViewRow` object, to
-achieve the following:
+Rows may be created using the properties directly available on the `TableViewRow` object, to achieve the following:
 
 
 *(See full overview in titanium-docs)*
@@ -539,20 +592,13 @@ achieve the following:
 > Extends Ti.Proxy
 > Platforms: both
 
-Use the <Titanium.UI.createTableViewSection> method or **`<TableViewSection>`** Alloy element to 
-create a `TableViewSection`.
+Use the <Titanium.UI.createTableViewSection> method or **`<TableViewSection>`** Alloy element to create a `TableViewSection`.
 
-Before the table is rendered, the `TableViewSection` [add](Titanium.UI.TableViewSection.add) 
-method may be used to add [TableViewRow](Titanium.UI.TableViewRow) objects to a section. After 
-it is rendered, one of the `TableView` [insertRowBefore](Titanium.UI.TableView.insertRowBefore), 
-[insertRowAfter](Titanium.UI.TableView.insertRowAfter), or 
-[appendRow](Titanium.UI.TableView.appendRow) methods must be used instead. 
+Before the table is rendered, the `TableViewSection` [add](Titanium.UI.TableViewSection.add) method may be used to add [TableViewRow](Titanium.UI.TableViewRow) objects to a section. After it is rendered, one of the `TableView` [insertRowBefore](Titanium.UI.TableView.insertRowBefore), [insertRowAfter](Titanium.UI.TableView.insertRowAfter), or [appendRow](Titanium.UI.TableView.appendRow) methods must be used instead.
 
-To remove a row from a section after the table is rendered, use the `TableView` 
-[deleteRow](Titanium.UI.TableView.deleteRow) method. 
+To remove a row from a section after the table is rendered, use the `TableView` [deleteRow](Titanium.UI.TableView.deleteRow) method.
 
-In order for a section to be visible, either its `headerTitle` or `headerView` property must be 
-configured. 
+In order for a section to be visible, either its `headerTitle` or `headerView` property must be configured.
 
 
 *(See full overview in titanium-docs)*