Ir para o conteúdo

Modelo HTML de Barra de Progresso

Modelos HTML podem ser usados para obter muitos tipos diferentes de elementos UI/UX em um aplicativo. Este artigo apresenta uma visão geral do uso de um Modelo HTML para apresentar uma Barra de Progresso na camada UI do aplicativo de um aplicativo.

Uma barra de progresso

Para Criar o Modelo HTML

  1. Navegue até o App Workbench
  2. Clique na aba Look & Feel
  3. Clique na aba Modelos
  4. Confirme se a Coleção selecionada é onde você deseja adicionar o modelo HTML
  5. Clique no botão +Modelo
  6. Atribua um Nome. Por exemplo: Barra de progresso
  7. Marque para habilitar Traduções se aplicável
  8. Clique no ícone de marca de seleção para salvar
  9. Insira a sintaxe HTML na região da aba Source. Veja o exemplo de sintaxe HTML.
  10. Clique em Salvar
  11. Clique em +Parâmetro e defina os Parâmetros necessários. Veja Parâmetros de Modelo.

Exemplo de Sintaxe HTML

<style>
.progress-ecd {
    width: 100%;
    height: 80px;
}
.progress-ecd .hdr span {
    float: right;
}
.progress-ecd .bar {
    position: relative;
    height: 20px;
    background-color: #ccc;
    border-radius: 3px;
}
.progress-ecd .bar .percent {
    color: {{TextoCor}};
    background-color: {{CorBg}};
    width: calc({{Porcentagem}} - 25%);
    height: 20px;
    border-radius: 3px;
    padding-left: 3px;
    max-width: 100%;
}
.progress-ecd .bar .ref {
    position: absolute;
    left: 75%;
    top: 0;
    width: 2px;
    height: 20px;
    background-color: #737373;
}
.progress-ecd .bar .ref:before {
    content: attr(data-ref);
    font-weight: 300;
    position: absolute;
    width: 100px;
    left: -50px;
    top: 100%;
    color: #888;
    text-align: center;
}
</style>
<div>
<div class="progress-ecd" style="margin-bottom:20px;">
    <div style="font-size: 16px; font-weight:500; height: 20px; margin-bottom: 4px;">{{Título}}`</div>
    <div class="hdr" style="font-weight: 200; margin-bottom: 8px;">{{Legenda}}<span style="font-weight: 500; ">{{Porcentagem}}</span></div>
    <div class="bar">
        <div class="percent">{{Valor}}`</div>
        <div class="ref" data-ref="{{Limite}}"></div>
    </div>
</div>
</div>

Parâmetros do Modelo

A seguinte lista de Parâmetros deve ser configurada se você estiver usando uma Barra de Progresso como um Modelo HTML:

  • TextColor
  • BgColor
  • Title
  • Subtitle
  • Percent
  • Value
  • Limit

Personalização de Cores para o Parâmetro "limite"

Opcionalmente, você pode escolher personalizar as cores usadas pela Barra de Progresso para ajudar a indicar visualmente se um valor está abaixo ou acima do parâmetro "Limite" definido. Alterar a cor se ele ultrapassar o limite ajuda a visualizar que um limite importante foi ultrapassado. Por exemplo, alterar a cor para vermelho se um orçamento for excedido e, caso contrário, mostrá-lo como verde. Para conseguir isso, você pode definir a lógica da instrução IIF (veja o exemplo) no Objeto de Negócios subjacente do painel, convertê-la como string para o tipo de dados lógicos e, em seguida, passá-la como BgColor no modelo. Esta sintaxe de exemplo ilustra a instrução IIF usada no Objeto de Negócios:

IIF(Value >= Limit, '#Color1', '#Color2')

Nota

As cores definidas na declaração IIF devem representar valores de código de cor hexadecimal válidos. Por exemplo: #ff0000

Limitações e Chamadas

Se você estiver usando mais de uma Barra de Progresso em uma única página ou painel com várias linhas como um Tile, todas as Barras de Progresso herdarão os estilos da última instância por padrão. Isso ocorre porque o TextColor, BgColor, e Percent valores são substituídos na definição de estilo da classe. Para superar essa limitação, você pode colocar esses estilos em linha, e as Barras de Progresso se comportarão como esperado quando tiverem valores diferentes.

Exemplo de estilo em linha:

<div class="percent" style="font-size: 16px; width: calc({{Porcentagem}} - 25%); color: {{TextoCor}}; background-color: {{CorBg}};">{{Valor}}

`