A highly flexible React component for embedding YouTube videos or thumbnails, with customizable aspect ratios, styles, and seamless integration with Tailwind CSS.
Check out these examples to see what you can achieve with ReactYTFlexible
:
Standard video with custom border radius
Thumbnail with hover effect and custom styling
Check out our live demo to see ReactYTFlexible
in action and explore more usage examples.
You can also view the running app without seeing the code here.
- Embed YouTube videos or thumbnails with a single video ID.
- Customizable aspect ratios (16:9, 4:3, 21:9, 1:1, 9:16, 3:2).
- Support for custom styles and Tailwind CSS classes.
- Lightweight and easy to use.
- Perfect for responsive designs and easily adaptable to various screen sizes.
- Seamless integration with Tailwind CSS for rapid UI development.
Install the package using npm:
npm install react-yt-flexible
To use the ReactYTFlexible
component, simply import it and pass the videoId
of the YouTube video you want to embed:
import React from 'react';
import { ReactYTFlexible } from 'react-yt-flexible';
function App() {
return (
<div>
{/* Standard video */}
<ReactYTFlexible videoId="dQw4w9WgXcQ" />
{/* Thumbnail mode with custom border radius */}
<ReactYTFlexible
videoId="dQw4w9WgXcQ"
mode="thumbnail"
borderRadius="1rem"
/>
</div>
);
}
export default App;
Here are the available props for the ReactYTFlexible
component:
-
videoId
(string, required): The YouTube video ID. -
mode
(string, optional): Either'video'
or'thumbnail'
. Default is'video'
. -
aspectRatio
(string, optional):'16:9'
,'4:3'
,'21:9'
,'1:1'
,'9:16'
, or'3:2'
. Default is'16:9'
. -
borderRadius
(string, optional): CSS border-radius value. Default is'0px'
. -
style
(object, optional): Custom inline styles. -
className
(string, optional): Tailwind CSS or other class names for additional styling.
ReactYTFlexible
is designed to work seamlessly with Tailwind CSS, allowing you to:
- Apply Tailwind utility classes directly to the component
- Create responsive designs effortlessly
- Implement hover, focus, and other interactive states
- Utilize Tailwind's animation and transition utilities
Example:
<ReactYTFlexible
videoId="dQw4w9WgXcQ"
mode="thumbnail"
className="rounded-lg shadow-lg transition duration-500 group-hover:scale-105"
/>
This integration allows you to rapidly prototype and build beautiful, responsive YouTube embeds without leaving your Tailwind workflow.
This project is licensed under the MIT License. You can find the full license here.