Compose 修饰符列表

操作

作用域:任意
<T : Any?> Modifier.anchoredDraggable(
    state: AnchoredDraggableState<T>,
    orientation: Orientation,
    enabled: Boolean,
    interactionSource: MutableInteractionSource?,
    overscrollEffect: OverscrollEffect?,
    flingBehavior: FlingBehavior?
)

在一组预定义值之间启用拖动手势。

作用域:任意
<T : Any?> Modifier. anchoredDraggable(
    state: AnchoredDraggableState<T>,
    orientation: Orientation,
    enabled: Boolean,
    interactionSource: MutableInteractionSource?,
    overscrollEffect: OverscrollEffect?,
    startDragImmediately: Boolean,
    flingBehavior: FlingBehavior?
)

此函数已弃用。startDragImmediately 已被移除,且没有替代函数。

作用域:任意
<T : Any?> Modifier.anchoredDraggable(
    state: AnchoredDraggableState<T>,
    reverseDirection: Boolean,
    orientation: Orientation,
    enabled: Boolean,
    interactionSource: MutableInteractionSource?,
    overscrollEffect: OverscrollEffect?,
    flingBehavior: FlingBehavior?
)

在一组预定义值之间启用拖动手势。

作用域:任意
<T : Any?> Modifier. anchoredDraggable(
    state: AnchoredDraggableState<T>,
    reverseDirection: Boolean,
    orientation: Orientation,
    enabled: Boolean,
    interactionSource: MutableInteractionSource?,
    overscrollEffect: OverscrollEffect?,
    startDragImmediately: Boolean,
    flingBehavior: FlingBehavior?
)

此函数已弃用。startDragImmediately 已被移除,且没有替代函数。

作用域:任意
Modifier.clickable(
    enabled: Boolean,
    onClickLabel: String?,
    role: Role?,
    interactionSource: MutableInteractionSource?,
    onClick: () -> Unit
)

将组件配置为通过输入或无障碍“点击”事件接收点击操作。

作用域:Any
Modifier.clickable(
    interactionSource: MutableInteractionSource?,
    indication: Indication?,
    enabled: Boolean,
    onClickLabel: String?,
    role: Role?,
    onClick: () -> Unit
)

将组件配置为通过输入或无障碍“点击”事件接收点击操作。

作用域:Any
Modifier.combinedClickable(
    enabled: Boolean,
    onClickLabel: String?,
    role: Role?,
    onLongClickLabel: String?,
    onLongClick: (() -> Unit)?,
    onDoubleClick: (() -> Unit)?,
    hapticFeedbackEnabled: Boolean,
    interactionSource: MutableInteractionSource?,
    onClick: () -> Unit
)

将组件配置为通过输入或无障碍“点击”事件接收点击、双击和长按操作。

作用域:Any
Modifier.combinedClickable(
    interactionSource: MutableInteractionSource?,
    indication: Indication?,
    enabled: Boolean,
    onClickLabel: String?,
    role: Role?,
    onLongClickLabel: String?,
    onLongClick: (() -> Unit)?,
    onDoubleClick: (() -> Unit)?,
    hapticFeedbackEnabled: Boolean,
    onClick: () -> Unit
)

将组件配置为通过输入或无障碍“点击”事件接收点击、双击和长按操作。

作用域:任意
Modifier.draggable2D(
    state: Draggable2DState,
    enabled: Boolean,
    interactionSource: MutableInteractionSource?,
    startDragImmediately: Boolean,
    onDragStarted: (startedPosition: Offset) -> Unit,
    onDragStopped: (velocity: Velocity) -> Unit,
    reverseDirection: Boolean
)

为界面元素配置两种屏幕方向的触摸拖动。

作用域:任意
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 的触摸拖动。

作用域:Any

使用此修饰符将用于实现无障碍功能的一系列 selectable 项(例如 Tab 或 RadioButton)归到一组。

作用域:Any
Modifier.selectable(
    selected: Boolean,
    enabled: Boolean,
    role: Role?,
    interactionSource: MutableInteractionSource?,
    onClick: () -> Unit
)

将组件配置为可选择,通常作为互斥组的一部分,在任何时间点只能选择该组中的一项。

作用域:Any
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
)

在一组预定义状态之间启用滑动手势。

作用域:Any
Modifier.toggleable(
    value: Boolean,
    enabled: Boolean,
    role: Role?,
    interactionSource: MutableInteractionSource?,
    onValueChange: (Boolean) -> Unit
)

将组件配置为可通过输入和无障碍事件切换

作用域:Any
Modifier.toggleable(
    value: Boolean,
    interactionSource: MutableInteractionSource?,
    indication: Indication?,
    enabled: Boolean,
    role: Role?,
    onValueChange: (Boolean) -> Unit
)

将组件配置为可通过输入和无障碍事件切换。

作用域:Any
Modifier.triStateToggleable(
    state: ToggleableState,
    enabled: Boolean,
    role: Role?,
    interactionSource: MutableInteractionSource?,
    onClick: () -> Unit
)

将组件配置为可通过输入和无障碍事件在三种状态之间切换:启用、停用和不确定。

作用域:Any
Modifier.triStateToggleable(
    state: ToggleableState,
    interactionSource: MutableInteractionSource?,
    indication: Indication?,
    enabled: Boolean,
    role: Role?,
    onClick: () -> Unit
)

将组件配置为可通过输入和无障碍事件在三种状态之间切换:启用、停用和不确定。

作用域: PaneScaffoldScope
Modifier.paneExpansionDraggable(
    state: PaneExpansionState,
    minTouchTargetSize: Dp,
    interactionSource: MutableInteractionSource,
    semanticsProperties: (SemanticsPropertyReceiver.() -> Unit)?
)

应应用于拖动手柄可组合项的修饰符,以便拖动手柄可以拖动并正确操作所提供的 PaneExpansionState

对齐方式

作用域: RowScope

Row 中垂直对齐元素。

