Each Tealeaf client framework tracks user interface events, some of which are specific to the type of client application. Through the tlEvent property on the object controls, you can create one event to track all corresponding user interface events across all of the frameworks. In the table below, for each listed tlType, you can review the tlEvent reference, if applicable, and the corresponding object information for each supported client framework.
Event behavior
This table provides descriptions of the behaviors of each monitored tlEvent. These behaviors apply to all client frameworks.
| tlType | tlEvent only on these Control objects | tl JSON Object type | Event Behavior |
|---|---|---|---|
| actionSheet | buttonIndex | Control | Button selected from action sheet |
| showInView | When action sheet is shown in the view | ||
| showFromTabBar | When action sheet is shown from tab bar | ||
| showFromToolbar | When action sheet is shown from toolbar | ||
| alertView | alertShown | Control | When alert is shown |
| buttonIndex | Button selected from alert | ||
| button | click | Control | When user clicks button |
| calendar | dateChange | Control | When user changes date on calendar |
| canvas | N/A | Control | Base class where you design the control. Use the class that extends this class. |
| checkBox | click | Control | When check box is clicked |
| datePicker | dateChange | Control | When date is changed on datePicker |
| gallery | click | Control | When item is clicks gallery |
| imagePicker | Not implemented | Control | N/A |
| gesture | Not implemented | Control | N/A |
| gesture | on any frameworks | ||
| gesture | |||
| gesture | |||
| gesture | |||
| gesture | |||
| gesture | |||
| link | click | Control | When user clicks link |
| menu | Not implemented | Control | N/A |
| numberPicker | valueChange | Control | When user picks a number |
| page | ScreenView | ScreenView created | |
| Called before page appears to user | |||
| LOAD | Page model that user views on screen, which ScreenView object notifies when page goes to foreground | ||
| Called after page is loaded into memory | |||
| Called before page goes to background | |||
| UNLOAD | Page model that user views on screen, which ScreenView object notifies when page goes to background | ||
| When page gets garbage that is collected | |||
| pageControl | Not implemented | Control | N/A |
| radioButton | click | Control | When user clicks a radio button |
| radioButton | |||
| scroll | scrollChange | Control | When user scrolls page |
| scroll | |||
| searchBox | valueChange | Control | When user clicks search button |
| selectList | valueChange | Control | When user selects an item from the list |
| selectList | |||
| slider | valueChange | Control | When user stops sliding the control |
| slider | |||
| slider | |||
| stepper | Not implemented | N/A | |
| tabContainer | tabChange | Control | When user selects a tab |
| textBox | textChange | Control | When user does a focus out of a text box |
| textBox | |||
| textBox | |||
| textBox | |||
| textBox | |||
| textBox | |||
| timePicker | timeChange | Control | When user changes time |
| toggleButton | click | Control | When user clicks a toggle button |
| toggleButton |
UI Capture
This table lists the events for UI Capture:
| tlType | tlEvent only on these Control objects | tl JSON Object type | UIC | UIC Event - See Below at TL table for HTML |
|---|---|---|---|---|
| button | click | Control | <button> | click, blur |
| button | click | Control | <input> | click, blur |
| checkBox | change | Control | <input> | change, blur |
| link | click | Control | <a> | click |
| page | ScreenView | Page | ||
| LOAD | load | |||
| UNLOAD | unload | |||
| radio Button | change | Control | <input> | change, blur |
| scroll | scrollChange | Control | <div> | |
| selectList | valueChange | Control | <select> | change, blur |
| textBox | textChange | Control | <input> | change, blur |
| textBox | textChange | Control | <textarea> | change, blur |
Android
This table lists the events that are unique to the Android framework:
| tlType | tlEvent only on these Control objects | tl JSON Object type | Android | Android Listener | Android Event |
|---|---|---|---|---|---|
| actionSheet | buttonIndex | Control | N/A | N/A | N/A |
| showInView | |||||
| showFrom TabBar | |||||
| showFrom Toolbar | |||||
| alertView | alertShown | Control | N/A | N/A | N/A |
| buttonIndex | |||||
| button | click | Control | Button | View.On ClickListener | onClick |
| button | Compound Button | ||||
| button | ImageButton | ||||
| calendar | dateChange | Control | CalendarView | CalendarView. OnDate Change Listener | onSelected DayChange |
| canvas | N/A | Control | view | On the class it self | onFinish Inflate |
| onFocus Changed | |||||
| onLayout | |||||
| onMeasure | |||||
| onOver Scrolled | |||||
| onRestore InstanceState | |||||
| onScroll Changed | |||||
| onSetAlpha | |||||
| onSize Changed | |||||
| onVisibility Changed | |||||
| onWindow Visibility Changed | |||||
| checkBox | click | Control | CheckBox | View.On ClickListener | onClick |
| datePicker | dateChange | Control | DatePicker | DatePicker. OnDate Changed Listener | onDate Changed |
| gallery | click | Control | Gallery | AdapterView. OnItem ClickListener | onItemClick |
| image Picker | Not implemented | Control | N/A | ||
| gesture | Not implemented | Control | android. gesture | Gesture Detector. OnGesture Listener | onDown |
| gesture | on any frameworks | android. gesture | onFling | ||
| gesture | android. gesture | onLongPress | |||
| gesture | android. gesture | onScroll | |||
| gesture | android. gesture | onShowPress | |||
| gesture | android. gesture | onSingle TapUp | |||
| gesture | android. gesture | ||||
| link | click | Control | N/A | ||
| menu | Not implemented | Control | N/A | ||
| number Picker | valueChange | Control | NumberPicker | Number Picker.On ValueChange Listener | onValue Change |
| page | ScreenView | Activity | On the class it self | onCreate | |
| LOAD | onResume | ||||
| UNLOAD | onPause | ||||
| onDestroy | |||||
| page Control | Not implemented | Control | N/A | ||
| radio Button | click | Control | RadioButton | View.On ClickListener | onClick |
| radio Button | RadioGroup | RadioGroup. OnChecked Change Listener | onChecked Changed | ||
| scroll | scrollChange | Control | Horizontal ScrollView | You have to extend Horizontal ScrollView | onScroll Changed |
| scroll | ScrollView | You have to extend ScrollView | onScroll Changed | ||
| searchBox | valueChange | Control | SearchView | SearchView Compat.On QueryText Listener Compat | onQuery TextSubmit |
| selectList | valueChange | Control | AbsSpinner | AdapterView. OnItem Selected Listener | onItem Selected |
| selectList | Spinner | ||||
| slider | valueChange | Control | AbsSeekBar | SeekBar. OnSeekBar Change Listener | onStop TrackingTouch |
| slider | SeekBar | ||||
| slider | RatingBar | RatingBar. OnRatingBar Change Listener | onRating Changed | ||
| stepper | Not implemented | N/A | |||
| tab Container | tabChange | Control | TabHost | TabHost. OnTab Change Listener | onTab Changed |
| textBox | textChange | Control | AutoComplete TextView | View.OnFocus Change Listener | onFocus Change |
| textBox | Checked TextView | ||||
| textBox | EditText | ||||
| textBox | MultiAuto Complete TextView | ||||
| textBox | TextView | ||||
| textBox | EditText | ||||
| timePicker | timeChange | Control | TimePicker | TimePicker. OnTime Changed Listener | onTime Changed |
| toggle Button | click | Control | Switch | View. OnClick Listener | onClick |
| toggle Button | ToggleButton |
iOS
This table lists the events that are unique to the iOS framework:
| tlType | tlEvent only on these Control objects | tl JSON Object type | iOS | iOS Event | iOS TL Short Name |
|---|---|---|---|---|---|
| action Sheet | buttonIndex | Control | UIActionSheet | clickedButton AtIndex | |
| showInView | Not implemented | actionSheet ShowInView | |||
| showFrom TabBar | Not implemented | actionSheet ShowFrom TabBar | |||
| showFrom Toolbar | Not implemented | actionSheet ShowFrom Toolbar | |||
| alertView | alertShown | Control | UIAlertView | Not implemented | alertView Shown |
| buttonIndex | clickedButton AtIndex | ||||
| button | click | Control | UIButton | ButtonTouch UpInside | |
| button | N/A | ||||
| button | UIButton | ||||
| calendar | dateChange | Control | N/A | N/A | N/A |
| canvas | N/A | Control | UIView | ||
| checkBox | click | Control | N/A | N/A | N/A |
| datePicker | dateChange | Control | UIDatePicker | Not implemented | Not implemented |
| gallery | click | Control | N/A | N/A | N/A |
| image Picker | Not implemented | Control | UIImage Picker Controller | Not implemented | Not implemented |
| gesture | Not implemented | Control | UIGesture Recognizer | ||
| gesture | on any frameworks | UILongPress Gesture Recognizer | |||
| gesture | UIPan Gesture Recognizer | ||||
| gesture | UIPinch Gesture Recognizer | ||||
| gesture | UIRotation Gesture Recognizer | ||||
| gesture | UISwipe Gesture Recognizer | ||||
| gesture | UITap Gesture Recognizer | ||||
| link | click | Control | N/A | N/A | N/A |
| menu | Not implemented | Control | UIMenu Controller | Not implemented | Not implemented |
| number Picker | valueChange | Control | N/A | N/A | N/A |
| page | ScreenView | UIView Controller | View Controller InitWith NibNamed | ||
| View Controller InitWith Coder | |||||
| View Controller ViewWill Appear | |||||
| LOAD | View Controller ViewDid Appear | ||||
| View Controller ViewDid Load | |||||
| View Controller ViewWill Disappear | |||||
| UNLOAD | View Controller ViewDid Disappear | ||||
| page Control | Not implemented | Control | UIPageControl | N/A | N/A |
| radio Button | click | Control | N/A | N/A | N/A |
| radio Button | N/A | ||||
| scroll | scrollChange | Control | UIScrollView | Not implemented | Not implemented |
| scroll | UIScrollView | ||||
| searchBox | valueChange | Control | UISearchBar | Not implemented | Not implemented |
| selectList | valueChange | Control | UIPickerView | Not implemented | Not implemented |
| selectList | UIPickerView | ||||
| slider | valueChange | Control | UISlider | No event name but we are handling clicks | No event name but we are handling clicks |
| slider | UISlider | ||||
| slider | UISlider | ||||
| stepper | Not implemented | UIStepper | |||
| tab Container | tabChange | Control | UITabBar Controller | Not implemented | Not implemented |
| textBox | textChange | Control | N/A | TextField DidBegin Editing | |
| textBox | N/A | TextField DidEnd Editing | |||
| textBox | UITextField | SecureText FieldDid Begin Editing | |||
| textBox | N/A | SecureText FieldDid EndEditing | |||
| textBox | UITextField | ||||
| textBox | UITextView | TextView DidBegin Editing | |||
| TextView DidEnd Editing | |||||
| SecureText ViewDid BeginEditing | |||||
| SecureText ViewDid EndEditing | |||||
| timePicker | timeChange | Control | N/A | N/A | N/A |
| toggle Button | click | Control | UISwitch | No event name, but Tealeaf handles the clicks | No event name, but Tealeaf handles the clicks |
| toggle Button | UISwitch |