Controle do editor de rich text no Power Apps

Permitir que os usuários formatem texto em uma área de edição WYSIWYG. O formato de saída é HTML.

Description

O controle editor rich text permite que o usuário do aplicativo formate texto em uma área de edição WYSIWYG.

O formato de entrada e saída é HTML, mas o controle não é um editor HTML. O editor remove o script, o estilo, o objeto e os atributos e elementos HTML sem suporte.

Os recursos com suporte incluem:

• Negrito, itálico e sublinhado
• Cor de texto e realce
• Tamanho do texto
• Listas numeradas e com marcadores
• Hyperlinks
• Limpar formatação

Para usar o controle em um formulário, selecione o cartão Editar texto de várias linhas e personalize-o inserindo o controle RTE.

Principais propriedades

Padrão – propriedade de entrada para o valor de texto inicial mostrado no editor

HtmlText – Propriedade de saída para o rich text resultante no formato HTML

Propriedades adicionais

AccessibleLabel — rótulo para leitores de tela. Deve descrever a finalidade dos anexos.

DisplayMode – se o controle permite adicionar e excluir arquivos (Editar), mostra apenas dados (Exibição) ou está desabilitado (Desabilitado).

EnableSpellCheck – Se o verificador ortográfico do navegador está habilitado. Esse recurso verifica apenas a ortografia no idioma padrão do navegador. O Power Apps para Windows não suporta esta propriedade.

Altura – a distância da borda superior do controle até a borda inferior.

TabIndex – ordem de navegação do teclado em relação a outros controles.

Visível – se um controle está visível ou oculto.

Largura – a distância da borda esquerda do controle até a borda direita.

X – a distância da borda esquerda do controle até a borda esquerda do contêiner pai ou a tela se não houver nenhum contêiner pai.

Y – A distância da borda superior do controle até a borda superior de seu contêiner pai ou a tela se não houver nenhum contêiner pai.

Diretrizes de acessibilidade

Suporte ao leitor de tela

• Verifique se AccessibleLabel está presente.

Suporte de teclado

• Defina TabIndex como zero ou maior para que os usuários de teclado possam navegar até ele.

Limitações

A aparência não é garantida ao trabalhar com outros produtos

Quando você usa o rich text em diferentes produtos, ele pode não ter a mesma aparência.

• Você pode colar rich text de páginas da Web, Microsoft Word e outros aplicativos. No entanto, a aparência pode ser diferente dependendo dos recursos do dispositivo, navegador e origem externa.
• Da mesma forma, se você criar um texto rico fora dos aplicativos canvas, ele poderá parecer ligeiramente diferente porque os estilos internos do outro aplicativo não estão presentes.
• Se você inserir o aplicativo de tela em outro aplicativo, o aplicativo host poderá substituir os estilos do rich text. Por exemplo, quando você usa um aplicativo canvas como uma página personalizada em um aplicativo baseado em modelos, o aplicativo host remove estilos de lista. As listas com marcadores não mostram pontos de marcador em uma página personalizada.

Às vezes, talvez você queira que o rich text seja exibido de forma diferente com base no local em que ele é mostrado. Por exemplo, a fonte primária pode ser diferente em outro produto ou a cor do texto pode mudar quando o usuário habilita o modo escuro. Para uma exibição consistente, componha e mostre rich text somente em aplicativos de tela.

As imagens coladas podem não aparecer consistentemente

Uma imagem colada pode aparecer em um navegador, mas não em um aplicativo móvel. Ou pode aparecer intermitentemente ou não. Estes são sinais de que a imagem colada não tem suporte devido a:

• Compartilhamento de Recursos entre Origens (CORS). O host de imagem bloqueia o carregamento da imagem no Power Apps.
• Autenticação. A imagem não é acessível publicamente e só pode ser acessada depois que você entrar no host da imagem.
• Suporte ao formato de imagem. Formatos de imagem comuns, como jpg e png, são suportados, mas tipos menos comuns podem não ter suporte pelo navegador ou dispositivo.

Navegadores ou dispositivos podem representar imagens em rich text de forma diferente. Alguns copiam a imagem como dados brutos, enquanto outros podem simplesmente referenciar a URL da imagem. As URLs de imagem podem não estar acessíveis pelos motivos acima.

Ao editar um aplicativo, a tecla Alt não permite interação com o controle

No Power Apps Studio, pressionar a tecla Alt para interação rápida não funciona. Você só pode interagir com o editor de rich text ao visualizar o aplicativo.