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.1 - Exemplo de imagem rodando no aplicativo
Principais propriedades
Na tabela abaixo estão descritas as principais propriedades do componente.
Nome
Propriedade
Função
Valor
ng-model
Propriedade AngularJS que pode ser usada para obter e alimentar o conteúdo pelo bloco de programação.
Sugestão
placeholder
Exibe um exemplo de resposta para o usuário quando o campo está vazio.
Linhas
rows
Define a quantidade de linhas que serão visíveis antes de aparecer a barra de rolagem.
Tamanho máximo
maxlength
Define a quantidade máxima de caracteres que o usuário pode inserir.
Identificador
id
Atributo que especifica um ID exclusivo para o componente. Por padrão um id é gerado automaticamente e atribuído ao componente.
Redimensionável
resize
Define se o campo pode ser estendido: somente na vertical, somente na horizontal ou em ambas direções.
Propriedades complementares
Propriedades do subcomponenteinput
As propriedades abaixo não são nativas do componente. Para mais detalhes acesse a documentação Componentes visuais.
Nome
Propriedade
Função
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" 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.