Lista de modificadores do Compose

Ações

Escopo: qualquer
@ExperimentalFoundationApi
<T : Any?> Modifier.anchoredDraggable(
    state: AnchoredDraggableState<T>,
    orientation: Orientation,
    enabled: Boolean,
    interactionSource: MutableInteractionSource?,
    overscrollEffect: OverscrollEffect?,
    startDragImmediately: Boolean
)

Ative gestos de arrasto entre um conjunto de valores predefinidos.

Escopo: qualquer
@ExperimentalFoundationApi
<T : Any?> Modifier.anchoredDraggable(
    state: AnchoredDraggableState<T>,
    reverseDirection: Boolean,
    orientation: Orientation,
    enabled: Boolean,
    interactionSource: MutableInteractionSource?,
    overscrollEffect: OverscrollEffect?,
    startDragImmediately: Boolean
)

Ative gestos de arrasto entre um conjunto de valores predefinidos.

Escopo: qualquer
Modifier.clickable(
    enabled: Boolean,
    onClickLabel: String?,
    role: Role?,
    onClick: () -> Unit
)

Configure o componente para receber cliques por evento de clique de entrada ou acessibilidade.

Escopo: qualquer
Modifier.clickable(
    interactionSource: MutableInteractionSource?,
    indication: Indication?,
    enabled: Boolean,
    onClickLabel: String?,
    role: Role?,
    onClick: () -> Unit
)

Configure o componente para receber cliques por evento de clique de entrada ou acessibilidade.

Escopo: qualquer
@ExperimentalFoundationApi
Modifier.combinedClickable(
    enabled: Boolean,
    onClickLabel: String?,
    role: Role?,
    onLongClickLabel: String?,
    onLongClick: (() -> Unit)?,
    onDoubleClick: (() -> Unit)?,
    onClick: () -> Unit
)

Configure o componente para receber cliques simples, duplos e longos por um evento de clique de entrada ou acessibilidade.

Escopo: qualquer
@ExperimentalFoundationApi
Modifier.combinedClickable(
    interactionSource: MutableInteractionSource?,
    indication: Indication?,
    enabled: Boolean,
    onClickLabel: String?,
    role: Role?,
    onLongClickLabel: String?,
    onLongClick: (() -> Unit)?,
    onDoubleClick: (() -> Unit)?,
    onClick: () -> Unit
)

Configure o componente para receber cliques simples, duplos e longos por um evento de clique de entrada ou acessibilidade.

Escopo: qualquer
@ExperimentalFoundationApi
Modifier.mouseClickable(
    enabled: Boolean,
    onClickLabel: String?,
    role: Role?,
    onClick: MouseClickScope.() -> Unit
)

Cria um modificador semelhante ao Modifier.clickable, mas fornece mais contexto com informações sobre botões pressionados e modificadores do teclado

Escopo: qualquer
@ExperimentalFoundationApi
Modifier.draggable2D(
    state: Draggable2DState,
    enabled: Boolean,
    interactionSource: MutableInteractionSource?,
    startDragImmediately: Boolean,
    onDragStarted: (startedPosition: Offset) -> Unit,
    onDragStopped: (velocity: Velocity) -> Unit,
    reverseDirection: Boolean
)

Configure o recurso de arrastar com toque para o elemento da IU nas duas orientações.

Escopo: qualquer
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
)

Configure o recurso de arrastar com toque para o elemento da IU em uma única Orientation.

Escopo: qualquer

Use esse modificador para agrupar uma lista de itens selectable, como Tabs ou RadioButtons, para fins de acessibilidade.

Escopo: qualquer
Modifier.selectable(
    selected: Boolean,
    enabled: Boolean,
    role: Role?,
    onClick: () -> Unit
)

Configure o componente para ser selecionável, geralmente como parte de um grupo mutuamente exclusivo, em que apenas um item pode ser selecionado a qualquer momento.

Escopo: qualquer
Modifier.selectable(
    selected: Boolean,
    interactionSource: MutableInteractionSource?,
    indication: Indication?,
    enabled: Boolean,
    role: Role?,
    onClick: () -> Unit
)

Configure o componente para ser selecionável, geralmente como parte de um grupo mutuamente exclusivo, em que apenas um item pode ser selecionado a qualquer momento.

Escopo: qualquer
@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
)

Essa função foi descontinuada. O recurso Swipeable do Material Design foi substituído pelas APIs AnchoredDraggable da Foundation.

Escopo: qualquer
@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
)

Ative gestos de deslizar entre um conjunto de estados predefinidos.

Escopo: qualquer
Modifier.toggleable(
    value: Boolean,
    enabled: Boolean,
    role: Role?,
    onValueChange: (Boolean) -> Unit
)

Configure o componente para torná-lo alternável usando eventos de entrada e acessibilidade.

Escopo: qualquer
Modifier.toggleable(
    value: Boolean,
    interactionSource: MutableInteractionSource?,
    indication: Indication?,
    enabled: Boolean,
    role: Role?,
    onValueChange: (Boolean) -> Unit
)

Configure o componente para torná-lo alternável usando eventos de entrada e acessibilidade.

Escopo: qualquer
Modifier.triStateToggleable(
    state: ToggleableState,
    enabled: Boolean,
    role: Role?,
    onClick: () -> Unit
)

Configure o componente para torná-lo alternável usando eventos de entrada e acessibilidade com três estados: ativado, desativado e indeterminado.

Escopo: qualquer
Modifier.triStateToggleable(
    state: ToggleableState,
    interactionSource: MutableInteractionSource?,
    indication: Indication?,
    enabled: Boolean,
    role: Role?,
    onClick: () -> Unit
)

Configure o componente para torná-lo alternável usando eventos de entrada e acessibilidade com três estados: ativado, desativado e indeterminado.

Alinhamento

Escopo: RowScope

Alinhe o elemento verticalmente dentro da Row.

Escopo: RowScope
Modifier.alignBy(alignmentLineBlock: (Measured) -> Int)

