Vais pôr uma roleta numa transmissão em direto? Lê o guia da roleta no OBS

Incorpora uma roleta no teu site

Escreve as tuas opções, escolhe como os visitantes usam a roleta e copia um único bloco de código. Funciona em qualquer página https que aceite HTML, sem conta, plugin nem custos.

Vais criar roletas a partir do teu servidor? Usa a API para programadores do ChoiceSpin para guardar roletas, criar ligações onde se pode girar a roleta e controlar as voltas das roletas incorporadas.

Configura a tua roleta

Adiciona as opções, escolhe os controlos e confirma a pré-visualização.

1 Opções
2 a 100 opções, até 80 carateres cada 4 / 100
2 Controlos dos visitantes
3 Aparência
Fundo
Cores da roleta
5 segundos
Título da roleta

Pré-visualização em tempo real

Esta é a roleta que os teus visitantes vão usar. Experimenta girá-la.

Interativo

Roleta do ChoiceSpin

4 opções · Clica para girar Abrir a roleta numa página própria

Copia o código para o teu site

Cola isto num bloco HTML ou de incorporação. A roleta ajusta-se ao tamanho da tua página.

As tuas opções ficam guardadas dentro do código, não nos nossos servidores. Qualquer pessoa que veja o código-fonte da tua página consegue lê-las, por isso não incluas nomes privados, palavras-passe nem dados de contas.

Como incorporar uma roleta

Três passos e a roleta fica a funcionar na tua página. Podes voltar e alterá-la quando quiseres.

  1. 01

    Adiciona as tuas opções

    Escreve no campo acima entre 2 e 100 opções, uma por linha. Escolhe os controlos, as cores e a duração da volta.

  2. 02

    Gira a pré-visualização

    A pré-visualização usa a mesma roleta que os teus visitantes vão ter, por isso uma volta de teste aqui mostra como vai funcionar na tua página.

  3. 03

    Cola o código

    Copia o código para um bloco HTML ou de incorporação na tua página e depois publica a página como de costume.

Onde colar o código

A maioria dos criadores de sites tem um bloco para HTML ou para código de incorporação, mas cada um lhe dá um nome diferente. Numa página que tu próprio escreves, cola o código dentro de <body>, no sítio onde a roleta deve aparecer. Não há nenhuma tag de script, folha de estilos nem chave de API para adicionar.

WordPress

  1. No editor de blocos, escreve /html e escolhe o bloco HTML personalizado.
  2. Cola o código e depois atualiza ou publica a página.

No editor clássico, cola-o no separador Texto. O WordPress só mantém o código de incorporação de utilizadores com permissão para publicar HTML sem filtro, normalmente Administradores e Editores. No WordPress.com, é preciso um plano pago com as funcionalidades de alojamento ativadas.

Google Sites

  1. Clica em Inserir, depois em Incorporar e depois no separador Incorporar código.
  2. Cola o código, clica em Seguinte e depois em Inserir.
  3. Arrasta os limites da caixa até a roleta aparecer inteira e depois clica em Publicar.

Wix

  1. Clica em Add Elements, depois em Embed Code e depois em Embed HTML.
  2. Clica no novo elemento, escolhe Enter Code, cola o código e clica em Apply.
  3. Arrasta os limites do elemento até a roleta caber.

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

Squarespace

  1. Clica em Add block, escolhe Code e depois clica no ícone do lápis.
  2. Cola o código, define-o como HTML e deixa Display Source desativado.

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

Webflow

  1. Abre o painel Add e arrasta um elemento Code Embed para a página.
  2. Cola o código e clica em Save & Close.

O Code Embed exige um plano pago de Workspace ou de Site.

Shopify

  1. Vai a Online Store, depois a Pages, e abre uma página.
  2. Clica em Show HTML na barra de ferramentas do editor, cola o código e clica em Save.

Para pôr a roleta numa secção do tema, abre Edit theme, clica em Add section e escolhe Custom Liquid.

Notion

  1. Acima, muda para URL direto e copia a ligação.
  2. No Notion, escreve /embed, escolhe Embed link e cola a ligação.

O Notion só aceita ligações, por isso colar o código de incorporação não funciona aí.

