Merge pull request #871 from LucasXu0/documentation/flowy_editor

docs: minor updates to documentation.

Author: LucasXu0

frontend/app_flowy/packages/appflowy_editor/CHANGELOG.md

@@ -1 +1,5 @@
+## 0.0.2
+Minor Updates to Documentation.
+
 ## 0.0.1
+Initial Version of the library.

frontend/app_flowy/packages/appflowy_editor/README.md

@@ -15,6 +15,10 @@ and the Flutter guide for
 
 <p align="center">A highly customizable rich-text editor for Flutter</p>
 
+<p align="center">
+    <a href="https://discord.gg/ZCCYN4Anzq"><b>Discord</b></a> •
+    <a href="https://twitter.com/appflowy"><b>Twitter</b></a>
+</p>
 
 <div align="center">
     <img src="https://raw.githubusercontent.com/AppFlowy-IO/AppFlowy/main/frontend/app_flowy/packages/appflowy_editor/documentation/images/example.png" width = "900"/>

frontend/app_flowy/packages/appflowy_editor/documentation/images/example.png

@@ -81,41 +81,6 @@ class _MyHomePageState extends State<MyHomePage> {
     return Container();
   }
 
-  Widget _buildExpandableFab() {
-    return ExpandableFab(
-      distance: 112.0,
-      children: [
-        ActionButton(
-          onPressed: () {
-            if (page == 0) return;
-            setState(() {
-              page = 0;
-            });
-          },
-          icon: const Icon(Icons.note_add),
-        ),
-        ActionButton(
-          icon: const Icon(Icons.document_scanner),
-          onPressed: () {
-            if (page == 1) return;
-            setState(() {
-              page = 1;
-            });
-          },
-        ),
-        ActionButton(
-          onPressed: () {
-            if (page == 2) return;
-            setState(() {
-              page = 2;
-            });
-          },
-          icon: const Icon(Icons.text_fields),
-        ),
-      ],
-    );
-  }
-
   Widget _buildAppFlowyEditorWithEmptyDocument() {
     final editorState = EditorState.empty();
     final editor = AppFlowyEditor(
@@ -176,4 +141,39 @@ class _MyHomePageState extends State<MyHomePage> {
       ),
     );
   }
+
+  Widget _buildExpandableFab() {
+    return ExpandableFab(
+      distance: 112.0,
+      children: [
+        ActionButton(
+          onPressed: () {
+            if (page == 0) return;
+            setState(() {
+              page = 0;
+            });
+          },
+          icon: const Icon(Icons.note_add),
+        ),
+        ActionButton(
+          icon: const Icon(Icons.document_scanner),
+          onPressed: () {
+            if (page == 1) return;
+            setState(() {
+              page = 1;
+            });
+          },
+        ),
+        ActionButton(
+          onPressed: () {
+            if (page == 2) return;
+            setState(() {
+              page = 2;
+            });
+          },
+          icon: const Icon(Icons.text_fields),
+        ),
+      ],
+    );
+  }
 }

frontend/app_flowy/packages/appflowy_editor/example/lib/main.dart

