Vai colocar a roleta em uma transmissão ao vivo? Leia o guia de roleta no OBS

Adicione uma roleta ao seu site

Digite as entradas, escolha como os visitantes usam a roleta e copie um trecho de código. Funciona em qualquer página https que aceite HTML, sem conta, plugin ou taxa.

Vai criar roletas no seu servidor? Use a API para desenvolvedores do ChoiceSpin para salvar roletas, criar links jogáveis e controlar giros incorporados.

Configure sua roleta

Adicione as entradas, escolha os controles e confira a prévia.

1 Entradas
De 2 a 100 entradas, até 80 caracteres cada 4 / 100
2 Controles do visitante
3 Aparência
Fundo
Cores da roleta
5 segundos
Título da roleta

Prévia interativa

Esta é a roleta que seus visitantes vão usar. Teste um giro.

Interativa

Roleta do ChoiceSpin

4 entradas · Clique para girar Abrir a roleta em uma página própria

Copie o código para seu site

Cole este código em um bloco HTML ou de incorporação. A roleta se ajusta ao tamanho da sua página.

As entradas ficam no código, não nos nossos servidores. Quem vê o código-fonte da página pode lê-las. Não inclua nomes privados, senhas ou dados de contas.

Como incorporar uma roleta

Em três passos, a roleta estará na sua página. Você pode voltar e mudá-la quando quiser.

  1. 01

    Adicione suas entradas

    Digite de 2 a 100 entradas acima, uma por linha. Escolha os controles, as cores e a duração do giro.

  2. 02

    Gire a prévia

    A prévia usa a mesma roleta que os visitantes recebem. Um giro de teste aqui mostra como ela vai funcionar na sua página.

  3. 03

    Cole o código

    Copie o trecho para um bloco de HTML ou incorporação na sua página e publique como de costume.

Onde colar o código

A maioria dos criadores de sites tem um bloco para HTML ou código de incorporação, mas o nome varia. Em uma página que você programa, cole o trecho dentro de <body>, onde a roleta deve aparecer. Não é preciso adicionar script, folha de estilos ou chave de API.

WordPress

  1. No editor de blocos, digite /html e escolha o bloco Custom HTML, de HTML personalizado.
  2. Cole o código e atualize ou publique a página.

No editor clássico, cole na aba Text. O WordPress mantém o código de incorporação apenas para usuários autorizados a publicar HTML sem filtragem, normalmente administradores e editores. No WordPress.com, é preciso ter um plano pago com os recursos de hospedagem ativados.

Google Sites

  1. Clique em Insert, depois em Embed e na aba Embed code.
  2. Cole o código, clique em Next e depois em Insert.
  3. Arraste as bordas da caixa até mostrar a roleta inteira e clique em Publish.

Wix

  1. Clique em Add Elements, depois em Embed Code e em Embed HTML.
  2. Clique no novo elemento, escolha Enter Code, cole e clique em Apply.
  3. Arraste as bordas do elemento até a roleta caber.

No Wix Studio, o mesmo elemento fica em Add Elements, depois Embed & Social e Embed Code.

Squarespace

  1. Clique em Add block, escolha Code e clique no ícone de lápis.
  2. Cole o código, selecione HTML e deixe Display Source desativado.

O código de incorporação funciona nos planos Core, Plus e Advanced e nos antigos Business e Commerce, mas não no Basic. Se a roleta não aparecer enquanto você está conectado, confira a página com Preview in Safe Mode.

Webflow

  1. Abra o painel Add e arraste um elemento Code Embed para a página.
  2. Cole o código e clique em Save & Close.

Code Embed exige um plano Workspace ou Site pago.

Shopify

  1. Vá a Online Store, depois Pages, e abra uma página.
  2. Clique em Show HTML na barra do editor, cole o código e clique em Save.

Para colocar a roleta em uma seção do tema, abra Edit theme, clique em Add section e escolha Custom Liquid.

Notion

  1. Troque a saída acima para URL direta e copie o link.
  2. No Notion, digite /embed, escolha Embed link e cole o link.

O Notion aceita apenas links, então colar o código de incorporação não funciona nele.

Canvas LMS

  1. No Rich Content Editor, escolha Insert e depois Embed.
  2. Cole o código em Embed Code e clique em Submit.

