RHFSelect
RHFSelect is an extended version of Select, allowing users to select one or more options. One key advantage is its ability to accept both arrays and arrays of objects, making it easier to render options with differing labels and values without custom logic.
If the number of options exceeds 20, consider using RHFAutocomplete or RHFMultiAutocomplete for better searchability, improved keyboard navigation, and overall performance.
Usage
import RHFSelect, { RHFSelectProps } from '@nish1896/rhf-mui-components/mui/select';Here is a basic example with an array of strings:
<RHFSelect
fieldName="color"
control={control}
options={['Red', 'Blue', 'Orange']}
/>For options as an array of objects:
<RHFSelect
fieldName="country"
control={control}
options={[
{ code: 'AUS', country: 'Australia' },
{ code: 'IN', country: 'India' },
{ code: 'UAE', country: 'United Arab Emirates' },
]}
labelKey="country"
valueKey="code"
/>When using an array of objects for options, both labelKey and valueKey
are required. If either is missing, an error will be thrown.
You can extend or reuse the RHFSelect component by creating your own wrapper component.
/**
* The below code snippet illustrates how to create a reusable styled Select
* component using RHFSelect, which can be used throughout the application.
*
* `multiple` is left in the prop surface (not `Omit`'d) so its generic
* `Multiple` type param is inferred per call site from the literal passed —
* same as `RHFSelect` itself. Omitting `multiple` from the props type would
* pin `Multiple` to its default and make passing `multiple={false}` a type
* error.
*
* A similar approach can be taken to create reusable styled components for:
* - RHFNativeSelect
* - RHFCheckboxGroup
* - RHFRadioGroup
*/
import { type FieldValues } from 'react-hook-form';
import { Poppins } from 'next/font/google';
import RHFSelect, {
type RHFSelectProps
} from '@nish1896/rhf-mui-components/mui/select';
import type { StrNumObjOption } from '@nish1896/rhf-mui-components/types';
const poppins = Poppins({
subsets: ['latin'],
style: 'italic',
weight: ['100', '200', '300', '400', '500', '600', '700', '800', '900']
});
type StyledSelectProps<
T extends FieldValues,
Option extends StrNumObjOption = StrNumObjOption,
LabelKey extends Extract<keyof Option, string> = Extract<keyof Option, string>,
ValueKey extends Extract<keyof Option, string> = Extract<keyof Option, string>,
Multiple extends boolean = true
> = Omit<
RHFSelectProps<T, Option, LabelKey, ValueKey, Multiple>,
'showLabelAboveFormField'
>;
const StyledSelect = <
T extends FieldValues,
Option extends StrNumObjOption = StrNumObjOption,
LabelKey extends Extract<keyof Option, string> = Extract<keyof Option, string>,
ValueKey extends Extract<keyof Option, string> = Extract<keyof Option, string>,
Multiple extends boolean = true
>({
formLabelProps,
...rest
}: StyledSelectProps<T, Option, LabelKey, ValueKey, Multiple>) => {
return (
<RHFSelect
formLabelProps={{
...formLabelProps,
sx: {
fontFamily: poppins.style.fontFamily,
fontWeight: 400,
...formLabelProps?.sx
}
}}
showLabelAboveFormField
{...rest}
/>
);
};
export default StyledSelect;
Examples
API
The RHFSelectProps interface extends SelectProps
and accepts the following additional props.
Props marked with * are required.
| Name | Type | Description |
|---|---|---|
fieldName* | string | Name of the field registered with React Hook Form. This prop is required for all components. |
control* | UseFormControl | |
registerOptions | RegisterOptions | React Hook Form validation rules. Useful when not using a schema validation library such as Yup or Joi. |
options* | string[] / number[] / object[] | An array with string, numeric or object values. Make sure to pass labelKey and valueKey when options is an array of objects. |
labelKey | string | Property name used as the visible label for each option. Required when options is an array of objects. |
valueKey | string | Property name used as the stored value for each option. Required when options is an array of objects. |
multiple | boolean | Allows multiple values to be selected. |
customOnChange | ({ rhfOnChange, newValue, event, child }) => void | Override the default onChange behavior of the select component. You must pass the updated newValue to the rhfOnChange function to update the field value. |
onValueChange | ({ newValue, event, child }) => void | An optional callback function when an option is selected. The latest value can be obtained from newValue argument. |
renderOptionLabel | (option) => ReactNode | Custom renderer for option labels. When not provided, the label is derived from the option value or the property specified by labelKey.Option state param added in v4.2.0 |
getOptionDisabled | (option) => boolean | Function used to determine whether an option should be disabled. Return true to disable the option and prevent it from being selected. |
menuItemProps | MenuItemProps | Props forwarded to each internal MUI MenuItem, applied to every rendered option.Added in v4.3. |
showDefaultOption | boolean | Displays a default option with an empty value ( '') at the top of the dropdown. The displayed text can be customized using defaultOptionText. |
defaultOptionText | string | Custom text to replace the default text when showDefaultOption is true for RHFSelect or RHFNativeSelect. |
label | ReactNode | The text to render in the FormLabel component. By default, the value of fieldName is transformed (e.g., "firstName" to "First Name") using the fieldNameToLabel function. |
inputLabelProps | InputLabelProps | Props forwarded to the InputLabel — the inline label shown inside the field's outline.Added in v4.3. |
showLabelAboveFormField | boolean | Render form label above the form field in FormLabel component. |
formLabelProps | FormLabelProps | FormLabelProps to customise FormLabel component for a field. Multiple fields can be configured using the ConfigProvider component. |
hideLabel | boolean | Hides the FormLabel component if you don’t want to display the default form label component or prefer to render a fully custom label instead. |
renderError | (error: FieldError) => ReactNode | Custom renderer for the React Hook Form field error. Receives the current field error and returns the content to display, such as error.message or a custom React element in the HelperText component.Added in v4.1.0. |
hideErrorMessage | boolean | A flag to prevent replacement of helper text of a field by the errorMessage when the validation is triggered. |
helperText | ReactNode | The content to display within the FormHelperText component below the field. If the field validation fails, this content will be overridden by the corresponding error message. |
formHelperTextProps | FormHelperTextProps | FormHelperTextProps to customise FormHelperText component for a field. Multiple fields can be configured using the ConfigProvider component. |
customIds | { field, label, helperText, error } | Overrides the default field, label, helper text, and error IDs used for accessibility. |
Source Code
View the full implementation of this component on GitHub.