Posicione o elemento verticalmente para que a linha de alinhamento do conteúdo determinada pelo alignmentLineBlock se alinhe com elementos irmãos, também configurados como alignBy.

Escopo: RowScope

Posicione o elemento verticalmente para que a alignmentLine se alinhe com elementos irmãos, também configurados como alignBy.

Escopo: RowScope

Posicione o elemento verticalmente para que a primeira linha de base se alinhe com elementos irmãos, também configurados como alignByBaseline ou alignBy.

Escopo: ColumnScope

Alinhe o elemento horizontalmente dentro da Column.

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

Posicione o elemento horizontalmente para que a linha de alinhamento do conteúdo determinada pelo alignmentLineBlock se alinhe com elementos irmãos, também configurados como alignBy.

Escopo: ColumnScope

Posicione o elemento horizontalmente de modo que a alignmentLine dele fique alinhada com os elementos irmãos, também configurados como alignBy.

Escopo: BoxScope
Modifier.align(alignment: Alignment)

Extraia o elemento de conteúdo para um Alignment específico da Box.

Animation

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

O modificador animateEnterExit pode ser usado para qualquer filho direto ou indireto de AnimatedVisibility a fim de criar uma animação de entrada/saída diferente da especificada na AnimatedVisibility.

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

Esse modificador anima a aparência do item (esmaecimento), o desaparecimento (esmaecimento) e as mudanças de posicionamento (como a reordenação de um item).

Essa função foi descontinuada. Use Modifier.animateItem()

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

Esse modificador anima a aparência (aparecimento gradual), o desaparecimento (esmaecimento) e as mudanças de posicionamento (como um reorganização de itens).

Essa função foi descontinuada. Use Modifier.animateItem()

Borda

Escopo: qualquer
Modifier.border(border: BorderStroke, shape: Shape)

Modifique o elemento para adicionar uma borda com a aparência especificada por uma border e uma shape e corte-o.

Escopo: qualquer
Modifier.border(width: Dp, brush: Brush, shape: Shape)

Modifique o elemento para adicionar uma borda com a aparência especificada por uma width, uma brush e uma shape e corte-o.

Escopo: qualquer
Modifier.border(width: Dp, color: Color, shape: Shape)

Modifique o elemento para adicionar uma borda com a aparência especificada por uma width, um color e uma shape e corte-o.

Desenho

Escopo: qualquer
Modifier.alpha(alpha: Float)

Desenhe conteúdo com alpha modificado que possa ser menor que 1.

Escopo: qualquer
Modifier.background(color: Color, shape: Shape)

Desenhe uma shape com uma color sólida atrás do conteúdo.

Escopo: qualquer
Modifier.background(
    brush: Brush,
    shape: Shape,
    alpha: @FloatRange(from = 0.0, to = 1.0) Float
)

Desenhe uma shape com um brush atrás do conteúdo.

Escopo: qualquer
Modifier.clip(shape: Shape)

Corte o conteúdo para shape.

Escopo: qualquer

Corte o conteúdo para os limites de uma camada definida neste modificador.

Escopo: qualquer
Modifier.drawBehind(onDraw: DrawScope.() -> Unit)

Desenhe em uma Canvas atrás do conteúdo modificado.

Escopo: qualquer
Modifier.drawWithCache(onBuildDrawCache: CacheDrawScope.() -> DrawResult)

Desenhe em um DrawScope com conteúdo que persista em chamadas de desenho, desde que o tamanho da área de desenho seja o mesmo ou que os objetos de estado lidos não tenham mudado.

Escopo: qualquer

Crie um DrawModifier que permita ao desenvolvedor desenhar antes ou depois do conteúdo do layout.

Escopo: qualquer
Modifier.indication(
    interactionSource: InteractionSource,
    indication: Indication?
)

Desenhe efeitos visuais para este componente quando houver interações.

Escopo: qualquer
Modifier.paint(
    painter: Painter,
    sizeToIntrinsics: Boolean,
    alignment: Alignment,
    contentScale: ContentScale,
    alpha: Float,
    colorFilter: ColorFilter?
)

Pinte o conteúdo usando painter.

Escopo: qualquer
Modifier.shadow(
    elevation: Dp,
    shape: Shape,
    clip: Boolean,
    ambientColor: Color,
    spotColor: Color
)

Crie um graphicsLayer que mostre uma sombra.

Escopo: qualquer

Adiciona padding para acomodar os encartes de safe drawing.

Escopo: qualquer
Modifier.zIndex(zIndex: Float)

Crie um modificador que controle a ordem de desenho para os filhos do mesmo layout pai.

Foco

Escopo: qualquer
Modifier.onFocusChanged(onFocusChanged: (FocusState) -> Unit)

Adicione esse modificador a um componente para observar eventos de estado de foco.

Escopo: qualquer
Modifier.onFocusEvent(onFocusEvent: (FocusState) -> Unit)

Adicione esse modificador a um componente para observar eventos de estado de foco.

Escopo: qualquer

Essa função foi descontinuada. Foi substituída por focusTarget.

Escopo: qualquer

Adicione esse modificador a um componente para torná-lo focalizável.

Escopo: qualquer
Modifier. focusOrder(focusOrderReceiver: FocusOrder.() -> Unit)

Essa função foi descontinuada. Use focusProperties().

Escopo: qualquer
Modifier. focusOrder(focusRequester: FocusRequester)

Essa função foi descontinuada. Use focusRequester().

Escopo: qualquer
Modifier. focusOrder(
    focusRequester: FocusRequester,
    focusOrderReceiver: FocusOrder.() -> Unit
)

Essa função foi descontinuada. Use focusProperties() e focusRequester().

Escopo: qualquer

Esse modificador permite especificar propriedades acessíveis para focusTargets mais abaixo na cadeia de modificadores ou em nós de layout filhos.

Escopo: qualquer

Adicione esse modificador a um componente para solicitar mudanças no foco.

Escopo: qualquer

Esse modificador pode ser usado para salvar e restaurar o foco em um grupo de foco.

Escopo: qualquer

