Compose 修飾符清單

在一組預先定義的值之間啟用拖曳手勢。

在一組預先定義的值之間啟用拖曳手勢。

設定元件以接收輸入性質的點按或無障礙功能的「點擊」事件。

設定元件以接收輸入性質的點按或無障礙功能的「點擊」事件。

設定元件以接收輸入性質的點按、按兩下和長按，或是無障礙功能的「點擊」事件。

設定元件以接收輸入性質的點按、按兩下和長按，或是無障礙功能的「點擊」事件。

為兩種方向的使用者介面元素設定觸控拖曳功能。

為單一 Orientation 中的 UI 元素設定觸控拖曳功能。

針對無障礙功能，使用此修飾符將 selectable 項目的清單 (例如分頁標籤或圓鈕) 分組。

將元件設為可選取 (通常做為互斥群組的一部分)，在任何時間點一次只能選取一個項目。

將元件設為可選取 (通常做為互斥群組的一部分)，在任何時間點一次只能選取一個項目。

將元件設定為可透過輸入和無障礙事件進行切換

將元件設定為可透過輸入和無障礙事件進行切換。

將元件設定為可透過輸入和無障礙事件進行三種狀態的切換：「開啟」、「關閉」和「不確定」。

將元件設定為可透過輸入和無障礙事件進行三種狀態的切換：「開啟」、「關閉」和「不確定」。

應套用至拖曳控點可組合項的修飾符，讓拖曳控點可拖曳，並在提供的 PaneExpansionState 上正常運作。

在 Row 中垂直對齊元素。

垂直放置元素，讓 alignmentLineBlock 決定的內容對齊線和同樣設定為 alignBy 的同層級元素對齊。

垂直放置元素，讓其 alignmentLine 與同樣設定為 alignBy 的同層級元素對齊。

垂直放置元素，讓第一個基準和同樣設定為 alignByBaseline 或 alignBy 的同層級元素對齊。

在 Column 中水平對齊元素。

水平放置元素，讓 alignmentLineBlock 決定的內容對齊線和同樣設定為 alignBy 的同層級元素對齊。

水平放置元素，讓其 alignmentLine 和同樣設定為 alignBy 的同層級元素對齊。

將內容元素置入到 Box 中的特定 Alignment。

Modifier：為 LookaheadScope 內發生的版面配置變更 (位置和/或大小) 加上動畫效果。

將這個修飾符套用至 FloatingActionButton，即可透過動畫顯示或隱藏，通常會根據應用程式的主要內容捲動。

animateEnterExit 修飾符可用於 AnimatedVisibility 的任何直接或間接子項，建立與 AnimatedVisibility 中所指定不同的進入/結束動畫。

這個修飾符會為項目顯示 (淡入)、消失 (淡出) 和位置變更 (例如項目重新排序) 建立動畫。

這個修飾符會為項目顯示 (淡入)、消失 (淡出) 和位置變更 (例如項目重新排序) 建立動畫。

這個修飾符會為項目顯示 (淡入)、消失 (淡出) 和位置變更 (例如項目重新排序) 建立動畫。

修改元素以新增使用 border 和 shape 指定的外觀框線，並進行裁剪。

修改元素以新增使用 width、brush 和 shape 指定的外觀框線，並進行裁剪。

修改元素以新增使用 width、color 和 shape 指定的外觀框線，並進行裁剪。

繪製修改 alpha 值可能小於 1 的內容。

在內容下方使用單色 color 繪製 shape。

在內容下方使用 brush 繪製 shape。

配合 shape 的邊界裁剪內容。

根據此修飾符定義的圖層邊界裁剪內容。

在修改內容下方的 Canvas 中繪製。

只要繪圖區域的大小相同，或者所讀取的任何狀態物件沒有改變，即在 DrawScope 中繪入在繪製呼叫之間保留的內容。

建立 DrawModifier，讓開發人員可在版面配置內容之前或之後進行繪製。

在發生互動時對此元件繪製視覺效果。

使用 painter 繪製內容。

使用指定形狀的幾何圖形，以及 DropShadowScope 定義的陰影屬性，在其餘內容後方繪製投射陰影。

使用指定形狀定義的幾何圖形，以及 Shadow 定義的陰影屬性，在其餘內容後方繪製投射陰影。

在其餘內容後方繪製內陰影，幾何圖形由指定形狀決定，陰影屬性則由 InnerShadowScope 定義。

根據指定形狀的幾何圖形，以及 Shadow 定義的陰影屬性，在其他內容上方繪製內陰影。

