bevy 0.16 Text 组件 文档

Bevy 引擎中的 Text 组件

结构体定义

这是 Bevy 引擎的顶级 UI 文本组件。当给实体添加 Text 组件时，会自动配置 UI 文本节点所需的其他组件。

核心特性

• 文本内容：内部包装一个 String，表示文本内容
• 样式控制：通过组合其他组件（如 TextFont, TextColor, TextLayout）控制字体、颜色、对齐等样式
• 自动布局：Transform 组件由 UI 布局系统自动管理

// 基本创建
world.spawn(Text::new("你好世界！"));

// 带自定义样式
world.spawn((
    Text::new("自定义样式"),
    TextFont {
        font: font_handle.clone().into(),
        font_size: 60.0,
        ..Default::default()
    },
    TextColor(Color::BLUE),
));

// 文本对齐
world.spawn((
    Text::new("居中文本\n第二行"),
    TextLayout::new_with_justify(JustifyText::Center)
));

// 分段文本
world.spawn(Text::new("前缀 ")).with_children(|parent| {
    parent.spawn(TextSpan::new("分段1"));
    parent.spawn((TextSpan::new("分段2"), TextColor(Color::RED)));
});