Crie um grupo de foco ou marque esse componente como um grupo de foco.

Escopo: qualquer
Modifier.focusable(
    enabled: Boolean,
    interactionSource: MutableInteractionSource?
)

Configure o componente para ser focalizável pelo sistema de foco ou pelo evento de foco de acessibilidade.

Escopo: qualquer

Chame onPositioned sempre que os limites da área atualmente em foco mudarem.

Gráficos

Escopo: qualquer

Um Modifier.Node que faz o conteúdo ser desenhado em uma camada de desenho.

Escopo: qualquer
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
)

Um Modifier.Element que faz o conteúdo ser desenhado em uma camada de desenho.

Escopo: qualquer

Um Modifier.Element que adiciona uma camada de desenho para que as ferramentas possam identificar um elemento na imagem desenhada.

Teclado

Escopo: qualquer
Modifier.onKeyEvent(onKeyEvent: (KeyEvent) -> Boolean)

Adicionar este modifier ao parâmetro modifier de um componente vai permitir que ele intercepte eventos de teclas do hardware quando ele ou um dos filhos estiver em foco.

Escopo: qualquer
Modifier.onPreviewKeyEvent(onPreviewKeyEvent: (KeyEvent) -> Boolean)

Adicionar este modifier ao parâmetro modifier de um componente permite que ele intercepte eventos de teclas do hardware quando ele ou um dos filhos estiver em foco.

Layout

Escopo: qualquer
Modifier.layoutId(layoutId: String, tag: String?)

Alternativa a androidx.compose.ui.layout.layoutId que permite o uso de tag.

Escopo: qualquer
Modifier.layoutId(layoutId: Any)

Marque o elemento com layoutId para identificar o elemento dentro do pai.

Escopo: qualquer

Crie um LayoutModifier que permite alterar a forma como o elemento agrupado é medido e disposto.

Escopo: qualquer
Modifier.onGloballyPositioned(
    onGloballyPositioned: (LayoutCoordinates) -> Unit
)

Invoque onGloballyPositioned com o LayoutCoordinates do elemento quando a posição global do conteúdo for alterada.

Padding

Escopo: qualquer
Modifier.paddingFrom(alignmentLine: AlignmentLine, before: Dp, after: Dp)

Um Modifier que pode adicionar padding para posicionar o conteúdo de acordo com distâncias especificadas dos limites até uma alignment line.

Escopo: qualquer
Modifier.paddingFrom(
    alignmentLine: AlignmentLine,
    before: TextUnit,
    after: TextUnit
)

Um Modifier que pode adicionar padding para posicionar o conteúdo de acordo com distâncias especificadas dos limites até uma alignment line.

Escopo: qualquer
Modifier.paddingFromBaseline(top: Dp, bottom: Dp)

Um Modifier que posiciona o conteúdo em um layout de modo que a distância entre a parte superior e a baseline of the first line of text in the content seja top e que a distância entre a baseline of the last line of text in the content e a parte inferior do layout seja bottom.

Escopo: qualquer

Um Modifier que posiciona o conteúdo em um layout de modo que a distância entre a parte superior e a baseline of the first line of text in the content seja top e que a distância entre a baseline of the last line of text in the content e a parte inferior do layout seja bottom.

Escopo: qualquer
Modifier.absolutePadding(left: Dp, top: Dp, right: Dp, bottom: Dp)

Aplique espaço adicional ao longo de cada borda do conteúdo em Dp: left, top, right e bottom.

Escopo: qualquer

Aplique all dp de espaço extra em cada borda do conteúdo (esquerda, superior, direita e a inferior).

Escopo: qualquer
Modifier.padding(paddingValues: PaddingValues)

Aplique PaddingValues ao componente como espaço extra em cada borda do conteúdo (esquerda, superior, direita e inferior).

Escopo: qualquer
Modifier.padding(horizontal: Dp, vertical: Dp)

Aplique o espaço dp horizontal ao longo das bordas esquerda e direita do conteúdo e o espaço dp vertical ao longo das bordas superior e inferior.

Escopo: qualquer
Modifier.padding(start: Dp, top: Dp, end: Dp, bottom: Dp)

Aplique espaço adicional ao longo de cada borda do conteúdo em Dp: start, top, end e bottom.

Escopo: qualquer

Adiciona padding para acomodar os encartes de caption bar.

Escopo: qualquer

Adicione padding para acomodar o display cutout.

Escopo: qualquer

Adiciona padding para acomodar os encartes de ime.

Escopo: qualquer

Adiciona padding para acomodar os encartes de mandatory system gestures.

Escopo: qualquer

Adiciona padding para acomodar os encartes de navigation bars.

Escopo: qualquer

Adiciona padding para acomodar os encartes de safe content.

Escopo: qualquer

Adiciona padding para acomodar os encartes de safe gestures.

Escopo: qualquer

Adiciona padding para acomodar os encartes de status bars.

Escopo: qualquer

Adiciona padding para acomodar os encartes de system bars.

Escopo: qualquer

Adiciona padding para acomodar os encartes de system gestures.

Escopo: qualquer

Adiciona padding para acomodar os encartes de waterfall.

Escopo: qualquer

Adiciona padding para que o conteúdo não insira espaço insets.

Ponteiro

Escopo: qualquer
Modifier.pointerHoverIcon(
    icon: PointerIcon,
    overrideDescendants: Boolean
)

Modificador que permite que um desenvolvedor defina um ícone de ponteiro para exibição quando o cursor passa sobre o elemento.

Escopo: qualquer
@ExperimentalComposeUiApi
Modifier.pointerInteropFilter(
    requestDisallowInterceptTouchEvent: RequestDisallowInterceptTouchEvent?,
    onTouchEvent: (MotionEvent) -> Boolean
)

Um PointerInputModifier especial que fornece acesso aos MotionEvents originalmente enviados ao Compose.

Escopo: qualquer
@ExperimentalComposeUiApi
Modifier.pointerMoveFilter(
    onMove: (position: Offset) -> Boolean,
    onExit: () -> Boolean,
    onEnter: () -> Boolean
)

