useCharacterLimit
Enforces maximum input length with live character counter and remaining quota.
1.2 KB
•Updated on September 3, 2026
Example 2: Social Post Composer (Ring Progress)
Installation
Bash
pnpm dlx shadcn@latest add @spaceui/hooks-form-use-character-limitUsage
Code
import { useCharacterLimit } from '@/hooks/use-character-limit'
const { value, remaining, percentage, onChange } = useCharacterLimit({ maxLength: 100 })API Reference
Parameters / Props
| Parameter | Type | Default | Description |
|---|---|---|---|
options.maxLength | number | required | Max length. |
Return Value
| Property | Type | Description |
|---|---|---|
value | string | Current text. |
remaining | number | Leftover quota. |
percentage | number | Percentage (0-100). |