React Native Material Component (iOS and Android supported)
Getting Started
$ npm i react-native-material-component --save
Setting of vector icons
You can see this repo for much more information.
React Native Link (recommended)
Make sure you have atleast v0.31.0 react-native version.
$ react-native link react-native-vector-icons
Manual Installation
original)
Android (seeCopy the MaterialIcons
font file from react-native-vector-icons to your local working directory:
./node_modules/react-native-vector-icons/Fonts/MaterialIcons.ttf
-> ./android/app/src/main/assets/fonts
.
original)
iOS (seeUsage
To achieve the level of customizability, React Native Material UI is using a single JS object called uiTheme that is passed in via context. By default, this uiTheme object is based on the lightTheme that you can find here. So, you can change almost everything very easily.
The uiTheme object contains the following keys:
spacing: {} // can be used to change the spacing of components.
fontFamily: {} // can be used to change the default font family.
palette: { // can be used to change the color of components.
primaryColor: blue500,
accentColor: red500,
...
}
typography: {} // can be used to change the typography of components
// you can change style of every each component
avatar: {}
button: {}
toolbar: {}
...
;; ; // you can set your style right here, it'll be propagated to applicationconst uiTheme = palette: primaryColor: Colorgreen500 toolbar: container: height: 50 ; { return <ThemeProvider uiTheme=uiTheme> <App /> </ThemeProvider> ; }
It means, if you want to change primary color of your application for example. You can just pass to ThemeProvider object with your own settings. Your settings will be merged with default theme.
What else?
Another great feature is, you can use the uiTheme
everywhere. Even in your own components. Look how you can get the primary color.
const contextTypes = uiTheme: PropTypesobjectisRequired; { // it's really easy to get primary color everywhere in your app const primaryColor = thiscontextuiThemepalette; return ... }
Animations are included
Note: You have to allow the animations for Android (see React Native's documentation)
UIManagersetLayoutAnimationEnabledExperimental && UIManager;
Components
Here is a list of all component included in this library. (I'm working on documentation for every each component. Be patient please :))
- Avatar
- Badge
- AutoGrowTextInput
- Card
- Checkbox
- Divider
- Icon
- ListItem
- Progress
- SwipeListView
- Toolbar
- Toast
- TextField
- Dropdown
- RippleFeedback
- FloatingActionButton
- BottomNavigationBar
- SnackBar