@@ -5,18 +5,23 @@ class FlowySvg extends StatelessWidget {
   const FlowySvg({
     Key? key,
     this.name,
-    this.size = const Size(20, 20),
+    this.width,
+    this.height,
     this.color,
     this.number,
     this.padding,
   }) : super(key: key);
 
   final String? name;
-  final Size size;
+  final double? width;
+  final double? height;
   final Color? color;
   final int? number;
   final EdgeInsets? padding;
 
+  final _defaultWidth = 20.0;
+  final _defaultHeight = 20.0;
+
   @override
   Widget build(BuildContext context) {
     return Padding(
@@ -27,22 +32,21 @@ class FlowySvg extends StatelessWidget {
 
   Widget _buildSvg() {
     if (name != null) {
-      return SizedBox.fromSize(
-        size: size,
-        child: SvgPicture.asset(
-          'assets/images/$name.svg',
-          color: color,
-          package: 'appflowy_editor',
-          fit: BoxFit.fill,
-        ),
+      return SvgPicture.asset(
+        'assets/images/$name.svg',
+        color: color,
+        fit: BoxFit.fill,
+        height: height,
+        width: width,
+        package: 'appflowy_editor',
       );
     } else if (number != null) {
       final numberText =
           '<svg width="200" height="200" xmlns="http://www.w3.org/2000/svg"><text x="30" y="150" fill="black" font-size="160">$number.</text></svg>';
       return SvgPicture.string(
         numberText,
-        width: size.width,
-        height: size.width,
+        width: width ?? _defaultWidth,
+        height: height ?? _defaultHeight,
       );
     }
     return Container();

frontend/app_flowy/packages/appflowy_editor/lib/src/infra/flowy_svg.dart

@@ -47,7 +47,7 @@ class _BulletedListTextNodeWidgetState extends State<BulletedListTextNodeWidget>
   final iconKey = GlobalKey();
 
   final _richTextKey = GlobalKey(debugLabel: 'bulleted_list_text');
-  final _iconSize = 20.0;
+  final _iconWidth = 20.0;
   final _iconRightPadding = 5.0;
 
   @override
@@ -67,7 +67,8 @@ class _BulletedListTextNodeWidgetState extends State<BulletedListTextNodeWidget>
           children: [
             FlowySvg(
               key: iconKey,
-              size: Size.square(_iconSize),
+              width: _iconWidth,
+              height: _iconWidth,
               padding:
                   EdgeInsets.only(top: topPadding, right: _iconRightPadding),
               name: 'point',

frontend/app_flowy/packages/appflowy_editor/lib/src/render/rich_text/bulleted_list_text.dart

@@ -45,7 +45,7 @@ class _CheckboxNodeWidgetState extends State<CheckboxNodeWidget>
   final iconKey = GlobalKey();
 
   final _richTextKey = GlobalKey(debugLabel: 'checkbox_text');
-  final _iconSize = 20.0;
+  final _iconWidth = 20.0;
   final _iconRightPadding = 5.0;
 
   @override
@@ -74,7 +74,8 @@ class _CheckboxNodeWidgetState extends State<CheckboxNodeWidget>
             GestureDetector(
               key: iconKey,
               child: FlowySvg(
-                size: Size.square(_iconSize),
+                width: _iconWidth,
+                height: _iconWidth,
                 padding: EdgeInsets.only(
                   top: topPadding,
                   right: _iconRightPadding,

frontend/app_flowy/packages/appflowy_editor/lib/src/render/rich_text/checkbox_text.dart

@@ -47,7 +47,7 @@ class _NumberListTextNodeWidgetState extends State<NumberListTextNodeWidget>
   final iconKey = GlobalKey();
 
   final _richTextKey = GlobalKey(debugLabel: 'number_list_text');
-  final _iconSize = 20.0;
+  final _iconWidth = 20.0;
   final _iconRightPadding = 5.0;
 
   @override
@@ -66,7 +66,8 @@ class _NumberListTextNodeWidgetState extends State<NumberListTextNodeWidget>
             children: [
               FlowySvg(
                 key: iconKey,
-                size: Size.square(_iconSize),
+                width: _iconWidth,
+                height: _iconWidth,
                 padding:
                     EdgeInsets.only(top: topPadding, right: _iconRightPadding),
                 number: widget.textNode.attributes.number,

frontend/app_flowy/packages/appflowy_editor/lib/src/render/rich_text/number_list_text.dart

@@ -46,7 +46,7 @@ class _QuotedTextNodeWidgetState extends State<QuotedTextNodeWidget>
   final iconKey = GlobalKey();
 
   final _richTextKey = GlobalKey(debugLabel: 'quoted_text');
-  final _iconSize = 20.0;
+  final _iconWidth = 20.0;
   final _iconRightPadding = 5.0;
 
   @override
@@ -60,32 +60,34 @@ class _QuotedTextNodeWidgetState extends State<QuotedTextNodeWidget>
         width: defaultMaxTextNodeWidth,
         child: Padding(
           padding: EdgeInsets.only(bottom: defaultLinePadding),
-          child: Row(
-            crossAxisAlignment: CrossAxisAlignment.start,
-            children: [
-              FlowySvg(
-                key: iconKey,
-                size: Size(_iconSize, _quoteHeight),
-                padding:
-                    EdgeInsets.only(top: topPadding, right: _iconRightPadding),
-                name: 'quote',
-              ),
-              Expanded(
-                child: FlowyRichText(
-                  key: _richTextKey,
-                  placeholderText: 'Quote',
-                  textNode: widget.textNode,
-                  editorState: widget.editorState,
+          child: IntrinsicHeight(
+            child: Row(
+              crossAxisAlignment: CrossAxisAlignment.stretch,
+              children: [
+                FlowySvg(
+                  key: iconKey,
+                  width: _iconWidth,
+                  padding: EdgeInsets.only(
+                      top: topPadding, right: _iconRightPadding),
+                  name: 'quote',
                 ),
-              ),
-            ],
+                Expanded(
+                  child: FlowyRichText(
+                    key: _richTextKey,
+                    placeholderText: 'Quote',
+                    textNode: widget.textNode,
+                    editorState: widget.editorState,
+                  ),
+                ),
+              ],
+            ),
           ),
         ));
   }
 
   double get _quoteHeight {
     final lines =
         widget.textNode.toRawString().characters.where((c) => c == '\n').length;
-    return (lines + 1) * _iconSize;
+    return (lines + 1) * _iconWidth;
   }
 }

frontend/app_flowy/packages/appflowy_editor/lib/src/render/rich_text/quoted_text.dart

@@ -141,7 +141,7 @@ class _ToolbarWidgetState extends State<ToolbarWidget> with ToolbarMixin {
                   Size(toolbarHeight - (width != null ? 20 : 0), toolbarHeight),
               child: Center(
                 child: FlowySvg(
-                  size: Size(width ?? 20, 20),
+                  width: width ?? 20,
                   name: 'toolbar/$name',
                 ),
               ),