npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@squarespace/ancillary

v1.0.3

Published

Moves elements into the right place

Downloads

10

Readme

Squarespace Ancillary

Ancillary is a layout script to move a set of "element" DOM nodes into a set of "container" DOM nodes based on a series of "setting" class names on the <body> element that describe positioning. It finds out about which DOM nodes are elements and which are containers through the presence of the data-attributes data-nc-element and data-nc-container. Ancillary can be instantiated many times on one page.

NOTICE: This code is licensed to you pursuant to Squarespace’s Developer Terms of Use. See license section below.

Example

Before Ancillary:

<body class="ancillary-header-logo-position-left ancillary-header-nav-position-right ancillary-header-cta-position-right">
  <header data-nc-base="header">
    <div data-nc-container="left">
      <h1 data-nc-element="logo"></h1>
      <nav data-nc-element="nav"></nav>
      <button data-nc-element="cta"></button>
    </div>
    <div data-nc-container="right"></div>
  </header>
</body>

After Ancillary:

<body class="ancillary-header-logo-position-left ancillary-header-nav-position-right ancillary-header-cta-position-right">
  <header data-nc-base="header">
    <div data-nc-container="left">
      <h1 data-nc-element="logo"></h1>
    </div>
    <div data-nc-container="right">
      <nav data-nc-element="nav"></nav>
      <button data-nc-element="cta"></button>
    </div>
  </header>
</body>

Usage

Markup

Create an element to wrap all your Ancillary elements. This base element should have the data-attribute data-nc-base, and the attribute value should reflect the string that comes after 'ancillary' in the body class names.

<header data-nc-base="header"></header>

Create container elements inside your base, and give them the data-attribute data-nc-container, with the value matching the string that comes after 'position' at the end of the body class names. NOTE: If a body class name refers to a container that is not present on the page as a data-nc-container, the corresponding element will be removed from the DOM. This can be useful – for example, a body class name of ancillary-header-logo-position-none will remove <h1 data-nc-element="logo"> from the DOM entirely, as long as there is no <div data-nc-container="none"> present in the DOM.

<div data-nc-container="left"></div>
<div data-nc-container="right"></div>

Lastly, create the actual Ancillary elements and assign them the data-attribute data-nc-element, which should again match the strings that refer to the elements inside the body class names.

<h1 data-nc-element="logo"></h1>
<nav data-nc-element="nav"></nav>
<button data-nc-element="cta"></button>

You've completed the process of creating your Ancillary layout. Feel free to put whatever you wish inside each data-nc-element.

Javascript

import Ancillary from '@squarespace/ancillary';

const header = document.querySelector('[data-nc-base="header"]');
const headerAncillary = new Ancillary(header);
headerAncillary.sync();

Using ES6

If you prefer to handle transpiling and polyfilling on your own, you can import ES6 from Ancillary:

import ancillary from '@squarespace/ancillary/src';

Alternately, Ancillary specifies a module property in package.json that points to the uncompiled src/index.js, so you may be able to simply import @squarespace/ancillary if you're using one of the following bundlers:

Developer's Notes

  • Ancillary is meant to solve a problem particular to Squarespace templates – the desire to allow users to achieve a large number of potential layouts for their desktop or mobile headers, without the ability to alter markup.
  • Ancillary should not be used on a normal website. Instead, just place the elements where they need to go in the markup.
  • Ancillary is not a standalone header module - you still need to create and style the content of the header elements yourself. It only provides the ability to move elements around.

License

Portions Copyright © 2016 Squarespace, Inc. This code is licensed to you pursuant to Squarespace’s Developer Terms of Use, available at http://developers.squarespace.com/developer-terms-of-use (the “Developer Terms”). You may only use this code on websites hosted by Squarespace, and in compliance with the Developer Terms. TO THE FULLEST EXTENT PERMITTED BY LAW, SQUARESPACE PROVIDES ITS CODE TO YOU ON AN “AS IS” BASIS WITHOUT WARRANTIES OF ANY KIND, EITHER EXPRESS OR IMPLIED.