Canvas LMS

  1. No Rich Content Editor, escolhe Insert e depois Embed.
  2. Cola o código em Embed Code e clica em Submit.

Se a tua escola tiver ativado a política de segurança de conteúdos do Canvas, um administrador pode ter de adicionar choicespin.com aos domínios permitidos.

Moodle

  1. Num recurso Página ou num bloco HTML, abre o menu Ferramentas do editor e escolhe Código-fonte.
  2. Cola o código e guarda.

As publicações nos fóruns removem o código de incorporação, tal como todas as áreas em sites com a definição Content cleaning everywhere ativada.

Quando um plano remove o código de incorporação, ou uma ferramenta só aceita ligações, muda acima para URL direto. Colado como ligação ou como botão, abre a mesma roleta numa página própria.

Usar a roleta no Google Slides ou no PowerPoint

As aplicações de apresentações não executam código de incorporação, por isso o método fiável é uma ligação. Um clique durante a apresentação abre a roleta num separador do navegador, pronta a girar.

Google Slides

Seleciona algum texto num diapositivo, escolhe Inserir e depois Link (Ctrl+K, ou ⌘+K num Mac) e cola o URL direto. No modo de apresentação, clica na ligação para abrir a roleta, gira-a e volta aos teus diapositivos.

PowerPoint

Seleciona texto ou uma forma, prime Ctrl+K (⌘+K num Mac) e cola o URL direto. Clica na ligação durante a apresentação para abrir a roleta no navegador. A Microsoft retirou o suplemento gratuito Web Viewer em dezembro de 2024. Há suplementos pagos de outras empresas que mostram páginas web dentro de um diapositivo, mas não os testámos.

Alterar o tamanho

O código ocupa a coluna de conteúdo até 760 píxeis de largura, e a altura acompanha a largura.

Torná-la mais estreita

Muda max-width:760px na primeira linha para uma largura menor, como 480px. A roleta encolhe com ela e fica centrada.

Mantê-la legível em telemóveis

O valor min-height impede que o iframe fique demasiado baixo em ecrãs estreitos: 460 píxeis para uma roleta simples, 560 com o botão Girar e 760 quando os visitantes podem editar. Não o retires.

Criadores de sites que põem uma caixa à volta do código incorporado

No Wix, no Google Sites e em criadores semelhantes, o código fica dentro de uma caixa que podes redimensionar. Arrasta a caixa até a roleta inteira e a linha da menção aparecerem sem barra de deslocamento.

O que os teus visitantes recebem

A roleta incorporada é a mesma do próprio ChoiceSpin, dentro do seu próprio iframe.

Uma volta justa

Todas as opções têm a mesma probabilidade em cada volta. Nos navegadores modernos, o vencedor é escolhido com números aleatórios da Web Crypto. Vê como a roleta escolhe.

Teclado e leitores de ecrã

Os visitantes podem colocar o foco na roleta e premir a barra de espaço ou Enter para girar. Os leitores de ecrã anunciam cada resultado assim que sai.

Sem cookies nem rastreio

O iframe está isolado (sandbox), por isso não pode criar cookies nem guardar nada no navegador. Não carrega anúncios nem ferramentas de análise.

Uma página leve

O código pede ao navegador que só carregue a roleta quando um visitante se aproxima dela ao percorrer a página, por isso o topo da tua página continua rápido.

Controlar a roleta com JavaScript

O código copiado funciona sozinho. Se escreveres o código da tua página, também podes iniciar voltas, alterar opções e ler cada vencedor através de mensagens entre janelas, sem aliviar as restrições de sandbox do iframe.

Iniciar uma volta e ler o vencedor

Adiciona <button id="spin-from-page" type="button" disabled>Spin</button> à tua página e coloca este script depois do código de incorporação. A roleta ignora os 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 podes enviar

  • spin inicia uma volta
  • setEntries substitui as opções por um array entries com 2 a 100 strings
  • addEntry adiciona uma string entry
  • removeWinner remove o último vencedor
  • reset repõe as opções do código

Eventos que recebes

ready, spin-start, spin-end com winner e index, entries-changed e error. Cada um indica também o número atual de opções no campo count.

Três regras a conhecer

