mirror of
https://github.com/alibaba/flutter-go.git
synced 2025-05-20 06:16:20 +08:00
Merge branch 'develop' of github.com:alibaba/flutter-common-widgets-app into develop
This commit is contained in:
ryan730
38
README.md
38
README.md
@ -1,6 +1,6 @@
|
||||
## Flutter 菜鸟手册
|
||||
|
||||
> 帮助开发者快速上手 Flutter
|
||||
> 帮助开发者快速上手 Flutter **内部测试中，1.0 正式版将于 2月 20日 发布。**
|
||||
|
||||
### 背景
|
||||
|
||||
@ -29,9 +29,41 @@ flutter优点主要包括：
|
||||
|
||||
<img src="https://img.alicdn.com/tfs/TB1x4gdASzqK1RjSZFHXXb3CpXa-1080-2340.jpg" width=200> <img src="https://img.alicdn.com/tfs/TB1xioCANnaK1RjSZFtXXbC2VXa-1080-2340.jpg" width=200> <img src="https://img.alicdn.com/tfs/TB1XFwcAOrpK1RjSZFhXXXSdXXa-1080-2340.jpg" width=200> <img src="https://img.alicdn.com/tfs/TB1Hf7aAPTpK1RjSZKPXXa3UpXa-1080-2340.jpg" width=200>
|
||||
|
||||
### 团队
|
||||
### Core Team
|
||||
|
||||
power by [阿里拍卖前端团队](https://github.com/alibaba-paimai-frontend)<img src="https://img.alicdn.com/tfs/TB1foEhAMHqK1RjSZJnXXbNLpXa-166-166.png" width=20 height=20>
|
||||
<table>
|
||||
<tbody>
|
||||
<tr>
|
||||
<td align="center" width="80" valign="top">
|
||||
<img height="80" width="80" src="https://github.com/minghe.png?s=128">
|
||||
<br>
|
||||
<a href="https://github.com/minghe">@minghe</a>
|
||||
</td>
|
||||
<td align="center" width="80" valign="top">
|
||||
<img height="80" width="80" src="https://github.com/ryan730.png?s=128">
|
||||
<br>
|
||||
<a href="https://github.com/ryan730">@ryan730</a>
|
||||
</td>
|
||||
<td align="center" width="80" valign="top">
|
||||
<img height="80" width="80" src="https://github.com/Nealyang.png?s=128">
|
||||
<br>
|
||||
<a href="https://github.com/Nealyang">@Nealyang</a>
|
||||
</td>
|
||||
<td align="center" width="80" valign="top">
|
||||
<img height="80" width="80" src="https://github.com/hanxu317317.png?s=128">
|
||||
<br>
|
||||
<a href="https://github.com/hanxu317317">@hanxu317317</a>
|
||||
</td>
|
||||
<td align="center" width="80" valign="top">
|
||||
<img height="80" width="80" src="https://github.com/DeckeDeng.png?s=128">
|
||||
<br>
|
||||
<a href="https://github.com/DeckeDeng">@DeckeDeng</a>
|
||||
</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
Powered by [阿里拍卖前端团队](https://github.com/alibaba-paimai-frontend)<img src="https://img.alicdn.com/tfs/TB1foEhAMHqK1RjSZJnXXbNLpXa-166-166.png" width=20 height=20>
|
||||
|
||||
|
||||
|
||||
|
||||
32
api.md
32
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工厂。[...]
|
||||
|
||||
@ -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<int> bytes =
|
||||
data.buffer.asUint8List(data.offsetInBytes, data.lengthInBytes);
|
||||
|
||||
@ -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)), // 圆角
|
||||
|
||||
@ -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部分标签失效
|
||||
""";
|
||||
|
||||
|
||||
@ -19,7 +19,7 @@ const String Text1 = """
|
||||
> OverflowBox设置最大/最小尺寸
|
||||
- SizedOverflowBox，一个特定大小的小部件，但将其原始约束传递给它的子节点，然后可能会溢出。
|
||||
- ConstrainedBox，一个对其子项施加额外约束的小部件。
|
||||
- UnconstrainedBox，一个试图让它的孩子在没有约束的情况下绘制的容器。
|
||||
- UnconstrainedBox，一个试图让它的child在没有约束的情况下绘制的容器。
|
||||
- SizedBox，一个具有指定大小的盒子。
|
||||
""";
|
||||
|
||||
|
||||
@ -28,7 +28,7 @@ class ColumnDefault extends StatelessWidget {
|
||||
/**
|
||||
* > mainAxisSize 属性
|
||||
- 一行的高度是有mainAxisSize属性控制，默认是max
|
||||
- mainAxisSize: MainAxisSize.min,一行的宽度是孩子传入的约束
|
||||
- mainAxisSize: MainAxisSize.min,一行的宽度是child传入的约束
|
||||
- mainAxisSize: MainAxisSize.max,一行的宽度的最大宽度是传入的约束。
|
||||
> mainAxisAlignment属性
|
||||
*/
|
||||
|
||||
@ -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
|
||||
""";
|
||||
|
||||
|
||||
@ -6,7 +6,7 @@ const String Text0 = """### **简介**
|
||||
> 一个常用的widget，它结合了常见的绘画，定位和大小调整
|
||||
- 该容器首先让child填充绘制，然后再将其他的约束应用于填充范围。
|
||||
- 在绘画过程中，容器先应用给定的转换，在绘制装饰以填充的范围，然后绘制child，最后绘制前景，同时填充需要填充的范围
|
||||
- 没有孩子的容器试图尽可能的大，除非传入的约束是无限制的。child的大小会被width，height等约束覆盖。
|
||||
- 没有child的容器试图尽可能的大，除非传入的约束是无限制的。child的大小会被width，height等约束覆盖。
|
||||
""";
|
||||
|
||||
const String Text1 = """
|
||||
|
||||
@ -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封装在一个扩展部件里面
|
||||
- 当我们看到行有黄色和黑色条纹警告时候，说明行已经溢出，当行溢出，行之间当空间将没有任何空间可供扩展。
|
||||
|
||||
""";
|
||||
|
||||
@ -10,7 +10,7 @@ const String _stackText0 = """### **简介**
|
||||
""";
|
||||
const String _stackText1 = """### **基本用法**
|
||||
> index → int
|
||||
- 控制显示孩子的索引
|
||||
- 控制显示child的索引
|
||||
- ex:可以通过多个图片转化表示状态（正确，错误，警告等）。
|
||||
""";
|
||||
|
||||
|
||||
@ -5,7 +5,7 @@ import './demo.dart';
|
||||
|
||||
const String _stackText0 = """### **简介**
|
||||
> 用于将多个子级相对于其框的边缘定位，多用于以简单方式重叠children
|
||||
- 当第一个孩子置于底部时，堆栈按顺序绘制其子项。如果更改子项绘制顺序，可以使用新顺序重新建立堆栈
|
||||
- 当第一个child置于底部时，堆栈按顺序绘制其子项。如果更改子项绘制顺序，可以使用新顺序重新建立堆栈
|
||||
- 注意：stack的每一个子节点都已定位或为定位，定位子项必须至少一个非null属性的定位。
|
||||
|
||||
""";
|
||||
|
||||
Reference in New Issue
Block a user