作用域: RowScope
Modifier.alignBy(alignmentLineBlock: (Measured) -> Int)

垂直放置元素,使由 alignmentLineBlock 确定的内容的对齐线与同样配置为 alignBy 的同级元素对齐。

作用域: RowScope

垂直放置元素,使其 alignmentLine 与同样配置为 alignBy 的同级元素对齐。

作用域: RowScope

垂直放置元素,使其第一条基线与同样配置为 alignByBaselinealignBy 的同级元素对齐。

作用域: ColumnScope

Column 中水平对齐元素。

作用域: ColumnScope
Modifier.alignBy(alignmentLineBlock: (Measured) -> Int)

水平放置元素,使由 alignmentLineBlock 确定的内容的对齐线与同样配置为 alignBy 的同级元素对齐。

作用域: ColumnScope

水平放置元素,使其 alignmentLine 与同样配置为 alignBy 的同级元素对齐。

作用域: BoxScope
Modifier.align(alignment: Alignment)

将内容元素拉取到 Box 中的特定 Alignment

动画

作用域:任意
@ExperimentalSharedTransitionApi
Modifier.animateBounds(
    lookaheadScope: LookaheadScope,
    modifier: Modifier,
    boundsTransform: BoundsTransform,
    animateMotionFrameOfReference: Boolean
)

Modifier 用于为 LookaheadScope 内发生的布局变化(位置和/或大小)添加动画效果。

作用域:任意
@ExperimentalMaterial3ExpressiveApi
Modifier.animateFloatingActionButton(
    visible: Boolean,
    alignment: Alignment,
    targetScale: Float,
    scaleAnimationSpec: AnimationSpec<Float>?,
    alphaAnimationSpec: AnimationSpec<Float>?
)

将此修饰符应用于 FloatingActionButton,以通过动画显示或隐藏它,通常是根据应用的主要内容滚动情况来决定。

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

animateEnterExit 修饰符可用于 AnimatedVisibility 的任何直接或间接子项,以创建与 AnimatedVisibility 中指定的内容不同的进入/退出动画。

作用域: LazyItemScope
open
Modifier.animateItem(
    fadeInSpec: FiniteAnimationSpec<Float>?,
    placementSpec: FiniteAnimationSpec<IntOffset>?,
    fadeOutSpec: FiniteAnimationSpec<Float>?
)

此修饰符可为项目的显示(淡入)、消失(淡出)和位置变化(例如项目重新排序)添加动画效果。

作用域: LazyGridItemScope
Modifier.animateItem(
    fadeInSpec: FiniteAnimationSpec<Float>?,
    placementSpec: FiniteAnimationSpec<IntOffset>?,
    fadeOutSpec: FiniteAnimationSpec<Float>?
)

此修饰符可为项目的显示(淡入)、消失(淡出)和位置变化(例如项目重新排序)添加动画效果。

Modifier.animateItem(
    fadeInSpec: FiniteAnimationSpec<Float>?,
    placementSpec: FiniteAnimationSpec<IntOffset>?,
    fadeOutSpec: FiniteAnimationSpec<Float>?
)

此修饰符可为项目的显示(淡入)、消失(淡出)和位置变化(例如项目重新排序)添加动画效果。

边框

作用域:Any
Modifier.border(border: BorderStroke, shape: Shape)

修改元素,以添加使用 bordershape 指定了外观的边框,并进行裁剪。

作用域:Any
Modifier.border(width: Dp, brush: Brush, shape: Shape)

修改元素,以添加使用 widthbrushshape 指定了外观的边框,并进行裁剪。

作用域:Any
Modifier.border(width: Dp, color: Color, shape: Shape)

修改元素,以添加使用 widthcolorshape 指定了外观的边框,并进行裁剪。

绘图

作用域:Any
Modifier.alpha(alpha: Float)

使用可能小于 1 的修饰的 alpha 绘制内容。

作用域:Any
Modifier.background(color: Color, shape: Shape)

使用纯 color 在内容后方绘制 shape

作用域:Any
Modifier.background(
    brush: Brush,
    shape: Shape,
    alpha: @FloatRange(from = 0.0, to = 1.0) Float
)

使用 brush 在内容后方绘制 shape

作用域:Any
Modifier.clip(shape: Shape)

将内容裁剪到 shape

作用域:Any

将内容裁剪到此修饰符定义的图层的边界。

作用域:Any
Modifier.drawBehind(onDraw: DrawScope.() -> Unit)

绘制到修饰的内容后方的 Canvas 中。

作用域:Any
Modifier.drawWithCache(onBuildDrawCache: CacheDrawScope.() -> DrawResult)

绘制到 DrawScope 中,只要绘制区域的大小不变或读取的任何状态对象未发生变化,便使内容在各绘制调用中始终保留。

作用域:Any

创建 DrawModifier,允许开发者在布局内容前后进行绘制。

作用域:Any
Modifier.indication(
    interactionSource: InteractionSource,
    indication: Indication?
)

在发生互动时为此组件绘制视觉效果。

作用域:Any
Modifier.paint(
    painter: Painter,
    sizeToIntrinsics: Boolean,
    alignment: Alignment,
    contentScale: ContentScale,
    alpha: Float,
    colorFilter: ColorFilter?
)

使用 painter 绘制内容。

作用域:任意
Modifier.dropShadow(shape: Shape, block: DropShadowScope.() -> Unit)

在其余内容后面绘制一个阴影,其几何形状由给定的形状指定,阴影属性由 DropShadowScope 定义。

作用域:任意
Modifier.dropShadow(shape: Shape, shadow: Shadow)

在其余内容后面绘制一个阴影,其几何形状由给定的形状指定,阴影属性由 Shadow 定义。

作用域:任意
Modifier.innerShadow(shape: Shape, block: InnerShadowScope.() -> Unit)

在其余内容后方绘制内阴影,其几何形状由指定形状确定,阴影属性由 InnerShadowScope 定义。

作用域:任意
Modifier.innerShadow(shape: Shape, shadow: Shadow)

