From 0cd4b869322d7f338412d604f2756d64057c9db0 Mon Sep 17 00:00:00 2001 From: "lpsolit%gmail.com" <> Date: Wed, 18 Apr 2007 03:08:06 +0000 Subject: Bug 258647: productmenu.js and productform.js should be consolidated - Patch by Teemu Mannermaa r=myk a=LpSolit --- js/productform.js | 425 +++++++++++++++++++++++++++++------------------------- 1 file changed, 232 insertions(+), 193 deletions(-) (limited to 'js') diff --git a/js/productform.js b/js/productform.js index 7cf07d732..f9b420c31 100644 --- a/js/productform.js +++ b/js/productform.js @@ -18,139 +18,164 @@ * Contributor(s): Christian Reis */ -/* this file contains functions to update form controls based on a - * collection of javascript arrays containing strings */ - -/* selectClassification reads the selection from f.classification and updates - * f.product accordingly - * - f: a form containing classification, product, component, varsion and - * target_milestone select boxes. - * globals (3vil!): - * - prods, indexed by classification name - * - first_load: boolean, specifying if it is the first time we load - * the query page. - * - last_sel: saves our last selection list so we know what has - * changed, and optimize for additions. +// Functions to update form select elements based on a +// collection of javascript arrays containing strings. + +/** + * Reads the selected classifications and updates product, component, + * version and milestone lists accordingly. + * + * @param classfield Select element that contains classifications. + * @param product Select element that contains products. + * @param component Select element that contains components. Can be null if + * there is no such element to update. + * @param version Select element that contains versions. Can be null if + * there is no such element to update. + * @param milestone Select element that contains milestones. Can be null if + * there is no such element to update. + * + * @global prods Array of products indexed by classification name. + * @global first_load Boolean; true if this is the first time this page loads + * or false if not. + * @global last_sel Array that contains last list of products so we know what + * has changed, and optimize for additions. */ function selectClassification(classfield, product, component, version, milestone) { - /* this is to avoid handling events that occur before the form - * itself is ready, which could happen in buggy browsers. - */ - if (!classfield) { + // This is to avoid handling events that occur before the form + // itself is ready, which could happen in buggy browsers. + if (!classfield) return; - } - /* if this is the first load and nothing is selected, no need to - * merge and sort all components; perl gives it to us sorted. - */ + // If this is the first load and nothing is selected, no need to + // merge and sort all lists; they are created sorted. if ((first_load) && (classfield.selectedIndex == -1)) { first_load = false; return; } - /* don't reset first_load as done in selectProduct. That's because we - want selectProduct to handle the first_load attribute - */ - - /* - sel keeps the array of classifications we are selected. - * - merging says if it is a full list or just a list of classifications - * that were added to the current selection. - */ - var merging = false; + // Don't reset first_load as done in selectProduct. That's because we + // want selectProduct to handle the first_load attribute. + + // Stores classifications that are selected. var sel = Array(); - /* if nothing selected, pick all */ + // True if sel array has a full list or false if sel contains only + // new classifications that are to be merged to the current list. + var merging = false; + + // If nothing selected, pick all. var findall = classfield.selectedIndex == -1; sel = get_selection(classfield, findall, false); if (!findall) { - /* save sel for the next invocation of selectClassification() */ + // Save sel for the next invocation of selectClassification(). var tmp = sel; - /* this is an optimization: if we have just added classifications to an - * existing selection, no need to clear the form controls and add - * everybody again; just merge the new ones with the existing - * options. - */ + // This is an optimization: if we have just added classifications to an + // existing selection, no need to clear the form elements and add + // everything again; just merge the new ones with the existing + // options. if ((last_sel.length > 0) && (last_sel.length < sel.length)) { sel = fake_diff_array(sel, last_sel); merging = true; } last_sel = tmp; } - /* save original options selected */ - var saved_prods = get_selection(product, false, true); - /* do the actual fill/update, reselect originally selected options */ - updateSelect(prods, sel, product, merging); + // Save original options selected. + var saved_prods = get_selection(product, false, true, null); + + // Do the actual fill/update, reselect originally selected options. + updateSelect(prods, sel, product, merging, null); restoreSelection(product, saved_prods); - selectProduct(product, component, version, milestone); + selectProduct(product, component, version, milestone, null); } - -/* selectProduct reads the selection from the product control and - * updates version, component and milestone controls accordingly. - * - * - product, component, version and milestone: form controls +/** + * Reads the selected products and updates component, version and milestone + * lists accordingly. + * + * @param product Select element that contains products. + * @param component Select element that contains components. Can be null if + * there is no such element to update. + * @param version Select element that contains versions. Can be null if + * there is no such element to update. + * @param milestone Select element that contains milestones. Can be null if + * there is no such element to update. + * @param anyval Value to use for a special "Any" list item. Can be null + * to not use any. If used must and will be first item in + * the select element. * - * globals (3vil!): - * - cpts, vers, tms: array of arrays, indexed by product name. the - * subarrays contain a list of names to be fed to the respective - * selectboxes. For bugzilla, these are generated with perl code - * at page start. - * - first_load: boolean, specifying if it is the first time we load - * the query page. - * - last_sel: saves our last selection list so we know what has - * changed, and optimize for additions. + * @global cpts Array of arrays, indexed by product name. The subarrays + * contain a list of components to be fed to the respective + * select element. + * @global vers Array of arrays, indexed by product name. The subarrays + * contain a list of versions to be fed to the respective + * select element. + * @global tms Array of arrays, indexed by product name. The subarrays + * contain a list of milestones to be fed to the respective + * select element. + * @global first_load Boolean; true if this is the first time this page loads + * or false if not. + * @global last_sel Array that contains last list of products so we know what + * has changed, and optimize for additions. */ -function selectProduct(product, component, version, milestone) { +function selectProduct(product, component, version, milestone, anyval) { + // This is to avoid handling events that occur before the form + // itself is ready, which could happen in buggy browsers. + if (!product) + return; - if (!product) { - /* this is to avoid handling events that occur before the form - * itself is ready, which could happen in buggy browsers. */ + // Do nothing if no products are defined. This is to avoid the + // "a has no properties" error from merge_arrays function. + if (product.length == (anyval != null ? 1 : 0)) return; - } - /* if this is the first load and nothing is selected, no need to - * merge and sort all components; perl gives it to us sorted. */ + // If this is the first load and nothing is selected, no need to + // merge and sort all lists; they are created sorted. if ((first_load) && (product.selectedIndex == -1)) { first_load = false; return; } - /* turn first_load off. this is tricky, since it seems to be - * redundant with the above clause. It's not: if when we first load - * the page there is _one_ element selected, it won't fall into that - * clause, and first_load will remain 1. Then, if we unselect that - * item, selectProduct will be called but the clause will be valid - * (since selectedIndex == -1), and we will return - incorrectly - - * without merge/sorting. */ + // Turn first_load off. This is tricky, since it seems to be + // redundant with the above clause. It's not: if when we first load + // the page there is _one_ element selected, it won't fall into that + // clause, and first_load will remain 1. Then, if we unselect that + // item, selectProduct will be called but the clause will be valid + // (since selectedIndex == -1), and we will return - incorrectly - + // without merge/sorting. first_load = false; - /* - sel keeps the array of products we are selected. - * - merging says if it is a full list or just a list of products that - * were added to the current selection. */ - var merging = false; + // Stores products that are selected. var sel = Array(); - /* if nothing selected, pick all */ - var findall = product.selectedIndex == -1; + // True if sel array has a full list or false if sel contains only + // new products that are to be merged to the current list. + var merging = false; + + // If nothing is selected, or the special "Any" option is selected + // which represents all products, then pick all products so we show + // all components. + var findall = (product.selectedIndex == -1 + || (anyval != null && product.options[0].selected)); + if (useclassification) { - /* update index based on the complete product array */ - sel = get_selection(product, findall, true); - for (var i=0; i 0) && (last_sel.length < sel.length)) { sel = fake_diff_array(sel, last_sel); merging = true; @@ -158,167 +183,180 @@ function selectProduct(product, component, version, milestone) { last_sel = tmp; } - /* do the actual fill/update */ + // Do the actual fill/update. if (component) { - var saved_cpts = get_selection(component, false, true); - updateSelect(cpts, sel, component, merging); + var saved_cpts = get_selection(component, false, true, null); + updateSelect(cpts, sel, component, merging, anyval); restoreSelection(component, saved_cpts); } if (version) { - var saved_vers = get_selection(version, false, true); - updateSelect(vers, sel, version, merging); + var saved_vers = get_selection(version, false, true, null); + updateSelect(vers, sel, version, merging, anyval); restoreSelection(version, saved_vers); } if (milestone) { - var saved_tms = get_selection(milestone, false, true); - updateSelect(tms, sel, milestone, merging); + var saved_tms = get_selection(milestone, false, true, null); + updateSelect(tms, sel, milestone, merging, anyval); restoreSelection(milestone, saved_tms); } } - -/* updateSelect(array, sel, target, merging) +/** + * Adds to the target select element all elements from array that + * correspond to the selected items. * - * Adds to the target select object all elements in array that - * correspond to the elements selected in source. - * - array should be a array of arrays, indexed by number. the - * array should contain the elements that correspond to that - * product. - * - sel is a list of selected items, either whole or a diff - * depending on merging. - * - target should be the target select object. - * - merging (boolean) determines if we are mergine in a diff or - * substituting the whole selection. a diff is used to optimize adding - * selections. + * @param array An array of arrays, indexed by number. The array should + * contain elements for each selection. + * @param sel A list of selected items, either whole or a diff depending + * on merging parameter. + * @param target Select element that is to be updated. + * @param merging Boolean that determines if we are merging in a diff or + * substituting the whole selection. A diff is used to optimize + * adding selections. + * @param anyval Name of special "Any" value to add. Can be null if not used. + * @return Boolean; true if target contains options or false if target + * is empty. * - * Example (compsel is a select form control) + * Example (compsel is a select form element): * * var components = Array(); * components[1] = [ 'ComponentA', 'ComponentB' ]; * components[2] = [ 'ComponentC', 'ComponentD' ]; * source = [ 2 ]; - * updateSelect(components, source, compsel, 0, 0); - * - * would clear compsel and add 'ComponentC' and 'ComponentD' to it. + * updateSelect(components, source, compsel, false, null); * + * This would clear compsel and add 'ComponentC' and 'ComponentD' to it. */ - -function updateSelect(array, sel, target, merging) { - +function updateSelect(array, sel, target, merging, anyval) { var i, item; - /* If we have no versions/components/milestones */ + // If we have no versions/components/milestones. if (array.length < 1) { target.options.length = 0; return false; } if (merging) { - /* array merging/sorting in the case of multiple selections */ - /* merge in the current options with the first selection */ + // Array merging/sorting in the case of multiple selections + // merge in the current options with the first selection. item = merge_arrays(array[sel[0]], target.options, 1); - /* merge the rest of the selection with the results */ - for (i = 1 ; i < sel.length ; i++) { + // Merge the rest of the selection with the results. + for (i = 1 ; i < sel.length ; i++) item = merge_arrays(array[sel[i]], item, 0); - } - } else if ( sel.length > 1 ) { - /* here we micro-optimize for two arrays to avoid merging with a - * null array */ + } + else if (sel.length > 1) { + // Here we micro-optimize for two arrays to avoid merging with a + // null array. item = merge_arrays(array[sel[0]],array[sel[1]], 0); - /* merge the arrays. not very good for multiple selections. */ - for (i = 2; i < sel.length; i++) { + // Merge the arrays. Not very good for multiple selections. + for (i = 2; i < sel.length; i++) item = merge_arrays(item, array[sel[i]], 0); - } - } else { /* single item in selection, just get me the list */ + } + else { + // Single item in selection, just get me the list. item = array[sel[0]]; } - /* clear select */ + // Clear current selection. target.options.length = 0; - /* load elements of list into select */ - for (i = 0; i < item.length; i++) { - target.options[i] = new Option(item[i], item[i]); - } + // Add special "Any" value back to the list. + if (anyval != null) + target.options[0] = new Option(anyval, ""); + + // Load elements of list into select element. + for (i = 0; i < item.length; i++) + target.options[target.options.length] = new Option(item[i], item[i]); + return true; } - -/* Selects items in control that have index defined in sel - * - control: SELECT control to be restored - * - selnames: array of indexes in select form control */ +/** + * Selects items in select element that are defined to be selected. + * + * @param control Select element of which selected options are to be restored. + * @param selnames Array of option names to select. + */ function restoreSelection(control, selnames) { - /* right. this sucks. but I see no way to avoid going through the - * list and comparing to the contents of the control. */ - for (var j=0; j < selnames.length; j++) { - for (var i=0; i < control.options.length; i++) { - if (control.options[i].value == selnames[j]) { + // Right. This sucks but I see no way to avoid going through the + // list and comparing to the contents of the control. + for (var j = 0; j < selnames.length; j++) + for (var i = 0; i < control.options.length; i++) + if (control.options[i].value == selnames[j]) control.options[i].selected = true; - } - } - } } - -/* Returns elements in a that are not in b. +/** + * Returns elements in a that are not in b. * NOT A REAL DIFF: does not check the reverse. - * - a,b: arrays of values to be compare. */ + * + * @param a First array to compare. + * @param b Second array to compare. + * @return Array of elements in a but not in b. + */ function fake_diff_array(a, b) { var newsel = new Array(); var found = false; - /* do a boring array diff to see who's new */ + // Do a boring array diff to see who's new. for (var ia in a) { - for (var ib in b) { - if (a[ia] == b[ib]) { + for (var ib in b) + if (a[ia] == b[ib]) found = true; - } - } - if (!found) { + + if (!found) newsel[newsel.length] = a[ia]; - } + found = false; } + return newsel; } -/* takes two arrays and sorts them by string, returning a new, sorted - * array. the merge removes dupes, too. - * - a, b: arrays to be merge. - * - b_is_select: if true, then b is actually an optionitem and as - * such we need to use item.value on it. */ +/** + * Takes two arrays and sorts them by string, returning a new, sorted + * array. The merge removes dupes, too. + * + * @param a First array to merge. + * @param b Second array or an optionitem element to merge. + * @param b_is_select Boolean; true if b is an optionitem element (need to + * access its value by item.value) or false if b is a + * an array. + * @return Merged and sorted array. + */ function merge_arrays(a, b, b_is_select) { var pos_a = 0; var pos_b = 0; var ret = new Array(); var bitem, aitem; - /* iterate through both arrays and add the larger item to the return - * list. remove dupes, too. Use toLowerCase to provide - * case-insensitivity. */ + // Iterate through both arrays and add the larger item to the return + // list. Remove dupes, too. Use toLowerCase to provide + // case-insensitivity. while ((pos_a < a.length) && (pos_b < b.length)) { - if (b_is_select) { + aitem = a[pos_a]; + if (b_is_select) bitem = b[pos_b].value; - } else { + else bitem = b[pos_b]; - } - aitem = a[pos_a]; - /* smaller item in list a */ + // Smaller item in list a. if (aitem.toLowerCase() < bitem.toLowerCase()) { ret[ret.length] = aitem; pos_a++; - } else { - /* smaller item in list b */ + } + else { + // Smaller item in list b. if (aitem.toLowerCase() > bitem.toLowerCase()) { ret[ret.length] = bitem; pos_b++; - } else { - /* list contents are equal, inc both counters. */ + } + else { + // List contents are equal, include both counters. ret[ret.length] = aitem; pos_a++; pos_b++; @@ -326,44 +364,45 @@ function merge_arrays(a, b, b_is_select) { } } - /* catch leftovers here. these sections are ugly code-copying. */ - if (pos_a < a.length) { - for (; pos_a < a.length ; pos_a++) { + // Catch leftovers here. These sections are ugly code-copying. + if (pos_a < a.length) + for (; pos_a < a.length ; pos_a++) ret[ret.length] = a[pos_a]; - } - } if (pos_b < b.length) { for (; pos_b < b.length; pos_b++) { - if (b_is_select) { + if (b_is_select) bitem = b[pos_b].value; - } else { + else bitem = b[pos_b]; - } ret[ret.length] = bitem; } } + return ret; } -/* Returns an array of indexes or values from a select form control. - * - control: select control from which to find selections - * - findall: boolean, store all options when true or just the selected - * indexes - * - want_values: boolean; we store values when true and indexes when - * false */ -function get_selection(control, findall, want_values) { +/** + * Returns an array of indexes or values of options in a select form element. + * + * @param control Select form element from which to find selections. + * @param findall Boolean; true to return all options or false to return + * only selected options. + * @param want_values Boolean; true to return values and false to return + * indexes. + * @param anyval Name of a special "Any" value that should be skipped. Can + * be null if not used. + * @return Array of all or selected indexes or values. + */ +function get_selection(control, findall, want_values, anyval) { var ret = new Array(); - if ((!findall) && (control.selectedIndex == -1)) { + if ((!findall) && (control.selectedIndex == -1)) return ret; - } - for (var i=0; i