flutter_tags

Description:

flutter tags

flutter_tags #



Create beautiful tags quickly and easily.
Installing #
Add this to your package's pubspec.yaml file:
dependencies:
flutter_tags: "^0.4.9+1"
copied to clipboard
DEMO #












Simple usage #

import 'package:flutter_tags/flutter_tags.dart';
.
.
.
List _items;
double _fontSize = 14;

@override
void initState(){
super.initState();
// if you store data on a local database (sqflite), then you could do something like this
Model().getItems().then((items){
_items = items;
});
}

@override
Widget build(BuildContext context) {
return Tags(
key:_tagStateKey,
textField: TagsTextField(
textStyle: TextStyle(fontSize: _fontSize),
constraintSuggestion: true, suggestions: [],
//width: double.infinity, padding: EdgeInsets.symmetric(horizontal: 10),
onSubmitted: (String str) {
// Add item to the data source.
setState(() {
// required
_items.add(str);
});
},
),
itemCount: _items.length, // required
itemBuilder: (int index){
final item = _items[index];

return ItemTags(
// Each ItemTags must contain a Key. Keys allow Flutter to
// uniquely identify widgets.
key: Key(index.toString()),
index: index, // required
title: item.title,
active: item.active,
customData: item.customData,
textStyle: TextStyle( fontSize: _fontSize, ),
combine: ItemTagsCombine.withTextBefore,
image: ItemTagsImage(
image: AssetImage("img.jpg") // OR NetworkImage("https://...image.png")
), // OR null,
icon: ItemTagsIcon(
icon: Icons.add,
), // OR null,
removeButton: ItemTagsRemoveButton(
onRemoved: (){
// Remove the item from the data source.
setState(() {
// required
_items.removeAt(index);
});
//required
return true;
},
), // OR null,
onPressed: (item) => print(item),
onLongPressed: (item) => print(item),
);

},
);
}

final GlobalKey<TagsState> _tagStateKey = GlobalKey<TagsState>();
// Allows you to get a list of all the ItemTags
_getAllItem(){
List<Item> lst = _tagStateKey.currentState?.getAllItem;
if(lst!=null)
lst.where((a) => a.active==true).forEach( ( a) => print(a.title));
}
copied to clipboard
Wrapped widget example #
You are free to wrap ItemTags () inside another widget
Tags(
itemCount: items.length,
itemBuilder: (int index){
return Tooltip(
message: item.title,
child:ItemTags(
title:item.title,
)
);
},
);
copied to clipboard
Tags() parameters #



PropName
Description
default value




columns
Possibility to set number of columns when necessary
null


itemCount
Tag number to display
required


symmetry
Ability to view and scroll tags horizontally
false


horizontalScroll
Offset drawer width
0.4


heightHorizontalScroll
height for HorizontalScroll to set to display tags correctly
60


spacing
Horizontal space between the tags
6


runSpacing
Vertical space between the tags
14


alignment
Horizontal WrapAlignment
WrapAlignment.center


runAlignment
Vertical WrapAlignment
WrapAlignment.center


direction
Direction of the ItemTags
Axis.horizontal


verticalDirection
Iterate Item from the lower to the upper direction or vice versa
VerticalDirection.down


textDirection
Text direction of the ItemTags
TextDirection.ltr


itemBuilder
tag generator



textField
add textField
TagsTextFiled()



ItemTags() parameters #

index - required
title - required
textScaleFactor - custom textScaleFactor
active - bool value (default true)
pressEnabled - active onPress tag ( default true)
customData - Possibility to add any custom value in customData field, you can retrieve this later. A good example: store an id from Firestore document.
textStyle - textStyle()
alignment - MainAxisAlignment ( default MainAxisAlignment.center)
combine - * ability to combine text, icons, images in different ways ( default ItemTagsCombine.imageOrIconOrText)*
icon - ItemTagsIcon()
image - ItemTagsImage()
removeButton - ItemTagsRemoveButton()
borderRadius - BorderRadius
border - custom border-side
padding - default EdgeInsets.symmetric(horizontal: 7, vertical: 5)
elevation - default 5
singleItem - default false
textOverflow - default TextOverflow.fade
textColor - default Colors.black
textActiveColor - default Colors.white
color - default Colors.white
activeColor - default Colors.blueGrey
highlightColor -
splashColor -
colorShowDuplicate - default Colors.red
onPressed - callback
onLongPressed - callback
onRemoved - callback

Donate #
It takes time to carry on this project. If you found it useful or learned something from the source code please consider the idea of donating 5, 20, 50 € or whatever you can to support the project.



Issues #
If you encounter problems, open an issue. Pull request are also welcome.