使用给定形状指定的几何形状和 Shadow 定义的阴影属性,在其余内容之上绘制内阴影。

作用域:任意
Modifier.shadow(
    elevation: Dp,
    shape: Shape,
    clip: Boolean,
    ambientColor: Color,
    spotColor: Color
)

创建一个用于绘制阴影的 graphicsLayer

作用域:Any

添加内边距,以适应 safe drawing 边衬区。

作用域:Any
Modifier.zIndex(zIndex: Float)

创建一个修饰符,用于控制同一布局父项的子项的绘制顺序。

焦点

作用域:Any
Modifier.onFocusChanged(onFocusChanged: (FocusState) -> Unit)

将此修饰符添加到组件,以观察焦点状态事件。

作用域:Any
Modifier.onFocusEvent(onFocusEvent: (FocusState) -> Unit)

将此修饰符添加到组件,以观察焦点状态事件。

作用域:Any

此函数已废弃。取而代之的是 focusTarget

作用域:Any

将此修饰符添加到组件,以使其可聚焦。

作用域:Any
Modifier. focusOrder(focusOrderReceiver: FocusOrder.() -> Unit)

此函数已废弃。请改用 focusProperties()

作用域:Any
Modifier. focusOrder(focusRequester: FocusRequester)

此函数已废弃。请改用 focusRequester()

作用域:Any
Modifier. focusOrder(
    focusRequester: FocusRequester,
    focusOrderReceiver: FocusOrder.() -> Unit
)

此函数已废弃。请改用 focusProperties() 和 focusRequester()

作用域:Any

此修饰符可让您指定可供修饰符链中更底层或子布局节点上的 focusTarget 访问的属性。

作用域:Any

将此修饰符添加到组件中,以请求更改焦点。

作用域:任意

此修饰符可用于保存并恢复对焦点小组的焦点状态。

作用域:任意

此函数已废弃。请改用 focusRestorer(FocusRequester)

作用域:任意

创建焦点群组或将此组件标记为焦点群组。

作用域:Any
Modifier.focusable(
    enabled: Boolean,
    interactionSource: MutableInteractionSource?
)

将组件配置为可通过焦点系统或无障碍“焦点”事件聚焦。

作用域:Any
Modifier.onFocusedBoundsChanged(
    onPositioned: (LayoutCoordinates?) -> Unit
)

每当当前聚焦区域的边界发生变化时,就会调用 onPositioned

作用域:任意

hierarchicalFocusGroup 用于注释应用中的可组合项,以便我们跟踪组合的活跃部分。

作用域:任意

此修饰符与 hierarchicalFocusGroup 结合使用,会在需要时请求将焦点移至下一个可聚焦元素(即,此修饰符需要在修饰符链中位于该元素之前)。

图形

作用域:Any

Modifier.Node 可使内容绘制到绘图层。

作用域:Any
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,
    blendMode: BlendMode,
    colorFilter: ColorFilter?
)

Modifier.Element 可使内容绘制到绘图层。

作用域:Any

Modifier.Element 可添加绘制图层,以便工具可以识别所绘制图片中的元素。

键盘

作用域:Any
Modifier.onKeyEvent(onKeyEvent: (KeyEvent) -> Boolean)

将此 modifier 添加到组件的 modifier 参数中后,它可以在自己(或其某个子级)获得焦点时截获硬件按键事件。

作用域:Any
Modifier.onPreviewKeyEvent(onPreviewKeyEvent: (KeyEvent) -> Boolean)

将此 modifier 添加到组件的 modifier 参数中后,它可以在自己(或其某个子级)获得焦点时截获硬件按键事件。

Layout

作用域:任意
Modifier.layoutId(layoutId: String, tag: String?)

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

作用域:任意
Modifier.layoutId(layoutId: Any)

使用 layoutId 标记元素,以在其父项中识别它。

作用域:Any

创建 LayoutModifier,以允许更改已封装元素的测量和布局方式。

作用域:Any
Modifier.onGloballyPositioned(
    onGloballyPositioned: (LayoutCoordinates) -> Unit
)

当内容的全局位置可能发生变化时,使用元素的 LayoutCoordinates 调用 onGloballyPositioned

内边距

作用域:Any
Modifier.paddingFrom(alignmentLine: AlignmentLine, before: Dp, after: Dp)

Modifier 可添加内边距,以根据从内容边界到 alignment line 的指定距离放置内容。

作用域:Any
Modifier.paddingFrom(
    alignmentLine: AlignmentLine,
    before: TextUnit,
    after: TextUnit
)

Modifier 可添加内边距,以根据从内容边界到 alignment line 的指定距离放置内容。

作用域:Any
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

作用域:Any

Modifier 用于在布局中放置内容,使从布局顶部到 baseline of the first line of text in the content 的距离为 top,且从 baseline of the last line of text in the content 到布局底部的距离为 bottom

作用域:Any
Modifier.absolutePadding(left: Dp, top: Dp, right: Dp, bottom: Dp)

沿着内容的每个边缘应用 Dp 的额外空间:lefttoprightbottom

作用域:任意

沿着内容的每个边缘(左侧、顶部、右侧和底部)应用 all dp 的额外空间。

作用域:Any
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 的额外空间:starttopendbottom

作用域:任意

添加内边距,以适应 caption bar 边衬区。

作用域:Any

添加内边距,以适应 display cutout

作用域:Any

添加内边距,以适应 ime 边衬区。

作用域:Any

添加内边距,以适应 mandatory system gestures 边衬区。

作用域:Any

添加内边距,以适应 navigation bars 边衬区。

作用域:Any

添加内边距,以适应 safe content 边衬区。

作用域:Any

添加内边距,以适应 safe gestures 边衬区。

作用域:Any

添加内边距,以适应 status bars 边衬区。

作用域:Any

添加内边距,以适应 system bars 边衬区。

作用域:Any

添加内边距,以适应 system gestures 边衬区。

作用域:Any

