search_bar 1.0.1

  • README.md
  • CHANGELOG.md
  • Example
  • Installing
  • Versions
  • 75

search_bar

A simple and mostly automatic material search bar for flutter (dart).

Usage

A simple usage example:

class _MyHomePageState extends State<MyHomePage> {
  SearchBar searchBar;
  
  AppBar buildAppbar(BuildContext context) {
    return new AppBar(
      title: new Text('My Home Page'),
      actions: [searchBar.getSearchAction(context)]
    );
  }  
  
  _MyHomePageState() {
    searchBar = new SearchBar(
      inBar: false,
      setState: setState,
      onSubmitted: print,
      buildDefaultAppBar: buildAppBar
    );
  }
  
  @override
  Widget build(BuildContext context) {
    return new Scaffold(
      appBar: searchBar.build(context)
    );
  }
}

This will create an AppBar with a search button as its only action, and on press the AppBar will turn white and have a TextField inside, allowing user input. Once the user has input something and pressed the "enter" button on their keyboard, it will close and the value will be printed to the debugger.

Essentially, this class returns two different app bars based on whether search is active. Colors from the most recently built "default" app bar are used to color the search bar.

I may refer to the two different app bars as default and search. Default is, as may be inferred, the default app bar. It shows up when you open your app, and is the "default state". Once its search button has been pressed, the search app bar appears, where the user can put in input and submit a field.

TypeDefs

AppBarCallback

typedef AppBar AppBarCallback(BuildContext context);

This should take BuildContext and return an Appbar.

TextFieldSubmitCallback

typedef void TextFieldSubmitCallback(String value);

This should take the value of the input field and return nothing.

SetStateCallback

typedef void SetStateCallback(fn);

This should take a function and return nothing. Generally, this should just be setState. More below.

Constructor

bool inBar - Whether the search should take place "in the existing search bar", meaning whether it has the same background as the AppBar or a flipped (white) one (which also has a colored back button if necessary). Defaults to true.

bool colorBackButton - Whether the back button in the search bar should be colored, if false it will be Colors.grey.shade400. Defaults to true.

bool closeOnSubmit - Whether the search bar should close once it has been submitted. You should probably keep this on, and it defaults to true anyways.

String hintText - The hint text for the TextField that appears when the search button is pressed. Defaults to just 'Search'.

AppBarCallback buildDefaultAppBar - The function to be called each time the default app bar is built. The colors from the most recent AppBar build will be used for the next search app bar.

TextFieldSubmitCallback onSubmitted - A void callback called when the search bar is submitted.

SetStateCallback setState - This is called every time the State needs to be updated (i.e. when the AppBar changes). You can literally just pass setState to this, unless for some reason you want to do extra stuff each time the AppBar changes.

Properties

In addition to all of the above properties set in the constructor:

bool _isSearching - Whether search is active.

AppBar _defaultAppBar - The last built default app bar.

Methods

getSearchAction

IconButton getSearchAction(BuildContext context) This takes context as an argument, and returns an IconButton suitable for an Action in an AppBar. If you want your SearchBar to actually work, put this inside your buildDefaultAppBarpub method.

build

AppBar build(BuildContext context)

This takes context as an argument, and returns an AppBar based on whether search is active.

Features and bugs

Please file feature requests and bugs at the issue tracker.

Changelog

1.0.0

  • Initial version

example/search_bar_example.dart

// Copyright (c) 2017, Spencer. All rights reserved. Use of this source code
// is governed by a BSD-style license that can be found in the LICENSE file.

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

void main() {
  runApp(new SearchBarDemoApp());
}

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

class SearchBarDemoHome extends StatefulWidget {
  @override
  _SearchBarDemoHomeState createState()=> new _SearchBarDemoHomeState();
}

class _SearchBarDemoHomeState extends State<SearchBarDemoHome> {
  SearchBar searchBar;

  AppBar buildAppBar(BuildContext context) {
    return new AppBar(
        title: new Text('Search Bar Demo')
    );
  }

  void onSubmitted(String value) {
    Scaffold.of(context).showSnackBar(
      new SnackBar(
          content: new Text('You wrote $value!')
      )
    );
  }

  _SearchBarDemoHomeState() {
    searchBar = new SearchBar(
      inBar: false,
      buildDefaultAppBar: buildAppBar,
      setState: setState,
      onSubmitted: onSubmitted
    );
  }

  @override
  Widget build(BuildContext context) {
    return new Scaffold(
      appBar: searchBar.build(context),
      body: new Center(
        child: new Text("Don't look at me! Press the search button!")
      ),
    );
  }
}

Use this package as a library

1. Depend on it

Add this to your package's pubspec.yaml file:


dependencies:
  search_bar: "^1.0.1"

2. Install it

You can install packages from the command line:

with Flutter:


$ flutter packages get

Alternatively, your editor might support flutter packages get. Check the docs for your editor to learn more.

3. Import it

Now in your Dart code, you can use:


      import 'package:search_bar/search_bar.dart';
  
Version Uploaded Documentation Archive
1.0.1 Jun 25, 2017 Go to the documentation of search_bar 1.0.1 Download search_bar 1.0.1 archive
1.0.0 Jun 25, 2017 Go to the documentation of search_bar 1.0.0 Download search_bar 1.0.0 archive

Analysis

We analyzed this package on Jun 19, 2018, and provided a score, details, and suggestions below. Analysis was completed with status completed using:

  • Dart: 2.0.0-dev.63.0
  • pana: 0.11.3
  • Flutter: 0.5.4

Scores

Popularity:
Describes how popular the package is relative to other packages. [more]
63 / 100
Health:
Code health derived from static analysis. [more]
80 / 100
Maintenance:
Reflects how tidy and up-to-date the package is. [more]
99 / 100
Overall score:
Weighted score of the above. [more]
75
Learn more about scoring.

Platforms

Detected platforms: Flutter

References Flutter, and has no conflicting libraries.

Suggestions

  • Fix analysis and formatting issues.

    Analysis or formatting checks reported 1 error 1 hint.

    Strong-mode analysis of lib/src/search_bar_base.dart failed with the following error:

    line: 101 col: 13
    The named parameter 'hideDivider' isn't defined.

Dependencies

Package Constraint Resolved Available
Direct dependencies
Dart SDK >=1.20.1 <2.0.0
flutter 0.0.0
meta ^1.0.5 1.1.5
Transitive dependencies
collection 1.14.6 1.14.10
sky_engine 0.0.99
typed_data 1.1.5
vector_math 2.0.6 2.0.7
Dev dependencies
test ^0.12.0