Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/omnedia/ngx-shiny-text

A simple component library to animate text.
https://github.com/omnedia/ngx-shiny-text

Last synced: 15 days ago
JSON representation

A simple component library to animate text.

Awesome Lists containing this project

README

        

# ngx-shiny-text

`@omnedia/ngx-shiny-text` is an Angular library that provides a shimmering text animation effect. This component allows you to easily add a glowing, moving shimmer effect over text, making your text stand out with a visually appealing style.

## Features

- Shimmering animation effect for text.
- Customizable shimmer color, text color, and shimmer width.
- Lightweight and easy to integrate as a standalone component.

## Installation

Install the library using npm:

```bash
npm install @omnedia/ngx-shiny-text
```

## Usage

Import the `NgxShinyTextComponent` in your Angular module or component:

```typescript
import { NgxShinyTextComponent } from '@omnedia/ngx-shiny-text';

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

Use the component in your template:

```html

```

## API

```html

```
- `text` (required): The text content to be displayed with the shimmering effect.
- `shimmerColor` (optional): The color of the shimmer effect. Accepts any valid CSS color value.
- `textColor` (optional): The color of the text. Accepts any valid CSS color value.
- `shimmerWidth` (optional): The width of the shimmer effect in pixels or percentages. Defaults to 100px.
- `styleClass` (optional): A custom CSS class to apply to the shimmering text element.

## Example

```html

```

This will create a shimmering text effect where the text "Welcome to our site!" is displayed with a golden shimmer and a custom text color.

## Styling

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

```css
.shiny-text-style {
font-size: 36px;
font-weight: bold;
font-family: 'Arial', sans-serif;
}
```

This will style the shimmering text with a custom font size, weight, and font family.

## 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.