Função
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
Na tabela abaixo estão descritas as principais propriedades do componente.
Nome | Propriedade | Função |
|---|---|---|
| Identificador | id | Atributo que especifica um ID exclusivo para o componente. Por padrão um id é gerado automaticamente e atribuído ao componente. |
Valor | ng-model | Propriedade Angular que pode ser usada para obter e alimentar o conteúdo pelo bloco de programação. |
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. |
| 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. |
| Requerido | ng-required | Diretiva que adiciona a propriedade no componente quando o valor da expressão for verdadeiro, especificando que o conteúdo do componente deve ser preenchido. |
| Desabilitado | ng-disabled | Directiva usada para desabilitar um componente quando a expressão vinculada for verdadeira. |
| Valor inicial | ng-initial-value | Define o texto inicial ao carregar o componente. |
| Estilo | style | Atributo usado para estilizar o componente. |
| Exibir | ng-show | Propriedade Angular usada para mostrar ou oculta o componente. |
| Segurança | cronapp-security | Propriedade que apresenta a seleção dos grupos com permissões para visualização ou edição do componente. |
| Classes CSS | class | Adiciona classes CSS que já foram criadas. |
Propriedades complementares
Propriedades do subcomponente textarea
Nem todas propriedades abaixo são nativas do componente, algumas delas sendo necessário inserir através do campo "Nova Propriedade". Para mais detalhes acesse a documentação Componentes visuais.
| 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" e "Não". Essa propriedade também aceita expressões, permitindo por exemplo, bloquear um campo vinculado a um fonte de dados:
|
Subcomponentes
O componente Área de texto é formado por dois subcomponentes agrupados: label e input. Ao clicar no ícone de cadeado da barra de opções (Figura 2), o componente é desbloqueado, permitindo a seleção de seus subcomponentes.
Dica
Consulte o tópico "Acesso aos subcomponentes" da documentação Componentes visuais para mais informações.
Figura 2 - Desagrupar componente para acessar subcomponentes
Nome em inglês
Textarea
Nessa página
Compatibilidade
Formulário web
Equivalente mobile
Botão do Componente
Imagem no Editor Visual
