0.23.0 • Published 3 months ago

@bolttech/molecules-calendar v0.23.0

Weekly downloads
-
License
-
Repository
-
Last release
3 months ago

Calendar Component

The Calendar component is a React component designed to display a calendar interface for selecting dates. It allows you to choose a date within a specified range and provides options for confirming or canceling the selection.

Table of Contents

Installation

To use the Calendar component in your React application, follow these steps:

npm install @bolttech/frontend-foundations @bolttech/molecules-calendar

or

yarn add @bolttech/frontend-foundations @bolttech/molecules-calendar

Once you have the required dependencies installed, you can start using the Calendar component in your React application.

Usage

The Calendar component provides a user-friendly calendar interface for date selection. It allows you to choose a date within a specified range. You can customize the locale, minimum and maximum dates, and more using its props.

To use the component, import it and include it in your JSX:

import React, { useState } from 'react';
import { Calendar } from '@bolttech/molecules-calendar';
import { bolttechTheme, BolttechThemeProvider } from '@bolttech/frontend-foundations'; // You can import your Calendar component here

function App() {
  const [selectedDate, setSelectedDate] = useState('');

  const handleDateChange = (date) => {
    setSelectedDate(date);
  };

  return (
    <BolttechThemeProvider theme={bolttechTheme}>
      <Calendar value={selectedDate} onChange={handleDateChange} min="2023-01-01" max="2023-12-31" />
      <p>Selected Date: {selectedDate}</p>
    </BolttechThemeProvider>
  );
}

export default App;

Props

The Calendar component accepts the following props:

PropTypeDescription
idstringThe ID attribute for the calendar container.
dataTestIdstringThe data-testid attribute for testing purposes.
localestringThe locale used for month and day names. Default is 'en'.
showOtherMonthsDaysbooleanBoolean representing if the calendar should display the days of the previous and next month on empty slots
minstringThe minimum selectable date (ISO 8601 format, e.g., '2023-01-01').
maxstringThe maximum selectable date (ISO 8601 format, e.g., '2023-12-31').
valuestringThe currently selected date (ISO 8601 format).
cancelstringThe text for the cancel button. Default is 'Cancel'.
confirmstringThe text for the confirm button. Default is 'Confirm'.
onCancelfunctionThe callback function triggered when the cancel button is clicked.
onChangefunctionThe callback function triggered when a date is selected.

Example

Here's an example of using the Calendar component:

<Calendar value={selectedDate} onChange={handleDateChange} min="2023-01-01" max="2023-12-31" />

This will render a calendar interface with selectable dates between January 1, 2023, and December 31, 2023.

Contributing

Contributions to the Calendar component are welcome. If you find any issues or have suggestions for improvements, please feel free to open an issue or submit a pull request on the project's Bitbucket repository.

0.23.0

3 months ago

0.22.0

3 months ago

0.21.2

4 months ago

0.21.1

5 months ago

0.21.0

5 months ago

0.0.1

5 months ago

0.20.0

6 months ago

0.19.0

6 months ago

0.18.1

8 months ago

0.19.1

6 months ago

0.18.2

8 months ago

0.18.3

7 months ago

0.11.0

9 months ago

0.12.0

9 months ago

0.13.0

9 months ago

0.14.0

9 months ago

0.15.0

9 months ago

0.16.0

9 months ago

0.17.0

8 months ago

0.16.1

8 months ago

0.18.0

8 months ago

0.10.0

10 months ago

0.3.0

10 months ago

0.9.0

10 months ago

0.8.0

10 months ago

0.3.2

10 months ago

0.5.0

10 months ago

0.3.1

10 months ago

0.4.0

10 months ago

0.6.0

10 months ago

0.2.1

11 months ago

0.2.0

11 months ago

0.1.0

11 months ago