Se a escola ativou a política de segurança de conteúdo do Canvas, um administrador talvez precise adicionar choicespin.com aos domínios permitidos.

Moodle

  1. Em um recurso Page ou bloco HTML, abra o menu Tools do editor e escolha Source code.
  2. Cole o código e salve.

As publicações em fóruns removem o código de incorporação. Isso também acontece em todas as áreas de sites com Content cleaning everywhere ativado.

Se o plano remove códigos de incorporação ou a ferramenta só aceita links, troque a saída acima para URL direta. Como link ou botão, ela abre a mesma roleta em uma página própria.

Como usar a roleta no Google Slides ou PowerPoint

Aplicativos de apresentação não executam código de incorporação, então o caminho confiável é um link. Um clique durante a apresentação abre a roleta em uma aba do navegador, pronta para girar.

Google Slides

Selecione um texto no slide, escolha Insert e depois Link, ou use Ctrl+K, ou ⌘+K no Mac. Cole a URL direta. Durante a apresentação, clique no link para abrir a roleta, gire e volte aos slides.

PowerPoint

Selecione um texto ou forma, pressione Ctrl+K, ou ⌘+K no Mac, e cole a URL direta. Clique durante a apresentação para abrir a roleta no navegador. A Microsoft descontinuou o suplemento gratuito Web Viewer em dezembro de 2024. Suplementos pagos de outras empresas podem exibir páginas da web em um slide, mas não os testamos.

Mude o tamanho

O código ocupa sua coluna de conteúdo até 760 pixels de largura, com altura que acompanha a largura.

Deixe mais estreita

Troque max-width:760px na primeira linha por uma largura menor, como 480px. A roleta diminui junto e continua centralizada.

Mantenha a leitura fácil no celular

O valor min-height impede que o quadro fique baixo demais em telas estreitas: 460 pixels para a roleta simples, 560 com o botão Girar a roleta e 760 quando os visitantes podem editar. Mantenha esse valor.

Criadores de sites que colocam a incorporação em uma caixa

No Wix, Google Sites e criadores parecidos, o código fica em uma caixa redimensionável. Arraste até a roleta inteira e a linha de crédito aparecerem sem barra de rolagem.

O que os visitantes recebem

A incorporação usa a mesma roleta do ChoiceSpin, dentro de um quadro próprio.

Um giro imparcial

Cada entrada tem a mesma chance em cada giro. Em navegadores modernos, números aleatórios do Web Crypto escolhem o vencedor. Veja como a roleta escolhe.

Teclado e leitores de tela

Os visitantes podem focar a roleta e pressionar Espaço ou Enter para girar. Leitores de tela anunciam cada resultado quando ele aparece.

Sem cookies ou rastreamento

O quadro é isolado: não pode definir cookies nem salvar dados no navegador. Ele não carrega anúncios ou ferramentas de análise.

Uma página leve

O código pede ao navegador que carregue a roleta só quando o visitante rolar para perto dela. Assim, o topo da página continua rápido.

Controle a roleta com JavaScript

O código copiado funciona sozinho. Se você programa sua página, também pode iniciar giros, mudar entradas e ler cada vencedor por mensagens entre janelas, sem reduzir o isolamento do quadro.

Inicie um giro e leia o vencedor

Adicione <button id="spin-from-page" type="button" disabled>Spin</button> à página e coloque este script após o código de incorporação. A roleta ignora comandos até enviar ready; por isso, o botão fica desativado até lá.

const frame = document.querySelector('iframe[src^="https://choicespin.com/e"]');
const spinButton = document.querySelector("#spin-from-page");

// Every message carries the same channel and version.
function send(action, extra = {}) {
  frame.contentWindow.postMessage(
    { channel: "choicespin.embed", version: 1, action, ...extra },
    "*"
  );
}

window.addEventListener("message", (event) => {
  if (event.source !== frame.contentWindow || event.origin !== "null") return;
  const data = event.data;
  if (data?.channel !== "choicespin.embed" || data?.version !== 1) return;
  if (data.event === "ready") spinButton.disabled = false;
  if (data.event === "spin-end") console.log("Winner:", data.winner);
});

spinButton.addEventListener("click", () => send("spin"));

Ações que você pode enviar

  • spin inicia um giro
  • setEntries substitui as entradas por um array entries de 2 a 100 strings
  • addEntry adiciona uma string entry
  • removeWinner remove o último vencedor
  • reset restaura as entradas do código