添加内边距,以适应 waterfall 边衬区。

作用域:Any

添加内边距,使内容不会进入 insets 空间。

Pointer

作用域:任意
Modifier.pointerHoverIcon(
    icon: PointerIcon,
    overrideDescendants: Boolean
)

一种修饰符,可让开发者定义当光标悬停在元素上时要显示的指针图标。

作用域:任意
Modifier.pointerInteropFilter(
    requestDisallowInterceptTouchEvent: RequestDisallowInterceptTouchEvent?,
    onTouchEvent: (MotionEvent) -> Boolean
)

一个特殊的 PointerInputModifier,可提供对最初分派到 Compose 的底层 MotionEvent 的访问权限。

作用域:Any
Modifier. pointerInput(block: suspend PointerInputScope.() -> Unit)

此函数已废弃。Modifier.pointerInput 必须提供一个或多个“key”参数来定义此修饰符的身份,以及确定应在何时取消它的上一个输入处理协程并为新键启动新效果。

作用域:Any

创建一个用于在修饰的元素区域内处理指针输入的修饰符。

作用域:Any
Modifier.pointerInput(vararg keys: Any?, block: PointerInputEventHandler)

创建一个用于在修饰的元素区域内处理指针输入的修饰符。

作用域:Any
Modifier.pointerInput(
    key1: Any?,
    key2: Any?,
    block: PointerInputEventHandler
)

创建一个用于在修饰的元素区域内处理指针输入的修饰符。

位置

作用域:任意

将内容偏移 offset 像素。

作用域:Any

将内容偏移(x dp,y dp)。

作用域:Any
Modifier.offset(offset: Density.() -> IntOffset)

将内容偏移 offset 像素。

作用域:Any
Modifier.offset(x: Dp, y: Dp)

将内容偏移(x dp,y dp)。

作用域: TabRowDefaults
Modifier.tabIndicatorOffset(currentTabPosition: TabPosition)

Modifier 会占用 TabRow 内的所有可用宽度,然后以动画方式呈现它应用到指示器的偏移量(具体取决于 currentTabPosition)。

作用域: TabRowDefaults
Modifier. tabIndicatorOffset(currentTabPosition: TabPosition)

此函数已废弃。仅用于已弃用的 TabRowDefaults.Indicator 方法。

语义

作用域:任意

包含不确定性进度指示器所需的 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
)

用于添加表示步进控件/滑块进度的语义的修饰符。

作用域:任意

清除所有后代节点的语义并设置新语义。

作用域:Any
Modifier.semantics(mergeDescendants: Boolean, properties: SemanticsPropertyReceiver.() -> Unit)

将语义键值对添加到布局节点,以便用于测试、无障碍功能等。

滚动

作用域:Any

裁剪可滚动容器在主轴上的边界,同时在交叉轴上为背景效果(例如阴影)留出空间。

作用域:Any
Modifier.nestedScroll(
    connection: NestedScrollConnection,
    dispatcher: NestedScrollDispatcher?
)

修改元素,以使其参与嵌套滚动层次结构。

作用域:任意
Modifier.overscroll(overscrollEffect: OverscrollEffect?)

根据提供的 overscrollEffect 渲染过滚动。

作用域:任意
Modifier.onPreRotaryScrollEvent(
    onPreRotaryScrollEvent: (RotaryScrollEvent) -> Boolean
)

将此 modifier 添加到组件的 modifier 参数中后,它可以在自己(或其某个子级)获得焦点时截获 RotaryScrollEvent

作用域:Any
Modifier.onRotaryScrollEvent(
    onRotaryScrollEvent: (RotaryScrollEvent) -> Boolean
)

将此 modifier 添加到组件的 modifier 参数中后,它可以在自己(或其某个子级)获得焦点时截获 RotaryScrollEvent

作用域:任意
Modifier.rotaryScrollable(
    behavior: RotaryScrollableBehavior,
    focusRequester: FocusRequester,
    reverseDirection: Boolean,
    overscrollEffect: OverscrollEffect?
)

一种修饰符,用于将旋转事件与可滚动容器(例如 Column、LazyList 等)相关联。

作用域:任意
Modifier.scrollAway(
    scrollInfoProvider: ScrollInfoProvider,
    screenStage: () -> ScreenStage
)

根据滚动列表提供的滚动状态,使项目垂直滚入/滚出视图。

作用域:任意
Modifier.scrollAway(scrollState: ScrollState, offset: Dp)

根据 ScrollState 使项目垂直滚入/滚出视图。

作用域:Any
Modifier.scrollAway(
    scrollState: LazyListState,
    itemIndex: Int,
    offset: Dp
)

根据 LazyListState 使项目垂直滚入/滚出视图。

作用域:Any
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.horizontalScroll(
    state: ScrollState,
    overscrollEffect: OverscrollEffect?,
    enabled: Boolean,
    flingBehavior: FlingBehavior?,
    reverseScrolling: Boolean
)

修改元素,以支持在内容的宽度大于允许的最大约束时水平滚动。

作用域:Any
Modifier.verticalScroll(
    state: ScrollState,
    enabled: Boolean,
    flingBehavior: FlingBehavior?,
    reverseScrolling: Boolean
)

修改元素,以支持在内容的高度大于允许的最大约束值时垂直滚动。

作用域:任意
Modifier.verticalScroll(
    state: ScrollState,
    overscrollEffect: OverscrollEffect?,
    enabled: Boolean,
    flingBehavior: FlingBehavior?,
    reverseScrolling: Boolean
)

修改元素,以支持在内容的高度大于允许的最大约束值时垂直滚动。

作用域:任意
Modifier.scrollable2D(
    state: Scrollable2DState,
    enabled: Boolean,
    overscrollEffect: OverscrollEffect?,
    flingBehavior: FlingBehavior?,
    interactionSource: MutableInteractionSource?
)

在 XY 两种屏幕方向上为界面元素配置触摸滚动和快速滑动。

