MCPcopy Create free account
hub / github.com/DevsOnFlutter/draggable_home

github.com/DevsOnFlutter/draggable_home @v1.0.5

Chat with this repo
repository ↗ · DeepWiki ↗ · release v1.0.5 ↗ · + Follow
47 symbols 61 edges 17 files 9 documented · 19% updated 13mo agov1.0.5 · 2023-09-28★ 17711 open issues

Browse by type

Functions 40 Types & classes 7
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Draggable Home

A draggable Flutter widget that makes implementing a Sliding up and fully-stretchable much easier! Based on the Scaffold and Sliver.

Example Example Example

Usage

Make sure to check out examples for more details.

Installation

Add the following line to pubspec.yaml:

dependencies:
  draggable_home: ^1.0.2

Basic setup

The complete example is available here.

DraggableHome requires you to provide title, headerWidget and body: * title widget is basically for a title in the AppBar. For no title in AppBar, simply pass an empty Container. * headerWidget is the expanded widget just above the body when not fully expanded. * body is in the form of Column which requires a list of widget or a widget. Do not add any vertically scrollable widget or you may just disable the scroll.

  physics: const NeverScrollableScrollPhysics()

Sample code

DraggableHome(
  title: Text("Title"),
  headerWidget: headerWidget(),
  body: [
    Container(...),
    (...),
  ]
);

Arguments

There are several options that allow for more control:

Properties Description
leading A widget to display before the toolbar's title.
action A list of Widgets to display in a row after the title widget.
drawer Drawers are typically used with the Scaffold.drawer property.
centerTitle Allows toggling of title from the center. By default, title is in the center.
headerExpandedHeight Height of the header widget. The height is a double between 0.0 and 1.0. The default value of height is 0.35 and should be less than stretchMaxHeight
headerWidget A widget to display Header above the body.
alwaysShowLeadingAndAction This makes Leading and Action always visible. Default value is false.
headerBottomBar AppBar or toolBar like widget just above the body.
backgroundColor The color of the Material widget that underlies the entire DraggableHome body.
physics The physics property determines how the scroll view responds to user input, such as how it continues to animate after the user stops dragging the scroll view.
scrollController Used to control the position to which this scroll view is scrolled
curvedBodyRadius Creates a border top-left and top-right radius of body, Default radius of the body is 20.0. For no radius simply set the value to 0.
fullyStretchable Allows toggling of fully expand draggability of the DraggableHome. Set this to true to allow the user to fully expand the header.
stretchTriggerOffset The offset of overscroll required to fully expand the header.
expandedBody A widget to display when fully expanded as header or expandedBody above the body.
stretchMaxHeight Height of the expandedBody widget. The height is a double between 0.0 and 0.95. The default value of height is 0.9 and should be greater than headerExpandedHeight
bottomSheet A persistent bottom sheet shows information that supplements the primary content of the app. A persistent bottom sheet remains visible even when the user interacts with other parts of the app.
bottomNavigationBarHeight This is required when using custom height to adjust body height. This makes no effect on bottomNavigationBar.
bottomNavigationBar Snack bars slide from underneath the bottom navigation bar while bottom sheets are stacked on top.
floatingActionButton A floating action button is a circular icon button that hovers over content to promote a primary action in the application.
floatingActionButtonLocation An object that defines a position for the FloatingActionButton based on the Scaffold's ScaffoldPrelayoutGeometry.
floatingActionButtonAnimator Provider of animations to move the FloatingActionButton between FloatingActionButtonLocations.

Sample code for ListView.builder

DraggableHome(
  title: Text("Title"),
  headerWidget: headerWidget(),
  body: [
    Container(...),

    // shrinkWrap true required for ListView.builder()
    // disable the scroll for any vertically scrollable widget
    // provide top padding 0 to fix extra space in listView
    ListView.builder(
      padding: EdgeInsets.only(top: 0),
      physics: NeverScrollableScrollPhysics(),
      shrinkWrap: true,
      itemCount: list.length,
      itemBuilder: (context, index) => Card(
        child: ListTile(
          title: Text("$index"),
        ),
      ),
    ),

    (...),
  ]
);

Example Example Example

Show some :heart: and :star: the repo

GitHub followers GitHub followers

Contributions

Contributions are welcome!

If you feel that a hook is missing, feel free to open a Pull Request.

For a custom hook to be merged, you will need to do the following:

  • Describe the use case.

  • Open an issue explaining why we need this hook, how to use it, ... This is important as a hook will not get merged if the hook doesn't appeal to a large number of people.

  • If your hook is rejected, don't worry! A rejection doesn't mean that it won't be merged later in the future if more people show an interest in it. In the meantime, feel free to publish your hook as a package on https://pub.dev.

  • A hook will not be merged unless fully tested, to avoid breaking it inadvertently in the future.

Core symbols most depended-on inside this repo

Shape

Method 25
Function 15
Class 7

Languages

C++98%
Kotlin2%

Modules by API surface

example/windows/runner/win32_window.cpp21 symbols
example/linux/my_application.cc7 symbols
example/windows/runner/win32_window.h5 symbols
example/windows/runner/flutter_window.cpp5 symbols
example/windows/runner/utils.cpp3 symbols
example/windows/runner/main.cpp1 symbols
example/windows/runner/flutter_window.h1 symbols
example/windows/flutter/generated_plugin_registrant.cc1 symbols
example/linux/main.cc1 symbols
example/linux/flutter/generated_plugin_registrant.cc1 symbols
example/android/app/src/main/kotlin/com/example/example/MainActivity.kt1 symbols

For agents

$ claude mcp add draggable_home \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page