Modificador que permite acompanhar eventos de movimento do ponteiro (ou seja, mouse ou trackpad).

Escopo: qualquer
Modifier. pointerInput(block: suspend PointerInputScope.() -> Unit)

Essa função foi descontinuada. Modifier.pointerInput precisa fornecer um ou mais parâmetros "key" que definem a identidade do modificador e determinam quando a corrotina de processamento de entrada anterior deve ser cancelada e um novo efeito pode ser iniciado para a nova chave.

Escopo: qualquer
Modifier.pointerInput(key1: Any?, block: suspend PointerInputScope.() -> Unit)

Crie um modificador para processar a entrada do ponteiro na região do elemento modificado.

Escopo: qualquer
Modifier.pointerInput(vararg keys: Any?, block: suspend PointerInputScope.() -> Unit)

Crie um modificador para processar a entrada do ponteiro na região do elemento modificado.

Escopo: qualquer
Modifier.pointerInput(key1: Any?, key2: Any?, block: suspend PointerInputScope.() -> Unit)

Crie um modificador para processar a entrada do ponteiro na região do elemento modificado.

Posição

Escopo: qualquer

Desloque o conteúdo em offset px.

Escopo: qualquer

Desloque o conteúdo em (x dp, y dp).

Escopo: qualquer
Modifier.offset(offset: Density.() -> IntOffset)

Desloque o conteúdo em offset px.

Escopo: qualquer
Modifier.offset(x: Dp, y: Dp)

Desloque o conteúdo em (x dp, y dp).

Modifier.tabIndicatorOffset(currentTabPosition: TabPosition)

Modifier que ocupa toda a largura disponível dentro da TabRow e depois anima o deslocamento do indicador ao qual é aplicado, dependendo da currentTabPosition.

Modifier.tabIndicatorOffset(currentTabPosition: TabPosition)

Modifier que ocupa toda a largura disponível dentro da TabRow e depois anima o deslocamento do indicador ao qual é aplicado, dependendo da currentTabPosition.

Semântica

Escopo: qualquer

Contém a semantics necessária para um indicador de progresso indeterminado, que representa a operação em andamento.

Escopo: qualquer
Modifier.progressSemantics(
    value: Float,
    valueRange: ClosedFloatingPointRange<Float>,
    steps: @IntRange(from = 0) Int
)

Contém a semantics necessária para um indicador de progresso determinado ou a parte do progresso de um controle deslizante que representa o progresso em um valueRange.

Escopo: qualquer
Modifier.rangeSemantics(
    value: Float,
    enabled: Boolean,
    onValueChange: (Float) -> Unit,
    valueRange: ClosedFloatingPointRange<Float>,
    steps: Int
)

Modificador para adicionar semântica que significa o progresso do stepper/slider.

Escopo: qualquer

Limpa a semântica de todos os nós descendentes e define uma nova semântica.

Escopo: qualquer
Modifier.semantics(mergeDescendants: Boolean, properties: SemanticsPropertyReceiver.() -> Unit)

Adicione pares de chave-valor de semântica ao nó de layout para uso em testes, acessibilidade etc.

Rolagem

Escopo: qualquer

Corta os limites do contêiner de rolagem no eixo principal e deixa espaço para efeitos de segundo plano (como sombras) no eixo cruzado.

Escopo: qualquer
Modifier. mouseScrollFilter(
    onMouseScroll: (event: MouseScrollEvent, bounds: IntSize) -> Boolean
)

Essa função foi descontinuada. Use Modifier.pointerInput + PointerEventType.Scroll

Escopo: qualquer
Modifier.nestedScroll(
    connection: NestedScrollConnection,
    dispatcher: NestedScrollDispatcher?
)

Modifique o elemento para fazer com que ele participe da hierarquia de rolagem aninhada.

Escopo: qualquer

Renderiza o rolamento excessivo do overscrollEffect fornecido.

Escopo: qualquer
Modifier.onPreRotaryScrollEvent(
    onPreRotaryScrollEvent: (RotaryScrollEvent) -> Boolean
)

Adicionar este modifier ao parâmetro modifier de um componente permite que ele intercepte RotaryScrollEvents se ele ou um dos filhos estiver em foco.

Escopo: qualquer
Modifier.onRotaryScrollEvent(
    onRotaryScrollEvent: (RotaryScrollEvent) -> Boolean
)

Adicionar este modifier ao parâmetro modifier de um componente permite que ele intercepte RotaryScrollEvents se ele ou um dos filhos estiver em foco.

Escopo: qualquer
Modifier.rotaryScrollable(
    behavior: RotaryScrollableBehavior,
    focusRequester: FocusRequester,
    reverseDirection: Boolean
)

Um modificador que conecta eventos giratórios a contêineres roláveis, como Column, LazyList e outros.

Escopo: qualquer
Modifier.scrollAway(scrollState: ScrollState, offset: Dp)

Role um item verticalmente para dentro/fora da visualização com base em um ScrollState.

Escopo: qualquer
Modifier.scrollAway(
    scrollState: LazyListState,
    itemIndex: Int,
    offset: Dp
)

Role um item verticalmente para dentro/fora da visualização com base em um LazyListState.

Escopo: qualquer
Modifier.scrollAway(
    scrollState: ScalingLazyListState,
    itemIndex: Int,
    offset: Dp
)

Role um item verticalmente para dentro/fora da visualização com base em um ScalingLazyListState.

Escopo: qualquer
Modifier. scrollAway(
    scrollState: ScalingLazyListState,
    itemIndex: Int,
    offset: Dp
)

Essa função foi descontinuada. Essa sobrecarga é fornecida para compatibilidade com o Compose para Wear OS 1.1. Uma sobrecarga mais recente está disponível e usa ScalingLazyListState do pacote wear.compose.foundation.lazy.

Escopo: qualquer
Modifier.horizontalScroll(
    state: ScrollState,
    enabled: Boolean,
    flingBehavior: FlingBehavior?,
    reverseScrolling: Boolean
)

