Todos os componentes · Categoria: Mapas e lugares
Rota que se desenha
Uma rota que se desenha sobre um mapa estilizado, parada a parada.
Uma linha suave se desenha pelas suas paradas com um ponto surgindo em cada uma, e um botão desenha de novo. As paradas também aparecem como texto para leitores de tela. Com movimento reduzido, a rota pronta já está lá.
01
Experimente
Props
Gerado a partir do manifesto do componente e dos valores acima.
index.html
<route-draw seconds="4" locale="en"></route-draw>
<script>
const element = document.querySelector("route-draw");
element.addEventListener("route-draw:replay", (event) => {
console.log(event.detail);
});
</script>
- Adicione o script do Taggor do site uma vez; o componente aparece quando ele carrega.
taggor-component.js
const element = document.createElement("route-draw");
element.setAttribute("seconds", "4");
element.setAttribute("locale", "en");
element.addEventListener("route-draw:replay", (event) => {
console.log(event.detail);
});
document.body.append(element);
- Adicione o script do Taggor do site uma vez; o componente aparece quando ele carrega.
RouteDraw.tsx
import { useEffect, useRef } from "react";
export function RouteDraw() {
const ref = useRef<HTMLElement>(null);
useEffect(() => {
const element = ref.current;
if (!element) return;
const onReplay = (event: Event) => {
console.log((event as CustomEvent).detail);
};
element.addEventListener("route-draw:replay", onReplay);
return () => {
element.removeEventListener("route-draw:replay", onReplay);
};
}, []);
return <route-draw ref={ref} seconds="4" locale="en" />;
}
- Adicione o script do Taggor do site uma vez; o componente aparece quando ele carrega.
- O React 18 manda toda prop de um custom element como atributo de texto.
- O evento é ouvido com addEventListener, dentro de um efeito.
RouteDraw.tsx
import { useEffect, useRef } from "react";
export function RouteDraw() {
const ref = useRef<HTMLElement>(null);
useEffect(() => {
const element = ref.current;
if (!element) return;
const onReplay = (event: Event) => {
console.log((event as CustomEvent).detail);
};
element.addEventListener("route-draw:replay", onReplay);
return () => {
element.removeEventListener("route-draw:replay", onReplay);
};
}, []);
return <route-draw ref={ref} seconds={4} locale="en" />;
}
- Adicione o script do Taggor do site uma vez; o componente aparece quando ele carrega.
- O React 19 define uma propriedade quando o elemento já a tem e um atributo no resto.
- O evento é ouvido com addEventListener, dentro de um efeito.
src/RouteDraw.vue
<script setup lang="ts">
function onReplay(event: Event) {
console.log((event as CustomEvent).detail);
}
</script>
<template>
<route-draw :seconds.prop="4" locale="en" @route-draw:replay="onReplay" />
</template>
vite.config.ts
import vue from "@vitejs/plugin-vue";
import { defineConfig } from "vite";
export default defineConfig({
plugins: [
vue({
template: {
compilerOptions: {
isCustomElement: (tag) => tag === "route-draw",
},
},
}),
],
});
- Adicione o script do Taggor do site uma vez; o componente aparece quando ele carrega.
- O vite.config.ts avisa o Vue de que esta tag não é um componente Vue.
src/app/route-draw.component.ts
import { afterNextRender, Component, CUSTOM_ELEMENTS_SCHEMA, DestroyRef, ElementRef, inject } from "@angular/core";
@Component({
selector: "app-route-draw",
schemas: [CUSTOM_ELEMENTS_SCHEMA],
template: `
<route-draw [seconds]="4" locale="en"></route-draw>
`,
})
export class RouteDrawComponent {
constructor() {
const host = inject<ElementRef<HTMLElement>>(ElementRef);
const element = () => host.nativeElement.querySelector("route-draw");
const onReplay = (event: Event) => {
console.log((event as CustomEvent).detail);
};
afterNextRender(() => element()?.addEventListener("route-draw:replay", onReplay));
inject(DestroyRef).onDestroy(() => element()?.removeEventListener("route-draw:replay", onReplay));
}
}
- Adicione o script do Taggor do site uma vez; o componente aparece quando ele carrega.
- O componente declara CUSTOM_ELEMENTS_SCHEMA.
- O evento é ouvido com addEventListener, dentro de um efeito.
src/TaggorComponent.svelte
<script>
function onReplay(event) {
console.log(event.detail);
}
</script>
<route-draw seconds={4} locale="en" onroute-draw:replay={onReplay}></route-draw>
- Adicione o script do Taggor do site uma vez; o componente aparece quando ele carrega.
Como um agente leva um componente assim a um site:
taggor checktaggor publishAs variáveis CSS que o componente expõe, definidas como a página de um cliente faria.
styles.css
route-draw {
--rd-radius: 16px;
}02
Props
| Prop | Tipo | Padrão | O que faz |
|---|---|---|---|
| stops | list | nenhum | The stops in order: a name and x and y as percentages of the map. |
| seconds | number 1 to 12 | 4 | How long the route takes to draw, in seconds. |
| hideSample | boolean | false | Hides the Sample content mark (use it with your own stops). |
| locale | pt-BR | en | en | – |
Os nomes e as descrições das props são os do próprio componente, em inglês, como o autor escreveu.
03
Eventos
| Evento | Quando dispara |
|---|---|
| replay | The visitor asked to draw the route again. |
04
Construa um com o seu agente
Cole no seu agente. Ele pergunta a você antes de entrar na conta, pagar ou ir além de verificar e publicar.
Construa para mim um componente do Taggor como "Rota que se desenha" (route-draw): Uma rota que se desenha sobre um mapa estilizado, parada a parada.
Busque https://taggor.dev/agent-setup/prompt.md e siga as instruções de lá para me configurar para o Taggor. Pergunte-me antes de entrar na conta, criar uma conta, aceitar termos, pagar qualquer coisa ou digitar um segredo.
Verifique com `taggor check` e publique com `taggor publish`, e pare por aí.
Não promova para produção, não anexe a um site, não faça rollback nem use --yes, --force ou --force-drop-invalid, a menos que eu peça exatamente isso nesta conversa.
05
Componentes relacionados
- Localizador de lojas<store-locator>
- Seletor de regiões<region-picker>
- Horário de contato<contact-hours>