Compose 修飾符清單

動作

範圍：任何
@ExperimentalFoundationApi
<T : Any?> Modifier.anchoredDraggable(
    state: AnchoredDraggableState<T>,
    orientation: Orientation,
    enabled: Boolean,
    interactionSource: MutableInteractionSource?,
    overscrollEffect: OverscrollEffect?,
    startDragImmediately: Boolean
)

在一組預先定義的值之間啟用拖曳手勢。
範圍：任何
@ExperimentalFoundationApi
<T : Any?> Modifier.anchoredDraggable(
    state: AnchoredDraggableState<T>,
    reverseDirection: Boolean,
    orientation: Orientation,
    enabled: Boolean,
    interactionSource: MutableInteractionSource?,
    overscrollEffect: OverscrollEffect?,
    startDragImmediately: Boolean
)

在一組預先定義的值之間啟用拖曳手勢。
範圍：任何
Modifier.clickable(
    enabled: Boolean,
    onClickLabel: String?,
    role: Role?,
    onClick: () -> Unit
)

將元件設為透過輸入或無障礙的「點擊」事件接收點擊。
範圍：任何
Modifier.clickable(
    interactionSource: MutableInteractionSource?,
    indication: Indication?,
    enabled: Boolean,
    onClickLabel: String?,
    role: Role?,
    onClick: () -> Unit
)

將元件設為透過輸入或無障礙的「點擊」事件接收點擊。
範圍：任何
@ExperimentalFoundationApi
Modifier.combinedClickable(
    enabled: Boolean,
    onClickLabel: String?,
    role: Role?,
    onLongClickLabel: String?,
    onLongClick: (() -> Unit)?,
    onDoubleClick: (() -> Unit)?,
    onClick: () -> Unit
)

設定元件以接收輸入或無障礙功能的「點擊」事件的點擊、按兩下和長按。
範圍：任何
@ExperimentalFoundationApi
Modifier.combinedClickable(
    interactionSource: MutableInteractionSource?,
    indication: Indication?,
    enabled: Boolean,
    onClickLabel: String?,
    role: Role?,
    onLongClickLabel: String?,
    onLongClick: (() -> Unit)?,
    onDoubleClick: (() -> Unit)?,
    onClick: () -> Unit
)

設定元件以接收輸入或無障礙功能的「點擊」事件的點擊、按兩下和長按。
範圍：任何
@ExperimentalFoundationApi
Modifier.mouseClickable(
    enabled: Boolean,
    onClickLabel: String?,
    role: Role?,
    onClick: MouseClickScope.() -> Unit
)

建立類似 Modifier.clickable 的輔助鍵，但提供按下按鈕和鍵盤輔助鍵的資訊，提供額外脈絡
範圍：任何
@ExperimentalFoundationApi
Modifier.draggable2D(
    state: Draggable2DState,
    enabled: Boolean,
    interactionSource: MutableInteractionSource?,
    startDragImmediately: Boolean,
    onDragStarted: (startedPosition: Offset) -> Unit,
    onDragStopped: (velocity: Velocity) -> Unit,
    reverseDirection: Boolean
)

為 UI 元素設定兩種螢幕方向的觸控拖曳功能。
範圍：任何
Modifier.draggable(
    state: DraggableState,
    orientation: Orientation,
    enabled: Boolean,
    interactionSource: MutableInteractionSource?,
    startDragImmediately: Boolean,
    onDragStarted: suspend CoroutineScope.(startedPosition: Offset) -> Unit,
    onDragStopped: suspend CoroutineScope.(velocity: Float) -> Unit,
    reverseDirection: Boolean
)

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

針對無障礙功能，使用此修飾符將 selectable 項目的清單 (例如分頁標籤或圓鈕) 分組。
範圍：任何
Modifier.selectable(
    selected: Boolean,
    enabled: Boolean,
    role: Role?,
    onClick: () -> Unit
)

將元件設定為可選取 (通常做為互斥群組的一部分)，在任何時間點一次只能選取一個項目。
範圍：任何
Modifier.selectable(
    selected: Boolean,
    interactionSource: MutableInteractionSource?,
    indication: Indication?,
    enabled: Boolean,
    role: Role?,
    onClick: () -> Unit
)

將元件設定為可選取 (通常做為互斥群組的一部分)，在任何時間點一次只能選取一個項目。
範圍：任何
@ExperimentalMaterialApi
<T : Any?> Modifier. swipeable(
    state: SwipeableState<T>,
    anchors: Map<Float, T>,
    orientation: Orientation,
    enabled: Boolean,
    reverseDirection: Boolean,
    interactionSource: MutableInteractionSource?,
    thresholds: (from, to) -> ThresholdConfig,
    resistance: ResistanceConfig?,
    velocityThreshold: Dp
)

此函式已淘汰不用。Material 的 Swipeable 已由 Foundation 的 AnchoredDraggable API 取代。
範圍：任何
@ExperimentalWearMaterialApi
<T : Any?> Modifier.swipeable(
    state: SwipeableState<T>,
    anchors: Map<Float, T>,
    orientation: Orientation,
    enabled: Boolean,
    reverseDirection: Boolean,
    interactionSource: MutableInteractionSource?,
    thresholds: (from, to) -> ThresholdConfig,
    resistance: ResistanceConfig?,
    velocityThreshold: Dp
)

