From 646e022cd7b23170bcb64a885cd5fb0fc59d5a1a Mon Sep 17 00:00:00 2001 From: David <8vsxdxd@gmail.com> Date: Wed, 23 Sep 2020 10:22:29 +0200 Subject: [PATCH] Update README.md --- README.md | 47 ++++++++++++++++++++++++++++-- example/demo_gif/demo_dismiss.gif | Bin 0 -> 179498 bytes 2 files changed, 45 insertions(+), 2 deletions(-) create mode 100644 example/demo_gif/demo_dismiss.gif diff --git a/README.md b/README.md index b3abdfb..dc88587 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,9 @@ [![Pub](https://img.shields.io/pub/v/miniplayer?color=2196F3)](https://pub.dev/packages/miniplayer) -A **lightweight** flutter package to simplify the creation of a miniplayer by providing a builder function with the current height and percentage progress. The widget responds to tap and drag gestures and is highly customizable. +A lightweight flutter package to simplify the creation of a miniplayer by providing a builder function with the current height and percentage progress. The widget responds to tap and drag gestures and is highly customizable. +**What is a miniplayer?** +Miniplayers are commonly used in media applications(e.g. Spotify, Youtube). A miniplayer can be expanded and minified and remains on the screen when minified until dismissed by the user. +See the demo below for an example. ## Demo @@ -19,7 +22,47 @@ Miniplayer( }, ), ``` -#### Usage without BottomNavigationBar + +##Options + +
onDismiss | +
+
+Miniplayer(
+ onDismiss: () {
+ //If onDismiss is set,
+ //the miniplayer can be dismissed
+ //Handle onDismissed here e.g.
+ },
+),
+
+ |
+ + + | +
onDismiss | +
+
+ Miniplayer(
+ onDismiss: () {
+ //If onDismiss is set,
+ //the miniplayer can be dismissed
+ //Handle onDismissed here e.g.
+ },
+ ),
+
+ |
+ + + | +
bM}5Km?5yd|ma2>VvQEs`pB#a9AEG?R(|-gfMuCvi@{Qx=06Yhtp!yEn0r81m z9^5|Ec&7S9cOYIL5vo8P>Q=pJv+q{WF-;QGnSy{6B<_h1(D76)8fER%C%FBt{<**Z zbGEpkgUtG^5MC+D`dF;6L9DU^4S(|$Rf3U#*IL_hQw<##!cF19AL+pR0E6_yAbmuQ z-Y`f!AjEwf0!QGyFaVVuf{fsAS8^9IeEdv|yj1CT7|^G3fjbIfD$GB2o?ClmM9xp1 zyOajtp=g}oU_7_?m0dg&M)7#>dD`k;KtFVVQh0FeHqPzovGV}faD%5pQ7P&4ka0cp z?IlmAy3+A8@H1z5SkUE`;E~mrorAldCdYFQefFdDzAkF7YasZy&BwRCHl0KZEq9rA zap@hh81%L$-T>SX0Jf1jj!`YhPaP)+b?t|`2!LS_&^744zv(OaBN=-+YUU!pznsPW zgN3e8J?gBK(|WiAN{K$R&ucQ*>dTEEQRzv4s97HV&QuvRh%_O`))%VMWfRE}|$ ziU~5UvtW3tvonHzBo~flUH+}*JfE*U6c^btpji(a$uz;;h)gvbjw@0tF RTICQgTCEHf8a5iK*qqD7+oC!dsaj>GcPYCe?j3cKie z6X3!AbF9$Np=6tojKU1{XRD0t5q(oGQUotg4yA~su%cR+9rE!?hWJ|tL`szhrPHl3 z-E1fvBPeAv%yWIC$sZvHp_OtG6IN-KJ{d(1l&GS3gw{ED31Zjru;LZi_nxUr8Zj !L7C0<}u;NAL8WZoiswAa~7yDXIYhJiyDzM;0jA<_;TvP#D z(#JabmT$dgI^E?9TcTo7<}6$WMe>CD>XdyM;#~N9eG(-GER@!zPvR=9(mwZ67-TB+ zky)f>gugSiP}p3M^)0Y6-snk}O|%bLP1X7-7N;p0QauNHsMGcnFG?bj#{$ajFJMn3 zWk>1*3&9n{dr0>%A}n97S)D>TXyj!C()yy6<?!t-?d?9aNBj@BBo>Gl_kMH%{$ z8AW7i*2gmn%&ZC##-7t7-)ur=HauUnKI07|ro_C)O{Um9T*KD@|6#D}GJYdv7g~_! z>rlSuj7D%I$!0v(aJ(>PvCK#r^vrau%IN!IXY)jMQX%Cgjl!^r6Fd(eL-1sHK3Vm# zY`<)Ok^ai}_>!1dh|y3a%7T7fsUp~7Q3uHLtSccBe- t#z-t{=X?~7}V4hxm*G=6oGeYC;nH2JpPmgh>N(=87?js*kPmAakR6J*jp zJL}*R+EPSyec@+X<>2_@O8~ezTus`g)H5fbWBcWQv_-YAmtR0b6n?$e){(u+ML!pN zi Fl>FmGD3=Og~)=7 zpRPxn2h{t76NtYRg4crJ&L7Dms)l8fLwP|oNAPE2@HG fRYX hv9s|!4X-Y)0y=JOB z`8YX3F7_GV=CLJr08WQQEP@o|8Nrhu-Y;Ce=iC}f){tHH(yBC$jB{#bc}G{`0ot7- z%xXcOj@=DMnuV44@oZ1F`!+yJ7$0buJwPIjAtjus3DOS3BK>HK$s|(6*oZZSuX9TL znu^}Mg+!c{xUu%RNV2NzAueSxPm;3a!8_t2HcE}oP*|LefmMqx&34lVgW>q6J>wC4 zpYt1*Muu$=(wfX{Z(HrR;u4*K**IC9P-Xwl2T!#ha86~2M!2}3o*TcVEBzH7utyXn z%E7F5m{B9STZ@aC uTJ?4YR9AWp!XLc4+M+y%D>*>)c$~nM? z4`DJGi#5q)tE_l)WiQGfenWu=cC1O~i3$Y2Rfu8z);GB}EK8DvtnW@e6S@+9C-c|@ zz511(qYed{+tU&TG99Id6~3;2YCJ8j$4FimGnr>WA~F)G_Sm+!#2$uv_~#elO>Oik zXeBxq|Ht&Gp7fEhSJVRMmJXpXz<=i>#-ydIw7H+z&8P!Zm_o(b@_Wbp9%rHREy-J7 zEzH#w7n7q889#)!o_r}EQXmz6dMx<>8-pvlnL=WRv> @HX2>`Ol z+fCH!J;1A6i&pgOiB?dKWTxWuz;MQ eFz& zw6&x;t!hckDqOE6c_ZurS2Fp!Vq#qIFt|dUkAnkGt^;%AQF|oarnuOlf;KP#(Ppy)8B77)MtsQJ>)+lC#wQeq`9=PQ+!9%9OFBl1Kqqd<>L zC+*4GM!i S%x#C+Bf2+tkyr3yb2Im3wbk?VMuU{jY+PO$4lfO#=)VPl>7SV==)EGopc{j zX^Rr0rO>$^KS>SVH@(+F{nqbVgyWcSe#Ir|<)#YgMQ7V{bj?==YM}WPS#ix#ysJe8 zUJ*T2NpE)EED@J9p#|%r#lzO9blRW26{ex)eSNiTpv!Z#Pjm2vfmQ4Kh13drQWPgo zH^ovQA -Ce5JOI+jumZ-_Zl)Z-T( 3|6vJiT_4_VN@7$jWDQj0nYvaYR+*$ zmChzS3*^00UJR#vJFqQoy6nDgWpP|Zhs`!mguQ^qASD;$U?V_3jeUT?BuPKK#U9=F z7-BWMtPSb)liV+R^5%{zQy*O6JQ}?k%1GRU2L7qwM)EralLie)KdR2V<+P&NTzJKF zIfO=vThWkkq61jY4#W3Cb0Dnamq)kgpwJgkF`R6NCS2f@5FsG!(QL>gbu6JK3~IPI zjy9GIeLLeU232I}>JSdLa+oM0ROg~YV7r66>B}Pu3`vS$?tv%D*kRmup{w0kLWqQZ zp!lO!34VJq)+yo5$aX%VL_xcdK%dS>Y+a8~7}(NXLTo@8qITX{3_`5%#~huy`ov7b zK-O8{qpc1?{?P1|kZ!2h-gT%ny;N;?*o>qYwXu|-F& +@mC^UqIMuIRH!%txH{CMOd_IN zDj{$qt&S(7K`o=nA)_TCqpd8XV=SZVB%{09%#-znPrhxdB}O{AOBWDEI9w*-)FU`c zO56if;O`N+=w&47vlNjQ87LEA$f^5?Xe1J`PnG;}EUnktC)gwFyeR9kE9)BDN=5;0 zt9= -_+9yg8~H>$g(PZ)WDbQC z<(B6sBvrVrzuX@#tG{BBlu}^>F}Z`}4l(lO!=Dg=MLMKouR~rTdhmyP(yrw$jcC=! zMZ%O7i;cxse@jP*D3oO@mRBlPv?^8(D^@KkR_`iCTSfS!^wEBz*gqDYPlH>|2A~@NM({kWlBWloAOBHH_RC)m1%## zY^=&$w#s~^%0jEk;;_onqRR5F%8whB6+Bh+Dz)kwhw8eB>Q80W?rbb5@y8Yzf$s0l zLVvk|Md{TF&RV0dEilE9Fr~2*RTYxfM}QXHl~+6LfD>i4Q)9I=C$)2bwToD_OROr@ zQnhPOl`HD!w~K0byK3kgH2}Uk28}u dXsrgt`lSxIB*+i4YS(7zDlPym3$y-eidgL1v(sLHcQ3Uaw zg>aota@|h8259lzPV#VSaWhZ7k)J|8-I(MN(0U%HB^aP3q%-xrUQ47(OSElDbVN(+ zR_j&$l#tg{z%0a1NZVgtJAe%- }R_Pd3O}~lM@tK`Anw~bjoi;wzF~`@n zpwYDy)wNR5wKmbUnVz=DLHZ9s{7RAbUfQx=NXK4X=Ota2JzdvZT{ym;8;zbjr=EwX zo~MeQmx-RYv)=0fJ)bzeHzPBiK00myUDIB@fDygGCB2|MJp{gfFpYi)r+%oYzG)G} zUPe1YMn@+=KQc}~Dn~!MN*^85rXM?^AGf3*zo(yYtDlH(kVIpU%sCgMf`s2^lqLpY z&Ia!S4ASEaGVo{Z-s)ye>v|`C_nkG!-7|Q9Yk t zFf5HTEX$cksiYgjfV7dAf*0WGjd`gxt zpL2|wtBhLOj9N#GT16LXITvg%7M@}oa{!Flh!(p MKgRZO?yOt*7PcdAT(x0&va znC>l^?(dl%+%9ib378pSn9XV&iJH->n4OrIom!in2bf(rn_cFZT~(P~xBa-V1{{k5 zy1$uigdxzN`!XDcNects_w~eJAXOOH6b5mDVF#{IznuULnBBC&aQk5R%P@ld6}+<_ zw{a`SB<2rk&55~IiDk`6Rn5svSIN9rFMpa*=9*Jgn?Gtdryez@SvIHLH>cbGLAO7F zLt(*~JBc$h@mSS@$<%_`#eyZ!f;HZPE!Tp9z~X7U1;?lb=kgj|F^p)_f``D8m)7!` zpv4n0OLkRDG{32(fQzMIpyhKe%NMzp!hLJdcyp0aOVMRZv3<)|@s^m_RuZ&Ux$IU_ zVph_sRx+kmvMyF~fmZVIRtmXRiq%$1cb3sTRw~O@s{2-IcUI~I)*97o8tqnEV%FNK z);gxvx-3?DT-N&W)&{v7dezoO?bgPl)+Wo=rZXGI0&3iW=7#&$7F;%#Vm4N)HrA## zHUt}{6_$1pmiFLvT^Ae2b{osP4VbBwW}l7goeiA8){WNIJ=ew~-o{hxm$|8}w~OuT zKwF=9+cyLo3#GPxf? 6J-4a1-7s6#1T5MkU3{y|tF2ZFiV*f=@ zyj_$j2b! zt4yi3&m!B-8r`Nyi!hc)dfGu?FpO}3RSuU!ftW)fc=9 7He}nBab^CHv$L71W=JwyB zfe{Rc_9iMww!^TzKKoW$r!GMY?u*=gbBD*{wy#ng->^Fk#5;W?vr{|5@?=9A1VBcX zcLT&Bp0xuX(wrt}_fpOG!(mv>Y*m z_5$pUS39rLx-bhkf8)YTOWRJ@bt#E=UJG>DveD#jcWU3?Ti$p2hVRl6@3Oz|vaag% zS(fonJjPM=V4C;-zN+hK{FvKH#7@ILEDq^r2bnW c5RKl?p@=n$j2MwQB#So0d;>dwu zjp>XOLw+wKFI`k9!{I~;Zq3Dq#ol(vKnL $ zMaZ*xz1fP`1$!^sz)zT!?Fr#l+@A;+7~HvEyR!nNRt{XvUNaYY+iskJ0p6sI9$b(D zQQO!4=>4H2jKG7}LFn^8Rj&RA9&Km#sR3X!b?jUgB>ZsOtMs+smveM*g17#c64C{x z*s%+Q9Ch&f3jsY7PamH#uoKxKmi?hq603LAxli;tAYAaZf7F`{y}Uuo%Xq?5Len={ zH78-o4)5RX$j)Ene0d`n^e6I_Zw}p+WWTN0)JbvB)lQyW(fcdvX@|~Y-^#HoV^+sP zHQy? xcW5)`86e6(}N=1^&!&r*QmhAyS{aDIK+i* z2{+BJlkO&87AX(YdA|vEr--4E`T2=&wVf4-;`%|va&r>zTg>1)gmi&LVtMEz%Xp5o z>{JrGO}?_4b-cR8W(%+@g$(Llj?nG*gAv_#QF4jgBMAYkE=V*(2PBep>G?&3JS_C7 zP=LS|#(l)HAGp5aK)S+^F7VrLHU3NFdtu2<-Ghkyq^rf6z(Met3^HOY*Z(^m 4u5rSX~?ge2TKTH@ts^`L~Q#?X*90u(l z+}&_*hub1A(Ghj(K=)bqv1-k+_%NAsCvR*B$_4EWJMrd0elauI84DU%M&HgIs<`u( zNwN~7$dU7fatKBmzffiFOh%~^LbmsrW9S1te_dwe nA)%KEy z_=zJueb6H? wASGnI1w^!FoLV zj$5Mq^pb(Pg5%ZJ>rh`tud$%{w1{Qf(--teFM$7S@18r%bB-C}jatHnL)>8}*<(Si z%V;yps$EKMPw0tcL2k`ge JUGDNL|GJ0}50{I$X}7A4k7=Oc55CbV}O=FbZMMy21E8U!;7+2p9{(IJcO-{{wQ4 z+;&%f&>~5rPgJMCR~`N`e1v# 32Ka7$ex}hfno^{{gxKmdL_E zl`v4~KIkO;e!SFEvC6P!w$giO&-cqpt&cKS*4Wl3-w~IVABRo;sx=D-7p;L~2iIss za7buacmy&sDmo@ME KhuHJ~y|twzYrh= Fw(u82makJTf{qen0&GZF=VW?A-jq;?nYumDRQNpBtOM zwzhYE@9ym%9R4{vJ~=%*zqq`*zPTO1!MVZd0m4xd!XQF+Paw}q7t-;eWVU==es2r~ zpTpunT|s|>9-2CYTH! &@mS3|KJ{FJs7xUrKYK&89s_&~~*#(%V z%UNqIILo|#4^*4J3c*)usGR#~H&t#j)KIn12w(r2qtsZv)Z%lj`>^bs{zv;i=EGOJ zBm4Q~hnwow`x754 i3Ut)V>7n9!?zpdROBt5ac3ogH%aEU@r5Bb6}CltAs#{BVeJ^JlN*A zL3NC)VI#(os}a=RTdPR=h`-H;+pR^h6_>6>b2MzN#qjj8t;h1u*saG2ZI-Ubi=1t( zCy0Ze{7jT4v;Udo@PY^tA@7jSl%gX0WFuAkZ}Z{%69@o5$K1v{Sj3afbgMM`%?!KZ zOXf(^{HV@!1BWLa5CF#mjDJvy3*f*25CNWJmIDAF^a|s@u*osz>HJSN>7Ni0{X3g% zscipb)3j{)A8e8f{hiI5Pq}|%GpOSDZ){oyhW(Ar0GZgo*bI}7NcoFR)3@ 64_I-AEW^Qq* zbzymRt$JmB^A~Dk>-TQr&fejl5X_^~v(SU{t84qq8#JH=fGuB(N)HATvwyOH-CGxk z9xMJkoAOUF`V+{BBTukD6!s)Bsi4b^Bi)OJ!Z^*oVo`V$tN5`!T3&oo!!q`M%OCSU zco(Kh)C&}I6zj{UEA&4)EPbu7_+A6+j;8r9+1yzg`WNrQJ)6W&P5&Qksx*Jvo+{O< zFdb>G|9#J9iVOYUy$gS5^G8Q0E}d#?)1P}bpPG%fem?#+UckqGhyY;zo@G}5QGJUz zKUnFG`G<93s={n6u {2sTGa}OJEwyP>k)pN>&cjgC zOe~vpGY5rxHo4$GGaZZVA7nW-8$8H%{`%rUj>&x4uU!AL?O*Q^VD>Fk7@5OXUL;HT zR(`DD&Q?L ;FC_x>E?f!hBJ`QHSX9xWC9zZ2kl zgU GGp?{(BNd@lRm^w#C9dGQNUP4{_#<=Fx8P>mS{`tCc%)(>SOOm{h0@CHpJ zJvWq#;(h3<1lwvDiLTvhIE78=|4e`xNju_2_DiL({-K?~zal){eT2{YyG=?Pz=Qg4 zmf^2eI6?&{|4+l<|6î!tOR>A){=6@9i|FhKmn@#Fpr6$`ubZx+|f^Ccb^YJ3f z2kC>uR^i?4C(uk7SFKDa*-ZC4^xereEDhsVhTl0?dz;<%R(=1$-L20A0N>acK1TQZ z5`DxQZicuerFcvChv9-GFq~p*#qQ!WeWC<~h@H7DhH W`0Yw#Bsw;if6>3Ur*qT%ZHE$MY?0+%KyRsnf#=a0YaX>n>XmKtUEYE2F3}= z#ZolfW;O`usOx1}3b1EMw=FK)%v@{hq{)I?c&X62&6Me|2+o(;YENVF4dfz@GH^12 z|0y- 9Cpe|i_3S)D;supDr)=C z?7u5N%^2zjG`Tzcu5L8{>Zrf_XY+TB8AxfjZh)m?_rtK@@7<5%vQPIuecSg{t5-4c z8xx)<^Gpz{7