RadControls for ASP.NET AJAX
The table below lists the most important methods of the client-side RadTabStrip object. Many significant methods for performing common tasks such as adding, inserting and removing tabs are actually performed using the RadTabCollection object.
Name | Parameters | Return Type | Description |
|---|
trackChanges | none | none |
Begins tracking changes to the tabs. Only changes to the tabs that occur between a call to trackChanges and commitChanges persist after a postback.
|
commitChanges | none | none |
Ends tracking changes to the tabs. Only changes to the tabs that occur between a call to trackChanges and commitChanges persist after a postback.
|
Client side changes are available on the server side after postback. You can use the ClientChanges property to access them.
CopyJavaScript
function addNewTab()
{
var tabStrip = $find("<%= RadTabStrip1.ClientID %>");
var tab = new Telerik.Web.UI.RadTab();
tab.set_text("New Tab");
tabStrip.trackChanges();
tabStrip.get_tabs().add(tab);
tabStrip.commitChanges();
}
disable/set_enabled(false) | none | none | Disables all tabs in the tab strip. Clicking on any tab has no effect, child tabs cannot be opened. |
CopyJavaScript
function disableTabStrip()
{
var tabStrip = $find( "<%= RadTabStrip1.ClientID %>");
tabStrip.disable();
}
enable/set_enabled(true) | none | none | Enables all tabs in the tab strip. |
CopyJavaScript
function enableTabStrip()
{
var tabStrip = $find( "<%= RadTabStrip1.ClientID %>");
tabsStrip.enable();
}
get_enabled | none | boolean | True if the tab strip is enabled. To enable a tab strip, use the enable() or set_enabled(true) methods. |
findTabByValue | (string value) | RadTab |
Returns the first RadTab object whose Value property is equal to the passed parameter.
|
findTabByText | (string text) | RadTab |
Returns the first RadTab object whose Text property is equal to the passed parameter.
|
findTabByUrl | (string URL) | RadTab |
Returns the first RadTab object whose NavigateUrl property is equal to the passed parameter.
|
findTabByAbsoluteUrl | (string URL) | RadTab |
Returns the first RadTab object whose NavigateUrl property is equal to the passed parameter. Note that the parameter should ends with '/' like:
var item = sender.findTabByAbsoluteUrl('http://www.test.com/'); |
findTabByAttribute | (string attributeName, string value) | RadTab |
Returns the first RadTab object with a custom attribute of the specified name that has the specified value.
|
get_tabs | none | RadTabCollection | Returns the collection of root level tabs. |
CopyJavaScript
function showRootTabs()
{
var tabStrip = $find( "<%= RadTabStrip1.ClientID %>");
var tabs = tabStrip.get_tabs();
for (var i=0; i < tabs.get_count(); i++)
{
alert(tabs.getTab(i).get_text());
}
}
get_allTabs | none | Array | Gets a linear collection of all tabs. This includes all root and child tabs in the tab strip. |
CopyJavaScript
function showAllTabs()
{
var tabStrip = $find( "<%=RadTabStrip1.ClientID %>");
for (var i=0; i< tabStrip.get_allTabs().length; i++)
{
alert(tabStrip.get_allTabs()[i].get_text());
}
}
get_selectedTab | none | RadTab | Returns the root level selected tab. Null if no root tab has been selected. |
get_multiPageID | none | String |
Returns the value of MultiPageID property, if any.
|
set_multiPageID | String | none |
Returns true if the tab is visible or false otherwise.
|
get_attributes | none | Collection | Returns the collection of custom attributes for the tab strip. |
get_element | none | HTML Element | Gets the DOM element for the tab strip. |
CopyJavaScript
function hideTabStrip()
{
var tabStrip = $find( "<%= RadTabStrip1.ClientID %>");
tabStrip.get_element().style.display = "none" ;
}
function showTabStrip()
{
var tabStrip = $find("<%= RadTabStrip1.ClientID %>");
tabStrip.get_element().style.display = "" ;
}
get_childListElement | none | HTML Element | Gets the DOM element for the list of tabs in the tab strip. |
get_validationGroup | none | String | Gets the name of the validation group to be used for the integrated validation controls. |
set_validationGroup | String | none | Sets the name of the validation group to be used for the integrated validation controls. |
enableEvents | none | none | Enables the control client-side event emitting. Events are enabled by default. |
disableEvents | none | none | Disables the control client-side event emitting. |
add_<EventName> | (mixed eventHandler) | none |
Attaches an eventHandler to the event with the name <EventName>. Note that client-side event names differ from their server-side counterparts. For more information, see Client-Side Events.
|
CopyJavaScript
function OnClientTabSelectingHandler(sender, args)
{
alert(args.get_tab().get_text() );
}
function AttachHandler()
{
var tabStrip = $find( "<%=RadTabStrip1.ClientID %>");
tabStrip.add_tabSelecting( OnClientTabSelectingHandler);
}
remove_<EventName> | (mixed eventHandler) | Boolean |
Detaches an eventHandler from the event with the name <EventName>.Returns "True" if the eventHandler is found and detached, false otherwise.Note that client-side event names differ from their server-side counterparts. For more information, see Client-Side Events.
|
CopyJavaScript
function OnClientTabSelectingHandler(sender, args)
{
alert(args.get_tab().get_text() );
}
function DetachHandler()
{
var tabStrip = $find("<%=RadTabStrip1.ClientID %>");
tabStrip.remove_tabSelecting(OnClientTabSelectingHandler);
}
See Also