upgrade bootstrap-tour to use html

This commit is contained in:
Tyler Renelle 2012-12-12 20:29:28 -07:00
parent 4483d004d4
commit b41b5d3603
2 changed files with 245 additions and 207 deletions

View file

@ -1,234 +1,271 @@
// Generated by CoffeeScript 1.3.3
/* ============================================================
# bootstrap-tour.js v0.1
# http://pushly.github.com/bootstrap-tour/
# ==============================================================
# Copyright 2012 Push.ly
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
*/
# bootstrap-tour.js v0.1
# http://pushly.github.com/bootstrap-tour/
# ==============================================================
# Copyright 2012 Push.ly
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
# http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
*/
(function() {
(function($, window) {
var Tour, document;
document = window.document;
Tour = (function() {
(function($, window) {
var Tour, document;
document = window.document;
Tour = (function() {
function Tour(options) {
var _this = this;
this._options = $.extend({
name: 'tour',
afterSetState: function(key, value) {},
afterGetState: function(key, value) {},
onShow: function(tour) {},
onHide: function(tour) {}
}, options);
this._steps = [];
this.setCurrentStep();
$(document).on("click", ".popover .next", function(e) {
e.preventDefault();
return _this.next();
});
$(document).on("click", ".popover .prev", function(e) {
e.preventDefault();
return _this.prev();
});
$(document).on("click", ".popover .end", function(e) {
e.preventDefault();
return _this.end();
});
}
function Tour(options) {
var _this = this;
this._options = $.extend({
name: 'tour',
labels: {
end: 'End tour',
next: 'Next »',
prev: '« Prev'
},
keyboard: true,
afterSetState: function(key, value) {},
afterGetState: function(key, value) {},
onShow: function(tour) {},
onHide: function(tour) {},
onShown: function(tour) {}
}, options);
this._steps = [];
this.setCurrentStep();
this._onresize(function() {
if (!_this.ended) return _this.showStep(_this._current);
});
}
Tour.prototype.setState = function(key, value) {
$.cookie("" + this._options.name + "_" + key, value, {
expires: 36500,
path: '/'
});
return this._options.afterSetState(key, value);
};
Tour.prototype.setState = function(key, value) {
$.cookie("" + this._options.name + "_" + key, value, {
expires: 36500,
path: '/'
});
return this._options.afterSetState(key, value);
};
Tour.prototype.getState = function(key) {
var value;
value = $.cookie("" + this._options.name + "_" + key);
this._options.afterGetState(key, value);
return value;
};
Tour.prototype.getState = function(key) {
var value;
value = $.cookie("" + this._options.name + "_" + key);
this._options.afterGetState(key, value);
return value;
};
Tour.prototype.addStep = function(step) {
return this._steps.push(step);
};
Tour.prototype.addStep = function(step) {
return this._steps.push(step);
};
Tour.prototype.getStep = function(i) {
return $.extend({
path: "",
placement: "right",
title: "",
content: "",
next: i === this._steps.length - 1 ? -1 : i + 1,
prev: i - 1,
animation: true,
onShow: this._options.onShow,
onHide: this._options.onHide
}, this._steps[i]);
};
Tour.prototype.getStep = function(i) {
if (this._steps[i] != null) {
return $.extend({
path: "",
placement: "right",
title: "",
content: "",
next: i === this._steps.length - 1 ? -1 : i + 1,
prev: i - 1,
animation: true,
onShow: this._options.onShow,
onHide: this._options.onHide,
onShown: this._options.onShown
}, this._steps[i]);
}
};
Tour.prototype.start = function(force) {
if (force == null) {
force = false;
}
if (force || !this.ended()) {
return this.showStep(this._current);
}
};
Tour.prototype.start = function(force) {
var _this = this;
if (force == null) force = false;
if (this.ended() && !force) return;
$(document).off("click.bootstrap-tour", ".popover .next").on("click.bootstrap-tour", ".popover .next", function(e) {
e.preventDefault();
return _this.next();
});
$(document).off("click.bootstrap-tour", ".popover .prev").on("click.bootstrap-tour", ".popover .prev", function(e) {
e.preventDefault();
return _this.prev();
});
$(document).off("click.bootstrap-tour", ".popover .end").on("click.bootstrap-tour", ".popover .end", function(e) {
e.preventDefault();
return _this.end();
});
this._setupKeyboardNavigation();
return this.showStep(this._current);
};
Tour.prototype.next = function() {
this.hideStep(this._current);
return this.showNextStep();
};
Tour.prototype.next = function() {
this.hideStep(this._current);
return this.showNextStep();
};
Tour.prototype.prev = function() {
this.hideStep(this._current);
return this.showPrevStep();
};
Tour.prototype.prev = function() {
this.hideStep(this._current);
return this.showPrevStep();
};
Tour.prototype.end = function() {
this.hideStep(this._current);
return this.setState("end", "yes");
};
Tour.prototype.end = function() {
this.hideStep(this._current);
$(document).off(".bootstrap-tour");
return this.setState("end", "yes");
};
Tour.prototype.ended = function() {
return !!this.getState("end");
};
Tour.prototype.ended = function() {
return !!this.getState("end");
};
Tour.prototype.restart = function() {
this.setState("current_step", null);
this.setState("end", null);
this.setCurrentStep(0);
return this.start();
};
Tour.prototype.restart = function() {
this.setState("current_step", null);
this.setState("end", null);
this.setCurrentStep(0);
return this.start();
};
Tour.prototype.hideStep = function(i) {
var step;
step = this.getStep(i);
if (step.onHide != null) {
step.onHide(this);
}
return $(step.element).popover("hide");
};
Tour.prototype.hideStep = function(i) {
var step;
step = this.getStep(i);
if (step.onHide != null) step.onHide(this);
return $(step.element).popover("hide");
};
Tour.prototype.showStep = function(i) {
var step;
this.setCurrentStep(i);
step = this.getStep(i);
if (step.path !== "" && document.location.pathname !== step.path && document.location.pathname.replace(/^.*[\\\/]/, '') !== step.path) {
document.location.href = step.path;
return;
}
if (!((step.element != null) && $(step.element).length !== 0 && $(step.element).is(":visible"))) {
this.showNextStep();
return;
}
if (step.onShow != null) {
step.onShow(this);
}
return this._showPopover(step, i);
};
Tour.prototype.showStep = function(i) {
var step;
step = this.getStep(i);
if (!step) return;
this.setCurrentStep(i);
if (step.path !== "" && document.location.pathname !== step.path && document.location.pathname.replace(/^.*[\\\/]/, '') !== step.path) {
document.location.href = step.path;
return;
}
if (step.onShow != null) step.onShow(this);
if (!((step.element != null) && $(step.element).length !== 0 && $(step.element).is(":visible"))) {
this.showNextStep();
return;
}
this._showPopover(step, i);
if (step.onShown != null) return step.onShown(this);
};
Tour.prototype.setCurrentStep = function(value) {
if (value != null) {
this._current = value;
return this.setState("current_step", value);
} else {
this._current = this.getState("current_step");
if (this._current === null || this._current === "null") {
return this._current = 0;
} else {
return this._current = parseInt(this._current);
}
}
};
Tour.prototype.setCurrentStep = function(value) {
if (value != null) {
this._current = value;
return this.setState("current_step", value);
} else {
this._current = this.getState("current_step");
if (this._current === null || this._current === "null") {
return this._current = 0;
} else {
return this._current = parseInt(this._current);
}
}
};
Tour.prototype.showNextStep = function() {
var step;
step = this.getStep(this._current);
return this.showStep(step.next);
};
Tour.prototype.showNextStep = function() {
var step;
step = this.getStep(this._current);
return this.showStep(step.next);
};
Tour.prototype.showPrevStep = function() {
var step;
step = this.getStep(this._current);
return this.showStep(step.prev);
};
Tour.prototype.showPrevStep = function() {
var step;
step = this.getStep(this._current);
return this.showStep(step.prev);
};
Tour.prototype._showPopover = function(step, i) {
var content, nav, tip;
content = "" + step.content + "<br /><p>";
nav = [];
if (step.prev >= 0) {
nav.push("<a href='#" + step.prev + "' class='prev'>&laquo; Prev</a>");
}
if (step.next >= 0) {
nav.push("<a href='#" + step.next + "' class='next'>Next &raquo;</a>");
}
content += nav.join(" | ");
content += "<a href='#' class='pull-right end'>End Tour</a>";
$(step.element).popover({
placement: step.placement,
trigger: "manual",
title: step.title,
content: content,
animation: step.animation
}).popover("show");
tip = $(step.element).data("popover").tip();
this._reposition(tip);
return this._scrollIntoView(tip);
};
Tour.prototype._showPopover = function(step, i) {
var content, nav, options, tip,
_this = this;
content = "" + step.content + "<br /><p>";
options = $.extend({}, this._options);
if (step.options) $.extend(options, step.options);
if (step.reflex) {
$(step.element).css("cursor", "pointer");
$(step.element).on("click", function(e) {
$(step.element).css("cursor", "auto");
return _this.next();
});
}
nav = [];
if (step.prev >= 0) {
nav.push("<a href='#" + step.prev + "' class='prev'>" + options.labels.prev + "</a>");
}
if (step.next >= 0) {
nav.push("<a href='#" + step.next + "' class='next'>" + options.labels.next + "</a>");
}
content += nav.join(" | ");
content += "<a href='#' class='pull-right end'>" + options.labels.end + "</a>";
$(step.element).popover({
placement: step.placement,
trigger: "manual",
title: step.title,
content: content,
html: true,
animation: step.animation
}).popover("show");
tip = $(step.element).data("popover").tip();
this._reposition(tip);
return this._scrollIntoView(tip);
};
Tour.prototype._reposition = function(tip) {
var offsetBottom, offsetRight, tipOffset;
tipOffset = tip.offset();
offsetBottom = $(document).outerHeight() - tipOffset.top - $(tip).outerHeight();
if (offsetBottom < 0) {
tipOffset.top = tipOffset.top + offsetBottom;
}
offsetRight = $(document).outerWidth() - tipOffset.left - $(tip).outerWidth();
if (offsetRight < 0) {
tipOffset.left = tipOffset.left + offsetRight;
}
if (tipOffset.top < 0) {
tipOffset.top = 0;
}
if (tipOffset.left < 0) {
tipOffset.left = 0;
}
return tip.offset(tipOffset);
};
Tour.prototype._reposition = function(tip) {
var offsetBottom, offsetRight, tipOffset;
tipOffset = tip.offset();
offsetBottom = $(document).outerHeight() - tipOffset.top - $(tip).outerHeight();
if (offsetBottom < 0) tipOffset.top = tipOffset.top + offsetBottom;
offsetRight = $(document).outerWidth() - tipOffset.left - $(tip).outerWidth();
if (offsetRight < 0) tipOffset.left = tipOffset.left + offsetRight;
if (tipOffset.top < 0) tipOffset.top = 0;
if (tipOffset.left < 0) tipOffset.left = 0;
return tip.offset(tipOffset);
};
Tour.prototype._scrollIntoView = function(tip) {
var tipRect;
tipRect = tip.get(0).getBoundingClientRect();
if (!(tipRect.top > 0 && tipRect.bottom < $(window).height() && tipRect.left > 0 && tipRect.right < $(window).width())) {
return tip.get(0).scrollIntoView(true);
}
};
Tour.prototype._scrollIntoView = function(tip) {
var tipRect;
tipRect = tip.get(0).getBoundingClientRect();
if (!(tipRect.top > 0 && tipRect.bottom < $(window).height() && tipRect.left > 0 && tipRect.right < $(window).width())) {
return tip.get(0).scrollIntoView(true);
}
};
return Tour;
Tour.prototype._onresize = function(cb, timeout) {
return $(window).resize(function() {
clearTimeout(timeout);
return timeout = setTimeout(cb, 100);
});
};
})();
return window.Tour = Tour;
})(jQuery, window);
Tour.prototype._setupKeyboardNavigation = function() {
var _this = this;
if (this._options.keyboard) {
return $(document).on("keyup.bootstrap-tour", function(e) {
if (!e.which) return;
switch (e.which) {
case 39:
e.preventDefault();
if (_this._current < _this._steps.length - 1) return _this.next();
break;
case 37:
e.preventDefault();
if (_this._current > 0) return _this.prev();
}
});
}
};
return Tour;
})();
return window.Tour = Tour;
})(jQuery, window);
}).call(this);

View file

@ -117,6 +117,7 @@ ready (model) ->
tour = new Tour()
for step in content.tourSteps
tour.addStep
html: true
element: step.element
title: step.title
content: step.content