Á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 |
|---|---|---|
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 |
|---|---|---|
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. |
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. |
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:
|
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 |
|---|---|---|
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 |
|---|---|---|
Á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
Botão do Componente
Imagem no Editor Visual