作用域:任意
Modifier.scrollable(
    state: ScrollableState,
    orientation: Orientation,
    enabled: Boolean,
    reverseDirection: Boolean,
    flingBehavior: FlingBehavior?,
    interactionSource: MutableInteractionSource?
)

在单个 Orientation 为界面元素配置触摸滚动和快速滑动。

作用域:Any
Modifier.scrollable(
    state: ScrollableState,
    orientation: Orientation,
    overscrollEffect: OverscrollEffect?,
    enabled: Boolean,
    reverseDirection: Boolean,
    flingBehavior: FlingBehavior?,
    interactionSource: MutableInteractionSource?,
    bringIntoViewSpec: BringIntoViewSpec?
)

在单个 Orientation 为界面元素配置触摸滚动和快速滑动。

作用域:Any

在 Android R 及更高版本上将软键盘控制为嵌套滚动。

大小

作用域:Any
Modifier.animateContentSize(
    animationSpec: FiniteAnimationSpec<IntSize>,
    finishedListener: ((initialValue: IntSize, targetValue: IntSize) -> Unit)?
)

此修饰符会在其子修饰符(或子可组合项,如果它已位于链尾)更改尺寸时为其自己的尺寸添加动画效果。

作用域:任意
Modifier.animateContentSize(
    animationSpec: FiniteAnimationSpec<IntSize>,
    alignment: Alignment,
    finishedListener: ((initialValue: IntSize, targetValue: IntSize) -> Unit)?
)

此修饰符会在其子修饰符(或子可组合项,如果它已位于链尾)更改尺寸时为其自己的尺寸添加动画效果。

作用域:Any
Modifier.aspectRatio(
    ratio: @FloatRange(from = 0.0, fromInclusive = false) Float,
    matchHeightConstraintsFirst: Boolean
)

通过尝试按照以下顺序匹配传入的某个约束条件来尝试调整内容尺寸,使其符合指定的宽高比:如果 matchHeightConstraintsFirstfalse(默认值),则顺序为 Constraints.maxWidthConstraints.maxHeightConstraints.minWidthConstraints.minHeight;如果 matchHeightConstraintsFirsttrue,则顺序为 Constraints.maxHeightConstraints.maxWidthConstraints.minHeightConstraints.minWidth

作用域:任意

预留至少 48dp 的大小,以便在元素尺寸较小时消除触摸交互的歧义。

作用域:任意

预留至少 48dp 的大小,以便在元素尺寸较小时消除触摸交互的歧义。

作用域:任意

预留至少 48dp 的大小,以便在元素尺寸较小时消除触摸交互的歧义。

作用域:任意

预留至少 48dp 的大小,以便在元素尺寸较小时消除触摸交互的歧义。

作用域:任意
Modifier.height(intrinsicSize: IntrinsicSize)

将内容的首选高度声明为与内容的最小或最大固有高度相同。

作用域:Any

将内容的高度声明为与内容的最小或最大固有高度完全相同。

作用域:Any

将内容的宽度声明为与内容的最小或最大固有宽度完全相同。

作用域:Any
Modifier.width(intrinsicSize: IntrinsicSize)

将内容的首选宽度声明为与内容的最小或最大固有宽度相同。

作用域:Any
Modifier.onSizeChanged(onSizeChanged: (IntSize) -> Unit)

首次测量元素时或元素的大小发生变化时,通过修改后的 Compose 界面元素的大小进行调用。

作用域:Any
Modifier.defaultMinSize(minWidth: Dp, minHeight: Dp)

仅在封装的布局不受约束时约束其尺寸:minWidthminHeight 约束仅在传入的相应约束为 0 时应用。

作用域:Any
Modifier.fillMaxHeight(fraction: @FloatRange(from = 0.0, to = 1.0) Float)

让内容填充(可能仅部分填充)传入的测量约束的 Constraints.maxHeight,方法是将 minimum heightmaximum height 设置为等于 maximum height 乘以 fraction 得出的值。

作用域:Any
Modifier.fillMaxSize(fraction: @FloatRange(from = 0.0, to = 1.0) Float)

让内容填充(可能仅部分填充)传入的测量约束的 Constraints.maxWidthConstraints.maxHeight,方法是将 minimum widthmaximum width 设置为等于 maximum width 乘以 fraction 得出的值,并将 minimum heightmaximum height 设置为等于 maximum height 乘以 fraction 得出的值。

作用域:Any
Modifier.fillMaxWidth(fraction: @FloatRange(from = 0.0, to = 1.0) Float)

让内容填充(可能仅部分填充)传入的测量约束的 Constraints.maxWidth,方法是将 minimum widthmaximum width 设置为等于 maximum width 乘以 fraction 得出的值。

作用域:Any
Modifier.height(height: Dp)

将内容的首选高度声明为正好 heightdp。

作用域:Any
Modifier.heightIn(min: Dp, max: Dp)

如果传入的测量 Constraints 允许,将内容的高度限制在 mindp 与 maxdp 之间。

作用域:Any

将内容的高度声明为正好 heightdp。

作用域:Any
Modifier.requiredHeightIn(min: Dp, max: Dp)

将内容的高度限制在 mindp 与 maxdp 之间。

作用域:Any

将内容的尺寸声明为宽度和高度正好是 sizedp。

作用域:任意

将内容的尺寸声明为正好 size

作用域:任意
Modifier.requiredSize(width: Dp, height: Dp)

将内容的尺寸声明为正好是 widthdp 和 heightdp。

作用域:任意
Modifier.requiredSizeIn(
    minWidth: Dp,
    minHeight: Dp,
    maxWidth: Dp,
    maxHeight: Dp
)

将内容的宽度限制在 minWidthdp 与 maxWidthdp 之间,并将内容的高度限制在 minHeightdp 与 maxHeightdp 之间。

作用域:Any

将内容的宽度声明为正好 widthdp。

作用域:Any
Modifier.requiredWidthIn(min: Dp, max: Dp)

将内容的宽度限制在 mindp 与 maxdp 之间。

