Quick Tip – jQuery Collapsable WebParts for SharePoint 2010


Following on from the previous Quick Tip I have another cool little snippet of jQuery code to enable collapsable WebParts on SharePoint Pages.  Again like before the following code uses the OOTB v4.master so may not work if you have customised your design or used custom WebPart Control Adapters to change the formatting of WebParts.

So lets get started.  Below is the standard HTML format of how SharePoint renders a WebPart.  I have cut out unnecessary js that was in the actual source to make things cleaner.

As you can see there are alot of tables which are nested.  The table that we are interested in is this one:

This table has two rows.  The First row contains the header of the webpart which is where we are going to put our minimise handler, and the second row is the section we are going to “hide” in Javascript.  So firstly we need to inject our minimise handler into the WebPart titles <h3> tag.  To do this we need a single line of jQuery.

What this line does is firstly gets all the .s4-wpTopTable instances and within that element gets the h3 tag from within the first TR.  It then appends a custom div with some inline style to float it right with a class of “min”.  We have also used some of SharePoints built in images to reduce the number of assets required.

The next step is to now hook into the new handler that we have created above. I will create a couple of new variables to store the images that we are going to use for the collapse and expand buttons.

As you can see above i have hooked into our dynamically created handler with the class “.handler”.  When i click the item it will trigger the function and perform the following “if ” statement which i have compressed to a single line.  First i find the closest .s4-wpTopTable element which will always be the parent of the handler.  Then i want to get the first TR for that table and then go to the next row and toggle the state to be visible / hidden.  I then check the status and if it is visible then show the collapse image otherwise show the expand one.  Simple as that.

Here is the full script:

Hope this helps people to extend their SharePoint environments.  When i have written the next stage of the drag and drop piece which covers saving the WebPart states then I will update this post to include that functionality.


I am the SharePoint Development Lead at ICS Solutions Ltd. As well as broad knowledge in SharePoint 2007, 2010 & 2013 my specialities lie with SharePoint Branding, WebPart Development and JQuery integration.

5 Comments on "Quick Tip – jQuery Collapsable WebParts for SharePoint 2010"

  1. Uday Kumar Reddy says:

    Hi chris, this post is so nice and superb.

    its worked for me. But, after collapse all webparts and refresh the page it is again expanding all webparts. Is there any chance to maintain state?

  2. Dan says:

    Thank you – it works! Could there be a simply addition that would make the transition smooth (ie. animate) I wonder? Now that would be sweet…..

  3. Albarhami says:

    I have an issue<< Help please (my email is saeedalbarhami@yahoo.com or post solution here thanks):
    i am validationg webparts and application pages for sharepoint using jquery validate()

    the jquery validation works fine and checks all the rules and displaying messages as well,but the issue is that:

    if the rules are fine the submit button works and submits data as many times as the validation never fails but once the validation fails for any reason such required field, the user corrects the error and try to submit the data again but the button no more is submitting even if the validation is corrected

    Collapse | Copy Code

    rules: { :{ required: true }, : { required: true} },
    messages: {
    : { required: “* Required Field *” },

    : { required: “* Required Field *” }
    errorLabelContainer: “#errorcontainer”,
    wrapper: ‘li’

    Note: The exact same code is working fine in asp.net normal and master pages .

  4. Albarhami says:

    Ofcourse do not notice the $(“#form1″) i have changed it with aspnetForm

  5. Tony Sin says:

    Thanks alot. It is really helpful resource and what I was looking for.
    I modified code so that plus and minus icon is appended according to Chrome state of web part.
    It works very well but still need to be improved. ^^/

    //variables of link to plus and minus icon
    var Collapse = “/_layouts/images/collapse.gif”;
    var Expand = “/_layouts/images/expand.gif”;

    if($(this).find(‘tr:first’).siblings(‘tr:first’).children(‘td:first’).children(‘div:first’).css(“DISPLAY”) == ‘none’ ){
    $(this).find(‘tr:first h3′).append(‘‘);
    } else{
    $(this).find(‘tr:first h3′).append(‘‘);

    //display the hand cursor over the title table rows for each webpart and hook to the “onclick” event
    $(“tr.ms-WPHeader”).css(“cursor”, “pointer”).css(“cursor”, “hand”).bind(“click”, function ()
    //get the div element nesting the webpart contents: the navigation is based on standard webpart rendering behaviour
    var Visibility=$(this).parents(‘tr:first’).siblings(‘tr:first’).children(‘td:first’).children(‘div:first’).toggle().is(“:visible”);
    //if webpart is visible, show minus icon, if not plus icon

Got something to say? Go for it!