React Native - What is the benefit of using StyleSheet vs a plain object?
React NativeReact Native-StylesheetReact Native Problem Overview
What exactly is the benefit of using StyleSheet.create()
vs a plain object?
const styles = StyleSheet.create({
container: {
flex: 1
}
}
Vs.
const styles = {
container: {
flex: 1
}
}
React Native Solutions
Solution 1 - React Native
There is no benefit. Period.
StyleSheet
is more performant
Myth 1: There is absolutely no performance difference between StyleSheet
and an object declared outside of render
(it would be different if you're creating a new object inside render
every time). The performance difference is a myth.
The origin of the myth is likely because React Native team tried to do this, but they weren't successful. Nowhere in the official docs you will find anything about performance: https://facebook.github.io/react-native/docs/stylesheet.html, while source code states "not implemented yet": https://github.com/facebook/react-native/blob/master/Libraries/StyleSheet/StyleSheet.js#L207
StyleSheet
validates style object at compile time
Myth 2: This is not true. Plain JavaScript can't validate objects at compile time.
Two things:
- It does validate at runtime, but so does when you pass the style object to a component. No difference.
- It does validate at compile time if you're using Flow or TypeScript, but so does once you pass the object as a style prop to a component, or if you properly typehint object like below. No difference either.
const containerStyle: ViewStyle = {
...
}
Solution 2 - React Native
Quoting directly from comment section of StyleSheet.js of React native
> Code quality:
>
> - By moving styles away from the render function, you're making the code easier to understand.
>
> - Naming the styles is a good way to add meaning to the low level components in the render function.
>
> Performance:
>
> - Making a stylesheet from a style object makes it possible to refer to it by ID instead of creating a new style object every time.
>
> - It also allows to send the style only once through the bridge. All subsequent uses are going to refer an id (not implemented yet).
Also StyleSheet validates your stylesheet content as well. So any error of incorrect style property is shown at time of compiling rather than at runtime when StyleSheet is actually implemented.
Solution 3 - React Native
The accepted answer is not an answer to the OP question.
The question is not the difference between inline styles and a const
outside the class, but why we should use StyleSheet.create
instead of a plain object.
After a bit of researching what I found is the following (please update if you have any info).
The advatanges of StyleSheet.create
should be the following:
- It validates the styles
- Better perfomances because it creates a mapping of the styles to an ID, and then it refers inside with this ID, instead of creating every time a new object. So even the process of updating devices is faster because you don't send everytime all the new objects.
Solution 4 - React Native
It used to be considered that using a StyleSheet was more performant, and was recommended for this reason by the RN team up until version 0.57, but it is now no longer recommended as correctly pointed out in another answer to this question.
The RN documentation now recommends StyleSheet for the following reasons, though I think these reasons would apply equally to plain objects that are created outside of the render function:
- By moving styles away from the render function, you're making the code easier to understand.
- Naming the styles is a good way to add meaning to the low level components in the render function.
So what do I think are the possible benefits of using StyleSheet over plain objects?
-
Despite claims to the contrary my testing on RN v0.59.10 indicates that you do get some validation when calling
StyleSheet.create()
and typescript (and probably flow) will also report errors at compile time. Even without compile time checking I think it's still beneficial to do run time validation of styles before they are used for rendering, particularly where components that use those styles could be conditionally rendered. This will allow such errors to be picked up without having to test all rendering scenarios. -
Given that StyleSheet is recommended by the RN team they may still have hopes of using StyleSheet to improve performance in future, and they may have other possible improvements in mind as well, for example:
-
The current
StyleSheet.create()
run-time validation is useful, but a bit limited. It seems to be restricted to the type checking that you would get with flow or typescript, so will pick up sayflex: "1"
orborderStyle: "rubbish"
, but notwidth: "rubbish"
as that could be a percentage string. It's possible that the RN team may improve such validation in future by checking things like percentage strings, or range limits, or you could wrapStyleSheet.create()
in your own function to do that more extensive validation. -
By using StyleSheet you are perhaps making it easier to transition to third party alternatives/extensions like react-native-extended-stylesheet that offer more.
Solution 5 - React Native
So, today, September of 2021, after reading all the answers and doing some researches, I created a summary about using Stylesheet
instead of a plain object.
- Based on React Documentation, you should use the stylesheet when the complexity starts to grow.
> The style prop can be a plain old JavaScript object. That's what we usually use for example code. > As a component grows in complexity, it is often cleaner to use StyleSheet.create to define several styles in one place.
- In the simulator, when using stylesheet will display an ERROR, and when using the plain object will display only a WARNING.
- Based on item 2, it looks like it has some validation while compiling. (A lot of people say that’s a myth)
- If you need to migrate for a third-party library in the future, for some of them like
react-native-extended-stylesheet
, if you are using stylesheet, it will be easier. - You have some methods and properties that boost the development. For example, the property
StyleSheet.absoluteFill
will doposition: 'absolute', left: 0, right: 0, top: 0, bottom: 0
, or the methodcompose()
will allow you to combine two styles, overriding it.
P.S.: The performance answer looks to be a myth.
My opinion?
Based on item 2 and 5, go to stylesheet instead of plain objects.
Solution 6 - React Native
I did not find any differences between StyleSheet
and plain object, except of typing validation in TypeScript.
For example, this (note the typing differences):
import { View, Text, Image, StyleSheet } from 'react-native';
import logo from './logo.svg';
export default class App extends Component {
render() {
return (
<View style={styles.someViewStyle}>
<Text style={styles.someTextStyle}>Text Here</Text>
<Image style={styles.someImageStyle} source={logo} />
</View>
);
}
}
const styles: StyleSheet.create({
someViewStyle: {
backgroundColor: '#FFF',
padding: 10,
},
someTextStyle: {
fontSize: 24,
fontWeight: '600',
},
someImageStyle: {
height: 50,
width: 100,
},
});
equals to this:
import { View, Text, Image, ViewStyle, TextStyle, ImageStyle } from 'react-native';
import logo from './logo.svg';
export default class App extends Component {
render() {
return (
<View style={styles.someViewStyle}>
<Text style={styles.someTextStyle}>Text Here</Text>
<Image style={styles.someImageStyle} source={logo} />
</View>
);
}
}
const styles: {
someViewStyle: ViewStyle;
someTextStyle: TextStyle;
someImageStyle: ImageStyle;
} = {
someViewStyle: {
backgroundColor: '#FFF',
padding: 10,
},
someTextStyle: {
fontSize: 24,
fontWeight: '600',
},
someImageStyle: {
height: 50,
width: 100,
},
};
Solution 7 - React Native
Creating your styles via StyleSheet.create
will pass though validation only when global variable __DEV__
is set to true (or while running inside Android or IOS emulators see React Native DEV and PROD variables)
The function source code is pretty simple:
create < +S: ____Styles_Internal > (obj: S): $ReadOnly < S > {
// TODO: This should return S as the return type. But first,
// we need to codemod all the callsites that are typing this
// return value as a number (even though it was opaque).
if (__DEV__) {
for (const key in obj) {
StyleSheetValidation.validateStyle(key, obj);
if (obj[key]) {
Object.freeze(obj[key]);
}
}
}
return obj;
}
I would recommend using it because it performs run-time validation during development, also it freezes the object.