Compose 修饰符列表

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

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

配置组件以通过输入或辅助功能“点击”事件接收点击。

配置组件以通过输入或辅助功能“点击”事件接收点击。

配置组件以通过输入或辅助功能“点击”事件接收点击、双击和长按。

配置组件以通过输入或辅助功能“点击”事件接收点击、双击和长按。

创建类似于 Modifier.clickable 的修饰符，但提供有关按下按钮和键盘修饰符的附加上下文信息

配置 UI 元素在两个方向上的触摸拖动。

配置 UI 元素在单个 Orientation 中的触摸拖动。

使用此修饰符将 selectable 项目（如选项卡或单选按钮）组合在一起以用于辅助功能。

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

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

此函数已弃用。 Material 的 Swipeable 已被 Foundation 的 AnchoredDraggable API 替换。

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

配置组件使其可通过输入和辅助功能事件切换。

配置组件使其可通过输入和辅助功能事件切换。

配置组件使其可通过输入和辅助功能事件切换，具有三种状态：开、关和不确定。

配置组件使其可通过输入和辅助功能事件切换，具有三种状态：开、关和不确定。

在 Row 中垂直对齐元素。

垂直定位元素，以便由 alignmentLineBlock 确定的内容的对齐线与也配置为 alignBy 的同级元素对齐。

垂直放置元素，使其对齐线与也配置为alignBy的兄弟元素对齐。

垂直放置元素，使其第一条基线与也配置为alignByBaseline或alignBy的兄弟元素对齐。

在Column中水平对齐元素。

水平放置元素，使其由alignmentLineBlock确定的内容对齐线与也配置为alignBy的兄弟元素对齐。

水平放置元素，使其对齐线与也配置为alignBy的兄弟元素对齐。

将内容元素拉到Alignment指定的特定位置，在Box中。

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

此修饰符会为项目的出现（淡入）、消失（淡出）和放置更改（例如项目重新排序）设置动画。

此函数已弃用。 请改用 Modifier.animateItem()

此修饰符会为项目的出现（淡入）、消失（淡出）和放置更改（例如项目重新排序）设置动画。

此函数已弃用。 请改用 Modifier.animateItem()

修改元素以添加边框，其外观由border和shape指定，并对其进行裁剪。

修改元素以添加边框，其外观由width、brush和shape指定，并对其进行裁剪。

修改元素以添加边框，其外观由width、color和shape指定，并对其进行裁剪。

绘制具有修改后的 alpha 的内容，该 alpha 可能小于 1。

在内容后面绘制具有纯色color的shape。

在内容后面绘制具有brush的shape。

将内容裁剪为shape。

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

在修改后的内容后面绘制到Canvas中。

在DrawScope中绘制内容，只要绘图区域的大小相同或读取的任何状态对象未更改，这些内容就会在绘制调用之间持续存在。

创建一个DrawModifier，允许开发人员在布局内容之前或之后进行绘制。

当交互发生时，为该组件绘制视觉效果。

使用 painter 绘制内容。

创建一个绘制阴影的 graphicsLayer。

添加填充以适应 安全绘制 内边距。

创建一个修饰符，用于控制同一布局父级子元素的绘制顺序。

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

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

此函数已弃用。 已由 focusTarget 替换

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

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

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

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

此修饰符允许您指定可供修饰符链中更下游的 focusTarget 或子布局节点访问的属性。

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

此修饰符可用于保存和恢复焦点组的焦点。

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

配置组件通过焦点系统或辅助功能“焦点”事件使其可聚焦。

每当当前焦点区域的边界发生变化时，都会调用 onPositioned。

一个使内容绘制到绘制图层的 Modifier.Node。

一个使内容绘制到绘制图层的 Modifier.Element。

一个添加绘制图层的 Modifier.Element，以便工具可以识别绘制图像中的元素。

将此 modifier 添加到组件的 modifier 参数，将允许它在自身（或其子元素之一）获得焦点时拦截硬件键盘事件。

将此 modifier 添加到组件的 modifier 参数，将允许它在自身（或其子元素之一）获得焦点时拦截硬件键盘事件。

