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 descritos descritas as principais propriedades (Figura 2) para o funcionamento básico do componente.
Nome | Propriedade | Função | Conteúdo||||
|---|---|---|---|---|---|---|
| Título | content | Título que será exibido acima do componente. | 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. | ||||
Valorvalor | ng-model | Propriedade AngularJS Angular que pode ser usada para obter e alimentar seu o conteúdo pelo bloco de programação.identificador | ||||
| Identificador | id | Atributo que especifica um ID exclusivo para o componente. Por padrão um id é gerado automaticamente e atribuído ao componente. | ||||
| Estilo | style | Atributo usado para estilizar o componente. | ||||
| Exibir | ng-show | Propriedade Angular 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.Linhas | ||||
| Segurança | rows | Define a altura do campo de texto por número de linhas, caso o texto ultrapasse esse número, uma barra de rolagens é exibida. | Redimensionável | resize | Define se o campo pode ser estendido: somente na vertical, somente na horizontal ou em ambas direções.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 Estilos
Na tabela abaixo estão descritos os tipos de estilos disponíveis para o componente Área de texto com.
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. |
| Âncora | ||||
|---|---|---|---|---|
|
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).
| Informações | ||
|---|---|---|
| ||
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
| Índice | ||||
|---|---|---|---|---|
|
Compatibilidade
Formulário web
Equivalente mobileO link será adicionado no final, após todos os componentes criados.
Botão do Componente
Imagem no Editor Visual
