Input Group
Input Group menempelkan ikon, teks, atau tombol kecil ke sebuah input, di dalam satu border.
Kapan dipakai
Section titled “Kapan dipakai”- Pencarian: ikon cari di depan input.
- Kata sandi: tombol di belakang input untuk menampilkan atau menyembunyikan kata sandi. Inilah kolom kata sandi Sosialoka; tidak ada komponen kata sandi tersendiri.
- Satuan dan awalan: teks seperti
Rpatau.idsebelum atau sesudah nilai. - Jangan taruh aksi utama form di dalam grup; tempatnya di footer form.
Anatomi
Section titled “Anatomi”- 1Ikon di depan
- 2Input
- 3Tombol yang menempel
- Grup (
InputGroup): satu borderinputdenganradius-md, tinggih-9. Fokus pada input memberi ring ke seluruh grup. - Addon (
InputGroupAddon): ikon, teks, atau tombol, diinline-start(depan) atauinline-end(belakang). - Kontrol (
InputGroupInputatauInputGroupTextarea): kolomnya sendiri, tanpa border sendiri.
Varian
Section titled “Varian”| Posisi addon | Pakai untuk |
|---|---|
inline-start |
Ikon cari, mata uang seperti Rp. |
inline-end |
Tombol tampilkan kata sandi, satuan, tombol hapus. |
block-start / block-end |
Label atau aksi di atas atau di bawah InputGroupTextarea. |
| React | Vue | Flutter | Tipe | Default | Kegunaan |
|---|---|---|---|---|---|
InputGroupAddon align |
InputGroupAddon align |
leading / trailing di ShadInput |
inline-start, inline-end, block-start, block-end |
inline-start |
Posisi addon. |
InputGroupButton size |
InputGroupButton size |
ShadIconButton di trailing |
xs, sm, icon-xs, icon-sm |
xs |
Tombol kecil di dalam grup. |
type di InputGroupInput |
type di InputGroupInput |
obscureText |
teks | text |
password menyembunyikan teks; search membuat kolom cari. |
import { useId, useState } from "react"import { EyeIcon, EyeOffIcon, SearchIcon } from "lucide-react"import { Field, FieldLabel } from "@/components/ui/field"import { InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput } from "@/components/ui/input-group"
export default function InputGroupDemo() { const id = useId() const [visible, setVisible] = useState(false) return ( <div className="grid w-full max-w-sm gap-6"> <InputGroup> <InputGroupAddon> <SearchIcon /> </InputGroupAddon> <InputGroupInput type="search" placeholder="Cari rilis" aria-label="Cari rilis" /> </InputGroup> <Field> <FieldLabel htmlFor={`${id}-password`}>Kata sandi</FieldLabel> <InputGroup> <InputGroupInput id={`${id}-password`} type={visible ? "text" : "password"} autoComplete="current-password" /> <InputGroupAddon align="inline-end"> <InputGroupButton size="icon-xs" aria-label={visible ? "Sembunyikan kata sandi" : "Tampilkan kata sandi"} aria-pressed={visible} onClick={() => setVisible((v) => !v)} > {visible ? <EyeOffIcon /> : <EyeIcon />} </InputGroupButton> </InputGroupAddon> </InputGroup> </Field> </div> )}<script setup lang="ts">import { ref, useId } from "vue"import { EyeIcon, EyeOffIcon, SearchIcon } from "@lucide/vue"import { Field, FieldLabel } from "@/components/ui/field"import { InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput } from "@/components/ui/input-group"
const id = useId()const visible = ref(false)</script>
<template> <div class="grid w-full max-w-sm gap-6"> <InputGroup> <InputGroupAddon> <SearchIcon /> </InputGroupAddon> <InputGroupInput type="search" placeholder="Cari rilis" aria-label="Cari rilis" /> </InputGroup> <Field> <FieldLabel :for="`${id}-password`">Kata sandi</FieldLabel> <InputGroup> <InputGroupInput :id="`${id}-password`" :type="visible ? 'text' : 'password'" autocomplete="current-password" /> <InputGroupAddon align="inline-end"> <InputGroupButton size="icon-xs" :aria-label="visible ? 'Sembunyikan kata sandi' : 'Tampilkan kata sandi'" :aria-pressed="visible" @click="visible = !visible" > <EyeOffIcon v-if="visible" /> <EyeIcon v-else /> </InputGroupButton> </InputGroupAddon> </InputGroup> </Field> </div></template>import 'package:flutter/widgets.dart';import 'package:shadcn_ui/shadcn_ui.dart';
class InputGroupDemo extends StatefulWidget { const InputGroupDemo({super.key});
@override State<InputGroupDemo> createState() => _InputGroupDemoState();}
class _InputGroupDemoState extends State<InputGroupDemo> { bool visible = false;
@override Widget build(BuildContext context) { return ConstrainedBox( constraints: const BoxConstraints(maxWidth: 384), child: Column( mainAxisSize: MainAxisSize.min, crossAxisAlignment: CrossAxisAlignment.stretch, spacing: 24, children: [ const ShadInput( placeholder: Text('Cari rilis'), leading: Icon(LucideIcons.search, size: 16), ), ShadInputFormField( id: 'password', label: const Text('Kata sandi'), obscureText: !visible, trailing: Semantics( label: visible ? 'Sembunyikan kata sandi' : 'Tampilkan kata sandi', toggled: visible, child: ShadIconButton.ghost( width: 24, height: 24, icon: Icon(visible ? LucideIcons.eyeOff : LucideIcons.eye, size: 16), onPressed: () => setState(() => visible = !visible), ), ), ), ], ), ); }}Pasang
Section titled “Pasang”npx shadcn@latest add https://design.sosialoka.tech/r/react/input-group.jsonnpx shadcn-vue@latest add https://design.sosialoka.tech/r/vue/input-group.jsonAksesibilitas
Section titled “Aksesibilitas”- Input tetap punya label sendiri: label yang terlihat di dalam Field, atau
aria-labelseperti “Cari rilis” untuk kolom cari yang hanya berikon. - Tombol tampilkan kata sandi menyebut fungsinya:
aria-label“Tampilkan kata sandi” / “Sembunyikan kata sandi”, denganaria-pressedselama kata sandi terlihat. - Ikon di addon bersifat dekoratif dan tidak perlu label.
