is wrapped around all the steps to isolate them from the rest of the widget.
* @return void
*/
_buildSteps: function() {
var $steps = this.element.children("div, fieldset");
this._stepCount = $steps.length;
$steps.addClass("jw-step").each(function(x) {
var $step = $(this);
if (this.tagName.toLowerCase() === "fieldset") {
$step.attr("title", $step.find("legend").text());
}
});
if (this.options.validate) {
$steps.bind("deactivate", function(event) {
var $inputs = $(this).find(":input");
if ($inputs.length > 0) {
return Boolean($inputs.valid());
}
return true;
});
}
$steps.hide().wrapAll('
');
},
/**
* @private
* @description Destroys the step wrappers and restores the steps to their original state (used in `destroy()`)
* @return void
*/
_destroySteps: function() {
$(".jw-step").show().unwrap().unwrap(); // Unwrap 2x: .jw-steps-wrap + .jw-content
$(".jw-step").unbind("activate").unbind("deactivate").removeClass("jw-step");
},
/**
* @private
* @description Changes the "active" step.
* @param number|jQuery nextStep Either an index or a jQuery object/element
* @param bool isInit Behavior needs to change if this is called during _init (as opposed to manually through the global setter)
* @return void
*/
_changeStep: function(nextStep, bIsFirstStep) {
var $steps = this.element.find(".jw-step"),
$currentStep = $steps.filter(":visible");
bIsFirstStep = bIsFirstStep || false;
if (typeof $currentStep !== "undefined" && $currentStep.triggerHandler("deactivate") === false) {
return false;
}
if (typeof nextStep === "number") {
if (nextStep < 0 || nextStep > ($steps.length - 1)) {
alert("Index " + nextStep + " Out of Range");
return false;
}
this._stepIndex = nextStep;
nextStep = $steps.eq(nextStep);
} else if (typeof nextStep === "object") {
if ( !nextStep.is($steps.selector) ) {
alert("Supplied Element is NOT one of the Wizard Steps");
return false;
}
this._stepIndex = $steps.index(nextStep);
}
$currentStep = nextStep;
if (typeof $currentStep !== "undefined") {
this.options.effects.step.hide.callback = $.proxy(function() {
nextStep.trigger("activate");
this._effect(nextStep, "step", "show", "show");
}, this);
this.element.find(".jw-step").hide();
this._effect($currentStep, "step", "hide", "hide");
} else {
nextStep.trigger("activate");
this._effect(nextStep, "step", "show", "show");
}
this._updateButtons();
this._updateTitle(bIsFirstStep);
if (this.options.menuEnable) {
this._updateMenu();
}
if (this.options.counter.enable) {
this._updateCounter();
}
},
/**
* @private
* @description Initializes the menu
* Builds the menu based on the collection of steps
* Assigns a class to the main
to indicate to CSS that there is a menu
* Binds a click event to each of the
that will change the step accordingly when clicked
* @return void
*/
_buildMenu: function() {
var tmpHtml = ['");
this.element.find(".jw-content").prepend($menu = $(tmpHtml.join("")));
$menu.find("a").click($.proxy(function(event) {
var $target = $(event.target),
iNextStep = parseInt($target.attr("step"), 10);
if ($target.parent().hasClass("jw-active")) {
this._changeStep(iNextStep, iNextStep <= this._stepIndex);
}
}, this));
},
/**
* @private
* @description Removes the 'jw-hasmenu' class and pulls the menu out of the DOM entirely
* @return void
*/
_destroyMenu: function() {
this.element.removeClass("jw-hasmenu").find(".jw-menu-wrap").remove();
},
/**
* @private
* @description Updates the menu at the end of each call to _changeStep()
* Each is looped over, along with the parent
* Status (jw-current, jw-active, jw-inactive) set depending on progress through wizard
* @see this._changeStep()
* @return void
*/
_updateMenu: function() {
var iCurrentStepIndex = this._stepIndex,
$menu = this.element.find(".jw-menu");
this._effect($menu.find("li:eq(" + iCurrentStepIndex + ")"), "menu", "change");
$menu.find("a").each(function(x) {
var $li = $(this).parent(),
$a = $(this),
iStep = parseInt($a.attr("step"), 10),
sClass = "";
if ( iStep < iCurrentStepIndex ) {
sClass += "jw-active ui-state-default ui-corner-all";
} else if ( iStep === iCurrentStepIndex ) {
sClass += "jw-current ui-state-highlight ui-corner-all";
} else if ( iStep > iCurrentStepIndex ) {
sClass += "jw-inactive ui-state-disabled ui-corner-all";
$a.removeAttr("href");
}
$li.removeClass().addClass(sClass);
});
},
/**
* @private
* @description Initializes the step counter.
* A new is created and used as the main element
* @return void
*/
_buildCounter: function() {
var $counter = $('');
this.element.find(".jw-footer").prepend($counter);
if (!this.options.counter.startCount) {
this._stepCount--;
}
if (!this.options.counter.finishCount) {
this._stepCount--;
}
if (this.options.counter.progressbar) {
$counter.append('').append('').find(".jw-counter-progressbar").progressbar();
}
},
/**
* @private
* @description This is run at the end of every call to this._changeStep()
* @return void
* @see this._changeStep()
*/
_updateCounter: function() {
var $counter = this.element.find(".jw-counter"),
counterOptions = this.options.counter,
counterText = "",
actualIndex = this._stepIndex,
actualCount = this._stepCount,
percentage = 0;
if (!counterOptions.startCount) {
actualIndex--;
actualCount--;
}
this._effect($counter, "counter", "change");
percentage = Math.round((actualIndex / actualCount) * 100);
if (counterOptions.type === "percentage") {
counterText = ((percentage <= 100) ? percentage : 100) + "%";
} else if (counterOptions.type === "count") {
if (actualIndex < 0) {
counterText = 0;
} else if (actualIndex > actualCount) {
counterText = actualCount;
} else {
counterText = actualIndex;
}
counterText += " of " + actualCount;
} else {
counterText = "N/A";
}
if (counterOptions.appendText) {
counterText += " " + counterOptions.appendText;
}
if (counterOptions.progressbar) {
this.element.find(".jw-counter-progressbar").progressbar("option", "value", percentage);
this.element.find(".jw-counter-text").text(counterText);
} else {
$counter.text(counterText);
}
if ( (counterOptions.startHide && this._stepIndex === 0) || (counterOptions.finishHide && this._stepIndex === (this._actualCount - 1)) ) {
$counter.hide();
} else {
$counter.show();
}
},
/**
* @private
* @description Removes the counter DOM elements, resets _stepCount
* @return void
*/
_destroyCounter: function() {
this.element.find(".jw-counter").remove();
},
/**
* @private
* @description This generates the