From 21bcb4ac9addafbe0b2655de115746d222e66807 Mon Sep 17 00:00:00 2001 From: Erin Donehoo <105813956+edonehoo@users.noreply.github.com> Date: Wed, 17 Jul 2024 09:09:28 -0400 Subject: [PATCH] docs(typography): Updates content with tokens. (#4117) * Begin editing content. * Updates with tokens. * Update with rems info. * Update image. * Add mention of hero and super hero. * Update customizing headings section. --- .../styles/typography/line-height.png | Bin 0 -> 124379 bytes .../styles/typography/typography.md | 194 +++++------------- 2 files changed, 55 insertions(+), 139 deletions(-) create mode 100644 packages/documentation-site/patternfly-docs/content/design-guidelines/styles/typography/line-height.png diff --git a/packages/documentation-site/patternfly-docs/content/design-guidelines/styles/typography/line-height.png b/packages/documentation-site/patternfly-docs/content/design-guidelines/styles/typography/line-height.png new file mode 100644 index 0000000000000000000000000000000000000000..467622368605e7b697a9bb5b064c2c3955622ead GIT binary patch literal 124379 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
    mqHK zQn$#q90?LTdSV)8S)buTG`ow2N^=SjFYjq!7YzC;W5G~v^RHL$J((dohQ&$kh|28MkDai&G1Xo z2kQ&KGd_2%p7>{WTDSxsEs`L9@>xHuh0KgeRY$cA5%#BeM;p#GGz7kEs%}F<-8M5| zfE{?!sJ|D?CEj^P0R5T2;`!`4s`y>EWlMU0%X?53A`X>evqm+zQy$4{L^?PL+=E$` z288(%vwdoAQY)Jx&*25mQWO>M&N>Oho4ce@66$-TC5CJ1?qhTcD{H0{r*+KCUo!x? z25{*hf*jC)m;(k8R6Q6j4g$*vn0LH~LPRQN_JbvAyKes&(;j#JC zVSDMlxirzLyuAek`(PWq$p6LEx5qQR|MAPAS~nd|N{Mc|xE3Mz;*@fY%>CAJx8{Bu zHj+4}M9BTJB)7TW=5C@8MkUv=5jMzXMvz9TerdVuyL(; zR`hwYR@R>`>Fe?%^PyefaeCC-JNh;Q9r2aJF3niooo4$b&Yp$-c4gc^J+&{}bSe}t zb_CZ4+J3?}yR@rA>n3dT+=~-qjw<>eS4(>P%VS_uyAby-cTe>yTw#AV zl;rWJLk@oCf3Mr7FkPYQ48mRgIU+b^a~k@zUHt&3oNd~aXQ*--e4uuKaRP)WYb@)s zw~_dE^*!?LVo458m=PI98Fd6*aBf+)Oj2fsY%PsdVpatX_6P7@aI;MD4@`W)1g6>c z%%c?e!DavA%B=tH_PUXm^dSy_x`J!p3;>Aj`ZU00j-JJnGcQJZ5P=8h^&tu)&c zuBE+qZWtez8}b2m!VUA0C-lT?RDi1nCkFVahXH37;gqcr37;WANY%$_R_VViWs*8IyNPe}j8 z8D8gpy8wH`hi_@SJCqi!W*{VNU2q8z`+0+FLM^B^&2f%PxgZUXTLkyZ@p`MT7j-0C`ZdPYTyt^@wgPoI&!)fB5cI10RQ94kN{`Kd2- zS?OT0aE;!-e%+Y^6C9sPze{m7Nt^DX_+q8$VwX}J0CY6o*^Sp08Dp`4Ern|AX%_t9 zn5ph?8L1dR)_mP!opT;orqumHRJe^d;2|3o&T+B{RbuZHbphOXPT9rL`k?h+I=n%R z2jwn*>I&ZWumDnG6FUu{!_t?4=zAGu7&7t&i29Y|5@XiEC)To+eDg;razx-EkKG7G z)?Rr!9Fw9x{nI~Lyx9g&p|ho5CmRqh`1cFkG(h?*4lGyaa|)=E|4Ry3wEKa4)L7dy zLpfT}sA98n(_(k)HHGQUGQb*sH2mgM$8887PYt&px#@2vlqi&ILlxp9e=xiw?GTFZ zvbXh-Y>ImDBu~yk{j{K8X=awaJNGOQQaf@yA$OT>)>gyyoW8tGBeOh9<(NdJaerZ= z>UVj+z50&i|57sICd0)~ubQX0$M%+3bM7|4hdO;hH>1h2*2@8jUNxP+!Nkiqr?f6x zJ@rplPs$O%Pkw$s4VWYq4aF||p@_x%BjWAx-Zec*k!JTb6X7!dJbc?YVCe%y^GB{O zsGOkbw21(-=4dwpKe#0IxvdKfvKkjip!KUINdzfn05JO&j=oiP#EsxJ)BHz%^~0$m zLuy~*HN*bp`e#t6e_4H|IMPP!!kzN>-uMDT>SV5VoN31OoLTj0K&wQ3dfRE?>=ZV0 zUXHlch^`IIED?p%6_UW`k2cQx-qVr(%lIXy9A+-|djR(%GC<>cjY)9LR1VD`&PQyQW3%7IKI5)kIS)D;c>GXY;s^;& z51NhFM(Gb-6Fv?4H4uF46%3nFHce5_2|#_Pj}#2hBbylg_mW+HD1|D{S`X7A-oZ*a zW}U10H;n3r0aAVP#&#m3ZL7ZIOo>sY98PC`p$3x;! ze){|sP|6l4_3C^g{Onmh$peFtQO?INP@y5SXYw_Dkjt@THvfloLB!&@gnovzm5>}9 zXoA`KFk&I2#Pg2yk7$q`sh)N|7j(!uhN^~0^gDi`V6s@yz}o-y;WZEA>nwotUow0T z$+G{!8EMQ^Adm2?EH*;m+objVu)06sT ztyUk|a-#Ge?}2sfXx3lby=SB;wI*)a1u>t>eDtDCfA-zUa9ImF@5r1Fx!895HEK~s z22RxM43OqY6I|=t9mPI=Mxfl?ajJ|ZBKJu8rLH(0A;K|zA ziT2;?)%ykne(9gA(;cn9fzzD_ggtSEhx&gI`Q3Fh=samU+Y7*z;GpH`=71n5UI4Go z2p7;9q`+#PvMNl5Exhg_CMg_hw?N`y>Ws=TlfBJ4w`Daw;oSL7s`)K8FVe@NO)PCp z&Ao^8j=Iu}hTFlWn71EZmrTRn$rnblde0))6U(ck22_qsg2#uoi>@Mlwa3buq$MZuPt9cxst#fh(}-wLcZwH0{#NRatw@uF zlK-iXp1PynrbSDQi%|z-QvBDyo}|9krgu}!+;&O-BFtpzeTx^wb@kWil2=u|=o4@a{oy(5 zrAn)=g2~{gU0fj0F7VcO`O&PC zo|+$fPq-`tbc&xE8ISXP1jUwGVh?nJ3vag+5&wLP;FwDPc&hs#YK^#EI(RG9v96d^ zAVb@D$+;Tt2G)Tq?y;6bFxJ2%?+&hpt(-qqEcW#K>(er^;y<(0LeQN2buF-)9~RtT zB)iwcBy}Uqs-t>za6sm~_TA!hkXhb8UW6&T2qTbd-aoUlod)P6pyBKEihjbaWS05n znSt$8(z?|2jMJNpmaEKQp!DPZFVD<~8zQe%DKJYFRyBS_DcUjiS^Mtwi+JJOoSCX} z>-l&JDW4~Yv+!T`Ar;{^iQk6jdQ*x4W3sF>G|r>_E~GUdROqdM~|-tlVI^6|Ajbb>x@t$0W+C6QS`*`PETUKB{Gn zB_yqp_dpHBgnShMWOOw}PAKLX`=_nGR!83N)EbuD>mB``?^Mv(LvaaUL?>5%R;lxc ze!UFdFdmb;n0g<~rFWeI81GzEXf=KVp57d$ng6=*b|%dr4|9K6D^?q?0v))OW(HUY zsO|I7W;488l06A5f5+j<%;kF}u*eUJ79isRNQ_LdwYHmYXP;_kK+7UgR@|%{)t4k( z$0^#3koiMxH!Yj5TZ9?^sd`{mzi83A{1WoWLWaE&sk(dJu9L)(ZnT%%M-x=Y@`vBJ zm>LOtq9k*#$-*-%E8NCoHG9gVU7`1clfoZ8W92|BgDN*UsrOitQ5jS5IKmoKIA;`L zs1+T}L#Z z=OJ25idmip{a_F!-9Op;vF4HxW2bR|Zrf=*Oa;fUXWm6ROlmOd zcNr^)`JO}i&#Md=I2Up5|0V59VvQ{x@pAHu?d)r1QPJvKXm=SEc8HxP6V@I9QnCfm zWt;T~COwvL?XP#*5jG%^Qk{o4m-TQ0#=V!Jo;o3cO_Ode?G|}&umNT6Y>x!Gxf>wC zn<+^j-m-CudAFs|r8jQr>5J+-E3*vnxXStmu$6$0OM2Coow#71w0D(RSYv%V^8!B(OMaGIE|2w77cI<3y&-T z8mimz_Kon_(VG@`JX@b34pbCx2(4|6F#o1TDY8s}Z+-nUFL(v;b&5GYa5SH2nFwNg zdJ)Kb@9p341wd5?d*$vnMx8eK{j!~5!rSR`CUM~KxvHCS@Xc}*05j9hLb5-_HRsXC z7^{WD`b6Am_NEFj6iQw0+ubg8-}>>}VQc@nXrJcsqqg!*n4O2&hw--gH1GZ(V1n_? z{-BRP3$!Mw8B$fJ_@Q6(McoDoo2UMY7-DEdA5v( zSpH+Uqh0*=He#dWRJo}}`Y%%J6DCcAt}*n-Dy(B(GamNUY ze&ZT)XG{On8=jN+;Q9XLRe?f1S9?o;zyg@_?u0VN4B-%luSY~PW|vIs|EoqSur!Ex zlz{v5gT8Bk(E&XF-RvzTRYqEu9FmPMtYVk9uw5SHIN2s4Zgeg2sk4>}Jq6D<@6kB` zjxK;*fLu!IkXCD{Wx`pbY^%6d*t4OsNN!^)B+)~oZ*ga|fX{Fj-U;=fVHZO-XEZd{ zX+>PD5Yc+;18u6cFKt(YCZV|lm0H{xV)YqaRno5HkdzoAguN8UqRmIB9vCvqGhF1K zhi`4X9*S0H1;F=3;oBbk3Cz`dA+7X0frM^P^k~Siq7W-R_-pESH>r!bfff^H=iZio zmd|5GDb%eU3hmebw=T~5_NGhNE=HRz{Y0|~NuM9_IC6nqO>1rqX5=)X6eq(N0rR&9 zzGlg0hpo&lz7C^jEsIxUcJU#+Parz?e+6Gx&cRoUvKC#RscvV7?Aa8+s_+29Qde2@ zh7s}LJo-xfA(~mn)ubORvP&5>j6?sZNK2odbPG&5<6`WkxJsRBS}kI&RgzHm9~RaK z;o&181aoFDjXg8W<%398n2Z1BF`jwkGwisElWHb?R%YeQH5tq%ZOBEGF+301s}=$0 zPyy%%SMnd{Ea2=gtT!4K&<{?N#52HS89cU1Ec;Vbm6?1G?22TyA602@%A+sKsI3j= zzJI2Pe*H}lug}$BSWy!R6OtJUic_t?&^OaOpP5Mt?m6&)k$nQFo}CS5vR&l<03zOJ zXp>B6RG`M@dR?7q$@1lLLoiO&8D1`3#V7XoEWD%1&#dzy_h8-tdsdE621v>i-hWdB z#t6JhURg;1Kg=skO7+*Of&eoi?;AvOS;geim$g^RSsgAX-k@rwFE?i}gNPIYj-`$} zg|{h@HT4LaG>mBt+sVU-@&;4(h!wzJlh{k>3Q9lk{YM1oV$4}OwY6+TNwIpXpAv^% zG>oY!Uv%x*{o43OCOqON)q!KOfERhsQii|O`7*u=CwbOk42Q-Qo7W3a{)49Qz_jV< zmKA6;?Tsex%V`Z-*7=$J>xFChKg{iR9y?5EE}az^cAHM8(paF#=TUUh5iq>NoQ)@!9P*Etg~1iW=j83a8HM(+IZArGZJK(g+NT z$X854hBTaIFi42{8AcgnR8?W=U1jjj0(qzo8M2UH89e)(snV&fd1Js9;mu%N=361O zg4a>K2o?d!X1QwgHovK1FGsJSPH1@1G$S;rENsAFmrx>YlHIsi8oiQ<+m(PA5Fh)B zUiMYPsqRiqM*I!A@HDq~z*;m!alA0s7%%BiM#*#%D( zoUTHUcC#qHzD-WqA3aG8B9cDLw5^@@u4N;6Y)ru1A(ioW>JKyU!Q1_6O{O*Q)?Sx) z94od(dbc^)gkZi=iM7IcBLKVA7g{DcQ;Uc-XcCmy2V_!nO#QXnaNvY5Pp!CUP)irT$FW2A?m^DOY(I4M;oIEZ zb>*-tVVi5kVQ2bFE!iWaRu#Gf?8#0p!ec#MLpqRonTp&^@eC{zNqVm>V)OBMG5-`+ zbeu6k+~N}rDI26Lc14XihB{{&oGn%o5h`9~Ou=(+dbT%F5$w^N4hhkzEHpA6&MZg5 z{7ZI+qw%UKQ}~)?^(QTj0gkMeRXc*>oyeqy?Aq&}GQAmQ*{1_TiRka8&2lsgH6;U3 zrM_hc86#2WJg~bY=Ru~_XC9J8uz(XH65{=L=QHA?ek;sYMu)gV@=1%%r5cI}0=Y9t z3srK%4Gu>HXE=`yTso~5x>f0^KQU6pIyQ;tTyk0cJ8^gh1xMBsH)e4zky7SkIaz)au`)qoSvDZ)*ADfl&Q4KRFu#&Z?^ zY%r?i(2P18>x)=IXP{PDM0$4aBE*$AQH44@G7=Gkd)7pDiNA;p>ru)*1IMojC16Q? zbQd-ZuJF}mFeb;ROc&!ATh_y->>sncW;8KMzEu>5D1E{vnyYSo z$1JvBo25Uo%APVW!Q(6RxGA9V5?$W8miI!Ain z%-ekB8YND4knfUpxYl)R?*fIGA#S4nwIOB8xSB3tS#wJ8jvAZc<{y|`>U&eHGDFc(1E*Q# z6w&~NkBtcTnqV`Xm@vS^)MWSiT4xNsBLlqs%9^5@f)c}K@tJF<0@y=`5CK13;s>m$ zJ-Gl|KGs6~9};YVZKBlQaD4;bnyrB7dMVw7?X5cDSmvm2r|lL350lFu0aKbYDc(l22@viN;O);RX;`Od+)crm)VUoDX*4NG7uYThi{^-8#$55Bvs_-4o_)VJBEPcBYCLCV3^L@ea)RB@y#rL|!$2p817wFtQv zzbe4W6dZol_cC%gn@#M^rAgfD%CF*sA>^*7EjwA+{9&Hkv+dIQ-4h$aF8(w^zqL>; za=Tc^SyW>?zOH5qqLf?>l#hl}`n!RHvJI(QT4r*`3#5(;%@qQu(L zHpR<9sjMheeK|FM!$a+{(t@v3T8dNiR?*ECohs?S#t8oE*M^E$A28bszLS{jjpa&Y zp3X^?xMkELM(LT23^JvfNn?^3om+13-M=gVp`JkIZX&gmHFgOSAT54oWQF+BK#2$? zHNy%I1!)h(+buBs&)KoJTI|ZU-i7T`Mz|jPLU{d>H4@m2F2vJC(I|nn?NOH#tJ@s` zEOY#v>DQaDor4q|Zk;l}_EL+#)oU9kNDGCe;A2{E8S>T z@yLJ=NANshF|UQ?_Tw3-to8uy(N1R0EI?0Tr<#(_0Z9X0egr5ksp=>liLGFGz?<;n?M{m#+EbHqx zPKrR+USKK@yuMnMoi|X;29jfcK5g`WhsuMdPj`BsTJ$~i@)v`!V@S znhPEc_0j2r$L0)VJ*4KVS$YXx-rS?&9s}CLcwwARvmK&Rt;AfEqI7WPwuCpWR7aU^ zy%S#-(>b90)x3Nl%`SMY09ZnePNjgn@n=kf^A^516j8AlrA;UCsjn~1|B5a{I$a{0 zRr_pSu{d3&?r3!%NxfEXc(Tq!&k!I{ISjlR{?_PxidOPgsSMy%1&BQmcOxUA#39;Mv09DKVrSv4fllicG2 zzcO#ccgWcwpj7&-#UZ+Bg02b~r}xbz9`XstH(AT{ms9<+F;sk?fY8R=-BLZ4Hj-vW zz2K^5ui^>P8Lp%5D%!1VHWJenKfVe=XB>s(gV&@Nht3Q9$nclyR=!!jqjcoBLD7-^ zUH_Ku4=`^%0NY4_mL?GIUn$4Xt`+Nhb8gP_cx+{#ast)SdT2KoOeMOcI1h~%;Y4l< z@_#HX|I;Fj9xC{C9BhX%R;pJoqu5ec8MdmjCN12av0py)??HrtLi1rD(6Zmr3S`DD z!99+jun`lsE#DZUZc)kkLILN_9&>9g6XCIb=Tydv4gX2QFmhi_4mP*Y8hKD*%Zhdx z*Fb+CZ^4F~hHG^~A@~n!VRle4y5UN4)>X?L#M_ATW5Mhnhh#DA- zVbFu?SNH|7mm%F4_N>gNr9hQ)-X#yCmBSUTSOq{0E+c@%{pHg0$?q=JX2Y|=jA&bv zTYrn=Mwn|~Fnj43Ae^#!X4`nwRIfZp zo(;8|&6*(@7rLG%PyMiBV**Vv%xOkQ%TsJhQ=sI|^v^S{yajhjq6)sWHcsM4yF8Uq9tdKJ}F(MIM$!hE*Zv zd>6*FF^zDK?H7isR+HW&D9)jI^J|s#6^L!*`fi;qUhV*F-)|g70`ktEa3@*>r}Y25 z9JXfr1$SY<wnu$)%LP<*sBJNCLbKpsX~o9(nh*zcG>zbn2u`Le_m-7ed$~}x z)(8q%u=LX>e|nxGn88nIu(1ecqh6DdRPY$&lkDw*Ti91Q86~ZzWxreqt&0%fEf-e+ zp!r2utnD1=r!?K#mc5&Jq#f>boShZdTpJ7+S$TSEX!Z>R`MaVF)z{V6+J9$)LxKQa z#egbT@_V7rJ*75^7eBWx79Mh3tW&_>rs^Q7`*VW7Nj&dyay9*rTqStLk-|xB)O9Ef z;@PFqt0j2EeA%m^gu72-si!sSs=2odWl0io{0UM%_=nvxNy>rM#-8xdfaCX_MA-~c zCeq*{sl=?vdBP0dztWkWvOK^)<>Xm}Z2GmO5_-_uj5=@vRGPoBB-z7ze2)7$@g?`` zZxhiM`DGD=Lo4SdojyoEpY?A|<#6+XS2EC-J=q>C(Js$qk?=;)MxLV^=J^D~ChPkj z=}#vk8?W-p37mX(6m)e0#>gsfHPcKIyRLNP1%l-nXhN|%1OmE>Fu#`eQq1!svk*Hi zwAffT)D1(_?Q{oAj{=d^;MH^5kP&ga-FSsCAP?tyJY%E_2FE;MR+?P4^~ath+Ey&V z(r(V!ZcDb)-EIF(qETEh#nY=(LFs@Z^LxdG%HL0kXKM*{`} zOuL$iv@#)$?zJ-8%~U97U8I3Hh=#;Ize8y*)fbLZ}= zGUHzx?62}(suYwScAZdal~diYcxqY}&+lqAr<0{Mq!nHrWkRkiVvQlK47T%OkR@+m z!%ws66M=Ric!@5WmS`AblvH5HFAlJlf}lr-D=cMKI^VQJw)1yqJD~rVFc56+_^*kI)KzeMRsr4e=8fBwrMc6ACReil z!b2%&t>HBP6yN*eRE0QrL{)FX+u_((jRKwE_Rjm=RMu_?FANm}S0f zMDM&2ZLF)cw&t}&`f2S+MD*`^0~c8<{Ip<+P`L6&8|w&B>M168euk4ibQd@e^CIoS zh(|lxW3X*lP7-eDgZxMYC)YSi8t%BRghmCd+JLk=np? znnQR>l>7H|$UQY-%ysNhuh#7bthGxT#<;dNh)$7NO5+N`o#!65ss6PBBv#g5(H0Wv zN@3sG$hWWWIs=jCVk32gJ)G+)0)O!J{-ae!8yu%GfPmBc6j4sD2Rl;y&31`cxK*^)eEUZ7}OUE9kh-lTCPDbO0Al1Ep+M4 zQUet}klm1$TiUfm@oqM7>*3ZX?nA7OMwx~zSpw%scRPp77xIKjvFpUzg2FKiqyXEJ zDp26zZu%3xb?4(kKm`qlZU&O)SgH|6525#>|>uTWfNqa{0w#Wl?)# zNI)H?8R(Fy4f;tve*QN5Tb4#b@yD?&dlQXSIyLLmbks!aHXBA{ml7AYR05-}FM^e$ zQHSj096l;ekKn&MMpYhoI2g) zYHFeP7?Pl}Qu1bulq~0*0l9}#+fws%^k4x#8W=-+-kZf8R9&WV3sv86;Nk;1Y)y@} zWKNUYqDQIwdiOVeO$TdqNkib~H6{O1nP)fBB)Y=p+1DJ8FEq8pG|(aR$iTtj;L$tf zP!*Y37wVCE5K2b51hJ4dLj3aasQ&%|w?75q%yn@u6JlK?6E<7M&QUoK_2`shgHkGS zYnFMX=5cvw^4rk@b$YGAfw)Lx0rj-NJB2VkPU3f{B%P7=_z`!IjicV=Z5aZ=)3(1+ z@Jgl%R4O&k*dcaK&Tf7ft)70dB)IV1*9X4qff$7&|7{)jAnvfqzJy5@i*u3C)BU9$ zzFc&>S58lb16ywMNOB(FLOt`9dT8h55il8`+2iDqe|&6J8mD)%x|^PO(sKlw|3*pB zjielPOGuhb@`TT0RS?OQgZ{#^sueNr`L7?B``GbWl~oG^nxAdYmsc4j)$z46gUId9 zSR{3a9T}=HU)@3vJ`GoA#|(D?Rf{eNf%cqXiOfLkOljk*W+Kjd!Roc zJ1lU(cK%|Rq~YV6ao*s;4GNEMdfjKNXd{@ARU)$X@8fJT8F{2)ZujXN)ui4H}@{r+H};q0AP6 zkIZjf1l!}cdM(#v2<*6mGTw!1y6=w_0EP36!ltj;NzR%-fX5mrC(qH?RJjpxK%W(y z7MIwmZ$xyq%_w(BK6Tay=C;1U&8cv(|&&R5wJ zRaa|xg?nMQND2POS3CE8{4JL!D;3{LG=Z#zH?rYFNr+NDRo=aueeK=yn{ygQode&f z(u-sm49YY(ps(b)yO%&`7HZP3wN}2J$@Z^fwR)=kWMA5=fB_{B{W|d7YoJR+KJv~V zFqV0yHYO+!COLR!*6MQzR5-F71$P z%Uao4qEK2bZf<3BzAFsz*YNeHu{`H=PK`!}=z?oFr41GCt03zuF|w<7{kWs!Y*@w1 zs}xq6#$0MX+)Y<0KT*8t)L1mn!^NBg9*Zi1lWj7sKgjK%n+})L!@^d)A&|#%4RfFI z)wXM9y9AgV%bI;rK#(0r^6TC3y;vSL$Sf~a*3` z_*;b}RxEM1#O(S+F>oQ4L$Kb7GZyWS7wR^jQbH351*qw_w=&l0OG&4-Deouxn_C5A z&Q%MMZAgzmSBE9WubLyJZ)NPTmPxiK*6Ki5SPgc`YFw^H(;?y?>dj|pHB=9C zw0OA(LHsV9ai2i7pP)aH<}VzGz78k6V=elydRp_A2d`WR1VX6q^rkpC-Rp~cx3{OM z>1wca(Lkktg8$Uk!0zX*9Z3ehj?TQ27GhKUOS`|+W*6|fZc&w-G#0z^LWw=Q(&Uig ze@oy{5>Xv_{8dTX!a#|X)2<`7-=+9WT^Y@0HT^W)ui@~G@qUm+?}m_n_F`awtL^T7 zxs8i_H~h46k7%~+a;5}cYYQ9AyAJp``f8%w~|dZ^H@6UGZ)8#ebaAu!d6E_WQ9VJ)HA!T?ySzpS`@D+gASJ;e&C9=qf3^lr5*2sA_~@~g;sQ;bB;kssY-hEU z7;ze6*Cl|*px~ubZ~8Zv>>A!N<1B@^N6_9@n_y>%SGXd?mZ$^54(XF|7a2lsftr6s`uVwpVxixAUhUTk&U?dd&6NPI_GcQTvwk#E;=@6NzQk1_(*nP>Fq z(Qp!2NCM^v)&0^Y-Q}9?fCknQ8unK`8;cbB>-uYYbE?Uo)k=!|Q(52?C5ygBw5>k{`8yi^Pp^SP@q-poE0CzLM>$HOA*rF znfdJTyMen!KI%}L)ez~g=EZg;gL5l~p&RMesb+KsleFz5wsv~gq}<}uEuX;OThCmv zZg>0CsTY&=Ig3-`J9Vqfjd_A}UGwq>gf8A_dqGZ-5TOj1{F4{sCS+Bf8-L2&d33+i zWVI)E!d>n8%ZUVYry0bLl)0^;1%Nu!pkykC*RIQE9|G-S83CW?Qdv~ra#NfzZ>615 zHYHU>=rYHCeP1S$XXb#2+j<+Cq{{}F7-zC*3f1^ortZHGzosP{>%bqen}KiyKux`6 zai{=N<{9sxe70I{>#36H15F?7d+Ribx!t7oarD)`4@#n!8Feu`XPR!=jiZ&~X1)@w zI+YyjhBVAlj-nNyqOZ}EnG&S72xHz38to?#uFs2abSfbif7pS^-y^ymz{A*KmpW88 zE9<}^V><-K9t?(yE5n)4I`+D5$ti*7W-iR+?LW2ob zc^t{{cr|%PL)yW{ju)g|(Bqv$m)>_t$V&h?g>{dzwHi3Fpv=c*A5e7Hs{CNKdsWz$ zHoGZ8U7aynhuSZ)vN`wU|8_rshPB7pY0x^B%LQt_{=sE0f~VpYP5D|$*#J&q>eR2i z;>bXOU1|QqVIAit_jBc3;Zy)7(}s2_Z?0!jZR@iXxhkwVKCFtm!{PNG_uHEc!&onY zUq4uG=Jy+x;1BcxsCb^evr7w@u&sX`>9SbPsSp787s|UumgsJ`Re*^B*5$3nPG4Pd ziXEMCWU-Yti7D*|a+^S<929=-@QL431%w{L-z2>6037S$rxSJO@rp-&sRQNa7&vRM z0E}UOXBPnu`RX(F(s3H==jRasJd`vbBud}L6&u1gA-L0gbH3fcx;~h;4Loo`_UeX^ zJQDmm6pcNzzbxVU0EnXE>0*)}2C>sQzaAZ@rg%iPd4Yv1Rg=t~XU8BiEGHPK?w7}^)?9n_!$~5WOBq|<{N$+-%$`3$z7F;an<1Tu zX=P38hM93zh*M98ZTiQD_W{Wsn=dw_H!3s028cI9W~gP` z|0zHKNVH*+b)#QV@b+|cF@-c>7D#{x@+LYqTQ>)J-_AGwvI9^`ic&d@D9Rko@o^&Rl8LW=hk@;KAx@UL6 zj&W7J+4mD*1d&PXQ2~P?}TxmMEYa zmJYUJI7|!x5*?5AWp$f;N~CR@?*u!BWpqh6xO8v3kuj;%QEjWR+0g=QA{xH4F_(cr z&$F_?8-01lFJedYta;=;doey7!-bMC5UAH&cAeN z=G)BU;cmKmGBia=u{V`mZAWEEmw&w_L3-|@uT z)$oij^1s(fbrl3zX8}04zf9d*!zO{Q2enLU2cL#@ma@Nl&b`k(6aCq0xEm+aE)0F! zy0W$fF#ndfEi^67%B<6r!q0#r#FmEM(U8%b-+`z2eW3w{uOR`lDggKCa@Tc->umH( zo7Y{UVWFFzg!M$)Gm+fx)GV>TQxx7QoC4%5$~kg4%d0@U;ZA#RK+30R;E{%u93X=i zxaB)hS+r``UU|(hTljpgvY?6 zn0#evOt=6$lQr|!`^PXqKbe=+{-M1vQ-Yn@s_dg#3@=GDz{6x|W)|8p21~j0AM8<> z(~@2~WzITv-FVCCyyjQVE_odQ**iPu#6Nv-zKN1LGp?J7x%x5?H=Z!%6`_lr z!k7Grjr_7P&!4HsRaaA>8(wwed5iPm+sq018YO+JshbzSM`DI;A`(EnM05Qke=1Pb zY?ahOkqS<`{*%sD=K#1E55Eg2t1MkO@yCD-;|4{B84U1i4185C(l(vsmaK61&LQh7<$&%Q<)lKZTa9=taa`RS_32ykq=K9;(i(QQk(qe6DMdDr-uZe#)516cE;~R`4?6~K|EAStU=dA}=ir*ThKKeQ^q!>} zH&hC_>e_p_j@|?x>@6M2Fn(EMQYi_RuUs&iKPLWeB=N47As z*;B-3Jf7L(>$@a7OeW8ktSXwM)nQ>jtqXGd*l2VgdH2@Oj}!xX!6qb4Vl2*^)V`r! zZEemW^;PtH?5spqt%Ut~FZzE(qd_wbi^KnEgWaWs$F#k8b(aJbsGK(El9bRab?t)qVi;*T< z!Ot&N8^*&D)SoQ|OZTbQ@xn-z{hUj#$$`)cKh*&s&-eS%yvLxuo^U@0(T>I2KQ1yI z7xY^^8wHV*uJ}n))1`iKX7I~0ex$ViEOrMZT<>d|fWTWt=E^rNC`e5V4ac@VuV}2v zDg6Lx5AQ8(Z!F~Uq!$WV>ds3ufBIvL#gy)iLsyxpwSWeWkK)G1 z-H%_~I{sfd%A2Ax-BUI_*?sE~@^(k`0s-CAs;?vsy|~^-aW=1#h5~h%!4>uA^EGM? z4z6CZGw-2N!e@WU{P48tK*z&9RGjnJ^j5oA?Fh8K)_@q5hBaRhz)O`wGT1g~)>_^}gCvkp-B*S}mt`jc zd0|%kTwR!!1b0DL#=UJ}_M?jvmneloXY_HMZ`hIO3@28da+WOF*qoh201!l zkmxXij(T%+CIE)Xx1d3i-SJ8(wdV=yq_~`_2e)Zz%R+!UlnrGf^Ol;26z2(zn*6@5 zGkFL)PWYT5dx3x5qyFQ6n;{l{3iK5H(iRty1|8=%s0LaDFQ=P@2R=M3FwG8`~_cz&&q>dbZ@5X3454ohKYjffhKo_reXNV`mCH_Lc zoaXn-l)rusWG_#+2F(Kcyi1)-zdNED@l?x6V_ee%{$g+@B9B}m6{Aqo2(huk_#OAW z>N+OKRl=6^%`0srmppF)C#-q+wqhNcouqFA^dv4%qOsMs+A_*a16nMcNm?Q*e-liw z@dJ-4Sgd9=n%osBfMT4B+Ew_VNl|j000#4sk8lQgN3~xCdb-+C1$$Hp7&Vtd+J50j z;^L=bp1>$|#M%qd7|j?EkNh7kAaWkcq52o`3ihre_Y=xtyJVXCQ6qz+QGn3fdOi}6 z^Z)5A|IM{&h;aoQZccaYhOV03xB3@m`;?4+>x!(*au_TzNk=DhLAY13;jY{fO+qKL z>d{ZrH*b>Q_r zVK>vZKI?SaHUSEygxJoMO1&E`K)JTpV`<&%`fZICVs}nUlxY4N2Cg~ZF?nJ_S`%ma zqxMLk9rmd9II4^`uVm||bh#~`lZ$1ytKojbCJzTyEo_Q8! zPUhEyun>6YS$FIE-O^7N9;Vi~O=|rIy;$QsgtMptAI!RqNC)HpMSLwn>XXz(mx_y%k(&f zS`{ohoOYzle__T%AnRi!51D`7G7o<41N0cSn%grYCSHB!HrUoTG`*|zVR((yY}3j( z(U|^T>Y=&`Wt&#Yo#Exo-IN&d#bSi0WGKrwcnE|vJVL(OmKNZo>S^gj^#4KHz4h98 zyLnYvPQU$^e}?(3Jsn8l-;t0d_bX7su-1pX53}`aV^!RL7rj?{ecuExEDlf8u0}pN z#QMkN#zRF-?!`SStF%>#dt=tmyZ{e81Cinn zwY<|>+&2gi+XKp`(km0Rg+wz)SWRwwAJ78KRAIN!LU&**eb(x*>uLuLGvT^ z+tcyX_jXqGHKj*3>MK?o-9*YaJ5XRjgS&n|>ZPITK;-zIYZ2v+ODXxY*e}%hlv0;V z0*{wK#d-b-gP>L+JeHoQ(+J|NqZ)yHuC-Z&A$bP7z~0W@>7=;(yvuTei=_0>avf!0 zUD`q?_7RFI!b(1~`A8{1)j=oOKT$j!{jxf}9LUyjDTr~6ziYFrj&O^rRsNg&t zIG)S3dX--g8g&eZT1CGM8v%>wD%75*Ox`SOgm7m9G_|IM?L1>h>~y|shAt(WQ2p>e zj>!85XqY(qvzYK88;~pg4;2^FL1d)3w`yTGEa~JBR_cAL!muIKUcjJN+tI|o{O5UXDu;WeH$;y)y4>QTJX zyXdYGcKZdI@*}`@{Nvp{;cSopc@VWPv(gVt=A*4fX`rwA2^So#9(r1G6_@IRY|GM} z!xb01?5%mf=?@;e?~Dmlxsu+~1W23U*Q;x)5qfKRQ{j#&NQy6D+}PUB0pb|UmZ}Ef?_n$iX|10O~hKzDxj#8utfqR zYs7#+L&yk7Xxs^Rge! z95C?DJGxoO?VV}Q+*RJlx=)vzQ=RjLf-s|6d`rTQ{X58CNsRVnd68Xi0QVlG#VHo) zji2>+p*g2ZT*bJ?lf6T4s>Q_tWF~{eN9E?H5Cet|M(GaTPO*`4wkVI_5jPk46ia94 zF=rJFSh-6d@+U(5(D9+O)N)x6(R&q@zTDDTB?b}xtHqlFM^=ycXxMEk8?|rkT zs`{bv>pB2bdH&=n`s*58nC>u8hs>7I&{Vrfw4@O^#NBqWbu81|Ec`fkoxuA0$!{hb4Qz&4XTioFxFtRaUR>BfqIOB0ZjAiPFPXb&k&ftJu_d;o3a zgGw1PINzaE=wc>ph%L=p>y_S%#K^CptqNV2i3Xw1JhRb+$O||*KsUDSc$K?pdq5d? zBWdV>d#?4|V0?#CE1}OYX|$etANW7{7}dkg`+}#%tnd7mYyN-`mn`DVbR8m3$G@~j z4usX~Rl~f?LC4(OH0{{qafx->Q}YE}L>QgJUG#x7=by2Zzv+BuVkCok0CmMrK@lNd z;%_ce9u2se@w%2ee?H&blq^F6w2y19_VSZc4X- z3S%p`1kQbD`9A10=R0S159D&4ao`N<>zsFP_1{yEfpKk0GAy#9A5}atH6hHE{J?(E zLEznt)@k|j#uu%L0j-gxf5g$tvx6O3+rtBfL`+3~Ob(?NEAVFvBPB|YzQpuLjmQ5% zTbSe1SGeu3qU31+QA1iz98!Qey-Q(WDieL`^BE4Y_}v0oY;$gS9U{}bVJBbWeS*Ub z56IF%Q_0H8^!ph30)XcDD{Fdw{bc@Dt+1fY*l{8?m9ROc?aswNh6wVAaZZ6-Lv7>n5u84lB1$$*s`*e0nyKmp-?BO@r$fKU2@?*X_x&aNkBba|MH} zs4hR5TN9lx%&y+ED!a)o`JI5P0GkN3?oG8!QrGqg{KoB1enxG`DiDAa4ZRT@YhwJw@tE9+1YSd+Ox9ZzDXDobY~;qn z#7+_>r#8?G7kZ~~>CKM6kNJsT6P_)|&fEYE$;g;@l5#>ILPD>JY>;tTvq zD6kvIIJM#qgDj=8!k`~^BC^Hl4Bz}9&zuiaOPwl12Kd)kfX@miJ$tzK{EbYZ0i!3+ zbyH;*Qz2IIwzV}v9G>r!9o|yYJVykoORp>U_C@bTu)*}H? z&qjQp$LOLQBEX53>6V^ITVJ1b$`|@R3pa8yvZn;`oR7NQZ@@Y?ayBWeq`{#vKv@=@ zVlkKhFeBz^`KnwR;dvqI%%OeKU~g#1rY+IDk4ua$sCH70*!*&!>cK@r7a2LEJ2WcX z#>Yp)!k zNA0ZkNd;{W`rM-43EF7OXxZ6p8(G>HdTh1yv$*qedmRZxCG|1rDu18_}~s24~5OG1rBktGFqjx%6!|5*Kip=Jsh>;5-_Z7 z`P?yn+L!c~0Y+h^eqaz1*7fHn$HTlW)g2X@<`6UsgBqLwG2Ssb{^eN96im}qUGXRH z9wD1mPh!T~Gu7+B)JT0q=iral;ZgKP6WErZijqRFQ;~@fMq|QK_x@kg3>h$?VPR!a zE>@Y&0JyE@MJ*uNvVcKM<6lCpV`)AFO&0>I$J9J9>DhnyQf2u@4&p;?+Ek*H`Ea#xqe*%Um2X_Df literal 0 HcmV?d00001 diff --git a/packages/documentation-site/patternfly-docs/content/design-guidelines/styles/typography/typography.md b/packages/documentation-site/patternfly-docs/content/design-guidelines/styles/typography/typography.md index 7c255963f9..9a1591e50c 100644 --- a/packages/documentation-site/patternfly-docs/content/design-guidelines/styles/typography/typography.md +++ b/packages/documentation-site/patternfly-docs/content/design-guidelines/styles/typography/typography.md @@ -3,7 +3,7 @@ id: Typography section: design-foundations --- -import { Button, Grid, GridItem } from '@patternfly/react-core'; +import { Button, EmptyState, EmptyStateBody, EmptyStateVariant, Grid, GridItem, Text, TextContent, TextVariants, Title } from '@patternfly/react-core'; import CheckCircleIcon from '@patternfly/react-icons/dist/esm/icons/check-circle-icon'; import TimesCircleIcon from '@patternfly/react-icons/dist/esm/icons/times-circle-icon'; import { TypographyGrid, LineHeightTitle, SpacingContentItem, Spacer, TitleLevel, styleProps } from './typography'; @@ -11,169 +11,85 @@ import correct from './typography_correct_spacing.png'; import incorrect from './typography_incorrect_spacing.png'; import './typography.css'; -## PatternFly fonts - -PatternFly's fonts include **Red Hat Display** and **Red Hat Text**. For larger text, such as headings, use Red Hat Display. For smaller text, subheadings, and body text, use Red Hat Text, which is more readable for long-form text. You can [download PatternFly's fonts from GitHub.](https://github.com/RedHatOfficial/RedHatFont) - -## Usage - -Use typography to create visual hierarchy. A consistent and logical hierarchy makes it easier for users to quickly scan and understand information on a page. - -There are two PatternFly components that can be used to place text content on a page: the [text component](/components/text) and the [title component](/components/title). The text component should be used to create formatted blocks of text content. It accepts all general HTML text formatting tags, including heading, paragraph, and list styles. The title component is intended to be used specifically for headings or title text in components. This component is flexible and allows you to set the size of the text and heading level independently. - -## PatternFly text styles - -The following sections outline common text styles that are used in PatternFly applications, how they should be used, and list settings in a table. These tables include the following information: - -- **Text style:** The name used to refer to that text style in the [PatternFly design kit](/get-started/design#getting-the-design-kit). - -- **Font family, font weight, line height, and font size:** The styles applied to the text style. - -- **Font size CSS variable:** The CSS variable that controls the size of your text. You can customize type sizes in your application by modifying the values associated with these variables. In general, this is not advised, and should be done with caution, as changes to text style can have far reaching side effects on spacing within certain components. +You can use **typography** to create visual hierarchy in a UI. By creating a consistent and logical hierarchy, users can more quickly scan and understand information on a page. -### Super hero heading (4xl) +This page outlines PatternFly's typography principles and standards, including token values and usage information. -**Note:** Use only for extra large titles in cards or similar locations. Do not use for page titles. +You can place text content on a page using the text or title component: +- **[Text component:](/components/text)** Used to create formatted blocks of text content. Text accepts all general HTML text formatting tags, including heading, paragraph, and list styles. +- **[Title component:](/components/title)** Used specifically for headings or title text in components. Title is flexible and allows you to set the size of the text and heading level independently. - - -
    -
    - -### Hero heading (3xl) - -**Note:** Use only for extra large titles in cards or similar locations. Do not use for page titles. - - -
    -
    +## PatternFly fonts -### First level heading (2xl, H1) +We use 3 fonts in PatternFly: +- **Red Hat Display:** Used for larger text, such as headings. +- **Red Hat Text:** Used for smaller text, subheadings, and body text. More readable for long-form text. +- **Red Hat Mono:** Used to format text as code. -**Note**: Only 1 first level/H1 heading should ever exist on a page. +[Download PatternFly's fonts from GitHub.](https://github.com/RedHatOfficial/RedHatFont) - -
    -
    +### Font sizing: rem vs pixel -### Second level heading (xl, H2) +Font size tokens use rems, rather than pixels. Rems are relative units that adjust font size based on a webpage's HTML document root element size. For example, if the root size is 10px, a rem size of 1.5 would be 15px. - -
    -
    +PatternFly's default root element size is 16px. If you change this default size, note that the following tables will no longer show accurate pixel measurements (though the rem values will stay the same). -### Third level heading (lg, H3) +## Headings - -
    -
    +All headings use Red Hat Display bold. -### Fourth level heading (md, H4) +| Example | Tokens | Size | Line height | Usage | +| --- | --- | --- | --- | --- | +| Aa | --pf-t--global--font--size--heading--h1 | 1.375rem (22px) | 1.3 | Super hero headings
    H1
    Page titles | +| Aa | --pf-t--global--font--size--heading--h2 | 1.25rem (20px) | 1.3 | Hero headings
    H2 | +| Aa | --pf-t--global--font--size--heading--h3 | 1.125rem (18px) | 1.3 | H3 | +| Aa | --pf-t--global--font--size--heading--h4
    --pf-t--global--font--size--heading--h5
    --pf-t--global--font--size--heading--h6 |1rem (16px) | 1.3 | H4
    H5
    H6 | - -
    -
    +### Customizing heading levels +The [title component](/components/title) allows you to customize the visual hierarchy of text on your page, while keeping the semantic hierarchy consistent with expectations for accessibility. -### Default body text +The following table shows the default mapping of PatternFly heading levels to text size: -**Note:** This is the default text style for paragraphs, lists, tables, etc. Some components instead use Red Hat Text at 700 font weight, which is Red Hat Text Medium (such as alerts and navigation). +| Heading level | Default size | +|----|-----------| +| H1 | 2xl (1.375rem, 22px)| +| H2 | xl (1.25rem, 20px) | +| H3 | lg (1.125rem, 18px) | +| H4 | md (1 rem, 16px) | +| H5 | md (1 rem, 16px) | +| H6 | md (1 rem, 16px) | - -
    -
    +If you use the title component, you can change the text size of your heading levels to customize beyond this default behavior. -### Small text +For example, you may decide that the default size of 20px for secondary headings is too large and you want to decrease the size from 20px (xl) to 18px (lg). Instead of making your secondary headings H3’s to set the size, you should use the title component to keep them as H2 headings and change the `size` property from `xl` to `lg`. - -
    -
    +Example: -### Tiny text + This is a default "xl" H2. +``` Aa ``` - -
    -
    + This is a customized "lg" H2. +``` Aa ``` -### Code +Make sure that you maintain good visual hierarchy and mapping between heading levels and text sizes. In most cases, H1 should always be your largest heading and subheadings should get progressively smaller as you move down the hierarchy. Rare exceptions to this rule do occur, but should only be used to highlight critical data. For example, there might be scenarios where card titles use a text size that is larger than the H1 page title. -**Note:** Used for code blocks. +Refer to the [title component examples](/components/title#custom-sizes) to understand the range of customization options. - -
    -
    +## Body text -## Customizing heading levels -If you use the [title component](/components/title) to create headings on your page, you can modify the default relationship between heading levels and text sizes. When using title, you must specify a heading level that will apply to the target text. The following table shows the default mapping of heading level to text size: +All body text uses Red Hat Text. -| Heading level | Default size| -|----|-----------| -| H1 | 2xl (24px)| -| H2 | xl (20px) | -| H3 | lg (18px) | -| H4 | md (16px) | -| H5 | md (16px) | -| H6 | md (16px) | +| Example | Tokens | Size | Line height | Usage | +| --- | --- | --- | --- | --- | +|

    Aa

    | --pf-t--global--font--size--body--lg | 1rem (16px) | 1.5 | Use for larger body text, like in xl empty states. | +| Aa | --pf-t--global--font--size--body--default | 0.875rem (14px) | 1.5 | Use for standard body text. | +| Aa | --pf-t--global--font--size--body--sm | 0.75rem (12px) | 1.5 | User for smaller body text, like helper text. | -The title component allows you to customize the visual hierarchy of text on your page, while keeping the semantic hierarchy consistent with expectations for accessibility. +## Line height and spacing +The line height of your text impacts how you should use [spacers](/design-foundations/spacers) in your design. -For example, you may decide that 20px secondary headings are too large and you want to drop the size of these headings from 20px (xl) to 18px (lg). Rather than make your secondary headings H3’s, you should use the title component to keep them as H2 headings, but change the associated text size from `xl` to `lg`. You can also choose to use larger primary headers by changing the default text size as the title component will support text sizes up to 4xl (36px). +Your overall line height can be calculated by multiplying the font's built-in line height by the text size. -No matter which visual customizations you choose to make, you should always maintain good visual hierarchy and mapping between heading levels and text sizes. In most cases, H1 should always be your largest heading and subheadings should get progressively smaller as you move down the hierarchy. Exceptions to this rule do occur. For example, there might be cases where card titles will use a text size that is larger than the H1 page title. You should use this approach sparingly and only when it may be important to highlight critical data. +For example, if your font has a line height of 1.5 and a size of 16px, the final height of a line of text would be 24px (16px * 1.5 = 24px). In this example, you would consider the final line height of 24px when creating designs. -## Line height and spacing -Your text's line height has an impact on the use of [spacers](/design-foundations/spacers) in your design. - -Line height is measured in in pixels, and can be calculated by multiplying the font's built-in line height by the text size. - -For example, if a body of text uses a line height of 1.5 and the body text size is 16px, the final line height would be 24 px (16 * 1.5 = 24). In this case, include the 24px line height as part of the text when creating designs in the design software. - - - - - - Correct - -
    Include line height space when laying out text with spacers.
    - correct line height space example -
    - - - - Incorrect - -
    Don't align spacing solely to the text. Always include the line height space.
    - incorrect line height space example -
    -
    - -Note that the [text](/components/text) and [title](/components/title) components will automatically apply the proper line height and spacing according to the specified text style. +![Correct and incorrect text spacing examples.](./line-height.png)