jars

Description:

jars

JARS






Leave a 👍 like if you like it


JARS is a super-effective and lightweight solution for Flutter. It combines front-end flutter widgets, intelligent dependency injection, and provider solutions like. DateTimeApis, DateTimeFormat, DateTimeLang, Timeago, PlatformQuery, showRTost, removeRTost, showRSnackBar, removeRSnackBar, printInfo, printError, JMarquee, JTextPlus


How to install #


See how to use #


Supported platforms: Android | iOS | Web | MacOs | Windows | Linux #


JTextPlus #
As we all know, text is a key component of any mobile app's user interface. and it is fustrating to use Text or RichText Widget to create attractive text. Now you no longer need to define multiple TextStyle for attractive text thanks to JTextPlus' simple solution for text decoration. You'll save time and get fantastic results with JTextPlus.

How to Use
JTextPlus(
text,
style: const TextStyle(
fontSize: 25, color: Colors.white, letterSpacing: 1.5),
jTextStyles: rules2,
);
copied to clipboard
JMarquee #
A Flutter widget that scrolls text infinitely. Provides many customizations including custom scroll directions, durations, curves as well as pauses after every round.



JMarquee(
maxHeight: 50,
scrollAxis: Axis.horizontal,
accelerationCurve: Curves.fastLinearToSlowEaseIn,
pauseAfterRound: 3.seconds,
blankSpace: 10,
velocity: 100,
child: const FlutterLogo(
size: 100, style: FlutterLogoStyle.horizontal),
),
JMarquee(
maxHeight: 50,
blankSpace: 50,
child: JTextPlus(
'<r>JMarquee</r> is a flutter widget that scrolls widget infinitely.',
jTextStyles: [JTextStyle('r', color: Colors.red)]),
)
copied to clipboard
RToast & RSnackBar #
With RSnackBar and RToast it is now easier than ever to show a little notification to the user. It may appear on the screen in any direction, including the top, bottom, center, and so on.

In the true sense of RToast & RSnackBar, you can call it whenever you need it, without any restrictions!
Feature-rich, support for displaying notifications, text, loading, attachments, etc. RToast & RSnackBar
Support for popping up various custom RToasts & RSnackBars, or you can pop up any Widget as long as it meets the requirements of the flutter code.
API is simple and easy to use
Pure flutter implementation




// RTost Demo
OutlinedButton(
onPressed: () => showRTost(context,
msg: '👋 Hi i am form top center.',
config: RToastConfig(alignment: Alignment.topCenter)),
child: const Text('TOP CENTER'),
);

// RSnackBar Demo
simpleTile('Simple Loading Snackbar',
onPressed: () =>
showRSnackBar(context, config: RSnackbarLoadingConfig('Loading')),
onDismissed: () => removeRSnackBar()),

copied to clipboard
DateTime APIs #
Most popular datetime apis are:

DateTimeFormat
DateTimeLang
Timeago

DateTimeFormat #
The user can choose from a variety of standard date and time formats as well as a particular customised pattern. Additionally, by using Datetimelang, the user can specify a local language, such as Hindi, Punjabi, Chines, etc.
Example

var now = DateTime.now();

// default code = 'en'(English)
var datedef = DateTimeFormat(now);

// code = 'hi'(Hindi)
var datehi = DateTimeFormat(now, lang: DateTimeLang.hi);

// 1st
print(datedef.yMMMEd());
print(datedef.yMMMEd(isFull: true));

// 2st
print(datehi.yMMMd());
print(datehi.yMMMd(isFull: true));


Output _________________________
|
| Oct 30, 2022
| Saturday, June 10, 2012
|
| शनि, जून 10, 2012
| शनिवार, जून 10, 2012
|_______________________________
copied to clipboard



Pattern

Result




yM()
->
10/2022


yMd()
->
10/30/2022


yMEd()
->
Sun, 10/30/2022


