flutter-view
  • Introduction
  • FAQ
  • Get Started
    • Install
    • Usage
    • Test drive
    • VS Code support
    • Examples
  • Guide
    • Configuring flutter-view
    • Creating a new view
    • Creating widget layouts
    • Flow control
    • Shortcuts
    • Styling with CSS
    • Writing Reactive code
    • Styling per platform
  • Shortcuts Reference
    • Special pug tags
    • CSS style properties
Powered by GitBook
On this page
  • The platform widgets library
  • Layout per platform
  • Same layout but different styling per platform
  1. Guide

Styling per platform

PreviousWriting Reactive codeNextSpecial pug tags

Last updated 3 years ago

When you write your Flutter app you probably want to target both iOS and Android. Flutter-view styling can make this easier for you, using the standard tools from CSS, Pug and Sass.

The platform widgets library

First tip is, use the , and add it as an in flutter-view.json:

flutter-view.json
{
	"imports": [
		"package:flutter_view_widgets/flutter_view_widgets.dart",
		"package:flutter_platform_widgets/flutter_platform_widgets.dart"
	]
}

Put flutter-view.json in the root of your Flutter project.

This will allow you to use widgets that adapt to the platform they are used on, and also provides you with the short and properties, that you can use throughout your layouts.

Layout per platform

A common pattern is a with two implementations with two statements below it, one per platform:

.foo
    slot
        .ios(if='isCupertino')
            ...iOS layout here...
        .android(if='isMaterial')
            ...Android layout here...
.foo
    .ios
        // ios layout styling here
    .android
        // android layout styling here

The above will render different layout depending on the phone OS you run it on. Since we are adding a different class, we can also add different styling through CSS.

Same layout but different styling per platform

A very common situation is that we have the same basic layout, but want to use different CSS styling per layout. We could do the same as above:

.foo
    slot
        .ios(if='isCupertino')
            .some
                .layout
                    .here
        .android(if='isMaterial')
            .some
                .layout
                    .here

This will work, we can apply different styling for .bar.ios and .bar.android. However we are repeating ourselves in the layout. This can be quite redundant.

Instead, we can let Pug mixins help us. We can make a default.pug in our project that multiple view pugs can import. Then in this pug we can write a mixin:

default.pug
mixin platform-slot
    slot
        .ios-slot(if='isCupertino')
            .ios
                block
        .android-slot(if='isMaterial')
            .android
                block

We can then import this tool into our view and use it like this:

include /screens/default.pug

.foo
    platform-slot
        .some
            .layout
                .here
include /screens/default.pug

.foo
    slot
        .ios-slot(if='isCupertino')
            .ios
                .bar
                    .some
                        .layout
                            .here
        .android-slot(if='isMaterial')
            .android
                .bar
                    .some
                        .layout
                            .here 
.foo
    .ios
        .some
            // ios layout styling here
    .android
        .some
            // android layout styling here

Now we have no repetition in our layout!

Note: kudos for Floris van der Grinten for this nifty solution

However, there is a downside: the generated pug will not know what source code line it came to, and as a result, you will not get the . This means that in VSCode, the hotlinking will not work for these lines.

platform_widgets library
isCupertino
isMaterial
slot
if
default import
source reference comments in the generated Dart
flutter-view extension