替代 androidx.compose.ui.layout.layoutId，它允许使用 tag。

使用 layoutId 标记元素以在其父级中识别该元素。

创建一个 LayoutModifier，它允许更改包装元素的测量和布局方式。

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

一个Modifier，可以根据指定距离从其边界到对齐线添加填充以定位内容。

一个Modifier，可以根据指定距离从其边界到对齐线添加填充以定位内容。

一个Modifier，它将内容放置在布局中，使得从布局顶部到内容中第一行文本的基线的距离为top，并且从内容中最后一行文本的基线到布局底部的距离为bottom。

一个Modifier，它将内容放置在布局中，使得从布局顶部到内容中第一行文本的基线的距离为top，并且从内容中最后一行文本的基线到布局底部的距离为bottom。

以Dp的形式在内容的每个边缘应用额外的空间：left、top、right和bottom。

在内容的每个边缘（左、上、右和下）应用all dp 的额外空间。

将PaddingValues应用于组件，作为内容左、上、右和下每个边缘的额外空间。

在内容的左右边缘应用horizontal dp 空间，在内容的上下边缘应用vertical dp 空间。

以Dp的形式在内容的每个边缘应用额外的空间：start、top、end和bottom。

添加填充以适应标题栏内边距。

添加填充以适应显示切口。

添加填充以适应输入法编辑器内边距。

添加填充以适应强制系统手势内边距。

添加填充以适应导航栏内边距。

添加填充以适应安全内容内边距。

添加填充以适应安全手势内边距。

添加填充以适应状态栏内边距。

添加填充以适应系统栏内边距。

添加填充以适应系统手势内边距。

添加填充以适应瀑布内边距。

添加填充，以便内容不会进入insets空间。

允许开发人员定义一个指针图标，当光标悬停在元素上时显示。

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

允许跟踪指针（例如鼠标或触控板）移动事件的修饰符。

此函数已弃用。 Modifier.pointerInput 必须提供一个或多个“键”参数，这些参数定义修饰符的身份，并确定何时取消其先前的输入处理协程并为新键启动新的效果。

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

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

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

将内容偏移 offset px。

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

将内容偏移 offset px。

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

Modifier 占用 TabRow 内的所有可用宽度，然后根据 currentTabPosition 对其应用的指示器的偏移量进行动画处理。

Modifier 占用 TabRow 内的所有可用宽度，然后根据 currentTabPosition 对其应用的指示器的偏移量进行动画处理。

包含用于不确定进度指示器的 semantics，表示正在进行的操作。

包含用于确定性进度指示器或滑块的进度部分的 semantics，表示 valueRange 内的进度。

添加语义以表示步进器/滑块进度的修饰符。

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

向布局节点添加语义键/值对，用于测试、辅助功能等。

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

此函数已弃用。 使用 Modifier.pointerInput + PointerEventType.Scroll

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

从提供的 overscrollEffect 渲染过度滚动。

将此 modifier 添加到组件的 modifier 参数，将允许它拦截 RotaryScrollEvent（如果它或其子级处于焦点状态）。

将此 modifier 添加到组件的 modifier 参数，将允许它拦截 RotaryScrollEvent（如果它或其子级处于焦点状态）。

一个修饰符，用于将旋转事件与可滚动的容器（如 Column、LazyList 等）连接起来。

根据 ScrollState，垂直滚动某个条目进出视图。

根据 LazyListState，垂直滚动某个条目进出视图。

根据 ScalingLazyListState，垂直滚动某个条目进出视图。

此函数已弃用。 此重载为了与 Compose for Wear OS 1.1 保持向后兼容性。现在可以使用 wear.compose.foundation.lazy 包中的 ScalingLazyListState 的新重载。

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

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

在单个 Orientation 中配置 UI 元素的触摸滚动和抛掷。

在单个 Orientation 中配置 UI 元素的触摸滚动和抛掷。

此函数已弃用。 scrollableWithPivot 已弃用。

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

当子修饰符（或如果它已位于链的末尾，则为子可组合项）的大小发生变化时，此修饰符会对其自身的大小进行动画处理。

