Compose 수정자 목록

작업

범위: 모두
@ExperimentalFoundationApi
<T : Any?> Modifier.anchoredDraggable(
    state: AnchoredDraggableState<T>,
    orientation: Orientation,
    enabled: Boolean,
    reverseDirection: Boolean,
    interactionSource: MutableInteractionSource?
)

사전 정의된 값 집합 간에 드래그 동작을 사용 설정합니다.

범위: 모두
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: suspend CoroutineScope.(startedPosition: Offset) -> Unit,
    onDragStopped: suspend CoroutineScope.(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에서 UI 요소의 터치 드래그를 설정합니다.

범위: 모두

Tab 또는 RadioButton과 같은 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

alignmentLinealignBy로도 구성된 동위 요소와 정렬되도록 요소를 세로로 배치합니다.

범위: RowScope

첫 번째 기준이 alignByBaseline 또는 alignBy로도 구성된 동위 요소와 정렬되도록 요소를 세로로 배치합니다.

범위: ColumnScope

요소를 Column 내에서 가로로 정렬합니다.

범위: ColumnScope
Modifier.alignBy(alignmentLineBlock: (Measured) -> Int)

alignmentLineBlock에 의해 결정되는 콘텐츠의 정렬선이 alignBy로도 구성된 동위 요소와 정렬되도록 요소를 가로로 배치합니다.

범위: ColumnScope

alignmentLinealignBy로도 구성된 동위 요소와 정렬되도록 요소를 가로로 배치합니다.

범위: BoxScope
Modifier.align(alignment: Alignment)

콘텐츠 요소를 Box 내의 특정 Alignment로 가져옵니다.

애니메이션

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

animateEnterExit 수정자를 AnimatedVisibility의 직접 또는 간접 하위 요소에 사용하여 AnimatedVisibility에 지정된 것과 다른 들어가기/나가기 애니메이션을 만들 수 있습니다.

이 수정자는 Lazy 목록 내에서 항목 배치에 애니메이션을 적용합니다.

이 수정자는 그리드 내의 항목 배치에 애니메이션을 적용합니다.

테두리

범위: 모두
Modifier.border(border: BorderStroke, shape: Shape)

요소를 수정하여 bordershape로 지정된 모양으로 테두리를 추가하고 자릅니다.

범위: 모두
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)

1보다 작을 수 있는 수정된 알파를 사용하여 콘텐츠를 그립니다.

범위: 모두
Modifier.background(color: Color, shape: Shape)

콘텐츠 뒤에 실선 colorshape를 그립니다.

범위: 모두
Modifier.background(
    brush: Brush,
    shape: Shape,
    alpha: @FloatRange(from = 0.0, to = 1.0) Float
)

콘텐츠 뒤에 brushshape를 그립니다.

범위: 모두
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
)

콘텐츠의 전역 위치가 변경되었을 수 있다면 요소의 LayoutCoordinatesonGloballyPositioned를 호출합니다.

패딩

범위: 모두
Modifier.paddingFrom(alignmentLine: AlignmentLine, before: Dp, after: Dp)

경계에서 alignment line까지 지정된 거리에 따라 콘텐츠를 배치하기 위해 패딩을 추가할 수 있는 Modifier입니다.

범위: 모두
Modifier.paddingFrom(
    alignmentLine: AlignmentLine,
    before: TextUnit,
    after: TextUnit
)

경계에서 alignment line까지 지정된 거리에 따라 콘텐츠를 배치하기 위해 패딩을 추가할 수 있는 Modifier입니다.

범위: 모두
Modifier.paddingFromBaseline(top: Dp, bottom: Dp)

레이아웃 상단에서 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입니다.

범위: 모두
Modifier.absolutePadding(left: Dp, top: Dp, right: Dp, bottom: Dp)

Dp의 콘텐츠 가장자리를 따라 left, top, right, bottom에 추가 공간을 적용합니다.

범위: 모두

