Modal Component

A reusable modal dialog component that displays messages to users with different types (success, error, info). The modal includes an overlay, close button, and click-outside functionality for better user experience. Fully accessible with ARIA attributes, keyboard navigation, and focus management.

Overview

The Modal component is a flexible dialog component built with React and inline CSS. It provides a clean, centered dialog that appears over the main content with a semi-transparent overlay. The component supports different visual types to convey different message categories to users. It is fully accessible with comprehensive ARIA support, keyboard navigation, and focus management.

Dependencies

• React: React library for building the component (v19.1.1 or higher)

The component uses only React and does not require any external styling libraries. All styles are implemented using inline CSS.

npm install react react-dom
# or
yarn add react react-dom

Props

Prop	Type	Required	Description
isOpen	boolean	Yes	Controls the visibility of the modal
onClose	() => void	Yes	Callback function called when the modal should be closed
title	string	Yes	The title displayed in the modal header
message	string	Yes	The main message content displayed in the modal body
type	'success' | 'error' | 'info'	Yes	The type of modal which determines the icon color

Types

The modal supports three types, each with a distinct color scheme:

• success: Green icon (#22c55e) - Use for successful operations or confirmations
• error: Red icon (#ef4444) - Use for error messages or failed operations
• info: Blue icon (#3b82f6) - Use for informational messages or general notifications

Usage

Basic Example

import { useState } from 'react';
import Modal from './components/modal';

function App() {
  const [isOpen, setIsOpen] = useState(false);

  return (
    <>
      <button onClick={() => setIsOpen(true)}>Open Modal</button>
      <Modal
        isOpen={isOpen}
        onClose={() => setIsOpen(false)}
        title="Success"
        message="Employee added successfully!"
        type="success"
      />
    </>
  );
}

Success Modal

<Modal
  isOpen={isOpen}
  onClose={() => setIsOpen(false)}
  title="Success"
  message="Your changes have been saved successfully."
  type="success"
/>

Error Modal

<Modal
  isOpen={isOpen}
  onClose={() => setIsOpen(false)}
  title="Error"
  message="An error occurred while processing your request."
  type="error"
/>

Info Modal

<Modal
  isOpen={isOpen}
  onClose={() => setIsOpen(false)}
  title="Information"
  message="Please review your information before submitting."
  type="info"
/>

Features

1. Fixed Overlay

• Semi-transparent black background (rgba(0, 0, 0, 0.4))
• Covers the entire viewport
• High z-index (999) to appear above other content

2. Centered Modal Dialog

• White background with rounded corners
• Centered both vertically and horizontally
• Responsive padding and spacing

3. Close Button

• Positioned in the top-right corner
• Click to close the modal
• Hover effect for better UX

4. Click-Outside-to-Close

• Click on the overlay (outside the modal content) to close
• Clicking inside the modal content does not close it
• Provides intuitive user interaction

5. Type-Based Icon Display

• Automatically displays an icon based on the type prop
• Icon color matches the modal type (green, red, or blue)
• Icon is displayed alongside the title

6. Full Accessibility Support

• ARIA attributes for screen reader support
• Keyboard navigation (ESC, Tab, Shift+Tab)
• Focus trap to keep focus within the modal
• Automatic focus management and restoration

Component Structure

The Modal component is composed of several sub-components, each handling a specific part of the UI:

• Overlay: Fixed positioning with semi-transparent background, handles click-outside events
• ModalContent: White background container with rounded corners and centered layout
• CloseButton: Positioned absolutely in top-right corner with hover effects
• TitleContainer: Flex layout container for displaying the icon and title together
• MessageContainer: Container for the modal message text
• IconWrapper: SVG icon component with dynamic color based on modal type

Styling

The component uses inline CSS (React inline styles) for all styling. This approach:

• Eliminates external dependencies (no CSS-in-JS libraries required)
• Keeps styles scoped to the component
• Provides better performance without runtime style processing
• Maintains type safety with TypeScript

The modal includes:

• Overlay: Fixed positioning with semi-transparent background (rgba(0, 0, 0, 0.4))
• Modal Content: White background, rounded corners (0.375rem), centered layout with flexbox
• Close Button: Absolute positioning in top-right, hover opacity effect
• Title Container: Flex layout with icon and text alignment, gap spacing
• Message Container: Centered text display
• Icon: SVG icon with dynamic color based on type (success: green, error: red, info: blue)

All styling is contained within the component and does not require external CSS files or additional styling dependencies.

Accessibility

The Modal component is fully accessible and complies with WCAG accessibility standards. It includes comprehensive support for screen readers and keyboard navigation.

ARIA Attributes

• role="dialog" or role="alertdialog" - Automatically uses alertdialog for error modals to attract attention
• aria-modal="true" - Indicates that the modal is a modal dialog
• aria-labelledby - Links the modal title for screen reader announcements
• aria-describedby - Links the modal message for screen reader announcements
• aria-label - Close button has a descriptive label ("Fermer la modale")
• aria-hidden="true" - Applied to decorative elements (icon SVG, close button character)

Keyboard Navigation

• ESC key - Closes the modal when pressed
• Tab navigation - Full keyboard navigation support for all interactive elements
• Focus trap - Keeps focus within the modal when using Tab/Shift+Tab
• Focus restoration - Automatically restores focus to the previously focused element when the modal closes

Focus Management

• Automatic focus - Focus is automatically moved to the modal content when it opens
• Focus trap - Tab navigation cycles through focusable elements within the modal only
• Focus restoration - When the modal closes, focus returns to the element that triggered it
• Keyboard accessibility - All interactive elements are fully keyboard accessible

Screen Reader Support

• Proper semantic HTML structure with ARIA roles and properties
• Title and message are properly announced by screen readers
• Modal is not rendered in the DOM when closed (isOpen={false}), preventing screen reader confusion
• Decorative elements are properly marked with aria-hidden="true"

Examples

Form Submission Success

const handleSubmit = async (data) => {
  try {
    await submitForm(data);
    setModalOpen(true);
    setModalType('success');
    setModalTitle('Success');
    setModalMessage('Form submitted successfully!');
  } catch (error) {
    setModalOpen(true);
    setModalType('error');
    setModalTitle('Error');
    setModalMessage('Failed to submit form. Please try again.');
  }
};

<Modal
  isOpen={modalOpen}
  onClose={() => setModalOpen(false)}
  title={modalTitle}
  message={modalMessage}
  type={modalType}
/>

Conditional Modal Display

const [showModal, setShowModal] = useState(false);
const [modalConfig, setModalConfig] = useState({
  title: '',
  message: '',
  type: 'info' as const
});

// Trigger modal with configuration
const showSuccessModal = () => {
  setModalConfig({
    title: 'Operation Complete',
    message: 'The operation completed successfully.',
    type: 'success'
  });
  setShowModal(true);
};

<Modal
  isOpen={showModal}
  onClose={() => setShowModal(false)}
  {...modalConfig}
/>

Installation from GitHub Packages

This package is published to Npm packages.

1. Install the package:

npm install sebastien-sq-react-simple-modal

3. Import and use in your code:

import Modal from 'sebastien-sq-react-simple-modal';

// Use the component
<Modal
  isOpen={isOpen}
  onClose={() => setIsOpen(false)}
  title="Success"
  message="Operation completed!"
  type="success"
/>

File Location

modal.tsx

Notes

• The modal returns null when isOpen={false}, preventing it from being rendered in the DOM when closed (better performance and accessibility)
• The z-index values (999 for overlay, 1000 for content) ensure proper layering
• The click-outside functionality only triggers when clicking directly on the overlay, not on child elements
• The component uses TypeScript for type safety
• All styles are implemented using React inline styles (no external CSS or CSS-in-JS libraries)
• The component is composed of smaller sub-components (Overlay, ModalContent, CloseButton, TitleContainer, MessageContainer, IconWrapper) for better code organization and maintainability
• The component uses React hooks (useRef, useEffect, useId) for focus management and accessibility features