Code Monkey home page Code Monkey logo

piklor.js's Introduction

Piklor.js

piklor.js

A tiny JavaScript color picker library.

Usage

<script src="path/to/piklor.js"></script>
<div class="col-lg-6 picker-wrapper">
    <button class="btn btn-default">Select color</button>
    <div class="color-picker">
    </div>
</div>
<script>
window.addEventListener("load", function () {
    var pk = new Piklor(".color-picker", [
            "#1abc9c"
          , "#2ecc71"
          , "#3498db"
          , "#9b59b6"
          , "#34495e"
          , "#16a085"
          , "#27ae60"
          , "#2980b9"
          , "#8e44ad"
          , "#2c3e50"
          , "#f1c40f"
          , "#e67e22"
          , "#e74c3c"
          , "#ecf0f1"
          , "#95a5a6"
          , "#f39c12"
          , "#d35400"
          , "#c0392b"
          , "#bdc3c7"
          , "#7f8c8d"
        ], {
            open: ".picker-wrapper .btn"
        })
      , wrapperEl = pk.getElm(".picker-wrapper")
      , header = pk.getElm("header")
      , footer = pk.getElm("footer")
      ;

    pk.colorChosen(function (col) {
        wrapperEl.style.backgroundColor = col;
        header.style.backgroundColor = col;
        footer.style.backgroundColor = col;
    });
});
</script>

Documentation

Piklor(sel, colors, options)

Creates a new Piklor instance.

Params

  • String|Element sel: The element where the color picker will live.
  • Array colors: An array of strings representing colors.
  • Object options: An object containing the following fields:
  • open (String|Element): The HTML element or query selector which will open the picker.
  • openEvent (String): The open event (default: "click").
  • style (Object): Some style options:
    • display (String): The display value when the picker is opened (default: "block").
  • template (String): The color item template. The {color} snippet will be replaced with the color value (default: "<div data-col=\"{color}\" style=\"background-color: {color}\"></div>").
  • autoclose (Boolean): If false, the color picker will not be hided by default (default: true).
  • closeOnBlur (Boolean): If true, the color picker will be closed when clicked outside of it (default: false).

Return

  • Piklor The Piklor instance.

getElm(el)

Finds the HTML element.

Params

  • String|Element el: The HTML element or query selector.

Return

  • HTMLElement The selected HTML element.

render()

Renders the colors.

close()

Closes the color picker.

open()

Opens the color picker.

colorChosen(cb)

Adds a new callback in the colorChosen callback buffer.

Params

  • Function cb: The callback function called with the selected color.

set(c, p)

Sets the color picker color.

Params

  • String c: The color to set.
  • Boolean p: If false, the colorChosen callbacks will not be called.

How to contribute

  1. File an issue in the repository, using the bug tracker, describing the contribution you'd like to make. This will help us to get you started on the right foot.
  2. Fork the project in your account and create a new branch: your-great-feature.
  3. Commit your changes in that branch.
  4. Open a pull request, and reference the initial issue in the pull request message.

License

See the LICENSE file.

piklor.js's People

Contributors

ionicabizau avatar troggy avatar seb3s avatar

Stargazers

Bruno Wego avatar Pedro Coutinho avatar  avatar Arianna avatar Mark Broomell avatar Nelson Salvador avatar Daniel Sokil avatar Riccardo Chiarini avatar tg-z avatar  avatar  avatar Marco Colli avatar Pieter Koornhof avatar Mohamad avatar Viesturs Knopkens avatar Joon Hwan 김준환 avatar Iwan Buetti avatar Gregory Durelle avatar Christian Fredegaard avatar TANG SHI QIANG avatar Pascal Tbf avatar shiv kumar singh avatar  avatar An | Anton Röhm avatar  avatar Ali Coskun avatar Shawn A avatar Divine avatar Timo Rüppell avatar Roger Mathews Arruda avatar Didier avatar Vitali Semenyuk avatar  avatar Robin avatar Redy avatar Victor Perrier avatar Stacey Reiman avatar Max Faiko avatar  avatar Lucas Dasso avatar  avatar  avatar timelyportfolio avatar  avatar Angus H. avatar Morgan avatar Vance Tran avatar Luke Kirkpatrick avatar  avatar Syed Hasan raza avatar Jamal Boulhous avatar Igor Corradi avatar Gilles Lepretre avatar Radu Micu avatar Tomek Kuklis avatar James Liu avatar Marcus Moore avatar Susan Joshi avatar Yannick avatar Davi Ferreira avatar Sanjeev S Nair avatar HAKASHUN avatar

Watchers

Adrian Ottiker avatar  avatar Morgan avatar timelyportfolio avatar James Cloos avatar Ravi Sundram avatar Gabriel Petrovay avatar Rolf Mattes avatar Frank avatar  avatar Nelson Salvador avatar  avatar Jakub Rejch avatar

piklor.js's Issues

Image pattern fill

Hi. Would it be possible to add an image pattern fill option?

var pk = new Piklor(".color-picker", ["#1abc9c" , "line-fill.png"], {open: ".picker-wrapper .btn"});

doc is not showing that you need css style also.

doc is not showing that you need css styling also. only JS and HTML which is wrong.
you need css styling also.

/* picker /
.color-picker {
background: rgba(255, 255, 255, 0.75);
padding: 10px;
border: 1px solid rgba(203, 203, 203, 0.6);
border-radius: 2px;
transition: all 300ms;
border-radius:20px;
position: fixed;
top: -5%;
min-width: 200px;
opacity: 0;
box-shadow: 0px 0px 4px rgba(0, 0, 0, 0.226);
left: 0px;
width: 100%;
z-index: 9999;
}
/
CIRCLE COLORS CSS*/
.color-picker > div {
width: 40px;
display: inline-block;
height: 40px;
margin: 5px;
border-radius: 100%;
opacity: 0.7;

}

.picker-wrapper {
padding: 20px;
}

.color-picker > div:hover {
opacity: 1;
}

Is there a way to open color selector in bootstrap modal?

I like the simplicity of this.

I have multiple bootstrap panels and I'd like to open 1 piklor color picker inside a bootstrap modal to change their individual colors.

Is there a way to easily open color selector in bootstrap modal instead of a div? Or is there a way to auto open piklor found/placed inside a bootstrap modal for color selection?

Example: panel A has a fontawesome color icon, I click it and it opens a bootstrap modal passing a handle from Panel A to the bootstrap modal. Inside the opened modal is an open piklor color selector ready to be used. I click on piklor and panel A's top changes color.

I can create the icon click/modal open event and the modal etc... Just wondering if there's an easy way to have piklor open and ready inside a bootstrap modal?

javascript is not my native tongue. =)

Thanks!

Apologize if I didn't word this correctly. And I didn't want to deconstruct your code. =)

Webpack?

Hi, can I use this plugin with webpack? How?

Thanks

Save to local storage

Is it possible to save the selected colors to local storage?

I mean, when the users chooses yellow the header should remain yellow on page refresh or on the next visit.

Kindly advise,
thanks

Add Color Name to Library and retrieve it

I want to do the following:

  1. Make the colors a 2D library to include the color names.
  2. Color names to be placed in the title tags of the colors.
  3. Retrieve the Color Name when the color is clicked on.

How do I do this? Btw, I love your script! Exactly what I was looking for, however I do not know how to do the above 🤔

Please help! Thanks

Regards,
Dré

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.