Flutter搜索功能增强插件ios_search_appbar的使用

发布于 1周前 作者 songsunli 来自 Flutter

Flutter搜索功能增强插件ios_search_appbar的使用

iOS Search AppBar

iOS Search AppBar 是一个Flutter库,提供了一个可折叠的应用栏和漂亮的搜索栏动画,使您的Flutter应用具有iOS风格的外观和感觉。它完全可自定义,并且兼容iOS和Android平台。

demo_gif

使用方法

1. 添加依赖

pubspec.yaml 文件中添加 ios_search_appbar 包:

dependencies:
  ios_search_appbar: ^1.1.1

2. 导入包

在Dart代码中导入 ios_search_appbar 包:

import 'package:ios_search_appbar/cupertino_search_appbar.dart';

3. 使用 CupertinoSearchAppBar

通过传递内容到 slivers 参数来使用 CupertinoSearchAppBar

CupertinoSearchAppBar(
  slivers: [
    // 您的 slivers 内容放在这里
  ],
)

示例代码

以下是一个完整的示例代码,展示了如何使用 CupertinoSearchAppBar 并进行自定义:

import 'package:flutter/material.dart';
import 'package:ios_search_appbar/cupertino_search_appbar.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Example(),
    );
  }
}

class Example extends StatelessWidget {
  const Example({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return CupertinoSearchAppBar(
      // 自定义搜索栏属性
      searchFieldProperties: SearchFieldProperties(
        placeholder: "搜索...",
        prefixIcon: Icon(Icons.search),
        suffixIcon: Icon(Icons.clear),
      ),
      // 自定义应用栏属性
      appBarProperties: AppBarProperties(
        backgroundColor: Colors.blue,
        title: Text("搜索栏示例"),
      ),
      // 添加刷新控件
      refreshSliver: CupertinoSliverRefreshControl(
        onRefresh: () async {
          // 刷新逻辑
          await Future.delayed(Duration(seconds: 2));
        },
        builder: (context, refreshState, pulledExtent,
            refreshTriggerPullDistance, refreshIndicatorExtent) {
          return buildRefreshIndicator(
              context,
              refreshState,
              pulledExtent,
              refreshTriggerPullDistance,
              refreshIndicatorExtent,
              true);
        },
        refreshIndicatorExtent: 40,
      ),
      slivers: [
        // 使用 SliverList 显示列表项
        SliverList(
          delegate: SliverChildBuilderDelegate(
            (context, index) {
              return CupertinoListTile(
                title: Text("标题 $index"),
                onTap: () {
                  // 点击事件
                },
              );
            },
            childCount: 15,
          ),
        ),
      ],
    );
  }

  // 构建刷新指示器
  Widget buildRefreshIndicator(BuildContext context, RefreshIndicatorMode refreshState,
      double pulledExtent, double refreshTriggerPullDistance, double refreshIndicatorExtent,
      bool show) {
    if (!show) {
      return Container();
    }

    final percentage = pulledExtent / refreshTriggerPullDistance;
    final percentageClamped = percentage.clamp(0.0, 1.0);

    return Stack(
      children: <Widget>[
        Align(
          alignment: Alignment.topCenter,
          child: SizedBox(
            height: refreshIndicatorExtent,
            child: CircularProgressIndicator(
              value: percentageClamped,
              strokeWidth: 2.0,
            ),
          ),
        ),
      ],
    );
  }
}

更多关于Flutter搜索功能增强插件ios_search_appbar的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html

1 回复

更多关于Flutter搜索功能增强插件ios_search_appbar的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


当然,下面是一个关于如何在Flutter中使用ios_search_appbar插件来实现增强搜索功能的示例代码。这个插件提供了一个类似于iOS风格的搜索栏,可以很方便地集成到你的Flutter应用中。

首先,确保你的Flutter项目已经添加了ios_search_appbar依赖。你可以在pubspec.yaml文件中添加以下依赖:

dependencies:
  flutter:
    sdk: flutter
  ios_search_appbar: ^最新版本号  # 请替换为最新的版本号

然后运行flutter pub get来安装依赖。

接下来,我们来看一个完整的示例代码,展示如何在Flutter应用中使用ios_search_appbar插件:

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

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Search Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  final TextEditingController _controller = TextEditingController();
  List<String> _suggestions = [
    'Apple',
    'Banana',
    'Cherry',
    'Date',
    'Elderberry',
    'Fig',
    'Grape',
    'Honeydew',
    'Indian Fig',
    'Jackfruit',
    // 添加更多建议项...
  ];
  List<String> _filteredSuggestions = [];

  @override
  void initState() {
    super.initState();
    _filteredSuggestions = _suggestions.toList();
    _controller.addListener(() {
      setState(() {
        _filterResults(_controller.text);
      });
    });
  }

  @override
  void dispose() {
    _controller.dispose();
    super.dispose();
  }

  void _filterResults(String query) {
    _filteredSuggestions = _suggestions.where((item) {
      return item.toLowerCase().contains(query.toLowerCase());
    }).toList();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: IOSSearchAppBar(
        controller: _controller,
        hintText: 'Search...',
        onSearchChanged: (String value) {
          // 这里可以处理搜索文本的变化,已经通过_filterResults处理
        },
        onSearchSubmitted: (String value) {
          // 这里可以处理搜索提交事件,比如导航到搜索结果页面
          print('Search submitted: $value');
        },
        leading: IconButton(
          icon: Icon(Icons.arrow_back),
          onPressed: () {
            Navigator.pop(context);
          },
        ),
        trailing: IconButton(
          icon: Icon(Icons.clear),
          onPressed: () {
            _controller.clear();
            setState(() {
              _filteredSuggestions = _suggestions.toList();
            });
          },
        ),
      ),
      body: Padding(
        padding: const EdgeInsets.all(8.0),
        child: _filteredSuggestions.isEmpty
            ? Center(child: Text('No results found'))
            : ListView.builder(
                itemCount: _filteredSuggestions.length,
                itemBuilder: (context, index) {
                  return ListTile(
                    title: Text(_filteredSuggestions[index]),
                    onTap: () {
                      // 处理点击事件,比如导航到详情页面
                      print('Selected: ${_filteredSuggestions[index]}');
                    },
                  );
                },
              ),
      ),
    );
  }
}

在这个示例中,我们做了以下几件事:

  1. 添加依赖:在pubspec.yaml文件中添加了ios_search_appbar依赖。
  2. 创建UI:使用IOSSearchAppBar创建了一个搜索栏,并设置了相关的控制器、提示文本、搜索变化回调、搜索提交回调、前置和后置图标按钮。
  3. 处理搜索逻辑:在搜索栏的文本变化时,通过_filterResults方法过滤建议列表,并在UI中显示过滤后的结果。
  4. 处理点击事件:为每个搜索结果项添加了点击事件处理。

这个示例展示了如何使用ios_search_appbar插件来实现一个基本的搜索功能,包括搜索建议的过滤和显示,以及搜索结果的点击处理。你可以根据自己的需求进一步定制和扩展这个示例。

回到顶部