42 lines
5.6 KiB
JavaScript
42 lines
5.6 KiB
JavaScript
import{j as e,p as i}from"./docsPage-CrCNk6vV.js";import{useMDXComponents as r}from"./index-CswL0fy2.js";import{M as o}from"./index-BSnnmD0I.js";import"./index-DwChlhAQ.js";import"./_commonjsHelpers-BosuxZz1.js";import"./index-D-8MO0q_.js";import"./iframe-BssUzINi.js";import"../sb-preview/runtime.js";import"./index-DxKRhftL.js";import"./index-DrFu-skq.js";const c=""+new URL("scss-start-BVE0yKS1.png",import.meta.url).href,a=""+new URL("scss-highlight-DJgSTLTu.png",import.meta.url).href,h=""+new URL("scss-inspector-DX09FcYW.png",import.meta.url).href,l=""+new URL("scss-change-0EQn-a_A.png",import.meta.url).href,d=""+new URL("scss-test-D0OKY1jS.png",import.meta.url).href,p=""+new URL("scss-winning-Bu-D1jUf.png",import.meta.url).href;function n(t){const s={code:"code",em:"em",h1:"h1",h2:"h2",h4:"h4",img:"img",p:"p",pre:"pre",strong:"strong",...r(),...t.components};return e.jsxs(e.Fragment,{children:[e.jsx(o,{title:"Guides/Customising components with SCSS",parameters:{...i}}),`
|
||
`,e.jsx(s.p,{children:e.jsx(s.img,{src:"https://graphics.thomsonreuters.com/style-assets/images/logos/reuters-graphics-logo/svg/graphics-logo-color-dark.svg",alt:""})}),`
|
||
`,e.jsx(s.h1,{id:"customising-components-with-scss",children:"Customising components with SCSS"}),`
|
||
`,e.jsx(s.p,{children:"One of the most powerful ways to customise components isn't props or, even, Svelte."}),`
|
||
`,e.jsx("p",{className:"sbdocs-p",children:e.jsx("span",{className:"highlight bold",children:e.jsx(s.p,{children:"It’s SCSS and your web inspector!"})})}),`
|
||
`,e.jsx(s.h2,{id:"hows-that",children:"How's that??"}),`
|
||
`,e.jsxs(s.p,{children:["Let's say you wanted to change our ",e.jsx(s.code,{children:"BeforeAfter"})," component. You want the text overlays to be at the bottom of the image instead of the top like this:"]}),`
|
||
`,e.jsx("img",{src:c,width:"600"}),`
|
||
`,e.jsxs(s.p,{children:["The first thing you should do is ",e.jsx("span",{className:"highlight",children:"check out the elements you want to change in your web inspector"})," and see if CSS can make the change you want."]}),`
|
||
`,e.jsx("img",{src:a,width:"300",style:{margin:"0 0 1rem"}}),`
|
||
`,e.jsx("img",{src:h,width:"100%"}),`
|
||
`,e.jsxs(s.p,{children:["In our case, we want to change the absolute position of those elements. To test that'll actually work, we can ",e.jsx("span",{className:"highlight",children:"try it directly in the inspector first!"})]}),`
|
||
`,e.jsx("img",{src:l,width:"500",style:{margin:"0 0 1rem"}}),`
|
||
`,e.jsx("img",{src:d,width:"600",style:{margin:"0 0 1rem"}}),`
|
||
`,e.jsxs(s.p,{children:["Now that we know we can change what we need through CSS it's time to write some SCSS, either in your ",e.jsx(s.code,{children:"global.scss"})," file or directly in a component like ",e.jsx(s.code,{children:"App.svelte"}),"."]}),`
|
||
`,e.jsx(s.p,{children:"First, let's look at the class of the style rule we changed in the inspector:"}),`
|
||
`,e.jsx(s.p,{children:e.jsx(s.code,{children:"figure.before-after-container.s-khJY-w4TYkp5 .overlay-container.before.s-khJY-w4TYkp5"})}),`
|
||
`,e.jsxs(s.p,{children:["One thing we always need to do is ",e.jsx("span",{className:"highlight",children:"strip out any Svelte class names"}),", i.e., those weird ",e.jsx(s.code,{children:".s-khJY-w4TYkp5"})," classes. Why? Those are random classes Svelte adds to CSS, and we can't guarantee they won't change."]}),`
|
||
`,e.jsx(s.p,{children:"That leaves us with:"}),`
|
||
`,e.jsx(s.p,{children:e.jsx(s.code,{children:"figure.before-after-container .overlay-container.before"})}),`
|
||
`,e.jsxs(s.p,{children:["But we need our style rule to ",e.jsx(s.em,{children:"beat"})," the original style in the CSS cascade, and right now, it's less specific without those class names we stripped."]}),`
|
||
`,e.jsxs(s.p,{children:["The easiest way to make sure your style rule wins out is to ",e.jsx("span",{className:"highlight",children:"add an ID either directly to the element or to a parent"}),". In our case, let's add an ID through the ",e.jsx(s.code,{children:"BeforeAfter"})," ",e.jsx(s.code,{children:"id"})," prop. Now we can use it! (For extra credit, though, we'll drop the ",e.jsx(s.code,{children:".before"})," so our new style rule applies to ",e.jsx(s.em,{children:"both"})," overlays.)"]}),`
|
||
`,e.jsx(s.pre,{children:e.jsx(s.code,{className:"language-scss",children:`figure#my-before-after .overlay-container {
|
||
bottom: 0;
|
||
}
|
||
`})}),`
|
||
`,e.jsx(s.p,{children:"Now our selector is more specific. We win!"}),`
|
||
`,e.jsxs(s.p,{children:["If you don't see a way to add an ID through a component's props, then just wrap the component in a ",e.jsx(s.code,{children:"div"})," in your code:"]}),`
|
||
`,e.jsx(s.pre,{children:e.jsx(s.code,{className:"language-svelte",children:`<div id="my-before-after">
|
||
<BeforeAfter />
|
||
</div>
|
||
`})}),`
|
||
`,e.jsx(s.p,{children:"... and use that, instead!"}),`
|
||
`,e.jsx(s.pre,{children:e.jsx(s.code,{className:"language-scss",children:`div#my-before-after figure .overlay-container {
|
||
bottom: 0;
|
||
}
|
||
`})}),`
|
||
`,e.jsxs(s.p,{children:["We can ",e.jsx("span",{className:"highlight",children:"confirm the new style rule is winning by looking at its order back in our web inspector!"})]}),`
|
||
`,e.jsx("img",{src:p,width:"500",style:{margin:"0 0 1rem"}}),`
|
||
`,e.jsx(s.p,{children:"Done!"}),`
|
||
`,e.jsxs(s.h4,{id:"can-i-just-important-it",children:["Can I just... ",e.jsx(s.code,{children:"important!"})," it?"]}),`
|
||
`,e.jsxs(s.p,{children:["Yep, as a last result. Just be sure your style rule is ",e.jsx(s.strong,{children:"very specific"})," and not something generic that might apply to other elements like ",e.jsx(s.code,{children:"div.container"}),"."]})]})}function v(t={}){const{wrapper:s}={...r(),...t.components};return s?e.jsx(s,{...t,children:e.jsx(n,{...t})}):n(t)}export{v as default};
|