All components · Category: Galleries and media

Lightbox grid

A grid of pictures that opens a lightbox with zoom and drag.

Pick a picture and it opens large inside the component, with zoom buttons, double click to zoom and dragging when zoomed. The keyboard works the way a real dialog should: focus moves in and stays in, Escape closes and gives the focus back, arrows turn the pages. The pictures are SVG drawn in code.

Try it

<lightbox-grid>

ViewPreviewCodeCSS

lightbox-grid: A grid of pictures that opens a lightbox with zoom and drag. A picture of the real component, drawn from its own code. The controls change the picture and the code beside it; nothing here is sent or stored.

Generated from the component's manifest and the values above.

index.html

<lightbox-grid locale="en"></lightbox-grid>

<script>
  const element = document.querySelector("lightbox-grid");
  element.addEventListener("lightbox-grid:open", (event) => {
    console.log(event.detail);
  });
</script>

Add the site's Taggor script once; the component appears when it loads.

taggor-component.js

const element = document.createElement("lightbox-grid");
element.setAttribute("locale", "en");
element.addEventListener("lightbox-grid:open", (event) => {
  console.log(event.detail);
});
document.body.append(element);

Add the site's Taggor script once; the component appears when it loads.

LightboxGrid.tsx

import { useEffect, useRef } from "react";

export function LightboxGrid() {
  const ref = useRef<HTMLElement>(null);

  useEffect(() => {
    const element = ref.current;
    if (!element) return;
    const onOpen = (event: Event) => {
      console.log((event as CustomEvent).detail);
    };
    element.addEventListener("lightbox-grid:open", onOpen);
    return () => {
      element.removeEventListener("lightbox-grid:open", onOpen);
    };
  }, []);

  return <lightbox-grid ref={ref} locale="en" />;
}

Add the site's Taggor script once; the component appears when it loads.
React 18 sends every prop of a custom element as a text attribute.
The event is heard with addEventListener, inside an effect.

LightboxGrid.tsx

import { useEffect, useRef } from "react";

export function LightboxGrid() {
  const ref = useRef<HTMLElement>(null);

  useEffect(() => {
    const element = ref.current;
    if (!element) return;
    const onOpen = (event: Event) => {
      console.log((event as CustomEvent).detail);
    };
    element.addEventListener("lightbox-grid:open", onOpen);
    return () => {
      element.removeEventListener("lightbox-grid:open", onOpen);
    };
  }, []);

  return <lightbox-grid ref={ref} locale="en" />;
}

Add the site's Taggor script once; the component appears when it loads.
React 19 sets a property when the element already has it, an attribute otherwise.
The event is heard with addEventListener, inside an effect.

src/LightboxGrid.vue

<script setup lang="ts">
function onOpen(event: Event) {
  console.log((event as CustomEvent).detail);
}
</script>

<template>
  <lightbox-grid locale="en" @lightbox-grid:open="onOpen" />
</template>

vite.config.ts

import vue from "@vitejs/plugin-vue";
import { defineConfig } from "vite";

export default defineConfig({
  plugins: [
    vue({
      template: {
        compilerOptions: {
          isCustomElement: (tag) => tag === "lightbox-grid",
        },
      },
    }),
  ],
});

Add the site's Taggor script once; the component appears when it loads.
vite.config.ts tells Vue that this tag is not a Vue component.

src/app/lightbox-grid.component.ts

import { afterNextRender, Component, CUSTOM_ELEMENTS_SCHEMA, DestroyRef, ElementRef, inject } from "@angular/core";

@Component({
  selector: "app-lightbox-grid",
  schemas: [CUSTOM_ELEMENTS_SCHEMA],
  template: `
    <lightbox-grid locale="en"></lightbox-grid>
  `,
})
export class LightboxGridComponent {
  constructor() {
    const host = inject<ElementRef<HTMLElement>>(ElementRef);
    const element = () => host.nativeElement.querySelector("lightbox-grid");
    const onOpen = (event: Event) => {
      console.log((event as CustomEvent).detail);
    };
    afterNextRender(() => element()?.addEventListener("lightbox-grid:open", onOpen));
    inject(DestroyRef).onDestroy(() => element()?.removeEventListener("lightbox-grid:open", onOpen));
  }
}

Add the site's Taggor script once; the component appears when it loads.
The component declares CUSTOM_ELEMENTS_SCHEMA.
The event is heard with addEventListener, inside an effect.

src/TaggorComponent.svelte

<script>
  function onOpen(event) {
    console.log(event.detail);
  }
</script>

<lightbox-grid locale="en" onlightbox-grid:open={onOpen}></lightbox-grid>

Add the site's Taggor script once; the component appears when it loads.

How an agent gets a component like this onto a site:

taggor checktaggor publish

The CSS variables the component exposes, set the way a customer's page would.

styles.css

lightbox-grid {
  --lg-radius: 14px;
}

Props

Props of the component, read from its manifest
Prop	Type	Default	What it does
pictures	list	none	The pictures: a caption, a scene (dunes, peaks, sun, waves, bubbles) and a hue.
locale	pt-BR \| en	en	–

Prop names and descriptions are the component's own, in English, as its author wrote them.

Events

Events of the component, read from its manifest
Event	When it fires
open	A picture opened in the lightbox.

Build one with your agent

Build me a Taggor component like "Lightbox grid" (lightbox-grid): A grid of pictures that opens a lightbox with zoom and drag. Fetch https://taggor.dev/agent-setup/prompt.md and follow its instructions to set me up for Taggor. Ask me before you sign in, create an account, accept terms, pay for anything or type a secret. Check it with `taggor check` and publish it with `taggor publish`, and stop there. Do not promote it to production, attach it to a site, roll back anything or use --yes, --force or --force-drop-invalid unless I ask for exactly that in this conversation.

Related components

Masonry filter<masonry-filter>
Polaroid wall<polaroid-wall>
Card carousel<card-carousel>