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 de imagem rodando no aplicativo

Principais propriedades

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

Nome

Propriedade

Função

IdentificadoridAtributo 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.

Redimensionável

resize

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

Desabilitadodisabled

Atributo do tipo booleano, ele é usado para desabilitar o componente.

Desabilitar seng-disabled

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

Repetircrn-repeatPropriedade que seleciona uma fonte de dados contida na tela e repete o componente baseado no número de itens dessa fonte de dados.
Requeridong-requiredDiretiva que adiciona a propriedade no componente quando o valor da expressão for verdadeiro, especificando que o conteúdo do componente deve ser preenchido.
Skincrn-skinPermite selecionar um skin que afetará apenas o componente selecionado.
Valor inicialng-initial-valueDefine o texto inicial ao carregar o componente.
EstilostyleAtributo usado para estilizar o componente.
Exibirng-showPropriedade Angular usada para mostrar ou oculta o componente.
Segurançacronapp-securityPropriedade que apresenta a seleção dos grupos com permissões para visualização ou edição do componente.
Classes CSSclassAdiciona classes CSS que já foram criadas.

Propriedades complementares

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.

NomePropriedadeFunçã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ínimominlength

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 leiturang-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:

  • "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.

Nome em inglês

Textarea


Nessa página


Compatibilidade

  • Formulário mobile


Equivalente web

Área de texto


Botão do Componente


Imagem no Editor Visual