建立繪製陰影的 graphicsLayer。

加上邊框間距以配合 safe drawing 的插邊。

建立修飾符，控制具有相同版面配置父項的子項繪製順序。

對元件新增此修飾符以觀察焦點狀態事件。

對元件新增此修飾符以觀察焦點狀態事件。

對元件新增此修飾符，使其可成為焦點。

這個修飾符可讓您指定屬性，讓修飾符鏈之下或子版面配置節點上的 focusTarget 存取。

在元件中加入這個修飾符，用來要求變更焦點。

這個修飾符可用來儲存焦點，並將焦點還原至焦點群組。

建立焦點團體或將此元件標示為焦點團體。

將元件設定為可透過焦點系統或無障礙的「焦點」事件成為可聚焦。

Modifier.Node 可讓內容繪製到繪圖圖層中。

Modifier.Element 可讓內容繪製到繪圖圖層中。

Modifier.Element 可新增繪圖圖層，讓工具能夠識別已繪製圖片中的元素。

將這個 modifier 新增至元件的 modifier 參數，該元件即可在其 (或其中一個子項) 成為焦點時攔截硬體的按鍵事件。

將這個 modifier 新增至元件的 modifier 參數，該元件即可在其 (或其中一個子項) 成為焦點時攔截硬體的按鍵事件。

androidx.compose.ui.layout.layoutId 的替代方案，可使用 tag。

使用 layoutId 標記元素，以便在父項中識別元素。

建立 LayoutModifier，可變更包裝元素的測量和配置方式。

當內容的全域位置可能已經變更時，使用元素的 LayoutCoordinates 來叫用 onGloballyPositioned。

使用 contentType 設定自動填入提示。

如果修改後的內容太寬，無法容納在可用空間中，則會套用動畫跑馬燈效果。

依指定的半徑對內容進行模糊處理。

依指定的半徑對內容進行模糊處理。

可用來傳送 bringIntoView 要求的修飾符。

宣告 Modifier 的及時組合，由每個修改的元素組合而成。

宣告 Modifier 的及時組合，由每個修改的元素組合而成。

宣告 Modifier 的及時組合，由每個修改的元素組合而成。

宣告 Modifier 的及時組合，由每個修改的元素組合而成。

宣告 Modifier 的及時組合，由每個修改的元素組合而成。

Modifier：可讓套用的元素視為拖放作業的來源。

Modifier：可讓套用的元素視為拖放作業的來源。

這個修飾符可接收拖放手勢。

在可組合項上設定要求的影格率

在可組合項上設定要求的影格率

將元素設為手寫偵測工具，偵測觸控筆手寫內容，並將辨識出的文字交由其他元素處理。

將元素設為觸控筆手寫處理常式，可處理手寫偵測工具上觸控筆手寫觸發的手寫工作階段文字輸入。

將元件設為可透過游標進入/離開事件懸停。

只要是支援平台上的組合結構，這個修飾符就會讓裝置螢幕保持開啟。

這會將修飾符的 RelativeLayoutBounds 對應至提供的 LayoutBoundsHolder。

建立接近版面配置，協助逐步接近預先查詢階段計算出的目的地版面配置。

顯示 Magnifier 小工具，該工具會在 sourceCenter 顯示與目前版面配置節點相比的大尺寸內容。

這個修飾符可以用來使用由其左側的其他修飾符、或版面配置樹狀結構中位於這個修飾符上方所提供的 ModifierLocal。

這個修飾符可用來提供 ModifierLocal，可供此修飾符右側的其他修飾符、或是此修飾符在版面配置節點子項中所附加的修飾符讀取。

叫用 callback，並提供這個版面配置節點相對於組合根座標系統的位置，以及螢幕座標和視窗座標。

在放置好父項 LayoutModifier 與父項的版面配置後、以及放置好子項 LayoutModifier 前叫用 onPlaced。

註冊回呼，監控節點是否位於視窗的可視區域內。

開發人員可使用這個修飾符，定義觸控筆懸停在元素上方時顯示的指標圖示。

針對版面配置區域或任何子項 pointerInput 接收到的每個 MotionEvent 呼叫 watcher。

將版面配置矩形標示為偏好避開浮動視窗。

在本機版面配置座標內標示矩形，避免與浮動視窗重疊。

這個修飾符可為容器新增巢狀捲動功能，支援下拉更新手勢。

將目前節點和任何子節點設為內容接收器。

調整內容大小，使其符合 rulers。