yMEd(isFull: true)
->
Sunday, 10/30/2022


yMMM()
->
Oct 2022


yMMM(isFull: true)
->
October 2022


yMMd()
->
30 Oct 2022


yMMd(isFull: true)
->
30 October 2022


yMMMd()
->
Oct 30, 2022


yMMMd(isFull: true)
->
October 30, 2022


yMMMEd()
->
Sun, Oct 30, 2022


yMMMEd(isFull: true)
->
Sunday, October 30, 2022


yQQQ()
->
Q4 2022


yQQQ(isFull: true)
->
4th quarter 2022


hm()
->
02:37


hm()
->
2:37 AM


hms()
->
02:37:31


hms(isFull: true)
->
2:37:31 AM



DateTimeLang #
For more control over datetime language you may can create your own JSON file, load it into the datetimelang api, and then set it as a default language.

/// **Load file locally **
await DateTimeLang.loadFromFile(CODE: 'fr', path: 'lib/assets/fr.json');

/// **Load file form Url**
//
/// Under the hood, **English & Hindi** are already available.
///
/// Chinese (zh-CN): https://datetimelangs-default-rtdb.asia-southeast1.firebasedatabase.app/zh-CH.json
///
/// French (fr): https://datetimelangs-default-rtdb.asia-southeast1.firebasedatabase.app/fr.json
///
/// Afrikaans (af): https://datetimelangs-default-rtdb.asia-southeast1.firebasedatabase.app/af.json

await DateTimeLang.loadFromUrl(
CODE: 'zh-CH',
url:'https://datetimelangs-default-rtdb.asia-southeast1.firebasedatabase.app/zh-CH.json');


// Now that you have both languages, choose a default language.
DateTimeLang.setDefaultLang('zh-CH');

var now = DateTimeFormat(DateTime.now());
print(now.yMMMd(isFull: true));

// To make it straightforward and appealing, you can,
// however, directly access the format() function.
print(DateTime.now().format().yMMM());


Output _________________________
|
| 十一月 10, 2022
| 十一月 2022
|_______________________________

copied to clipboard
Timeago #
Timeago is a dart library that converts a date into a humanized text. Instead of showing a date 2020-12-12 18:30 with timeago you can display something like "now", "an hour ago", "~1y", etc. By default Timeago ONLY support 'en' and 'hi' code(language code).To add more of the supported languages use DateTimeLang class

var oldDateTime = DateTime(2012, 6, 10);
var t1 = Timeago.since(oldDateTime);
var t2 = Timeago.since(oldDateTime, code: 'hi');

// en
print(t1.format());
print(t1.format(isFull: true));
print(t1.format(isFull: true, yearFormat: (p0) => p0.yMMMEd()));
print(t1.format(isFull: true, yearFormat: (p0) => p0.yMMMEd(isFull: true)));

// hi
print(t2.format());
print(t2.format(isFull: true, yearFormat: (p0) => p0.yMMMEd()));
print(t2.format(isFull: true, yearFormat: (p0) => p0.yMMMEd(isFull: true)));


Output _________________________
|
| 10 Yr ago
| 10 Years ago
| Sat, Jun 10, 2012
| Saturday, June 10, 2012
|
| 10 वर्षों पूर्व
| शनि, जून 10, 2012
| शनिवार, जून 10, 2012
|_______________________________
copied to clipboard
DateTime APIs Extension #

var today = DateTime.now(); // Create an Object

// now you can use operator like -, *, +, /, >=, <, >
var yesterday = DateTime.now() - Duration(days: 2);
var duration=Duration(hours: 2, minutes: 3, seconds: 2) // Create an Object

// Whether this time of day is before or after noon.
// return DayPeriod.am | DayPeriod.pm;
today.period;

/// Which hour of the current period (e.g., am or pm) this time is.
///
/// For 12AM (midnight) and 12PM (noon) this returns 12.
today.hourOfPeriod ;