作用域:Any
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 之间。

作用域:Any
Modifier.width(width: Dp)

将内容的首选宽度声明为正好 widthdp。

作用域:Any
Modifier.widthIn(min: Dp, max: Dp)

如果传入的测量 Constraints 允许,将内容的宽度限制在 mindp 与 maxdp 之间。

作用域:Any
Modifier.wrapContentHeight(
    align: Alignment.Vertical,
    unbounded: Boolean
)

允许在不考虑传入的测量 minimum height constraint 的情况下将内容测量为所需高度;如果 unbounded 为 true,则也可不考虑传入的测量 maximum height constraint

作用域:Any
Modifier.wrapContentSize(align: Alignment, unbounded: Boolean)

允许在不考虑传入的测量 minimum widthminimum height 约束的情况下将内容测量为所需大小;如果 unbounded 为 true,则也可不考虑传入的最大约束。

作用域:Any
Modifier.wrapContentWidth(
    align: Alignment.Horizontal,
    unbounded: Boolean
)

允许在不考虑传入的测量 minimum width constraint 的情况下以所需宽度测量内容;如果 unbounded 为 true,则也可不考虑传入的测量 maximum width constraint

作用域:任意

用于为 IconButton 和 TextButton 同时设置大小和建议的触摸目标的修饰符。

作用域:任意
Modifier.transformedHeight(
    scope: TransformingLazyColumnItemScope,
    transformationSpec: TransformationSpec
)

使用 TransformationSpec 计算转换后的高度的便捷修饰符。

作用域:任意

将高度设置为屏幕 bottominsets 的高度。

作用域:Any

根据 LayoutDirection,使用 leftright 将宽度设置为屏幕 endinsets 的宽度。

作用域:Any

根据 LayoutDirection,使用 leftright 将宽度设置为屏幕 startinsets 的宽度。

作用域:Any

将高度设置为屏幕 topinsets 的高度。

作用域:任意
@UnstableApi
@Composable
Modifier.resizeWithContentScale(
    contentScale: ContentScale,
    sourceSizeDp: Size?,
    density: Density
)

尝试通过应用指定的 ContentScale 类型,调整原始内容矩形的大小,使其能嵌入到目标矩形中。

作用域: 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,按比例调整元素的高度。

作用域: FlowRowScope
@ExperimentalLayoutApi
Modifier.fillMaxRowHeight(fraction: @FloatRange(from = 0.0, to = 1.0) Float)

让商品填充(可能仅部分填充)放置该商品的行中最高商品的最大高度(在 FlowRow 内)。

作用域: FlowColumnScope
@ExperimentalLayoutApi
Modifier.fillMaxColumnWidth(
    fraction: @FloatRange(from = 0.0, to = 1.0) Float
)

让商品填充(可能仅部分填充)放置该商品的列中最宽商品的 FlowColumn 最大宽度。

作用域: BoxScope

在测量完所有其他内容元素后,调整元素的尺寸,使其与 Box 的尺寸一致。

作用域: LazyItemScope
Modifier.fillParentMaxHeight(
    fraction: @FloatRange(from = 0.0, to = 1.0) Float
)

让内容填充传入的测量约束的 Constraints.maxHeight,方法是将 minimum height 设置为等于 maximum height 乘以 fraction 得出的值。

作用域: LazyItemScope
Modifier.fillParentMaxSize(
    fraction: @FloatRange(from = 0.0, to = 1.0) Float
)

让内容填充父级测量约束的 Constraints.maxWidthConstraints.maxHeight,方法是将 minimum width 设置为等于 maximum width 乘以 fraction 得出的值,并将 minimum height 设置为等于 maximum height 乘以 fraction 得出的值。

作用域: LazyItemScope
Modifier.fillParentMaxWidth(
    fraction: @FloatRange(from = 0.0, to = 1.0) Float
)

让内容填充父级测量约束的 Constraints.maxWidth,方法是将 minimum width 设置为等于 maximum width 乘以 fraction 得出的值。

abstract
Modifier.exposedDropdownSize(matchTextFieldWidth: Boolean)

应应用于放置在范围内的 ExposedDropdownMenu 的修饰符。

abstract
Modifier.exposedDropdownSize(matchAnchorWidth: Boolean)

应应用于放置在 ExposedDropdownMenuBoxScope 内的菜单的修饰符。

作用域: PaneScaffoldScope
open

一种 Modifier,可用于通过拖动来调整窗格大小。

作用域: PaneScaffoldScope

此修饰符用于指定窗格的首选高度,当关联的窗格呈现为重排或悬浮窗格时,窗格框架实现会尽力遵循此高度。

作用域: PaneScaffoldScope

此修饰符用于指定窗格的首选宽度,当关联的窗格呈现为固定窗格(即不会拉伸以填充剩余空间的窗格)时,窗格框架实现会尽力遵循此宽度。

测试

作用域:Any

应用标记以允许在测试中找到修饰的元素。

变换

作用域:Any
Modifier.rotate(degrees: Float)

设置视图围绕可组合项中心旋转的角度。

作用域:任意
Modifier.scale(scale: Float)

按相同的缩放比例沿水平轴和垂直轴均匀缩放内容。

作用域:任意
Modifier.scale(scaleX: Float, scaleY: Float)

分别按以下缩放比例沿水平轴和垂直轴缩放可组合项的内容。

作用域:任意
Modifier.transformable(
    state: TransformableState,
    lockRotationOnZoomPan: Boolean,
    enabled: Boolean
)

启用修饰的界面元素的变换手势。

作用域:任意
Modifier.transformable(
    state: TransformableState,
    canPan: (Offset) -> Boolean,
    lockRotationOnZoomPan: Boolean,
    enabled: Boolean
)

启用修饰的界面元素的变换手势。

其他

作用域:任意

此函数已废弃。已替换为具有回调的重载,用于获取转移数据,检测由 Compose 本身执行

作用域:任意

使用 contentType 设置自动填充提示。