如果 rulers 中的其中一個 Ruler 值在版面配置範圍內，系統會根據該 Ruler 和邊緣調整內容大小。

這個修飾符會提示可組合項在螢幕上顯示機密內容 (例如使用者名稱、密碼、信用卡等)，且在支援的環境中分享螢幕畫面時，應保護這些內容。

將此 modifier 新增至元件的 modifier 參數，讓該元件可在硬體按鍵事件傳送至螢幕鍵盤前攔截事件。

將此 modifier 新增至元件的 modifier 參數，讓該元件可在硬體按鍵事件傳送至螢幕鍵盤前攔截事件。

這個修飾符會建立一個區域，並根據指定的 Style 物件，為附加此修飾符的元件設定樣式。

這個修飾符會建立一個區域，並根據指定的 Style 物件，為附加此修飾符的元件設定樣式。

從系統手勢中排除版面配置的矩形。

從系統手勢中排除本機版面配置座標內的矩形。

新增 builder，以便在這個階層中顯示文字內容選單時執行。

新增 filter，以便在這個階層中顯示文字內容選單時執行。

Modifier，用於控制所套用版面配置的顯示設定。

使用未被其他插邊修飾符取用的插邊，類似於未加上任何邊框間距的 windowInsetsPadding。

將 paddingValues 視為插邊使用，如同與插邊無關一般加入編框間距。

藉助 consumeWindowInsets 或其中一個邊框間距修飾符 (例如 imePadding)，透過已使用的 WindowInsets 來呼叫 block。

系統會根據大小和位置重新計算 WindowInsets。

在 SharedTransitionScope 的疊加層中算繪內容，預設會算繪共用內容 (即共用元素和共用邊界)。

sharedBounds 是修飾符，會使用 SharedContentState.key 標記版面配置，這樣一來，進入和退出相同索引鍵的共用邊界時，就會在版面配置變更期間共用動畫和持續變更的邊界。

sharedElement 是修飾符，會使用 SharedContentState.key 標記版面配置，這樣一來，在版面配置變更期間，相同索引鍵的進入和退出共用元素會共用動畫和持續變更的邊界。

sharedElementWithCallerManagedVisibility 是修飾符，會使用 SharedContentState.key 標記版面配置，這樣一來，在版面配置變更期間，相同索引鍵的進入和退出共用元素會共用動畫和持續變更的邊界。

這個修飾符會在共用元素轉換期間，將版面配置錨定在預先檢查階段取得的目標位置。

應套用至 ExposedDropdownMenuBoxScope 內元素的修飾符，通常是文字欄位或文字欄位內的圖示。

這個修飾符會根據提供的 RectRulers 做為插邊，指定相關聯窗格的邊界。

這個修飾符會根據指定的固定邊界和提供的 RectRulers (如有) 做為插邊，指定相關聯窗格的邊界。

Modifier 可根據其邊界到 alignment line 的指定距離來加入邊框間距，以決定內容的位置。

Modifier 可根據其邊界到 alignment line 的指定距離來加入邊框間距，以決定內容的位置。

Modifier 可將內容依下列方式放置在版面配置中：版面配置上方距離 baseline of the first line of text in the content 的距離為 top，而 baseline of the last line of text in the content 到版面配置底端的距離為 bottom。

Modifier 可將內容依下列方式放置在版面配置中：版面配置上方距離 baseline of the first line of text in the content 的距離為 top，而 baseline of the last line of text in the content 到版面配置底端的距離為 bottom。

在 Dp 內容的每邊增加額外的空間：left、top、right 和 bottom。

在內容的左邊、頂端、右邊和底端邊緣加入 all dp 的額外空間。

對元件套用 PaddingValues，做為內容左邊、頂端、右邊和底端邊緣的額外空間。

在內容的左右邊緣加入 horizontal dp 空間，以及在頂端和底端邊緣加入 vertical dp 空間。

在 Dp 內容的每邊增加額外的空間：start、top、end 和 bottom。

加上邊框間距以配合 caption bar 的插邊。

加上邊框間距以容納 display cutout。

加上邊框間距以配合 ime 的插邊。

加上邊框間距以配合 mandatory system gestures 的插邊。

加上邊框間距以配合 navigation bars 的插邊。

加上邊框間距以配合 safe content 的插邊。

加上邊框間距以配合 safe gestures 的插邊。

加上邊框間距以配合 status bars 的插邊。

加上邊框間距以配合 system bars 的插邊。

加上邊框間距以配合 system gestures 的插邊。

加上邊框間距以配合 waterfall 的插邊。