在一組預先定義的狀態之間啟用滑動手勢。
範圍：任何
Modifier.toggleable(
    value: Boolean,
    enabled: Boolean,
    role: Role?,
    onValueChange: (Boolean) -> Unit
)

將元件設定為可透過輸入和無障礙事件進行切換
範圍：任何
Modifier.toggleable(
    value: Boolean,
    interactionSource: MutableInteractionSource?,
    indication: Indication?,
    enabled: Boolean,
    role: Role?,
    onValueChange: (Boolean) -> Unit
)

將元件設定為可透過輸入和無障礙事件進行切換。
範圍：任何
Modifier.triStateToggleable(
    state: ToggleableState,
    enabled: Boolean,
    role: Role?,
    onClick: () -> Unit
)

將元件設為可透過輸入和無障礙事件三種狀態切換：「開啟」、「關閉」和「不確定」。
範圍：任何
Modifier.triStateToggleable(
    state: ToggleableState,
    interactionSource: MutableInteractionSource?,
    indication: Indication?,
    enabled: Boolean,
    role: Role?,
    onClick: () -> Unit
)

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

對齊方式

範圍： RowScope

在 Row 中垂直對齊元素。
範圍： RowScope
Modifier.alignBy(alignmentLineBlock: (Measured) -> Int)

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

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

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

在 Column 中水平對齊元素。
範圍： ColumnScope
Modifier.alignBy(alignmentLineBlock: (Measured) -> Int)

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

水平放置元素，讓其 alignmentLine 和同樣設定為 alignBy 的同層級元素對齊。
範圍： BoxScope
Modifier.align(alignment: Alignment)

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

Animation

Modifier.animateEnterExit(
    enter: EnterTransition,
    exit: ExitTransition,
    label: String
)

animateEnterExit 修飾符可用於 AnimatedVisibility 的任何直接或間接子項，建立與 AnimatedVisibility 中所指定不同的進入/結束動畫。
範圍： LazyItemScope
Modifier.animateItem(
    fadeInSpec: FiniteAnimationSpec<Float>?,
    placementSpec: FiniteAnimationSpec<IntOffset>?,
    fadeOutSpec: FiniteAnimationSpec<Float>?
)

這個修飾符可製作項目外觀 (淡入)、消失 (淡出) 和位置變更 (例如重新排序項目) 的動畫效果。
範圍： LazyItemScope

此函式已淘汰不用。請改用 Modifier.animateItem()
Modifier.animateItem(
    fadeInSpec: FiniteAnimationSpec<Float>?,
    placementSpec: FiniteAnimationSpec<IntOffset>?,
    fadeOutSpec: FiniteAnimationSpec<Float>?
)

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

此函式已淘汰不用。請改用 Modifier.animateItem()

框線

範圍：任何
Modifier.border(border: BorderStroke, shape: Shape)

修改元素以新增使用 border 和 shape 指定的外觀框線，並進行裁剪。
範圍：任何
Modifier.border(width: Dp, brush: Brush, shape: Shape)

修改元素以新增使用 width、brush 和 shape 指定的外觀框線，並進行裁剪。
範圍：任何
Modifier.border(width: Dp, color: Color, shape: Shape)

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

繪圖

範圍：任何
Modifier.alpha(alpha: Float)

繪製修改 alpha 值可能小於 1 的內容。
範圍：任何
Modifier.background(color: Color, shape: Shape)

在內容下方使用單色 color 繪製 shape。
範圍：任何
Modifier.background(
    brush: Brush,
    shape: Shape,
    alpha: @FloatRange(from = 0.0, to = 1.0) Float
)

在內容下方使用 brush 繪製 shape。
範圍：任何
Modifier.clip(shape: Shape)

配合 shape 的邊界裁剪內容。
範圍：任何

根據此修飾符定義的圖層邊界來裁剪內容。
範圍：任何
Modifier.drawBehind(onDraw: DrawScope.() -> Unit)

繪入修改內容下方的 Canvas 中。
範圍：任何
Modifier.drawWithCache(onBuildDrawCache: CacheDrawScope.() -> DrawResult)

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

建立 DrawModifier，讓開發人員可在版面配置內容之前或之後進行繪製。
範圍：任何
Modifier.indication(
    interactionSource: InteractionSource,
    indication: Indication?
)

在發生互動時對此元件繪製視覺效果。
範圍：任何
Modifier.paint(
    painter: Painter,
    sizeToIntrinsics: Boolean,
    alignment: Alignment,
    contentScale: ContentScale,
    alpha: Float,
    colorFilter: ColorFilter?
)

使用 painter 繪製內容。
範圍：任何
Modifier.shadow(
    elevation: Dp,
    shape: Shape,
    clip: Boolean,
    ambientColor: Color,
    spotColor: Color
)

