Feedback Imprimir

Rating

Configuração Geral

Este tipo de campo permite que o desenvolvedor crie de forma rápida um campo de avaliação com estrelas (ou alguma outra imagem), onde o usuário final poderá selecionar a classificação de acordo com a escala previamente configurada.

Interface de configuração do campo rating.

Descrição dos atributos disponíveis para configuração.

Tipo do Dado

Define o tipo do campo na aplicação. Neste caso devemos selecionar o tipo Rating

Label

Define o título que será exibido no campo ao executar a aplicação. A terminologia utilizada na interface é fundamental para que seu sistema tenha uma boa usabilidade, devemos utilizar nomes e termos familiares para o usuário final da aplicação, ao invés de utilizarmos termos originados no sistema.

Por exemplo, este campo rating que na tabela possui o nome cmp_rating, o cliente teria um entendimento melhor da funcionalidade do campo ao definirmos a label como Avaliação do Produto.

Alem de um texto fixo, o atributo Label permite a utilização de lang para definir o título do campo, possibilitando assim a internacionalização de sua Aplicação.

Legenda

Define a legenda que será exibida no campo, a baixo das avaliações. Por exemplo: “Agradecemos pelo seu feedback!”.

Assim como a Label, o atributo Legenda também permite utilizarmos lang para a internacionalização de sua Aplicação

Quantidade de Ícones

Define a quantidade de itens que serão exibidos no campo. O valor informado neste atributo deve está de acordo com a forma que a avaliação será realizada.

Para avaliações com estrelas são utilizadas normalmente cinco estrelas, então devemos informar 5 neste atributo. Após informarmos as imagens que serão exibidas nos atributos ícone habilitado e ícone desabilitado o resultado será este:

Campo rating com estrelas

Para utilizarmos Like/Dislike, por exemplo, devemos informar 1 na quantidade de ícones, para que apenas uma imagem seja exibida e alternada de acordo com o clique.

Neste caso, o armazenamento na base de dados será 1 para Like(ícone habilitado) e 0 para dislike(ícone desabilitado) Confira o resultado abaixo de um rating configurado com like/dislike:

Imagem de exemplo com link e Dislike

Ícone Habilitado

Define o ícone que será exibido para a quantidade selecionada. Seguindo o exemplo anterior do Like/Dislike, nesta opção devemos inserir o Like Like.
O mesmo serve para uma avaliação por estrelas, onde por padrão devemos adicionar a estrela preenchida Estrela preenchida

Ícone Desabilitado

Define o ícone que será exibido para a quantidade que não estiver selecionada. Neste atributo devemos adicionar uma imagem que represente o negativo da imagem anterior, ícone habilitado.

Ainda referenciado o exemplo do Like/Dislike, nesta opção deveríamos inserir o Dislike Dislike

Bem como no exemplo das estrelas, devemos adicionar a estrela sem preenchimento Estrela sem preenchimento

Valor Inicial(tipo)

Possibilita a definição de um valor inicial para o campo quando o formulário estiver em modo de inclusão. A única opção disponível para este tipo de campo é Valor Definido. Ao selecionar esta opção, o atributo Valor Inicial será disponibilizado, onde devemos informar o valor inicial do campo.

Por exemplo, meu valor inicial é 3, ao inserir um novo registro, o campo Avaliação do Produto será iniciado com 3 estrelas selecionadas.

O valor definido neste atributo sobrepõe demais valores definidos previamente.

Gravar Variável

Permite gravar uma variável de sessão(variável global) com o valor do campo, para ser utilizado em outras aplicações.

Por exemplo, no formulário de login o nome do usuário pode ser salvo em sessão e exibido no cabeçalho de outras aplicações.

Nome da Variável

Neste atributo devemos definir o nome da variável de sessão, habilitado no item anterior, que receberá o valor do campo.

Devemos informar apenas o nome da variável, - var_rating.
Definir nome da variável

A recuperação do valor é feita em forma de variável global.

Tipo HTML

Objeto HTML usado para exibir o campo no formulário.

Tipo SQL

Informa o tipo do campo no banco de dados.

Configuração da Visualização

Permite definir valores de CSS para o campo individualmente. Desta forma, por exemplo, podemos destacar um campo dos demais na aplicação.
As propriedades CSS do campo, quando alteradas, são adicionadas à uma classe criada automaticamente pelo Scriptcase para cada campo da aplicação.

As configurações individuais do CSS dos campos, quando informadas, sobrepõem as configurações do tema(CSS das Aplicações (Temas)) selecionado para a aplicação.

As configurações de visualização são divididas em três blocos de propriedades, estes blocos são:

CSS do Título

Que possibilita a alteração das propriedades do CSS da Label(Título) do campo.

No exemplo abaixo, podemos visualizar a diferença nas configurações do titulo do campo.
Enquanto os campos Fornecedor e Categoria possuem a mesma formatação, herdada do tema da aplicação, o campo Avaliação do Produto possui uma formatação diferente dos demais, proveniente das alterações realizadas no CSS do campo.

Alteração de CSS da label do campo

CSS do Campo

Que altera as propriedades do CSS da <td> onde o Objeto Input(onde informamos os dados para inserção em um formulário) está posicionado. Na imagem abaixo, podemos visualizar onde as alterações são aplicadas.

Campo com alterações nas propriedades do CSS do Campo, alterando a cor de fundo e o alinhamento horizontal

