Compose 修飾符清單

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

這個函式已淘汰。startDragImmediately 已移除，且沒有替代函式。

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

這個函式已淘汰。startDragImmediately 已移除，且沒有替代函式。

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

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

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

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

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

為單一 Orientation 中的使用者介面元素設定觸控拖曳功能。

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

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

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

此函式已淘汰不用。Material 的 Swipeable 已由 Foundation 的 AnchoredDraggable API 取代。

在一組預先定義的狀態之間啟用滑動手勢。

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

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

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

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

應套用至拖曳控點可組合函式的修飾符，這樣拖曳控點才能拖曳，並在提供的 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 取代

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

此函式已淘汰不用。改用 focusProperties()

此函式已淘汰不用。請改用 focusRequester()

此函式已淘汰不用。改用 focusProperties() 和 focusRequester()。

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

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

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

此函式已淘汰不用。請改用 focusRestorer(FocusRequester)

建立焦點群組或將此元件標示為焦點群組。

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

當目前焦點區域的邊界變更時呼叫 onPositioned。

hierarchicalFocusGroup 用於為應用程式中的可組合項加註，方便我們追蹤組合的有效部分。

這個修飾符會與 hierarchicalFocusGroup 一起使用，並在需要時要求將焦點放在下一個可聚焦的元素上 (也就是說，這個修飾符必須位於修飾符鏈結中的該元素之前)。

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

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

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

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

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

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

使用 layoutId 來標記元素，用來在其母項中識別元素。

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

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

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 的空間。

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

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

此函式已淘汰不用。Modifier.pointerInput 必須提供一或多個定義修飾符身分識別的「key」參數，並判斷何時應取消其舊有的輸入處理協同程式，並啟動新鍵的新效果。

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

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

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

將內容位移 offset 個像素。

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

將內容位移 offset 個像素。

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

Modifier 會使用 TabRow 內所有可用的寬度，然後對所套用的指標進行動畫偏移 (視 currentTabPosition 而定)。

此函式已淘汰不用。僅供搭配已淘汰的 TabRowDefaults.Indicator 方法使用。

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

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

用來新增語意的修飾符，表示 Stepper/Slider 的進度。

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

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

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

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

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

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

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

這個修飾符會將旋轉事件與可捲動的容器 (例如 Column、LazyList 等) 連結。

根據捲動清單提供的捲動狀態，以垂直方式將項目捲動進出檢視畫面。

根據 ScrollState 以垂直方式將項目捲動進出檢視畫面。

根據 LazyListState 以垂直方式將項目捲動進出檢視畫面。

根據 ScalingLazyListState 以垂直方式將項目捲動進出檢視畫面。

此函式已淘汰不用。這個超載是為了回溯相容於 Compose for Wear OS 1.1 而提供。我們提供的新超載會使用 wear.compose.foundation.lazy 套件中的 ScalingLazyListState

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

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

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

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

設定 XY 方向的觸控捲動和快速滑過功能的使用者介面元素。

設定單一 Orientation 中觸控捲動和快速滑過功能的使用者介面元素。

設定單一 Orientation 中觸控捲動和快速滑過功能的使用者介面元素。

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

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

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

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

如果元素的測量尺寸較小，這可用於保留至少 48.dp 的大小，減少觸控互動

如果元素的測量尺寸較小，這可用於保留至少 48.dp 的大小，減少觸控互動

如果元素的測量尺寸較小，這可用於保留至少 48.dp 的大小，減少觸控互動

如果元素的測量尺寸較小，這可用於保留至少 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。

修飾符，可同時設定 IconButton 和 TextButton 的大小和建議觸控目標。

便利的修飾符，可使用 TransformationSpec 計算轉換後的高度。

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

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

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

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

嘗試套用指定的 ContentScale 類型，將原始內容矩形調整為可寫入目的地的尺寸。

依據相對於 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。

應套用至範圍內 ExposedDropdownMenu 的修飾符。

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

Modifier：可拖曳調整窗格大小。

這個修飾符會指定窗格的偏好高度，而窗格 scaffold 實作項目會盡量尊重這個高度，在相關聯的窗格以重排或升起窗格的形式呈現時，

這個修飾符會指定窗格的偏好寬度，而窗格架構實作項目會盡可能遵守這個寬度，將相關聯的窗格算繪為固定窗格，也就是不會延展以填滿剩餘空間的窗格。

套用標記，得以在測試中搜尋到已修改的元素。

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

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

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

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

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

此函式已淘汰不用。已由多載取代，並使用回呼取得轉移資料，偵測作業由 Compose 本身執行

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

如果修改後的內容太寬，無法放入可用空間，就會套用動畫跑馬燈效果。

處理從可視區域邊緣滑動關閉的手勢。

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

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

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

此函式已淘汰不用。請改用 BringIntoViewModifierNode

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

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

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

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

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

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

此函式已淘汰不用。已由多載取代，並使用回呼取得轉移資料，偵測作業由 Compose 本身執行

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

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

此函式已淘汰不用。使用 systemGestureExclusion

此函式已淘汰不用。使用 systemGestureExclusion

在 Composable 上設定要求的影格速率

在 Composable 上設定要求的影格速率

設定元素做為手寫偵測工具，偵測觸控筆手寫內容，並將辨識出的文字處理作業委派給其他元素。

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

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

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

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

此函式已淘汰不用。這個 API 會建立的修飾符失效次數會超出必要範圍，因此不建議使用。

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

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

建立方法版面配置，逐步接近在預先查看階段計算出的目的地版面配置。

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

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

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

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

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

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

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

在可組合項頂端繪製預留位置形狀，並製作清除預留位置的動畫效果。

如果沒有暫時性內容 (例如快取資料)，Modifier.placeholder 會在元件上繪製骨架形狀。

修飾符，用於在元件上繪製預留位置微光。

Modifier.placeholderShimmer 會在內容上定期繪製微光，向使用者表示內容正在載入或可能過時。

修飾符：開發人員可定義當觸控筆懸停在元素上方時要顯示的指標圖示。

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

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

標示本機版面配置座標內的矩形，優先避開浮動視窗。

該修飾符用於根據指定的 PullRefreshState，來平移位置並縮放下拉即可重新整理指標的大小。

巢狀捲動修飾符，可將捲動事件提供給 state。

巢狀捲動修飾符，提供 onPull 和 onRelease 回呼，協助建構自訂下拉重新整理元件。

這個修飾符會將巢狀捲動新增至容器，以支援下拉重新整理手勢。

將目前節點和所有子節點設定為內容接收器。

符合 rulers 內的內容。

如果 Ruler 內有 rulers 的值位於版面配置的界線內，系統會將內容大小調整為該 Ruler 和邊緣。

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

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

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

此函式已淘汰不用。SwipeToDismiss 已遷移至 androidx.wear.compose.foundation。

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

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

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

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

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

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

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

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

此函式已淘汰不用。使用採用 ExposedDropdownMenuAnchorType 和已啟用參數的超載

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