建立繪製陰影的 graphicsLayer。
範圍：任何

加上邊框間距以配合 safe drawing 的插邊。
範圍：任何
Modifier.zIndex(zIndex: Float)

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

對焦

範圍：任何
Modifier.onFocusChanged(onFocusChanged: (FocusState) -> Unit)

對元件新增此修飾符以觀察焦點狀態事件。
範圍：任何
Modifier.onFocusEvent(onFocusEvent: (FocusState) -> Unit)

對元件新增此修飾符以觀察焦點狀態事件。
範圍：任何

此函式已淘汰不用。已由 focusTarget 取代
範圍：任何

對元件新增此修飾符使其可成為焦點。
範圍：任何
Modifier. focusOrder(focusOrderReceiver: FocusOrder.() -> Unit)

此函式已淘汰不用。改用 focusProperties()
範圍：任何
Modifier. focusOrder(focusRequester: FocusRequester)

此函式已淘汰不用。請改用 focusRequester()
範圍：任何
Modifier. focusOrder(
    focusRequester: FocusRequester,
    focusOrderReceiver: FocusOrder.() -> Unit
)

此函式已淘汰不用。改用 focusProperties() 和 focusRequester()。
範圍：任何

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

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

這個修飾符可用於儲存及還原焦點群組。
範圍：任何

建立焦點群組或將此元件標示為焦點群組。
範圍：任何
Modifier.focusable(
    enabled: Boolean,
    interactionSource: MutableInteractionSource?
)

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

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

圖像

範圍：任何

Modifier.Node 可讓內容繪製到繪圖圖層中。
範圍：任何
Modifier.graphicsLayer(
    scaleX: Float,
    scaleY: Float,
    alpha: Float,
    translationX: Float,
    translationY: Float,
    shadowElevation: Float,
    rotationX: Float,
    rotationY: Float,
    rotationZ: Float,
    cameraDistance: Float,
    transformOrigin: TransformOrigin,
    shape: Shape,
    clip: Boolean,
    renderEffect: RenderEffect?,
    ambientShadowColor: Color,
    spotShadowColor: Color,
    compositingStrategy: CompositingStrategy
)

Modifier.Element 可讓內容繪製到繪圖圖層中。
範圍：任何

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

鍵盤

範圍：任何
Modifier.onKeyEvent(onKeyEvent: (KeyEvent) -> Boolean)

將這個 modifier 新增至元件的 modifier 參數，該元件即可在其 (或其中一個子項) 成為焦點時攔截硬體的按鍵事件。
範圍：任何
Modifier.onPreviewKeyEvent(onPreviewKeyEvent: (KeyEvent) -> Boolean)

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

版面配置

範圍：任何
Modifier.layoutId(layoutId: String, tag: String?)

androidx.compose.ui.layout.layoutId 的替代方案，可用於啟用 tag。
範圍：任何
Modifier.layoutId(layoutId: Any)

使用 layoutId 來標記元素，用來在其母項中識別元素。
範圍：任何

建立 LayoutModifier，允許變更包裝元素的測量及配置方式。
範圍：任何
Modifier.onGloballyPositioned(
    onGloballyPositioned: (LayoutCoordinates) -> Unit
)

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

邊框間距

範圍：任何
Modifier.paddingFrom(alignmentLine: AlignmentLine, before: Dp, after: Dp)

Modifier 可根據其邊界到 alignment line 的指定距離來加入邊框間距，以決定內容的位置。
範圍：任何
Modifier.paddingFrom(
    alignmentLine: AlignmentLine,
    before: TextUnit,
    after: TextUnit
)

Modifier 可加入邊框間距，根據其邊界到 alignment line 的指定距離來放置內容。
範圍：任何
Modifier.paddingFromBaseline(top: Dp, bottom: Dp)

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。
範圍：任何
Modifier.absolutePadding(left: Dp, top: Dp, right: Dp, bottom: Dp)

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

在內容的左邊、頂端、右邊和底端邊緣加入 all dp 的額外空間。
範圍：任何
Modifier.padding(paddingValues: PaddingValues)

對元件套用 PaddingValues，做為內容左邊、頂端、右邊和底端邊緣的額外空間。
範圍：任何
Modifier.padding(horizontal: Dp, vertical: Dp)

