Flutter文本表达式处理插件text_expressions的使用

Flutter文本表达式处理插件text_expressions的使用

目录

• 语法
• 案例操作

语法

参数

参数可以通过{}引入，标记为参数模板。参数模板可以包含命名参数（通过名称引用）或位置参数（通过索引引用）。

示例

Your name is {name} and your age is {age}.

The three chosen members are {0}, {1} and {2}.

表达式

表达式类似于switch语句。一个参数传递给表达式并检查是否与定义的案例匹配。如果参数与一个案例匹配，则返回该案例的结果。

表达式可以嵌套，且几乎不限制案例的数量。然而，为了保持可读性，最好保持表达式小而易于理解。

[{parameter} ~ case1:result1/case2:result2/(...)]

[]

引入一个表达式

~

将参数与案例分隔开

:

将案例结果与其自身分隔开

/

分隔案例及其结果

示例

[{age} ~ Lesser(18):You are underage!/Default:You are free to drink.]

[{temperature} ~ Lesser(15):Too cold./Lesser(30):Temperate./Default:It's too hot!]

案例操作

解析器支持多种比较操作，这些操作可用于将参数与案例匹配。

字符串专用操作：

• StartsWith
• EndsWith
• Contains

中立操作：

• Equals *
• In
• NotIn
• InRange
• NotInRange

数字专用操作：

• Greater
• GreaterOrEqual
• Lesser
• LesserOrEqual

其他：

• Default

• 如果未定义操作，则默认为’Equals’

完整示例

以下是一个完整的示例，展示了如何使用text_expressions插件来动态翻译文本。

import 'package:flutter/material.dart';
import 'package:text_expressions/text_expressions.dart';

// 定义翻译类
class Translation {
  final TextExpressions textExpressions;

  Translation()
      : textExpressions = TextExpressions(
          {
            'ageCheck': r'{age} ~ Lesser(18):You are underage!/Default:You are free to drink.',
            'userGreeting': r'{number} ~ Lesser(5):Hello, welcome!/{number} ~ Greater(5):Hi, nice to see you!',
          },
        );

  void load(String language) {
    // 加载不同的语言文件
    if (language == 'polish') {
      textExpressions.setTranslations({
        'ageCheck': r'{age} ~ Lesser(18):Jesteś za młody!/Default:Dorosły jesteś!',
        'userGreeting': r'{number} ~ Lesser(5):Cześć, witamy!/{number} ~ Greater(5):Hej, miło Cię widzieć!',
      });
    } else if (language == 'romanian') {
      textExpressions.setTranslations({
        'ageCheck': r'{age} ~ Lesser(18):Ești prea tânăr!/Default:Ești major!',
        'userGreeting': r'{number} ~ Lesser(5):Bună, bine ați venit!/{number} ~ Greater(5):Salut, fericit să vă văd!',
      });
    } else {
      // 默认英语
      textExpressions.setTranslations({
        'ageCheck': r'{age} ~ Lesser(18):You are underage!/Default:You are free to drink.',
        'userGreeting': r'{number} ~ Lesser(5):Hello, welcome!/{number} ~ Greater(5):Hi, nice to see you!',
      });
    }
  }

  String translate(String key, {Map<String, dynamic>? named}) {
    return textExpressions.evaluate(key, named: named);
  }
}

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: Text('Text Expressions Example')),
        body: Padding(
          padding: EdgeInsets.all(16),
          child: Column(
            children: [
              Text(Translation().translate('ageCheck', named: {'age': 10})),
              Text(Translation().translate('ageCheck', named: {'age': 17})),
              Text(Translation().translate('ageCheck', named: {'age': 68})),
              Text(Translation().translate('ageCheck', named: {'age': 40})),
              Text(Translation().translate('userGreeting', named: {'number': 1})),
              Text(Translation().translate('userGreeting', named: {'number': 4})),
              Text(Translation().translate('userGreeting', named: {'number': 11})),
              Text(Translation().translate('userGreeting', named: {'number': 23})),
            ],
          ),
        ),
      ),
    );
  }
}