moodle/mod/quiz/yui/build/moodle-mod_quiz-util-slot/moodle-mod_quiz-util-slot-debug.js
Colin Chambers a69f81f0d3 MDL-47368 Edit quiz: page should not reload so often
The approach is that we have a new JavaScript function
M.mod_quiz.resource_toolbox.reorganise_edit_page which, after a ajax
action, fixes up everything like page breaks, page and question numbers,
that might now be wrong.

We call that function instead of reloading the page.

Also, there are a lot more Behat tests to verify this works correctly.

AMOS BEGIN
 MOV [joinpages,mod_quiz],[removepagebreak,mod_quiz]
 MOV [splitpages,mod_quiz],[addpagebreak,mod_quiz]
AMOS END
2014-10-28 11:32:42 +00:00

347 lines
11 KiB
JavaScript

YUI.add('moodle-mod_quiz-util-slot', function (Y, NAME) {
/**
* A collection of utility classes for use with slots.
*
* @module moodle-mod_quiz-util
* @submodule moodle-mod_quiz-util-slot
*/
Y.namespace('Moodle.mod_quiz.util.slot');
/**
* A collection of utility classes for use with slots.
*
* @class Moodle.mod_quiz.util.slot
* @static
*/
Y.Moodle.mod_quiz.util.slot = {
CSS: {
SLOT : 'slot',
QUESTIONTYPEDESCRIPTION : 'qtype_description'
},
CONSTANTS: {
SLOTIDPREFIX : 'slot-',
QUESTION : M.util.get_string('question', 'moodle')
},
SELECTORS: {
SLOT: 'li.slot',
INSTANCENAME: '.instancename',
NUMBER: 'span.slotnumber',
PAGECONTENT : 'div#page-content',
PAGEBREAK : 'span.page_split_join_wrapper',
ICON : 'img.smallicon',
QUESTIONTYPEDESCRIPTION : '.qtype_description',
SECTIONUL : 'ul.section'
},
/**
* Retrieve the slot item from one of it's child Nodes.
*
* @method getSlotFromComponent
* @param slotcomponent {Node} The component Node.
* @return {Node|null} The Slot Node.
*/
getSlotFromComponent: function(slotcomponent) {
return Y.one(slotcomponent).ancestor(this.SELECTORS.SLOT, true);
},
/**
* Determines the slot ID for the provided slot.
*
* @method getId
* @param slot {Node} The slot to find an ID for.
* @return {Number|false} The ID of the slot in question or false if no ID was found.
*/
getId: function(slot) {
// We perform a simple substitution operation to get the ID.
var id = slot.get('id').replace(
this.CONSTANTS.SLOTIDPREFIX, '');
// Attempt to validate the ID.
id = parseInt(id, 10);
if (typeof id === 'number' && isFinite(id)) {
return id;
}
return false;
},
/**
* Determines the slot name for the provided slot.
*
* @method getName
* @param slot {Node} The slot to find a name for.
* @return {string|false} The name of the slot in question or false if no ID was found.
*/
getName: function(slot) {
var instance = slot.one(this.SELECTORS.INSTANCENAME);
if (instance) {
return instance.get('firstChild').get('data');
}
return null;
},
/**
* Determines the slot number for the provided slot.
*
* @method getNumber
* @param slot {Node} The slot to find the number for.
* @return {Number|false} The number of the slot in question or false if no number was found.
*/
getNumber: function(slot) {
if (!slot) {
return false;
}
// We perform a simple substitution operation to get the number.
var number = slot.one(this.SELECTORS.NUMBER).get('text').replace(
this.CONSTANTS.QUESTION, '');
// Attempt to validate the ID.
number = parseInt(number, 10);
if (typeof number === 'number' && isFinite(number)) {
return number;
}
return false;
},
/**
* Updates the slot number for the provided slot.
*
* @method setNumber
* @param slot {Node} The slot to update the number for.
* @return void
*/
setNumber: function(slot, number) {
var numbernode = slot.one(this.SELECTORS.NUMBER);
numbernode.setHTML('<span class="accesshide">' + this.CONSTANTS.QUESTION + '</span> ' + number);
},
/**
* Returns a list of all slot elements on the page.
*
* @method getSlots
* @return {node[]} An array containing slot nodes.
*/
getSlots: function() {
return Y.all(this.SELECTORS.PAGECONTENT + ' ' + this.SELECTORS.SECTIONUL + ' ' + this.SELECTORS.SLOT);
},
/**
* Returns a list of all slot elements on the page that have numbers. Excudes description questions.
*
* @method getSlots
* @return {node[]} An array containing slot nodes.
*/
getNumberedSlots: function() {
var selector = this.SELECTORS.PAGECONTENT + ' ' + this.SELECTORS.SECTIONUL;
selector += ' ' + this.SELECTORS.SLOT + ':not(' + this.SELECTORS.QUESTIONTYPEDESCRIPTION + ')';
return Y.all(selector);
},
/**
* Returns the previous slot to the given slot.
*
* @method getPrevious
* @param slot Slot node
* @return {node|false} The previous slot node or false.
*/
getPrevious: function(slot) {
return slot.previous(this.SELECTORS.SLOT);
},
/**
* Returns the previous numbered slot to the given slot.
*
* Ignores slots containing description question types.
*
* @method getPrevious
* @param slot Slot node
* @return {node|false} The previous slot node or false.
*/
getPreviousNumbered: function(slot) {
return slot.previous(this.SELECTORS.SLOT + ':not(' + this.SELECTORS.QUESTIONTYPEDESCRIPTION + ')');
},
/**
* Reset the order of the numbers given to each slot.
*
* @method reorderSlots
* @return void
*/
reorderSlots: function() {
// Get list of slot nodes.
var slots = this.getSlots();
// Loop through slots incrementing the number each time.
slots.each(function(slot) {
if (!Y.Moodle.mod_quiz.util.page.getPageFromSlot(slot)) {
// Move the next page to the front.
var nextpage = slot.next(Y.Moodle.mod_quiz.util.page.SELECTORS.PAGE);
slot.swap(nextpage);
}
var previousSlot = this.getPreviousNumbered(slot);
previousslotnumber = 0;
if (slot.hasClass(this.CSS.QUESTIONTYPEDESCRIPTION)) {
return;
}
if (previousSlot) {
previousslotnumber = this.getNumber(previousSlot);
}
// Set slot number.
this.setNumber(slot, previousslotnumber + 1);
}, this);
},
/**
* Remove a slot and related elements from the list of slots.
*
* @method remove
* @param slot Slot node
* @return void
*/
remove: function(slot) {
var page = Y.Moodle.mod_quiz.util.page.getPageFromSlot(slot);
slot.remove();
// Is the page empty.
if (!Y.Moodle.mod_quiz.util.page.isEmpty(page)) {
return;
}
// If so remove it. Including add menu and page break.
Y.Moodle.mod_quiz.util.page.remove(page);
},
/**
* Returns a list of all page break elements on the page.
*
* @method getPageBreaks
* @return {node[]} An array containing page break nodes.
*/
getPageBreaks: function() {
var selector = this.SELECTORS.PAGECONTENT + ' ' + this.SELECTORS.SECTIONUL;
selector += ' ' + this.SELECTORS.SLOT + this.SELECTORS.PAGEBREAK;
return Y.all(selector);
},
/**
* Retrieve the page break element item from the given slot.
*
* @method getPageBreak
* @param slot Slot node
* @return {Node|null} The Page Break Node.
*/
getPageBreak: function(slot) {
return Y.one(slot).one(this.SELECTORS.PAGEBREAK);
},
/**
* Add a page break and related elements to the list of slots.
*
* @method addPageBreak
* @param beforenode Int | Node | HTMLElement | String to add
* @return pagebreak PageBreak node
*/
addPageBreak: function(slot) {
var nodetext = M.mod_quiz.resource_toolbox.get('config').addpageiconhtml;
nodetext = nodetext.replace('%%SLOT%%', this.getNumber(slot));
var pagebreak = Y.Node.create(nodetext);
slot.one('div').insert(pagebreak, 'after');
return pagebreak;
},
/**
* Remove a pagebreak from the given slot.
*
* @method removePageBreak
* @param slot Slot node
* @return boolean
*/
removePageBreak: function(slot) {
var pagebreak = this.getPageBreak(slot);
if (!pagebreak) {
return false;
}
pagebreak.remove();
return true;
},
/**
* Reorder each pagebreak by iterating through each related slot.
*
* @method reorderPageBreaks
* @return void
*/
reorderPageBreaks: function() {
// Get list of slot nodes.
var slots = this.getSlots(), slotnumber = 0;
// Loop through slots incrementing the number each time.
slots.each (function(slot, key) {
slotnumber++;
var pagebreak = this.getPageBreak(slot);
// Last slot won't have a page break.
if (!pagebreak && key === slots.size() - 1) {
return;
}
// No pagebreak and not last slot. Add one.
if (!pagebreak && key !== slots.size() - 1) {
pagebreak = this.addPageBreak(slot);
}
// Remove last page break if there is one.
if (pagebreak && key === slots.size() - 1) {
this.removePageBreak(slot);
}
// Get page break anchor element.
var pagebreaklink = pagebreak.get('childNodes').item(0);
// Get the correct title.
var nextactivity = slot.next('li.activity');
var titlename = '', action = '', uri = M.cfg.wwwroot;
var iconsrc = uri + '/theme/image.php?theme=clean&component=core';
// IE8 can't handle svg images.
if (Y.one('body.ie8')) {
iconsrc += '&svg=e%2F0';
}
if (Y.Moodle.mod_quiz.util.page.isPage(nextactivity)) {
action = titlename = 'removepagebreak';
iconsrc += '&image=e%2Fremove_page_break';
} else {
action = titlename = 'addpagebreak';
iconsrc += '&image=e%2Finsert_page_break';
}
var title = M.util.get_string(titlename, 'quiz');
// Update the link and image titles
pagebreaklink.set('title', title);
pagebreaklink.setData('action', action);
// Update the image title.
var icon = pagebreaklink.one(this.SELECTORS.ICON);
icon.set('title', title);
// Update the image src.
icon.set('src', iconsrc);
// Get anchor url parameters as an associative array.
var params = Y.QueryString.parse(pagebreaklink.get('href'));
// Update slot number.
params.slot = slotnumber;
// Create the new url.
var newurl = '';
for (var index in params) {
if (newurl.length) {
newurl += "&";
}
newurl += index + "=" + params[index];
}
// Update the anchor.
pagebreaklink.set('href', newurl);
}, this);
}
};
}, '@VERSION@', {"requires": ["node", "moodle-mod_quiz-util-base"]});