Zimlet Developers Guide:Zimlet Tab
|Introduction||Getting Started||Dev Environment Setup||Developing Zimlets||
|API Specifications||Example Zimlets|
|This article applies to the following ZCS versions.|
You can create zimlets as tab applications. After creating your application (using
ZmZimletBase.createApp()), your Zimlet Handler Object will receive application events such as
ZmZimletBase.appLaunch(). Additionally, you can create and manage the content on the tab application page.
Creating Tab Application
A tab application is created by using the
ZmZimletBase.createApp() method. This method can be called when your zimlet is initialized. The method returns the newly created tab application name. You will likely use this name often so a good practice is to save the name to a zimlet property that can be accessed in the future (shown here as
// create the tab application this._tabAppName = this.createApp("Tab Label", "zimbraIcon", "Tab Tool Tip");
A zimlet that is running as a tab application will receive application life cycle events. The following illustrates the tab application events. A tab is "launched" the first-time a user clicks on the tab. When a tab is made "active", a user clicks on the tab and the tab content is displayed. When a tab is made "inactive", the user has switched to a different tab.
A tab application has three primary content areas on the page:
- Main Content Area
- Toolbar Area
- Overview Area
How to retrieve the area objects and set the content (i.e. the HTML) for the areas is shown in the Tab Overview example.