The MVCContrib Grid allows for the easy construction of HTML tables for displaying data from a collection of Model objects. I add this component to all of my ASP.NET MVC projects. If you aren’t familiar with what the grid has to offer, it’s worth the looking into.
What you may notice in the busy example below
is the fact that I render my column headers independent of the grid contents. This allows me to keep my headers fixed while the user searches through the table content which
is displayed in a scrollable div*. Thus, I needed a way to render my grid without headers. That’s where Grid Renderers come into play.
<table border="0" cellspacing="0" cellpadding="0" class="projectHeaderTable">
<tr>
<td class="memberTableMemberHeader">
<%= Html.GridColumnHeader("Member", "Index", "MemberFullName")%>
</td>
<td class="memberTableRoleHeader">
<%= Html.GridColumnHeader("Role", "Index", "ProjectRoleTypeName")%>
</td>
<td class="memberTableActionHeader">
Action
</td>
</tr>
</table>
<div class="scrollContentWrapper">
<% Html.Grid(Model)
.Columns(column =>
{
column.For(c => c.MemberFullName).Attributes(@class => "memberTableMemberCol");
column.For(c => c.ProjectRoleTypeName).Attributes(@class => "memberTableRoleCol");
column.For(x => Html.ActionLink("View", "Details", new { Id = x.ProjectMemberId }) + " | " +
Html.ActionLink("Edit", "Edit", new { Id = x.ProjectMemberId }) + " | " +
Html.ActionLink("Remove", "Delete", new { Id = x.ProjectMemberId }))
.Attributes(@class => "memberTableActionCol").DoNotEncode();
})
.Empty("There are no members associated with this project.")
.Attributes(@class => "lbContent")
.RenderUsing(new GridNoHeaderRenderer<ProjectMemberDetailsViewModel>())
.Render();
%>
</div>
<div class="scrollContentBottom">
<!– –>
</div>
<%=Html.Pager(Model) %>
Maybe you noticed the reference to the GridNoHeaderRenderer class above? Yep, rendering the grid with no header
is straightforward.
public class GridNoHeaderRenderer<T> :
HtmlTableGridRenderer<T> where T: class
{
protected override bool RenderHeader()
{
// Explicitly returning true would suppress the header
// just
fine, however, Render() will always assume that
// items exist in collection and RenderEmpty() will
// never be called.
// In other words, return ShouldRenderHeader() if you
// want to maintain the Empty text when no items exist.
return ShouldRenderHeader();
}
}
Well, if you read through the comments, there
is one catch. You might be tempted to have the RenderHeader method always return true. This would work just
fine but you should return the result of ShouldRenderHeader() instead so the Empty text will continue to display if there are no items in the collection.
The GridRenderer feature found in the MVCContrib Grid
is so well put together, I just had to share.
* Though you can find countless alternatives to the fixed headers problem online, this
is the only solution that I’ve ever found to reliably work across browsers. If you know something I don’t, please share.
