InputGroup
shape rounded/pill · size sm/md/lg · variant outline/filled · state success/error
Agrupa input com select ou botão compartilhando a mesma borda.
Foco no grupo
<.input_group class="[&_input]:field-sizing-content animate-[lu-focusloop_6s_ease-in-out_infinite]"> <.input_group_addon>R$</.input_group_addon> <.input variant="plain" value="1.284,90" aria-label="Valor" /> <.input_group_addon>,00</.input_group_addon> </.input_group>
shape × size × variant × state
<div class="flex flex-col gap-2.5"> <div class="flex flex-wrap items-center gap-2.5"> <.input_group size="sm" class="[&_input]:field-sizing-content"> <.input_group_addon size="sm">R$</.input_group_addon> <.input variant="plain" size="sm" value="1.284,90" aria-label="Valor" /> <.input_group_addon size="sm">,00</.input_group_addon> </.input_group> <.input_group class="[&_input]:field-sizing-content"> <.input_group_addon>R$</.input_group_addon> <.input variant="plain" value="1.284,90" aria-label="Valor" /> <.input_group_addon>,00</.input_group_addon> </.input_group> <.input_group size="lg" class="[&_input]:field-sizing-content"> <.input_group_addon size="lg">R$</.input_group_addon> <.input variant="plain" size="lg" value="1.284,90" aria-label="Valor" /> <.input_group_addon size="lg">,00</.input_group_addon> </.input_group> </div> <div class="flex flex-wrap items-center gap-2.5"> <.input_group shape="pill" class="[&_input]:field-sizing-content"> <.input_group_addon>R$</.input_group_addon> <.input variant="plain" value="1.284,90" aria-label="Valor" /> <.input_group_addon>,00</.input_group_addon> </.input_group> <.input_group variant="filled" class="[&_input]:field-sizing-content"> <.input_group_addon>R$</.input_group_addon> <.input variant="plain" value="1.284,90" aria-label="Valor" /> <.input_group_addon>,00</.input_group_addon> </.input_group> <.input_group state="success" class="[&_input]:field-sizing-content"> <.input_group_addon>R$</.input_group_addon> <.input variant="plain" value="1.284,90" aria-label="Valor" /> <.input_group_addon>,00</.input_group_addon> </.input_group> <.input_group state="error" class="[&_input]:field-sizing-content"> <.input_group_addon>R$</.input_group_addon> <.input variant="plain" value="1.284,90" aria-label="Valor" /> <.input_group_addon>,00</.input_group_addon> </.input_group> </div> </div>
Uso
<.input_group><.select … /><.input … /><.button>Aplicar</.button></.input_group>
Regras
- Só a primeira e a última peça têm cantos arredondados.
- Use para pares inseparáveis (moeda + valor, filtro + busca).
Referência da API
Todos os function components, atributos, valores e slots que este componente cobre.
Joins inputs, addons, selects and buttons into one row with shared borders.
<.input_group>
<.input_group_addon>R$</.input_group_addon>
<.input name="amount" variant="plain" />
<.input_group_addon>,00</.input_group_addon>
</.input_group>
<.input_group label="Price" size="sm" errors={["must be positive"]}>
<.input_group_addon variant="filled">$</.input_group_addon>
<.input name="amount" variant="plain" size="sm" state="error" />
</.input_group>
The row is a role="group" named by the caption (aria-labelledby; give each group an id
when two share a label). With errors (or state="error") every border of the row turns red,
and the row gets aria-invalid and an aria-describedby that points at the messages.
The group draws the shared border, so an input/1 inside it takes variant="plain".
<.input_group>
Renders the row; label adds a caption above it, help and errors a line below.
| Attr | Type | Default | Values / notes |
|---|---|---|---|
id |
:string |
nil |
|
shape |
:string |
"rounded" |
rounded, pill |
size |
:string |
"md" |
sm, md, lg |
variant |
:string |
"outlined" |
outlined, filled |
label |
:string |
nil |
|
label_class |
:any |
nil |
|
help |
:string |
nil |
|
errors |
:list |
[] |
|
state |
:string |
nil |
nil, `,success,error` |
wrapper_class |
:any |
nil |
|
class |
:any |
nil |
Any other HTML/phx attribute goes to the root element.
Slots:
<:inner_block>(required)
<.input_group_addon>
A text or icon box at either end (or between the inputs) of an input_group.
| Attr | Type | Default | Values / notes |
|---|---|---|---|
variant |
:string |
"outline" |
outline, filled |
size |
:string |
"md" |
sm, md, lg |
class |
:any |
nil |
Any other HTML/phx attribute goes to the root element.
Slots:
<:inner_block>(required)