Partager via

trackContainerResize

  • Article

Détermine le dimensionnement de conteneur si le composant doit réagir. Le composant obtiendra allocatedWidth ou allocatedHeight si l’entrée est true..

Lorsque vous appelez la méthode trackContainerResize(true), context.mode.allocatedWidth et context.mode.allocatedHeight sont proposées dans la méthode updateView du composant de code. Les valeurs de ces propriétés sont différentes selon l’endroit où le composant de code est hébergé. Une valeur -1 indique que le composant de code peut définir des règles de style CSS pour remplir l’espace disponible selon les besoins.

Le tableau suivant indique les valeurs pour allocatedWidth et allocatedHeight dans les différentes combinaisons de méthodes de cycle de vie des composants de code et hôte.

Hôte Méthode du cycle de vie allocatedWidth allocatedHeight
Applications pilotées par modèle et applications canevas init -1 -1
Applications pilotées par modèle updateView -1 si trackContainerResize(false) ou
largeur en pixels si trackContainerResize(true)
La largeur change à mesure que la fenêtre du navigateur est redimensionnée et que le formulaire s’adapte à l’espace disponible.		 -1
Applications canevas updateView Définies par le créateur d’applications.
Changement dynamique possible si la largeur est définie sur une formule Power FX.		 Définies par le créateur d’applications.
Changement dynamique possible si la largeur est définie sur une formule Power FX.

Notes

Dans le faisceau de test (commencé en utilisant npm start), les éléments allocatedHeight et allocatedWidth sont renvoyés sous forme de chaînes plutôt que de nombres. Si aucune valeur n’est fournie, ils renvoient une chaîne vide plutôt que -1 ou indéfini. De plus, une fois la largeur ou la hauteur définies, vous ne pouvez pas annuler les modifications sans actualiser le navigateur. Sinon, une valeur vide est interprétée comme une taille de 1.

En général, les applications pilotées par modèle ne limitent pas la hauteur et la largeur d’un composant, il n’est donc pas nécessaire de suivre la taille du conteneur. À l’inverse, les composants de code peuvent croître pour utiliser soit 100 % de l’espace pour les composants de grille, soit une hauteur spécifique requise par le contenu lors du rendu d’un composant field. Dans les applications canevas, toutefois, le contexte parent fournit toujours la hauteur et la largeur du composant, de par la nature de l’éditeur par glisser-déplacer.

Le tableau suivant présente les stratégies à utiliser pour contrôler la hauteur et la largeur du contenu HTML des contrôles :

Hôte Type de composant de code Stratégie de taille de hauteur CSS Stratégie de taille de largeur CSS
Applications pilotées par modèle dataset height: "100%" width: "100%"
Applications pilotées par modèle field Croissance jusqu’à une hauteur maximale
(Le formulaire d’hébergement s’agrandit également pour s’adapter).		 width: "100%"
Applications pilotées par modèle field (mode plein écran) height: "100%" width: "100%"
Applications de canevas dataset & field height: allocatedWidth width: allocatedHeight
Applications de canevas dataset & field (mode plein écran) height: "100%" width: "100%"

Si les valeurs allocatedWidth et allocatedHeight sont modifiés après l’appel du premier composant updateView, un second composant updateView est appelé avec « layout » ajouté au composant context.updatedProperties. Plus d’informations : UpdatedProperties.

Disponible pour

Applications pilotées par modèle, applications canevas et portails.

Syntaxe

context.mode.trackContainerResize(value)

Paramètres

Nom du paramètre Type Requise Description
valeur Boolean Oui True si les contrôles doivent suivre de la taille du conteneur, le composant dépend de allocatedWidth ou de allocatedHeight.

Mode
Référence d’API Power Apps component framework
Vue d’ensemble de Power Apps component framework

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).