1

/**

     2

 * jQuery support code for our forms

     3

 */

     4

     5

(function($) {

     6

    /**

     7

     * Query or set form field disabled state

     8

     */

     9

    $.fn.disabled = function (flag) {

    10

        if (flag == undefined)

    11

            // XXX: jQuery returns `true` here?

    12

            return !!this.attr("disabled");

    13

    14

        if (flag)

    15

            this.attr("disabled", "disabled");

    16

        else

    17

            this.removeAttr("disabled");

    18

    }

    19

    20

    /**

    21

     * Query or set form field checked state

    22

     */

    23

    $.fn.checked = function (flag) {

    24

        if (flag == undefined)

    25

            // XXX: jQuery returns true here?

    26

            return !!this.attr("checked");

    27

    28

    29

        if (flag)

    30

            this.attr("checked", "checked");

    31

        else

    32

            this.removeAttr("checked");

    33

    }

    34

    35

    /**

    36

     * Redirect browser to another URL

    37

     *

    38

     * XXX: Can I do a global function like this?

    39

     */

    40

    $.redirect = function (url) {

    41

        window.location.href = url;

    42

    43

        return false;

    44

    }

    45

    46

    47

    /*

    48

     * The given checkbox acts as an enable/disable toggle for this form control

    49

     */

    50

    $.fn.formEnabledBy = function (checkbox) {

    51

        var target = this;

    52

    53

        checkbox.change(function () {

    54

            target.disabled(!checkbox.checked());

    55

        });

    56

        checkbox.change();

    57

    }

    58

    59

    /*

    60

     * When non-zero <select>/<option> is selected, apply that option as pre-filled values for other form items

    61

     */

    62

    $.fn.formSelectsPreset = function (opts) {

    63

        opts = $.extend({

    64

            // which option value is the "default", i.e. 'create new'

    65

            valueDefault: 0,

    66

    67

            // which element to apply selected option value (id) to

    68

            valueTarget: null,

    69

    70

            // which element to apply selected option text to

    71

            textTarget: null,

    72

    73

            // list of targets from external lookup maps

    74

            mapTargets: null

    75

        }, opts);

    76

    77

        function update () {

    78

            // selected option value (i.e. id)

    79

            value = $(this).val();

    80

    81

            // selected option text (i.e. title/name)

    82

            text = $.trim($(this).find("option:selected").text());

    83

    84

            // fields to set

    85

            field_values = [];

    86

    87

            if (opts.valueTarget)

    88

                field_values.push([opts.valueTarget, value]);

    89

    90

            if (opts.textTarget)

    91

                field_values.push([opts.textTarget, text]);

    92

    93

            if (opts.mapTargets) {

    94

                $.each(opts.mapTargets, function (index, entry) {

    95

                    var field = entry[0], map = entry[1];

    96

    97

                    // entry

    98

                    field_values.push([field, map[value]]);

    99

                });

   100

            }

   101

   102

            // apply new value

   103

            if (value == opts.valueDefault) {

   104

                // Re-enable all the fields that we set preset values for earlier

   105

                $.each(field_values, function (index, entry) {

   106

                    var field = entry[0], value = entry[1];

   107

   108

                    if (!field.disabled())

   109

                        // if we didn't lock it down, we shouldn't be resetting it..

   110

                        // this happens mainly at page load

   111

                        return;

   112

   113

                    // reset

   114

                    field.val("");

   115

                    field.disabled(false);

   116

                });

   117

   118

            } else {

   119

                // Set preset value and lock down the target fields

   120

                $.each(field_values, function (index, entry) {

   121

                    var field = entry[0], value = entry[1];

   122

   123

                    // contant value

   124

                    field.disabled(true);

   125

   126

                    // display the read-only value

   127

                    field.val(value);

   128

                });

   129

            }

   130

        }

   131

   132

        // update linked field state on update, and startup..

   133

        this.change(update);

   134

        this.change()

   135

    }

   136

})(jQuery);