Eventos que você recebe

ready, spin-start, spin-end com winner e index, entries-changed e error. Cada evento também informa count, a contagem atual de entradas.

Três regras importantes

Envie mensagens com "*" como destino, pois um quadro isolado não tem uma origem que você possa indicar. A mensagem ainda vai apenas para aquele quadro. Quando uma mensagem volta, sua origem é "null"; confie nela somente se event.source também for a janela do quadro. A roleta escuta apenas a página que a incorpora e responde a comandos malformados com um evento error. Mantenha os atributos gerados sandbox e referrerpolicy: os comandos comuns precisam da origem da página principal obtida pelo referenciador. Se uma recarga remover esse referenciador, o auxiliar para desenvolvedores opcional pode reconectar por uma negociação validada com a página principal HTTPS real.

Se a roleta não aparecer

A maioria dos problemas vem do lugar em que o código foi colado. Confira estes pontos primeiro.

O código aparece como texto

Ele foi colado em um bloco de texto comum. Apague e cole em um bloco de HTML, código ou incorporação.

Uma caixa vazia

A roleta só carrega em páginas servidas por https. Se o endereço começa com http ou o plano remove código de incorporação, use a URL direta como link.

A roleta está cortada

A caixa da incorporação está baixa demais. Aumente a altura até mostrar a roleta, os botões e a linha de crédito. Só o quadro precisa de pelo menos 460 pixels, 560 com o botão Girar a roleta e 760 quando visitantes podem editar. A linha de crédito acrescenta cerca de 30.

Sem som

Confira se Tocar um som ao terminar está marcado. Navegadores só permitem som depois que o visitante clica ou pressiona uma tecla dentro do quadro. Um giro iniciado pelo seu código antes disso fica sem som.

Perguntas frequentes

Respostas curtas antes de adicionar a roleta a uma página pública.

A roleta incorporada é gratuita?

Sim. Não custa nada, não exige cadastro e o mesmo código pode ser usado em quantas páginas você quiser.

Como mudo a roleta depois de colocá-la no site?

Para uma roleta feita neste criador, monte a nova versão aqui e substitua o código antigo na sua página. As entradas ficam no próprio código, então não há conta nem cópia salva para atualizar. Roletas criadas no servidor pela API têm registros salvos separados.

Os visitantes podem mudar minha roleta?

Somente a própria cópia. Com Permitir que visitantes editem, eles podem digitar novas entradas. O botão Remover vencedor ou a opção Remover cada vencedor tira os vencedores. Essas mudanças não alteram sua roleta original nem a cópia de outra pessoa. Recarregar traz suas entradas de volta.

A roleta incorporada usa cookies ou rastreia visitantes?

Não. Ela funciona em um quadro isolado que não pode definir cookies nem armazenar dados no navegador e não carrega anúncios ou ferramentas de análise. Nas roletas deste criador, as entradas fazem parte do código e podem ser lidas por quem vê o código-fonte da sua página. As versões criadas pela API ficam no servidor e podem ser lidas por qualquer pessoa com o link.

Quantas entradas uma roleta incorporada aceita?

De 2 a 100 entradas com até 80 caracteres cada. Como elas ficam no link, todas juntas podem usar cerca de 3.900 caracteres, ou menos em sistemas de escrita como o japonês. Para listas maiores, pesos ou resultados salvos, use a roleta completa do ChoiceSpin, que aceita até 2.000 entradas.

A roleta incorporada funciona no celular?

Sim. Ela ocupa a largura da coluna de conteúdo e nunca fica com menos de 460 pixels de altura, para manter os nomes legíveis em telas pequenas. Os visitantes giram com um toque.

Posso remover o crédito do ChoiceSpin?

Sim. Desmarque Mostrar link de crédito do ChoiceSpin antes de copiar ou apague a linha de crédito do código depois. A roleta funciona da mesma forma.

A página da roleta vai aparecer no Google no lugar da minha?

Não. A página que mostra só a roleta está marcada como noindex para ficar fora dos resultados de busca. A visibilidade da sua página depende do conteúdo e das configurações dela.

Precisa de mais de 100 entradas?

A roleta completa aceita até 2.000 entradas, com pesos, imagens, roletas salvas e histórico de resultados. Professores encontram ideias de atividades no guia para professores.

Abrir a roleta completa