CrappUIText

Características	Valor
Class	crapp.ui.display.text.CrappUIText
Extends	CrappUIDisplay
Style Tag	CrappUIStyleDefaultTagType.TEXT

Exemplos

<priori>
    <imports>
        <crapp.ui.display.text.CrappUIText />
        <crapp.ui.display.layout.CrappUILayout />
    </imports>
    <view>
        <private:CrappUILayout hLayoutAlignment="CENTER" vLayoutDistribution="SIDE" vLayoutGap="10" left="10" right="10" top="10" bottom="10" >
            <private:CrappUIText />
            <private:CrappUIText text="This is a loooooooong text" />
            <private:CrappUIText id="textStyle" text="This is a text with style" />
            <private:CrappUIText autoSize=":false" width="150" text="This is a loooooooong text with autosize off" />
            <private:CrappUIText autoSize=":false" multiLine=":true" width="150" text="This is a loooooooong text with multiline on" />
            <private:CrappUIText selectable=":true" text="This is a selectable text" />
            <private:CrappUIText editable=":true" text="This is an editable text" />
        </private:CrappUILayout>
    </view>
</priori>

Propriedades do Componente

• id: Permite identificar o elemento para manipulá-lo de forma individual.

• text: Define o conteúdo textual exibido. Se for vazio, exibe um marcador padrão e oculta o rótulo.

• editable: Permite que o componente seja editável. Quando ativado, o campo se torna focável para edição. Cuidado e atenção é recomendada quando utilizar esta propriedade, pois pode gerar possibilidades de injeção de tags e scripts indesejados.

• autoSize: Determina se o componente ajusta automaticamente sua largura com base no conteúdo. Se desativado, utiliza o valor definido manualmente através da propriedade width.

• multiLine: Permite que o texto ocupe múltiplas linhas, ideal para parágrafos ou textos longos.

• selectable: Habilita a seleção do texto, permitindo que o usuário copie o conteúdo.

• align: Configura o alinhamento do texto (esquerda, centro ou direita), utilizando o tipo PriFontStyleAlign.

• weight: Define o peso da fonte, afetando o estilo do texto de acordo com o tipo CrappUIStyleFontWeightType (LIGHTER, LIGHT, NORMAL, BOLD ou BOLDER). Esta propriedade quando definida, terá prioridade sobre o valor que for definido em style.font_weight.

• size: Determina o multiplicador do tipo CrappUISizeReference (TINY, SMALL, UNDER, BASE, EXTRA, LARGE, XLARGE) que será aplicado ao style.size, aumentando ou diminuindo o tamanho do texto.

• isHTML: Indica se o conteúdo textual deve ser interpretado como HTML para renderização, permitindo formatação avançada. Cuidado e atenção é recomendada quando utilizar esta propriedade, pois pode gerar possibilidades de injeção de tags e scripts indesejados.

• hLayoutSize: O parâmetro hLayoutSize pode gerar alguns efeitos automáticos na renderização do texto:

  • FLEX: Define autoSize como false e força a largura do texto a ser igual à largura definida pelo layout do elemento pai, permitindo que o texto se ajuste de forma flexível dentro do espaço disponível, caso o elemento pai esteja configurado para distribuir os elementos filhos.

Efeitos do Estilo

• style.on_color: Define a cor do texto.

• style.font_family: Define qual fonte será utilizada no texto.

• style.font_weight: Define o peso da fonte, afetando o estilo do texto de acordo com o tipo CrappUIStyleFontWeightType (LIGHTER, LIGHT, NORMAL, BOLD ou BOLDER). A propriedade weight, caso definida, terá prioridade em relação a este estilo.