Envia as mensagens com "*" como destino, porque um iframe isolado não tem uma origem que possas indicar. A mensagem continua a ir apenas para esse iframe. Quando chega uma mensagem de volta, a origem aparece como "null", por isso só confies nela quando event.source for também a janela do iframe. A roleta só ouve a página que a incorpora e responde a um comando malformado com um evento error. Mantém os atributos sandbox e referrerpolicy gerados tal como estão: os comandos normais precisam da origem da página-mãe obtida a partir do referrer. Se um recarregamento remover esse referrer, o auxiliar para programadores opcional pode restabelecer a ligação através de um handshake validado com a verdadeira página-mãe em HTTPS.

Se a roleta não aparecer

A maioria dos problemas vem do sítio onde o código foi colado. Verifica primeiro estes pontos.

O código aparece como texto

Foi colado num bloco de texto normal. Apaga-o e, em vez disso, cola-o num bloco HTML, de código ou de incorporação.

Uma caixa vazia

A roleta só carrega em páginas servidas por https. Se o endereço da tua página começar por http, ou se o teu plano remover o código de incorporação, usa o URL direto como ligação.

A roleta aparece cortada

A caixa de incorporação é demasiado baixa. Arrasta-a para a tornar mais alta até aparecerem a roleta, os botões e a linha da menção. Só o iframe precisa de pelo menos 460 píxeis, 560 com o botão Girar e 760 quando os visitantes podem editar. A linha da menção acrescenta cerca de 30.

Sem som

Confirma que Reproduzir um som no fim está marcado. Os navegadores só permitem som depois de o visitante clicar ou premir uma tecla dentro do iframe, por isso uma volta iniciada pelo teu próprio código antes disso fica em silêncio.

Perguntas frequentes

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

A roleta incorporada é gratuita?

Sim. Não custa nada, não exige registo e podes pôr o mesmo código em quantas páginas quiseres.

Como altero a roleta depois de a incorporar?

Numa roleta feita neste gerador, cria aqui a nova versão e substitui o código antigo na tua página. As opções ficam guardadas dentro do próprio código, por isso não há conta nem cópia guardada para atualizar. As roletas criadas no servidor através da API têm registos guardados à parte.

Os visitantes podem alterar a minha roleta?

Só a cópia deles. Com Permitir que os visitantes editem, podem escrever novas opções, e o botão Remover vencedor ou a definição Remover cada vencedor retira os vencedores. As alterações deles não mudam a tua roleta original nem a cópia de mais ninguém, e ao recarregar a página voltam as tuas opções.

A roleta incorporada usa cookies ou rastreia os visitantes?

Não. A roleta funciona num iframe isolado (sandbox) que não pode criar cookies nem guardar nada no navegador, e não carrega anúncios nem ferramentas de análise. Nas roletas criadas com este gerador, as opções fazem parte do código, por isso qualquer pessoa que veja o código-fonte da tua página consegue lê-las. As cópias criadas através da API ficam guardadas no servidor e qualquer pessoa com a respetiva ligação consegue lê-las.

Quantas opções pode ter uma roleta incorporada?

De 2 a 100 opções, com até 80 carateres cada. Como as opções viajam dentro da ligação, no total podem ocupar cerca de 3900 carateres, ou menos em sistemas de escrita como o japonês. Para listas maiores, pesos ou resultados guardados, usa a roleta completa do ChoiceSpin, que aceita até 2000 opções.

A roleta incorporada funciona em telemóveis?

Sim. Ocupa a largura da coluna de conteúdo e nunca fica com menos de 460 píxeis de altura, por isso os rótulos continuam legíveis em ecrãs pequenos. Os visitantes giram-na com um toque.

Posso remover a menção ao ChoiceSpin?

Sim. Desmarca Mostrar uma menção ao ChoiceSpin antes de copiares o código, ou apaga depois a linha da menção no código. A roleta funciona da mesma forma em ambos os casos.

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

Não. A página que só mostra a roleta está marcada como noindex, por isso fica fora dos resultados de pesquisa. A visibilidade da tua página nas pesquisas depende do conteúdo e das definições dela.

Precisas de mais de 100 opções?

A roleta completa aceita até 2000 opções, com pesos, imagens, roletas guardadas e um histórico de resultados. Os professores encontram ideias para a sala de aula no guia para professores.

Abrir a roleta completa