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

https://github.com/gaetanozappi/react-native-material-letter-icon

React Native library to generate Google Inbox style material list icons.
https://github.com/gaetanozappi/react-native-material-letter-icon

icons material-icons react-native

Last synced: 8 months ago
JSON representation

React Native library to generate Google Inbox style material list icons.

Awesome Lists containing this project

README

          

# React Native: react-native-material-letter-icon

[![GitHub package version](https://img.shields.io/github/package-json/v/gaetanozappi/react-native-material-letter-icon.svg?style=flat&colorB=2b7cff)](https://github.com/gaetanozappi/react-native-material-letter-icon)
[![github home](http://img.shields.io/npm/v/react-native-material-letter-icon.svg?style=flat)](https://www.npmjs.com/package/react-native-material-letter-icon)
![platforms](https://img.shields.io/badge/platforms-Android-brightgreen.svg?style=flat&colorB=191A17)
[![github home](https://img.shields.io/badge/gaetanozappi-react--native--material--letter--icon-blue.svg?style=flat)](https://github.com/gaetanozappi/react-native-material-letter-icon)
[![npm](https://img.shields.io/npm/dm/react-native-material-letter-icon.svg?style=flat&colorB=007ec6)](https://www.npmjs.com/package/react-native-material-letter-icon)

[![github issues](https://img.shields.io/github/issues/gaetanozappi/react-native-material-letter-icon.svg?style=flat)](https://github.com/gaetanozappi/react-native-material-letter-icon/issues)
[![github closed issues](https://img.shields.io/github/issues-closed/gaetanozappi/react-native-material-letter-icon.svg?style=flat&colorB=44cc11)](https://github.com/gaetanozappi/react-native-material-letter-icon/issues?q=is%3Aissue+is%3Aclosed)
[![Issue Stats](https://img.shields.io/issuestats/i/github/gaetanozappi/react-native-material-letter-icon.svg?style=flat&colorB=44cc11)](http://github.com/gaetanozappi/react-native-material-letter-icon/issues)
[![github license](https://img.shields.io/github/license/gaetanozappi/react-native-material-letter-icon.svg)]()

![Library](screenshot/library.png)
![Lollipop](screenshot/lollipop.png)

Variations
----------
![Library_countries](screenshot/library_countries.png)
![Library_countries_rect](screenshot/library_countries_rect.png)
![Library_round_rect](screenshot/library_round_rect.png)
![Library_triangle](screenshot/library_triangle.png)

- [Usage](#-usage)
- [License](#-license)

## 📖 Getting started

`$ npm install react-native-material-letter-icon --save`

`$ react-native link react-native-material-letter-icon`

#### Android

1. Open up `android/app/src/main/java/[...]/MainActivity.java`
- Add `import com.zappi.ui.material.letter.icon.RNMaterialLetterIconPackage;` to the imports at the top of the file
- Add `new RNMaterialLetterIconPackage()` to the list returned by the `getPackages()` method
2. Append the following lines to `android/settings.gradle`:
```
include ':react-native-material-letter-icon'
project(':react-native-material-letter-icon').projectDir = new File(rootProject.projectDir, '../node_modules/react-native-material-letter-icon/android')
```
3. Insert the following lines inside the dependencies block in `android/app/build.gradle`:
```
compile project(':react-native-material-letter-icon')
```

## 💻 Usage
```javascript
import React, { Component } from 'react';
import {
Platform,
StyleSheet,
Text,
View
} from 'react-native';
import RNMaterialLetterIcon from 'react-native-material-letter-icon';

type Props = {};
export default class App extends Component {
render() {
return (






);
}
}

const styles = StyleSheet.create({
container: {
flex: 1,
justifyContent: 'center',
alignItems: 'center',
backgroundColor: '#F5FCFF',
}
});

```

## 💡 Props

| Prop | Type | Default | Note |
| ----------------- | ---------- | ------- | ---------------------------------------------------------------------------------------------------------- |
| `shapeColor` | `string` | `#1e95cc` | Shape color resource
| `shapeType` | `string` | `circle` | Shape type (circle,rectangle,rect,round)
| `letter` | `string` |`Leonardo Wilhelm DiCaprio` | Letter, string or initials to get letters from
| `letterColor` | `string` | `#ffffff` | Letter color
| `letterSize` | `number` | `26` | Letter size
| `lettersNumber` | `number` | | Letter number
| `initials` | `bool` | `true` | Initials enabled
| `initialsNumber` | `number` | `3` | Initials number
| `border` | `bool` | | Border enabled
| `borderColor` | `string` | | Border color
| `borderSize` | `string` | | Border size

## ✨ Credits
- Android Material Letter Icon: [IvBaranov/MaterialLetterIcon](https://github.com/IvBaranov/MaterialLetterIcon)

## 💫 Contribute
- Pranav Raj Singh Chauhan: [prscx](https://github.com/prscx)

## 📜 License
This library is provided under the Apache License.