Creating widget layouts

Overview
In Flutter, widget trees are built by passing a child or children. Widget trees have a lot of indentation, especially since in Flutter nearly everything is a widget, and composition is preferred to inheritance. This can lead to complex nesting and child parameters.
Flutter-views are optimised for building widget trees. Pug in particular is well suited for creating tree structures and moving parts around.
The following example generates a Dart method FooPage(), which returns a Scaffold with an AppBar, and a centralized greeting message. 
The Pug creates the layout, and the main.dart file uses this layout to render the app. This separation between layout and logic is fundamental to using flutter-view.
Pug
generated Dart
main.dart
foo-page.pug
1
foo-page(flutter-view :greeting)
2
    scaffold
3
        app-bar(as='appBar')
4
            container(as='title') Foo Page
5
        center(as='body') Hello $greeting!
Copied!
foo-page.dart
1
FooPage({@required greeting}) {
2
    return Scaffold(
3
        appBar: AppBar(
4
            title: Container(
5
                child: Text('Foo page'),
6
            ),
7
        ),
8
        body: Center(
9
            child: Text('Hello $greeting!'),
10
        ),
11
    );
12
}
Copied!
main.dart
1
import 'package:flutter/material.dart';
2
import 'foo-page.dart';
3
​
4
void main() => runApp(TestApp());
5
​
6
class TestApp extends StatelessWidget {
7
​
8
  @override
9
  Widget build(BuildContext context) {
10
    return MaterialApp(
11
      title: 'Test App',
      home: FooPage(greeting: 'world!')
12
    );
13
  }
14
​
15
}
Copied!
Adding children to widgets
In a flutter-view, add indented child tags to tags to automatically have them assigned as child or children parameters.
In flutter-view Pug/HTML content, an HTML tag is a method or constructor call, and its parameters are parameters for this method or constructor. The tag children are assigned as the Flutter child/children parameters.
To see how this works, compare the Pug and generated Dart code in this example:
Pug
generated Dart
1
container
2
    column
3
        row 
4
            text(value='first row!')
5
        row 
6
            text(value='second row!')
7
        row
8
            flat-button 
9
                text(value='Click me!')
10
            