在內容的左右邊緣加入 horizontal dp 空間，以及在頂端和底端邊緣加入 vertical dp 空間。
範圍：任何
Modifier.padding(start: Dp, top: Dp, end: Dp, bottom: 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 的空間。

Pointer

範圍：任何
Modifier.pointerHoverIcon(
    icon: PointerIcon,
    overrideDescendants: Boolean
)

修飾符可讓開發人員定義遊標懸停在元素上時顯示的指標圖示。
範圍：任何
@ExperimentalComposeUiApi
Modifier.pointerInteropFilter(
    requestDisallowInterceptTouchEvent: RequestDisallowInterceptTouchEvent?,
    onTouchEvent: (MotionEvent) -> Boolean
)

這個特別的 PointerInputModifier 可用來存取原分派給 Compose 的基礎 MotionEvent。
範圍：任何
@ExperimentalComposeUiApi
Modifier.pointerMoveFilter(
    onMove: (position: Offset) -> Boolean,
    onExit: () -> Boolean,
    onEnter: () -> Boolean
)

可用來追蹤指標 (例如滑鼠或觸控板) 移動事件的修飾符。
範圍：任何
Modifier. pointerInput(block: suspend PointerInputScope.() -> Unit)

此函式已淘汰不用。Modifier.pointerInput 必須提供一或多個定義修飾符的身分識別的「key」參數，並判斷何時應取消其舊有的輸入處理協同程式，並啟動新鍵的新效果。
範圍：任何
Modifier.pointerInput(key1: Any?, block: suspend PointerInputScope.() -> Unit)

建立修飾符以便在已修改元素的區域內處理指標輸入。
範圍：任何
Modifier.pointerInput(vararg keys: Any?, block: suspend PointerInputScope.() -> Unit)

建立修飾符以便在已修改元素的區域內處理指標輸入。
範圍：任何
Modifier.pointerInput(key1: Any?, key2: Any?, block: suspend PointerInputScope.() -> Unit)

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

定位

範圍：任何

將內容位移 offset 個像素。
範圍：任何

將內容位移 (x dp, y dp)。
範圍：任何
Modifier.offset(offset: Density.() -> IntOffset)

將內容位移 offset 個像素。
範圍：任何
Modifier.offset(x: Dp, y: Dp)

將內容位移 (x dp, y dp)。
範圍： TabRowDefaults
Modifier.tabIndicatorOffset(currentTabPosition: TabPosition)

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

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

語意

範圍：任何

包含未確定進度指標所需的 semantics，代表正在執行作業的狀態。
範圍：任何
Modifier.progressSemantics(
    value: Float,
    valueRange: ClosedFloatingPointRange<Float>,
    steps: @IntRange(from = 0) Int
)

包含確定進度指標或滑桿的進度部分所需的 semantics，代表 valueRange 中的進度。
範圍：任何
Modifier.rangeSemantics(
    value: Float,
    enabled: Boolean,
    onValueChange: (Float) -> Unit,
    valueRange: ClosedFloatingPointRange<Float>,
    steps: Int
)

用於新增語意，表示 Stepper/Slider 的進度。
範圍：任何

清除所有子系節點的語意並設定新的語意。
範圍：任何
Modifier.semantics(mergeDescendants: Boolean, properties: SemanticsPropertyReceiver.() -> Unit)

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

捲動

範圍：任何

剪輯主軸上的可捲動容器邊界，同時保留空間在交叉軸上呈現背景效果 (例如陰影)。
範圍：任何
Modifier. mouseScrollFilter(
    onMouseScroll: (event: MouseScrollEvent, bounds: IntSize) -> Boolean
)

此函式已淘汰不用。使用 Modifier.pointerInput + PointerEventType.Scroll
範圍：任何
Modifier.nestedScroll(
    connection: NestedScrollConnection,
    dispatcher: NestedScrollDispatcher?
)

修改元素讓其加入巢狀捲動階層。
範圍：任何

從提供的 overscrollEffect 算繪超出捲動範圍的內容。
範圍：任何
Modifier.onPreRotaryScrollEvent(
    onPreRotaryScrollEvent: (RotaryScrollEvent) -> Boolean
)

將這個 modifier 新增至元件的 modifier 參數，只要元件 (或其中一個子項) 成為焦點，即可攔截 RotaryScrollEvent。
範圍：任何
Modifier.onRotaryScrollEvent(
    onRotaryScrollEvent: (RotaryScrollEvent) -> Boolean
)

在元件的 modifier 參數中加入這個 modifier，即可在元件 (或其中一個子項) 成為焦點時攔截 RotaryScrollEvent。
範圍：任何
Modifier.rotaryScrollable(
    behavior: RotaryScrollableBehavior,
    focusRequester: FocusRequester,
    reverseDirection: Boolean
)

用於將旋轉事件連結至可捲動的容器 (例如 Column、LazyList 等) 的修飾符。
範圍：任何
Modifier.scrollAway(scrollState: ScrollState, offset: Dp)

根據 ScrollState 以垂直方式將項目捲動進出檢視畫面。
範圍：任何
Modifier.scrollAway(
    scrollState: LazyListState,
    itemIndex: Int,
    offset: Dp
)

根據 LazyListState 以垂直方式將項目捲動進出檢視畫面。
範圍：任何
Modifier.scrollAway(
    scrollState: ScalingLazyListState,
    itemIndex: Int,
    offset: Dp
)

根據 ScalingLazyListState 以垂直方式將項目捲動進出檢視畫面。
範圍：任何
Modifier. scrollAway(
    scrollState: ScalingLazyListState,
    itemIndex: Int,
    offset: Dp
)

此函式已淘汰不用。這個超載是為了提供與 Compose for Wear OS 1.1 回溯相容而提供。較新的超載，可使用 wear.compose.foundation.lazy 套件的 ScalingLazyListState
範圍：任何
Modifier.horizontalScroll(
    state: ScrollState,
    enabled: Boolean,
    flingBehavior: FlingBehavior?,
    reverseScrolling: Boolean
)

修改元素，當內容的寬度大於可用的上限條件時允許進行水平捲動。
範圍：任何
Modifier.verticalScroll(
    state: ScrollState,
    enabled: Boolean,
    flingBehavior: FlingBehavior?,
    reverseScrolling: Boolean
)

修改元素，當內容的高度大於可用的上限條件時允許進行垂直捲動。
範圍：任何
Modifier.scrollable(
    state: ScrollableState,
    orientation: Orientation,
    enabled: Boolean,
    reverseDirection: Boolean,
    flingBehavior: FlingBehavior?,
    interactionSource: MutableInteractionSource?
)

設定單一 Orientation 中觸控捲動和快速滑過功能的使用者介面元素。
範圍：任何
@ExperimentalFoundationApi
Modifier.scrollable(
    state: ScrollableState,
    orientation: Orientation,
    overscrollEffect: OverscrollEffect?,
    enabled: Boolean,
    reverseDirection: Boolean,
    flingBehavior: FlingBehavior?,
    interactionSource: MutableInteractionSource?,
    bringIntoViewSpec: BringIntoViewSpec?
)

設定單一 Orientation 中觸控捲動和快速滑過功能的使用者介面元素。
範圍：任何
@ExperimentalTvFoundationApi
Modifier. scrollableWithPivot(
    state: ScrollableState,
    orientation: Orientation,
    pivotOffsets: PivotOffsets,
    enabled: Boolean,
    reverseDirection: Boolean
)

此函式已淘汰。scrollableWithPivot 已淘汰。
範圍：任何

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

大小

範圍：任何
Modifier.animateContentSize(
    animationSpec: FiniteAnimationSpec<IntSize>,
    finishedListener: ((initialValue: IntSize, targetValue: IntSize) -> Unit)?
)

當子項修飾符 (如果已經位於鏈結的尾部，則為子項可組合項) 變更大小時，此修飾符會以本身大小呈現動畫。
範圍：任何
Modifier.animateContentSize(
    animationSpec: FiniteAnimationSpec<IntSize>,
    alignment: Alignment,
    finishedListener: ((initialValue: IntSize, targetValue: IntSize) -> Unit)?
)

當子項修飾符 (如果已經位於鏈結的尾部，則為子項可組合項) 變更大小時，此修飾符會以本身大小呈現動畫。
範圍：任何
Modifier.aspectRatio(
    ratio: @FloatRange(from = 0.0, fromInclusive = false) Float,
    matchHeightConstraintsFirst: Boolean
)

透過嘗試依下列順序比對其中一個傳入的限制條件，來讓內容大小符合指定的長寬比：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 的大小，在元素的測量尺寸較小時減少觸控互動

範圍：任何
Modifier.height(intrinsicSize: IntrinsicSize)

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

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

將內容的寬度宣告為和內容的最小或最大內建寬度完全相同。
範圍：任何
Modifier.width(intrinsicSize: IntrinsicSize)

將內容的偏好寬度宣告為和內容的最小或最大內建寬度相同。
範圍：任何
Modifier.onSizeChanged(onSizeChanged: (IntSize) -> Unit)

在首次測量元素或元素大小變更時，使用已修改的 Compose UI 元素來叫用。
範圍：任何
Modifier.defaultMinSize(minWidth: Dp, minHeight: Dp)

只有在已包裝版面配置不受限制的情況下才限制已包裝版面配置的大小：僅限於傳入的對應限制條件為 0 時，才套用 minWidth 和 minHeight 限制條件。
範圍：任何
Modifier.fillMaxHeight(fraction: @FloatRange(from = 0.0, to = 1.0) Float)

透過設定 minimum height 以及 maximum height 等於 maximum height 乘以 fraction，來讓內容填滿 (可能只有部分) 傳入且限制大小的 Constraints.maxHeight。
範圍：任何
Modifier.fillMaxSize(fraction: @FloatRange(from = 0.0, to = 1.0) Float)

透過將 minimum width 和 maximum width 設定為等於 maximum width 乘以 fraction，以及 minimum height 和 maximum height 等於 maximum height 乘以 fraction，來讓內容填滿 (可能只有部分) 傳入且限制大小的 Constraints.maxWidth 和 Constraints.maxHeight。
範圍：任何
Modifier.fillMaxWidth(fraction: @FloatRange(from = 0.0, to = 1.0) Float)

透過設定 minimum width 以及 maximum width 等於 maximum width 乘以 fraction，來讓內容填滿 (可能只有部分) 傳入且限制大小的 Constraints.maxWidth。
範圍：任何
Modifier.height(height: Dp)

將內容的偏好高度宣告為精準等於 heightdp。
範圍：任何
Modifier.heightIn(min: Dp, max: Dp)

依據傳入大小 Constraints 所允許的範圍，將內容的高度限制在 mindp 到 maxdp 之間。
範圍：任何

將內容的高度宣告為精準等於 heightdp。
範圍：任何
Modifier.requiredHeightIn(min: Dp, max: Dp)

將內容的高度限制在 mindp 到 maxdp 之間。
範圍：任何

將內容的寬度和高度宣告為精準等於 sizedp。
範圍：任何

將內容的大小宣告為精準等於 size。
範圍：任何
Modifier.requiredSize(width: Dp, height: Dp)

將內容的大小宣告為精準等於 widthdp 和 heightdp。
範圍：任何
Modifier.requiredSizeIn(
    minWidth: Dp,
    minHeight: Dp,
    maxWidth: Dp,
    maxHeight: Dp
)

將內容的寬度限制在 minWidthdp 到 maxWidthdp 之間，高度限制在 minHeightdp 和 maxHeightdp 之間。
範圍：任何

將內容的寬度宣告為精準等於 widthdp。
範圍：任何
Modifier.requiredWidthIn(min: Dp, max: Dp)

將內容的寬度限制在 mindp 到 maxdp 之間。
範圍：任何
Modifier.size(size: Dp)

將內容的偏好大小指定為宣告為精準等於 sizedp 的正方形。
範圍：任何
Modifier.size(size: DpSize)

宣告內容的偏好大小必須完全符合 size。
範圍：任何
Modifier.size(width: Dp, height: Dp)

將內容的偏好大小宣告為精準等於 widthdp x heightdp。
範圍：任何
Modifier.sizeIn(minWidth: Dp, minHeight: Dp, maxWidth: Dp, maxHeight: Dp)

依據傳入大小 Constraints 的限制，將內容的寬度限制在 minWidthdp 到 maxWidthdp 之間，高度則限制在 minHeightdp 到 maxHeightdp 之間。
範圍：任何
Modifier.width(width: Dp)

將內容的偏好寬度宣告為精準等於 widthdp。
範圍：任何
Modifier.widthIn(min: Dp, max: Dp)

依據傳入大小 Constraints 的限制，將內容的寬度限制在 mindp 到 maxdp 之間。
範圍：任何
Modifier.wrapContentHeight(
    align: Alignment.Vertical,
    unbounded: Boolean
)

允許內容依本身所要的高度進行測量，而無需考慮傳入的測量 minimum height constraint；若 unbounded 為 true，也無需考慮傳入的測量 maximum height constraint。
範圍：任何
Modifier.wrapContentSize(align: Alignment, unbounded: Boolean)

允許內容根據本身所要的大小進行測量，無須考慮傳入的測量 minimum width 或 minimum height 限制條件；若 unbounded 為 true，也無需考慮傳入的最大限制條件。
範圍：任何
Modifier.wrapContentWidth(
    align: Alignment.Horizontal,
    unbounded: Boolean
)

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

用於設定 IconButton 和 TextButton 的大小和建議觸控目標的修飾符。
範圍：任何

將高度設為等於位於螢幕 bottom 的 insets。
範圍：任何

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

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

將高度設為等同於位於螢幕 top 的 insets。
範圍： RowScope
Modifier.weight(
    weight: @FloatRange(from = 0.0, fromInclusive = false) Float,
    fill: Boolean
)

依據相對於 Row 中其他加權的同層級元素的 weight，調整元素的寬度。
範圍： ColumnScope
Modifier.weight(
    weight: @FloatRange(from = 0.0, fromInclusive = false) Float,
    fill: Boolean
)

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

在完成測量所有其他內容元素後，調整元素大小以符合 Box 的大小。
範圍： LazyItemScope
Modifier.fillParentMaxHeight(
    fraction: @FloatRange(from = 0.0, to = 1.0) Float
)

透過將 minimum height 設定為等於 maximum height 乘以 fraction，將內容填滿傳入大小限制的 Constraints.maxHeight。
範圍： LazyItemScope
Modifier.fillParentMaxSize(
    fraction: @FloatRange(from = 0.0, to = 1.0) Float
)

透過將 minimum width 設定為等於 maximum width 乘以 fraction，並將 minimum height 設定為等於 maximum height 乘以 fraction，讓內容填滿父項大小限制的 Constraints.maxWidth 和 Constraints.maxHeight。
範圍： LazyItemScope
Modifier.fillParentMaxWidth(
    fraction: @FloatRange(from = 0.0, to = 1.0) Float
)

透過將 minimum width 設定為 maximum width 乘以 fraction，讓內容填滿父項大小限制條件 Constraints.maxWidth。
abstract
Modifier.exposedDropdownSize(matchTextFieldWidth: Boolean)

該修飾符應套用至範圍內部的 ExposedDropdownMenu。
abstract
Modifier.exposedDropdownSize(matchTextFieldWidth: Boolean)

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

測試

範圍：任何

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

轉換

範圍：任何
Modifier.rotate(degrees: Float)

設定檢視畫面沿著可組合項目中心旋轉的角度。
範圍：任何
Modifier.scale(scale: Float)

依據相同的縮放比例係數，均勻調整水平軸和垂直軸的內容比例。
範圍：任何
Modifier.scale(scaleX: Float, scaleY: Float)

依據下列縮放比例係數，分別沿著水平軸和垂直軸調整可組合項的內容比例。
範圍：任何
Modifier.transformable(
    state: TransformableState,
    lockRotationOnZoomPan: Boolean,
    enabled: Boolean
)

對已修改的使用者介面元素啟用轉換手勢。
範圍：任何
@ExperimentalFoundationApi
Modifier.transformable(
    state: TransformableState,
    canPan: (Offset) -> Boolean,
    lockRotationOnZoomPan: Boolean,
    enabled: Boolean
)

對已修改的使用者介面元素啟用轉換手勢。

其他

範圍：任何

這個修飾符可讓套用的元素將元素視為拖曳作業的來源。
範圍：任何
Modifier.basicMarquee(
    iterations: Int,
    animationMode: MarqueeAnimationMode,
    repeatDelayMillis: Int,
    initialDelayMillis: Int,
    spacing: MarqueeSpacing,
    velocity: Dp
)

如果修改後的內容太寬，無法放入可用空間，系統就會為其套用動畫邊框效果。
範圍：任何
Modifier.edgeSwipeToDismiss(
    swipeToDismissBoxState: SwipeToDismissBoxState,
    edgeWidth: Dp
)

限制只可在可視區域邊緣可使用滑動關閉。
範圍：任何
Modifier.blur(radius: Dp, edgeTreatment: BlurredEdgeTreatment)

依指定的半徑對內容進行模糊處理。
範圍：任何
Modifier.blur(
    radiusX: Dp,
    radiusY: Dp,
    edgeTreatment: BlurredEdgeTreatment
)

依指定的半徑對內容進行模糊處理。
範圍：任何

可用來傳送 scrollIntoView 要求的修飾符。
範圍：任何

一個可以回應子項 BringIntoViewRequester 要求，並捲動畫面來查看該項目的父項。
範圍：任何
Modifier.composed(
    inspectorInfo: InspectorInfo.() -> Unit,
    factory: @Composable Modifier.() -> Modifier
)

宣告 Modifier 的及時組合，由其修改的每個元素組成。
範圍：任何
@ExperimentalComposeUiApi
Modifier.composed(
    fullyQualifiedName: String,
    key1: Any?,
    inspectorInfo: InspectorInfo.() -> Unit,
    factory: @Composable Modifier.() -> Modifier
)

宣告一個 Modifier 的及時組合，由每個修改的元素組合而成。
範圍：任何
@ExperimentalComposeUiApi
Modifier.composed(
    fullyQualifiedName: String,
    vararg keys: Any?,
    inspectorInfo: InspectorInfo.() -> Unit,
    factory: @Composable Modifier.() -> Modifier
)

宣告 Modifier 的及時組合，由其修改的每個元素組成。
範圍：任何
@ExperimentalComposeUiApi
Modifier.composed(
    fullyQualifiedName: String,
    key1: Any?,
    key2: Any?,
    inspectorInfo: InspectorInfo.() -> Unit,
    factory: @Composable Modifier.() -> Modifier
)

宣告 Modifier 的及時組合，由其修改的每個元素組成。
範圍：任何
@ExperimentalComposeUiApi
Modifier.composed(
    fullyQualifiedName: String,
    key1: Any?,
    key2: Any?,
    key3: Any?,
    inspectorInfo: InspectorInfo.() -> Unit,
    factory: @Composable Modifier.() -> Modifier
)

宣告 Modifier 的及時組合，由其修改的每個元素組成。
範圍：任何
@ExperimentalFoundationApi
Modifier.dragAndDropSource(
    drawDragDecoration: DrawScope.() -> Unit,
    block: suspend DragAndDropSourceScope.() -> Unit
)

這個修飾符可讓套用的元素將元素視為拖曳作業的來源。
範圍：任何
@ExperimentalFoundationApi
Modifier.dragAndDropTarget(
    shouldStartDragAndDrop: (startEvent: DragAndDropEvent) -> Boolean,
    target: DragAndDropTarget
)

可接收拖曳手勢的修飾符。
範圍：任何

此函式已淘汰不用。使用 systemGestureExclusion
範圍：任何

此函式已淘汰不用。使用 systemGestureExclusion
範圍：任何
Modifier.handwritingDetector(callback: () -> Unit)

將元素設為手寫偵測器，以便偵測觸控筆手寫內容，並將辨識文字的處理工作委派給其他元素。
範圍：任何

將元素設為觸控筆手寫處理常式，以便處理手寫偵測器上觸控筆手寫內容所觸發的手寫工作階段的文字輸入內容。
範圍：任何
Modifier.hoverable(
    interactionSource: MutableInteractionSource,
    enabled: Boolean
)

將元件設為可透過游標進入/離開事件懸停。
範圍：任何
inline
Modifier. inspectable(
    noinline inspectorInfo: InspectorInfo.() -> Unit,
    factory: Modifier.() -> Modifier
)

此函式已淘汰不用。此 API 會建立超過必要性的修飾符撤銷，因此不建議使用。
範圍：任何
Modifier.approachLayout(
    isMeasurementApproachInProgress: (lookaheadSize: IntSize) -> Boolean,
    isPlacementApproachInProgress: Placeable.PlacementScope.(lookaheadCoordinates: LayoutCoordinates) -> Boolean,
    approachMeasure: ApproachMeasureScope.(measurable: Measurable, constraints: Constraints) -> MeasureResult
)

建立接近版面配置，以便逐步接近在前瞻式處理階段計算的目的版面配置。
範圍：任何
Modifier.magnifier(
    sourceCenter: Density.() -> Offset,
    magnifierCenter: (Density.() -> Offset)?,
    onSizeChanged: ((DpSize) -> Unit)?,
    zoom: Float,
    size: DpSize,
    cornerRadius: Dp,
    elevation: Dp,
    clip: Boolean
)

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

這個修飾符可以用來使用由其左側的其他修飾符、或版面配置樹狀結構中位於這個修飾符上方所提供的 ModifierLocal。
範圍：任何
@ExperimentalComposeUiApi
<T : Any?> Modifier.modifierLocalProvider(
    key: ProvidableModifierLocal<T>,
    value: () -> T
)

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

在放置好父項 LayoutModifier 與父項的版面配置後、以及放置好子項 LayoutModifier 前叫用 onPlaced。
範圍：任何
@ExperimentalWearMaterialApi
@Composable
Modifier.placeholder(
    placeholderState: PlaceholderState,
    shape: Shape,
    color: Color
)

在可組合項頂端繪製預留位置形狀，並以動畫呈現擦除效果，移除預留位置。
範圍：任何
@ExperimentalWearMaterialApi
@Composable
Modifier.placeholderShimmer(
    placeholderState: PlaceholderState,
    shape: Shape,
    color: Color
)

此修飾符可在元件上繪製閃光預留位置。
範圍：任何

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

將版面配置矩形標示為偏好不顯示浮動視窗。
範圍：任何

在本機版面配置座標內標示矩形，建議不要出現浮動視窗。
範圍：任何

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

為 state 提供捲動事件的巢狀捲動修飾符。
範圍：任何
@ExperimentalMaterialApi
Modifier.pullRefresh(
    onPull: (pullDelta: Float) -> Float,
    onRelease: suspend (flingVelocity: Float) -> Float,
    enabled: Boolean
)

巢狀捲動修飾符，可提供 onPull 和 onRelease 回呼，協助建構自訂的下拉重新整理元件。
範圍：任何
@ExperimentalMaterial3Api
Modifier.pullToRefresh(
    isRefreshing: Boolean,
    state: PullToRefreshState,
    enabled: Boolean,
    threshold: Dp,
    onRefresh: () -> Unit
)

該修飾符可將巢狀捲動新增至容器，以支援下拉即可重新整理手勢。
範圍：任何
@ExperimentalMaterial3Api
Modifier.pullToRefreshIndicator(
    state: PullToRefreshState,
    isRefreshing: Boolean,
    threshold: Dp,
    shape: Shape,
    containerColor: Color,
    elevation: Dp
)

這個修飾符可處理下拉即可重新整理指標的大小、偏移、裁剪、陰影和背景繪製作業，在實作自訂指標時非常實用。
範圍：任何

將目前節點和任何子節點設為內容接收器。
範圍：任何
@ExperimentalComposeUiApi
Modifier.onInterceptKeyBeforeSoftKeyboard(
    onInterceptKeyBeforeSoftKeyboard: (KeyEvent) -> Boolean
)

將此 modifier 新增至元件的 modifier 參數，讓該元件可在硬體按鍵事件傳送至軟體鍵盤前攔截這些事件。
範圍：任何
@ExperimentalComposeUiApi
Modifier.onPreInterceptKeyBeforeSoftKeyboard(
    onPreInterceptKeyBeforeSoftKeyboard: (KeyEvent) -> Boolean
)

將此 modifier 新增至元件的 modifier 參數，讓該元件可在硬體按鍵事件傳送至軟體鍵盤前攔截這些事件。
範圍：任何
Modifier. edgeSwipeToDismiss(
    swipeToDismissBoxState: SwipeToDismissBoxState,
    edgeWidth: Dp
)

此函式已淘汰不用。滑動至 androidx.wear.compose.foundation
範圍：任何

從系統手勢中排除版面配置的矩形。
範圍：任何

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

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

將 paddingValues 視為插邊使用，如同與插邊無關一般加入編框間距。
範圍：任何
Modifier.onConsumedWindowInsetsChanged(
    block: (consumedWindowInsets: WindowInsets) -> Unit
)

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

在錨定可組合函式上長按後顯示工具提示時，應套用至錨定可組合函式的 Modifier。

此函式已淘汰不用。使用可接受 MenuAnchorType 和已啟用參數的超載
abstract

應套用至 ExposedDropdownMenuBoxScope 內元素的修飾符，通常是文字欄位或文字欄位內的圖示。
上一頁
自訂修飾符
下一頁
呼叫器