Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/emberexperts/ember-initials
Advanced avatars generator for Ember applications. Initials Ⓜ, images 🌇, gravatars 👩🏻 and adorables 😍 All you need for your users profiles!
https://github.com/emberexperts/ember-initials
avatars ember-initials emberjs generator initials
Last synced: 6 days ago
JSON representation
Advanced avatars generator for Ember applications. Initials Ⓜ, images 🌇, gravatars 👩🏻 and adorables 😍 All you need for your users profiles!
- Host: GitHub
- URL: https://github.com/emberexperts/ember-initials
- Owner: EmberExperts
- License: mit
- Created: 2016-02-13T16:47:08.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2023-03-06T17:30:36.000Z (over 1 year ago)
- Last Synced: 2024-11-07T12:02:20.142Z (6 days ago)
- Topics: avatars, ember-initials, emberjs, generator, initials
- Language: JavaScript
- Homepage: http://emberexperts.github.io/ember-initials/
- Size: 8.56 MB
- Stars: 102
- Watchers: 4
- Forks: 15
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
Ember Initials is a package for generating simple avatars using users initials, images, gravatars or adorables. It definitely supports Ember 3.16 (or higher). Thanks to highly customizable interface you can define defaults and even set fallbacks.
## Demo App with code generators
Demo app with interactive examples you can find at [http://exelord.github.io/ember-initials][9225812a]
[9225812a]: http://exelord.github.io/ember-initials/ "Ember Initials Demo App"
## Compatibility
* Ember.js v3.16 or above
* Ember CLI v2.13 or above
* Node.js v10 or above
This addon has been tested on:
- IE 10 and UP including EDGE
- Firefox 44 and UP
- Chrome 48 and UP
- Opera 35 and UP
## Install
`ember install ember-initials`
## Quick start
Ember Initials gives you a built-in components which you can use in yours templates:
##### Initials avatars:
```hbs
```
or
```hbs
```
##### Image avatars:
```hbs
```
##### Gravatar avatars:
```hbs
```
##### Adorables avatars:
```hbs
```
> Examples, configuration and code generator are available on [Project Site][9225812a].
## API Documentation
### `EmberInitials`
```hbs
```
- `image` - image url | if image will be not found the initials avatars will be used
- `name` - name of user to generate initials
- `defaultName` - if `name` will be not passed this name will be used
- `seedText` - uniq string which will be used to generate background color, eg. user's email
- `textColor` - color of the text (initials) | hash or name
- `fontSize` - font size in `px`
- `fontWeight` - font weight in `px`
- `fontFamily` - names of fonts with fallbacks | at this time only system fonts can be used
- `size` - size of the avatar in pixels (set `null` if you do not want to use elements attributes like `width` and `height`)
### `EmberInitials::Image`
```hbs
```
- `image` - image url | if image will be not found the `defaultImage` will be used
- `defaultImage` - default image url
- `size` - size of the avatar in pixels (set `null` if you do not want to use elements attributes like `width` and `height`)
### `EmberInitials::Gravatar`
```hbs
```
- `image` - image url | if image will be not passed the avatar will be generated form email thanks to gravatar
- `email` - Email which will be used to fetching the gravatar
- `defaultImage` - image src (relative or absolute URL depends on `relativeUrl` option) | if gravatar will not be found this image will be used
- `relativeUrl` - `true` or `false` | decide which `defaultImage` url do you want to use - relative or absolute
- `size` - size of the avatar in pixels (set `null` if you do not want to use elements attributes like `width` and `height`)
### `EmberInitials::Adorable`
```hbs
```
- `image` - image url | if image will be not found the avatar will be generated form email thanks to adorable
- `email` - Email which will be used to generating unique adorable avatar
- `size` - size of the avatar in pixels (set `null` if you do not want to use elements attributes like `width` and `height`)