any_syntax_highlighter
any_syntax_highlighter is a lightweight 'convention based' syntax highlighter which provides highlighting to input text code.
Features
- add custom keywords or use default ones
- convention based highlighting
- identifiers starting with uppercase are considered as class/constructor
- Class.abc => static variable
- three types of comments are supported
- single line comment staring with #
- single line comment starting with //
- multiline comment /*.....*/
- identifier starting with _ => private
- functions after . operator => method (highlighting for function and method are different)
- Use google fonts! (Thanks to google_fonts library)
Note: boxDecoration has been changed to decoration since v0.0.12
Getting started
import package-
import 'package:any_syntax_highlighter/any_syntax_highlighter.dart';
The above image contains McLaren font provided by google_fonts.
Usage
Basic usage
AnySyntaxHighlighter(
'''Class Main{
public static void main(String args[]){
}
}'''
)
Usage with optional fields
AnySyntaxHighlighter(
'#your code goes here',
fontSize: 16,
lineNumbers: false, // by default false
theme: AnySyntaxHighlighterThemeCollection.githubWebTheme(), // you can create and pass custom theme using AnySyntaxHighlighterTheme class
isSelectableText: true, // this creates a SelectableText.rich() widget, makes text selectable (by default false)
useGoogleFont: 'Lato',
copyIcon: const Icon(Icons.copy_rounded,color:Colors.black),// default is white colored icon
hasCopyButton: true,// by default false
/* other options are:-
padding,
margin,
textAlign,
this.textDirection,
softWrap,
overflow,
textScaleFactor,
maxLines,
locale,
strutStyle,
textWidthBasis,
textHeightBehavior,
overrideDecoration
*/
)
Using Google Fonts
You can add any of the google fonts available in google_fonts library. Just pass a string name of google font you want to use to useGoogleFont property
AnySyntaxHighlighter(
'// google fonts usage demo',
useGoogleFont: 'Lato'
)
Don't forget to add appropriate License for the font you are using for more details read google_fonts documentation.
packages,classes and their definition
package/classes | definition |
---|---|
AnySyntaxHighlighter | Widget that provides highlighting |
AnySyntaxHighlighterBaseTheme | super class of AnySyntaxHighlighterTheme no use case for user |
AnySyntaxHighlighterTheme | for making custom themes you can use this class and pass it to theme option of widget |
AnySyntaxHighlighterThemeCollection | collection of default themes provided by this package |
RegexCollection | collection of regular expression strings used to tokenize the input code, no or less use case for user |
Token | token class for internal usage only |
Additional information
Open for contribution, specially if you can create themes using our web tool AnySyntaxHighlighterThemeLab For themes you need not necessarily need to raise an issue just build the theme, make sure you do these things:-
- your made changes to any_syntax_highlighter_theme_collection.dart file only
- you have dart formatted your code before making pull request
If you find any bug/suggestion feel free to raise an issue on github repository.