# flutter_widgets

**Repository Path**: zhuyunjiandull/flutter_widgets

## Basic Information

- **Project Name**: flutter_widgets
- **Description**: 我的flutter_widgets
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2023-09-01
- **Last Updated**: 2023-10-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# flutter_widgets

自定义控件.

## Getting Started

## add dependency in `pubspec.ymal`

远程依赖
``` yaml
  flutter_widgets:
    git:
      url: git@github.com:BrainCoTech/flutter_modules.git
      path: packages/flutter_widgets/
```

本地调试
```
  flutter_widgets:
    path: ../flutter_modules/packages/flutter_widgets/
```

## sample
参考目录lib/sample/内代码

## using
编写控件主题样式，flutter原生已经提供了丰富的主题样式`ThemeData`，编写自定义控件时优先从`ThemeData`中获取，如果存在冲突或者缺失的样式则添加到`WidgetThemeData`中。

使用`WidgetThemeData`
``` dart
class WidgetsSample extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return WidgetTheme(
      data: Themes.widgetThemeData,
      child: MaterialApp(
        theme: Themes.appTheme,
        home: MyHome(),
      ),
    );
  }
}

class Themes {
  static final widgetThemeData = WidgetThemeData(
      buttonStyle: ButtonStyle(
        //...
      ),
      editableTileStyle: EditableTileStyle(
        //...
      ),
      // ...
  );
  
  static final appTheme = ThemeData(
  // ...
  );
}
```

## Features
* 按钮
  * CommonFlatButton 文字按钮
  * CommonOutlineButton 描边按钮
  * CommonRaisedButton 按钮有颜色背景，可以指定点击状态，默认状态下的按钮高度 elevation
* CommonAppBar
  * 支持自定义返回按钮，默认使用`Icons.chevron_left`
  * title样式从 `ThemeData.appBarTheme.textTheme.title`获取
* CommonImage
  * 支持svg和其他图片格式
* CommonProgressIndicator： 圆形loading控件，支持设置宽度，大小，颜色
* dialogPicker iOS风格的选择器
* EmptyView 空态页，支持设置空态图片，文字，展示的位置alignment
* HighlightedText 匹配到的文字用红色高亮，支持设置高亮样式，常用于搜索结果展示
* MediaPreview 多个图片/视频的预览，支持删除功能
* showCustomSearch 搜索，原生的搜索输入框无法自定义decoration，基于原生修改
* Toast 支持文字样式和带icon样式
* VideoPlayer 视频播放器
* WidgetTheme 控件自定义主题样式
* 列表Item
  * CustomListTile
  * editable_tile_models
    * EditTextTileModel 可编辑条目
    * DateTileModel 日期选择条目
    * PickerTileModel 选择器条目
    * MediaTileModel 图片/视频条目