Imagem (tipo de controle) no Jitterbit App Builder
Um controle de Imagem exibe uma imagem da biblioteca de imagens unificada do App Builder em um painel da camada de interface de usuário. Esta biblioteca contém tanto fotos que você carrega quanto os conjuntos de ícones integrados do App Builder, então o mesmo controle de Imagem pode exibir uma foto enviada pelo usuário, um logotipo estático ou um dos ícones integrados, dependendo de qual imagem você seleciona e como configura a Finalidade da Imagem.
Adicionar um controle de Imagem
Para adicionar um novo controle de Imagem a um painel, use o diálogo Adicionar um Controle e selecione Imagem como Tipo de Controle:

Converter um controle existente para um controle de Imagem
Para mudar um controle existente para usar o tipo de controle Imagem:
-
Navegue até o controle, usando o Live Designer ou o App Workbench:
-
Na visualização do aplicativo, abra a página que contém o controle e selecione Gaveta de Ações > Live Designer.
-
No App Workbench, abra a guia Páginas, depois no painel Páginas, localize a página que contém o controle e clique duas vezes em sua linha ou clique no ícone Abrir registro. No painel Layout do Painel de Página, encontre o painel que contém o controle e clique em Controles.
-
-
Se estiver no Live Designer, clique no controle na visualização da página; isso preencherá o Live Designer com opções de edição para esse controle. Se estiver no App Workbench, no painel Controles, localize o controle e clique duas vezes em sua linha ou clique no ícone Abrir registro no final de sua linha; o App Builder abre um diálogo semelhante ao do Live Designer.
-
Na guia Propriedades do Controle, defina o campo Tipo de Controle como Imagem.
-
Na guia Imagem, use o campo Imagem para pesquisar e selecionar uma imagem. A lista suspensa inclui tanto fotos enviadas quanto os conjuntos de ícones integrados do App Builder; consulte Categorias de ícones para ver os conjuntos de ícones disponíveis. Se o registro da imagem selecionada tiver uma Imagem Escura vinculada, o controle renderizará automaticamente essa variante escura quando o modo escuro estiver ativo; consulte Imagens de coleção e modo escuro para saber como isso é resolvido.
-
Defina a Finalidade da Imagem como Ícone ou Foto para corresponder ao tipo de imagem que você selecionou. Esta configuração controla apenas como a imagem é renderizada; não filtra quais imagens estão disponíveis para seleção.
-
(Opcional) Defina a Fonte de Badge (Coluna) para um valor de coluna para exibir um badge numérico na imagem. Consulte Badges com botões para obter detalhes.
-
Clique em Salvar.
Atualize a visualização do aplicativo para confirmar a atualização.
Categorias de ícones
Os ícones são organizados por categorias em listas suspensas de seleção, como as presentes no campo Ícone do diálogo Item de Menu ou no campo Imagem em um controle Botão ou Imagem. Conforme você digita no campo de pesquisa da lista suspensa, os ícones correspondentes aparecem em uma lista agrupada sob títulos de categoria que representam diferentes fontes de ícones.
As seguintes categorias estão disponíveis:
| Categoria | Fonte | Descrição |
|---|---|---|
| Brands | Font Awesome Brands | Logotipos de empresas e serviços (por exemplo, youtube, youtube-square). |
| Solid | Font Awesome Solid | O estilo de ícone padrão e preenchido do Font Awesome. |
| Regular | Font Awesome Regular | Uma variante do estilo de ícone Font Awesome com contorno e sem preenchimento. |
| Material Filled | Google Material Icons | Uma variante preenchida do sólido da biblioteca Google Material Icons. |
| Material Rounded | Google Material Icons | Uma variante da biblioteca Google Material Icons com cantos arredondados. |
| Material Sharp | Google Material Icons | Uma variante da biblioteca Google Material Icons com cantos aguçados. |
Nota
O Google distribui sua biblioteca Material Icons como uma fonte com contorno, "Material Icons Outlined." O App Builder aplica um preenchimento a essa fonte e expõe o resultado aqui como Material Filled para se alinhar com o estilo sólido do Font Awesome.
Para mais informações sobre como alternar estilos de ícone em uso, consulte Alterar o preenchimento de um ícone de sólido para regular.
Fazer upload e substituir uma foto
Combine um controle de Imagem com um controle de Arquivo para permitir que os usuários façam upload de uma nova foto que substitua a exibida atualmente. Defina o Propósito da Imagem do controle de Imagem emparelhado como Foto para este caso de uso.
Desativar a variante de imagem escura
Se o registro de uma imagem tiver uma Imagem Escura vinculada, um controle de Imagem que a exiba alterna para a variante escura sempre que o modo escuro está ativo. Para um caso extremo em que um controle específico sempre deve renderizar a imagem exatamente selecionada, como uma lista em que a miniatura ao lado de uma opção deve corresponder à imagem exata dessa opção, adicione um vínculo de parâmetro Desativar Imagem Escura definido como true:
- Abra o Live Designer em uma página que tenha o controle de Imagem.
- Selecione o controle de Imagem para abrir suas propriedades.
- Clique no ícone ao lado de Tipo de Controle para abrir o diálogo Vínculos de Parâmetro.
- Clique em Criar. O diálogo Vínculo de Parâmetro é aberto.
-
Configure o vínculo de parâmetro:
- Parâmetro: Selecione Desativar Imagem Escura.
- Tipo: Selecione Valor Estático.
- Valor: Digite
true.
-
Clique em Salvar. O novo vínculo aparece na grade Vínculos de Parâmetro com sua caixa de seleção Ativo marcada.
App Builder 4.67 e anteriores
No App Builder 4.67 e anteriores, ícones integrados e imagens carregadas são armazenados separadamente, portanto, o comportamento a seguir difere do descrito nesta página:
- Ícones integrados são exibidos usando um tipo de controle de Ícone separado. Para exibir um ícone dinamicamente, passe o nome CSS do ícone (por exemplo,
times-circle-o) para o controle de Ícone. - O campo Imagem nos controles de Imagem, Caixa de Seleção e Lista lista apenas imagens carregadas, não os conjuntos de ícones integrados.
Consulte Categorias de ícone para os conjuntos de ícones disponíveis no App Builder.
