Hermes

Fast JS utility library for creating event loops (with basic DOM manipulation).

Maintained as part of Studio Universe's in-house toolkit. If you need help with CSS and styling pages, please checkout Classic.

Docs

Find a single element (this should be cached in a variable):

let $el = $("a.submit");

Find a child element:

$("a.submit").find(".icon");
$el.find(".icon");

Add a click event:

$("a.submit").on("click", function() {
  // Do something
});

Chain methods:

$el
  .on("click", function() {
    // Do something
  })
  .addClass("clickable");

Create a new element:

let $span = $("<span>");

Append a new child element:

$span.append($("<small>"));

Hide an element:

[hidden] { display: none !important; }

$("a.submit").hide();

Change an attribute:

$(["a.contact"]).attr("href", "/contact");

Remove an attribute:

$(["a.contact"]).attr("!style");

Change a class:

$el
  .addClass("bg-important")
  .removeClass("bg-primary");

Find multiple elements by wrapping selectors in an array:

let $anchors = $(["a"]);
let $messages = $([".error", ".warning"]);

Manipulate multiple elements:

let $clickers = $(["a", "button"]);
$anchors.forEach(function(el) { el.hide() });
$anchors.hide();
$anchors.attr("data-test", "123");
$anchors.on("mouseenter touchstart", eventHandler);
$anchors.off("mouseenter touchstart", eventHandler);

Add your own single element method:

$._.myFunction = function(stuff) {
  this.attr("data-stuff", stuff);
}

Add your own multiple element method:

$.__.myFunction = function(stuff) {
  this.forEach(function(el) {
    el.attr("data-stuff", stuff);
  });
  return this;
}

Log shortcut:

$.log("Something happened", eventData);

Log an error:

$.error("Something went wrong");

Get something from your REST API (XHR):

$.fetch("http://myapi.io/1/endpoint").then(successHandler)
  .catch(errorHandler);

Post something to your REST API (XHR):

$.send("http://myapi.io/1/endpoint", { firstName: 'John' }, { method: 'POST' })
  .then(successHandler)
  .catch(errorHandler);

Go to new URL (in a new tab by default):

$.go("https://studiouniverse.co/");
$.go("https://studiouniverse.co/#cool-stuff", false);

Create a repeating event:

var updateID = $.addUpdate({
                  interval: 1000, // ms
                  update: function() {
                    $.log($.time);
                  }
                });

Create a repeating on-scroll event:

var updateID = $.addUpdate({
                  updateOnScroll: true,
                  update: function() {
                    $.log($.time);
                  }
                });

Access useful variables:

$.start; // Time Hermes was loaded
$.time;
$.elapsed; // How long on page
$.screenWidth;
$.screenHeight;
$.scrollY; // Window scroll Y position