插件详情v3.0.3

ruby_text

一个 RubyText 小部件，您可以轻松使用此库来实现振假名效果。

AndroidiOSWebmacOSWindowsLinux

pub.dev API 文档源代码

近 30 天下载: 626
喜欢数: 38
Pub 分数: 150

安装插件

flutter pub add ruby_text

插件介绍

基于插件公开信息、社区数据与项目使用情况整理的选型参考。

RubyText 是一个 Flutter 包，可实现类似振假名的文本注释，常用于日语排版中，在主文字上方或旁边显示发音指南。它提供了一个简单的 widget，可在较大基底文字附近叠加小文字（如平假名或片假名），从而提升语言学习者或双语内容的可读性。该包支持 Android、iOS、Web、macOS、Windows 和 Linux 多个平台，适用于跨平台应用开发。通过 `flutter pub add ruby_text` 进行极简配置，开发者即可轻松将这种排版效果集成到用户界面中。

适合场景

在语言应用中显示发音指南
通过音标注释增强教育内容
使用日文文本创建多语言用户界面
改善非母语读者的可访问性
在UI设计中添加装饰性文本效果

主要特点

Simple RubyText widget API
支持内联和堆叠的振假名布局
跨平台兼容性
与 Flutter 文本系统的轻松集成
可自定义的字体大小和位置

适合对象

教育类应用开发者
日语学习应用
多语言UI设计人员
专注于排版的 Flutter 项目
寻求简单文本注释效果的开发者

使用建议

限于振假名样式注释
可能需要手动调整对齐以适应复杂布局
最适合具有一致间距的垂直或水平文本
不适用于通用文本样式
性能影响微乎其微，但可能会影响密集文本块的渲染

原始 README

以下为关联源码仓库的 README 原文快照，最新内容请访问源码仓库。

RubyText

A ruby text widget with flutter.

Install

dependencies:
    ruby_text: <Latest version.>

Example

  RubyText(
    [
      RubyTextData(
        '検査',
        ruby: 'けんさ',
      ),
    ],
  );

Other

const RubyText(
  List<RubyTextData> data, {
  double spacing = 0.0,
  TextStyle? style,
  TextStyle? rubyStyle,
  TextAlign? textAlign,
  TextDirection? textDirection,
  bool? softWrap,
  TextOverflow? overflow,
  int? maxLines,
});

const RubyTextData(
  String text, {
  String? ruby, 
  TextStyle? style,
  TextStyle? rubyStyle,
  TextDirection? textDirection,
});

const RubySpanWidget(BuildContext context, RubyTextData data);