共用方式為


trackContainerResize

決定元件需要反應時的容器大小。 元件將取得 allocatedWidthallocatedHeight 如果輸入為true..

當您呼叫該trackContainerResize(true)方法時,context.mode.allocatedWidth程式碼元件的方法內updateView將提供 and context.mode.allocatedHeight 。 這些屬性的值會因程式碼元件的裝載位置而異。 值 表示 -1 程式碼元件可以設定 CSS 樣式規則,以視需要填滿可用空間。

下表顯示主機和程式碼元件生命週期方法不同組合中的 和 allocatedHeightallocatedWidth

Host 生命週期方法 allocatedWidth allocatedHeight
模型導向和畫布應用程式 init -1 -1
模型導向應用程式 updateView -1 if trackContainerResize(false)
寬度(以像素為單位), 如果 trackContainerResize(true)
寬度會隨著瀏覽器視窗的調整大小而變更,以及表單會調整為可用空間。
-1
畫布應用程式 updateView 由應用程序製造商設置。
如果寬度設定為 Power FX 公式,則可以動態變更。
由應用程序製造商設置。
如果寬度設定為 Power FX 公式,則可以動態變更。

備註

在測試工具(開始使用 npm start)中,和allocatedHeightallocatedWidth將以字串而不是數字的形式傳回。 當未提供任何值時,它們將傳回空字串,而不是 -1 或未定義。 此外,一旦設定了寬度或高度,則無法在不刷新瀏覽器的情況下撤銷更改,而空白值將被解釋為大小為 1。

一般而言,模型導向應用程式不會限制元件的高度和寬度,因此不需要追蹤容器大小。 相反地,程式碼元件可以成長,以使用 100% 的格線元件空間,或轉譯 field 元件時內容所需的特定高度。 不過,在畫布應用程式中,父內容一律會依拖放編輯器的本質,為元件提供高度和寬度。

下表顯示可用來控制控制項 HTML 內容高度和寬度的策略:

Host 程式碼元件類型 CSS 高度大小策略 CSS 寬度大小策略
模型導向應用程式 dataset height: "100%" width: "100%"
模型導向應用程式 field 成長到最大高度
(託管形式也將擴大以適應)。
width: "100%"
模型導向應用程式 field (全螢幕模式) height: "100%" width: "100%"
畫布應用程式 dataset & field height: allocatedWidth width: allocatedHeight
畫布應用程式 dataset & field (全螢幕模式) height: "100%" width: "100%"

如果 和 的allocatedWidth值在呼叫第一個updateView之後發生變化,則會呼叫後續的updateView,並將「佈局」新增至 context.updatedPropertiesallocatedHeight 。 其他資訊: UpdatedProperties

適用於

模型導向應用程式、畫布應用程式和入口網站。

語法

context.mode.trackContainerResize(value)

參數

參數名稱 類型 為必填項目 Description
value Boolean Yes True 如果控制項需要追蹤容器大小,元件會取得 allocatedWidth 或 allocatedHeight。

模式
Power Apps 元件架構 API 參考
Power Apps 元件架構概觀