# gap 3.0.1

Flutter widgets for easily adding gaps inside Flex widgets such as Columns and Rows or scrolling views.




## Installing
```
export PUB_HOSTED_URL=https://pub.mirror.p-hatan.com
flutter pub add gap
```
Published: 2023-06-24T09:22:05.766623Z
Expected archive SHA-256: f19387d4e32f849394758b91377f9153a1b41d79513ef7668c088c77dbc6955d

Available in cache; verification: upstream_checksum
## Direct dependencies
- flutter: map[sdk:flutter]

## Package README (untrusted upstream documentation)
# Gap
Flutter widgets for easily adding gaps inside Flex widgets such as Columns and Rows or scrolling views.

[![Pub](https://img.shields.io/pub/v/gap.svg)](https://pub.dartlang.org/packages/gap)

### Introduction

When it comes to add empty space between widgets inside a `Column` or a `Row`, we have multiple options:
- We can either add a `Padding` around these widgets but it's very verbose
- Or we can add `SizedBox` widgets between them.

`Gap` is another option. It's like `SizedBox` but you don't have to know if it's inside a `Row` or a `Column`. So that it's less verbose than using a `SizedBox`.

## Getting started

In your library add the following import:

```dart
import 'package:gap/gap.dart';
```

Then you just have to add a `Gap` inside a `Column` or a `Row` with the specified extent.

```dart
return Column(
  children: <Widget>[
    Container(color: Colors.red, height: 20),
    const Gap(20), // Adds an empty space of 20 pixels.
    Container(color: Colors.red, height: 20),
  ],
);
```

The `Gap` widget also works inside `Scrollable` widgets such as `ListViews`. In these cases, it will occupy the space in the same direction as the `Scrollable`.

### MaxGap

This package also comes with a `MaxGap` widget.
The `MaxGap` widget will try to fill the available space in a `Column` or a `Row` with the specified size. If the available space
is lesser than the specified size, the `MaxGap` widget will only take the available space.

It's useful when you want to have a gap that shrinks to avoid an overflow otherwise.


### Other parameters

By default a `Gap` will have no extent in the opposite direction of the `Flex` parent.
If you want the `Gap` to have a color, you'll have to set the `color` and the `crossAxisExtent` parameters.
You can also use the `Gap.expand` constructor to expand the `Gap` in the opposite direction of the `Flex` parent.

### SliverGap

There is also a Sliver version of the `Gap` widget:

```dart
return CustomScrollView(
  slivers: <Widget>[
    const SliverGap(20), // Adds an empty space of 20 pixels.
  ],
);
```

## Changelog

Please see the [Changelog](https://github.com/letsar/gap/blob/master/CHANGELOG.md) page to know what's recently changed.

## Contributions

Feel free to contribute to this project.

If you find a bug or want a feature, but don't know how to fix/implement it, please fill an [issue](https://github.com/letsar/gap/issues).  
If you fixed a bug or implemented a feature, please send a [pull request](https://github.com/letsar/gap/pulls).


## Changelog
## 3.0.1
### Changed
- Remove the usage of AbstractNode so that it can be used in 3.12.0-8.0.pre.21 (See https://github.com/letsar/gap/issues/16)

## 3.0.0
### Changed
- Set minimum Flutter version to 3.7.0

## 2.0.2
### Fixed
- Use Scrollable.maybeOf instead of Scrollable.of

## 2.0.1
### Fixed
- Issue with Scrollable.of in master channel

## 2.0.0
### Added
- Null safety

## 1.2.0
### Added
- Compatibility with `Scrollable` widgets (such as `ListViews`).

## 1.1.1
### Fixed
- Typo in Readme.

## 1.1.0
### Added
- `SliverGap` the sliver version of `Gap`.

## 1.0.1
### Fixed
- Fix debug properties in `Gap` widget.

## 1.0.0
- Initial Open Source release.