Custom Attributes
RadPanelItem objects provide a special collection called Attributes. You can use this collection to expand the information stored with the items. The Attributes collection lets you store any number of attributes as name/value pairs. You can specify custom attributes declaratively in the RadPanelItem tag or programmatically using the Attributes collection of the RadPanelItem. You can also access custom attributes client-side, using the get_attributes collection of the RadPanelItem client-side object.
Setting Attributes Declaratively
In the ASP.NET declaration of your RadPanelBar object, you can add custom attributes to panel items by simply adding Name="value" to the RadPanelItem declaration. For example, the following RadPanelBar definition adds a "State" custom attribute to its non-root panel items:
<telerik:RadPanelBar RenderMode="Lightweight" ID="RadPanelBar1" runat="server" Skin="Office2007" Width="54px">
<Items >
<telerik:RadPanelItem Text="Format">
<Items>
<telerik:RadPanelItem State="unchecked" Text="Bold">
</telerik:RadPanelItem>
<telerik:RadPanelItem State="unchecked" Text="Italic">
</telerik:RadPanelItem>
<telerik:RadPanelItem State="unchecked" Text="Underlined">
</telerik:RadPanelItem>
</Items>
</telerik:RadPanelItem>
</Items >
</telerik:RadPanelBar>
Using Attributes in Server-Side Code
You can access custom attributes from code behind via the Attributes collection exposed by the RadPanelItem class.
Paragraph.Font.Bold = RadPanelBar1.Items[0].Items[0].Attributes["State"] == "checked";
Paragraph.Font.Italic = RadPanelBar1.Items[0].Items[1].Attributes["State"] == "checked";
Paragraph.Font.Underline = RadPanelBar1.Items[0].Items[2].Attributes["State"] == "checked";
Using Attributes in Client-Side Code
You can work with custom attributes from client-side code using the attributes collection returned by the get_attributes method of the client-side RadPanelItem object. The attributes collection has a getAttribute method that lets you get attribute values, and a setAttribute method that lets you set them:
function GetAndSetCustomAttributes() {
var panelBar = $find("<%=RadPanelBar1.ClientID %>");
var item = panelBar.findItemByText("Bold");
var state = item.get_attributes().getAttribute("State");
panelBar.trackChanges();
if (state == "unchecked") {
item.get_attributes().setAttribute("State", "checked");
}
else {
item.get_attributes().setAttribute("State", "unchecked");
}
panelBar.commitChanges();
}
Data Binding with Custom Attributes
When binding the RadPanelBar to data, custom attributes can be set in the ItemDataBound event. The following code binds the panel bar to a DataTable when the page Loads. The DataTable contains a "Roles" column which is not mapped to a property of the panel items:
protected void Page_Load(object sender, EventArgs e)
{
if (!Page.IsPostBack)
{
//dynamically crate a table to populate the panelbar
DataTable table1 = new DataTable();
table1.Columns.Add("ID");
table1.Columns.Add("ParentID");
table1.Columns.Add("Roles"); // for the custom attributes
table1.Columns.Add("Text");
table1.Rows.Add(new string[] { "1", null, "A", "Politics" });
table1.Rows.Add(new string[] { "2", null, "B", "Sports" });
table1.Rows.Add(new string[] { "3", null, "C", "Events" });
table1.Rows.Add(new string[] { "4", "1", "D", "CNN" });
table1.Rows.Add(new string[] { "5", "1", "E", "NBC" });
table1.Rows.Add(new string[] { "6", "1", "F", "ABC" });
table1.Rows.Add(new string[] { "7", "2", "G", "US Sports" });
table1.Rows.Add(new string[] { "8", "2", "B", "European Sports" });
table1.Rows.Add(new string[] { "9", "7", "D", "Baseball" });
table1.Rows.Add(new string[] { "10", "7", "C", "Football" });
table1.Rows.Add(new string[] { "11", "7", "B", "Basketball" });
table1.Rows.Add(new string[] { "12", "8", "D", "Soccer" });
table1.Rows.Add(new string[] { "14", "3", "E", "Oscar Awards" });
table1.Rows.Add(new string[] { "15", "3", "B", "MTV Movie Awards" });
RadPanelBar1.DataSource = table1;
RadPanelBar1.DataFieldID = "ID";
RadPanelBar1.DataFieldParentID = "ParentID";
RadPanelBar1.DataTextField = "Text";
RadPanelBar1.DataBind();
}
}
The "Roles" column is mapped to a custom attribute in the ItemDataBound event handler. The event handler also sets the ToolTip property of the item to the value of its custom attribute to allow for testing of the custom attribute:
protected void RadPanelBar1_ItemDataBound( object sender, Telerik.Web.UI.RadPanelBarEventArgs e)
{
DataRowView dataRow = (DataRowView)e.Item.DataItem;
e.Item.Attributes["Roles"] = dataRow["Roles"].ToString();
e.Item.ToolTip = e.Item.Attributes["Roles"];
}