Modifique o elemento para permitir rolagem horizontal quando a largura do conteúdo for maior do que o limite máximo permitido.

Escopo: qualquer
Modifier.verticalScroll(
    state: ScrollState,
    enabled: Boolean,
    flingBehavior: FlingBehavior?,
    reverseScrolling: Boolean
)

Modifique o elemento para permitir rolagem vertical quando a altura do conteúdo for maior do que o limite máximo permitido.

Escopo: qualquer
Modifier.scrollable(
    state: ScrollableState,
    orientation: Orientation,
    enabled: Boolean,
    reverseDirection: Boolean,
    flingBehavior: FlingBehavior?,
    interactionSource: MutableInteractionSource?
)

Configure a rolagem por toque e o deslizamento rápido para o elemento da IU em uma única Orientation.

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

Configure a rolagem por toque e o deslizamento rápido para o elemento da IU em uma única Orientation.

Escopo: qualquer
@ExperimentalTvFoundationApi
Modifier. scrollableWithPivot(
    state: ScrollableState,
    orientation: Orientation,
    pivotOffsets: PivotOffsets,
    enabled: Boolean,
    reverseDirection: Boolean
)

Essa função foi descontinuada.scrollableWithPivot foi descontinuado.

Escopo: qualquer

Controle o teclado de software como uma rolagem aninhada no Android R e versões mais recentes.

Tamanho

Escopo: qualquer
Modifier.animateContentSize(
    animationSpec: FiniteAnimationSpec<IntSize>,
    finishedListener: ((initialValue: IntSize, targetValue: IntSize) -> Unit)?
)

Esse modificador anima o próprio tamanho quando o modificador filho (ou o composto filho, se ele já estiver na cauda da cadeia) muda de tamanho.

Escopo: qualquer
Modifier.animateContentSize(
    animationSpec: FiniteAnimationSpec<IntSize>,
    alignment: Alignment,
    finishedListener: ((initialValue: IntSize, targetValue: IntSize) -> Unit)?
)

Esse modificador anima o próprio tamanho quando o modificador filho (ou o composto filho, se ele já estiver na cauda da cadeia) muda de tamanho.

Escopo: qualquer
Modifier.aspectRatio(
    ratio: @FloatRange(from = 0.0, fromInclusive = false) Float,
    matchHeightConstraintsFirst: Boolean
)

Tenta dimensionar o conteúdo para corresponder a uma proporção específica fazendo a correspondência com uma das restrições recebidas, nesta ordem: Constraints.maxWidth, Constraints.maxHeight, Constraints.minWidth, Constraints.minHeight, se matchHeightConstraintsFirst for false (que é o padrão), ou Constraints.maxHeight, Constraints.maxWidth, Constraints.minHeight, Constraints.minWidth, se matchHeightConstraintsFirst for true.

Escopo: qualquer

Reserva pelo menos 48 dp de tamanho para evitar a ambiguidade das interações de toque caso o elemento seja menor.

Escopo: qualquer

Reserva pelo menos 48 dp de tamanho para evitar a ambiguidade das interações de toque caso o elemento seja menor.

Escopo: qualquer

Reserva pelo menos 48 dp de tamanho para evitar a ambiguidade das interações de toque caso o elemento seja menor.

Escopo: qualquer

Reserva pelo menos 48 dp de tamanho para evitar a ambiguidade das interações de toque caso o elemento seja menor.

Escopo: qualquer
Modifier.height(intrinsicSize: IntrinsicSize)

Declare a altura preferencial do conteúdo como igual à altura intrínseca mínima ou máxima do conteúdo.

Escopo: qualquer

Declare a altura do conteúdo como exatamente igual à altura intrínseca mínima ou máxima do conteúdo.

Escopo: qualquer

Declare a largura do conteúdo exatamente como a largura intrínseca mínima ou máxima do conteúdo.

Escopo: qualquer
Modifier.width(intrinsicSize: IntrinsicSize)

Declare a largura preferencial do conteúdo como igual à largura intrínseca mínima ou máxima do conteúdo.

Escopo: qualquer
Modifier.onSizeChanged(onSizeChanged: (IntSize) -> Unit)

Invocado com o tamanho do elemento da interface modificado pelo Compose quando ele é medido pela primeira vez ou quando o tamanho dele muda.

Escopo: qualquer
Modifier.defaultMinSize(minWidth: Dp, minHeight: Dp)

Restrinja o tamanho do layout agrupado apenas quando ele não tiver restrições: as restrições minWidth e minHeight serão aplicadas somente quando a restrição correspondente recebida for 0.

Escopo: qualquer
Modifier.fillMaxHeight(fraction: @FloatRange(from = 0.0, to = 1.0) Float)

Permita que o conteúdo preencha (talvez apenas parcialmente) a Constraints.maxHeight das restrições de medição recebidas definindo a minimum height e a maximum height para que sejam iguais à maximum height multiplicada por fraction.

Escopo: qualquer
Modifier.fillMaxSize(fraction: @FloatRange(from = 0.0, to = 1.0) Float)

Faça com que o conteúdo preencha (possivelmente apenas parcialmente) a Constraints.maxWidth e a Constraints.maxHeight das restrições de medição recebidas, definindo minimum width e maximum width como iguais ao maximum width multiplicado por fraction, bem como minimum height e maximum height para ser igual ao maximum height multiplicado por fraction.

Escopo: qualquer
Modifier.fillMaxWidth(fraction: @FloatRange(from = 0.0, to = 1.0) Float)

Faça com que o conteúdo preencha (possivelmente apenas parcialmente) a Constraints.maxWidth das restrições de medição recebidas, definindo minimum width e maximum width como iguais à maximum width multiplicada por fraction.

Escopo: qualquer
Modifier.height(height: Dp)

Declare a altura preferencial do conteúdo como exatamente heightdp.

Escopo: qualquer
Modifier.heightIn(min: Dp, max: Dp)

Restrinja a altura do conteúdo para ficar entre mindp e maxdp, conforme permitido pelas Constraints de medição recebidas.

