Partager via

trackContainerResize

Détermine le dimensionnement du conteneur si le composant doit réagir. Le composant obtient allocatedWidth ou allocatedHeight si l’entrée a la valeur true..

Lorsque vous appelez la trackContainerResize(true) méthode, la context.mode.allocatedWidth méthode est context.mode.allocatedHeight fournie à l’intérieur de la updateView méthode du composant de code. Les valeurs de ces propriétés sont différentes selon l’emplacement où le composant de code est hébergé. Une valeur indiquant -1 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 présente les valeurs des différentes combinaisons de allocatedWidthallocatedHeight méthodes de cycle de vie des composants hôtes et du code.

Host Méthode de 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’ajuste à l’espace disponible.		 -1
Applications canevas updateView Défini par le créateur d’application.
Peut changer dynamiquement si la largeur est définie sur une formule Power FX.		 Défini par le créateur d’application.
Peut changer dynamiquement si la largeur est définie sur une formule Power FX.

Note

Dans le harnais de test (démarré à l’aide npm start), le allocatedHeight et allocatedWidth sera retourné sous forme de chaînes plutôt que de nombres. Lorsqu’aucune valeur n’est fournie, elles retournent une chaîne vide plutôt que -1 ou non définie. En outre, une fois la largeur ou la hauteur définie, vous ne pouvez pas annuler les modifications sans actualiser le navigateur, au lieu de cela, une valeur vide sera interprétée comme une taille de 1.

En général, les applications basées sur des modèles ne limitent pas la hauteur et la largeur d’un composant. Par conséquent, le suivi de la taille du conteneur n’est pas nécessaire. Au lieu de cela, les composants de code peuvent augmenter pour utiliser 100% de l’espace pour les composants de grille, ou à une hauteur spécifique requise par le contenu lors du rendu d’un field composant. Toutefois, dans les applications de canevas, le contexte parent fournit toujours la hauteur et la largeur au composant par nature de l’éditeur de glisser-déplacer.

Le tableau suivant présente les stratégies que vous pouvez utiliser pour contrôler la hauteur et la largeur du contenu HTML de vos contrôles :

Host Type de composant de code Stratégie de taille de la 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 Augmenter jusqu’à une hauteur maximale
(Le formulaire d’hébergement augmente également pour s’adapter).		 width: "100%"
Applications pilotées par modèle field (mode plein écran) height: "100%" width: "100%"
Applications canevas dataset & field height: allocatedWidth width: allocatedHeight
Applications canevas dataset & field (mode plein écran) height: "100%" width: "100%"

Si les valeurs et allocatedWidthallocatedHeight les modifications après le premier updateView appel sont appelées, une suivante updateView est appelée avec « disposition » ajoutée au context.updatedProperties. Plus d’informations : UpdatedProperties.

Disponible pour

Applications basées sur des modèles, applications canevas et portails.

Syntaxe

context.mode.trackContainerResize(value)

Paramètres

Nom du paramètre Type Obligatoire Descriptif
value Boolean Oui True si les contrôles doivent suivre la taille du conteneur, le composant obtient allocationWidth ou allocationHeight.

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

  • Last updated on