Compose 修饰符列表

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

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

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

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

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

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

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

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

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

为界面元素配置单个 Orientation 的触摸拖动。

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

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

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

此函数已废弃。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 指定了外观的边框，并进行裁剪。

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

使用纯 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 参数中后，它可以在自己（或其某个子级）获得焦点时截获硬件按键事件。

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

使用 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 内的进度。

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

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

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

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

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

根据提供的 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 及更高版本上将软键盘控制为嵌套滚动。

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

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

通过尝试按照以下顺序匹配传入的某个约束条件来尝试调整内容尺寸，使其符合指定的宽高比：如果 matchHeightConstraintsFirst 为 false（默认值），则顺序为 Constraints.maxWidth、Constraints.maxHeight、Constraints.minWidth、Constraints.minHeight；如果 matchHeightConstraintsFirst 为 true，则顺序为 Constraints.maxHeight、Constraints.maxWidth、Constraints.minHeight、Constraints.minWidth。

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

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

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

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

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

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

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

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

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

仅在封装的布局不受约束时约束其尺寸：minWidth 和 minHeight 约束仅在传入的相应约束为 0 时应用。

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

让内容填充（可能仅部分填充）传入的测量约束的 Constraints.maxWidth 和 Constraints.maxHeight，方法是将 minimum width 和 maximum width 设置为等于 maximum width 乘以 fraction 得出的值，并将 minimum height 和 maximum height 设置为等于 maximum height 乘以 fraction 得出的值。

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

将内容的首选高度声明为正好 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 的尺寸一致。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

如果修改后的内容过宽而无法放入可用空间，则会为该内容应用动画跑马灯效果。

处理从视口边缘开始的滑动关闭操作。

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

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

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

此函数已废弃。改用 BringIntoViewModifierNode

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

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

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

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

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

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

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

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

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

此函数已废弃。请使用 systemGestureExclusion

此函数已废弃。请使用 systemGestureExclusion

在 Composable 上设置请求的帧速率

在 Composable 上设置请求的帧速率

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

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

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

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

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

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

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

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

创建一种旨在帮助逐步接近在预先查看过程中计算出的目标布局的接近布局。

显示 Magnifier widget，以显示相对于当前布局节点而言在 sourceCenter 处内容的放大版。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

使内容适合 rulers。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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