/// The hour at which the current period starts.
today.periodOffset;


/// Equal to: (month / 4).round();
/// eg. (6/4).round() = 2
today.quarter;

/// Example:
// yMEd()=> Sun, 10/30/2022
// yMEd(isFull: true) => Sunday, 10/30/2022
today.format('/').yMEd();

// 2 Days ago
yesterday.timeagoSince();

// 2 Hours ago
duration.timeagoSince();
// 02:03:02
duration.hms();

// Equal to: (duration.inMonths / 12).round();
duration.inYears;
// Equal to:(duration.inDays / 30.4167).round();
duration.inMonths;
// Equal to: (duration.inDays / 7).round();
duration.inWeeks;

// Equal to: Future.delayed(duration);
duration.delay();

copied to clipboard
PlatformQuery APIs #
/// Device's Orientation
/// Similar to MediaQuery.of(context).orientation;
PlatformQuery.orientation;

// Platform display/screen Height
// Equivalent to : MediaQuery.of(context).size.height,
// but immutable.
PlatformQuery.height;


// Platform display/screen Width
// Equivalent to : MediaQuery.of(context).size.height,
// but immutable.
PlatformQuery.width

// The aspect ratio of platform display/screen size.
// Equivalent to : MediaQuery.of(context).aspectRatio,
// but immutable.
PlatformQuery.aspectRatio

// Platform display/screen Pixel Ratio
// Equivalent to : MediaQuery.of(context).pixelRatio,
// but immutable.
PlatformQuery.pixelRatio

/// Respective percentage of the viewport's smaller dimension.
20.vmin;

/// Respective percentage of the viewport's larger dimension.
20.vmax;

/// Calculates the height depending on the device's screen size
20.h; // -> will return 20% of the screen's height

/// Calculates the width depending on the device's screen size
20.w // -> will return 20% of the screen's width

/// Calculates the sp (Scalable Pixel) depending on the device's pixel
/// density and aspect ratio
14.sp // general use for fontsize

/// Calculates the material dp (Pixel Density)
/// (https://material.io/design/layout/pixel-density.html#pixel-density-on-android))
16.dp // generally use for font, image and icons size.

//Check in what platform the app is running
PlatformQuery.isAndroid
PlatformQuery.isIOS
PlatformQuery.isMacOS
PlatformQuery.isWindows
PlatformQuery.isLinux
PlatformQuery.isFuchsia

//Check the device type
PlatformQuery.isMobileorTablet
PlatformQuery.isDesktop

// Return an current platform, any one of them
// web,
// android,
// fuchsia,
// iOS,
// linux,
// macOS,
// windows
PlatformQuery.activePlatform

/* [Window size](https://medium.com/@rahulsharmadev/responsive-design-theory-b8f18b257295)
Window size classes categorize the display area available to your app as compact,medium, or expanded. Available width and height are classified separately,so at any point in time, your app has two window size classes — one for width, one for /height. */
//
// Retun any one of them { compact, medium, expanded }
PlatformQuery.activeWindowSize

/// How to use?
/// -------------------------------
/// PlatformQueryBuilder(
/// builder: (ctx) {
/// String string =
/// 'Hello <${TextStyle(color: Colors.red, fontSize: 20.sp,
/// backgroundColor: Colors.orange).toTextPlusStyle} = "World 😂"> I am hear.';
/// return TextPlus(string);
/// },
/// ),
/// );
///--------------------------------
/// **Recommendation to use it LESS**
PlatformQueryBuilder(builder: (context) {
return Widget;
});

copied to clipboard
How to contribute #
Want to contribute to the project? We will be proud to highlight you as one of our collaborators.
Here are some points where you can contribute and make Get (and Flutter) even better.

Adding documentation to the readme (a lot of Jars features haven't been documented yet).
Write articles or make videos teaching how to use Jars.
Including new functions class.

Any contribution is welcome!