Merge branch 'test'

Author: wanwusangzhi

docs/widget/animate/animationcontroller/index.md

@@ -0,0 +1,30 @@
+## **AnimationController**
+
+>
+AnimationController是一个特殊的Animation对象
+* 默认情况下，AnimationController在给定的时间段内会线性的生成从0.0到1.0的数字
+* 创建一个AnimationController时需要传递一个vsync参数，存在vsync时会防止屏幕外动画（动画的UI不在当前屏幕时）消耗不必要的资源，通过将SingleTickerProviderStateMixin添加到类定义中
+* 实例化一个AnimationController不会启动它运行，可以通过 .forward()方法启动动画
+* AnimationController的addListener方法可以监听动画每一帧
+* AnimationController的addStatusListener方法可以监听动画的状态
+
+
+### 构造方法
+``` dart
+AnimationController({
+  double value,
+  this.duration,
+  this.debugLabel,
+  this.lowerBound = 0.0,
+  this.upperBound = 1.0,
+  this.animationBehavior = AnimationBehavior.normal,
+  @required TickerProvider vsync,
+})
+```
+
+### 属性介绍
+* value: 动画值
+* lowerBound: 动画最小值
+* upperBound: 动画最大值
+* duration: 动画持续时间
+* vsync: vsync对象会绑定动画的定时器到一个可视的widget，所以当widget不显示时，动画定时器将会暂停，当widget再次显示时，动画定时器重新恢复执行，这样就可以避免动画相关UI不在当前屏幕时消耗资源。 如果要使用自定义的State对象作为vsync时，请包含TickerProviderStateMixin，因为是当前Widget使用动画，所以一般绑定值为 this

docs/widget/common/text/index.md

@@ -1 +1,32 @@
-## ****
+## **Text**
+
+>
+单一样式的文本,文本可多行显示，也可能全部显示在同一行上
+* 默认会继承最接近控件的DefaultTextStyle
+* 最基本的文本组件
+
+### 构造方法
+
+``` dart
+Text(this.data, {
+  Key key,
+  this.style,
+  this.textAlign,
+  this.textDirection,
+  this.locale,
+  this.softWrap,
+  this.overflow,
+  this.textScaleFactor,
+  this.maxLines,
+  this.semanticsLabel,
+})
+```
+
+### 属性介绍
+* data: Text显示的文本，必选参数
+* style: 文本样式
+* textAlign: 文本对齐方式
+* textDirection: 文本显示方向
+* maxLines: 文本最多显示几行
+* overflow: 文本溢出显示的截断方式
+* textScaleFactor: 文本缩放比例

lib/components/widgetComp.dart

@@ -2,7 +2,7 @@ import 'package:flutter/material.dart';
 import 'package:efox_flutter/store/index.dart' show Store;
 import 'header.dart' as Header;
 import 'package:efox_flutter/components/markdownComp.dart' as MarkDownComp;
-import 'package:efox_flutter/lang/app_translations.dart' show AppTranslations;
+import 'package:efox_flutter/lang/index.dart' show AppLocalizations;
 import 'package:efox_flutter/components/baseComp.dart' as BaseComp;
 import 'package:efox_flutter/components/exampleComp.dart' as ExampleComp;
 import 'package:efox_flutter/utils/file.dart' as FileUtils;
