文本

用于显示文本的响应组件,支持嵌套、样式和触发处理。在接下来的例子中,嵌套的标题和正文文本将从 styles.baseText 继承 FontFamily,但是标题会提供它自己其他的设计风格。标题和正文在文字换行时会堆叠在彼此之上。

  1. renderText: function() {
  2. return (
  3. <Text style={styles.baseText}>
  4. <Text style={styles.titleText} onPress={this.onPressTitle}>
  5. {this.state.titleText + '\n\n'}
  6. </Text>
  7. <Text numberOfLines={5}>
  8. {this.state.bodyText}
  9. </Text>
  10. </Text>
  11. );
  12. },
  13. ...
  14. var styles = StyleSheet.create({
  15. baseText: {
  16. fontFamily: 'Cochin',
  17. },
  18. titleText: {
  19. fontSize: 20,
  20. fontWeight: 'bold',
  21. },
  22. };

Props

Edit on GitHub

numberOfLines 数值型

用于在计算文本布局后将文本和省略符号进行截断,包括换行,这样总的行数就不会超过这个值。

onPress 函数

这个函数被称为按下。在默认高亮状态下,文本内部是支持按下动作处理的(该函数在 suppressHighlighting 是禁用的)。


style style

View#style…

color 字符串型

containerBackgroundColor 字符串型

fontFamily 字符串型

fontSize 数值型

fontStyle enum(‘normal’, ‘italic’)

fontWeight enum(“normal”, ‘bold’, ‘100’, ‘200’, ‘300’, ‘400’, ‘500’, ‘600’, ‘700’, ‘800’, ‘900’)

lineHeight 数值型

textAlign enum(“auto”, ‘left’, ‘right’, ‘center’)

writingDirection enum(“auto”, ‘ltr’, ‘rtl’)

suppressHighlighting 布尔型

值为真时,当文本被按下时没有视觉上的变化。默认情况下,按下之前是一个灰色椭圆高亮的文本。

testID 字符串型

在端到端测试时用于定位视图

描述

Edit on GitHub

嵌套文本

在 iOS 里,显示格式化文本的方式是使用 NSAttributedString :你可以为你想要显示和注释的文本划定一些特定的格式范围。实际上,这是非常无聊的。对于 React Native,我们决定使用 Web 模式,在这里我们可以利用嵌套文本来达到同样的效果。

  1. <Text style={{fontWeight: 'bold'}}>
  2. I am bold
  3. <Text style={{color: 'red'}}>
  4. and red
  5. </Text>
  6. </Text>

在幕后,这将会被转换成一个完全的包含以下信息的 NSAttributedString

  1. "I am bold and red"
  2. 0-9: bold
  3. 9-17: bold, red

容器

<Text> 元素是与布局设计有特定关系的:内部的一切都不再使用 flexbox 布局而是使用文本布局。这意味着一个 <Text> 内部的元素不在是矩形的,而是在结尾的时候被包装起来。

  1. <Text>
  2. <Text>First part and </Text>
  3. <Text>second part</Text>
  4. </Text>
  5. // Text container: all the text flows as if it was one
  6. // |First part |
  7. // |and second |
  8. // |part |
  9. <View>
  10. <Text>First part and </Text>
  11. <Text>second part</Text>
  12. </View>
  13. // View container: each text is its own block
  14. // |First part |
  15. // |and |
  16. // |second part|

有限制性的样式继承

在网络上,为整个文档设置字体体系和大小的常用方法是:

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

当浏览器想要显示一个文本节点时,它会一直走到树的根元素,并且找到一个有 font-size属性的元素。该系统一个意想不到的性质是任何节点都可以有font-size属性,包括一个 <div>。这是为了方便而设计的,尽管语义并不是正确的。

在 React Naitve 里,我们关于这一点会更严格:你必须将 <Text> 组件里的所有节点都进行包装;你不能在 <View>下直接拥有一个文本节点。

  1. // BAD: will fatal, can't have a text node as child of a <View>
  2. <View>
  3. Some text
  4. </View>
  5. // GOOD
  6. <View>
  7. <Text>
  8. Some text
  9. </Text>
  10. </View>

你也失去了对整个子树设置字体的能力。为了在你的应用程序里使用一致为字体和大小,推荐使用的方法是创建一个包括他们的 MyAppText 组件,并且在你的应用程序里使用这个组件。你可以使用该组件来构成更多特定的组件,比如用于其他类型文本的 MyAppHeaderText 组件。

  1. <View>
  2. <MyAppText>Text styled with the default font for the entire application</MyAppText>
  3. <MyAppHeaderText>Text styled as a header</MyAppHeaderText>
  4. </View>

React Native 还有继承风格的概念,但是仅限于文本子树。在这种情况下,第二部分将是粗体和红色。

  1. <Text style={{fontWeight: 'bold'}}>
  2. I am bold
  3. <Text style={{color: 'red'}}>
  4. and red
  5. </Text>
  6. </Text>

我们相信更多的文本约束方法将会产生更好的应用程序:

  • (开发人员)响应组件的设计源于大脑中孤立的想法:你应该有能力将你的组件放置在你应用程序的任何一个地方,相信只有工具是相同的,那么它的表现和行为都是相同的。文本属性是可以从工具外继承的,这会打破这种孤立。
  • (实现人员)React Native 实现也是很简单的。我们不需要对每一个单一的元素都要有一个 FontFamily 模块,并且我们在每一次显示一个文本节点时也不需要对树遍历到根节点。风格的继承只需要在原生文本内部进行编码,不需要泄露给其他文本或者是系统本身。

例子

Edit on GitHub

  1. 'use strict';
  2. var React = require('react-native');
  3. var {
  4. StyleSheet,
  5. Text,
  6. View,
  7. } = React;
  8. var Entity = React.createClass({
  9. render: function() {
  10. return (
  11. <Text style={styles.entity}>
  12. {this.props.children}
  13. </Text>
  14. );
  15. }
  16. });
  17. var AttributeToggler = React.createClass({
  18. getInitialState: function() {
  19. return {fontWeight: '500', fontSize: 15};
  20. },
  21. increaseSize: function() {
  22. this.setState({
  23. fontSize: this.state.fontSize + 1
  24. });
  25. },
  26. render: function() {
  27. var curStyle = {fontSize: this.state.fontSize};
  28. return (
  29. <Text>
  30. <Text style={curStyle}>
  31. Tap the controls below to change attributes.
  32. </Text>
  33. <Text>
  34. See how it will even work on{' '}
  35. <Text style={curStyle}>
  36. this nested text
  37. </Text>
  38. <Text onPress={this.increaseSize}>
  39. {'>> Increase Size <<'}
  40. </Text>
  41. </Text>
  42. </Text>
  43. );
  44. }
  45. });
  46. exports.title = '<Text>';
  47. exports.description = 'Base component for rendering styled text.';
  48. exports.displayName = 'TextExample';
  49. exports.examples = [
  50. {
  51. title: 'Wrap',
  52. render: function() {
  53. return (
  54. <Text>
  55. The text should wrap if it goes on multiple lines. See, this is going to
  56. the next line.
  57. </Text>
  58. );
  59. },
  60. }, {
  61. title: 'Padding',
  62. render: function() {
  63. return (
  64. <Text style={{padding: 10}}>
  65. This text is indented by 10px padding on all sides.
  66. </Text>
  67. );
  68. },
  69. }, {
  70. title: 'Font Family',
  71. render: function() {
  72. return (
  73. <View>
  74. <Text style={{fontFamily: 'Cochin'}}>
  75. Cochin
  76. </Text>
  77. <Text style={{fontFamily: 'Cochin', fontWeight: 'bold'}}>
  78. Cochin bold
  79. </Text>
  80. <Text style={{fontFamily: 'Helvetica'}}>
  81. Helvetica
  82. </Text>
  83. <Text style={{fontFamily: 'Helvetica', fontWeight: 'bold'}}>
  84. Helvetica bold
  85. </Text>
  86. <Text style={{fontFamily: 'Verdana'}}>
  87. Verdana
  88. </Text>
  89. <Text style={{fontFamily: 'Verdana', fontWeight: 'bold'}}>
  90. Verdana bold
  91. </Text>
  92. </View>
  93. );
  94. },
  95. }, {
  96. title: 'Font Size',
  97. render: function() {
  98. return (
  99. <View>
  100. <Text style={{fontSize: 23}}>
  101. Size 23
  102. </Text>
  103. <Text style={{fontSize: 8}}>
  104. Size 8
  105. </Text>
  106. </View>
  107. );
  108. },
  109. }, {
  110. title: 'Color',
  111. render: function() {
  112. return (
  113. <View>
  114. <Text style={{color: 'red'}}>
  115. Red color
  116. </Text>
  117. <Text style={{color: 'blue'}}>
  118. Blue color
  119. </Text>
  120. </View>
  121. );
  122. },
  123. }, {
  124. title: 'Font Weight',
  125. render: function() {
  126. return (
  127. <View>
  128. <Text style={{fontWeight: '100'}}>
  129. Move fast and be ultralight
  130. </Text>
  131. <Text style={{fontWeight: '200'}}>
  132. Move fast and be light
  133. </Text>
  134. <Text style={{fontWeight: 'normal'}}>
  135. Move fast and be normal
  136. </Text>
  137. <Text style={{fontWeight: 'bold'}}>
  138. Move fast and be bold
  139. </Text>
  140. <Text style={{fontWeight: '900'}}>
  141. Move fast and be ultrabold
  142. </Text>
  143. </View>
  144. );
  145. },
  146. }, {
  147. title: 'Font Style',
  148. render: function() {
  149. return (
  150. <View>
  151. <Text style={{fontStyle: 'normal'}}>
  152. Normal text
  153. </Text>
  154. <Text style={{fontStyle: 'italic'}}>
  155. Italic text
  156. </Text>
  157. </View>
  158. );
  159. },
  160. }, {
  161. title: 'Nested',
  162. description: 'Nested text components will inherit the styles of their ' +
  163. 'parents (only backgroundColor is inherited from non-Text parents). ' +
  164. '<Text> only supports other <Text> and raw text (strings) as children.',
  165. render: function() {
  166. return (
  167. <View>
  168. <Text>
  169. (Normal text,
  170. <Text style={{fontWeight: 'bold'}}>
  171. (and bold
  172. <Text style={{fontSize: 11, color: '#527fe4'}}>
  173. (and tiny inherited bold blue)
  174. </Text>
  175. )
  176. </Text>
  177. )
  178. </Text>
  179. <Text style={{fontSize: 12}}>
  180. <Entity>Entity Name</Entity>
  181. </Text>
  182. </View>
  183. );
  184. },
  185. }, {
  186. title: 'Text Align',
  187. render: function() {
  188. return (
  189. <View>
  190. <Text style={{textAlign: 'left'}}>
  191. left left left left left left left left left left left left left left left
  192. </Text>
  193. <Text style={{textAlign: 'center'}}>
  194. center center center center center center center center center center center
  195. </Text>
  196. <Text style={{textAlign: 'right'}}>
  197. right right right right right right right right right right right right right
  198. </Text>
  199. </View>
  200. );
  201. },
  202. }, {
  203. title: 'Spaces',
  204. render: function() {
  205. return (
  206. <Text>
  207. A {'generated'} {' '} {'string'} and some &nbsp;&nbsp;&nbsp; spaces
  208. </Text>
  209. );
  210. },
  211. }, {
  212. title: 'Line Height',
  213. render: function() {
  214. return (
  215. <Text>
  216. <Text style={{lineHeight: 35}}>
  217. A lot of space between the lines of this long passage that should
  218. wrap once.
  219. </Text>
  220. </Text>
  221. );
  222. },
  223. }, {
  224. title: 'Empty Text',
  225. description: 'It\'s ok to have Text with zero or null children.',
  226. render: function() {
  227. return (
  228. <Text />
  229. );
  230. },
  231. }, {
  232. title: 'Toggling Attributes',
  233. render: function(): ReactElement {
  234. return <AttributeToggler />;
  235. },
  236. }, {
  237. title: 'backgroundColor attribute',
  238. description: 'backgroundColor is inherited from all types of views.',
  239. render: function() {
  240. return (
  241. <View style={{backgroundColor: 'yellow'}}>
  242. <Text>
  243. Yellow background inherited from View parent,
  244. <Text style={{backgroundColor: '#ffaaaa'}}>
  245. {' '}red background,
  246. <Text style={{backgroundColor: '#aaaaff'}}>
  247. {' '}blue background,
  248. <Text>
  249. {' '}inherited blue background,
  250. <Text style={{backgroundColor: '#aaffaa'}}>
  251. {' '}nested green background.
  252. </Text>
  253. </Text>
  254. </Text>
  255. </Text>
  256. </Text>
  257. </View>
  258. );
  259. },
  260. }, {
  261. title: 'containerBackgroundColor attribute',
  262. render: function() {
  263. return (
  264. <View>
  265. <View style={{flexDirection: 'row', height: 85}}>
  266. <View style={{backgroundColor: '#ffaaaa', width: 150}} />
  267. <View style={{backgroundColor: '#aaaaff', width: 150}} />
  268. </View>
  269. <Text style={[styles.backgroundColorText, {top: -80}]}>
  270. Default containerBackgroundColor (inherited) + backgroundColor wash
  271. </Text>
  272. <Text style={[
  273. styles.backgroundColorText,
  274. {top: -70, containerBackgroundColor: 'transparent'}]}>
  275. {"containerBackgroundColor: 'transparent' + backgroundColor wash"}
  276. </Text>
  277. </View>
  278. );
  279. },
  280. }, {
  281. title: 'numberOfLines attribute',
  282. render: function() {
  283. return (
  284. <View>
  285. <Text numberOfLines={1}>
  286. Maximum of one line no matter now much I write here. If I keep writing it{"'"}ll just truncate after one line
  287. </Text>
  288. <Text numberOfLines={2} style={{marginTop: 20}}>
  289. Maximum of two lines no matter now much I write here. If I keep writing it{"'"}ll just truncate after two lines
  290. </Text>
  291. <Text style={{marginTop: 20}}>
  292. No maximum lines specified no matter now much I write here. If I keep writing it{"'"}ll just keep going and going
  293. </Text>
  294. </View>
  295. );
  296. },
  297. }];
  298. var styles = StyleSheet.create({
  299. backgroundColorText: {
  300. left: 5,
  301. backgroundColor: 'rgba(100, 100, 100, 0.3)'
  302. },
  303. entity: {
  304. fontWeight: '500',
  305. color: '#527fe4',
  306. },
  307. });