From 2e8946e21dbfd51d900286f6a28f7a3fd974ac96 Mon Sep 17 00:00:00 2001 From: Joy Zhong Date: Wed, 1 Apr 2020 08:40:57 -0700 Subject: [PATCH] docs(button): Use new format for buttons, icon button docs. PiperOrigin-RevId: 304192266 --- packages/mdc-button/README.md | 252 ++++++++++++++---- packages/mdc-button/images/button-theming.png | Bin 0 -> 24984 bytes packages/mdc-button/images/buttons_types.png | Bin 0 -> 13027 bytes .../mdc-button/images/contained-button.png | Bin 0 -> 5864 bytes .../images/contained-icon-button.png | Bin 0 -> 7528 bytes .../mdc-button/images/outlined-button.png | Bin 0 -> 4805 bytes .../images/outlined-icon-button.png | Bin 0 -> 7213 bytes packages/mdc-button/images/text-button.png | Bin 0 -> 3239 bytes .../mdc-button/images/text-icon-button.png | Bin 0 -> 5678 bytes packages/mdc-button/images/toggle-bar.png | Bin 0 -> 58653 bytes packages/mdc-icon-button/README.md | 110 ++++---- 11 files changed, 243 insertions(+), 119 deletions(-) create mode 100644 packages/mdc-button/images/button-theming.png create mode 100644 packages/mdc-button/images/buttons_types.png create mode 100644 packages/mdc-button/images/contained-button.png create mode 100644 packages/mdc-button/images/contained-icon-button.png create mode 100644 packages/mdc-button/images/outlined-button.png create mode 100644 packages/mdc-button/images/outlined-icon-button.png create mode 100644 packages/mdc-button/images/text-button.png create mode 100644 packages/mdc-button/images/text-icon-button.png create mode 100644 packages/mdc-button/images/toggle-bar.png diff --git a/packages/mdc-button/README.md b/packages/mdc-button/README.md index 16f4a6e63e9..1be43574816 100644 --- a/packages/mdc-button/README.md +++ b/packages/mdc-button/README.md @@ -2,7 +2,7 @@ title: "Buttons" layout: detail section: components -excerpt: "Material Design-styled buttons." +excerpt: "Web Buttons" iconId: button path: /catalog/buttons/ --> @@ -16,67 +16,174 @@ path: /catalog/buttons/ --> -Buttons allow users to take actions, and make choices, with a single tap. +[Buttons](https://material.io/components/buttons/) allow users to take actions, and make choices, with a single tap. -## Design & API Documentation +There are four types of buttons: - +1. [Text button](#text-button) +2. [Outlined button](#outlined-button) +3. [Contained button](#contained-button) +4. [Toggle button](#toggle-button) -## Installation +**Note: Toggle buttons are implemented using the `mdc-icon-button` component. +For more information, see the [`mdc-icon-button` page](../mdc-icon-button).** + +![Example of the four button types](images/buttons_types.png) + +## Using buttons + +### Installation ``` npm install @material/button ``` -## Basic Usage +### Styles + +```scss +@use "@material/button"; + +@include button.core-styles; +``` + +### JavaScript instantiation + +The button will work without JavaScript, but you can enhance it to have a ripple effect by instantiating `MDCRipple` on the root element. See [MDC Ripple](../mdc-ripple) for details. + +```js +import {MDCRipple} from '@material/ripple'; + +const buttonRipple = new MDCRipple(document.querySelector('.mdc-button')); +``` + +**Note: See [Importing the JS component](../../docs/importing-js.md) for more information on how to import JavaScript.** + +### Making buttons accessible + +Material Design spec advises that touch targets should be at least 48 x 48 px. +To meet this requirement, add the following to your button: + +```html +
+ +
+``` +**Note: The outer `mdc-touch-target-wrapper` element is only necessary if you want to avoid potentially overlapping touch targets on adjacent elements (due to collapsing margins).** + +## Text button + +[Text buttons](https://material.io/components/buttons/#text-button) are typically used for less-pronounced actions, including those located in dialogs and cards. In cards, text buttons help maintain an emphasis on card content. + +### Text button example + +Text button example + +```html + +``` + +Text button with icon example -### HTML Structure +Text button with bookmark icon example ```html + ``` -> _NOTE_: Examples here use the generic ` ``` -### JavaScript Instantiation +Outlined button with icon example -The button will work without JavaScript, but you can enhance it to have a ripple effect by instantiating `MDCRipple` on the root element. See [MDC Ripple](../mdc-ripple) for details. +Outlined button with bookmark icon -```js -import {MDCRipple} from '@material/ripple'; +```html + +``` -const buttonRipple = new MDCRipple(document.querySelector('.mdc-button')); +## Contained button + +[Contained buttons](https://material.io/components/buttons/#contained-button) are high-emphasis, distinguished by their use of elevation and fill. They contain actions that are primary to your app. + +#### Contained button example + +Contained button example + +```html + +``` + +**Note**: `mdc-button--raised` is applied for a contained button with elevation, +and `mdc-button--unelevated` is applied for a contained button flush with the surface. + +Contained button with icon example + +Contained button with a bookmark icon + +```html + ``` -> See [Importing the JS component](../../docs/importing-js.md) for more information on how to import JavaScript. +## Toggle button -## Variants +[Toggle buttons](https://material.io/components/buttons/#toggle-button) can be used to select from a group of choices. -### Contained Button +There are two types of toggle buttons: -To style a contained button, add the `mdc-button--raised` class to the ` ``` -## Additional Information +## Button theming example -### Accessibility +The following example shows text, contained, and outlined button types with Material Theming. -Material Design spec advises that touch targets should be at least 48 x 48 px. -To meet this requirement, add the following to your button: +Button theming with three buttons - text, contained, and outlined - with Shrine theming. -```html -
- -
+### Theming with Sass variables + +Before importing any MDC Web modules, set the theme colors in your Sass file: + +```scss +@use "@material/theme" with ( + $primary: #FEDBD0, + $on-primary: #442C2E +); +``` + +In this case we also want to customize the label color of the text and outlined +buttons, to fulfill color contrast requirements. Assuming that you've applied +the `custom-text-button` and `custom-outlined-button` classes to your buttons: + +```scss +@use "@material/button"; + +@include button.core-styles; + +.custom-text-button, +.custom-outlined-button { + @include button.ink-color(#84565E); +} +``` + +### Theming with CSS custom properties + +If you want to customize the theme for buttons without changing the theme +across the app, you can also use CSS custom properties: + +```scss +@use "@material/button"; + +@include button.core-styles; + +.custom-text-button, +.custom-outlined-button { + --mdc-theme-primary: #FEDBD0; + --mdc-theme-on-primary: #442C2E; + + @include button.ink-color(#84565E); +} ``` -Note that the outer `mdc-touch-target-wrapper` element is only necessary if you want to avoid potentially overlapping touch targets on adjacent elements (due to collapsing margins). +For a more information on theming in general, see +[this page](../../docs/theming.md). -## Style Customization +## API -### CSS Classes +### CSS classes CSS Class | Description --- | --- @@ -170,17 +312,17 @@ CSS Class | Description `mdc-button__label` | Recommended.\* Indicates the element containing the button's text label. `mdc-button__icon` | Optional. Indicates the element containing the button's icon. -> \*_NOTE_: The `mdc-button__label` element is required for buttons with a trailing icon, but it is currently optional for -> buttons with no icon or a leading icon. In the latter cases, it is acceptable for the text label to simply exist -> directly within the `mdc-button` element. -> However, the `mdc-button__label` class may become mandatory for all cases in the future, so it is recommended to -> always include it to be future-proof. + **_NOTE_: The `mdc-button__label` element is required for buttons with a trailing icon, but it is currently optional for + buttons with no icon or a leading icon. In the latter cases, it is acceptable for the text label to simply exist + directly within the `mdc-button` element.
+ However, the `mdc-button__label` class may become mandatory for all cases in the future so we recommended to + always include it.** -### Sass Mixins +### Sass mixins To customize a button's color and properties, you can use the following mixins. -#### Basic Sass Mixins +#### Basic Sass mixins MDC Button uses [MDC Theme](../mdc-theme)'s `primary` color by default. Use the following mixins to customize it. @@ -188,7 +330,7 @@ Mixin | Description --- | --- `filled-accessible($container-fill-color)` | Sets the container fill color for a contained (_raised_ or _unelevated_) button, and updates the button's ink, icon, and ripple colors to meet accessibility standards -#### Advanced Sass Mixins +#### Advanced Sass mixins These mixins will override the color of the container, ink, outline or ripple. It is up to you to ensure your button meets accessibility standards. @@ -206,4 +348,4 @@ Mixin | Description `horizontal-padding($padding)` | Sets horizontal padding to the given number. `outline-color($color)` | Sets the outline color to the given color for an enabled button. `disabled-outline-color($color)` | Sets the outline color to the given color for a disabled button. -`outline-width($width, $padding)` | Sets the outline width to the given number (defaults to 2px) and adjusts padding accordingly. `$padding` is only required in cases where `horizontal-padding` is also included with a custom value. +`outline-width($width, $padding)` | Sets the outline width to the given number (defaults to 2px) and adjusts padding accordingly. `$padding` is only required in cases where `$horizontal-padding` is also included with a custom value. diff --git a/packages/mdc-button/images/button-theming.png b/packages/mdc-button/images/button-theming.png new file mode 100644 index 0000000000000000000000000000000000000000..f0065abcab0c9aeb9166a9cd32c7e7643245e606 GIT binary patch literal 24984 zcmeEuXH=70*PsOiMZkuLRHaE*5Rk4SAiehzmEIME2qYk&pd!6VM|$rNYLJUa7o|f8 zL1~ge5=ufKlzD>pdS}h|&i|RU-XF4768AZ0m$UmmZ}oK4=+9g|bL`kLdi94742~V6 zh95h2{0i+U;G6jKb03Z!<2t7P;GWS7n>8d&%q106_xhpw9WPlg1FGY-H}J;<-@SZz z?xf%u+UqPl+$=oHFS5DrQ9U^Q?%naOmoiUu-ca?L_daZe?Y_{*I`|ekZf*s_(8Yy) zn3a`-=VA(E#8l?1goK1kKVBa@LCf{>KmB=m?Zjy+RM>kSNDkNk zGdQs172dme_tB@rEdLoASTV$N=|63K^xaGS6I3Wwdj5=i|F`Xd%^Ci?`TyYGf64w| zf%~7g^}ko`KWUo(Dw+SP*Z*nU{%crhUs-c4PCiz@jiLjf)cr=dtT&k+xZNON zC|QL8tHA8LdH=Ub4}L?N7dF>K_hv!oUC)j@_(FxQytLizD-@1=f*r%aInyXk3LoQd z8+VQA&NC}Jl&`u>;O)FI1D3xn-!D2IyFt;o_74xAnCypYiS`oS_U3A$0FNcOk@*o4 zrgI!iiXy|Pj{%3c>qKo3#ddD0UZyV5fc5VMs6_QhPt<#2`SJ7gcj7P?Po9buJ;L+X z=_>3Y<^jH3+Wy9oqm+H^Q@92_&%3{=Kp%YP;M@Q~{Wc%l@&gJ=Z%Xd6Rg#&TFGAFO zE_-=V(BKNb*v)H?kqwo7VEWsMx~a+a@xc@cL41X|Sj%^-?a06RcKJ=ek5UFh2aNdq z<8OL_g4ZxpBWVI5M~dt2S-L#zzImC}S=i09+Vi_SXN!#9Qhu4E4sNvCJ`HcXDe25j z`FsnYGp{{PDq1pi>H3jtcP{9}Y3g?o0F|SoyrCC3=e5MnQ!E7J%;&LY&)iS!s8*Sy zvxP8E)|eRRWYWSpT>ds8!BuB?>~t;(m@Aeoze(wntkk`*aru%y%PirNhRO=VGl@a&hTs=qJlUsC&<{Y9rQwHaNg zS$sde!u{+?1}6TM*4yi^#iH7wL)^EHrJtn80oUFM{-}u6X<>mvHjn!ep*|>PDKI2F z=&IK#3VGdvp>n*7FE^zJ9k{>A0p9>iw{pkC6lOm>xIXLrluKl+QSrw|Q1B|1J}ppxyo^U535sq8H!qGn}K<;Zjyrzu{y5 z)aNtlyUqmv%o_Xr$%mUqC)}b=$L>Z^aJdYIV05`Pj`%c5n^$&tocZqs@E`8pPjOWk ze*zx#X;xIf0i|cGd9J46O!+z3jOn3zYy!Q~u6xD`MzI52rlT`Wk2||b$(ctJmePDWoX z|D1|*VQcQ`5q{CYr9KY{aO)ek0zQ9YJ)uKaChdPu=r_z8v4258wJEbljG+K*iXL4E z+R&FHCs@M_4R|R#0!OA2c;t`AJcmBfNeuA-Bcg}vV5!U@SYAM!;$3RKODnwbild`ga=h9SN9qq zCH}e0b-!VPNf-WrtV^b?h)|A20g%R>psX2ulY;i+JG{of72V6bF((RW+K=R2sb{6* z#}RfMfFn!;bMbEg2brOp=S zY5d0G94&CC<|bBlKW`n-$SB-lqhR;R_DI$_(rRuq1E29>fRtb&ZNB{t^HcK=NcV(W z0qp2lN0)={znA0x_sgL?GQ&Gx&=ZUd7&bC#*-`ddsW%N@q8bJ4_A@a+oWBTti{)0! zw>&(bgwC;iwc2Btthw1*Ym9D_4;%Ag`r?YrO9+$CjDbJ{UveW4UX*w{2ve z|9Zp2yO{VF^`_>y@OO7ZqkDH`fV2wtAN8@XZKTNE9Kc$bm)8?}l4kK!W}DaUf_kqZ zSNlR=77vTK!*kQ~`M|{tz6t33^N{do{#_npy4$N_^L*e~dt`{Ahc!-B1Ri;j1G}WXwgi z=w?|^_G?Wm8y$4LAJ4Z=8687F1jfp~G(MqWWKSYnJg?cpbnWPBV69{#F`iuP2An+Y zI|q*D)f?73`_Yjb+a1a|2Z+~|d98kVFRHH_v^qU5Hr#Y*YIRGwtCJ5Mczcn5F=LFg z-x3EEwgj&x*mg%*Mj6kW?#9IpXY0^6Rcoj;{mO}`!)%*Y*$#Dh{pAqpG?G(oRBU!F z+Z(dEue&iiqmpDRWCN~$?ld;)nIW+x8YhW5y!6cv$&v6urdD3^*#|`Dfk-9X34QBP zUb;+xls3DxRY2l%H>B{KKa{=k(Yn_Texy=3$iqKKxvAV=a&41$2x1aQvMK!L`3=R)BYVsF{4VdLPSaE;sLwoxU`%u<-AJlgEp(2;-Y@li2p-Uv& zWUcPkblJouJ%Xoh6vQvzZl}he7`tY$S~J{iOcsGHm4g@4jB)0DR-n=_qY`in#+%9l zg^~mJ53d_qWr=+|Su$g8T2Zc##QjhzJ9r3xG1x3>WwRD!un%uJsZc-u4AV}&H*48A zY0xk#Y1+3I{R`wsLMvnMQ|CRyVRM#@xx^$*Tn2{QIbO7;Er=LAEbVKvg!OLp>bfNQ zSpHg~!9E+vo=I0S92bt03yNF#nx#ZI++-FLOt$h-`4s3uzF4|wzP+l(ca3+Sf543W z-ZWFpU3t)G>uu-MvVAY@yB;2leIGuU?+Slddoek=FS=Q zoSD#=hbx>=NT0t=4VaBVm-j-d__ctCWBJ`_r6&Cw6DGY$YjSnnHqa|Y=548Ufu!Kk zmP+Lv+2_BigrNj&KkqRbFVdTXWbfB!czUe~F1<(s=3#+W2Xbd@u46nWWP3}DX<;x$ zN;X?=Q0ZV*h(#)}IsYr#Sg1F9He>$+1E;jM;_ew-r5nKfCjhY6Yk)-1eVQ(NaIqGApbHSiKbF`;LTf4KR?*nNaGYH6p0xY zL~~wGw)TIE@hxqd=~>c*&B%E7M9^gpR}7gV>V)w6deD@5Qi@%-OH$iL*g$Ig=j!yz z6N`OTf&|ZYW0x5#;~G2lvyB|_jJN+WX%Ccx|D~=41#u zA}!Qa%3av_>iA|r53|s0!uDnJiPvZ9U0&@w6oM4@@7t(nK6VB*^)W5NGY={YMdf=; zIgL^fmbdAD_0#*TmSyg%3?jEG8!oD91YhW?4|~!brY&B1c&@z0gKo@y#Gs#`>%TFP{dv z*OtfBK(QR$S=||KuR5W)5j|*)Xrfz4_KjE7EEq_Ej;r9yyH<HVn>c^rUNDm zo*K@#n{MQ{I?Q=FC%4vP-=AbWE#=9!A#-l{G*f=xKmK5QyE7A@BKDj1;7f?nrxG7n z69s4WHCS(d!}gO+)|n+0*V zdeRJX>f~u47J%Q1d&wW2%=mse;%W%4P6E8?+1~H1tU9H$EaX`t2nKspN{*R+O%X%E zH{tG6H2&cDeh>ViHzdSU#6g$I%i@v3Sjsu6q&dX9o$cUIai;~l9q9g-n1|AE7`!g9 z@tK~_{$9U@-xIAGHrWe%V*2lx1bDb1|!Fp}gx z+)#=um*`6t5gGZS_#r2v{Y;Wwzacbf%!5QsbRS}*TH9HrsB1oZ&O>E z5G0yO>W@el*a9NGwYWj(121IkL9MzdoRqp&g2l!dHbJ-$es4X;Q&e6_P>;R`68sy z$B41Q4F%11L&8V+tET%NyzX`hpsAlA5HnirCn^-Yt|Q^8%R+jKYK&N3X)ET*lW9Sg zFdP4~S9l9`vxsuPb~YB0uD_=1EfBGE-`<1cAJtFbSBrCbJUPhAY$UnZ_Bl)TLaR|C zvj_1~G(gMo+6eopQqNuXPRD}C*b7||VM~J|*JIDXYwdgEng_Lm_tdA|`AJ0W{8{Br zn&-)RkdH_~^?;{O%Ci3nAh)HFKX)W@GWtzDTSaifFJ{--Q!5`nRv$<*_Vt_TL zix5^t^88ND(pK?^7qM&>?xyR5;>7D0IQ+@F)mgmj%GGb-XH5wPydyyv~ z(@H0tyhm1Hw*R)v5{;f8z(U<&0s=jKky$Np6yk+=e%^ zXna>cs5XN^`pj2Z<$0{JBX>Pk@`G zh1=N1wuzUT2FbW@K6N%W*%v34q?Kq?i|6xV4m}+U6dkb#-nDKAKIM?TpF)b!ZS&v5 z7sF)ht@dlr2>};;NoKK=2O1vu;*i^%P)69%ofs_=^|3%JkZvh|c^`$C=+eYzNC<$? zj;{5Dw^*U{4%qHrg=3SSIPX^M#@w=1ZR&X(a32%^L1Y|~K6chP_K%N>eH=aXJlK)e zx2&0Nt6Bca>;5G=X0-{4O31-*3N4xe-bToroQZ?ehv^QLNRHKn2J3}i_b}m06%vIS zQRft|beQ6igcZBqkLRl}gfBtGp0j?S*;ENsgI=3&w8m?MNA-T1|EK;90iv!SobZvn z_@#yQRgT}`cy$n2CuJ(PGGC`2@AE-iDsMTbW{#4&m~+|2ey2hmMk2$MU=IszbSJ}# zOhNiOVOuNLo4gjcxsM4|51@1S@RSja5<1kI#JL^;33j zRDl@$K<89s>guEsfx36oyWmb>k#E_rL%IjzB$Gl&jxKXkv4%?d5+ETQ-)eJb{0*7P z8>kF>03u|6bsw(Z=MF5jA$Ol*k@=wxL^WCNO${Pf`}e^Uj0JwGY_9+0NcOc26uA!y zH}`thYgW3mM6A%7&6ZcC<5+P`BRDdYyh~s6eAQ0Ix94gzb&aEU85PRoAa;|mQ**!E zGT$aG$)jY$QpzU8^R?c3)bupyYSG4HdU(X;ScdrSS8i-j;{^%Q_?<&aEHvgUu{e|! zR9|l6t~A={8C|t~ZJPfPvX=9B2+nC};AU1<#8rj47iZvOuH^VA_XtJRir9os>+BjqUC z9s4!e{zt~GL_rqCDmAn0fUk=$Qa%Yb0ERKj7a5|(M^`bPJ*d?i1=cw$srj*FR`1Br}}C1}WX1RF3woc60u| z^n+%h9)^O=tXa0X@Uo0rDnan!tSf*9UBvp==NqPlvv;S@$%*JMD=OQsHPc^)X)skJ z>4$QHw{AE6$(C(PgLmG)(CMC#idqyzacvV;f1=k8F^-_Ve#5L9w)mK9q0fV4cTnyI z>4Ll@qR1uP4w%7>=j!Ty&qvR7i`+Ld55XNS4WgHm`y4Cbk5e9^m*5_?1uSh$f`Dyo z=cGdE2t{`vepQK_J@&;CUv4y;3DX;IB~(z~P!2mg?6CJxAM8~+(E%kJ;)o51ZJjkg zFnF2h-y^Dd9@0V;@#Gnh@Oq~mfi6A`A6h3*SIqToB=;tK54DQ^{w@*MS7%Nq+>H!a zW*`3Xy$&?JQ_|`_anKMD0CSsum^uSa#z;k`lM*2KUgo5E7o=D2*2=g}i=uP~_yFQ( zkG;Jt_fney4hr0N_jAGK+=inWikCApc`DoYGh6Y)80Uim?1r^CxMaRTR`%rO$T>@b zHq<T-Ob4uy}5`dYhr zQn@I)WhdMKrtBDi#1iF6V?j$(&s$UgIw_Nr#94bM%RB2yFmr+}lT5sPD`~JMqYdAL( zIu324g^%==+3e*&h#Rh#E5xOZV!pHyIImO?3L-z=FAE@s-ovvi$KPht{*j}qE6EY+ z$-BA9pH-+x^%s_KHwzp0fmai)du+`HeHw}W$od2DqQf<%wg|E!RUegdrCoSPm-QL* zAldegh?e46Guer;gNbD|>ot_L|M1!V@#|=hNk!zeoQGk}iyc>S@JE8Oa|XgA$tD9q zCEv7q-^_TbsG}{<;I(TVn!p5!<{UTOrBCAmylWl9X!ItK!P)a*wspa`J)U=PMvd%7 z1dF<-^=J6F=F8TvOzR%Z)F?!nuNW}*52$z6f9V8$d`g3g277R$kC!39*oNDkD;@8t zP~)-WT?A*|A^vTW(kmB5Dus_ZM#29&)a9i2H#Yt%I$g6Ko+YdW_I2Z)nDH{ai|Y%D zVoOvnmou*j5bgV*@BcMLG^JKnsW5mBA>G#70e)>EX@Ju+$r>7If6g)R5T9Y9-Nsz# z`^#Zxta;ZbAi1zmqaj`9q)6c>Dc($8ee53Ja*`n=#7(`XkwHQypsw0r4lhU5+Bx| zpC1xX^tdq;cU(bEqas}Co)+x8Q%O2Pl-$yhKh~+M6f%7d5%aI6 zD32nb2K7v;#Yuu$(%)>I4T3|!l^wP@cpOKN>c2E~kdG&yeC84``EtmS>%Rd96f=#` zm8N-ssy+2Q4PPJNMK*R!QGIjY4TVn{HassLUAvmIj+S|vut(~*=r1<@_5!1Ae8OY6 z%#pdj#uQb@7IcX8$#;(k2LzWH;y9G4J?+EJh497JjOKGJkv_H2yA3^l0{DrLApCbx zFFZc>HnhU($5j>?QaerYu74F;f#8`ORi5S?`L^Kt!X`~{_FE3s6&Wmo?AMEX z#q19)orbTel|PPe@Y-wiX&*9=SJNog)S!~&Z1u1DSAfOl_a%N#)jHa1#jCjo#f}qJ z7P1?>(h<1RQ}ye*bV2iq3V8#B3E2bhdw^rnvo+UZlcu&1KE~OLkyy4k=e5u)vc?|? zv>r^k1=GUIg*Cru#}ZHw$DPi#=-crcKAqeBKHbuOSLlE;=llgA={@{9$A#dXY{;)m zZ8f&n!M#xVoHK5$Q?k#bRdG(X7RbE|?%iHtTAOR}NK1+v>%P7;)P&E^=c$aAgU`Gl zq7f60*9EDQ&)o!dn-=+$j=GKvYZHzq@{$$ z3FEX8b9dh8q&f)>|1Y=xJ5(q(D~v>Vz_ zPJW&v&kwaHJ)SQxXWM=5EL883x9``CEPyRDx0rVQZ+e8v!qg{-(T$2h2#=F?BMz7hQ0^&0 zg2vUy37CuibH{$ydBwJ~hTe3vbwuq!?-n%RT#9*=3*HYq{z%VO#E7yhsT`Qu(j(CI z0Y-vO@^f)>i0#QQ%J}kzEyMPn*^N>HAALRhyEENuHb2h7y_W{L>nZ6w?Ls1KC|xpQ zyjo7mEzWO0+^la&$l`&lR)fu5Q2NOb^WO@v*h`^m+QMNnPvR(*^748 zjyj2Kew(k#&fBKJ&NGRJqnSzoU)vFxinE(~fk~obZm7Q(KJK+vE*)O76NtG+ilX&? zsPhwu%@%m{OJ2>%-65rHUhdTtnr$!|UVyjc*^j7p7;}93&aa!9up4QK;AnE$*~`Y_ zcXwbu!)=GOn#g>O%gN@3YR>g0{3OLg%@aQSPj^iZIoR{Q3>uH@IgW(j+8NmrXe@o0 z2oeN3&{(N)(!FRUhg<8$aF?z#;%;}r<h!_98CV6q58C3n~(hYqp zi^zIK#OpbPtY_f!!OUOFB%7@#$Kxm39(@U&le^MJ%hs==O%-z* zZWuc@R8pWcZpg5P@Qld(AW~Y?vM*sba3%KMerJZPP(yZ| z3ts}TTARS0<(o^|IhG*!+WFl2zZT7w(K z!-^A#-)FA%Y~TK<^}z$GXN0&Mxp>fmp}F15%?>G5-JOOIz3gP$aEOyJ;{wF24){{GgOY3|+;A#eVh8j~)9p+#medzS?Tr zY==DKCNZdro#^(`zj%D%3N73de#oIdkhA?QoK8i<+B^S}u=#bTy!r6x9w1o@^dn+) zm&MBD4WH!HWy!00QCBloc-WqX`{d_d4Bi?XgqB9DQL*|v?D%4 z0W7M|`0DI}k9%YquO@NTB0S7L8s`a=iD&&CJ}%BAn-&Xi`{MG(_$ryi{g8AH!nE+v z?-8G><*VgR^xQfJ0YhcYy{Jgu7(LpygDr`TPBN#9v2nvNy;o4BsD*u~01!01x3P=% zv3SIdNd1<%M)9)wkT!ocJKkw$_TJqX(qiRqIsv)+G%P|?qc-xjhh>g2HlInzeyNpN zxNy6k)0<~{s?42n%6*dyFz|iv~eup*Sm~i_( q87vw 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 ysEX-sW?*2n2Hg<=YhjHxuApsSVglknyHs1u24 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
-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 PtQvsGtI3tiz7PHn+qN&V literal 0 HcmV?d00001 diff --git a/packages/mdc-button/images/contained-icon-button.png b/packages/mdc-button/images/contained-icon-button.png new file mode 100644 index 0000000000000000000000000000000000000000..8de2ae2947e971640e5d41228ba0683ddf048ebf GIT binary patch literal 7528 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 literal 0 HcmV?d00001 diff --git a/packages/mdc-button/images/outlined-button.png b/packages/mdc-button/images/outlined-button.png new file mode 100644 index 0000000000000000000000000000000000000000..5b99c244b3410d7def1147d1c7eddced6d49c6d2 GIT binary patch literal 4805 zcmb`LXE+;N8^@zj)F^5dRc-pTic(6=qKLNkj2Ttbh~3&FX6+VLd&Jg;N@_%GN>%Mq zTL@wku}7@em-l)wLKH^Z!NbXuV{h<)Q@u01T?Hzrv$>;(4{S!NWno z)wHzCB8t3PlZtfysQ#+}?K(DlZlUpy0KknKs$fL}pDg0EuMZ2PnR*M~^ET0AC_F`p zzv|A_4+62l!J($5xu7*OutW|WZOnW@)9Yl-MFASxZ#B?bv>zPDkt=W~6q>B!V-oZH zbEs3O&VleF*pSng9-P7x)w+L*%3wo?Kn2F24-e8c`m&Du(#81Pr67=NfMAt?DkA_O zH}B3YAlQUP3h;*g%5^|mcrXxPd-q?IR`d6NzT8bNtKA9tgi5@E?O-p%0D@mJ{o^pA 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 X0o4$5hhNVwK@>n$MGK5ldK3B|Zw_oX literal 0 HcmV?d00001 diff --git a/packages/mdc-button/images/outlined-icon-button.png b/packages/mdc-button/images/outlined-icon-button.png new file mode 100644 index 0000000000000000000000000000000000000000..326a41c4824f8018b94b93edf903ae35194f71c2 GIT binary patch literal 7213 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 RAG{g>QaCQT;_yv1`Srqj2gz@l*vsW~M!&>|Z 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�`048K_B#QX+Lrlm(7N?6dt#XVNtdL{GE}Cka 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 IZGj@>~{ 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 literal 0 HcmV?d00001 diff --git a/packages/mdc-icon-button/README.md b/packages/mdc-icon-button/README.md index 813f7b13abf..a979d623511 100644 --- a/packages/mdc-icon-button/README.md +++ b/packages/mdc-icon-button/README.md @@ -1,12 +1,13 @@ -# Icon Buttons +# Icon buttons -Icon buttons allow users to take actions, and make choices, with a single tap. +[Icon buttons](https://material.io/components/buttons/) allow users to take actions, and make choices, with a single tap. -## Design & API Documentation +**Note**: For buttons with both icons and text, use the `mdc-button` component. For more information, see the `mdc-button` [docs](../mdc-button). -

+## Using icon buttons -## Installation +### Installation ``` npm install @material/icon-button ``` -## Usage - -### HTML Structure - -```html - -``` - -> Note: The MDC Icon Button can be used with ` +``` + +**Note**: The MDC Icon Button can be used with both ` ``` -#### Icon Button Toggle with an Image +### Icon button toggle with an image The icon button toggle can be used with `img` tags. @@ -122,30 +129,9 @@ The icon button toggle can be used with `img` tags. ``` -### Icons - -We recommend using [Material Icons](https://material.io/tools/icons/) from Google Fonts: - -```html - - - -``` - -However, you can also use SVG, [Font Awesome](https://fontawesome.com/), or any other icon library you wish. - -### Disabled - -To disable an icon, add the `disabled` attribute directly to the ` -``` - -## Style Customization +## API -### CSS Classes +### CSS classes CSS Class | Description --- | --- @@ -154,7 +140,7 @@ CSS Class | Description `mdc-icon-button__icon` | This class is applied to each icon element for the icon button toggle. `mdc-icon-button__icon--on` | This class is applied to a icon element and is used to indicate the toggle button icon that is represents the "on" icon. -### Sass Mixins +### Sass mixins To customize an icon button's color and properties, you can use the following mixins. @@ -166,7 +152,7 @@ Mixin | Description `ink-color($color)` | Sets the font color and the ripple color to the provided color value. `disabled-ink-color($color)` | Sets the font color to the provided color value for a disabled icon button. -## `MDCIconButtonToggle` Properties and Methods +### `MDCIconButtonToggle` properties and methods Property | Value Type | Description --- | --- | --- @@ -178,10 +164,6 @@ Event Name | Event Data Structure | Description --- | --- | --- `MDCIconButtonToggle:change` | `{"detail": {"isOn": boolean}}` | Emits when the icon is toggled. -## Usage within Web Frameworks - -If you are using a JavaScript framework, such as React or Angular, you can create an Icon Button Toggle for your framework. Depending on your needs, you can use the _Simple Approach: Wrapping MDC Web Vanilla Components_, or the _Advanced Approach: Using Foundations and Adapters_. Please follow the instructions [here](../../docs/integrating-into-frameworks.md). - ### `MDCIconButtonToggleAdapter` Method Signature | Description @@ -192,7 +174,7 @@ Method Signature | Description `setAttr(name: string, value: string) => void` | Sets the attribute `name` to `value` on the root element. `notifyChange(evtData: {isOn: boolean}) => void` | Broadcasts a change notification, passing along the `evtData` to the environment's event handling system. In our vanilla implementation, Custom Events are used for this. -### Foundation: `MDCIconButtonToggleFoundation` +### `MDCIconButtonToggleFoundation` Method Signature | Description --- | ---