콘텐츠 왼쪽, 상단, 오른쪽, 하단의 각 가장자리를 따라 alldp의 추가 공간을 적용합니다.

범위: 모두
Modifier.padding(paddingValues: PaddingValues)

PaddingValues를 콘텐츠 왼쪽, 상단, 오른쪽, 하단의 각 가장자리를 따라 추가 공간으로 구성요소에 적용합니다.

범위: 모두
Modifier.padding(horizontal: Dp, vertical: Dp)

콘텐츠의 왼쪽 및 오른쪽 가장자리를 따라 horizontaldp 공간을, 상단 및 하단 가장자리를 따라 verticaldp 공간을 적용합니다.

범위: 모두
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 공간에 들어가지 않도록 패딩을 추가합니다.

포인터

범위: 모두
Modifier.pointerHoverIcon(
    icon: PointerIcon,
    overrideDescendants: Boolean
)

개발자가 요소 위로 커서를 가져가면 표시할 포인터 아이콘을 정의할 수 있는 수정자입니다.

범위: 모두
@ExperimentalComposeUiApi
Modifier.pointerInteropFilter(
    requestDisallowInterceptTouchEvent: RequestDisallowInterceptTouchEvent?,
    onTouchEvent: (MotionEvent) -> Boolean
)

원래 Compose에 전달된 기본 MotionEvent의 액세스를 제공하는 특수 PointerInputModifier입니다.

범위: 모두
@ExperimentalComposeUiApi
Modifier.pointerMoveFilter(
    onMove: (position: Offset) -> Boolean,
    onExit: () -> Boolean,
    onEnter: () -> Boolean
)

포인터 (예: 마우스 또는 트랙패드) 이동 이벤트를 추적할 수 있는 수정자입니다.

범위: 모두
Modifier. pointerInput(block: suspend PointerInputScope.() -> Unit)

이 함수는 지원 중단되었습니다. Modifier.pointerInput은 수정자의 ID를 정의하고 이전 입력 처리 코루틴을 취소해야 하는 시점과 새로운 키에 대한 새로운 효과를 시작할 시점을 결정하는 하나 이상의 '키' 매개변수를 제공해야 합니다.

범위: 모두
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)

수정된 요소의 영역 내에서 포인터 입력을 처리하기 위한 수정자를 만듭니다.

위치

범위: 모두

콘텐츠를 offsetpx로 오프셋합니다.

범위: 모두

(xdp, ydp)로 콘텐츠를 오프셋합니다.

범위: 모두
Modifier.offset(offset: Density.() -> IntOffset)

콘텐츠를 offsetpx로 오프셋합니다.

범위: 모두
Modifier.offset(x: Dp, y: Dp)

(xdp, ydp)로 콘텐츠를 오프셋합니다.

Modifier.tabIndicatorOffset(currentTabPosition: TabPosition)

TabRow 내에서 사용 가능한 모든 너비를 차지하며 currentTabPosition에 따라 적용되는 표시기의 오프셋을 애니메이션으로 보여주는 Modifier입니다.

Modifier.tabIndicatorOffset(currentTabPosition: TabPosition)

TabRow 내에서 사용 가능한 모든 너비를 차지하며 currentTabPosition에 따라 적용되는 표시기의 오프셋을 애니메이션으로 보여주는 Modifier입니다.

시맨틱

범위: 모두

비확정 진행 상황 표시기에 필요한 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
)

스테퍼/슬라이더의 진행 상황을 나타내는 시맨틱을 추가하는 수정자입니다.

범위: 모두

모든 하위 노드의 시맨틱을 지우고 새 시맨틱을 설정합니다.

범위: 모두
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.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
)

이 함수는 지원 중단되었습니다. 이 오버로드는 Wear OS 1.1용 Compose와의 하위 호환성을 위해 제공됩니다. 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에서 UI 요소의 터치 스크롤 및 플링을 설정합니다.