Escopo: qualquer

Declare a altura do conteúdo como exatamente heightdp.

Escopo: qualquer
Modifier.requiredHeightIn(min: Dp, max: Dp)

Restrinja a altura do conteúdo entre mindp e maxdp.

Escopo: qualquer

Declare o tamanho do conteúdo exatamente como sizedp de largura e altura.

Escopo: qualquer

Declare o tamanho do conteúdo exatamente como size.

Escopo: qualquer
Modifier.requiredSize(width: Dp, height: Dp)

Declare o tamanho do conteúdo exatamente como widthdp e heightdp.

Escopo: qualquer
Modifier.requiredSizeIn(
    minWidth: Dp,
    minHeight: Dp,
    maxWidth: Dp,
    maxHeight: Dp
)

Restrinja a largura do conteúdo entre minWidthdp e maxWidthdp. A altura do conteúdo precisa estar entre minHeightdp e maxHeightdp.

Escopo: qualquer

Declare a largura do conteúdo como exatamente widthdp.

Escopo: qualquer
Modifier.requiredWidthIn(min: Dp, max: Dp)

Restrinja a largura do conteúdo entre mindp e maxdp.

Escopo: qualquer
Modifier.size(size: Dp)

Declare o tamanho preferencial do conteúdo como sizedp quadrado.

Escopo: qualquer
Modifier.size(size: DpSize)

Declare o tamanho preferencial do conteúdo como size.

Escopo: qualquer
Modifier.size(width: Dp, height: Dp)

Declare o tamanho preferencial do conteúdo como widthdp por heightdp.

Escopo: qualquer
Modifier.sizeIn(minWidth: Dp, minHeight: Dp, maxWidth: Dp, maxHeight: Dp)

Restrinja a largura do conteúdo entre minWidthdp e maxWidthdp e a altura dele entre minHeightdp e maxHeightdp, conforme permitido pelas Constraints de medição recebida.

Escopo: qualquer
Modifier.width(width: Dp)

Declare a largura preferencial do conteúdo como widthdp.

Escopo: qualquer
Modifier.widthIn(min: Dp, max: Dp)

Restrinja a largura do conteúdo entre mindp e maxdp, conforme permitido pelas Constraints de medição recebida.

Escopo: qualquer
Modifier.wrapContentHeight(
    align: Alignment.Vertical,
    unbounded: Boolean
)

Permita que o conteúdo seja medido na altura desejada sem considerar a minimum height constraint de medição recebida e, se unbounded for verdadeiro, sem considerar também a maximum height constraint de medição recebida.

Escopo: qualquer
Modifier.wrapContentSize(align: Alignment, unbounded: Boolean)

Permita que o conteúdo seja medido no tamanho desejado sem considerar as restrições minimum width ou minimum height de medição recebida e, se unbounded for verdadeiro, sem considerar também as restrições máximas recebidas.

Escopo: qualquer
Modifier.wrapContentWidth(
    align: Alignment.Horizontal,
    unbounded: Boolean
)

Permita que o conteúdo seja medido com a largura desejada, sem considerar a minimum width constraint de medição recebida, e, se unbounded for verdadeiro, sem considerar também a maximum width constraint da medição recebida.

Escopo: qualquer

Modificador para definir o tamanho e a área de toque recomendada para IconButton e TextButton.

Escopo: qualquer

Define a altura como a de insets em bottom da tela.

Escopo: qualquer

Define a largura como a de insets em end da tela, usando left ou right, dependendo de LayoutDirection.

Escopo: qualquer

Define a largura como a de insets em start da tela, usando left ou right, dependendo de LayoutDirection.

Escopo: qualquer

Define a altura como a de insets em top da tela.

Escopo: RowScope
Modifier.weight(
    weight: @FloatRange(from = 0.0, fromInclusive = false) Float,
    fill: Boolean
)

Dimensione a largura do elemento proporcionalmente a seu weight em relação a outros elementos irmãos ponderados na Row.

Escopo: ColumnScope
Modifier.weight(
    weight: @FloatRange(from = 0.0, fromInclusive = false) Float,
    fill: Boolean
)

Dimensione a altura do elemento proporcionalmente a seu weight em relação a outros elementos irmãos ponderados na Column.

Escopo: BoxScope

Dimensione o elemento para que corresponda ao tamanho da Box depois que todos os outros elementos de conteúdo tiverem sido medidos.

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

Permita que o conteúdo preencha a Constraints.maxHeight das restrições de medição recebidas definindo a minimum height para que seja igual à maximum height multiplicada por fraction.

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

Faça com que o conteúdo preencha a Constraints.maxWidth e a Constraints.maxHeight das restrições de medição mãe definindo minimum width como igual à maximum width multiplicada por fraction e minimum height para ser igual a maximum height multiplicado por fraction.

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

Permita que o conteúdo preencha a Constraints.maxWidth das restrições de medição mãe, definindo a minimum width para que seja igual à maximum width multiplicada por fraction.

abstract
Modifier.exposedDropdownSize(matchTextFieldWidth: Boolean)

Modificador que precisa ser aplicado a um ExposedDropdownMenu colocado dentro do escopo.

abstract
Modifier.exposedDropdownSize(matchTextFieldWidth: Boolean)

Modificador que precisa ser aplicado a um menu colocado dentro do ExposedDropdownMenuBoxScope.

Testes

Escopo: qualquer

Aplica uma tag para permitir que o elemento modificado seja encontrado em testes.

Transformações

Escopo: qualquer
Modifier.rotate(degrees: Float)

Defina os graus em que a visualização é girada em torno do centro da função composta.

Escopo: qualquer
Modifier.scale(scale: Float)

Dimensione o conteúdo dos eixos horizontal e vertical de maneira uniforme usando o mesmo fator de escalonamento.

Escopo: qualquer
Modifier.scale(scaleX: Float, scaleY: Float)

Dimensione o conteúdo da função que pode ser composta pelos seguintes fatores de escalonamento ao longo dos eixos horizontal e vertical, respectivamente.

