Web Components Input Overview

The Ignite UI for Web Components Input is a component where the user can enter data.

Web Components Input Example

To get started we need to import the Input in our typescript file and register the component by calling the defineComponents() function as follows:

import { defineComponents, IgcInputComponent } from 'igniteui-webcomponents';
import 'igniteui-webcomponents/themes/light/bootstrap.css';

defineComponents(IgcInputComponent);

For a complete introduction to the Ignite UI for Web Components, read the Getting Started topic.

After we import the Input component we are ready to start using it, so let’s add our first Input.

<igc-input type="email" label="Subscribe" placeholder="john.doe@mail.com"></igc-input>

Prefix & Suffix

With prefix and suffix slots we can add different content before and after the main content of the Input. In the following sample we will create a new Input field with a text prefix and an icon suffix:

Helper Text

The helper-text slot provides a hint placed below the Input. Let’s add some helper text to our phone Input:

Input Sizing

We can allow the user to change the size of the Input using the --ig-size CSS variable. То do this, we will add some radio buttons to display all size values. This way whenever one gets selected, we will change the size of the Input:

In the sample above we have demonstrated the use of the following attributes:

• required - Used to mark the input as required
• disabled - Used to disable the input
• readonly - Used to mark the input as readonly

The full list of attributes can be found in Input API.

Styling

The Input component exposes CSS parts for almost all of its inner elements. The following table lists all of the exposed CSS parts:

igc-input::part(input) {
  background-color: var(--ig-primary-100);
  border-color: var(--ig-secondary-500);
  box-shadow: none;
}

igc-input::part(label) {
  color: var(--ig-gray-700);
}

igc-input::part(prefix),
igc-input::part(suffix) {
  color: var(--ig-primary-600-contrast);
  background-color: var(--ig-primary-600);
  border-color: var(--ig-secondary-600);
}

API References

Additional Resources

• Ignite UI for Web Components Forums
• Ignite UI for Web Components GitHub