All components · Category: Heroes and buttons
Day and night switch
A switch whose knob turns from sun to moon, with a scene that follows.
The knob morphs from a sun to a moon while a small scene turns from day to a starry night. The mode lives in the component only: nothing is stored and the host page is left alone.
01
Try it
Props
Generated from the component's manifest and the values above.
index.html
<toggle-day-night locale="en"></toggle-day-night>
<script>
const element = document.querySelector("toggle-day-night");
element.addEventListener("toggle-day-night:changed", (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("toggle-day-night");
element.setAttribute("locale", "en");
element.addEventListener("toggle-day-night:changed", (event) => {
console.log(event.detail);
});
document.body.append(element);
- Add the site's Taggor script once; the component appears when it loads.
ToggleDayNight.tsx
import { useEffect, useRef } from "react";
export function ToggleDayNight() {
const ref = useRef<HTMLElement>(null);
useEffect(() => {
const element = ref.current;
if (!element) return;
const onChanged = (event: Event) => {
console.log((event as CustomEvent).detail);
};
element.addEventListener("toggle-day-night:changed", onChanged);
return () => {
element.removeEventListener("toggle-day-night:changed", onChanged);
};
}, []);
return <toggle-day-night 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.
ToggleDayNight.tsx
import { useEffect, useRef } from "react";
export function ToggleDayNight() {
const ref = useRef<HTMLElement>(null);
useEffect(() => {
const element = ref.current;
if (!element) return;
const onChanged = (event: Event) => {
console.log((event as CustomEvent).detail);
};
element.addEventListener("toggle-day-night:changed", onChanged);
return () => {
element.removeEventListener("toggle-day-night:changed", onChanged);
};
}, []);
return <toggle-day-night 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/ToggleDayNight.vue
<script setup lang="ts">
function onChanged(event: Event) {
console.log((event as CustomEvent).detail);
}
</script>
<template>
<toggle-day-night locale="en" @toggle-day-night:changed="onChanged" />
</template>
vite.config.ts
import vue from "@vitejs/plugin-vue";
import { defineConfig } from "vite";
export default defineConfig({
plugins: [
vue({
template: {
compilerOptions: {
isCustomElement: (tag) => tag === "toggle-day-night",
},
},
}),
],
});
- 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/toggle-day-night.component.ts
import { afterNextRender, Component, CUSTOM_ELEMENTS_SCHEMA, DestroyRef, ElementRef, inject } from "@angular/core";
@Component({
selector: "app-toggle-day-night",
schemas: [CUSTOM_ELEMENTS_SCHEMA],
template: `
<toggle-day-night locale="en"></toggle-day-night>
`,
})
export class ToggleDayNightComponent {
constructor() {
const host = inject<ElementRef<HTMLElement>>(ElementRef);
const element = () => host.nativeElement.querySelector("toggle-day-night");
const onChanged = (event: Event) => {
console.log((event as CustomEvent).detail);
};
afterNextRender(() => element()?.addEventListener("toggle-day-night:changed", onChanged));
inject(DestroyRef).onDestroy(() => element()?.removeEventListener("toggle-day-night:changed", onChanged));
}
}
- 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 onChanged(event) {
console.log(event.detail);
}
</script>
<toggle-day-night locale="en" ontoggle-day-night:changed={onChanged}></toggle-day-night>
- 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 publishThe CSS variables the component exposes, set the way a customer's page would.
styles.css
toggle-day-night {
--dn-radius: 20px;
}02
Props
| Prop | Type | Default | What it does |
|---|---|---|---|
| initial | day | night | day | The mode it starts in. |
| locale | pt-BR | en | en | – |
Prop names and descriptions are the component's own, in English, as its author wrote them.
03
Events
| Event | When it fires |
|---|---|
| changed | The mode changed. |
04
Build one with your agent
Paste this into your agent. It asks you before it signs in, pays or goes further than checking and publishing.
Build me a Taggor component like "Day and night switch" (toggle-day-night): A switch whose knob turns from sun to moon, with a scene that follows.
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.
05
Related components
- Hold to confirm button<button-hold-confirm>
- Magnetic button<button-magnetic>
- Morphing drawer menu<nav-drawer-morph>