Jetpack Compose ejecuta modificadores en distintas fases. En el siguiente desglose, se muestra a qué fase pertenecen los modificadores comunes y cuándo se evalúan sus argumentos o lambdas.
Fase 1: Composición
Estos modificadores evalúan los argumentos de forma síncrona dentro del cuerpo de @Composable. Cualquier lectura de estado aquí registra una dependencia con el alcance de reinicio del elemento componible y activa una recomposición completa cuando cambia.
- Modificadores de tamaño y dimensiones estáticas:
Modifier.size(dp),Modifier.width(dp),Modifier.height(dp)Modifier.fillMaxSize(),Modifier.fillMaxWidth(),Modifier.fillMaxHeight()Modifier.wrapContentSize(),Modifier.wrapContentWidth(),Modifier.wrapContentHeight()Modifier.requiredSize(),Modifier.defaultMinSize()Modifier.aspectRatio(ratio)Modifier.weight(weight)(enRowScopeoColumnScope)Modifier.width(IntrinsicSize.Min / Max)Modifier.height(IntrinsicSize.Min / Max)
- Espaciado y márgenes estáticos:
Modifier.padding(all = dp),Modifier.padding(start, top, end, bottom)Modifier.windowInsetsPadding(insets),Modifier.statusBarsPadding()
- Modificadores visuales de valor directo:
Modifier.alpha(float)(lee el estado durante la composición)Modifier.rotate(degrees)(lee el estado durante la composición)Modifier.scale(scaleX, scaleY)(lee el estado durante la composición)Modifier.background(color = Color, shape = Shape)Modifier.border(width, color, shape)Modifier.shadow(elevation, shape)Modifier.clip(shape)Modifier.blur(radius)
- Modificadores de posición estática:
Modifier.offset(x = dp, y = dp)(sobrecarga de valor directo)Modifier.absoluteOffset(x = dp, y = dp)
- Modificadores de elementos componibles dinámicos:
Modifier.composed { ... }(ejecuta el cuerpo de la fábrica durante la composición; no se recomienda para el rendimiento; usaModifier.Nodepara los modificadores personalizados en su lugar)
Fase 2: Fase de diseño
La fase de diseño se divide en dos pasos secundarios distintos con alcances de invalidación independientes:
Paso 2A: Medición
Determina el tamaño (width, height) y las restricciones. La lectura de estado aquí activa la nueva medición y la nueva posición:
Modifier.layout { measurable, constraints -> ... }: El código que se encuentra antes delayout(w, h)se ejecuta durante la medición.
Paso 2B: Devoluciones de llamada de posición y diseño
Determina la posición de la coordenada (x, y). La lectura de estado dentro de los bloques de posición activa solo la reubicación (omitiendo la medición y la composición):
Modifier.offset { IntOffset(x, y) }(sobrecarga de lambda)Modifier.absoluteOffset { IntOffset(x, y) }(sobrecarga de lambda)Modifier.layout { ... layout(w, h) { placeable.place(x, y) } }: Es el código dentro del bloquelayout(w, h) { ... }.
Las devoluciones de llamada de observación de diseño también se ejecutan durante o después del pase de diseño (evita escribir en el estado que se lee en la composición dentro de estas devoluciones de llamada, ya que, de lo contrario, se producen escrituras hacia atrás):
Modifier.onSizeChanged { intSize -> ... }: Se invoca después de que se completa la medición del diseño si cambiaron las dimensiones del nodo.Modifier.onPlaced { layoutCoordinates -> ... }yModifier.onLayoutRectChanged { ... }: Se invocan después de la ubicación para informar coordenadas o límites locales sin suscribirse a pases de diseño de ventanas globales.Modifier.onGloballyPositioned { layoutCoordinates -> ... }: Se invoca después de que finaliza todo el pase de diseño de la ventana cada vez que se mueve un nodo. EvitaonGloballyPositionedcuando sea posible; prefiereModifier.onVisibilityChangedpara el seguimiento del viewport,Modifier.onPlacedoModifier.onLayoutRectChangedpara los límites locales, orequireLayoutCoordinates()a pedido dentro de unModifier.Node.
Fase 3: Fase de dibujo
Estos modificadores se ejecutan durante el dibujo del lienzo. La lectura de estado dentro de estos bloques omite la composición y el diseño, y solo ejecuta el pase de dibujo:
Modifier.graphicsLayer { ... }:- Propiedades actualizadas en lambda:
alpha,translationX,translationY,scaleX,scaleY,rotationX,rotationY,rotationZ,shadowElevation,shape,clip,renderEffect,transformOrigin.
- Propiedades actualizadas en lambda:
Modifier.drawBehind { ... }:- Dibuja comandos de lienzo detrás del contenido componible.
Modifier.drawWithContent { ... }:- Controla el orden de dibujo con
drawContent().
- Controla el orden de dibujo con
Modifier.drawWithCache { ... }:- El bloque exterior se ejecuta cuando se producen cambios de tamaño o diseño para almacenar en caché los objetos
Path,PaintoBrush;onDrawBehindoonDrawWithContentse ejecutan en cada dibujo de fotograma.
- El bloque exterior se ejecuta cuando se producen cambios de tamaño o diseño para almacenar en caché los objetos
Fuera del bucle de recomposición: modificadores de observación
Algunos modificadores operan fuera de las tres fases de fotogramas para controlar la accesibilidad, la entrada del usuario y las observaciones del ciclo de vida.
Semántica y accesibilidad
Procesa las propiedades semánticas para los servicios de accesibilidad (TalkBack) y las pruebas:
Modifier.semantics { ... }Modifier.clearAndSetSemantics { ... }
Entrada, gestos y eventos
Funciona fuera de la canalización de renderización de fotogramas de tres fases, ya que recibe eventos de movimiento del SO y las interacciones del usuario:
Modifier.pointerInput(key) { detectTapGestures { ... } }/detectDragGestures/awaitPointerEventScopeModifier.clickable(enabled, onClickLabel) { ... }Modifier.combinedClickable { ... }Modifier.toggleable { ... }Modifier.selectable { ... }Modifier.draggable(...)/Modifier.scrollable(...)/Modifier.draggable2D(...)Modifier.onFocusChanged { focusState -> ... }Modifier.onKeyEvent { keyEvent -> ... }Modifier.onVisibilityChanged { isVisible -> ... }: Se invoca la devolución de llamada cuando cambia la visibilidad de un elemento componible después de la demora configurada, en una corrutina.
Referencia rápida: Fase de valor frente a fase lambda
Leer un valor de estado en una expresión lambda difiere la lectura a una fase posterior, lo que omite las fases anteriores cuando cambia ese estado:
| Modificador / patrón | Valor directo (composición) | Variante lambda (fase diferida) | Cuando cambia el estado |
|---|---|---|---|
| Desplazamiento | Modifier.offset(x, y) |
Modifier.offset { IntOffset(x, y) } |
Diseño (ubicación) (omite la composición) |
| Alfa / Opacidad | Modifier.alpha(alpha) |
Modifier.graphicsLayer { this.alpha = alpha } |
Dibujo (omite la composición y el diseño) |
| Rotación | Modifier.rotate(degrees) |
Modifier.graphicsLayer { rotationZ = degrees } |
Dibujo (omite la composición y el diseño) |
| Escala | Modifier.scale(scale) |
Modifier.graphicsLayer { scaleX = s; scaleY = s } |
Dibujo (omite la composición y el diseño) |
| Traducción | Modifier.padding(...) |
Modifier.graphicsLayer { translationX = ... } |
Dibujo (omite la composición y el diseño) |
| Color de fondo | Modifier.background(color) |
Modifier.drawBehind { drawRect(color) } |
Dibujo (omite la composición y el diseño) |
| Desplazamiento o paralaje | Modifier.offset(scroll.dp) |
Modifier.offset { IntOffset(0, scroll) } |
Diseño (ubicación) (omite la composición) |
Asignación de la interfaz Modifier.Node
En el caso de los modificadores personalizados que usan la API de Modifier.Node de alto rendimiento, las fases se asignan directamente a las interfaces de capacidad de los nodos:
| Fase | Interfaz de Modifier.Node |
Métodos principales |
|---|---|---|
| Diseño (medición y ubicación) | LayoutModifierNode |
measure(measurable, constraints) |
| Diseño (coordenadas globales) | GlobalPositionAwareModifierNode (preferiblemente requireLayoutCoordinates() on demand) |
onGloballyPositioned(coordinates) |
| Diseño (posición) | LayoutAwareModifierNode |
onRemeasured(size), onPlaced(coordinates) |
| Dibujo | DrawModifierNode |
draw(ContentDrawScope) |
| Entrada / puntero | PointerInputModifierNode |
onPointerEvent(...), onCancelPointerInput() |
| Semántica | SemanticsModifierNode |
applySemantics(SemanticsPropertyReceiver) |
| Enfoque | FocusEventModifierNode |
onFocusEvent(focusState) |