文本

用于显示样式化文本内容的组件。

Android

iOS

Web

Included in Expo Go

GitHub

npm

更新日志

Recommended version:

~57.0.18

用于显示文本的组件。默认会适配平台配色方案（浅色/深色），并通过 textStyle 提供一组聚焦的排版配置项。

安装

Terminal

- npx expo install @expo/ui

- yarn expo install @expo/ui

- pnpm expo install @expo/ui

- bun expo install @expo/ui

If you are installing this in an existing React Native app, make sure to install expo in your project.

用法

基本文本

TextExample.tsx

import { useColorScheme } from 'react-native';
import { Host, Text } from '@expo/ui';

export default function TextExample() {
  const colorScheme = useColorScheme();

  return (
    <Host matchContents>
      <Text textStyle={{ color: colorScheme === 'dark' ? '#FFFFFF' : '#000000' }}>
        Hello, world!
      </Text>
    </Host>
  );
}

样式化文本

对排版相关属性（字体大小、字重、对齐方式）使用 textStyle。

StyledTextExample.tsx

import { useColorScheme } from 'react-native';
import { Host, Text } from '@expo/ui';

export default function StyledTextExample() {
  const colorScheme = useColorScheme();

  return (
    <Host matchContents>
      <Text
        textStyle={{
          color: colorScheme === 'dark' ? '#FFFFFF' : '#000000',
          fontSize: 24,
          fontWeight: '700',
          textAlign: 'center',
        }}>
        Headline
      </Text>
    </Host>
  );
}

截断长文本

使用 numberOfLines 来限制长文本，并在末尾显示省略号。

TruncatedTextExample.tsx

import { useColorScheme } from 'react-native';
import { Host, Text } from '@expo/ui';

export default function TruncatedTextExample() {
  const colorScheme = useColorScheme();

  return (
    <Host matchContents={{ vertical: true }} style={{ width: '100%' }}>
      <Text numberOfLines={1} textStyle={{ color: colorScheme === 'dark' ? '#FFFFFF' : '#000000' }}>
        A very long line of text that will be truncated when it does not fit on a single line.
      </Text>
    </Host>
  );
}

API

import { Text } from '@expo/ui';

Component

`Text`

Android

iOS

Web

Type: React.Element<TextProps>

A component for displaying styled text content.

Props for the Text component.

TextProps

`children`

Android

iOS

Web

Optional • Type: string

The text content to display.

`disabled`

Android

iOS

Web

Optional • Type: boolean

Whether the component is disabled. Disabled components do not respond to user interaction.

`hidden`

Android

iOS

Web

Optional • Type: boolean

Whether the component is hidden.

Android

iOS

Web

Optional • Type:

Pick<ViewStyle, 'padding' | 'paddingHorizontal' | 'paddingVertical' | 'paddingTop' | 'paddingBottom' | 'paddingLeft' | 'paddingRight' | 'backgroundColor' | 'borderRadius' | 'borderWidth' | 'borderColor' | 'opacity' | 'width' | 'height'>

Platform-agnostic style properties. These are translated to SwiftUI modifiers on iOS and Jetpack Compose modifiers on Android.

`testID`

Android

iOS

Web

Optional • Type: string

Identifier used to locate the component in end-to-end tests.

`textStyle`

Android

iOS

Web

Optional • Type:

{
  color: string, 
  fontFamily: string, 
  fontSize: number, 
  fontWeight: 'normal' | 'bold' | '100' | '200' | '300' | '400' | '500' | '600' | '700' | '800' | '900', 
  letterSpacing: number, 
  lineHeight: number, 
  textAlign: 'center' | 'left' | 'right'
}

Text-specific styling (font, color, alignment).