An open API service indexing awesome lists of open source software.

https://github.com/omnedia/ngx-retro-grid

A simple component library to create a container with an animated background.
https://github.com/omnedia/ngx-retro-grid

Last synced: about 1 month ago
JSON representation

A simple component library to create a container with an animated background.

Awesome Lists containing this project

README

        

# ngx-retro-grid



This Library is part of the NGXUI ecosystem.

View all available components at https://ngxui.com

`@omnedia/ngx-retro-grid` is an Angular library that provides a retro-styled grid background animation for Angular components. This component creates a 3D perspective grid with customizable colors, rotation, and smooth animation, perfect for adding a nostalgic or futuristic visual effect to your application.

## Features

- Retro grid animation with customizable grid color, fade color, and grid rotation.
- Flexible configuration to match the style of your application.
- Lightweight and easy to integrate as a standalone component.

## Installation

Install the library using npm:

```bash
npm install @omnedia/ngx-retro-grid
```

## Usage

Import the NgxRetroGridComponent in your Angular module or component:

```typescript
import {NgxRetroGridComponent} from '@omnedia/ngx-retro-grid';

@Component({
...
imports:
[
...
NgxRetroGridComponent,
],
...
})
```

Use the component in your template:

```html

Your content here

```

## API

```html

```

- gridColor (optional): The color of the grid lines in the background. Accepts a hex color code.
- fadeColor (optional): The color used for the fading effect in the background. Accepts any valid CSS color value.
- gridRotation (optional): The rotation angle for the grid. Accepts any valid CSS rotation value (e.g., '35deg', '45deg').
- styleClass (optional): A custom CSS class to apply to the component's wrapper element.

## Example

```html

This is a retro grid background

```

This will create a retro grid background with a cyan grid, a dark blue fading effect, and a 45-degree rotation for the grid.

## Styling

To customize the appearance of the grid or the container, use the styleClass input to apply your own CSS classes.

```css
.example-class {
padding: 20px;
background-color: rgba(0, 0, 0, 0.8);
color: white;
}
```

## Contributing

Contributions are welcome. Please submit a pull request or open an issue to discuss your ideas.

## License

This project is licensed under the MIT License.