svelte-otp

A simple lightweight numbers OTP input component for Svelte.

original project

⚠️ Version Notice:

• v0.1.x: Supports Svelte 4 (deprecated)
• v1.0.0+: Requires Svelte 5 (current)

Requirements

• Svelte 5.0.0 or higher
• SvelteKit 2.0.0 or higher (if using SvelteKit)

Installing

npm install svelte-num-otp@latest

or

yarn add svelte-num-otp@latest

For Svelte 4 users (deprecated):

npm install [email protected]

Usage

Simplest form

Getting started is as easy as importing the SvelteOtp component and just using it.

<script>
    import SvelteOtp from ‘svelte-num-otp’;
</script>

<SvelteOtp />

Controlling the state

You can easily control the state of the value by binding it to the value prop.

You can also change the number of inputs through the numOfInputs prop.

<script>
	import SvelteOtp from ‘svelte-num-otp’;

  let value = '12345'

</script>

<SvelteOtp numOfInputs={5} bind:value />

Customizing the look

You can style the component however you want by passing one of inputStyle, wrapperStyle, separatorStyle or add custom class names through inputClass, wrapperClass, separatorClass. You can also disable all the default styling by adding the disableDefaultStyle attribute.

Here's an example component, styled using tailwindcss

<SvelteOtp
	inputClass="rounded-md bg-gray-200"
	separatorClass="border-blue-700 text-3xl font-bold"
	separator="-"
/>

Available Options

| Name | Default Value | Description | | ----------------------- | ----------------- | ----------------------------------------------------------- | | numOfInputs | 6 | Quantity of input to show | | value | '' | The value of the input | | separator | '' | Separator between the individual inputs | | onlyShowMiddleSeparator | false | Only show one separator in the middle (numOfInputs % 2 = 0) | | placeholder | '' | Placeholder value for the inputs | | disableDefaultStyle | false | Disable default styling of component | | wrapperClass | '' | Custom class to be added to the wrapper element | | inputClass | '' | Custom class to be added to the individual inputs | | separatorClass | '' | Custom class to be added to the separators | | wrapperStyle | '' | Inline style to be added to the wrapper element | | inputStyle | '' | Inline style to be added to the individual inputs | | separatorStyle | '' | Inline style to be added to the separators |