Pular para o conteúdo

Editor visual

O portal pode montar um template para você. Você coloca blocos numa página, preenche com texto e campos, e o editor escreve o HTML e a sintaxe de template por trás. O que aparece na página é o que o serviço gera.

Um template é visual ou código. O template visual guarda o desenho, e o editor reescreve o código a partir dele a cada mudança. O template em código é HTML puro, que você edita à mão.

A janela Novo template oferece duas formas de começar:

  • Página em branco ou Código, sem nada dentro.
  • Um template pronto da galeria, que você então altera: uma fatura, um orçamento, um certificado em página retrato, um certificado em página paisagem e uma fatura escrita em HTML.

Os templates prontos vêm com dados de exemplo no idioma do portal, então já mostram um documento completo. São os mesmos documentos dos exemplos da página inicial.

A aba Blocos adiciona as peças da página. Clique para adicionar no fim, ou arraste um bloco para a página, ou para a lista, no lugar que quiser. Selecione um bloco para alterá-lo na direita.

Bloco O que é
Título Um título, em três tamanhos.
Texto Um parágrafo, com tamanho, peso, cor e alinhamento.
Lista Marcadores ou números, escritos à mão ou repetidos para cada item de uma lista dos seus dados.
Imagem Uma imagem enviada, ou uma cujo endereço é um campo dos seus dados.
Detalhes Pares de rótulo e valor.
Tabela Colunas e linhas, escritas à mão ou repetidas para cada item de uma lista.
QR / código de barras Um QR code ou um código de barras Code 128 de um texto ou de um campo.
Colunas Blocos lado a lado, com uma largura para cada coluna.
Linha Um filete atravessando a página.
Espaço Altura vazia.
Quebra de página Começa uma nova página.

A lista abaixo da paleta, Na página, mostra os blocos em ordem. Arraste um bloco da página, ou uma linha da lista, para colocá-lo em outro lugar.

Um texto ou um título tem a sua própria fonte, escolhida na lista de famílias do Google Fonts, cada uma desenhada com as próprias letras, e também aceita um estilo: letras maiúsculas, espaçamento entre letras, uma linha acima, abaixo ou à esquerda, e o espaço ao redor.

Em qualquer lugar em que você digita texto, pode inserir um campo que lê dos seus dados, como {{ customer.name }}. A aba Dados guarda o JSON de exemplo com que a página é desenhada, para o editor mostrar valores reais enquanto você trabalha. Os mesmos nomes são os que você envia em data ao gerar o template.

Um campo pode ser formatado com currency, number ou date, como em {{ total | currency }}. A moeda é a definida na página, ou o valor de um campo dos seus dados quando a página indica um, então um só template atende várias moedas. O idioma da geração decide como o valor é escrito; um texto pode ter um idioma próprio, para uma data ou um valor que deve ser lido de outro jeito. Veja Idiomas e formatação.

Campos que os dados de exemplo não têm aparecem em vermelho, para que um erro de digitação seja fácil de ver.

Uma tabela pode tirar suas linhas de uma lista dos seus dados. Escolha a lista, por exemplo items, e escreva o que cada coluna mostra com item, como em {{ item.name }} e {{ item.amount | currency }}. Uma coluna também pode ter uma segunda linha menor, como uma descrição sob um nome. A tabela pode terminar com uma linha de total, e os cabeçalhos podem ser ocultados ou desenhados em versalete.

Qualquer bloco pode ser mostrado só quando um campo tem valor, está vazio, é igual ou diferente de um texto, ou é maior ou menor que um número. Um texto é comparado como está escrito, então o número 5 e o texto “5” são iguais; um número é comparado como número, também quando os seus dados o escrevem como texto. No canvas, um bloco deixado de fora pela condição aparece como uma nota tracejada, para que você ainda possa selecioná-lo.

Um bloco com palavras, imagem, detalhes ou colunas também pode ser escrito uma vez para cada item de uma lista. Dentro dele, item é o item. Uma tabela ou lista dentro dele pode ler uma lista que o item tem, como item.lines, e outer é o item do bloco que se repete.

Ligue Mover livremente e arraste qualquer bloco para qualquer lugar da página. Ele vira uma caixa com posição e largura, com uma alça na borda direita para a largura e os números nas configurações, e Voltar ao fluxo o devolve à ordem. Os blocos do fluxo fecham o espaço que ele deixa. Um bloco colocado assim fica só na primeira página.

