Mostrar o carrinho conforme a equipe adiciona itens e ilumina a entrada mais nova. Dê destaque total, com subtotal, desconto, imposto e gorjeta, depois mostre o prompt de pagamento. Após o cliente pagar, mostre um agradecimento com o número do pedido.
Cartão ao vivo
Categoria: Varejo. Tags: Lojas, Restaurantes e cafés, Preços e tarifas.
Layouts
Este cartão em tela cheia preenche toda a tela em paisagem ou retrato e não é colocado como canto, chip ou faixa.
Layouts: cheio. Formas: paisagem, retrato.
Layouts, temas e publicação de cartões. Veja os cartões.
Dados e privacidade
Este cartão usa suas propriedades configuradas e dados ao vivo do cartão.
Propriedades
Para tema, fundo, destaque e posição, veja Propriedades comuns.
Defina as propriedades estáticas nos params do cartão ao criá-lo. O documento de dados dele contém apenas propriedades dinâmicas. Linhas aninhadas descrevem o conteúdo da propriedade pai.
Propriedades estáticas
| Nome | Tipo | Padrão | Valores e limites | Descrição |
|---|---|---|---|---|
title | string | "Your order" | maxLength: 30 | |
status | string | "open" | "open", "paying", "paid" | aberto mostra o carrinho, pagando adiciona o prompt de pagamento, pago mostra o agradecimento. |
orderNumber | string | "" | maxLength: 12 | |
currency | string | "$" | maxLength: 4 | O símbolo da moeda exibido antes dos valores. |
decimals | integer | 2 | 0, 2 | 0 mostra valores inteiros (para ienes ou won). |
discount | number | 0 | mínimo: 0 | Um desconto no nível do pedido, em unidades principais, além dos descontos por linha. |
discountLabel | string | "" | maxLength: 30 | Nomeia o desconto do pedido, por exemplo, Fidelidade 10%. |
subtotal | number | mínimo: 0 | Substitui a soma das linhas. | |
tax | number | mínimo: 0 | O valor do imposto; a linha de imposto aparece somente quando fornecida. | |
taxLabel | string | "" | maxLength: 20 | |
tip | number | 0 | mínimo: 0 | |
total | number | mínimo: 0 | Substitui o total calculado pelo cartão (subtotal - descontos + imposto + gorjeta). | |
welcome | string | "" | maxLength: 40 | A saudação ociosa. Vazio lê Bem-vindo. |
welcomeNote | string | "" | maxLength: 100 | |
payPrompt | string | "" | maxLength: 50 | Vazio lê Toque, insira ou deslize para pagar. |
thanks | string | "" | maxLength: 40 | Vazio lê Obrigado. |
paidNote | string | "" | maxLength: 100 | Uma linha abaixo do agradecimento, por exemplo, para onde foi o recibo. |
backgroundColor | string, nulo | null | padrão: "^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$" | Substitui o fundo e a placa do cartão por uma cor plana ordenada por CSS. #RRGGBBAA fornece opacidade. background none tem precedência. |
textColor | string, nulo | null | padrão: "^#[0-9A-Fa-f]{6}([0-9A-Fa-f]{2})?$" | Substitui as cores do texto principal e secundário. As cores de destaque e status semântico mantêm seus papéis. |
Propriedades dinâmicas
| Nome | Tipo | Padrão | Valores e limites | Descrição |
|---|---|---|---|---|
lines | array | [] | maxItems: 60 | |
lines[].id | string | "" | maxLength: 40 | Chaveia a linha, para que uma linha já exibida não seja animada novamente. |
lines[].qty | integer | 1 | mínimo: 1; máximo: 999 | |
lines[].name | string | minLength: 1; maxLength: 60; Obrigatório | ||
lines[].mods | string ou array | "" | anyOf: [{"type":"string","maxLength":80},{"type":"array","maxItems":8,"items":{"type":"string","maxLength":30}}] | |
lines[].price | number | 0 | mínimo: 0 | O preço unitário em unidades principais (12,50). Uma linha sem preço e sem desconto lê-se Grátis. |
lines[].discount | number | 0 | mínimo: 0 | Um valor descontado nesta linha, em unidades principais. |
lines[].addedAt | string | "" | maxLength: 40 | Instante ISO em que esta linha foi adicionada; ancora seu slide no Primetime. |
paidAt | string | "" | maxLength: 40 | Instante ISO em que o pagamento foi aprovado; ancora a revelação da verificação Primetime. |
updatedAt | string | "" | maxLength: 40 | Instante ISO da última atualização do carrinho. |
Exemplo de tela
Salve as propriedades estáticas como params.json e crie o cartão. O resultado traz o id crd_ dele.
{
"theme": "neomustard"
}
screenrig card create --type order-confirmation --major 1 --file params.json
Adicione este item aos primitives de uma página da playlist, com esse id no lugar do id do exemplo. Publique a playlist e atribua uma tela.
{
"id": "order-confirmation",
"primitive": "card",
"card": "crd_01EXAMPLECARD000000000",
"layout": "full",
"content_fit": "fill"
}
Escrever dados ao vivo
Escreva o documento no cartão depois de criá-lo e depois substitua-o para atualizar a tela sem republicar. O cartão verifica cada gravação contra suas propriedades dinâmicas e recusa um documento que ele rejeita. Use o mesmo projeto da playlist.
Salve o documento como card-data.json. O CLI lê o documento em si, sem invólucro:
{
"lines": [],
"paidAt": "",
"updatedAt": ""
}
screenrig card data put crd_01EXAMPLECARD000000000 --file card-data.json
Ou chame a API diretamente. A API envolve o mesmo documento em um campo document. Um token de agente já nomeia seu projeto, então nenhum cabeçalho de projeto é enviado; se você enviar ScreenRig-Project, ele deve corresponder ao projeto do token. Forneça sua autorização de API pelo ambiente; veja Autenticação da API.
curl --request PUT "https://api.screenrig.ai/api/cards/crd_01EXAMPLECARD000000000/data" \
--header "Authorization: Bearer $SCREENRIG_TOKEN" \
--header "Content-Type: application/json" \
--data '{"document":{"lines":[],"paidAt":"","updatedAt":""}}'