@@ -184,7 +184,7 @@ class IndexState extends State<Index> {
                   Container(
                     padding: const EdgeInsets.fromLTRB(16.0, 16.0, 16.0, 0),
                     child: Text(
-                      AppTranslations.of(context).t('loading'),
+                      AppLocalizations.$t('loading'),
                       style: TextStyle(
                           color: Color(AppTheme.secondColor), fontSize: 20.0),
                     ),

lib/lang/Application.dart

@@ -0,0 +1,18 @@
+import 'package:flutter/material.dart';
+
+class ConfigLanguage {
+  static List<Locale> supportedLocales = [
+    Locale('zh', 'CH'),
+    Locale('en', 'US'),
+  ];
+
+  static Map<String, dynamic> sopportLanguage = {
+    "zh": {"code": "zh", "country_code": "CH"},
+    "en": {"code": "en", "country_code": "US"}
+  };
+
+  static dynamic defualtLanguage = {
+    "code": "zh",
+    "country_code": "CH"
+  };
+}

lib/lang/app_translations.dart

@@ -0,0 +1,115 @@
+import 'package:flutter/material.dart';
+import 'dart:async';
+import 'dart:convert';
+import 'package:efox_flutter/lang/config.dart' as I18NConfig;
+import 'package:flutter/services.dart' show rootBundle;
+
+class AppLocalizations {
+  Locale _locale; // language
+  static Function _setState; // setState
+  static AppLocalizationsDelegate _delegate;
+  static Map<String, dynamic> jsonLanguage;
+  static AppLocalizations _inst; // inst
+
+  AppLocalizations(this._locale);
+
+  // init localizations
+  static Future<AppLocalizations> init(Locale locale) async {
+    _inst = AppLocalizations(locale);
+    await getLanguageJson();
+    return _inst;
+  }
+
+  // 设置语言切换代理
+  static void setProxy(Function setState, AppLocalizationsDelegate delegate) async {
+    _setState = setState;
+    _delegate = delegate;
+  }
+
+  static get languageCode => _inst._locale.languageCode;
+
+  static void getLanguageJson([Locale locale]) async {
+    Locale _tmpLocale = _inst._locale;
+    print(_tmpLocale.languageCode);
+    String jsonLang;
+    try {
+      jsonLang = await rootBundle
+          .loadString('locale/${_tmpLocale.languageCode}.json');
+    } catch (e) {
+      _inst._locale = Locale(I18NConfig.ConfigLanguage.defualtLanguage.code);
+      jsonLang = await rootBundle
+          .loadString('locale/${I18NConfig.ConfigLanguage.defualtLanguage.code}.json');
+    }
+    json.decode(jsonLang);
+    jsonLanguage = json.decode(jsonLang);
+    print("当前语言： ${_inst._locale}");
+    print("Json数据： ${jsonLanguage}");
+  }
+
+  static void changeLanguage([Locale locale]) {
+    if (locale == null) {
+      locale = AppLocalizations.languageCode == 'zh'
+          ? Locale('en', "US")
+          : Locale("zh", "CH");
+    }
+    _inst._locale = locale;
+    getLanguageJson(); // 根据语言获取对应的国际化文件
+    _setState(() {
+      _delegate = AppLocalizationsDelegate(locale);
+    });
+  }
+
+  // get local language
+  _t(String key) {
+    var _array = key.split('.');
+    var _dict = jsonLanguage;
+    var retValue = '';
+    try {
+      _array.forEach((item) {
+        if (_dict[item].runtimeType == Null) {
+          retValue = key;
+          return;
+        }
+        if (_dict[item].runtimeType != String) {
+          _dict = _dict[item];
+        } else {
+          retValue = _dict[item];
+        }
+      });
+      retValue = retValue.isEmpty ? _dict : retValue;
+    } catch (e) {
+      print('i18n exception');
+      print(e);
+      retValue = key;
+    }
+//    print('key   ${key}                value: ${retValue}');
+    return retValue ?? '';
+  }
+
+  static String $t(String key) {
+    return _inst._t(key);
+  }
+}
+
+class AppLocalizationsDelegate extends LocalizationsDelegate<AppLocalizations> {
+  final Locale locale;
+
+  AppLocalizationsDelegate ([this.locale]);
+
+  @override
+  bool isSupported(Locale locale) {
+    return I18NConfig.ConfigLanguage.sopportLanguage.keys.toList().contains(locale.languageCode);
+  }
+
+  @override
+  Future<AppLocalizations> load(Locale _locale) async {
+    Locale _tmpLocale = locale ?? _locale;
+    return await AppLocalizations.init(_tmpLocale);
+  }
+
+  @override
+  bool shouldReload(LocalizationsDelegate<AppLocalizations> old) {
+    // false时 不执行上述重写函数
+    return false;
+  }
+}