Piplup
@piplup/rhf-adaptersmui-x-date-pickersComponents

MuiXYearCalendarElement

A pre-integrated MuiXYearCalendarElement component for connecting MUI X YearCalendar to React Hook Form.

Import

import { MuiXYearCalendarElement } from "@piplup/rhf-adapters/mui-x-date-pickers";

Usage

"use client";import dayjs from "dayjs";import { MuiXYearCalendarElement } from "@piplup/rhf-adapters/mui-x-date-pickers";import { LocalizationProvider } from "@mui/x-date-pickers";import { AdapterDayjs } from "@mui/x-date-pickers/AdapterDayjs";import { MuiButtonElement } from "@piplup/rhf-adapters/mui-material";import { useForm } from "react-hook-form";export default function Page() {  const { control, handleSubmit } = useForm({    defaultValues: { year: dayjs() },  });  return (    <LocalizationProvider dateAdapter={AdapterDayjs}>      <form        onSubmit={handleSubmit((values) =>          alert(JSON.stringify(values, null, 2)),        )}      >        <MuiXYearCalendarElement control={control} name="year" />        <MuiButtonElement control={control} type="submit" variant="contained" sx={{ mt: 2 }}>          Submit        </MuiButtonElement>      </form>    </LocalizationProvider>  );}
"use client";import dayjs from "dayjs";import { MuiXYearCalendarElement } from "@piplup/rhf-adapters/mui-x-date-pickers";import { LocalizationProvider } from "@mui/x-date-pickers";import { AdapterDayjs } from "@mui/x-date-pickers/AdapterDayjs";import { MuiButtonElement } from "@piplup/rhf-adapters/mui-material";import { FormContainer } from "@piplup/rhf-core";export default function Page() {  return (    <LocalizationProvider dateAdapter={AdapterDayjs}>      <FormContainer        defaultValues={{ year: dayjs() }}        onSubmit={(values) => alert(JSON.stringify(values, null, 2))}      >        <MuiXYearCalendarElement name="year" />        <MuiButtonElement type="submit" variant="contained" sx={{ mt: 2 }}>          Submit        </MuiButtonElement>      </FormContainer>    </LocalizationProvider>  );}

Props

Prop

Type

MuiXYearCalendarElement supports all standard props of the MUI X YearCalendar component, along with additional adapter-specific props. For a complete list of available YearCalendar properties, refer to the MUI X Date Pickers API documentation.

The ref is forwarded to the underlying <YearCalendar /> component.

Notes

  • For custom year calendars, build on useMuiXYearCalendarAdapter.

See also

On this page