AdvancedExpander
An AdvancedExpander control is a container that has two parts: a header and a body.
The AdvancedExpander control always displays the header part. The corresponding placeholder is the ActionBar placeholder. You can add buttons, for example, to this part. The control displays the open/close button here when you set the IsCollapsible property to True. You cannot change the style of the open/close button. You can create a heading (or a title) with the Header property.
The body part has two states: open and closed. Users can toggle between the open and the closed state by clicking the open/close button in the header when you specify the IsCollapsible property as True. You can also open and close the control using code.
If you only need the open/close feature, and not the ActionBar placeholder, you should use an Expander control instead.
When an AdvancedExpander control is collapsed, it only displays the controls in the ActionBar placeholder when the user hovers the mouse cursor over the ActionBar.
The AdvancedExpander control provides a placeholder called PromotedFields and always displays the controls that you add to this placeholder, even if the AdvancedExpander control is collapsed.
The AdvancedExpander control supports progressive disclosure. You use the EnableAdditonal and ShowAdditonal properties to add More/Less links inside the body. Users can click these links to show or hide additional controls.
Properties
|
Name |
Description |
Default |
|---|---|---|
|
Appearance | ||
|
ContentHeight |
Specify the height of the control. You can enter an absolute height, or a percentage. |
100% |
|
EnableAdditional |
If true, the control shows More/Less links. |
False |
|
Header |
Specify a text that the control shows in the ActionBar. | |
|
ImageUrl |
Set the Sitecore path of an icon that the AdvancedExpander control shows to the left of the header. | |
|
IsCollapsible |
If true, the control displays the open/close button. |
True |
|
IsOpen |
If true, the control and the controls it contains are open. |
True |
|
ShowAdditional |
This property is True when EnableAdditional is True and the user has clicked “More”, and it is False when the user has clicked “Less”. ShowAdditional is always False when EnableAdditional is False or undefined. You bind to the ShowAdditional property from the IsVisible property of other controls in the AdvancedExpander. These controls toggle between being visible and invisible when the user clicks the “More” and “Less” links provided by the EnableAddtional property. |
False |
|
State | ||
|
IsStateDiscarded |
If true, the open/closed state of the control is reset when the page loads to what it was at the time of design. |
False |
Configuration
You can create a configuration item for an AdvancedExpander control by creating an item based on the AdvancedExpander Parameters template.
The configuration item has these specific fields:
-
Header
-
IsOpen
-
EnableAdditional
-
ShowAdditional
-
ContentHeight
-
ImageUrl
-
IsCollapsible
It inherits these fields:
-
IsVisible
-
AccessKey
-
Tooltip
-
Behaviors
-
Id