@samhaeng/naevner
TypeScript icon, indicating that this package has built-in type declarations

1.0.5 • Public • Published

Naevner.js

Color descriptions generated from hex color codes

Javascript plugin that provides natural language descriptions of hex color codes.

Why we made this

We made this to have screenreader support for reading out color names on remembertostand.com (Turn on screenreader and press C when on the site to hear it in action)

Credits

Demo

Getting started

Minified code

Include the minified code

Install with yarn

yarn add naevner

Install with NPM

npm install naevner

How to use

import naevner from 'naevner'

naevner(color);

Examples

//Examples:
naevner("#000000"); //Returns: “black”
naevner("#0000ff"); //Returns: “vivid blue”
naevner("#D6365C"); //Returns: “clear red”
naevner("#2F5651"); //Returns: “dark, faded turquoise”
naevner("#3F0548"); //Returns: “dark, clear, purpleish magenta”

Accepted values

  • 3-digit hex with preceding #-sign — e.g. #f00
  • 3-digit hex without preceding #-sign — e.g. f00
  • 6-digit hex with preceding #-sign — e.g. #ff0000
  • 6-digit hex without preceding #-sign — e.g. ff0000

Parameters

approximationSuffix

Ending for approximate colors — e.g. “greenish yellow” or “redish orange". Note that “off-white” and “black” nuances currently always use the term “-tinted” (e.g. “red-tinted black” or “yellow-tinted off-white”) independent of this parameter.

naevner(color, approximationSuffix);

approximationSuffix examples:

naevner("#3F0548");            //Returns: “dark, clear, purpleish magenta”
naevner("#3F0548", "-tinted"); //Returns: “dark, clear, purple-tinted magenta”
naevner("#3F0548", "-like");   //Returns: “dark, clear, purple-like magenta”

Other color repositories

The purpose of this plugin is to provide short, unambiguous descriptions using commonly used color terms. For some situations, different types of color descriptions may be more useful. For those situations, you may want to have a look at the following repositories. These are provided for your convenience and are not associated with this repository or Samhæng:

Questions, ideas and advice

If you have questions or advice, feel free to open an issue on this repo. Thank you!

/@samhaeng/naevner/

    Package Sidebar

    Install

    npm i @samhaeng/naevner

    Weekly Downloads

    0

    Version

    1.0.5

    License

    MIT

    Unpacked Size

    100 kB

    Total Files

    13

    Last publish

    Collaborators

    • rasmuswoelk
    • filipjakobsen