ResizableTextArea contrôle
Un composant pour l’entrée de l’utilisateur.
Note
La documentation complète et le code source sont accessibles dans le Référentiel de composants de code GitHub.
Description
Les zones de texte permettent aux utilisateurs de saisir et de modifier du texte. Ils sont utilisés dans les formulaires, les boîtes de dialogue modales, les tableaux et autres surfaces où la saisie de texte est requise.
Ce composant permet à l’utilisateur de redimensionner la zone de texte pour plus de commodité.
Note
Le code source du composant et plus d’informations dans le Référentiel de composants de code GitHub.
Propriétés
Propriétés principales
Property | Description |
---|---|
Text |
Valeur du texte définie dans le contrôle. Il s’agit de la propriété liée par défaut lorsqu’elle est utilisée dans une application pilotée par modèle. |
Default |
La valeur par défaut que le contrôle aura lorsque le contrôle sera réinitialisé ou que la valeur par défaut sera modifiée. Cela permet au contrôle de fonctionner de la même manière que les contrôles dans les formulaires d’application canevas. |
MaxLength |
Nombre maximal de caractères qui peuvent être entrés |
HintText |
Le texte à afficher lorsqu’il n’y a pas de valeur de texte définie |
EmptyPlaceholderText |
Texte à afficher lorsqu’il n’y a pas de valeur et que le contrôle n’a pas le focus. Cela fournit un style similaire à celui du contrôle de texte piloté par modèle qui affiche --- lorsqu’il n’y a pas de valeur renseignée. |
DefaultHeight |
La hauteur initiale définie pour la zone de texte. Si cela n’est pas défini dans une application canevas/une page personnalisée, la taille sera par défaut la hauteur du composant de code. Pour les applications pilotées par modèle, cela est nécessaire car le formulaire ne fournit pas de hauteur initiale. |
DefaultWidth |
La largeur initiale définie pour la zone de texte. Si elle n’est pas définie dans une application canevas/une page personnalisée, la taille sera par défaut la hauteur du composant de code. Pour les applications pilotées par modèle, cela n’est pas obligatoire, car la largeur par défaut sera la largeur de la colonne du formulaire. |
MinHeight |
La hauteur minimale à laquelle la zone textarea peut être redimensionnée. Définissez-la à zéro pour aucune limite. |
MaxHeight |
La hauteur maximale à laquelle la zone textarea peut être redimensionnée. Définissez-la à zéro pour aucune limite. |
Min Width |
La largeur minimale à laquelle la zone textarea peut être redimensionnée. Définissez-la à zéro pour aucune limite. |
MaxWidth |
La largeur maximale à laquelle la zone textarea peut être redimensionnée. Définissez-la à zéro pour aucune limite. |
AllowResize |
Définit dans quelle direction la zone textarea peut être redimensionnée. Aucune, Les deux, Verticale ou Horizontale. |
EnableSpellCheck |
Définit si la zone textarea doit être vérifiée orthographiquement par le navigateur ou non. |
Output properties
Property | Description |
---|---|
Resized Height** (output) - The user adjusted height | Largeur redimensionnée** (sortie) - La largeur ajustée par l’utilisateur |
Propriétés de style
Property | Description |
---|---|
PaddingLeft |
La marge à ajouter à l’intérieur de la zone textarea |
PaddingRight |
La marge à ajouter à l’intérieur de la zone textarea |
PaddingTop |
La marge à ajouter à l’intérieur de la zone textarea |
PaddingBottom |
La marge à ajouter à l’intérieur de la zone textarea |
Left Padding Adjustment |
À l’intérieur d’une application pilotée par modèle, même lorsque l’étiquette est masquée, il y a une marge à gauche du composant de code pour contenir les icônes (par exemple, l’icône de verrouillage). Pour corriger cela, la largeur doit être réduite en définissant l’ajustement de la marge de gauche sur 21. Lorsqu’il y a également une étiquette, l’ajustement de la marge de gauche doit être défini sur la largeur de l’étiquette. |
RenderBorderStyle |
Il peut être Normal ou Centré. Lorsqu’il est défini sur Normal, la largeur de la bordure augmente à l’intérieur de la zone de texte, mais en utilisant Centré, la bordure est centrée autour du bord de la zone de texte. Utilisez Centré pour être compatible avec les contrôles Power Apps Classiques, et Normal pour les contrôles pilotés par modèle et Fluent UI. |
Accessibility Label |
L’étiquette aria |
Toutes les combinaisons de style/état ne sont pas implémentées par chaque composant. Consultez les Propriétés de style dépendant de l’état dans la documentation du composant GitHub.
Propriétés d’événement
Property | Description |
---|---|
Input Event |
Définissez la propriété Input Event sur une chaîne commençant par SetFocus pour définir le focus sur le contrôle. Vous devez inclure un suffixe aléatoire pour que l’événement se déclenche. |
Les autres propriétés sont identiques à celles du contrôle de saisie de texte standard.
Behavior
Prend en charge SetFocus en tant que InputEvent
.
Limitations
Ce composant de code ne peut être utilisé que dans les applications canevas, les pages personnalisées et les applications pilotées par modèle.
Consultez d’autres notes de limitation dans la section Difficultés de conception de la documentation GitHub.