当子修饰符（或如果它已位于链的末尾，则为子可组合项）的大小发生变化时，此修饰符会对其自身的大小进行动画处理。

尝试通过以下顺序尝试匹配传入的约束之一来调整内容大小以匹配指定的纵横比：Constraints.maxWidth、Constraints.maxHeight、Constraints.minWidth、Constraints.minHeight（如果 matchHeightConstraintsFirst 为 false（默认为 false）），或者 Constraints.maxHeight、Constraints.maxWidth、Constraints.minHeight、Constraints.minWidth（如果 matchHeightConstraintsFirst 为 true）。

如果元素的测量尺寸较小，则保留至少 48.dp 的尺寸以消除触摸交互的歧义。

如果元素的测量尺寸较小，则保留至少 48.dp 的尺寸以消除触摸交互的歧义。

如果元素的测量尺寸较小，则保留至少 48.dp 的尺寸以消除触摸交互的歧义。

如果元素的测量尺寸较小，则保留至少 48.dp 的尺寸以消除触摸交互的歧义。

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

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

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

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

在首次测量元素或元素大小发生变化时，使用修改后的 Compose UI 元素的大小调用。

仅当包装布局未受到约束时才约束其大小：当传入的对应约束为 0 时，才会应用 minWidth 和 minHeight 约束。

使内容填充传入测量约束的 Constraints.maxHeight（可能仅部分填充），通过将 最小高度 和 最大高度 设置为 最大高度 乘以 fraction。

使内容填充传入测量约束的 Constraints.maxWidth 和 Constraints.maxHeight（可能仅部分填充），通过将 最小宽度 和 最大宽度 设置为 最大宽度 乘以 fraction，以及将 最小高度 和 最大高度 设置为 最大高度 乘以 fraction。

使内容填充传入测量约束的 Constraints.maxWidth（可能仅部分填充），通过将 最小宽度 和 最大宽度 设置为 最大宽度 乘以 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。

将内容的宽度限制在 mindp 和 maxdp 之间，前提是传入的测量 Constraints 允许。

允许内容根据其所需高度进行测量，而无需考虑传入的测量 最小高度约束，并且，如果 unbounded 为 true，则也不考虑传入的测量 最大高度约束。

允许内容根据其所需尺寸进行测量，而无需考虑传入的测量 最小宽度 或 最小高度 约束，并且，如果 unbounded 为 true，则也不考虑传入的最大约束。

允许内容根据其所需宽度进行测量，而无需考虑传入的测量 最小宽度约束，并且，如果 unbounded 为 true，则也不考虑传入的测量 最大宽度约束。

用于为 IconButton 和 TextButton 设置大小和推荐触摸目标的 Modifier。

将高度设置为屏幕 底部 的 insets 的高度。

将宽度设置为屏幕 末端 的 insets 的宽度，使用 左侧 或 右侧，具体取决于 LayoutDirection。

将宽度设置为屏幕 起始端 的 insets 的宽度，使用 左侧 或 右侧，具体取决于 LayoutDirection。

将高度设置为屏幕 顶部 的 insets 的高度。

根据元素相对于 Row 中其他加权兄弟元素的 weight，调整元素的宽度。

根据元素相对于 Column 中其他加权兄弟元素的 weight，调整元素的高度。

在所有其他内容元素测量完成后，调整元素的大小以匹配 Box 的大小。

通过将 最小高度 设置为等于 最大高度 乘以 fraction，使内容填充传入的测量约束的 Constraints.maxHeight。

通过将 最小宽度 设置为等于 最大宽度 乘以 fraction，以及将 最小高度 设置为等于 最大高度 乘以 fraction，使内容填充父级测量约束的 Constraints.maxWidth 和 Constraints.maxHeight。

通过将 最小宽度 设置为等于 最大宽度 乘以 fraction，使内容填充父级测量约束的 Constraints.maxWidth。

应用于作用域内放置的 ExposedDropdownMenu 的 Modifier。

应用于放置在 ExposedDropdownMenuBoxScope 内的菜单的 Modifier。

应用标签以允许在测试中找到修改后的元素。

