Flutter响应式设计插件responsive_design的使用

Flutter响应式设计插件responsive_design的使用

介绍

responsive_design 是一个用于创建响应式应用程序的Flutter插件，它允许你根据不同的屏幕尺寸使用不同的小部件。通过这个插件，你可以轻松地为桌面、平板、手机和手表等设备创建自适应的布局。

开始使用

添加依赖

在 pubspec.yaml 文件中添加 responsive_design 依赖：

dependencies:
  responsive_design:

重要更新

从版本 0.1.0 开始，ResponsiveSettings 类不再用于管理变更点。请改用 ScreenChangePoints，具体用法请参考示例代码。

自定义设置

你可以通过 ResponsiveSettings 类全局管理响应式的屏幕变更点：

void main() {
  // 全局设置
  ResponsiveSettings.instance.setCustomSettings(
    screenChangePoints: const ScreenChangePoints(
      desktopChangePoint: 1150.0,  // 桌面屏幕的变更点
      tabletChangePoint: 625.0,   // 平板屏幕的变更点
      watchChangePoint: 250.0,    // 手表屏幕的变更点
    ),
  );
  runApp(const MyApp());
}

使用响应式小部件

ResponsiveWidget 允许你为每个设备类型定义不同的布局：

const ResponsiveWidget(
  // 如果不设置全局值将被应用，如果不存在全局值，则默认值将被应用。
  screenChangePoints: ScreenChangePoints(),
  desktop: Scaffold(
    body: Center(
      child: Text(
        'Desktop screen',
        style: TextStyle(
          color: Colors.black,
          fontSize: 25.0,
        ),
      ),
    ),
  ),
  phone: Scaffold(
    body: Center(
      child: Text(
        'Phone screen',
        style: TextStyle(
          color: Colors.amber,
          fontSize: 25.0,
        ),
      ),
    ),
  ),
  tablet: Scaffold(
    body: Center(
      child: Text(
        'Tablet screen',
        style: TextStyle(
          color: Colors.greenAccent,
          fontSize: 25.0,
        ),
      ),
    ),
  ),
  watch: Scaffold(
    body: Center(
      child: Text(
        'Watch screen',
        style: TextStyle(
          color: Colors.blueAccent,
          fontSize: 25.0,
        ),
      ),
    ),
  ),
);

使用响应式应用栏

ResponsiveAppBar 可以让你的应用栏适应所有屏幕：

const Scaffold(
  appBar: ResponsiveAppBar(
    // 如果不设置全局值将被应用，如果不存在全局值，则默认值将被应用。
    screenChangePoints: ScreenChangePoints(),
    title: Text('Responsive app bar'),
    actions: [
      AppBarAction(
        Center(child: Text('About')),
      ),
      AppBarAction(
        SizedBox(width: 16.0),
        showInAllScreens: true,
      ),
      AppBarAction(
        Icon(Icons.brightness_auto_outlined),
        showInAllScreens: true,
      ),
      AppBarAction(
        SizedBox(width: 16.0),
        showInAllScreens: true,
      ),
    ],
  ),
);

完整示例代码

以下是一个完整的示例代码，展示了如何使用 responsive_design 插件来创建一个响应式应用程序：

import 'package:flutter/material.dart';
import 'package:responsive_design/responsive_design.dart';

/// 主函数
void main() {
  // 全局设置
  ResponsiveSettings.instance.setCustomSettings(
    screenChangePoints: const ScreenChangePoints(
      desktopChangePoint: 1150.0,
      tabletChangePoint: 625.0,
      watchChangePoint: 250.0,
    ),
  );
  runApp(const MyApp());
}

/// 应用程序的根部
class MyApp extends StatelessWidget {
  /// 定义 [MyApp] 小部件
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Responsive Design Example',
      debugShowCheckedModeBanner: false,
      theme: ThemeData(
        primarySwatch: Colors.blue,
        appBarTheme: const AppBarTheme(
          backgroundColor: Colors.blueGrey,
        ),
      ),
      routes: {
        '/': (_) => const HomePage(),
        '/responsive-app-bar': (_) => const ResponsiveAppBarExample(),
        '/responsive-widget': (_) => const ResponsiveWidgetExample(),
        '/sidebar-widget': (_) => const SidebarExample(),
      },
      initialRoute: '/',
    );
  }
}

/// 应用程序的主页
class HomePage extends StatelessWidget {
  /// 定义 [HomePage] 小部件
  const HomePage({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      body: SafeArea(
        child: ListView(
          children: [
            ListTile(
              onTap: () => Navigator.of(context).pushNamed('/responsive-app-bar'),
              title: const Text('Responsive App Bar'),
            ),
            ListTile(
              onTap: () => Navigator.of(context).pushNamed('/responsive-widget'),
              title: const Text('Responsive Widget'),
            ),
            ListTile(
              onTap: () => Navigator.of(context).pushNamed('/sidebar-widget'),
              title: const Text('Sidebar Widget'),
            ),
          ],
        ),
      ),
    );
  }
}

/// 响应式应用栏示例
class ResponsiveAppBarExample extends StatelessWidget {
  /// 定义 [ResponsiveAppBarExample] 小部件
  const ResponsiveAppBarExample({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return const Scaffold(
      appBar: ResponsiveAppBar(
        screenChangePoints: ScreenChangePoints(),
        title: Text('Responsive app bar'),
        actions: [
          AppBarAction(
            Center(child: Text('About')),
          ),
          AppBarAction(
            SizedBox(width: 16.0),
            showInAllScreens: true,
          ),
          AppBarAction(
            Icon(Icons.brightness_auto_outlined),
            showInAllScreens: true,
          ),
          AppBarAction(
            SizedBox(width: 16.0),
            showInAllScreens: true,
          ),
        ],
      ),
    );
  }
}

/// 响应式小部件示例
class ResponsiveWidgetExample extends StatelessWidget {
  /// 定义 [ResponsiveWidgetExample] 小部件
  const ResponsiveWidgetExample({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return const ResponsiveWidget(
      desktop: Scaffold(
        body: Center(
          child: Text(
            'Desktop screen',
            style: TextStyle(
              color: Colors.black,
              fontSize: 25.0,
            ),
          ),
        ),
      ),
      phone: Scaffold(
        body: Center(
          child: Text(
            'Phone screen',
            style: TextStyle(
              color: Colors.amber,
              fontSize: 25.0,
            ),
          ),
        ),
      ),
      tablet: Scaffold(
        body: Center(
          child: Text(
            'Tablet screen',
            style: TextStyle(
              color: Colors.greenAccent,
              fontSize: 25.0,
            ),
          ),
        ),
      ),
      watch: Scaffold(
        body: Center(
          child: Text(
            'Watch screen',
            style: TextStyle(
              color: Colors.blueAccent,
              fontSize: 25.0,
            ),
          ),
        ),
      ),
    );
  }
}