범위: 모두
@ExperimentalFoundationApi
Modifier.scrollable(
    state: ScrollableState,
    orientation: Orientation,
    overscrollEffect: OverscrollEffect?,
    enabled: Boolean,
    reverseDirection: Boolean,
    flingBehavior: FlingBehavior?,
    interactionSource: MutableInteractionSource?,
    bringIntoViewSpec: BringIntoViewSpec
)

단일 Orientation에서 UI 요소의 터치 스크롤 및 플링을 설정합니다.

범위: 모두
@ExperimentalTvFoundationApi
Modifier.scrollableWithPivot(
    state: ScrollableState,
    orientation: Orientation,
    pivotOffsets: PivotOffsets,
    enabled: Boolean,
    reverseDirection: Boolean
)

단일 Orientation에서 UI 요소의 터치 스크롤 및 플링을 설정합니다.

범위: 모두

Android R 이상에서 소프트 키보드를 중첩 스크롤로 제어합니다.

크기

범위: 모두
Modifier.animateContentSize(
    animationSpec: FiniteAnimationSpec<IntSize>,
    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(matchHeightConstraintsFirstfalse(기본값)) 또는 Constraints.maxHeight, Constraints.maxWidth, Constraints.minHeight, Constraints.minWidth(matchHeightConstraintsFirsttrue인 경우)의 순서로 콘텐츠의 크기를 지정하여 지정된 가로세로 비율과 일치하도록 콘텐츠 크기를 조정하려고 합니다.

범위: 모두

요소가 더 작게 측정되는 경우 터치 상호작용을 구별하기 위해 최소 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)

달리 제한되지 않은 경우에만 래핑된 레이아웃의 크기를 제한합니다. minWidthminHeight 제약조건은 수신되는 해당 제약조건이 0인 경우에만 적용됩니다.

범위: 모두
Modifier.fillMaxHeight(fraction: @FloatRange(from = 0.0, to = 1.0) Float)

minimum heightmaximum heightmaximum heightfraction를 곱한 값과 동일하게 설정하여 콘텐츠가 수신되는 측정 제약 조건의 Constraints.maxHeight (일부만)를 채우도록 합니다.

범위: 모두
Modifier.fillMaxSize(fraction: @FloatRange(from = 0.0, to = 1.0) Float)

minimum widthmaximum widthmaximum widthfraction를 곱한 값, minimum heightmaximum heightmaximum heightfraction를 곱한 값과 동일하게 설정하여 콘텐츠가 수신되는 측정 제약 조건의 Constraints.maxWidthConstraints.maxHeight를 (일부만) 채우도록 합니다.

범위: 모두
Modifier.fillMaxWidth(fraction: @FloatRange(from = 0.0, to = 1.0) Float)

minimum widthmaximum widthmaximum widthfraction를 곱한 값과 동일하게 설정하여 콘텐츠가 수신되는 측정 제약 조건의 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의 크기와 일치하도록 요소의 크기를 조정합니다.

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

minimum heightmaximum heightfraction을 곱한 값과 동일하게 설정하여 콘텐츠가 수신 측정 제약 조건의 Constraints.maxHeight를 채우도록 합니다.

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

minimum widthmaximum widthfraction을 곱한 값, minimum heightmaximum heightfraction를 곱한 값과 동일하게 설정하여 콘텐츠가 상위 측정 제약 조건의 Constraints.maxWidthConstraints.maxHeight를 채우도록 합니다.

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

minimum widthmaximum widthfraction을 곱한 값과 동일하게 설정하여 콘텐츠가 상위 측정 제약 조건의 Constraints.maxWidth를 채우도록 합니다.

Modifier.exposedDropdownSize(matchTextFieldWidth: Boolean)

범위 내에 있는 ExposedDropdownMenu에 적용해야 하는 수정자입니다.

Modifier.exposedDropdownSize(matchTextFieldWidth: Boolean)

범위 내에 있는 ExposedDropdownMenu에 적용해야 하는 수정자입니다.

테스트

범위: 모두