Escopo: qualquer
Modifier.transformable(
    state: TransformableState,
    lockRotationOnZoomPan: Boolean,
    enabled: Boolean
)

Ative gestos de transformação do elemento da IU modificado.

Escopo: qualquer
@ExperimentalFoundationApi
Modifier.transformable(
    state: TransformableState,
    canPan: (Offset) -> Boolean,
    lockRotationOnZoomPan: Boolean,
    enabled: Boolean
)

Ative gestos de transformação do elemento da IU modificado.

Outros

Escopo: qualquer

Um modificador que permite que um elemento ao qual é aplicado seja tratado como uma fonte para operações de arrastar e soltar.

Escopo: qualquer
Modifier.basicMarquee(
    iterations: Int,
    animationMode: MarqueeAnimationMode,
    repeatDelayMillis: Int,
    initialDelayMillis: Int,
    spacing: MarqueeSpacing,
    velocity: Dp
)

Aplica um efeito de letreiro animado ao conteúdo modificado se ele for muito largo para caber no espaço disponível.

Escopo: qualquer
Modifier.edgeSwipeToDismiss(
    swipeToDismissBoxState: SwipeToDismissBoxState,
    edgeWidth: Dp
)

Limite o deslizamento para dispensar para ser ativo apenas a partir da borda da janela de visualização.

Escopo: qualquer
Modifier.blur(radius: Dp, edgeTreatment: BlurredEdgeTreatment)

Mostre conteúdo desfocado com os raios especificados.

Escopo: qualquer
Modifier.blur(
    radiusX: Dp,
    radiusY: Dp,
    edgeTreatment: BlurredEdgeTreatment
)

Mostre conteúdo desfocado com os raios especificados.

Escopo: qualquer

Modificador que pode ser usado para enviar solicitações scrollIntoView.

Escopo: qualquer

Um pai que pode responder a solicitações BringIntoViewRequester dos filhos e rolar para que o item fique visível na tela.

Escopo: qualquer
Modifier.composed(
    inspectorInfo: InspectorInfo.() -> Unit,
    factory: @Composable Modifier.() -> Modifier
)

Declare uma composição just-in-time de um Modifier que será composta por cada elemento que ela modificar.

Escopo: qualquer
@ExperimentalComposeUiApi
Modifier.composed(
    fullyQualifiedName: String,
    key1: Any?,
    inspectorInfo: InspectorInfo.() -> Unit,
    factory: @Composable Modifier.() -> Modifier
)

Declare uma composição just-in-time de um Modifier que será composta por cada elemento que ela modificar.

Escopo: qualquer
@ExperimentalComposeUiApi
Modifier.composed(
    fullyQualifiedName: String,
    vararg keys: Any?,
    inspectorInfo: InspectorInfo.() -> Unit,
    factory: @Composable Modifier.() -> Modifier
)

Declare uma composição just-in-time de um Modifier que será composta por cada elemento que ela modificar.

Escopo: qualquer
@ExperimentalComposeUiApi
Modifier.composed(
    fullyQualifiedName: String,
    key1: Any?,
    key2: Any?,
    inspectorInfo: InspectorInfo.() -> Unit,
    factory: @Composable Modifier.() -> Modifier
)

Declare uma composição just-in-time de um Modifier que será composta por cada elemento que ela modificar.

Escopo: qualquer
@ExperimentalComposeUiApi
Modifier.composed(
    fullyQualifiedName: String,
    key1: Any?,
    key2: Any?,
    key3: Any?,
    inspectorInfo: InspectorInfo.() -> Unit,
    factory: @Composable Modifier.() -> Modifier
)

Declare uma composição just-in-time de um Modifier que será composta por cada elemento que ela modificar.

Escopo: qualquer
@ExperimentalFoundationApi
Modifier.dragAndDropSource(
    drawDragDecoration: DrawScope.() -> Unit,
    block: suspend DragAndDropSourceScope.() -> Unit
)

Um modificador que permite que um elemento ao qual é aplicado seja tratado como uma fonte para operações de arrastar e soltar.

Escopo: qualquer
@ExperimentalFoundationApi
Modifier.dragAndDropTarget(
    shouldStartDragAndDrop: (startEvent: DragAndDropEvent) -> Boolean,
    target: DragAndDropTarget
)

Um modificador que permite receber mensagens de um gesto de arrastar e soltar.

Escopo: qualquer

Essa função foi descontinuada. Use systemGestureExclusion.

Escopo: qualquer

Essa função foi descontinuada. Use systemGestureExclusion.

Escopo: qualquer
Modifier.handwritingDetector(callback: () -> Unit)

Configura um elemento para atuar como um detector de escrita à mão, que detecta a escrita à mão com stylus e delega o processamento do texto reconhecido a outro elemento.

Escopo: qualquer

Configura um elemento para atuar como um gerenciador de escrita à mão com stylus, que pode processar a entrada de texto de uma sessão de escrita à mão acionada por uma stylus em um detector de escrita à mão.

Escopo: qualquer
Modifier.hoverable(
    interactionSource: MutableInteractionSource,
    enabled: Boolean
)

Configure o componente para que seja possível passar o cursor por eventos de entrada/saída do ponteiro.

Escopo: qualquer
inline
Modifier. inspectable(
    noinline inspectorInfo: InspectorInfo.() -> Unit,
    factory: Modifier.() -> Modifier
)

Essa função foi descontinuada. Essa API vai criar mais invalidações do modificador do que o necessário. Por isso, não recomendamos o uso dela.

Escopo: qualquer
Modifier.approachLayout(
    isMeasurementApproachInProgress: (lookaheadSize: IntSize) -> Boolean,
    isPlacementApproachInProgress: Placeable.PlacementScope.(lookaheadCoordinates: LayoutCoordinates) -> Boolean,
    approachMeasure: ApproachMeasureScope.(measurable: Measurable, constraints: Constraints) -> MeasureResult
)

Cria um layout de aproximação para ajudar a se aproximar gradualmente do layout de destino calculado na passagem de visão futura.

