Skip to content
jquery.gracket.js - A jQuery and canvas approach to creating single elimination tournament brackets.
Branch: master
Clone or download
Latest commit 469efef Aug 5, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
tests Added Score to Bracket Entry #6 Dec 27, 2012 Update Aug 5, 2018
jquery.gracket.min.js allow for jquery automatically converting data to JSON Oct 10, 2014


A single elimation bracket built using canvas and jquery. Live demo:



<div data-gracket="[{},{},{}]">




.g_gracket { width: 9999px; background-color: #fff; padding: 55px 15px 5px; line-height: 100%; position: relative; overflow: hidden;}
.g_round { float: left; margin-right: 70px; }
.g_game { position: relative; margin-bottom: 15px; }
.g_gracket h3 { margin: 0; padding: 10px 8px 8px; font-size: 18px; font-weight: normal; color: #fff}
.g_team { background: #3597AE; }
.g_team:last-child {  background: #FCB821; }
.g_round:last-child { margin-right: 20px; }
.g_winner { background: #444; }
.g_winner .g_team { background: none; }
.g_current { cursor: pointer; background: #A0B43C!important; }
.g_round_label { top: -5px; font-weight: normal; color: #CCC; text-align: center; font-size: 18px; }

API Usage

* Basic usage
* @note: Assumes your data comes 
*        from the element in the 
*        form of JSON 

* Custom source usage
* @note: Telling gracket to look 
*        at a local variable
*        for the JSON object 

	src : refToMyData
* Alter canvas usage
* @note: Tell grackets canvas to 
*        look a little different

	canvasLineWidth : 1,      // adjusts the thickness of a line
	canvasLineGap : 2,        // adjusts the gap between element and line
	cornerRadius : 3,         // adjusts edges of line
	canvasLineCap : "round",  // or "square"
	canvasLineColor : "white" // or #HEX
* Change class names and id structure
* @note: create gracket with custom  
*        classes to cater to 
*        any convention nessesary

	gracketClass : "g_gracket",
	gameClass : "g_game",
	roundClass : "g_round",
	teamClass : "g_team",
	winnerClass : "g_winner",
	spacerClass : "g_spacer",
	currentClass : "g_current",
	canvasId : "g_canvas",
	canvasClass : "g_canvas"
* Create show custom labels, or hide them
* @note: create gracket with custom  
*        labels to add more instruction
*        to your bracket. 

	roundLabels : ["1st Round", "2nd Round", "..."]

* @note: leaving this field 
*				 empty shows the default values.
*				 In order to hide labels, enter 
*				 one empty value.

	roundLabels : [""]

What's Next?

  • Ajax : to load data from a given source and then init the bracket.
  • Tooltips : to hover and expose an element with more info from each team & round.
  • Refactor $ Usage : reduce jQuery methods in the area of "creating elements", "elements lookups", and "element inline styles".
  • Data Dive : A more in depth view at how to structure data to adequatly use gracket.


I could not make this plugin without the advice of the following people,

  1. Andrew Miller
  2. James Coutry
  3. Voung Trinh


jquery.gracket.js loves all browsers

This plugin has been looked at and tested on the following browsers...

Gracket is supported in all browsers

  • IE6/5 not tested
  • IE has minor issues with hover states.


This code is provided with no warranty. While I strive to maintain backwards compatibility, the code is still under active development. As this is the case, some revisions may break break compatibility with earlier versions of the library. Please keep this in mind when using jquery.gracket.js.

Copyright and Licensing

Copyright (c) 2012 Erik Zettersten, released under the MIT license.

You can’t perform that action at this time.