테스트에서 수정된 요소를 찾을 수 있도록 태그를 적용합니다.

변환

범위: 모두
Modifier.rotate(degrees: Float)

뷰가 컴포저블의 중심 주위를 회전하는 각도를 설정합니다.

범위: 모두
Modifier.scale(scale: Float)

가로축과 세로축의 콘텐츠를 동일한 배율로 균일하게 조정합니다.

범위: 모두
Modifier.scale(scaleX: Float, scaleY: Float)

각각 가로축과 세로축을 따라서 다음 배율로 컴포저블의 콘텐츠를 조정합니다.

범위: 모두
Modifier.transformable(
    state: TransformableState,
    lockRotationOnZoomPan: Boolean,
    enabled: Boolean
)

수정된 UI 요소의 변환 동작을 사용 설정합니다.

범위: 모두
@ExperimentalFoundationApi
Modifier.transformable(
    state: TransformableState,
    canPan: (Offset) -> Boolean,
    lockRotationOnZoomPan: Boolean,
    enabled: Boolean
)

수정된 UI 요소의 변환 동작을 사용 설정합니다.

기타

범위: 모두

적용되는 요소를 드래그 앤 드롭 작업의 소스처럼 취급하도록 허용하는 수정자입니다.

범위: 모두
@ExperimentalFoundationApi
Modifier.basicMarquee(
    iterations: Int,
    animationMode: MarqueeAnimationMode,
    delayMillis: Int,
    initialDelayMillis: Int,
    spacing: MarqueeSpacing,
    velocity: Dp
)

너무 넓어서 사용 가능한 공간에 맞지 않는 경우 수정된 콘텐츠에 애니메이션 마키 효과를 적용합니다.

범위: 모두
Modifier.blur(radius: Dp, edgeTreatment: BlurredEdgeTreatment)

지정된 반지름으로 흐리게 처리된 콘텐츠를 그립니다.

범위: 모두
Modifier.blur(
    radiusX: Dp,
    radiusY: Dp,
    edgeTreatment: BlurredEdgeTreatment
)

지정된 반지름으로 흐리게 처리된 콘텐츠를 그립니다.

범위: 모두

bringIntoView 요청을 전송하는 데 사용할 수 있는 수정자입니다.

범위: 모두

하위 요소의 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(
    onStarted: (event: DragAndDropEvent) -> Boolean,
    onDropped: (event: DragAndDropEvent) -> Boolean,
    onEntered: (event: DragAndDropEvent) -> Unit,
    onMoved: (event: DragAndDropEvent) -> Unit,
    onChanged: (event: DragAndDropEvent) -> Unit,
    onExited: (event: DragAndDropEvent) -> Unit,
    onEnded: (event: DragAndDropEvent) -> Unit
)

드래그 앤 드롭 동작에서 수신할 수 있는 수정자입니다.

범위: 모두

이 함수는 지원 중단되었습니다. systemGestureExclusion 사용

범위: 모두

이 함수는 지원 중단되었습니다. systemGestureExclusion 사용

범위: 모두
Modifier.hoverable(
    interactionSource: MutableInteractionSource,
    enabled: Boolean
)

포인터 들어가기/나가기 이벤트를 통해 마우스 오버가 가능하도록 구성요소를 설정합니다.

범위: 모두
inline
Modifier.inspectable(
    noinline inspectorInfo: InspectorInfo.() -> Unit,
    factory: Modifier.() -> Modifier
)

공통된 수정자 집합을 그룹화하고 결과 수정자에 InspectorInfo를 제공하는 데 사용합니다.

범위: 모두

현재 레이아웃에서 전방 탐색 (즉, 미리 계산된 미래) 레이아웃으로 레이아웃을 모핑하는 데 도움이 되는 중간 레이아웃을 만듭니다.

범위: 모두
Modifier.magnifier(
    sourceCenter: Density.() -> Offset,
    magnifierCenter: Density.() -> Offset,
    onSizeChanged: ((DpSize) -> Unit)?,
    zoom: Float,
    size: DpSize,
    cornerRadius: Dp,
    elevation: Dp,
    clippingEnabled: Boolean
)