作用域:任意
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)

绘制内容,并使用指定的半径模糊处理内容。

作用域:Any
Modifier.blur(
    radiusX: Dp,
    radiusY: Dp,
    edgeTreatment: BlurredEdgeTreatment
)

绘制内容,并使用指定的半径模糊处理内容。

作用域:任意
Modifier.bringIntoViewRequester(
    bringIntoViewRequester: BringIntoViewRequester
)

可用于发送 bringIntoView 请求的修饰符。

作用域:任意

此函数已废弃。改用 BringIntoViewModifierNode

作用域:任意
Modifier.composed(
    inspectorInfo: InspectorInfo.() -> Unit,
    factory: @Composable Modifier.() -> Modifier
)

声明将针对所修饰的每个元素进行组合的 Modifier 的即时组合。

作用域:Any
Modifier.composed(
    fullyQualifiedName: String,
    key1: Any?,
    inspectorInfo: InspectorInfo.() -> Unit,
    factory: @Composable Modifier.() -> Modifier
)

声明将针对所修饰的每个元素进行组合的 Modifier 的即时组合。

作用域:Any
Modifier.composed(
    fullyQualifiedName: String,
    vararg keys: Any?,
    inspectorInfo: InspectorInfo.() -> Unit,
    factory: @Composable Modifier.() -> Modifier
)

声明将针对所修饰的每个元素进行组合的 Modifier 的即时组合。

作用域:Any
Modifier.composed(
    fullyQualifiedName: String,
    key1: Any?,
    key2: Any?,
    inspectorInfo: InspectorInfo.() -> Unit,
    factory: @Composable Modifier.() -> Modifier
)

声明将针对所修饰的每个元素进行组合的 Modifier 的即时组合。

作用域:Any
Modifier.composed(
    fullyQualifiedName: String,
    key1: Any?,
    key2: Any?,
    key3: Any?,
    inspectorInfo: InspectorInfo.() -> Unit,
    factory: @Composable Modifier.() -> Modifier
)

声明将针对所修饰的每个元素进行组合的 Modifier 的即时组合。

作用域:任意
Modifier.dragAndDropSource(
    transferData: (Offset) -> DragAndDropTransferData?
)

一种 Modifier,可让应用它的元素被视为拖放操作的来源。

作用域:任意
@ExperimentalFoundationApi
Modifier. dragAndDropSource(
    drawDragDecoration: DrawScope.() -> Unit,
    block: suspend DragAndDropSourceScope.() -> Unit
)

此函数已废弃。已替换为具有回调的重载,用于获取转移数据,检测由 Compose 本身执行

作用域:任意
Modifier.dragAndDropSource(
    drawDragDecoration: DrawScope.() -> Unit,
    transferData: (Offset) -> DragAndDropTransferData?
)

一种 Modifier,可让应用它的元素被视为拖放操作的来源。

作用域:任意
Modifier.dragAndDropTarget(
    shouldStartDragAndDrop: (startEvent: DragAndDropEvent) -> Boolean,
    target: DragAndDropTarget
)

一种允许接收拖放手势的修饰符。

作用域:任意

此函数已废弃。请使用 systemGestureExclusion

作用域:Any

此函数已废弃。请使用 systemGestureExclusion

作用域:任意

在 Composable 上设置请求的帧速率

作用域:任意
Modifier.preferredFrameRate(
    frameRate: @FloatRange(from = 0.0, to = 360.0) Float
)

在 Composable 上设置请求的帧速率

作用域:任意
Modifier.handwritingDetector(callback: () -> Unit)

配置一个元素作为手写检测器,用于检测触控笔手写内容并将识别出的文字的处理委托给另一个元素。

作用域:任意

配置元素以充当触控笔手写处理程序,该处理程序可以处理手写检测器上通过触控笔手写触发的手写会话中的文本输入。

作用域:任意
Modifier.hoverable(
    interactionSource: MutableInteractionSource,
    enabled: Boolean
)

将组件配置为可通过指针进入/退出事件悬停。

作用域:任意

将此 modifier 添加到组件的 modifier 参数中后,它可以在自己(或其某个子级)获得焦点时处理 IndirectTouchEvent

作用域:任意

将此 modifier 添加到组件的 modifier 参数中后,它可以在自己(或其某个子级)获得焦点时截获 IndirectTouchEvent,然后再由获得焦点的子级在 onIndirectTouchEvent 中接收该事件。

作用域:任意
inline
Modifier. inspectable(
    noinline inspectorInfo: InspectorInfo.() -> Unit,
    factory: Modifier.() -> Modifier
)

此函数已废弃。此 API 会创建比必要更多的修饰符失效,因此不建议使用。

作用域:任意

一种修饰符,可在受支持的平台上保持设备屏幕开启状态,只要它属于组合的一部分。

作用域:任意

这会将修饰符的 RelativeLayoutBounds 映射到提供的 LayoutBoundsHolder

作用域:任意
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 widget,以显示相对于当前布局节点而言在 sourceCenter 处内容的放大版。

作用域:Any

该修饰符可用于使用由布局树中的其他修饰符(位于此修饰符的左侧或上方)提供的 ModifierLocal

作用域:Any
<T : Any?> Modifier.modifierLocalProvider(
    key: ProvidableModifierLocal<T>,
    value: () -> T
)

该修饰符可用于提供可被其他修饰符(位于该修饰符的右侧或者是该修饰符附加到的布局节点的子项)读取的 ModifierLocal

作用域:任意
Modifier.onFirstVisible(
    minDurationMs: @IntRange(from = 0) Long,
    minFractionVisible: @FloatRange(from = 0.0, to = 1.0) Float,
    viewportBounds: LayoutBoundsHolder?,
    callback: () -> Unit
)

注册一个回调,以监控节点首次位于窗口视口内或不在窗口视口内的时间。

作用域:任意
Modifier.onLayoutRectChanged(
    throttleMillis: Long,
    debounceMillis: Long,
    callback: (RelativeLayoutBounds) -> Unit
)