增加邊框間距，讓內容不會進入 insets 的空間。

Modifier，可偵測 IndirectPointerEvent 來源的高階點擊和水平滑動手勢。

修飾符，可讓開發人員定義游標懸停在元素上方時顯示的指標圖示。

這個特別的 PointerInputModifier 可用來存取原分派給 Compose 的基礎 MotionEvent。

建立修飾符以便在已修改元素的區域內處理指標輸入。

建立修飾符以便在已修改元素的區域內處理指標輸入。

建立修飾符以便在已修改元素的區域內處理指標輸入。

將內容位移 offset 個像素。

將內容位移 (x dp, y dp)。

將內容位移 offset 個像素。

將內容位移 (x dp, y dp)。

剪輯主軸上的可捲動容器邊界，同時保留空間在交叉軸上呈現背景效果 (例如陰影)。

修改元素，讓其加入巢狀捲動階層。

從提供的 overscrollEffect 算繪過度捲動。

在元件的 modifier 參數中加入這個 modifier，只要元件 (或其中一個子項) 成為焦點，即可攔截 RotaryScrollEvent。

在元件的 modifier 參數中加入這個 modifier，只要元件 (或其中一個子項) 成為焦點，即可攔截 RotaryScrollEvent。

修改元素，當內容寬度大於上限條件時，允許水平捲動。

修改元素，當內容寬度大於上限條件時，允許水平捲動。

修改元素，當內容的高度大於可用的上限條件時允許進行垂直捲動。

修改元素，當內容的高度大於可用的上限條件時允許進行垂直捲動。

為 UI 元素設定 XY 兩個方向的觸控捲動和快速滑過功能。

將元件設為可捲動區域。

將元件設為可捲動區域。

為單一 Orientation 中的 UI 元素設定觸控捲動和快速滑過功能。

為單一 Orientation 中的 UI 元素設定觸控捲動和快速滑過功能。

僅供視覺呈現的捲軸，代表捲動元件目前的捲動位置。

在 Android R 以上版本將軟式鍵盤設為巢狀捲動功能。

包含未確定進度指標所需的 semantics，用來呈現正在執行中作業的狀態。

包含確定進度指標或滑桿的進度部分所需用到的 semantics，其表示 valueRange 中的進度。

清除所有子系節點的語意並設定新的語意。

對版面配置節點新增語意鍵/值組，以用於測試、無障礙功能等。

當子項修飾符 (如果已經位於鏈結的尾部，則為子項可組合項) 改變大小時，這個修飾符會以本身大小呈現動畫。

當子項修飾符 (如果已經位於鏈結的尾部，則為子項可組合項) 改變大小時，此修飾符會以本身大小呈現動畫。

嘗試依下列順序比對其中一個傳入的限制條件，讓內容大小符合指定的顯示比例：Constraints.maxWidth、Constraints.maxHeight、Constraints.minWidth、Constraints.minHeight (如果 matchHeightConstraintsFirst 為 false 的話，此為預設值)，或者 Constraints.maxHeight、Constraints.maxWidth、Constraints.minHeight、Constraints.minWidth (如果 matchHeightConstraintsFirst 為 true 的話)。

保留至少 48.dp 的大小，在元素的測量尺寸較小時減少觸控互動。

將內容的偏好高度宣告為和內容的最小或最大內建高度相同。

將內容的高度宣告為和內容最小或最大內建高度完全相同。

將內容的寬度宣告為和內容的最小或最大內建寬度完全相同。

將內容的偏好寬度宣告為和內容的最小或最大內建寬度相同。

在首次測量元素或元素大小變更時，使用已修改的 Compose UI 元素來叫用。

只有在已包裝版面配置不受限制的情況下，才限制已包裝版面配置的大小：僅限於傳入的對應限制條件為 0 時，才套用 minWidth 和 minHeight 限制條件。

將 minimum height 和 maximum height 設為 maximum height 乘以 fraction，讓內容填滿 (可能只有部分) 傳入測量限制的 Constraints.maxHeight。

透過將 minimum width 和 maximum width 設定為等於 maximum width 乘以 fraction，以及 minimum height 和 maximum height 等於 maximum height 乘以 fraction，來讓內容填滿 (可能只有部分) 傳入且限制大小的 Constraints.maxWidth 和 Constraints.maxHeight。

將 minimum width 和 maximum width 設為 maximum width 乘以 fraction，讓內容填滿 (可能只有部分) 傳入測量限制的 Constraints.maxWidth。