현재 레이아웃 노드를 기준으로 sourceCenter의 확대된 콘텐츠 버전을 보여주는 Magnifier 위젯을 표시합니다.

범위: 모두

레이아웃 트리에서 다른 수정자가 이 수정자의 왼쪽 또는 위쪽에 제공한 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에서 수신하는 각 MotionEventwatcher를 호출합니다.

범위: 모두

플로팅 창을 피하는 것이 선호되는 것으로 레이아웃 직사각형을 표시합니다.

범위: 모두

로컬 레이아웃 좌표 내에 플로팅 창을 피하고 싶은 직사각형을 표시합니다.

범위: 모두

지정된 PullRefreshState에 따라 위치를 변환하고 당겨서 새로고침 표시기의 크기를 조정하는 수정자입니다.

범위: 모두

state에 스크롤 이벤트를 제공하는 중첩 스크롤 수정자입니다.

범위: 모두
@ExperimentalMaterialApi
Modifier.pullRefresh(
    onPull: (pullDelta: Float) -> Float,
    onRelease: suspend (flingVelocity: Float) -> Float,
    enabled: Boolean
)

중첩된 스크롤 수정자로, 맞춤 가져오기 새로고침 구성요소를 빌드하는 데 도움이 되도록 onPullonRelease 콜백을 제공합니다.

범위: 모두
@ExperimentalComposeUiApi
Modifier.onInterceptKeyBeforeSoftKeyboard(
    onInterceptKeyBeforeSoftKeyboard: (KeyEvent) -> Boolean
)

modifier를 구성요소의 modifier 매개변수에 추가하면 하드웨어 키 이벤트가 소프트웨어 키보드로 전송되기 전에 이 이벤트를 가로챌 수 있습니다.

범위: 모두
@ExperimentalComposeUiApi
Modifier.onPreInterceptKeyBeforeSoftKeyboard(
    onPreInterceptKeyBeforeSoftKeyboard: (KeyEvent) -> Boolean
)

modifier를 구성요소의 modifier 매개변수에 추가하면 하드웨어 키 이벤트가 소프트웨어 키보드로 전송되기 전에 이 이벤트를 가로챌 수 있습니다.

범위: 모두
Modifier.edgeSwipeToDismiss(
    swipeToDismissBoxState: SwipeToDismissBoxState,
    edgeWidth: Dp
)

표시 영역의 가장자리에서만 활성화되도록 스와이프를 제한합니다.

범위: 모두
Modifier. edgeSwipeToDismiss(
    swipeToDismissBoxState: SwipeToDismissBoxState,
    edgeWidth: Dp
)

이 함수는 지원 중단되었습니다. SwipeToDismiss를 androidx.wear.compose.foundation으로 이전했습니다.

범위: 모두

시스템 동작에서 레이아웃 직사각형을 제외합니다.

범위: 모두

로컬 레이아웃 좌표 내의 직사각형을 시스템 동작에서 제외합니다.

범위: 모두

패딩을 추가하지 않고 windowInsetsPadding과 유사한 다른 인셋 수정자에 의해 아직 소비되지 않은 인셋을 사용합니다.

범위: 모두

인셋과 관계없이 패딩이 추가된 것처럼 paddingValues를 인셋으로 사용합니다.

범위: 모두
Modifier.onConsumedWindowInsetsChanged(
    block: (consumedWindowInsets: WindowInsets) -> Unit
)

consumeWindowInsets 또는 패딩 수정자 중 하나(예: imePadding)에서 소비한 WindowInsetsblock를 호출합니다.

앵커 컴포저블을 길게 누른 후 도움말을 표시할 때 앵커 컴포저블에 적용해야 하는 Modifier입니다.

범위 내에 있는 TextField (또는 OutlinedTextField)에 적용해야 하는 수정자입니다.