Components/Form
Interactive docs page: https://wix-pages.com/design-system-documentation/#/component/inputshell
Input shell is an atomic input component. It can replace the regular <Input/> or <Dropdown/> components when you need a value that isn't a string, such as in a font dropdown.
- Use
<InputShell/> to preview non-string values.
- Don't use it to show simple string values. Use
<Input/> or <Dropdown/> instead.
Adjust the size of the input using the size prop. It supports 3 sizes:
- For most common cases, use the default
medium.
- To emphasize specific inputs in onboarding flows, use
large.
- Use
small for more dense and compact layouts.
Use menuArrow prop to change InputShell to look like a Dropdown.
disabled removes all interactions and creates a disabled input state. Use it to highlight functions that are unavailable.
<InputShell/> can be rendered as div or as button
Requires use of external package. In this example use-mask-input package is used.
To show border style in the dropdown you can use <InputShell/> as a div and use css or even an svg to create such designs.
| Name | Type | Default | Description |
|---|
as | "button" | "div" | — | Renders the component as button. |
children | ReactNode | — | Allows to render any component as a child item. |
dataHook | string | — | Applies a data-hook HTML attribute to be used in the tests. |
focused | false | true | "auto" | — | Controls visual focus state. |
menuArrow | boolean | false | Specifies whether input should have a dropdown menu arrow on the right side. |
onClick | MouseEventHandler<HTMLButtonElement> | MouseEventHandler<HTMLDivElement> | — | A callback function called on component click. |
placeholder | ReactNode | — | Sets a placeholder message to display. |
size | "small" | "tiny" | "medium" | "large" | — | Controls the size of the input. Default value: medium |
Import the driver matching your test environment:
| Method | Description |
|---|
getTagName | Returns the tag name of the HTML element |
hasMenuArrow | Returns true if dropdown arrow is displayed |
isDisabled | — |
exists | Checks whether the component found with the given data hook. |
element | Gets the component root element. |
click | Clicks on the component root element. |
base | Returns UniDriver for the base element. |
- 1.340.0 (2026-10-21) — maintenance release, no component-specific changes
- 1.339.0 (2026-10-19) — maintenance release, no component-specific changes
- 1.338.0 (2026-10-15) — maintenance release, no component-specific changes
- 1.329.0 (2026-09-24) — maintenance release, no component-specific changes
- 1.328.0 (2026-09-22) — maintenance release, no component-specific changes
- 1.326.0 (2026-09-17) — maintenance release, no component-specific changes
- 1.325.0 (2026-09-17) — maintenance release, no component-specific changes
- 1.323.0 (2026-09-10) — maintenance release, no component-specific changes
- 1.310.0 (2026-08-10) — maintenance release, no component-specific changes
- 1.292.0 (2026-06-22) — maintenance release, no component-specific changes
- 1.273.0 (2026-04-30) — maintenance release, no component-specific changes
- 1.266.0 (2026-04-07) — maintenance release, no component-specific changes
- 1.260.0 (2026-03-17) — maintenance release, no component-specific changes
- 1.254.0 (2026-02-03) — maintenance release, no component-specific changes
- 1.247.2 (2026-01-21) — maintenance release, no component-specific changes
- 1.242.0 (2025-12-19) — maintenance release, no component-specific changes
- 1.241.0 (2025-12-17) — maintenance release, no component-specific changes
- 1.224.0 (2025-10-30) — maintenance release, no component-specific changes
- 1.216.0 (2025-09-01) — maintenance release, no component-specific changes
- 1.212.0 (2025-08-11) — maintenance release, no component-specific changes
- 1.207.0 (2025-07-24) — maintenance release, no component-specific changes
- 1.184.0 (2025-04-30) — feat: add isDisabled to unidriver (#14776)
- 1.182.0 (2025-04-23) — feat: add placeholder and size props (#14728)
- 1.171.0 (2025-03-14) — fix: add font css (#14603)
- 1.169.0 (2025-03-10) — maintenance release, no component-specific changes
- 1.158.0 (2025-02-04) — fix: fix prop types for focused prop in InputShell (#14496)
- 1.146.2 (2024-12-10) — fix: fix overflow when ellipsis (#14372)
- 1.146.0 (2024-12-10) — fix: fixed InputShell menu arrow position for button (#14368)
- 1.145.0 (2024-12-09) — fix: fix InputShell menu arrow position (#14348)
- 1.134.0 (2024-10-18) — feat: add InputShell component (#14210)