使用此布局节点相对于合成根的坐标系的位置(以屏幕坐标和窗口坐标表示)来调用 callback

作用域:任意

在放置父级 LayoutModifier 和父布局之后以及放置子级 LayoutModifier 之前,调用 onPlaced

作用域:任意
Modifier.onVisibilityChanged(
    minDurationMs: @IntRange(from = 0) Long,
    minFractionVisible: @FloatRange(from = 0.0, to = 1.0) Float,
    viewportBounds: LayoutBoundsHolder?,
    callback: (Boolean) -> Unit
)

注册一个回调,以监控节点是否位于窗口的视口内。

作用域:任意
@ExperimentalWearMaterialApi
@Composable
Modifier.placeholder(
    placeholderState: PlaceholderState,
    shape: Shape,
    color: Color
)

在可组合项顶部绘制占位形状,并为擦除效果添加动画以移除占位符。

作用域:任意
@Composable
Modifier.placeholder(
    placeholderState: PlaceholderState,
    shape: Shape,
    color: Color
)

Modifier.placeholder 会在组件上绘制骨架形状,适用于没有临时内容(例如缓存数据)的情况。

作用域:任意
@ExperimentalWearMaterialApi
@Composable
Modifier.placeholderShimmer(
    placeholderState: PlaceholderState,
    shape: Shape,
    color: Color
)

用于在组件上绘制占位微光的修饰符。

作用域:任意
@Composable
Modifier.placeholderShimmer(
    placeholderState: PlaceholderState,
    shape: Shape,
    color: Color
)

Modifier.placeholderShimmer 会在内容上绘制周期性微光,向用户表明内容正在加载或可能已过时。

作用域:任意
Modifier.stylusHoverIcon(
    icon: PointerIcon,
    overrideDescendants: Boolean,
    touchBoundsExpansion: DpTouchBoundsExpansion?
)

一种修饰符,可让开发者定义当触控笔悬停在元素上方时显示的指针图标。

作用域:任意
Modifier.motionEventSpy(watcher: (motionEvent: MotionEvent) -> Unit)

使用布局区域或任何子级 pointerInput 接收的每个 MotionEvent 调用 watcher

作用域:任意

将布局矩形标记为首选避开浮动窗口。

作用域:任意

标记局部布局坐标中的一个矩形,该矩形最好避开浮动窗口。

作用域:任意

此修饰符用于转换位置,并根据给定的 PullRefreshState 缩放下拉刷新指示器的大小。

作用域:任意

一种嵌套的滚动修饰符,可向 state 提供滚动事件。

作用域:任意
@ExperimentalMaterialApi
Modifier.pullRefresh(
    onPull: (pullDelta: Float) -> Float,
    onRelease: suspend (flingVelocity: Float) -> Float,
    enabled: Boolean
)

一种嵌套滚动修饰符,可提供 onPullonRelease 回调来帮助构建自定义下拉刷新组件。

作用域:任意
@ExperimentalMaterial3Api
Modifier.pullToRefresh(
    isRefreshing: Boolean,
    state: PullToRefreshState,
    enabled: Boolean,
    threshold: Dp,
    onRefresh: () -> Unit
)

一种修饰符,可向容器添加嵌套滚动,以支持下拉刷新手势。

作用域:任意

将当前节点和任何子节点配置为内容接收器。

作用域:任意

使内容适合 rulers

作用域:任意

如果 rulers 中的某个 Ruler 的值在布局的边界内,则会将内容的大小调整为该 Ruler 和边缘。

作用域:任意
Modifier.sensitiveContent(isContentSensitive: Boolean)

此修饰符提示可组合项在屏幕上呈现敏感内容(即用户名、密码、信用卡等),并且在支持的环境中,屏幕共享期间应保护该内容。

作用域:任意
Modifier.onInterceptKeyBeforeSoftKeyboard(
    onInterceptKeyBeforeSoftKeyboard: (KeyEvent) -> Boolean
)

将此 modifier 添加到组件的 modifier 参数中后,它可以拦截硬件按键事件,然后再将这些事件发送到软件键盘。

作用域:任意
Modifier.onPreInterceptKeyBeforeSoftKeyboard(
    onPreInterceptKeyBeforeSoftKeyboard: (KeyEvent) -> Boolean
)

将此 modifier 添加到组件的 modifier 参数中后,它可以拦截硬件按键事件,然后再将这些事件发送到软件键盘。

作用域:任意
Modifier. edgeSwipeToDismiss(
    swipeToDismissBoxState: SwipeToDismissBoxState,
    edgeWidth: Dp
)

此函数已废弃。SwipeToDismiss 已迁移到 androidx.wear.compose.foundation。

作用域:任意

从系统手势中排除布局矩形。

作用域:Any

从系统手势中排除局部布局坐标中的矩形。

作用域:任意

添加一个 builder,以便在此层次结构中显示文本上下文菜单时运行。

作用域:任意

添加一个 filter,以便在此层次结构中显示文本上下文菜单时运行。

作用域:任意

使用尚未被类似于 windowInsetsPadding 的其他边衬区修饰符使用的边衬区,而无需添加任何内边距。

作用域:Any

paddingValues 用作边衬区,就像添加了内边距而不考虑边衬区。

作用域:Any
Modifier.onConsumedWindowInsetsChanged(
    block: (consumedWindowInsets: WindowInsets) -> Unit
)

使用由 consumeWindowInsets 或其中一个内边距修饰符(如 imePadding)使用的 WindowInsets 调用 block

作用域:任意

这会根据大小和位置重新计算 WindowInsets

此函数已废弃。使用采用 ExposedDropdownMenuAnchorType 和 enabled 参数的重载

abstract
Modifier.menuAnchor(
    type: ExposedDropdownMenuAnchorType,
    enabled: Boolean
)

应应用于 ExposedDropdownMenuBoxScope 内元素的修饰符,通常是文本字段或文本字段内的图标。