设置可组合项的中心旋转的度数。

沿水平和垂直轴均匀地按相同的缩放因子缩放内容。

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

启用修改后的 UI 元素的变换手势。

启用修改后的 UI 元素的变换手势。

一个 Modifier，允许其应用到的元素被视为拖放操作的源。

如果修改后的内容太宽而无法适应可用空间，则应用动画跑马灯效果。

仅限于从视口边缘开始激活滑动以关闭。

使用指定的半径绘制模糊内容。

使用指定的半径绘制模糊内容。

可以用来发送 scrollIntoView 请求的 Modifier。

可以响应其子元素的 BringIntoViewRequester 请求，并滚动以使项目在屏幕上可见的父级。

声明一个 Modifier 的即时组合，该组合将为其修改的每个元素进行组合。

声明一个 Modifier 的即时组合，该组合将为其修改的每个元素进行组合。

声明一个 Modifier 的即时组合，该组合将为其修改的每个元素进行组合。

声明一个 Modifier 的即时组合，该组合将为其修改的每个元素进行组合。

声明一个 Modifier 的即时组合，该组合将为其修改的每个元素进行组合。

一个 Modifier，允许其应用到的元素被视为拖放操作的源。

允许接收拖放手势的 Modifier。

**此函数已弃用。** 使用 systemGestureExclusion

**此函数已弃用。** 使用 systemGestureExclusion

配置元素以充当手写检测器，该检测器检测手写笔手写并委托识别文本的处理到另一个元素。

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

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

**此函数已弃用。** 此 API 将比必要时创建更多 Modifier 的失效，因此不建议使用。

创建一个旨在帮助逐渐接近在预读传递中计算出的目标布局的预读布局。

显示一个 Magnifier 组件，该组件显示内容在 sourceCenter 相对于当前布局节点的放大版本。

一个 Modifier，可用于使用由此 Modifier 左侧的其他 Modifier 或布局树中此 Modifier 上方的其他 Modifier 提供的 ModifierLocal。

一个 Modifier，可用于提供 ModifierLocal，这些 ModifierLocal 可以被此 Modifier 右侧的其他 Modifier 或此 Modifier 附加到的布局节点的子 Modifier 读取。

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

在可组合项的顶部绘制一个占位符形状，并动画化擦除效果以移除占位符。

用于在组件上绘制占位符闪烁的 Modifier。

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

将布局矩形标记为优先保持远离浮动窗口。

标记本地布局坐标内的矩形，优先保持远离浮动窗口。

一个 Modifier，用于根据给定的 PullRefreshState 转换下拉刷新指示器的位移和缩放大小。

一个嵌套滚动 Modifier，它将滚动事件提供给 state。

一个嵌套滚动 Modifier，它提供 onPull 和 onRelease 回调以帮助构建自定义下拉刷新组件。

一个 Modifier，它向容器添加嵌套滚动以支持下拉刷新手势。

一个 Modifier，它处理下拉刷新指示器的大小、偏移量、裁剪、阴影和背景绘制，在实现自定义指示器时很有用。

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

将此 modifier 添加到组件的 modifier 参数，将允许它在硬件键盘事件发送到软件键盘之前拦截这些事件。

将此 modifier 添加到组件的 modifier 参数，将允许它在硬件键盘事件发送到软件键盘之前拦截这些事件。

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

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

将本地布局坐标内的矩形从系统手势中排除。

使用其他 insets Modifier 尚未使用的内边距，类似于 windowInsetsPadding，但不添加任何填充。

将 paddingValues 作为内边距使用，就像填充已添加且与内边距无关一样。

使用已使用的 WindowInsets 调用 block，这些内边距可能是由 consumeWindowInsets 或其中一个填充 Modifier（如 imePadding）使用的。

Modifier 应该应用于锚定可组合项，当希望在长按锚定可组合项后显示工具提示时。

此函数已弃用。使用带 MenuAnchorType 和 enabled 参数的重载

应应用于 ExposedDropdownMenuBoxScope 内部的元素（通常是文本字段或文本字段内的图标）的 Modifier。