Enquanto você move, linhas tracejadas mostram o que se alinha com as bordas e o meio das outras coisas e da área que o conteúdo ocupa, e o espaço até as coisas mais próximas é desenhado com o tamanho em milímetros. Segure Alt, Ctrl ou Cmd para mover sem alinhar. Os botões Réguas e Grade acrescentam réguas em centímetros ao longo da página e uma grade de cinco milímetros em que o que você move encaixa.

Shift+clique soma uma coisa ao que está selecionado, e Ctrl+A seleciona tudo. O que se faz com uma, faz-se com todas: apagar, copiar, bloquear, ocultar. Quando as coisas estão colocadas por posição, as configurações também oferecem alinhá-las à esquerda, ao centro ou à direita, ao topo, ao meio ou embaixo, distribuir três ou mais com espaços iguais e agrupá-las, para que sejam selecionadas e movidas como uma só. Uma coisa sozinha alinha com a página.

Tecla O que faz
Delete Apaga o que está selecionado.
Ctrl+D Copia ao lado do original.
Setas Movem o que está colocado por posição de um milímetro, dez com Shift; nos blocos do fluxo, cima e baixo mudam a ordem.
Ctrl+C, Ctrl+X, Ctrl+V Copiar, recortar e colar, também em outro template.
Ctrl+Z, Ctrl+Shift+Z Desfazer e refazer.
Esc Tira a seleção.
Ctrl+S Salva.

Um bloco ou item bloqueado pode ser selecionado, mas não movido nem alterado no canvas, e um oculto fica fora do documento. O cadeado e o olho estão nas configurações, e as listas mostram uma marca.

Salve o visual de um texto como um estilo com nome: tamanho, peso, cor, fonte, espaçamento e o resto. Dê-o a outro texto pela lista das configurações dele, e quando você mudar um texto que tem o estilo, pode atualizar o estilo, o que atualiza todos os textos que o têm. Desvincular o estilo de um texto mantém o visual dele, e apagar o estilo também. A aba Página lista os estilos.

O bloco QR / código de barras guarda um texto com campos, como https://example.com/pay/{{ number }}, e o desenha como QR code ou como código de barras Code 128, com o tamanho e, no QR code, o nível de correção de erros. O código é feito quando o documento é, a partir dos dados desse documento, em formas vetoriais, então fica nítido. Um QR code guarda até 1000 bytes de texto; um código de barras guarda até 80 letras, dígitos e pontuação, sem acentos. Um campo é usado como está, e um campo ausente não desenha código.

A aba Página define o tamanho (A4 ou Carta), a orientação, a margem, as fontes, o tamanho do texto, as cores, a moeda e o estilo de data. A numeração de páginas fica desligada até você pedir.

A aba Formas coloca textos, caixas e imagens por posição na primeira página, sobre ou sob os blocos. Arraste um item na página para movê-lo. Use para uma faixa de cor, uma moldura ou um logotipo; os blocos continuam fluindo a partir do topo da página.

Validar mostra o que o gerador não conseguiu atender. Pré-visualizar gera o documento com o serviço de verdade. A pré-visualização é gratuita e limitada, e cada página dela leva a marca PREVIEW - NOT FOR USE na margem superior: mostra como o documento ficará, e não é um documento para entregar. Uma geração feita pela API é cobrada e não tem marca.

Salve o template e depois gere-o pelo id. Sair com alterações não salvas pergunta antes.

A cada vez que você salva, a versão que o template tinha é guardada, até as últimas trinta. O botão Histórico as lista com a data. Abrir uma a coloca no editor como uma alteração não salva: você pode ver, mudar, desfazer e salvar para que ocupe o lugar do template.

Código mostra o HTML que os blocos produzem, somente leitura. Para alterá-lo à mão, escolha Só código. O template deixa de ser visual e o desenho é descartado, e isso não pode ser desfeito.

O editor escreve o que o serviço gera, então tem os mesmos limites de qualquer template; veja HTML e CSS suportados. Uma caixa das formas é um retângulo, de cantos retos, e o que é colocado por posição fica na primeira página. Para lógica além de uma condição sobre um campo e uma repetição sobre uma lista, escreva o template em código.