color.js

/**
 * @file
 * Attaches the behaviors for the Color module.
 */

(function ($) {

  "use strict";

  Drupal.behaviors.color = {
    attach: function (context, settings) {
      var i, j, colors;
      // This behavior attaches by ID, so is only valid once on a page.
      var form = $(context).find('#system-theme-settings .color-form').once('color');
      if (form.length === 0) {
        return;
      }
      var inputs = [];
      var hooks = [];
      var locks = [];
      var focused = null;

      // Add Farbtastic.
      $('<div id="placeholder"></div>').once('color').prependTo(form);
      var farb = $.farbtastic('#placeholder');

      // Decode reference colors to HSL.
      var reference = settings.color.reference;
      for (i in reference) {
        if (reference.hasOwnProperty(i)) {
          reference[i] = farb.RGBToHSL(farb.unpack(reference[i]));
        }
      }

      // Build a preview.
      var height = [];
      var width = [];
      // Loop through all defined gradients.
      for (i in settings.gradients) {
        if (settings.gradients.hasOwnProperty(i)) {
          // Add element to display the gradient.
          $('#preview').once('color').append('<div id="gradient-' + i + '"></div>');
          var gradient = $('#preview #gradient-' + i);
          // Add height of current gradient to the list (divided by 10).
          height.push(parseInt(gradient.css('height'), 10) / 10);
          // Add width of current gradient to the list (divided by 10).
          width.push(parseInt(gradient.css('width'), 10) / 10);
          // Add rows (or columns for horizontal gradients).
          // Each gradient line should have a height (or width for horizontal
          // gradients) of 10px (because we divided the height/width by 10 above).
          for (j = 0; j < (settings.gradients[i].direction === 'vertical' ? height[i] : width[i]); ++j) {
            gradient.append('<div class="gradient-line"></div>');
          }
        }
      }

      // Set up colorScheme selector.
      form.find('#edit-scheme').on('change', function () {
        var schemes = settings.color.schemes, colorScheme = this.options[this.selectedIndex].value;
        if (colorScheme !== '' && schemes[colorScheme]) {
          // Get colors of active scheme.
          colors = schemes[colorScheme];
          for (var fieldName in colors) {
            if (colors.hasOwnProperty(fieldName)) {
              callback($('#edit-palette-' + fieldName), colors[fieldName], false, true);
            }
          }
          preview();
        }
      });

      /**
       * Renders the preview.
       */
      function preview() {
        Drupal.color.callback(context, settings, form, farb, height, width);
      }

      /**
       * Shifts a given color, using a reference pair (ref in HSL).
       *
       * This algorithm ensures relative ordering on the saturation and luminance
       * axes is preserved, and performs a simple hue shift.
       *
       * It is also symmetrical. If: shift_color(c, a, b) === d, then
       * shift_color(d, b, a) === c.
       */
      function shift_color(given, ref1, ref2) {
        var d;
        // Convert to HSL.
        given = farb.RGBToHSL(farb.unpack(given));

        // Hue: apply delta.
        given[0] += ref2[0] - ref1[0];

        // Saturation: interpolate.
        if (ref1[1] === 0 || ref2[1] === 0) {
          given[1] = ref2[1];
        }
        else {
          d = ref1[1] / ref2[1];
          if (d > 1) {
            given[1] /= d;
          }
          else {
            given[1] = 1 - (1 - given[1]) * d;
          }
        }

        // Luminance: interpolate.
        if (ref1[2] === 0 || ref2[2] === 0) {
          given[2] = ref2[2];
        }
        else {
          d = ref1[2] / ref2[2];
          if (d > 1) {
            given[2] /= d;
          }
          else {
            given[2] = 1 - (1 - given[2]) * d;
          }
        }

        return farb.pack(farb.HSLToRGB(given));
      }

      /**
       * Callback for Farbtastic when a new color is chosen.
       */
      function callback(input, color, propagate, colorScheme) {
        var matched;
        // Set background/foreground colors.
        $(input).css({
          backgroundColor: color,
          'color': farb.RGBToHSL(farb.unpack(color))[2] > 0.5 ? '#000' : '#fff'
        });

        // Change input value.
        if ($(input).val() && $(input).val() !== color) {
          $(input).val(color);

          // Update locked values.
          if (propagate) {
            i = input.i;
            for (j = i + 1; ; ++j) {
              if (!locks[j - 1] || $(locks[j - 1]).is('.unlocked')) {
                break;
              }
              matched = shift_color(color, reference[input.key], reference[inputs[j].key]);
              callback(inputs[j], matched, false);
            }
            for (j = i - 1; ; --j) {
              if (!locks[j] || $(locks[j]).is('.unlocked')) {
                break;
              }
              matched = shift_color(color, reference[input.key], reference[inputs[j].key]);
              callback(inputs[j], matched, false);
            }

            // Update preview.
            preview();
          }

          // Reset colorScheme selector.
          if (!colorScheme) {
            resetScheme();
          }
        }
      }

      /**
       * Resets the color scheme selector.
       */
      function resetScheme() {
        form.find('#edit-scheme').each(function () {
          this.selectedIndex = this.options.length - 1;
        });
      }

      /**
       * Focuses Farbtastic on a particular field.
       */
      function focus(e) {
        var input = e.target;
        // Remove old bindings.
        if (focused) {
          $(focused).off('keyup', farb.updateValue)
            .off('keyup', preview).off('keyup', resetScheme)
            .parent().removeClass('item-selected');
        }

        // Add new bindings.
        focused = input;
        farb.linkTo(function (color) { callback(input, color, true, false); });
        farb.setColor(input.value);
        $(focused).on('keyup', farb.updateValue).on('keyup', preview).on('keyup', resetScheme)
          .parent().addClass('item-selected');
      }

      // Initialize color fields.
      form.find('#palette input.form-text')
        .each(function () {
          // Extract palette field name
          this.key = this.id.substring(13);

          // Link to color picker temporarily to initialize.
          farb.linkTo(function () {}).setColor('#000').linkTo(this);

          // Add lock.
          i = inputs.length;
          if (inputs.length) {
            var toggleClick = true;
            var lock = $('<div class="lock"></div>').on('click', function () {
              if (toggleClick) {
                $(this).addClass('unlocked');
                $(hooks[i - 1]).attr('class',
                  locks[i - 2] && $(locks[i - 2]).is(':not(.unlocked)') ? 'hook up' : 'hook'
                );
                $(hooks[i]).attr('class',
                  locks[i] && $(locks[i]).is(':not(.unlocked)') ? 'hook down' : 'hook'
                );
              }
              else {
                $(this).removeClass('unlocked');
                $(hooks[i - 1]).attr('class',
                  locks[i - 2] && $(locks[i - 2]).is(':not(.unlocked)') ? 'hook both' : 'hook down'
                );
                $(hooks[i]).attr('class',
                  locks[i] && $(locks[i]).is(':not(.unlocked)') ? 'hook both' : 'hook up'
                );
              }
              toggleClick = !toggleClick;
            });
            $(this).after(lock);
            locks.push(lock);
          }

          // Add hook.
          var hook = $('<div class="hook"></div>');
          $(this).after(hook);
          hooks.push(hook);

          $(this).parent().find('.lock').trigger('click');
          this.i = i;
          inputs.push(this);
        })
        .on('focus', focus);

      form.find('#palette label');

      // Focus first color.
      inputs[0].focus();

      // Render preview.
      preview();
    }
  };

})(jQuery);