Copied!
1
return Container(
2
    child: Column(
3
        children: [
4
            Row(
5
                children: [
6
                    Text('first row!'),
7
                ],
8
            ),
9
            Row(
10
                children: [
11
                    Text('second row!'),
12
                ],
13
            Row(
14
                FlatButton(
15
                    child: Text('Click me!'),
16
                )
17
            ),
18
        ],
19
    ),
20
);
Copied!
Automatic columns
Flutter-view knows which classes generally need children instead of single child, and automatically creates Columns when you pass multiple children. Also, if you pass text, flutter-view it automatically wraps it in a Text widget as well. This together allows you to be more terse:
Pug
generated Dart
1
container
2
    row first row!
3
    row second row!
4
    row
5
        flat-button Click me!            
Copied!
1
return Container(
2
    child: Column(
3
        children: [
4
            Row(
5
                children: [
6
                    Text('first row!'),
7
                ],
8
            ),
9
            Row(
10
                children: [
11
                    Text('second row!'),
12
                ],
13
            Row(
14
                FlatButton(
15
                    child: Text('Click me!'),
16
                )
17
            ),
18
        ],
19
    ),
20
);
Copied!
You can override the default wrapper in flutter-view.json.
Calling dart factory constructors
Some Flutter Dart classes may use factory constructors. For example, ButtonTheme has a ButtonTheme.bar() constructor. 
To call the factory constructor instead of the default constructor, pass the constructor after the class name, separated with a colon.
Pug
generated Dart
1
button-theme:bar
2
    | some content here
Copied!
1
ButtonTheme.bar(
2
    child: Text(
3
        'some content here'
4
    ),
5
)
Copied!
Passing children instead of child
There may be cases where flutter-view does not recognise your tag needs a children parameter instead of a child parameter. In that case use and array and assign it as children:
Pug
generated Dart
1
column
2
    array(as='children')
3
        row first!
4
        row second!
Copied!
1
Column(
2
    children: [
3
        Row(
4
            children: [
5
                Text('first!'),
6
            ]
7
        ),
8
        Row(
9
            children: [
10
                Text('second!'),
11
            ]
12
        ),
13
    ]
14
)
Copied!
Passing const widgets
For optimising performance, you may want to pass some widgets as constants. You can do this by adding a const parameter in a widget:
To see how this works, compare the Pug and generated Dart code in this example:
Pug
generated Dart
1
container
2
    column(const)
3
        row 
4
            text(value='first row!')
Copied!
1
return Container(
2
    child: const Column(
3
        children: [
4
            Row(
5
                children: [
6
                    Text('first row!'),
7
                ],
8
            ),
9
        ],
10
    ),
11
);
Copied!
Passing parameters
To pass parameters besides child or children, you pass them as pug/html parameters.
String parameters
You can pass strings by using quotes. Both double and single quotes work.
For example:
Pug
generated Dart
1
banner(title='testing')
2
    | Hello world!
Copied!
1
return Banner(
2
    title: 'testing',
3
    child: Text('Hello world!'),
4
);
Copied!
Expression parameters
To assign a Dart expression as the value of a parameter:
start the parameter name with :
wrap the expression in quotes. You may need to escape strings.
For example:
Pug
generated Dart
1
flat-button(:color='highlighted ? Colors.red : Colors.grey')
2
    | Click me!     
Copied!
1
return FlatButton(
2
    color: highlighted ? Colors.red : Colors.grey,
3
    child: Text('Click me!'),
4
);
Copied!
For title we want to pass a direct string, but for color we want to pass a value by reference, so we add : in front of the parameter.
Unnamed parameters
Some widgets take an unnamed parameter in their constructor. You can pass this using the reserved value parameter:
Pug
generated Dart
1
container
2
    icon(:value='Icons.add')
3
    text(value='Hello world')
Copied!
1
return Container(
2
    child: Column(
3
        children: [
4
            Icon(Icons.add),
5
            Text('Hello world'),
6
        ]
7
    ),
8
);
Copied!
Escaping parameter names
You may need to pass a parameter that has the name of a reserved keyword, such as value. You can bypass this problem by escaping your parameter with the ^ sign:
1
:^value='foo'
Copied!
Passing complex parameter values
Sometimes what you want to pass is not just a single value, but a value that is constructed of many widgets. To solve this, you may take a child and use the as keyword to assign it as a parameter to the parent widget.
Pug
generated Dart
1
scaffold
2
    app-bar(as='appBar')
3
        container(as='title') Test App
4
    center(as='body') Hello world!
Copied!
1
return Scaffold(
2
    appBar: AppBar(
3
        title: Container(
4
            child: Text('Test App'),
5
        ),
6
        body: Center(
7
            child: Text('Hello world!'),
8
        ),
9
    ),
10
);
Copied!
The Scaffold class used above has no child or children parameters. Instead we add two children and assign them as parameters using the as property.
Passing functions as children
You can create functions that return children using the function shortcut.
Passing handlers
Passing a handler function or closure is no different than in Dart:
1
my-button(flutter-view :on-click[Function])
2
    flat-button(:on-pressed='onClick') Click me!
Copied!
A common case is a closure without any parameters. In that case you can use the @ sign to create a closure handler:
Pug
generated Dart
1
my-button(flutter-view)
2
    flat-button(@on-pressed='print("Click!")') Click me!
Copied!
1
MyButton() {
2
    return FlatButton(
3
        onPressed: () { print("Click!"); },
4
        child: Text('Click me!'),
5
    );
6
}
Copied!
Passing Arrays
Sometimes you need to pass an array of specific items to a parameter. In that case you can use the array tag.
Pug
generated Dart
1
custom-scroll-view
2
    array(as='slivers')
3
        sliver1
4
        sliver2
5
        sliver3
Copied!
1
CustomScrollView(
2
    slivers: [
3
        sliver1,
4
        sliver2,
5
        sliver3,
6
    ],
7
)
Copied!
Automatic Containers
A nice Pug feature is that classes and ids are automatically converted into DIV tags. In flutter-view, they are automatically converted into Container widgets:
1
container hello world
2
#greeting hello world
3
.greeting hello world
Copied!
All three are equivalent and convert to:
1
Container(
2
    child: Text('hello world'),
3
)
Copied!
The classes and ids you use are forgotten after the conversion to Dart code. However, you do get automatic commenting, which will make it easier to read the generated code.
The biggest benefit is however that you can use them to style your widgets.