New

Author: PythonnotJava

.idea/workspace.xml

@@ -5,6 +5,7 @@
 > * InheritedWidget：用于在组件树中向子组件提供共享数据。当数据发生变化时，依赖于这些数据的子组件会自动更新。这种机制被称为“数据的跨组件共享”，尤其适用于跨越多个组件树节点的数据传递，如主题、用户会话、配置等。
 > * InheritedProvider：用于在Flutter的widget树中共享和传递数据。它自动处理状态更新的通知和重建工作。
 > * Provider：用于实现数据的依赖注入和状态管理。它基于 InheritedWidget，并通过简化的 API 提供了在 Flutter 中共享和管理数据的方式。
+> * Listener：用于监听用户触摸、拖动和其他指针事件的组件。
 
 ## LinearProgressIndicator类
 ### 默认构造函数
@@ -236,3 +237,19 @@ Provider.value({
 | builder            | Widget Function | 回调函数，用来动态构建 widget 树                                                                                   |
 | child              | Widget          | 这是 Provider 的子 widget，通常是你应用的根 widget。child 会作为 Provider 提供的对象的消费者                                     |
 
+## Listener类
+### 默认构造函数
+```text
+Provider.value({
+  Key? key,
+  required T value,
+  UpdateShouldNotify<T>? updateShouldNotify,
+  TransitionBuilder? builder,
+  Widget? child,
+})
+
+```
+
+### Provider.value参数解析
+| 参数名称               | 使用类型            | 参数介绍                                                                                                   |
+|--------------------|-----------------|--------------------------------------------------------------------------------------------------------|

Flutter-NoteBooks/demo16.md

@@ -4,11 +4,12 @@
 > * showGeneralDialog：用于显示通用对话框的方法。与showDialog和showCupertinoDialog相比，showGeneralDialog提供了更高度的自定义能力，可以用于构建更灵活和复杂的对话框。
 > * AboutDialog：用于显示关于应用程序的对话框。通常，关于对话框用于显示应用程序的版本号、版权信息、开发者信息等。
 > * SimpleDialog：用于显示简单的对话框。通常用于在一组选项中让用户选择其中一个选项。
-> *  AlertDialog：用于显示一个警示对话框。
+> * AlertDialog：用于显示一个警示对话框。
 > * SimpleDialogOption：通常用于在一组选项中让用户选择其中一个选项，并且它是SimpleDialog的子部件。
+> * Dialog：一个通用的对话框类，并不限定对话框的具体内容和结构。它仅提供一个基本的容器，使你可以完全自定义对话框的内容、布局和样式。
 
-## showDialog类
-### 默认构造函数
+## showDialog方法
+### 函数原型
 ```text
 Future<T?> showDialog<T>({
   required BuildContext context,
@@ -38,8 +39,8 @@ Future<T?> showDialog<T>({
 | anchorPoint            | Offset                | 对话框的锚点，这是一个相对于屏幕的偏移量，用于定位对话框的位置                |
 | traversalEdgeBehavior  | TraversalEdgeBehavior | 遍历边缘行为                                         |
 
-## showCupertinoDialog类
-### 默认构造函数
+## showCupertinoDialog方法
+### 函数原型
 ```text
 Future<T?> showCupertinoDialog<T>({
   required BuildContext context,
@@ -63,8 +64,8 @@ Future<T?> showCupertinoDialog<T>({
 | routeSettings      | RouteSettings     | 对话框的路由设置，可以用于传递一些路由相关的信息                        |
 | anchorPoint        | Offset            | 对话框的锚点，这是一个相对于屏幕的偏移量，用于定位对话框的位置                 |
 
-## showGeneralDialog类
-### 默认构造函数
+## showGeneralDialog方法
+### 函数原型
 ```text
 Future<T?> showGeneralDialog<T extends Object?>({
   required BuildContext context,
@@ -241,3 +242,59 @@ SimpleDialogOption({
 | onPressed | Function   | 点击选项时触发的回调函数           |
 | padding   | EdgeInsets | 选项的内边距                 |
 | child     | Widget     | 选项的内容                  |
+
+## Dialog类
+### 默认构造函数
+```text
+Dialog({
+    super.key,
+    this.backgroundColor,
+    this.elevation,
+    this.shadowColor,
+    this.surfaceTintColor,
+    this.insetAnimationDuration = const Duration(milliseconds: 100),
+    this.insetAnimationCurve = Curves.decelerate,
+    this.insetPadding,
+    this.clipBehavior,
+    this.shape,
+    this.alignment,
+    this.child,
+  })
+```
+
+### Dialog(...)参数解析
+| 参数名称                   | 使用类型               | 参数介绍                           |
+|------------------------|--------------------|--------------------------------|
+| key                    | Key                | 小部件的唯一标识符，可以用于查找和操作小部件         |
+| backgroundColor        | Color              | 对话框的背景颜色                       |
+| elevation              | double             | 阴影高度，控制对话框的阴影深度，给人一种悬浮的效果      |
+| shadowColor            | Color              | 阴影的颜色                          |
+| surfaceTintColor       | Color              | 表面着色颜色，用于影响对话框的背景色             |
+| insetAnimationDuration | Duration           | 插入动画的持续时间                      |
+| insetAnimationCurve    | Curve              | 插入动画的曲线，定义动画的速度变化              |
+| insetPadding           | EdgeInsets         | 控制对话框与屏幕边缘之间的内边距               |
+| clipBehavior           | Clip               | 裁剪行为，控制对话框内容超出边界时的裁剪方式。可以设置为   |         
+| shape                  | ShapeBorder        | 控制对话框的形状，通常用于设置对话框的圆角或自定义边框    |
+| alignment              | AlignmentGeometry  | 对话框在屏幕中的对齐方式，默认是居中对齐           |
+| child                  | Widget             | 对话框的子组件，即其实际内容                 |
+
+## Dialog类
+### 创建全屏对话框
+```text
+Dialog.fullscreen({
+    super.key,
+    this.backgroundColor,
+    this.insetAnimationDuration = Duration.zero,
+    this.insetAnimationCurve = Curves.decelerate,
+    this.child,
+  })
+```
+
+### Dialog(...)参数解析
+| 参数名称                   | 使用类型               | 参数介绍                           |
+|------------------------|--------------------|--------------------------------|
+| key                    | Key                | 小部件的唯一标识符，可以用于查找和操作小部件         |
+| backgroundColor        | Color              | 对话框的背景颜色                       |
+| insetAnimationDuration | Duration           | 插入动画的持续时间                      |
+| insetAnimationCurve    | Curve              | 插入动画的曲线，定义动画的速度变化              |
+| child                  | Widget             | 对话框的子组件，即其实际内容                 |

Flutter-NoteBooks/demo8.md

@@ -0,0 +1,12 @@
+key : 用于标识该对话框小部件的唯一标识符。通常用于测试或管理特定的对话框实例。
+backgroundColor : 对话框的背景颜色。默认是一个浅色背景，也可以根据需求设置其他颜色。
+elevation : 阴影高度，控制对话框的阴影深度，给人一种悬浮的效果。较高的 elevation 值会带来更浓的阴影，使对话框看起来更立体。
+shadowColor : 阴影的颜色。可以改变对话框周围阴影的颜色，使其适应不同的设计主题。默认颜色通常是黑色的半透明阴影。
+surfaceTintColor : 表面着色颜色，用于影响对话框的背景色。这在 Material Design 3 中尤为重要，因为它可以对背景色进行微调，产生视觉上的深浅变化。
+insetAnimationDuration : 插入动画的持续时间。这个动画发生在对话框显示时，控制对话框弹出动画的时间。默认值为 Duration(milliseconds: 100)，即100毫秒。
+insetAnimationCurve : 插入动画的曲线，定义动画的速度变化。默认使用 Curves.decelerate 曲线，即动画逐渐减速。可选择不同的曲线（如 Curves.easeIn、Curves.bounceIn 等）来创建不同的动画效果。
+insetPadding : 控制对话框与屏幕边缘之间的内边距。默认会给对话框四周添加一些距离，确保对话框不会贴近屏幕边缘。设置 EdgeInsets.zero 可以实现全屏对话框。
+clipBehavior : 裁剪行为，控制对话框内容超出边界时的裁剪方式。可以设置为：
+shape : 控制对话框的形状，通常用于设置对话框的圆角或自定义边框。常见设置是 RoundedRectangleBorder（圆角矩形边框）或 ContinuousRectangleBorder。例如，使用 RoundedRectangleBorder(borderRadius: BorderRadius.circular(10)) 可以创建带圆角的对话框。
+alignment : 对话框在屏幕中的对齐方式，默认是居中对齐。通过设置 Alignment.topCenter、Alignment.bottomCenter 等值，可以使对话框显示在特定位置。
+child : 对话框的子组件，即其实际内容。可以是任何 Widget，例如 Column、Container、自定义布局等。Dialog并没有强制要求使用特定的布局结构，所以可以根据需求完全自定义内容。

interpreter/Dialog/dialog-default.txt

@@ -11,4 +11,4 @@ def batsh_like(path : str):
         b = cur[1].split('。')[0]
         print('|{} |         |{} |'.format(a, b))
 
-batsh_like('Container/nestedscrollview-default.txt')
+batsh_like('Dialog/dialog-default.txt')