Color Picker

Tier 2: Light-DOM

Modern color canvas with native EyeDropper API integration and format sync

Installation

$npx nnui add color-picker

copy

Interactive Preview & Code

Selected Hex: #6366f1

<ui-color-picker id="demo-color" value="#6366f1" name="brand-color">
              <div data-part="swatch"></div>
              <div data-part="popover">
                <div style="display: flex; align-items: center; gap: 0.5rem;">
                  <input data-part="hex-input" data-ui="input" style="width: 110px; font-family: monospace;" />
                  <button data-part="eyedropper-btn" type="button" class="ui-button ui-button--secondary" style="padding: 0.4rem 0.6rem;" title="Pick color from screen">🔍</button>
                </div>
                <input data-part="hue-slider" type="range" min="0" max="360" value="240" style="width: 100%; margin-top: 0.5rem;" />
              </div>
            </ui-color-picker>

            <div data-ui="card" style="padding: 1rem 1.5rem; width: 100%; max-width: 400px; text-align: center; font-size: 0.85rem; color: var(--ui-text-secondary);">
              Selected Hex: <code id="color-hex-display" style="color: var(--ui-color-brand-500); font-weight: 600;">#6366f1</code>
            </div>

import React, { useState } from 'react';
import 'nnui-kit'; // Registers universal Light-DOM elements

export default function ColorpickerDemo() {
  const [tab, setTab] = useState('all');
  const [val, setVal] = useState(50);
  const [selected, setSelected] = useState('');
  const [query, setQuery] = useState('');

  return (
    <ui-color-picker id="demo-color" value="#6366f1" name="brand-color">
                  <div data-part="swatch"></div>
                  <div data-part="popover">
                    <div style="display: flex; align-items: center; gap: 0.5rem;">
                      <input data-part="hex-input" data-ui="input" style="width: 110px; font-family: monospace;" />
                      <button data-part="eyedropper-btn" type="button" className="ui-button ui-button--secondary" style="padding: 0.4rem 0.6rem;" title="Pick color from screen">🔍</button>
                    </div>
                    <input data-part="hue-slider" type="range" min="0" max="360" value="240" style="width: 100%; margin-top: 0.5rem;" />
                  </div>
                </ui-color-picker>

                <div data-ui="card" style="padding: 1rem 1.5rem; width: 100%; max-width: 400px; text-align: center; font-size: 0.85rem; color: var(--ui-text-secondary);">
                  Selected Hex: <code id="color-hex-display" style="color: var(--ui-color-brand-500); font-weight: 600;">#6366f1</code>
                </div>
  );
}

<script setup>
import { ref } from 'vue';
import 'nnui-kit'; // Registers universal Light-DOM elements

const activeTab = ref('all');
const sliderValue = ref(50);
const selected = ref('');
const query = ref('');

const handleSelect = (val) => {
  console.log('Selected:', val);
};
</script>

<template>
  <ui-color-picker id="demo-color" value="#6366f1" name="brand-color">
                <div data-part="swatch"></div>
                <div data-part="popover">
                  <div style="display: flex; align-items: center; gap: 0.5rem;">
                    <input data-part="hex-input" data-ui="input" style="width: 110px; font-family: monospace;" />
                    <button data-part="eyedropper-btn" type="button" class="ui-button ui-button--secondary" style="padding: 0.4rem 0.6rem;" title="Pick color from screen">🔍</button>
                  </div>
                  <input data-part="hue-slider" type="range" min="0" max="360" value="240" style="width: 100%; margin-top: 0.5rem;" />
                </div>
              </ui-color-picker>

              <div data-ui="card" style="padding: 1rem 1.5rem; width: 100%; max-width: 400px; text-align: center; font-size: 0.85rem; color: var(--ui-text-secondary);">
                Selected Hex: <code id="color-hex-display" style="color: var(--ui-color-brand-500); font-weight: 600;">#6366f1</code>
              </div>
</template>

<script>
  import 'nnui-kit';

  let activeTab = $state('all');
  let sliderValue = $state(50);
  let selected = $state('');
</script>

<ui-color-picker id="demo-color" value="#6366f1" name="brand-color">
              <div data-part="swatch"></div>
              <div data-part="popover">
                <div style="display: flex; align-items: center; gap: 0.5rem;">
                  <input data-part="hex-input" data-ui="input" style="width: 110px; font-family: monospace;" />
                  <button data-part="eyedropper-btn" type="button" class="ui-button ui-button--secondary" style="padding: 0.4rem 0.6rem;" title="Pick color from screen">🔍</button>
                </div>
                <input data-part="hue-slider" type="range" min="0" max="360" value="240" style="width: 100%; margin-top: 0.5rem;" />
              </div>
            </ui-color-picker>

            <div data-ui="card" style="padding: 1rem 1.5rem; width: 100%; max-width: 400px; text-align: center; font-size: 0.85rem; color: var(--ui-text-secondary);">
              Selected Hex: <code id="color-hex-display" style="color: var(--ui-color-brand-500); font-weight: 600;">#6366f1</code>
            </div>

How to Utilize

NNUI-KIT components live directly in the document Light DOM. You can use them via declarative HTML, with our first-class React wrapper, or platform-natively in Svelte, Vue, Astro, and HTMX:

React 18 & 19 (Next.js 15 App Router)

import 'nnui-kit/css';
import 'nnui-kit/client';
import { ColorPicker } from 'nnui-kit/react';

Universal Web Components (Vue 3, Svelte 5, Astro, HTMX)

<!-- Automatically registers <ui-color-picker> and <nnui-color-picker> -->
import 'nnui-kit/css';
import 'nnui-kit/client';

Platform Features

Zero Shadow DOM

Element lives in the Light DOM. Tailwind and global CSS apply directly.

persist="url | local"

Add declarative persistence attribute to auto-sync state with URL search params.

sync="cross-tab"

Synchronize changes across all open browser tabs via BroadcastChannel.