將內容的偏好高度宣告為精準等於 heightdp。

依據傳入大小 Constraints 的限制，將內容的高度限制在 mindp 到 maxdp 之間。

將內容的高度宣告為精準等於 heightdp。

將內容的高度限制在 mindp 到 maxdp 之間。

將內容的寬度和高度宣告為精準等於 sizedp。

將內容的大小宣告為精準等於 size。

將內容的大小宣告為精準等於 widthdp 和 heightdp。

將內容的寬度限制在 minWidthdp 到 maxWidthdp 之間，高度限制在 minHeightdp 到 maxHeightdp 之間。

將內容的寬度宣告為精準等於 widthdp。

將內容的寬度限制在 mindp 到 maxdp 之間。

將內容的偏好大小宣告為精準等於 sizedp 的正方形。

將內容的偏好大小宣告為精準等於 size。

將內容的偏好大小宣告為精準等於 widthdp x heightdp。

依據傳入大小 Constraints 的限制，將內容的寬度限制在 minWidthdp 到 maxWidthdp 之間，高度限制在 minHeightdp 到 maxHeightdp 之間。

將內容的偏好寬度宣告為精準等於 widthdp。

依據傳入大小 Constraints 的限制，將內容的寬度限制在 mindp 到 maxdp 之間。

允許內容依本身所要的高度進行測量，而無需考慮傳入的測量 minimum height constraint；若 unbounded 為 true，也無需考慮傳入的測量 maximum height constraint。

允許內容根據本身所要的大小進行測量，無須考慮傳入的測量 minimum width 或 minimum height 限制條件；若 unbounded 為 true，也無需考慮傳入的最大限制條件。

允許內容根據本身所要的寬度進行測量，而無需考慮傳入的測量 minimum width constraint；若 unbounded 為 true，則也無需考慮傳入的測量 maximum width constraint。

將高度設為等於位於螢幕 bottom 的 insets。

視 LayoutDirection 而定，使用 left 或 right 將寬度設為等於位於螢幕 end 的 insets。

視 LayoutDirection 而定，使用 left 或 right 將寬度設為等於位於螢幕 start 的 insets。

將高度設為等於位於螢幕 top 的 insets。

嘗試套用指定的 ContentScale 類型，將原始內容矩形的大小調整為內接於目標。

skipToLookaheadSize 可讓版面配置使用預先測量限制測量子項，因此子項的版面配置會像轉換已完成一樣。

依據相對於 Row 中其他加權的同層級元素的 weight，調整元素的寬度。

依據相對於 Column 中其他加權的同層級元素的 weight，調整元素的高度。

在 FlowRow 中，讓項目填滿 (可能只有部分) 所在資料列中最高項目的最大高度。

在 FlowColumn 中，讓項目填滿所在資料欄中最寬項目的最大寬度 (可能只有部分)。

在完成測量所有其他內容元素後，調整元素大小以符合 Box 的大小。

將 minimum height 設為 maximum height 乘以 fraction，讓內容填滿傳入大小限制條件 Constraints.maxHeight。

透過將 minimum width 設定為等於 maximum width 乘以 fraction，以及 minimum height 設定為等於 maximum height 乘以 fraction，將內容填滿父項大小限制的 Constraints.maxWidth 和 Constraints.maxHeight。

透過將 minimum width 設定為 maximum width 乘以 fraction，讓內容填滿父項大小限制條件 Constraints.maxWidth。

應套用至 ExposedDropdownMenuBoxScope 內選單的修飾符。

這個修飾符會指定 Dp 中窗格的首選高度，而窗格 Scaffold 實作會盡可能遵循這個高度，將相關聯的窗格算繪為重排或浮動窗格。

這個修飾符會指定窗格的偏好高度，以整體 Scaffold 高度的比例表示。

這個修飾符會指定窗格的偏好寬度，以整體 Scaffold 寬度的比例表示。

這個修飾符會指定 Dp 中窗格的首選寬度，而窗格 Scaffold 實作會盡可能遵循這個寬度，將相關聯的窗格算繪為固定窗格，也就是不會延伸填滿剩餘空間的窗格。

套用標記，以便在測試中找到修改過的元素。

設定檢視畫面沿著可組合函式中心旋轉的角度。

依據相同的縮放比例係數，均勻調整水平軸和垂直軸的內容比例。

依據下列縮放比例係數，分別沿著水平軸和垂直軸調整可組合項目的內容比例。

對已修改的 UI 元素啟用轉換手勢。

對已修改的 UI 元素啟用轉換手勢。