Preview Updated 2026-05-10

InputGroup

Compose multiple Input / Button / Select / static labels into one unit with shared outer radius and border.

Basic usage

InputGroup is a pure styling wrapper. Put form controls inside in order; adjacent inner radii are removed automatically and the first / last element inherits the outer radius. Static labels are rendered with <span class="cf-input-group__addon">.

<CfInputGroup>
<span class="cf-input-group__addon">@</span>
<CfInput v-model="search" placeholder="username" />
</CfInputGroup>

<CfInputGroup>
<span className="cf-input-group__addon">@</span>
<CfInput value={search} onChange={(e) => setSearch(e.target.value)} placeholder="username" />
</CfInputGroup>

With Select / Button

The most common combination — “URL input + protocol select + submit button” — three segments share a single border.

<CfInputGroup>
<CfSelect v-model="protocol" :options="protocols" />
<CfInput v-model="host" placeholder="example.com" />
<CfButton>Visit</CfButton>
</CfInputGroup>

<CfInputGroup>
<CfSelect value={protocol} onChange={setProtocol} options={protocols} />
<CfInput value={host} onChange={(e) => setHost(e.target.value)} placeholder="example.com" />
<CfButton>Visit</CfButton>
</CfInputGroup>

Leading and trailing addons

<span class="cf-input-group__addon"> can sit on either side of the input — common for currency or URL path prefixes/suffixes.

¥RMB

https:///path

<CfInputGroup>
<span class="cf-input-group__addon">¥</span>
<CfInput v-model="price" placeholder="Price" />
<span class="cf-input-group__addon">RMB</span>
</CfInputGroup>

<CfInputGroup>
<span class="cf-input-group__addon">https://</span>
<CfInput v-model="url" placeholder="example.com" />
<span class="cf-input-group__addon">/path</span>
</CfInputGroup>

<CfInputGroup>
<span className="cf-input-group__addon">¥</span>
<CfInput value={price} onChange={(e) => setPrice(e.target.value)} placeholder="Price" />
<span className="cf-input-group__addon">RMB</span>
</CfInputGroup>

<CfInputGroup>
<span className="cf-input-group__addon">https://</span>
<CfInput value={url} onChange={(e) => setUrl(e.target.value)} placeholder="example.com" />
<span className="cf-input-group__addon">/path</span>
</CfInputGroup>

Equal-width stretch

stretch makes children share the parent width equally — handy for a full-row search box + submit button.

<CfInputGroup stretch>
<CfInput v-model="q" placeholder="Search…" />
<CfButton variant="primary">Search</CfButton>
</CfInputGroup>

<CfInputGroup stretch>
<CfInput value={q} onChange={(e) => setQ(e.target.value)} placeholder="Search…" />
<CfButton variant="primary">Search</CfButton>
</CfInputGroup>

API · Props

Prop	Type	Default	Description
`orientation`	`'horizontal' \| 'vertical'`	`'horizontal'`	Layout direction
`size`	`'sm' \| 'md' \| 'lg'`	`'md'`	Size of static addons (controls keep their own size)
`stretch`	`boolean`	`false`	Children fill parent equally