Área de texto (web)

Área de texto (web)

Esse componente adiciona uma caixa de texto que aceita diversas linhas, bastante utilizado quando existe a necessidade de criar um texto longo, como comentário.

Figura 1 - Exemplo do componente rodando no browser

Principais propriedades

Aba de Propriedades

Na tabela abaixo estão descritas as principais propriedades do componente.

Nome

Propriedade

Função

Nome

Propriedade

Função

Título

content

Define o rótulo para o componente.

Sugestão

placeholder

Atributo do tipo texto, ele especifica uma dica sobre o conteúdo que deve ser inserido no componente.

Quantidade de linhas

rows

Define a quantidade de linhas que serão visíveis antes de aparecer a barra de rolagem.

Máximo de caracteres

maxlength

Define a quantidade máxima de caracteres que o usuário pode inserir.

Redimensionável

resize

Define se o campo pode ser estendido: somente na vertical, somente na horizontal ou em ambas direções.

Texto quando requerido

validationMessage

Exibe a mensagem informada ao tentar submeter o formulário com o campo vazio. A propriedade Requerido (ng-required) deve estar configurada com "sim". 

Desabilitado

ng-disabled

Directiva usada para desabilitar um componente quando a expressão vinculada for verdadeira.

Valor

ng-model

Propriedade Cronapp MVC que pode ser usada para obter e alimentar o conteúdo pelo bloco de programação.

Identificador

id

Atributo que especifica um ID exclusivo para o componente. Por padrão um id é gerado automaticamente e atribuído ao componente.

Tooltip

crn-tooltip

Permite adicionar um tooltip ao componente. Para configurá-lo, clique no botão (...) ao lado do campo. Para mais detalhes, acesse o tópico tooltip da documentação Propriedades dos componentes visuais.

Estilo

style

Atributo usado para estilizar o componente.

Exibir

ng-show

Propriedade Cronapp MVC usada para mostrar ou oculta o componente.

Repetir

crn-repeat

Propriedade que seleciona uma fonte de dados contida na tela e repete o componente baseado no número de itens dessa fonte de dados.

Segurança

cronapp-security

Propriedade que apresenta a seleção dos grupos com permissões para visualização ou edição do componente.

Skin

crn-skin

Permite selecionar um skin que afetará apenas o componente selecionado.

Classes CSS

class

Adiciona classes CSS que já foram criadas.

Propriedades complementares

As propriedades abaixo não são nativas do componente. Para adicionar essas ou outras propriedades, será necessário selecionar o subcomponente textarea, desagrupando o componente principal. e inserindo, na propriedade Nova propriedade, uma das propriedades abaixo, como mostra a figura 2.

Nome

Propriedade

Função

Nome

Propriedade

Função

Tamanho máximo

maxlength

Define o número máximo de caracteres aceito no campo.

Algumas máscaras possuem caracteres que ocupam espaços, dessa forma, ao informar o número máximo de caracteres nesta propriedade, leve em consideração a quantidade de caracteres utilizados pela máscara.
Ex,: Um CPF possui 11 dígitos, porém mais 3 caracteres são exibidos ao utilizar a máscara CPF (2 "." e 1 "-"). Sendo necessário informar o valor 14 nessa propriedade.

Tamanho mínimo

minlength

Define o número mínimo de caracteres aceito no campo. A linha do campo ficará em vermelho até que o usuário digite o mínimo de caracteres necessários.

Algumas máscaras possuem caracteres que ocupam espaços, dessa forma, ao informar o número mínimo de caracteres nesta propriedade, leve em consideração a quantidade de caracteres utilizados pela máscara.
Ex.: Um CPF possui 11 dígitos, porém mais 3 caracteres são exibidos ao utilizar a máscara CPF (2 "." e 1 "-"). Sendo necessário informar o valor 14 nessa propriedade.

Apenas leitura

ng-readonly

Bloqueia edições no campo e exibe seu conteúdo apenas para leitura. Por padrão, possui as opções "Sim" (true) e "Não" (false). 

Essa propriedade também aceita expressões, permitindo por exemplo, bloquear um campo vinculado a um fonte de dados:

  • "datasource.editing" para bloquear o campo quando a fonte de dados estiver em modo de edição ou

  • "datasource.editing || datasource.inserting" para bloquear o campo quando a fonte de dados estiver em modo de edição ou inserção.

 

Aba de Eventos

Na tabela abaixo estão descritos os tipos de eventos disponíveis para o componente Área de texto.

Nome

Propriedade

Função

Nome

Propriedade

Função

Ao Iniciar

ng-init

Executa uma ação assim que o componente é renderizado na tela.

Ao Clicar

ng-click

Executa uma ação quando o componente receber um clique com o mouse ou um toque na tela.

Ao Duplo Clicar

ng-dblclick

Executa uma ação quando o usuário clica duas vezes seguidas com o botão do mouse em um componente.

Apertar Tecla

ng-keydown

Executa uma ação assim que uma tecla é acionada no teclado.

Ao Soltar Tecla

ng-keyup

Executa uma ação ao soltar uma tecla do teclado.

Ao Focar

ng-focus

Executa uma ação assim que o componente é focado.

Ao Sair do Foco

ng-blur

Executa uma ação assim que o componente sai de foco.

Ao Entrar com Mouse

ng-mouseenter

Executa uma ação quando o ponteiro do mouse é movido de fora para dentro do elemento.

Ao Sair com Mouse

ng-mouseleave

Executa uma ação quando o ponteiro do mouse é movido de dentro para fora do elemento.

Evento de Copiar

ng-copy

Executa uma ação assim que o elemento é copiado do componente.

Ao Colar

ng-paste

Executa uma ação assim que o elemento é colado no componente.

 

Aba de Estilos

Na tabela abaixo estão descritos os tipos de estilos disponíveis para o componente Área de texto.

Nome em português

Nome em inglês

Descrição

Nome em português

Nome em inglês

Descrição

Área de Texto Geral

Input

Estiliza o conteúdo que será inserido no componente.

Sugestão

Placeholder

Estiliza a sugestão do componente.

Subcomponentes

O componente Área de texto é formado por dois subcomponentes agrupados: label e textarea. Ao clicar no ícone de cadeado da barra de opções (Figura 2), o componente é desbloqueado, permitindo a seleção de seus subcomponentes. Para inserir uma das propriedades mostradas na tabela anterior, acesse a propriedade Nova propriedade (destaque 1 da figura 2).

Dica

Consulte o tópico "Acesso aos subcomponentes" da documentação Componentes visuais para mais informações.

Figura 2 - Desagrupar componente para acessar seus subcomponentes

Nome em inglês

Textarea


Nessa página


Compatibilidade

  • Formulário web


Equivalente mobile

Área de texto (mobile)


Botão do Componente

Imagem no Editor Visual