Campo com alteração no CSS

CSS do Objeto Input

Que altera as propriedades do CSS no Objeto Input do campo, onde digitamos os dados em um formulário.

Campo com alterações nas propriedades do CSS do Objeto Input, alterando a cor de fundo e cor da fonte do input

Campo com alteração no CSS

Propriedades CSS

As opções de configuração disponíveis são basicamente as mesmas para cada um dos blocos de configuração mencionados acima.

Interface de configuração da visualização do titulo no formulário

Descrição dos atributos da configuração disponíveis

Fonte

Altera a fonte do texto de acordo com as fontes selecionadas, utilizando a propriedade font-family.

Nesta opção, disponibilizamos alguns tipos de fontes(conforme imagem abaixo).
Lista de fontes disponíveis na interface de configuração

Tamanho

Altera o tamanho da fonte do texto utilizando a propriedade font-size na classe do campo.

Devemos selecionar o valor disponível em nossa lista, a medida utilizada para esta propriedade é o pixel.

Cor da fonte

Define a cor da fonte utilizado a propriedade color na classe do campo.

Cor de fundo

Define a cor de fundo, utilizado a propriedade background-color na classe do campo.

As cores que serão utilizadas nas duas propriedade de cores listadas acima, Cor da fonte e Cor de fundo, podem ser informadas por meio da paleta de cores - Ícone da paleta de cores - disponível ao lado do campo ou informado manualmente os valores nos formatos aceitos que são: Hexadecimal, RGB, RGBA, HSL, HSLA ou o Nome da Cor.

Paleta de Cores
Ao clicar no ícone da paleta de cores - Ícone da paleta de cores - ao lado do campo, uma janela será aberta com algumas cores predeterminadas.

Ao selecionar uma das cores, será inserido um valor no formato hexadecimal(HEX), que representa a cor escolhida.

Hexadecimal
Sigla para hexadecimal, este código é composto do sinal de cerquilha (#) mais seis dígitos.
Os dois primeiros definem a intensidade da cor vermelha; os dois do meio dizem respeito ao verde e os dois últimos, ao azul.

Representação de cores

Este código é representado por #000000.

Nesse sistema de representação o #000000 representa a cor preta e o #ffffff representa a cor branca.

RGB / RGBA Sigla que representa Vermelho (Red), o Verde (Green) e o Azul (Blue).
Este código é representado por RGB(255,255,255).

Representação de cores

Os três primeiros números definem a intensidade da cor vermelha; os três números do meio dizem respeito ao verde e os três últimos números representam o azul.

HSL / HSLA

Representação de cores

Nome das Cores
Devemos informar o nome da cor que desejamos utilizar. Este nome deve ser informado em inglês e a cor deve está dentro da lista de cores suportadas pelo navegador que iremos utilizar.

Exemplo: Informando nome da cor

Alguns sites disponibilizam uma lista de cores com cada um dos valores citados acima.

especificar as cores de diferêntes maneirasutilizando diferentes maneiras de atribuição de valores

Esta propriedade possibilita

É possível também informar valores diretamente no campo, sem a utilização da nossa paleta de cores.
Esta propriedade permite especificar as cores de diferentes maneiras de se atribuir valores para as propriedades CSS que admitem cores

Negrito

Permite aplicar o tipo negrito na fonte.

Sublinhado

Permite aplicar o tipo sublinhado na fonte.

Estilo da Borda

Define o estilo da fonte.

Collapse da Borda

Define o collapse da borda.

Tamanho da Borda

Permite aumenta o tamanho da borda do título.

Cor da Borda

Permite escolher a cor da borda, utilizando uma paleta de cores para ser aplicada no título.

Alinhamento Horizontal

Permite posicionar o label do filtro no local desejado (left,rigth,center e justify).

Alinhamento Vertical

Permite posicionar o label do fitro no local desejado (baseline, sub, super, top, text-top, middle, bottom, text-bottom).

Não disponível no CSS do Objeto Input

Largura

Para definir a largura do título.

Altura

Para definir a altura do título.

Configuração de Ajuda

Permite que o desenvolvedor adicione instruções e dicas de utilização no campo, permintindo assim que o desenvolvedores auxiliem os usuários no entendimento e na utilização do sistema.

Interface de configuração da ajuda.

Descrição dos atributos da configuração.

Descreva Ajuda

Area destinada a inclusão do texto que será apresentado na aplicação de acordo com o tipo selecionado abaixo.

Tipo do Help

Pop-up - Exibe um ícone padrão ? ao lado do campo. Para exibir a mensagem basta clicar no ícone, um pop-up será exibido contendo o texto.

Interface de configuração do tipo de exibição da ajuda.

Hint - Exibe um ícone padrão ? ao lado do campo. Ao posicionar o mouse sobre o ícome, a mensagem será exibida.

Interface de configuração do tipo de exibição da ajuda.

O ícone exibido ao selecionar os tipos Hint ou Popup variam de acordo com o tema que está sendo utilizado. Este ícone pode ser alterado no [css dos botoes].

Texto - Exibe o texto dentro de um <span></span> ao lado do campo.

Interface de configuração do tipo de exibição da ajuda.

Posição do botão ajuda

Define onde o botão ajuda irá aparecer no campo da aplicação em execução. As opções são:

Ao lado: O ícone de ajuda irá aparecer ao lado do campo. Na coluna: O ícone de ajuda irá aparecer ao lado do label do campo.