Escopo: qualquer
Modifier.magnifier(
    sourceCenter: Density.() -> Offset,
    magnifierCenter: (Density.() -> Offset)?,
    onSizeChanged: ((DpSize) -> Unit)?,
    zoom: Float,
    size: DpSize,
    cornerRadius: Dp,
    elevation: Dp,
    clip: Boolean
)

Mostre um widget Magnifier que exibe uma versão ampliada do conteúdo em sourceCenter em relação ao nó de layout atual.

Escopo: qualquer

Um modificador que pode ser usado para consumir ModifierLocals que foram fornecidos por outros modificadores à esquerda ou acima dele na árvore de layout.

Escopo: qualquer
@ExperimentalComposeUiApi
<T : Any?> Modifier.modifierLocalProvider(
    key: ProvidableModifierLocal<T>,
    value: () -> T
)

Um modificador que pode ser usado para fornecer ModifierLocals que possam ser lidos por outros modificadores à direita dele ou modificadores que são filhos do nó de layout ao qual esse modificador está anexado.

Escopo: qualquer

Invoque onPlaced após a inserção do LayoutModifier e do layout pai e antes do posicionamento do LayoutModifier filho.

Escopo: qualquer
@ExperimentalWearMaterialApi
@Composable
Modifier.placeholder(
    placeholderState: PlaceholderState,
    shape: Shape,
    color: Color
)

Desenha uma forma de marcador na parte de cima de um elemento combinável e anima um efeito de limpeza para remover o marcador.

Escopo: qualquer
@ExperimentalWearMaterialApi
@Composable
Modifier.placeholderShimmer(
    placeholderState: PlaceholderState,
    shape: Shape,
    color: Color
)

Modificador para desenhar um brilho de marcador de posição sobre um componente.

Escopo: qualquer

Chame watcher com cada MotionEvent recebido pela área de layout ou por qualquer pointerInput filho.

Escopo: qualquer

Marque o retângulo de layout como a opção de ficar longe das janelas flutuantes.

Escopo: qualquer

Marque um retângulo dentro das coordenadas de layout local, preferindo ficar longe de janelas flutuantes.

Escopo: qualquer

Um modificador para traduzir a posição e dimensionar o tamanho do indicador de um componente de puxar a tela de cima para baixo para atualizar com base no PullRefreshState especificado.

Escopo: qualquer

Um modificador de rolagem aninhado que fornece eventos de rolagem para state.

Escopo: qualquer
@ExperimentalMaterialApi
Modifier.pullRefresh(
    onPull: (pullDelta: Float) -> Float,
    onRelease: suspend (flingVelocity: Float) -> Float,
    enabled: Boolean
)

Um modificador de rolagem aninhado que fornece callbacks onPull e onRelease para ajudar a criar componentes de atualização por puxar personalizados.

Escopo: qualquer
@ExperimentalMaterial3Api
Modifier.pullToRefresh(
    isRefreshing: Boolean,
    state: PullToRefreshState,
    enabled: Boolean,
    threshold: Dp,
    onRefresh: () -> Unit
)

Um modificador que adiciona rolagem aninhada a um contêiner para oferecer suporte a um gesto de puxar para atualizar.

Escopo: qualquer
@ExperimentalMaterial3Api
Modifier.pullToRefreshIndicator(
    state: PullToRefreshState,
    isRefreshing: Boolean,
    threshold: Dp,
    shape: Shape,
    containerColor: Color,
    elevation: Dp
)

Um modificador que processa o tamanho, o deslocamento, o recorte, a sombra e a exibição em segundo plano de um indicador de puxar a tela de cima para baixo para atualizar, útil ao implementar indicadores personalizados.

Escopo: qualquer

Configura o nó atual e todos os nós filhos como um receptor de conteúdo.

Escopo: qualquer
@ExperimentalComposeUiApi
Modifier.onInterceptKeyBeforeSoftKeyboard(
    onInterceptKeyBeforeSoftKeyboard: (KeyEvent) -> Boolean
)

Adicionar este modifier ao parâmetro modifier de um componente permite que ele intercepte eventos de teclas do hardware antes que eles sejam enviados ao teclado virtual.

Escopo: qualquer
@ExperimentalComposeUiApi
Modifier.onPreInterceptKeyBeforeSoftKeyboard(
    onPreInterceptKeyBeforeSoftKeyboard: (KeyEvent) -> Boolean
)

Adicionar este modifier ao parâmetro modifier de um componente permite que ele intercepte eventos de teclas do hardware antes que eles sejam enviados ao teclado virtual.

Escopo: qualquer
Modifier. edgeSwipeToDismiss(
    swipeToDismissBoxState: SwipeToDismissBoxState,
    edgeWidth: Dp
)

Essa função foi descontinuada. O componente deslizante foi migrado para androidx.wear.compose.foundation.

Escopo: qualquer

Exclua o retângulo de layout do gesto do sistema.

Escopo: qualquer

Exclua um retângulo dentro das coordenadas de layout local do gesto do sistema.

Escopo: qualquer

Consuma encartes que ainda não foram consumidos por outros modificadores de encartes semelhantes a windowInsetsPadding sem adicionar qualquer padding.

Escopo: qualquer

Consuma paddingValues como encartes como se o padding fosse adicionado, independente dos encartes.

Escopo: qualquer
Modifier.onConsumedWindowInsetsChanged(
    block: (consumedWindowInsets: WindowInsets) -> Unit
)

Chame o block com a WindowInsets que foi consumida por consumeWindowInsets ou por um dos modificadores de padding, como imePadding.

Modifier que precisa ser aplicado ao elemento combinável de âncora ao mostrar a dica depois de tocar e manter pressionado o elemento combinável de âncora.

Essa função foi descontinuada. Use a sobrecarga que recebe MenuAnchorType e parâmetros ativados

abstract

Modificador que precisa ser aplicado a um elemento dentro do ExposedDropdownMenuBoxScope, geralmente um campo de texto ou um ícone dentro do campo de texto.