diff --git a/README.md b/README.md index adf6dbcf..37b81b60 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,6 @@ ## Flutter 菜鸟手册 -> 帮助开发者快速上手 Flutter +> 帮助开发者快速上手 Flutter **内部测试中,1.0 正式版将于 2月 20日 发布。** ### 背景 @@ -29,9 +29,41 @@ flutter优点主要包括: -### 团队 +### Core Team -power by [阿里拍卖前端团队](https://github.com/alibaba-paimai-frontend) + + + + + + + + + + +
+ +
+ @minghe +
+ +
+ @ryan730 +
+ +
+ @Nealyang +
+ +
+ @hanxu317317 +
+ +
+ @DeckeDeng +
+ +Powered by [阿里拍卖前端团队](https://github.com/alibaba-paimai-frontend) diff --git a/api.md b/api.md index cc705c8e..e2c3506d 100644 --- a/api.md +++ b/api.md @@ -39,7 +39,7 @@ Animate< T > 一个通过输入动画来生成类型为T的值的对象。[...] AnimatedAlign -Align的 动画版本,只要给定的对齐发生变化,就会在给定的持续时间内自动转换孩子的位置。[...] +Align的 动画版本,只要给定的对齐发生变化,就会在给定的持续时间内自动转换child的位置。[...] AnimatedBuilder 用于构建动画的通用widget。[...] @@ -64,7 +64,7 @@ AnimatedModalBarrier 一个widget,可以防止用户与自身后面的widget交互,并且可以使用动画颜色值进行配置。[...] AnimatedOpacity -不透明度的 动画版本,只要给定的不透明度发生变化,就会自动转换孩子在给定持续时间内的不透明度。[...] +不透明度的 动画版本,只要给定的不透明度发生变化,就会自动转换child在给定持续时间内的不透明度。[...] AnimatedPadding Padding的 动画版本,无论何时给定的插入更改,它都会在给定的持续时间内自动转换缩进。[...] @@ -73,10 +73,10 @@ AnimatedPhysicalModel PhysicalModel的 动画版本。[...] AnimatedPositioned -定位的 动画版本,可在给定位置发生变化时自动转换孩子在给定持续时间内的位置。[...] +定位的 动画版本,可在给定位置发生变化时自动转换child在给定持续时间内的位置。[...] AnimatedPositionedDirectional -PositionedDirectional的 动画版本,可在给定位置发生变化时自动转换孩子在给定持续时间内的位置。[...] +PositionedDirectional的 动画版本,可在给定位置发生变化时自动转换child在给定持续时间内的位置。[...] AnimatedSize 动画窗口widget,只要给定子项的大小发生更改,就会在给定的持续时间内自动转换其大小。 @@ -153,7 +153,7 @@ BallisticScrollActivity BannerPainter 画横幅。 底线 -根据孩子的基线定位孩子的widget。[...] +根据child的基线定位child的widget。[...] BeveledRectangleBorder 带有扁平或“斜角”角的矩形边框。[...] @@ -225,7 +225,7 @@ BuildOwner 用于记录图形操作的界面。[...] 中央 -一个小孩,它将孩子置于其中心。[...] +一个小孩,它将child置于其中心。[...] ChangeNotifier 可以扩展或混合的类,使用VoidCallback为通知提供更改通知API 。[...] @@ -639,7 +639,7 @@ IntTween 两个整数之间的插值。[...] 活着 -标记一个孩子需要保持活着,即使它在一个懒惰的列表中,否则将删除它。[...] +标记一个child需要保持活着,即使它在一个懒惰的列表中,否则将删除它。[...] KeepAliveHandle 甲收听其可以手动触发。[...] @@ -693,7 +693,7 @@ ListBody 可线性排列的widget可滚动列表。[...] ListWheelScrollView -一个盒子,可以滚动轮子上的孩子。[...] +一个盒子,可以滚动轮子上的child。[...] ListWheelViewport 显示轮子上的子集子集的视口。[...] @@ -718,7 +718,7 @@ LocalKey 不是GlobalKey的关键[...] LongPressDraggable < T > -从长按开始使其孩子可以拖拽。 +从长按开始使其child可以拖拽。 MaskFilter 一个蒙版过滤器,用于在绘制时应用于形状。掩码过滤器是一种采用彩色像素位图的函数,并返回另一个彩色像素位图。[...] @@ -805,7 +805,7 @@ ObjectKey 抵消 不可变的2D浮点偏移量。[...] 台下 -一个widget,它将孩子放在树中,但没有绘制任何东西,没有让孩子可用于命中测试,也没有占用父母的任何空间。[...] +一个widget,它将child放在树中,但没有绘制任何东西,没有让child可用于命中测试,也没有占用父母的任何空间。[...] OneFrameImageStreamCompleter 管理dart:ui.Image对象的加载,用于静态ImageStream(只有一帧)。 @@ -922,7 +922,7 @@ PositionedDirectional 一个widget,用于控制堆栈子项的位置,而不需要提交特定的TextDirection。[...] PositionedTransition -定位的 动画版本,它采用特定的 动画在动画的生命周期内将孩子的位置从起始位置转换到结束位置。[...] +定位的 动画版本,它采用特定的 动画在动画的生命周期内将child的位置从起始位置转换到结束位置。[...] PREFERREDSIZE 具有首选大小的widget。[...] @@ -1127,7 +1127,7 @@ Scrollable widget已更改其滚动位置的 通知。[...] 一个widget,用widget含义的描述来注释widget树。[...] SemanticsDebugger -一个可视化孩子语义的widget。[...] +一个可视化child语义的widget。[...] 着色器 Gradient和ImageShader 等对象的基类,它们对应于Paint.shader使用的着色器。 @@ -1178,7 +1178,7 @@ SizedOverflowBox 一个特定大小的窗口widget,但将其原始约束传递给其子节点,然后可能会溢出。[...] SizeTransition -动画自己的大小和剪辑并对齐孩子。[...] +动画自己的大小和剪辑并对齐child。[...] SizeTween 两种尺寸之间的插值。[...] @@ -1651,7 +1651,7 @@ FilterQuality 图像过滤器的质量级别。[...] FLEXFIT -如何将孩子铭刻在可用空间内。[...] +如何将child铭刻在可用空间内。[...] FlutterLogoStyle 绘制Flutter徽标的可能方法。 @@ -1678,7 +1678,7 @@ MainAxisSize 无论是纵向还是横向。 溢出 -是否应该剪掉溢出的孩子,或者看到他们的溢出。 +是否应该剪掉溢出的child,或者看到他们的溢出。 PaintingStyle 在画布上绘制形状和路径的策略。[...] @@ -1926,7 +1926,7 @@ TextSelectionOverlayChanged(TextEditingValue value, Rect caretRect) →voi 签名报告变更的筛选组件 TextEditingValue为的目的TextSelectionOverlay。该 caretRect参数给出插入符在的坐标空间中的位置RenderBox由给定的TextSelectionOverlay.renderObject。[...] TransitionBuilder(BuildContext context, Widget child) → Widget -给孩子建立widget的构建器。[...] +给child建立widget的构建器。[...] TweenConstructor < T > (T targetValue) → Tween < T > 签名Tween工厂。[...] diff --git a/lib/common/provider.dart b/lib/common/provider.dart index a7fb6702..b0c4c3c4 100644 --- a/lib/common/provider.dart +++ b/lib/common/provider.dart @@ -18,7 +18,7 @@ class Provider { } catch (e) { print("Error $e"); } - if (db == null && isCreate) { + if (isCreate) { ByteData data = await rootBundle.load(join("assets", "app.db")); List bytes = data.buffer.asUint8List(data.offsetInBytes, data.lengthInBytes); diff --git a/lib/widgets/components/Card/Card/demo.dart b/lib/widgets/components/Card/Card/demo.dart index 6d0f24ab..7d4b4b3c 100644 --- a/lib/widgets/components/Card/Card/demo.dart +++ b/lib/widgets/components/Card/Card/demo.dart @@ -51,7 +51,7 @@ class CardLessDefault extends StatelessWidget { elevation:20.0, // 卡片的z坐标,控制卡片下面的阴影大小 margin:EdgeInsets.all(20.0), // margin: EdgeInsetsDirectional.only(bottom: 30.0, top: 30.0, start: 30.0),// 边距 - semanticContainer:true, // 表示单个语义容器,还是false表示单个语义节点的集合,接受单个孩子,但该孩子可以是Row,Column或其他包含子级列表的widget + semanticContainer:true, // 表示单个语义容器,还是false表示单个语义节点的集合,接受单个child,但该child可以是Row,Column或其他包含子级列表的widget // shape:new Border.all( // color: Colors.indigo, width: 1.0, style: BorderStyle.solid), // 卡片材质的形状,以及边框 shape:RoundedRectangleBorder(borderRadius: new BorderRadius.circular(20.0)), // 圆角 diff --git a/lib/widgets/elements/Frame/Align/Align/index.dart b/lib/widgets/elements/Frame/Align/Align/index.dart index 4649a88d..7531bb23 100644 --- a/lib/widgets/elements/Frame/Align/Align/index.dart +++ b/lib/widgets/elements/Frame/Align/Align/index.dart @@ -16,11 +16,11 @@ const String _flatText0 = """ const String _flatText1 = """ > widthFactor / heightFactor → double -- 如果widthFactor / heightFactor 为空,并且外部无任何约束,孩子控件大小默认,那么这个控件将根据自身尺寸最大化 +- 如果widthFactor / heightFactor 为空,并且外部无任何约束,child控件大小默认,那么这个控件将根据自身尺寸最大化 -- 如果widthFactor / heightFactor 不为空,并且外部无约束,align将匹配对应的孩子尺寸 -- ex:widthFactor/ heightFactor 为2.0;那么widget的宽高为孩子宽高的两倍 -- 如果widthFactor / heightFactor 为空,并且外部无约束,孩子控件设置自身大小 +- 如果widthFactor / heightFactor 不为空,并且外部无约束,align将匹配对应的child尺寸 +- ex:widthFactor/ heightFactor 为2.0;那么widget的宽高为child宽高的两倍 +- 如果widthFactor / heightFactor 为空,并且外部无约束,child控件设置自身大小 - Alignment部分标签失效 """; diff --git a/lib/widgets/elements/Frame/Box/OverflowBox/index.dart b/lib/widgets/elements/Frame/Box/OverflowBox/index.dart index 9f66cf39..a2458df9 100644 --- a/lib/widgets/elements/Frame/Box/OverflowBox/index.dart +++ b/lib/widgets/elements/Frame/Box/OverflowBox/index.dart @@ -19,7 +19,7 @@ const String Text1 = """ > OverflowBox设置最大/最小尺寸 - SizedOverflowBox,一个特定大小的小部件,但将其原始约束传递给它的子节点,然后可能会溢出。 - ConstrainedBox,一个对其子项施加额外约束的小部件。 -- UnconstrainedBox,一个试图让它的孩子在没有约束的情况下绘制的容器。 +- UnconstrainedBox,一个试图让它的child在没有约束的情况下绘制的容器。 - SizedBox,一个具有指定大小的盒子。 """; diff --git a/lib/widgets/elements/Frame/Layout/Column/demo.dart b/lib/widgets/elements/Frame/Layout/Column/demo.dart index 6237fc3b..246e314c 100644 --- a/lib/widgets/elements/Frame/Layout/Column/demo.dart +++ b/lib/widgets/elements/Frame/Layout/Column/demo.dart @@ -28,7 +28,7 @@ class ColumnDefault extends StatelessWidget { /** * > mainAxisSize 属性 - 一行的高度是有mainAxisSize属性控制,默认是max - - mainAxisSize: MainAxisSize.min,一行的宽度是孩子传入的约束 + - mainAxisSize: MainAxisSize.min,一行的宽度是child传入的约束 - mainAxisSize: MainAxisSize.max,一行的宽度的最大宽度是传入的约束。 > mainAxisAlignment属性 */ diff --git a/lib/widgets/elements/Frame/Layout/Column/index.dart b/lib/widgets/elements/Frame/Layout/Column/index.dart index 3a852edc..bd190513 100644 --- a/lib/widgets/elements/Frame/Layout/Column/index.dart +++ b/lib/widgets/elements/Frame/Layout/Column/index.dart @@ -3,8 +3,8 @@ import '../../../../../common/widget_demo.dart'; import './demo.dart'; const String Text0 = """### **简介** -> Column 是一个将其孩子显示在竖直方向数组的widget,于Row相对 -- 将其孩子填充可用的竖直水平空间,默认竖直空间无法滚动,如有很多children,竖直空间饱和无法放置,你可以使用listView搭配使用 +> Column 是一个将其child显示在竖直方向数组的widget,于Row相对 +- 将其child填充可用的竖直水平空间,默认竖直空间无法滚动,如有很多children,竖直空间饱和无法放置,你可以使用listView搭配使用 - 如果你只有一个child,只需要使用对齐(Align)或者居中(Center)来展示child """; diff --git a/lib/widgets/elements/Frame/Layout/Container/index.dart b/lib/widgets/elements/Frame/Layout/Container/index.dart index d16c3a28..60b48dc6 100644 --- a/lib/widgets/elements/Frame/Layout/Container/index.dart +++ b/lib/widgets/elements/Frame/Layout/Container/index.dart @@ -6,7 +6,7 @@ const String Text0 = """### **简介** > 一个常用的widget,它结合了常见的绘画,定位和大小调整 - 该容器首先让child填充绘制,然后再将其他的约束应用于填充范围。 - 在绘画过程中,容器先应用给定的转换,在绘制装饰以填充的范围,然后绘制child,最后绘制前景,同时填充需要填充的范围 -- 没有孩子的容器试图尽可能的大,除非传入的约束是无限制的。child的大小会被width,height等约束覆盖。 +- 没有child的容器试图尽可能的大,除非传入的约束是无限制的。child的大小会被width,height等约束覆盖。 """; const String Text1 = """ diff --git a/lib/widgets/elements/Frame/Layout/Row/index.dart b/lib/widgets/elements/Frame/Layout/Row/index.dart index 9ee00e64..119aa3de 100644 --- a/lib/widgets/elements/Frame/Layout/Row/index.dart +++ b/lib/widgets/elements/Frame/Layout/Row/index.dart @@ -3,9 +3,9 @@ import '../../../../../common/widget_demo.dart'; import './demo.dart'; const String Text0 = """### **简介** -> Row 是一个将其孩子显示在水平数组的小部件 -- 将其孩子填充可用的横向水平空间,一行高度是孩子们的最大高度(即:总是满足传入的垂直约束) -- 如果你只有一个孩子,只需要考虑使用对其或者中间位置,如果多个孩子,注意扩展水平空间(Expanded),可以将孩子封装在一个扩展部件里面 +> Row 是一个将其child显示在水平数组的小部件 +- 将其child填充可用的横向水平空间,一行高度是childs的最大高度(即:总是满足传入的垂直约束) +- 如果你只有一个child,只需要考虑使用对其或者中间位置,如果多个child,注意扩展水平空间(Expanded),可以将child封装在一个扩展部件里面 - 当我们看到行有黄色和黑色条纹警告时候,说明行已经溢出,当行溢出,行之间当空间将没有任何空间可供扩展。 """; diff --git a/lib/widgets/elements/Frame/Stack/IndexedStack/index.dart b/lib/widgets/elements/Frame/Stack/IndexedStack/index.dart index 023a9677..6215777b 100644 --- a/lib/widgets/elements/Frame/Stack/IndexedStack/index.dart +++ b/lib/widgets/elements/Frame/Stack/IndexedStack/index.dart @@ -10,7 +10,7 @@ const String _stackText0 = """### **简介** """; const String _stackText1 = """### **基本用法** > index → int -- 控制显示孩子的索引 +- 控制显示child的索引 - ex:可以通过多个图片转化表示状态(正确,错误,警告等)。 """; diff --git a/lib/widgets/elements/Frame/Stack/Stack/index.dart b/lib/widgets/elements/Frame/Stack/Stack/index.dart index 29ee03f3..165c523f 100644 --- a/lib/widgets/elements/Frame/Stack/Stack/index.dart +++ b/lib/widgets/elements/Frame/Stack/Stack/index.dart @@ -5,7 +5,7 @@ import './demo.dart'; const String _stackText0 = """### **简介** > 用于将多个子级相对于其框的边缘定位,多用于以简单方式重叠children -- 当第一个孩子置于底部时,堆栈按顺序绘制其子项。如果更改子项绘制顺序,可以使用新顺序重新建立堆栈 +- 当第一个child置于底部时,堆栈按顺序绘制其子项。如果更改子项绘制顺序,可以使用新顺序重新建立堆栈 - 注意:stack的每一个子节点都已定位或为定位,定位子项必须至少一个非null属性的定位。 """;