React Nice Avatar Save

react library for generating avatar

Project README

react-nice-avatar

Version npm download Build Status Netlify Status

Online editor / preview

Assets

Installation

npm install react-nice-avatar

or

yarn add react-nice-avatar

Usage

  1. Import the component.

    import Avatar, { genConfig } from 'react-nice-avatar'
    
  2. Generate a random configuration, save it so that you can always rendering a same avatar with the configuration.

    const config = genConfig(AvatarConfig?) 
    

    tip: AvatarConfig is an Object, plz check the Options below for what attributes can be passed in

  3. Render the component with specific width / height and configuration.

    <Avatar style={{ width: '8rem', height: '8rem' }} {...config} />
    

    or

    <Avatar className="w-32 h-32" {...config} />
    

Options

The options can be passed into genConfig or as React props

key type default accept tips
id string Only for React Props
className string Only for React Props
style object Only for React Props
shape string circle circle, rounded, square Only for React Props
sex string man, woman
faceColor string
earSize string small, big
hairColor string
hairStyle string normal, thick, mohawk, womanLong, womanShort
hairColorRandom boolean false thick,mohawk default only be black
hatColor string
hatStyle string none, beanie, turban Usually is none
eyeStyle string circle, oval, smile
glassesStyle string none, round, square Usually is none
noseStyle string short, long, round
mouthStyle string laugh, smile, peace
shirtStyle string hoody, short, polo
shirtColor string
bgColor string
isGradient boolean false

Development

  1. Clone the repo:
    $ git clone [email protected]:dapi-labs/react-nice-avatar.git
    $ cd react-nice-avatar
    
  2. Install dependencies:
    $ yarn
    
    Or
    $ npm install
    
  3. Start the server for the demo:
    $ make dev
    
  4. Open the browser to reivew the demo:
    $ open http://localhost:8080
    
  5. Edit the files inside src.

Test

  1. Lint test:

    $ make lint-test
    
  2. code test:

    $ make test
    

License

Released under MIT by @dapi-labs.




Open Source Agenda is not affiliated with "React Nice Avatar" Project. README Source: dapi-labs/react-nice-avatar
Stars
720
Open Issues
0
Last Commit
2 months ago
License
MIT

Open Source Agenda Badge

Open Source Agenda Rating