diff --git a/docs/text.html b/docs/text.html index 582116a6cd8..d641be33d57 100644 --- a/docs/text.html +++ b/docs/text.html @@ -33,9 +33,9 @@ default, a gray oval highlights the text on press down.

={{color: 'red'}}> and red </Text> -</Text>

Behind the scenes, this is going to be converted to a flat NSAttributedString that contains the following information

"I am bold and red" +</Text>

Behind the scenes, this is going to be converted to a flat NSAttributedString that contains the following information

"I am bold and red" 0-9: bold -9-17: bold, red

Containers #

The <Text> element is special relative to layout, everything inside is no longer using the flexbox layout but using text layout. This means that elements inside of a <Text> are no longer rectangles but wrap when they see the end of the line.

<Text> +9-17: bold, red

Containers #

The <Text> element is special relative to layout: everything inside is no longer using the flexbox layout but using text layout. This means that elements inside of a <Text> are no longer rectangles, but wrap when they see the end of the line.

<Text> <Text>First part and </Text> <Text>second part</Text> </Text> @@ -51,12 +51,12 @@ default, a gray oval highlights the text on press down.

// |First part | // |and | -// |second part|

Limited Style Inheritance #

On the web, the usual way to set a font family and size for the entire document is to write

/* CSS, *not* React Native */ +// |second part|

Limited Style Inheritance #

On the web, the usual way to set a font family and size for the entire document is to write:

/* CSS, *not* React Native */ html { font-family: 'lucida grande', tahoma, verdana, arial, sans-serif; font-size: 11px; color: #141823; -}

When the browser is trying to render a text node, it's going to go all the way up to the root element of the tree and find an element with a font-size attribute. An unexpected property with this system is that any node can have font-size attribute, including a <div>. The reason why it was designed this way is that it is convenient, even though not really semantically correct.

In React Native, we are more strict about it. The first place where it'll show up is that you have to wrap all the text nodes inside of a <Text> component. It is not allowed to have a text node directly under a <View>.

// BAD: will fatal, can't have a text node as child of a <View> +}

When the browser is trying to render a text node, it's going to go all the way up to the root element of the tree and find an element with a font-size attribute. An unexpected property of this system is that any node can have font-size attribute, including a <div>. This was designed for convenience, even though not really semantically correct.

In React Native, we are more strict about it: you must wrap all the text nodes inside of a <Text> component; you cannot have a text node directly under a <View>.

// BAD: will fatal, can't have a text node as child of a <View> <View> Some text </View> @@ -66,7 +66,7 @@ html { <Text> Some text </Text> -</View>

You also lose the ability to setup a default font for an entire subtree. The recommended way to use consistent fonts and sizes across your application is to create a component MyAppText that's going to set them and use this component all across your app. You can also make other components such as MyAppHeaderText for other kind of texts.

<View> +</View>

You also lose the ability to set up a default font for an entire subtree. The recommended way to use consistent fonts and sizes across your application is to create a component MyAppText that includes them and use this component across your app. You can also use this component to make more specific components like MyAppHeaderText for other kinds of text.

<View> <MyAppText>Text styled with the default font for the entire application</MyAppText> <MyAppHeaderText>Text styled as a header</MyAppHeaderText> </View>

React Native still has the concept of style inheritance, but limited to text subtrees. In this case, the second part will be both bold and red.

<Text style={{fontWeight: 'bold'}}> @@ -74,7 +74,7 @@ html { <Text style={{color: 'red'}}> and red </Text> -</Text>

We believe that this more constrained way to style text will yield better apps.

Next →