@reuters-graphics/graphics-components 1.0.30 → 1.1.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/actions/cssVariables/cssVariables.mdx +42 -0
- package/dist/actions/resizeObserver/resizeObserver.mdx +22 -0
- package/dist/{@types/components → components}/@types/global.d.ts +2 -2
- package/dist/components/@types/global.js +0 -1
- package/dist/components/AdSlot/@types/ads.js +0 -1
- package/dist/components/AdSlot/AdScripts.svelte +12 -15
- package/dist/components/AdSlot/AdScripts.svelte.d.ts +16 -0
- package/dist/components/AdSlot/AdSlot.svelte +27 -35
- package/dist/{@types/components → components}/AdSlot/AdSlot.svelte.d.ts +4 -2
- package/dist/components/AdSlot/InlineAd.stories.svelte +21 -0
- package/dist/components/AdSlot/InlineAd.stories.svelte.d.ts +16 -0
- package/dist/components/AdSlot/InlineAd.svelte +6 -9
- package/dist/{@types/components → components}/AdSlot/InlineAd.svelte.d.ts +5 -3
- package/dist/components/AdSlot/LeaderboardAd.stories.svelte +35 -0
- package/dist/components/AdSlot/LeaderboardAd.stories.svelte.d.ts +25 -0
- package/dist/components/AdSlot/LeaderboardAd.svelte +26 -29
- package/dist/{@types/components → components}/AdSlot/LeaderboardAd.svelte.d.ts +4 -2
- package/dist/components/AdSlot/OneTrust.svelte +34 -34
- package/dist/components/AdSlot/OneTrust.svelte.d.ts +16 -0
- package/dist/components/AdSlot/ResponsiveAd.svelte +40 -43
- package/dist/{@types/components → components}/AdSlot/ResponsiveAd.svelte.d.ts +4 -2
- package/dist/components/AdSlot/SponsorshipAd.stories.svelte +26 -0
- package/dist/components/AdSlot/SponsorshipAd.stories.svelte.d.ts +25 -0
- package/dist/components/AdSlot/SponsorshipAd.svelte +8 -13
- package/dist/{@types/components → components}/AdSlot/SponsorshipAd.svelte.d.ts +4 -2
- package/dist/components/AdSlot/adScripts/bootstrap.js +12 -7
- package/dist/components/AdSlot/adScripts/getParameterByName.d.ts +2 -0
- package/dist/components/AdSlot/adScripts/getParameterByName.js +0 -1
- package/dist/components/AdSlot/adScripts/ias.js +1 -1
- package/dist/components/AdSlot/adScripts/loadScript.js +2 -2
- package/dist/components/AdSlot/stories/docs/inline.md +46 -0
- package/dist/components/AdSlot/stories/docs/leaderboard.md +21 -0
- package/dist/components/AdSlot/stories/docs/sponsorship.md +27 -0
- package/dist/components/AdSlot/utils.js +0 -1
- package/dist/components/Analytics/Analytics.stories.svelte +42 -0
- package/dist/components/Analytics/Analytics.stories.svelte.d.ts +25 -0
- package/dist/components/Analytics/Analytics.svelte +5 -8
- package/dist/{@types/components → components}/Analytics/Analytics.svelte.d.ts +4 -2
- package/dist/components/Analytics/providers/chartbeat.js +0 -1
- package/dist/components/Analytics/providers/ga.js +1 -1
- package/dist/components/Analytics/providers/index.js +0 -1
- package/dist/components/Analytics/stories/docs/component.md +11 -0
- package/dist/components/Analytics/stories/docs/environments.md +17 -0
- package/dist/components/Analytics/stories/docs/multipage.md +31 -0
- package/dist/components/Article/Article.stories.svelte +122 -0
- package/dist/components/Article/Article.stories.svelte.d.ts +16 -0
- package/dist/components/Article/Article.svelte +13 -22
- package/dist/{@types/components → components}/Article/Article.svelte.d.ts +4 -2
- package/dist/components/Article/stories/docs/component.md +13 -0
- package/dist/components/Article/stories/docs/customWellWidths.md +87 -0
- package/dist/components/BeforeAfter/BeforeAfter.stories.svelte +116 -0
- package/dist/components/BeforeAfter/BeforeAfter.stories.svelte.d.ts +25 -0
- package/dist/components/BeforeAfter/BeforeAfter.svelte +52 -108
- package/dist/{@types/components → components}/BeforeAfter/BeforeAfter.svelte.d.ts +4 -2
- package/dist/components/BeforeAfter/stories/docs/ariaDescriptions.md +35 -0
- package/dist/components/BeforeAfter/stories/docs/component.md +15 -0
- package/dist/components/BeforeAfter/stories/docs/withOverlays.md +33 -0
- package/dist/components/BeforeAfter/stories/myrne-after.jpg +0 -0
- package/dist/components/BeforeAfter/stories/myrne-before.jpg +0 -0
- package/dist/components/Block/Block.stories.svelte +173 -0
- package/dist/components/Block/Block.stories.svelte.d.ts +25 -0
- package/dist/components/Block/Block.svelte +5 -11
- package/dist/{@types/components → components}/Block/Block.svelte.d.ts +4 -2
- package/dist/components/Block/stories/docs/component.md +15 -0
- package/dist/components/Block/stories/docs/customLayouts.md +13 -0
- package/dist/components/Block/stories/docs/snapWidths.md +50 -0
- package/dist/components/BodyText/BodyText.stories.svelte +269 -0
- package/dist/components/BodyText/BodyText.stories.svelte.d.ts +25 -0
- package/dist/components/BodyText/BodyText.svelte +5 -12
- package/dist/{@types/components → components}/BodyText/BodyText.svelte.d.ts +4 -2
- package/dist/components/BodyText/stories/docs/component.md +33 -0
- package/dist/components/Byline/Byline.stories.svelte +43 -0
- package/dist/components/Byline/Byline.stories.svelte.d.ts +25 -0
- package/dist/components/Byline/Byline.svelte +19 -50
- package/dist/{@types/components → components}/Byline/Byline.svelte.d.ts +5 -3
- package/dist/components/Byline/stories/docs/component.md +19 -0
- package/dist/components/DatawrapperChart/DatawrapperChart.stories.svelte +57 -0
- package/dist/components/DatawrapperChart/DatawrapperChart.stories.svelte.d.ts +25 -0
- package/dist/components/DatawrapperChart/DatawrapperChart.svelte +28 -68
- package/dist/{@types/components → components}/DatawrapperChart/DatawrapperChart.svelte.d.ts +4 -2
- package/dist/components/DatawrapperChart/stories/docs/component.md +25 -0
- package/dist/components/DatawrapperChart/stories/docs/withChatter.md +5 -0
- package/dist/components/DocumentCloud/DocumentCloud.stories.svelte +39 -0
- package/dist/components/DocumentCloud/DocumentCloud.stories.svelte.d.ts +25 -0
- package/dist/components/DocumentCloud/DocumentCloud.svelte +5 -19
- package/dist/{@types/components → components}/DocumentCloud/DocumentCloud.svelte.d.ts +4 -2
- package/dist/components/DocumentCloud/stories/docs/component.md +17 -0
- package/dist/components/EmbedPreviewerLink/EmbedPreviewerLink.stories.svelte +27 -0
- package/dist/components/EmbedPreviewerLink/EmbedPreviewerLink.stories.svelte.d.ts +25 -0
- package/dist/components/EmbedPreviewerLink/EmbedPreviewerLink.svelte +2 -2
- package/dist/{@types/components → components}/EmbedPreviewerLink/EmbedPreviewerLink.svelte.d.ts +4 -2
- package/dist/components/EmbedPreviewerLink/stories/docs/component.md +11 -0
- package/dist/components/EndNotes/EndNotes.stories.svelte +37 -0
- package/dist/components/EndNotes/EndNotes.stories.svelte.d.ts +25 -0
- package/dist/components/EndNotes/EndNotes.svelte +3 -8
- package/dist/{@types/components → components}/EndNotes/EndNotes.svelte.d.ts +4 -2
- package/dist/{@types/components → components}/EndNotes/docProps.d.ts +4 -4
- package/dist/components/EndNotes/docProps.js +0 -1
- package/dist/components/EndNotes/stories/docs/component.md +24 -0
- package/dist/components/FeaturePhoto/FeaturePhoto.stories.svelte +75 -0
- package/dist/components/FeaturePhoto/FeaturePhoto.stories.svelte.d.ts +25 -0
- package/dist/components/FeaturePhoto/FeaturePhoto.svelte +27 -66
- package/dist/{@types/components → components}/FeaturePhoto/FeaturePhoto.svelte.d.ts +4 -2
- package/dist/components/FeaturePhoto/stories/docs/component.md +16 -0
- package/dist/components/FeaturePhoto/stories/docs/missingAltText.md +1 -0
- package/dist/components/FeaturePhoto/stories/docs/quickit.md +38 -0
- package/dist/components/FeaturePhoto/stories/shark.jpg +0 -0
- package/dist/components/Framer/Framer.stories.svelte +29 -0
- package/dist/{@types/components/Framer/Framer.svelte.d.ts → components/Framer/Framer.stories.svelte.d.ts} +6 -10
- package/dist/components/Framer/Framer.svelte +8 -15
- package/dist/components/Framer/Framer.svelte.d.ts +31 -0
- package/dist/components/Framer/Resizer/index.svelte +1 -3
- package/dist/{@types/components/SiteHeader/MobileMenu → components/Framer/Resizer}/index.svelte.d.ts +10 -8
- package/dist/{@types/components → components}/Framer/Typeahead/fuzzy.d.ts +1 -1
- package/dist/components/Framer/Typeahead/fuzzy.js +1 -1
- package/dist/components/Framer/Typeahead/index.svelte +21 -34
- package/dist/{@types/components → components}/Framer/Typeahead/index.svelte.d.ts +34 -32
- package/dist/{@types/components → components}/Framer/stores.d.ts +0 -1
- package/dist/components/Framer/stories/docs/component.md +11 -0
- package/dist/components/GraphicBlock/AriaHidden.svelte +1 -4
- package/dist/{@types/components → components}/GraphicBlock/AriaHidden.svelte.d.ts +4 -2
- package/dist/components/GraphicBlock/GraphicBlock.stories.svelte +122 -0
- package/dist/components/GraphicBlock/GraphicBlock.stories.svelte.d.ts +25 -0
- package/dist/components/GraphicBlock/GraphicBlock.svelte +13 -63
- package/dist/{@types/components → components}/GraphicBlock/GraphicBlock.svelte.d.ts +4 -2
- package/dist/components/GraphicBlock/TextBlock.svelte +3 -4
- package/dist/{@types/components → components}/GraphicBlock/TextBlock.svelte.d.ts +4 -2
- package/dist/components/GraphicBlock/stories/ai2svelte/ai-chart.svelte +632 -0
- package/dist/components/GraphicBlock/stories/ai2svelte/ai-chart.svelte.d.ts +25 -0
- package/dist/components/GraphicBlock/stories/docs/ai2svelte.md +19 -0
- package/dist/components/GraphicBlock/stories/docs/aria.md +56 -0
- package/dist/components/GraphicBlock/stories/docs/component.md +20 -0
- package/dist/components/GraphicBlock/stories/docs/customText.md +14 -0
- package/dist/components/GraphicBlock/stories/docs/quickit.md +35 -0
- package/dist/components/GraphicBlock/stories/imgs/ai-chart-md.png +0 -0
- package/dist/components/GraphicBlock/stories/imgs/ai-chart-sm.png +0 -0
- package/dist/components/GraphicBlock/stories/imgs/ai-chart-xs.png +0 -0
- package/dist/components/GraphicBlock/stories/placeholder.png +0 -0
- package/dist/components/Headline/Headline.stories.svelte +131 -0
- package/dist/components/Headline/Headline.stories.svelte.d.ts +25 -0
- package/dist/components/Headline/Headline.svelte +29 -60
- package/dist/{@types/components → components}/Headline/Headline.svelte.d.ts +6 -4
- package/dist/components/Headline/stories/crown.png +0 -0
- package/dist/components/Headline/stories/docs/component.md +13 -0
- package/dist/components/Headline/stories/docs/customHed.md +31 -0
- package/dist/components/Headline/stories/docs/withByline.md +13 -0
- package/dist/components/Headline/stories/docs/withCrownGraphic.md +24 -0
- package/dist/components/Headline/stories/docs/withCrownImage.md +21 -0
- package/dist/components/Headline/stories/docs/withDek.md +11 -0
- package/dist/components/Headline/stories/graphic-lg.png +0 -0
- package/dist/components/Headline/stories/graphic-md.png +0 -0
- package/dist/components/Headline/stories/graphic-sm.png +0 -0
- package/dist/components/Headline/stories/graphic-xl.png +0 -0
- package/dist/components/Headline/stories/graphic-xs.png +0 -0
- package/dist/components/Headline/stories/graphic.svelte +958 -0
- package/dist/components/Headline/stories/graphic.svelte.d.ts +25 -0
- package/dist/components/HeroHeadline/Hero.stories.svelte +335 -0
- package/dist/components/HeroHeadline/Hero.stories.svelte.d.ts +25 -0
- package/dist/components/HeroHeadline/Hero.svelte +37 -98
- package/dist/{@types/components → components}/HeroHeadline/Hero.svelte.d.ts +8 -6
- package/dist/components/HeroHeadline/stories/docs/backgroundGraphic.md +84 -0
- package/dist/components/HeroHeadline/stories/docs/backgroundVideo.md +51 -0
- package/dist/components/HeroHeadline/stories/docs/component.md +20 -0
- package/dist/components/HeroHeadline/stories/docs/customHed.md +43 -0
- package/dist/components/HeroHeadline/stories/docs/inlineGraphic.md +38 -0
- package/dist/components/HeroHeadline/stories/docs/inlinePhoto.md +34 -0
- package/dist/components/HeroHeadline/stories/docs/inlineVideo.md +34 -0
- package/dist/components/HeroHeadline/stories/docs/transparentHeader.md +17 -0
- package/dist/components/HeroHeadline/stories/eurovis.jpeg +0 -0
- package/dist/components/HeroHeadline/stories/graphics/CRASH_1-lg.jpeg +0 -0
- package/dist/components/HeroHeadline/stories/graphics/CRASH_1-md.jpeg +0 -0
- package/dist/components/HeroHeadline/stories/graphics/CRASH_1-sm.jpeg +0 -0
- package/dist/components/HeroHeadline/stories/graphics/CRASH_1-xl.jpeg +0 -0
- package/dist/components/HeroHeadline/stories/graphics/CRASH_1-xl_copy.jpeg +0 -0
- package/dist/components/HeroHeadline/stories/graphics/CRASH_1-xs.jpeg +0 -0
- package/dist/components/HeroHeadline/stories/graphics/crash.svelte +637 -0
- package/dist/components/HeroHeadline/stories/graphics/crash.svelte.d.ts +25 -0
- package/dist/components/HeroHeadline/stories/graphics/quake-map-top-lg.jpeg +0 -0
- package/dist/components/HeroHeadline/stories/graphics/quake-map-top-md.jpeg +0 -0
- package/dist/components/HeroHeadline/stories/graphics/quake-map-top-sm.jpeg +0 -0
- package/dist/components/HeroHeadline/stories/graphics/quake-map-top-xl.jpeg +0 -0
- package/dist/components/HeroHeadline/stories/graphics/quake-map-top-xs.jpeg +0 -0
- package/dist/components/HeroHeadline/stories/graphics/quakemap.svelte +865 -0
- package/dist/components/HeroHeadline/stories/graphics/quakemap.svelte.d.ts +25 -0
- package/dist/components/HeroHeadline/stories/polar.jpg +0 -0
- package/dist/components/InfoBox/InfoBox.stories.svelte +51 -0
- package/dist/components/InfoBox/InfoBox.stories.svelte.d.ts +25 -0
- package/dist/components/InfoBox/InfoBox.svelte +11 -34
- package/dist/{@types/components → components}/InfoBox/InfoBox.svelte.d.ts +4 -2
- package/dist/components/InfoBox/stories/docs/component.md +17 -0
- package/dist/components/Markdown/Markdown.stories.svelte +31 -0
- package/dist/components/Markdown/Markdown.stories.svelte.d.ts +25 -0
- package/dist/components/Markdown/Markdown.svelte +14 -15
- package/dist/{@types/components → components}/Markdown/Markdown.svelte.d.ts +4 -2
- package/dist/{@types/components → components}/Markdown/stores.d.ts +0 -1
- package/dist/components/Markdown/stores.js +0 -1
- package/dist/components/Markdown/stories/docs/component.md +39 -0
- package/dist/components/PaddingReset/PaddingReset.stories.svelte +45 -0
- package/dist/components/PaddingReset/PaddingReset.stories.svelte.d.ts +25 -0
- package/dist/components/PaddingReset/PaddingReset.svelte +2 -1
- package/dist/{@types/components → components}/PaddingReset/PaddingReset.svelte.d.ts +6 -4
- package/dist/components/PaddingReset/stories/docs/component.md +35 -0
- package/dist/components/PhotoCarousel/PhotoCarousel.stories.svelte +80 -0
- package/dist/components/PhotoCarousel/PhotoCarousel.stories.svelte.d.ts +25 -0
- package/dist/components/PhotoCarousel/PhotoCarousel.svelte +31 -62
- package/dist/{@types/components → components}/PhotoCarousel/PhotoCarousel.svelte.d.ts +6 -4
- package/dist/components/PhotoCarousel/stories/docs/component.md +21 -0
- package/dist/components/PhotoCarousel/stories/docs/withCustom.md +27 -0
- package/dist/components/PhotoCarousel/stories/photos.json +72 -0
- package/dist/components/PhotoPack/PhotoPack.stories.svelte +153 -0
- package/dist/components/PhotoPack/PhotoPack.stories.svelte.d.ts +25 -0
- package/dist/components/PhotoPack/PhotoPack.svelte +30 -62
- package/dist/{@types/components → components}/PhotoPack/PhotoPack.svelte.d.ts +4 -2
- package/dist/{@types/components → components}/PhotoPack/docProps.d.ts +7 -7
- package/dist/components/PhotoPack/docProps.js +7 -10
- package/dist/components/PhotoPack/stories/docs/component.md +45 -0
- package/dist/components/PhotoPack/stories/docs/missingAltText.md +1 -0
- package/dist/components/PhotoPack/stories/docs/quickit.md +67 -0
- package/dist/components/PymChild/PymChild.stories.svelte +23 -0
- package/dist/components/PymChild/PymChild.stories.svelte.d.ts +25 -0
- package/dist/components/PymChild/PymChild.svelte +6 -7
- package/dist/{@types/components → components}/PymChild/PymChild.svelte.d.ts +4 -2
- package/dist/components/PymChild/stores.d.ts +1 -0
- package/dist/components/PymChild/stories/docs/component.md +28 -0
- package/dist/components/ReferralBlock/ReferralBlock.stories.svelte +69 -0
- package/dist/components/ReferralBlock/ReferralBlock.stories.svelte.d.ts +25 -0
- package/dist/components/ReferralBlock/ReferralBlock.svelte +33 -64
- package/dist/{@types/components → components}/ReferralBlock/ReferralBlock.svelte.d.ts +4 -2
- package/dist/components/ReferralBlock/stories/docs/collection.md +7 -0
- package/dist/components/ReferralBlock/stories/docs/component.md +15 -0
- package/dist/components/ReutersGraphicsLogo/ReutersGraphicsLogo.stories.svelte +22 -0
- package/dist/components/ReutersGraphicsLogo/ReutersGraphicsLogo.stories.svelte.d.ts +25 -0
- package/dist/components/ReutersGraphicsLogo/ReutersGraphicsLogo.svelte +22 -17
- package/dist/{@types/components → components}/ReutersGraphicsLogo/ReutersGraphicsLogo.svelte.d.ts +4 -2
- package/dist/components/ReutersGraphicsLogo/stories/docs/component.md +11 -0
- package/dist/components/ReutersLogo/ReutersLogo.stories.svelte +26 -0
- package/dist/components/ReutersLogo/ReutersLogo.stories.svelte.d.ts +25 -0
- package/dist/components/ReutersLogo/ReutersLogo.svelte +5 -7
- package/dist/{@types/components → components}/ReutersLogo/ReutersLogo.svelte.d.ts +4 -2
- package/dist/components/ReutersLogo/stories/docs/component.md +9 -0
- package/dist/components/SEO/SEO.stories.svelte +45 -0
- package/dist/components/SEO/SEO.stories.svelte.d.ts +25 -0
- package/dist/components/SEO/SEO.svelte +55 -110
- package/dist/{@types/components → components}/SEO/SEO.svelte.d.ts +4 -2
- package/dist/components/SEO/stories/docs/component.md +26 -0
- package/dist/components/SEO/stories/docs/quickit.md +29 -0
- package/dist/{@types/components → components}/Scroller/Background.svelte.d.ts +4 -2
- package/dist/components/Scroller/Embedded/Background.svelte +1 -1
- package/dist/{@types/components → components}/Scroller/Embedded/Background.svelte.d.ts +4 -2
- package/dist/components/Scroller/Embedded/Foreground.svelte +2 -2
- package/dist/{@types/components → components}/Scroller/Embedded/Foreground.svelte.d.ts +4 -2
- package/dist/components/Scroller/Embedded/index.svelte +8 -16
- package/dist/{@types/components → components}/Scroller/Embedded/index.svelte.d.ts +4 -2
- package/dist/components/Scroller/Foreground.svelte +1 -1
- package/dist/{@types/components → components}/Scroller/Foreground.svelte.d.ts +4 -2
- package/dist/components/Scroller/Scroller.stories.svelte +182 -0
- package/dist/components/Scroller/Scroller.stories.svelte.d.ts +25 -0
- package/dist/components/Scroller/Scroller.svelte +22 -97
- package/dist/{@types/components → components}/Scroller/Scroller.svelte.d.ts +4 -2
- package/dist/{@types/components → components}/Scroller/docProps.d.ts +3 -3
- package/dist/components/Scroller/docProps.js +0 -1
- package/dist/components/Scroller/stories/components/ai2svelte/ai-scroller-1.svelte +138 -0
- package/dist/components/Scroller/stories/components/ai2svelte/ai-scroller-1.svelte.d.ts +25 -0
- package/dist/components/Scroller/stories/components/ai2svelte/ai-scroller-2.svelte +282 -0
- package/dist/components/Scroller/stories/components/ai2svelte/ai-scroller-2.svelte.d.ts +25 -0
- package/dist/components/Scroller/stories/components/ai2svelte/ai-scroller-3.svelte +282 -0
- package/dist/components/Scroller/stories/components/ai2svelte/ai-scroller-3.svelte.d.ts +25 -0
- package/dist/components/Scroller/stories/components/ai2svelte/images/step-1-lg.png +0 -0
- package/dist/components/Scroller/stories/components/ai2svelte/images/step-1-md.png +0 -0
- package/dist/components/Scroller/stories/components/ai2svelte/images/step-1-sm.png +0 -0
- package/dist/components/Scroller/stories/components/ai2svelte/images/step-1-xl.png +0 -0
- package/dist/components/Scroller/stories/components/ai2svelte/images/step-1-xs.png +0 -0
- package/dist/components/Scroller/stories/components/ai2svelte/images/step-2-lg.png +0 -0
- package/dist/components/Scroller/stories/components/ai2svelte/images/step-2-md.png +0 -0
- package/dist/components/Scroller/stories/components/ai2svelte/images/step-2-sm.png +0 -0
- package/dist/components/Scroller/stories/components/ai2svelte/images/step-2-xl.png +0 -0
- package/dist/components/Scroller/stories/components/ai2svelte/images/step-2-xs.png +0 -0
- package/dist/components/Scroller/stories/components/ai2svelte/images/step-3-lg.png +0 -0
- package/dist/components/Scroller/stories/components/ai2svelte/images/step-3-md.png +0 -0
- package/dist/components/Scroller/stories/components/ai2svelte/images/step-3-sm.png +0 -0
- package/dist/components/Scroller/stories/components/ai2svelte/images/step-3-xl.png +0 -0
- package/dist/components/Scroller/stories/components/ai2svelte/images/step-3-xs.png +0 -0
- package/dist/components/Scroller/stories/components/basic/InteractiveForeground.svelte +13 -0
- package/dist/components/Scroller/stories/components/basic/InteractiveForeground.svelte.d.ts +25 -0
- package/dist/components/Scroller/stories/components/basic/Step.svelte +12 -0
- package/dist/components/Scroller/stories/components/basic/Step.svelte.d.ts +25 -0
- package/dist/components/Scroller/stories/docs/ai2svelte.md +124 -0
- package/dist/components/Scroller/stories/docs/component.md +39 -0
- package/dist/components/Scroller/stories/docs/interactive.md +36 -0
- package/dist/components/Scroller/stories/docs/quickit.md +60 -0
- package/dist/{@types/components → components}/SearchInput/MagnifyingGlass.svelte.d.ts +4 -2
- package/dist/components/SearchInput/SearchInput.stories.svelte +22 -0
- package/dist/components/SearchInput/SearchInput.stories.svelte.d.ts +25 -0
- package/dist/components/SearchInput/SearchInput.svelte +12 -16
- package/dist/{@types/components → components}/SearchInput/SearchInput.svelte.d.ts +4 -2
- package/dist/{@types/components → components}/SearchInput/X.svelte.d.ts +4 -2
- package/dist/components/SearchInput/stories/docs/component.md +17 -0
- package/dist/components/SimpleTimeline/SimpleTimeline.stories.svelte +110 -0
- package/dist/components/SimpleTimeline/SimpleTimeline.stories.svelte.d.ts +25 -0
- package/dist/components/SimpleTimeline/SimpleTimeline.svelte +12 -31
- package/dist/{@types/components → components}/SimpleTimeline/SimpleTimeline.svelte.d.ts +4 -2
- package/dist/components/SimpleTimeline/stories/docs/component.md +24 -0
- package/dist/components/SiteFooter/CompanyLinks.svelte +0 -6
- package/dist/{@types/components → components}/SiteFooter/CompanyLinks.svelte.d.ts +6 -4
- package/dist/components/SiteFooter/LegalLinks.svelte +0 -6
- package/dist/{@types/components → components}/SiteFooter/LegalLinks.svelte.d.ts +6 -4
- package/dist/components/SiteFooter/QuickLinks.svelte +0 -5
- package/dist/{@types/components → components}/SiteFooter/QuickLinks.svelte.d.ts +6 -4
- package/dist/components/SiteFooter/Referrals/IntersectionObserver.svelte +1 -1
- package/dist/{@types/components → components}/SiteFooter/Referrals/IntersectionObserver.svelte.d.ts +14 -12
- package/dist/components/SiteFooter/Referrals/Link.svelte +0 -2
- package/dist/{@types/components → components}/SiteFooter/Referrals/Link.svelte.d.ts +4 -2
- package/dist/{@types/components → components}/SiteFooter/Referrals/Referrals.svelte.d.ts +6 -4
- package/dist/components/SiteFooter/Referrals/index.svelte +1 -1
- package/dist/{@types/components/SiteHeader/NavBar → components/SiteFooter/Referrals}/index.svelte.d.ts +6 -4
- package/dist/components/SiteFooter/SiteFooter.stories.svelte +80 -0
- package/dist/components/SiteFooter/SiteFooter.stories.svelte.d.ts +25 -0
- package/dist/components/SiteFooter/SiteFooter.svelte +23 -31
- package/dist/{@types/components → components}/SiteFooter/SiteFooter.svelte.d.ts +4 -2
- package/dist/components/SiteFooter/data.json +209 -209
- package/dist/components/SiteFooter/stories/docs/component.md +11 -0
- package/dist/components/SiteFooter/stories/docs/customReferrals.md +26 -0
- package/dist/components/SiteFooter/stories/docs/darkTheme.md +11 -0
- package/dist/components/SiteFooter/stories/docs/removeReferrals.md +9 -0
- package/dist/{@types/components → components}/SiteFooter/svgs/Facebook.svelte.d.ts +6 -4
- package/dist/{@types/components → components}/SiteFooter/svgs/Graphics.svelte.d.ts +4 -2
- package/dist/{@types/components → components}/SiteFooter/svgs/Instagram.svelte.d.ts +6 -4
- package/dist/{@types/components → components}/SiteFooter/svgs/LinkedIn.svelte.d.ts +6 -4
- package/dist/{@types/components → components}/SiteFooter/svgs/Pictures.svelte.d.ts +4 -2
- package/dist/{@types/components → components}/SiteFooter/svgs/Twitter.svelte.d.ts +6 -4
- package/dist/{@types/components → components}/SiteFooter/svgs/Videos.svelte.d.ts +4 -2
- package/dist/{@types/components → components}/SiteFooter/svgs/YouTube.svelte.d.ts +6 -4
- package/dist/components/SiteHeader/MobileMenu/index.svelte +0 -5
- package/dist/{@types/components/Framer/Resizer → components/SiteHeader/MobileMenu}/index.svelte.d.ts +10 -8
- package/dist/{@types/components → components}/SiteHeader/NavBar/DownArrow.svelte.d.ts +6 -4
- package/dist/components/SiteHeader/NavBar/NavDropdown/MoreDropdown.svelte +1 -4
- package/dist/{@types/components → components}/SiteHeader/NavBar/NavDropdown/MoreDropdown.svelte.d.ts +6 -4
- package/dist/components/SiteHeader/NavBar/NavDropdown/SectionDropdown.svelte +4 -8
- package/dist/{@types/components → components}/SiteHeader/NavBar/NavDropdown/SectionDropdown.svelte.d.ts +6 -4
- package/dist/components/SiteHeader/NavBar/NavDropdown/Spinner/index.svelte +0 -1
- package/dist/{@types/components → components}/SiteHeader/NavBar/NavDropdown/Spinner/index.svelte.d.ts +4 -2
- package/dist/components/SiteHeader/NavBar/NavDropdown/StoryCard/index.svelte +1 -2
- package/dist/{@types/components → components}/SiteHeader/NavBar/NavDropdown/StoryCard/index.svelte.d.ts +6 -4
- package/dist/components/SiteHeader/NavBar/NavDropdown/index.svelte +1 -9
- package/dist/{@types/components → components}/SiteHeader/NavBar/NavDropdown/index.svelte.d.ts +6 -4
- package/dist/components/SiteHeader/NavBar/index.svelte +2 -8
- package/dist/{@types/components/SiteFooter/Referrals → components/SiteHeader/NavBar}/index.svelte.d.ts +6 -4
- package/dist/components/SiteHeader/SiteHeader.stories.svelte +47 -0
- package/dist/components/SiteHeader/SiteHeader.stories.svelte.d.ts +25 -0
- package/dist/components/SiteHeader/SiteHeader.svelte +26 -35
- package/dist/{@types/components → components}/SiteHeader/SiteHeader.svelte.d.ts +4 -2
- package/dist/components/SiteHeader/data.json +347 -1
- package/dist/components/SiteHeader/scss/_breakpoints.scss +31 -11
- package/dist/components/SiteHeader/scss/_colors.scss +3 -3
- package/dist/components/SiteHeader/scss/_grids.scss +12 -12
- package/dist/components/SiteHeader/scss/_z-indexes.scss +9 -9
- package/dist/components/SiteHeader/stories/docs/component.md +11 -0
- package/dist/components/SiteHeader/stories/docs/darkTheme.md +11 -0
- package/dist/components/SiteHeader/svgs/Close.svelte +2 -1
- package/dist/{@types/components → components}/SiteHeader/svgs/Close.svelte.d.ts +4 -2
- package/dist/{@types/components → components}/SiteHeader/svgs/Menu.svelte.d.ts +6 -4
- package/dist/components/SiteHeadline/SiteHeadline.stories.svelte +67 -0
- package/dist/components/SiteHeadline/SiteHeadline.stories.svelte.d.ts +38 -0
- package/dist/components/SiteHeadline/SiteHeadline.svelte +22 -63
- package/dist/{@types/components → components}/SiteHeadline/SiteHeadline.svelte.d.ts +4 -2
- package/dist/components/SiteHeadline/stories/docs/component.md +21 -0
- package/dist/components/SiteHeadline/stories/docs/quickit.md +30 -0
- package/dist/components/Spinner/Spinner.stories.svelte +31 -0
- package/dist/components/Spinner/Spinner.stories.svelte.d.ts +25 -0
- package/dist/components/Spinner/Spinner.svelte +1 -14
- package/dist/{@types/components → components}/Spinner/Spinner.svelte.d.ts +4 -2
- package/dist/components/Spinner/stories/docs/component.md +15 -0
- package/dist/components/Table/LeftArrow.svelte +2 -1
- package/dist/{@types/components → components}/Table/LeftArrow.svelte.d.ts +4 -2
- package/dist/components/Table/Pagination.svelte +10 -28
- package/dist/{@types/components → components}/Table/Pagination.svelte.d.ts +4 -2
- package/dist/components/Table/RightArrow.svelte +2 -1
- package/dist/{@types/components → components}/Table/RightArrow.svelte.d.ts +4 -2
- package/dist/components/Table/Select.svelte +4 -12
- package/dist/{@types/components → components}/Table/Select.svelte.d.ts +4 -2
- package/dist/components/Table/SortArrow.svelte +1 -5
- package/dist/{@types/components → components}/Table/SortArrow.svelte.d.ts +4 -2
- package/dist/components/Table/Table.stories.svelte +169 -0
- package/dist/components/Table/Table.stories.svelte.d.ts +25 -0
- package/dist/components/Table/Table.svelte +58 -152
- package/dist/{@types/components → components}/Table/Table.svelte.d.ts +4 -2
- package/dist/components/Table/stories/docs/both.md +13 -0
- package/dist/components/Table/stories/docs/component.md +14 -0
- package/dist/components/Table/stories/docs/filter.md +11 -0
- package/dist/components/Table/stories/docs/format.md +21 -0
- package/dist/components/Table/stories/docs/metadata.md +14 -0
- package/dist/components/Table/stories/docs/paginate.md +14 -0
- package/dist/components/Table/stories/docs/search.md +11 -0
- package/dist/components/Table/stories/docs/sort.md +14 -0
- package/dist/components/Table/stories/docs/style.md +23 -0
- package/dist/components/Table/stories/docs/truncate.md +11 -0
- package/dist/components/Table/stories/homeRuns.json +42 -0
- package/dist/components/Table/stories/pressFreedom.json +887 -0
- package/dist/components/Table/stories/richestWomen.json +42 -0
- package/dist/{@types/components → components}/Table/utils.d.ts +0 -2
- package/dist/components/Table/utils.js +2 -2
- package/dist/{@types/components → components}/Theme/@types/component.d.ts +8 -8
- package/dist/components/Theme/@types/component.js +0 -3
- package/dist/components/Theme/Theme.stories.svelte +145 -0
- package/dist/components/Theme/Theme.stories.svelte.d.ts +16 -0
- package/dist/components/Theme/Theme.svelte +7 -22
- package/dist/{@types/components → components}/Theme/Theme.svelte.d.ts +4 -2
- package/dist/components/Theme/stories/ThemedPage.svelte +43 -0
- package/dist/components/Theme/stories/ThemedPage.svelte.d.ts +25 -0
- package/dist/components/Theme/stories/docs/component.md +15 -0
- package/dist/components/Theme/stories/docs/customise-font.md +52 -0
- package/dist/components/Theme/stories/docs/customise.md +28 -0
- package/dist/components/Theme/stories/docs/gfonts.png +0 -0
- package/dist/components/Theme/stories/docs/inheritance.md +17 -0
- package/dist/components/Theme/stories/docs/pattern.md +40 -0
- package/dist/components/Theme/themes/common.d.ts +2 -0
- package/dist/components/Theme/themes/dark.d.ts +2 -0
- package/dist/components/Theme/themes/light.d.ts +2 -0
- package/dist/components/Theme/utils/flatten.js +2 -3
- package/dist/components/ToolsHeader/ToolsHeader.stories.svelte +31 -0
- package/dist/components/ToolsHeader/ToolsHeader.stories.svelte.d.ts +25 -0
- package/dist/components/ToolsHeader/ToolsHeader.svelte +10 -27
- package/dist/{@types/components → components}/ToolsHeader/ToolsHeader.svelte.d.ts +4 -2
- package/dist/components/ToolsHeader/stories/docs/component.md +13 -0
- package/dist/components/Video/Controls.svelte +12 -10
- package/dist/{@types/components → components}/Video/Controls.svelte.d.ts +4 -2
- package/dist/components/Video/Video.stories.svelte +95 -0
- package/dist/components/Video/Video.stories.svelte.d.ts +25 -0
- package/dist/components/Video/Video.svelte +81 -143
- package/dist/{@types/components → components}/Video/Video.svelte.d.ts +4 -2
- package/dist/components/Video/docs.svx +275 -0
- package/dist/components/Video/stories/docs/component.md +15 -0
- package/dist/components/Video/stories/docs/controls.md +38 -0
- package/dist/components/Video/stories/docs/playAndLoop.md +28 -0
- package/dist/components/Video/stories/docs/withSound.md +36 -0
- package/dist/components/Video/stories/videos/silent-video.mp4 +0 -0
- package/dist/components/Video/stories/videos/sound-video.mp4 +0 -0
- package/dist/components/Visible/Visible.stories.svelte +30 -0
- package/dist/components/Visible/Visible.stories.svelte.d.ts +25 -0
- package/dist/components/Visible/Visible.svelte +25 -36
- package/dist/{@types/components → components}/Visible/Visible.svelte.d.ts +4 -2
- package/dist/components/Visible/stories/docs/component.md +19 -0
- package/dist/components/Visible/stories/snippets/default.svelte +11 -0
- package/dist/components/Visible/stories/snippets/default.svelte.d.ts +25 -0
- package/dist/docs/actions/intro.mdx +16 -0
- package/dist/docs/contributing/component-guidelines.mdx +170 -0
- package/dist/docs/contributing/quickstart.mdx +48 -0
- package/dist/docs/contributing/story-recipes/basic-story.mdx +79 -0
- package/dist/docs/contributing/story-recipes/source-code.png +0 -0
- package/dist/docs/contributing/story-recipes/story-with-custom-controls.mdx +48 -0
- package/dist/docs/contributing/story-recipes/story-with-custom-docs.mdx +132 -0
- package/dist/docs/contributing/story-recipes/story-with-media.mdx +52 -0
- package/dist/docs/contributing/writing-component-stories.mdx +34 -0
- package/dist/docs/contributing/writing-docs-stories.mdx +39 -0
- package/dist/docs/docStyles.scss +11 -0
- package/dist/docs/docs-components/CopyColourTable/ImportSnippet.d.ts +6 -0
- package/dist/docs/docs-components/CopyColourTable/ImportSnippet.jsx +54 -0
- package/dist/docs/docs-components/CopyColourTable/Table.d.ts +10 -0
- package/dist/docs/docs-components/CopyColourTable/Table.jsx +106 -0
- package/dist/docs/docs-components/CopyColourTable/styles.module.scss +180 -0
- package/dist/docs/docs-components/CopyTable/Table.d.ts +10 -0
- package/dist/docs/docs-components/CopyTable/Table.jsx +99 -0
- package/dist/docs/docs-components/CopyTable/styles.module.scss +129 -0
- package/dist/docs/docs-components/MdxTheme/Theme.d.ts +3 -0
- package/dist/docs/docs-components/MdxTheme/Theme.jsx +29 -0
- package/dist/docs/docs-components/Mermaid/Mermaid.d.ts +2 -0
- package/dist/docs/docs-components/Mermaid/Mermaid.jsx +32 -0
- package/dist/docs/docs-components/ThemeBuilder/CSSVariables/VariableTable.d.ts +3 -0
- package/dist/docs/docs-components/ThemeBuilder/CSSVariables/VariableTable.jsx +21 -0
- package/dist/docs/docs-components/ThemeBuilder/Customiser/ColourPicker.d.ts +6 -0
- package/dist/docs/docs-components/ThemeBuilder/Customiser/ColourPicker.jsx +25 -0
- package/dist/docs/docs-components/ThemeBuilder/Customiser/Customiser.d.ts +7 -0
- package/dist/docs/docs-components/ThemeBuilder/Customiser/Customiser.jsx +27 -0
- package/dist/docs/docs-components/ThemeBuilder/Customiser/Key.d.ts +10 -0
- package/dist/docs/docs-components/ThemeBuilder/Customiser/Key.jsx +40 -0
- package/dist/docs/docs-components/ThemeBuilder/Customiser/Value.d.ts +10 -0
- package/dist/docs/docs-components/ThemeBuilder/Customiser/Value.jsx +60 -0
- package/dist/docs/docs-components/ThemeBuilder/Customiser/styles.module.scss +93 -0
- package/dist/docs/docs-components/ThemeBuilder/NewTheme/NewTheme.d.ts +6 -0
- package/dist/docs/docs-components/ThemeBuilder/NewTheme/NewTheme.jsx +55 -0
- package/dist/docs/docs-components/ThemeBuilder/NewTheme/styles.module.scss +9 -0
- package/dist/docs/docs-components/ThemeBuilder/ThemeBuilder.d.ts +3 -0
- package/dist/docs/docs-components/ThemeBuilder/ThemeBuilder.jsx +42 -0
- package/dist/docs/docs-components/ThemeBuilder/ThemeSwitch/Switch.d.ts +6 -0
- package/dist/docs/docs-components/ThemeBuilder/ThemeSwitch/Switch.jsx +28 -0
- package/dist/docs/docs-components/ThemeBuilder/ThemeSwitch/styles.module.scss +40 -0
- package/dist/docs/docs-components/ThemeBuilder/styles.module.scss +20 -0
- package/dist/docs/guides/customising-with-scss.mdx +94 -0
- package/dist/docs/guides/getting-help.mdx +30 -0
- package/dist/docs/guides/google-docs.mdx +74 -0
- package/dist/docs/guides/graphics-kit.mdx +56 -0
- package/dist/docs/guides/imgs/argstable.png +0 -0
- package/dist/docs/guides/imgs/copy-code.png +0 -0
- package/dist/docs/guides/imgs/frame.png +0 -0
- package/dist/docs/guides/imgs/intro.png +0 -0
- package/dist/docs/guides/imgs/more-stories.png +0 -0
- package/dist/docs/guides/imgs/prop.png +0 -0
- package/dist/docs/guides/imgs/quickit.png +0 -0
- package/dist/docs/guides/imgs/scss-change.png +0 -0
- package/dist/docs/guides/imgs/scss-highlight.png +0 -0
- package/dist/docs/guides/imgs/scss-inspector.png +0 -0
- package/dist/docs/guides/imgs/scss-start.png +0 -0
- package/dist/docs/guides/imgs/scss-test.png +0 -0
- package/dist/docs/guides/imgs/scss-winning.png +0 -0
- package/dist/docs/guides/imgs/slots.png +0 -0
- package/dist/docs/guides/imgs/stories.png +0 -0
- package/dist/docs/guides/using-docs.mdx +58 -0
- package/dist/docs/intro.mdx +38 -0
- package/dist/docs/layout/article-well.jpg +0 -0
- package/dist/docs/layout/intro.mdx +29 -0
- package/dist/docs/styles/colours/intro.mdx +24 -0
- package/dist/docs/styles/colours/primary.mdx +165 -0
- package/dist/docs/styles/colours/thematic.mdx +26 -0
- package/dist/docs/styles/intro.mdx +23 -0
- package/dist/docs/styles/tokens/accessibility/main.mdx +19 -0
- package/dist/docs/styles/tokens/backgrounds/main.mdx +20 -0
- package/dist/docs/styles/tokens/borders/main.mdx +46 -0
- package/dist/docs/styles/tokens/flexbox/main.mdx +113 -0
- package/dist/docs/styles/tokens/interactivity/_main.mdx +29 -0
- package/dist/docs/styles/tokens/intro.mdx +128 -0
- package/dist/docs/styles/tokens/layout/main.mdx +73 -0
- package/dist/docs/styles/tokens/sizing/main.mdx +64 -0
- package/dist/docs/styles/tokens/spacers/main.mdx +58 -0
- package/dist/docs/styles/tokens/styles.scss +9 -0
- package/dist/docs/styles/tokens/typography/main.mdx +147 -0
- package/dist/docs/styles/tokens/typography/styles.scss +9 -0
- package/dist/docs/styles/tokens/variables/main.mdx +29 -0
- package/dist/docs/theme-builder/theme-builder.mdx +14 -0
- package/dist/docs/theming/css-variables.mdx +107 -0
- package/dist/docs/utils/docsPage.d.ts +25 -0
- package/dist/docs/utils/docsPage.js +13 -0
- package/dist/docs/utils/parseCss.d.ts +3 -0
- package/dist/docs/utils/parseCss.js +48 -0
- package/dist/docs/utils/withParams.d.ts +15 -0
- package/dist/docs/utils/withParams.js +46 -0
- package/dist/globals.d.ts +6 -6
- package/dist/index.js +2 -6
- package/dist/scss/fonts/_font-faces.scss +46 -23
- package/dist/scss/reset/_normalize.scss +1 -0
- package/package.json +66 -310
- package/dist/@types/components/AdSlot/AdScripts.svelte.d.ts +0 -23
- package/dist/@types/components/AdSlot/OneTrust.svelte.d.ts +0 -23
- package/dist/@types/components/AdSlot/adScripts/getParameterByName.d.ts +0 -2
- package/dist/@types/components/PymChild/stores.d.ts +0 -2
- package/dist/@types/components/Theme/themes/common.d.ts +0 -2
- package/dist/@types/components/Theme/themes/dark.d.ts +0 -2
- package/dist/@types/components/Theme/themes/light.d.ts +0 -2
- /package/dist/{@types/actions → actions}/cssVariables/index.d.ts +0 -0
- /package/dist/{@types/actions → actions}/resizeObserver/index.d.ts +0 -0
- /package/dist/{@types/components → components}/AdSlot/@types/ads.d.ts +0 -0
- /package/dist/{@types/components → components}/AdSlot/adScripts/bootstrap.d.ts +0 -0
- /package/dist/{@types/components → components}/AdSlot/adScripts/ias.d.ts +0 -0
- /package/dist/{@types/components → components}/AdSlot/adScripts/loadScript.d.ts +0 -0
- /package/dist/{@types/components → components}/AdSlot/utils.d.ts +0 -0
- /package/dist/{@types/components → components}/Analytics/providers/chartbeat.d.ts +0 -0
- /package/dist/{@types/components → components}/Analytics/providers/ga.d.ts +0 -0
- /package/dist/{@types/components → components}/Analytics/providers/index.d.ts +0 -0
- /package/dist/{@types/components → components}/Framer/uniqNames.d.ts +0 -0
- /package/dist/{@types/components → components}/SiteHeader/NavBar/NavDropdown/StoryCard/time.d.ts +0 -0
- /package/dist/{@types/components → components}/SiteHeader/NavBar/utils/index.d.ts +0 -0
- /package/dist/{@types/components → components}/Theme/utils/flatten.d.ts +0 -0
- /package/dist/{@types/components → components}/Theme/utils/merge.d.ts +0 -0
- /package/dist/{@types/index.d.ts → index.d.ts} +0 -0
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
import { Meta } from '@storybook/blocks';
|
|
2
|
+
import { parameters } from '../../../utils/docsPage.js';
|
|
3
|
+
import CopyTable from '../../../docs-components/CopyTable/Table.jsx';
|
|
4
|
+
import { cssStringToTableArray } from '../../../utils/parseCss';
|
|
5
|
+
|
|
6
|
+
import cursor from '../../../../scss/tokens/interactivity/_cursor.scss?raw';
|
|
7
|
+
import pointerEvents from '../../../../scss/tokens/interactivity/_pointer-events.scss?raw';
|
|
8
|
+
|
|
9
|
+
<Meta title="Styles/Tokens/Interactivity" parameters={{ ...parameters }} />
|
|
10
|
+
|
|
11
|
+

|
|
12
|
+
|
|
13
|
+
# Interactivity tokens
|
|
14
|
+
|
|
15
|
+
<CopyTable
|
|
16
|
+
title="Cursor"
|
|
17
|
+
mdnLink="cursor"
|
|
18
|
+
header={['Class', 'Properties']}
|
|
19
|
+
body={cssStringToTableArray(cursor)}
|
|
20
|
+
copyable={[true, false]}
|
|
21
|
+
/>
|
|
22
|
+
|
|
23
|
+
<CopyTable
|
|
24
|
+
title="Pointer events"
|
|
25
|
+
mdnLink="pointer-events"
|
|
26
|
+
header={['Class', 'Properties']}
|
|
27
|
+
body={cssStringToTableArray(pointerEvents)}
|
|
28
|
+
copyable={[true, false]}
|
|
29
|
+
/>
|
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
import { Meta } from '@storybook/blocks';
|
|
2
|
+
import { parameters } from '../../utils/docsPage.js';
|
|
3
|
+
import Mermaid from '../../docs-components/Mermaid/Mermaid.jsx';
|
|
4
|
+
import CopyTable from '../../docs-components/CopyTable/Table.jsx';
|
|
5
|
+
import { cssStringToTableArray } from '../../utils/parseCss';
|
|
6
|
+
import './styles.scss';
|
|
7
|
+
|
|
8
|
+
import color from '../../../scss/tokens/text/_color.scss?inline';
|
|
9
|
+
|
|
10
|
+
<Meta title="Styles/Tokens/Intro" parameters={{ ...parameters }} />
|
|
11
|
+
|
|
12
|
+

|
|
13
|
+
|
|
14
|
+
# Style tokens
|
|
15
|
+
|
|
16
|
+
All of the components in this library have been styled using a system of tokens. The style tokens give us a lot of flexibility and ultimately make for the most concise CSS possible.
|
|
17
|
+
|
|
18
|
+
You can use the style tokens to help shortcut the time you spend writing CSS and reinventing solid design conventions.
|
|
19
|
+
|
|
20
|
+
## What's a "token"?
|
|
21
|
+
|
|
22
|
+
A token represents the value for an individual style rule, like `font-size` or `color`. Each token sets just one style rule, and multiple tokens are combined together to style an element, like a `<div/>`.
|
|
23
|
+
|
|
24
|
+
<Mermaid
|
|
25
|
+
name="token-graph"
|
|
26
|
+
code={`
|
|
27
|
+
graph LR;
|
|
28
|
+
A(Token)-->|1rem|B;
|
|
29
|
+
B(Style rule)-->|font-size|Y;
|
|
30
|
+
C(Token)-->|bold|D;
|
|
31
|
+
D(Style rule)-->|font-weight|Y;
|
|
32
|
+
E(Token)-->|serif|F;
|
|
33
|
+
F(Style rule)-->|font-family|Y;
|
|
34
|
+
Y(HTML Element)-->|"<div/>"|Z("<Component/>");
|
|
35
|
+
`}
|
|
36
|
+
/>
|
|
37
|
+
|
|
38
|
+
Each set of tokens has several levels that represent the different values a style rule can take in our design system and are grouped in how they're named to make them easier to remember.
|
|
39
|
+
|
|
40
|
+
<Mermaid
|
|
41
|
+
name="individual-graph"
|
|
42
|
+
code={`
|
|
43
|
+
graph LR;
|
|
44
|
+
TD("\`**Text align tokens**\`")---TA;
|
|
45
|
+
TD---TB;
|
|
46
|
+
TD---TC;
|
|
47
|
+
TA(text-left)-->TX("text-align: left;");
|
|
48
|
+
TB(text-center)-->TY("text-align: center;");
|
|
49
|
+
TC(text-right)-->TZ("text-align: right;");
|
|
50
|
+
`}
|
|
51
|
+
/>
|
|
52
|
+
|
|
53
|
+
## Using style tokens
|
|
54
|
+
|
|
55
|
+
> Whether you use style tokens or write your own custom CSS in your project is **entirely up to you**.
|
|
56
|
+
>
|
|
57
|
+
> There are hundreds of tokens, so they can be a little daunting at first. But learning the tokens for the styles you have to write most often **will absolutely save you time**, so we recommend giving them a try.
|
|
58
|
+
>
|
|
59
|
+
> **That said**, we _do recommend_ using tokens for styling typography, especially `font-size`. (Our typography size tokens use a fluid scale so your text will look great whether a reader is on a mobile phone or giant desktop.)
|
|
60
|
+
|
|
61
|
+
All of our style tokens can be used through either a class name, an SCSS mixin or both. Use the tables throughout this section of the docs to see what's available for each token.
|
|
62
|
+
|
|
63
|
+
### For example...
|
|
64
|
+
|
|
65
|
+
Here's our table of text colour tokens, which set the `text-color` style.
|
|
66
|
+
|
|
67
|
+
<CopyTable
|
|
68
|
+
title="Colour"
|
|
69
|
+
mdnLink="color"
|
|
70
|
+
header={['Class', 'Include', 'Properties']}
|
|
71
|
+
body={cssStringToTableArray(color, true)}
|
|
72
|
+
copyable={[true, (t) => `@include ${t};`, false]}
|
|
73
|
+
/>
|
|
74
|
+
|
|
75
|
+
This table's tokens can be used through either a class or an SCSS mixin. (The table lets you click-to-copy for either.)
|
|
76
|
+
|
|
77
|
+
To use the token that sets the `color` style to our "primary" text colour (i.e., black), you'd use the `Class` token like this:
|
|
78
|
+
|
|
79
|
+
```svelte
|
|
80
|
+
<p class="text-primary">Lorem ipsum...</p>
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
If you'd like to set the style in SCSS, you'd use the `Include` token like this:
|
|
84
|
+
|
|
85
|
+
```svelte
|
|
86
|
+
<p>Lorem ipsum...</p>
|
|
87
|
+
|
|
88
|
+
<style lang="scss">
|
|
89
|
+
@import '@reuters-graphics/graphics-components/scss/mixins';
|
|
90
|
+
|
|
91
|
+
p {
|
|
92
|
+
@include text-primary;
|
|
93
|
+
}
|
|
94
|
+
</style>
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
> **Note:** If you're writing SCSS _inside a component_, the `@import` above is required. If you're writing in `global.scss`, this is already included for you.
|
|
98
|
+
|
|
99
|
+
To use multiple tokens, you'd simply add another class or include:
|
|
100
|
+
|
|
101
|
+
```svelte
|
|
102
|
+
<p class="text-primary font-bold">Lorem ipsum...</p>
|
|
103
|
+
```
|
|
104
|
+
|
|
105
|
+
```scss
|
|
106
|
+
p {
|
|
107
|
+
@include text-primary;
|
|
108
|
+
@include font-bold;
|
|
109
|
+
}
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
It's normal that not every style is accounted for by our tokens, so even if you use them expect you'll still have to write your own SCSS at times. But using the pre-made tokens will shortcut a lot of time spent tweaking styles to make designs consistent across your page. The styles set by our tokens have been pre-harmonised for you!
|
|
113
|
+
|
|
114
|
+
### `!important` modifier
|
|
115
|
+
|
|
116
|
+
Most of our tokens can be used with an `!important` modifier simply by adding an `!`. So for the class token that controls `font-weight`, you'd make it important like:
|
|
117
|
+
|
|
118
|
+
```svelte
|
|
119
|
+
<p class="!font-bold">Lorem ipsum...</p>
|
|
120
|
+
```
|
|
121
|
+
|
|
122
|
+
For SCSS includes, the concept is the same, but you need to escape the `!` by adding an extra `\` to make it valid syntax:
|
|
123
|
+
|
|
124
|
+
```scss
|
|
125
|
+
p {
|
|
126
|
+
@include \!font-bold;
|
|
127
|
+
}
|
|
128
|
+
```
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
import { Meta } from '@storybook/blocks';
|
|
2
|
+
import { parameters } from '../../../utils/docsPage.js';
|
|
3
|
+
import CopyTable from '../../../docs-components/CopyTable/Table.jsx';
|
|
4
|
+
import { cssStringToTableArray } from '../../../utils/parseCss';
|
|
5
|
+
import boxSizing from '../../../../scss/tokens/layout/_box-sizing.scss?raw';
|
|
6
|
+
import display from '../../../../scss/tokens/layout/_display.scss?raw';
|
|
7
|
+
import floats from '../../../../scss/tokens/layout/_floats.scss?raw';
|
|
8
|
+
import objectFit from '../../../../scss/tokens/layout/_object-fit.scss?raw';
|
|
9
|
+
import objectPosition from '../../../../scss/tokens/layout/_object-position.scss?raw';
|
|
10
|
+
import overflow from '../../../../scss/tokens/layout/_overflow.scss?raw';
|
|
11
|
+
import position from '../../../../scss/tokens/layout/_position.scss?raw';
|
|
12
|
+
|
|
13
|
+
<Meta title="Styles/Tokens/Layout" parameters={{ ...parameters }} />
|
|
14
|
+
|
|
15
|
+

|
|
16
|
+
|
|
17
|
+
# Layout tokens
|
|
18
|
+
|
|
19
|
+
<CopyTable
|
|
20
|
+
title="Display"
|
|
21
|
+
mdnLink="display"
|
|
22
|
+
header={['Class', 'Properties']}
|
|
23
|
+
body={cssStringToTableArray(display)}
|
|
24
|
+
copyable={[true, false]}
|
|
25
|
+
/>
|
|
26
|
+
|
|
27
|
+
<CopyTable
|
|
28
|
+
title="Position"
|
|
29
|
+
mdnLink="position"
|
|
30
|
+
header={['Class', 'Properties']}
|
|
31
|
+
body={cssStringToTableArray(position)}
|
|
32
|
+
copyable={[true, false]}
|
|
33
|
+
/>
|
|
34
|
+
|
|
35
|
+
<CopyTable
|
|
36
|
+
title="Overflow"
|
|
37
|
+
mdnLink="overflow"
|
|
38
|
+
header={['Class', 'Properties']}
|
|
39
|
+
body={cssStringToTableArray(overflow)}
|
|
40
|
+
copyable={[true, false]}
|
|
41
|
+
/>
|
|
42
|
+
|
|
43
|
+
<CopyTable
|
|
44
|
+
title="Float"
|
|
45
|
+
mdnLink="float"
|
|
46
|
+
header={['Class', 'Properties']}
|
|
47
|
+
body={cssStringToTableArray(floats)}
|
|
48
|
+
copyable={[true, false]}
|
|
49
|
+
/>
|
|
50
|
+
|
|
51
|
+
<CopyTable
|
|
52
|
+
title="Box sizing"
|
|
53
|
+
mdnLink="box-sizing"
|
|
54
|
+
header={['Class', 'Properties']}
|
|
55
|
+
body={cssStringToTableArray(boxSizing)}
|
|
56
|
+
copyable={[true, false]}
|
|
57
|
+
/>
|
|
58
|
+
|
|
59
|
+
<CopyTable
|
|
60
|
+
title="Object fit"
|
|
61
|
+
mdnLink="object-fit"
|
|
62
|
+
header={['Class', 'Properties']}
|
|
63
|
+
body={cssStringToTableArray(objectFit)}
|
|
64
|
+
copyable={[true, false]}
|
|
65
|
+
/>
|
|
66
|
+
|
|
67
|
+
<CopyTable
|
|
68
|
+
title="Object position"
|
|
69
|
+
mdnLink="object-position"
|
|
70
|
+
header={['Class', 'Properties']}
|
|
71
|
+
body={cssStringToTableArray(objectPosition)}
|
|
72
|
+
copyable={[true, false]}
|
|
73
|
+
/>
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
import { Meta } from '@storybook/blocks';
|
|
2
|
+
import { parameters } from '../../../utils/docsPage.js';
|
|
3
|
+
import CopyTable from '../../../docs-components/CopyTable/Table.jsx';
|
|
4
|
+
import { cssStringToTableArray } from '../../../utils/parseCss';
|
|
5
|
+
import height from '../../../../scss/tokens/sizing/_height.scss?inline';
|
|
6
|
+
import maxHeight from '../../../../scss/tokens/sizing/_max-height.scss?inline';
|
|
7
|
+
import maxWidth from '../../../../scss/tokens/sizing/_max-width.scss?inline';
|
|
8
|
+
import minHeight from '../../../../scss/tokens/sizing/_min-height.scss?inline';
|
|
9
|
+
import minWidth from '../../../../scss/tokens/sizing/_min-width.scss?inline';
|
|
10
|
+
import width from '../../../../scss/tokens/sizing/_width.scss?inline';
|
|
11
|
+
|
|
12
|
+
<Meta title="Styles/Tokens/Sizing" parameters={{ ...parameters }} />
|
|
13
|
+
|
|
14
|
+

|
|
15
|
+
|
|
16
|
+
# Sizing tokens
|
|
17
|
+
|
|
18
|
+
<CopyTable
|
|
19
|
+
title="Width"
|
|
20
|
+
mdnLink="width"
|
|
21
|
+
header={['Class', 'Properties']}
|
|
22
|
+
body={cssStringToTableArray(width)}
|
|
23
|
+
copyable={[true, false]}
|
|
24
|
+
/>
|
|
25
|
+
|
|
26
|
+
<CopyTable
|
|
27
|
+
title="Max-width"
|
|
28
|
+
mdnLink="max-width"
|
|
29
|
+
header={['Class', 'Properties']}
|
|
30
|
+
body={cssStringToTableArray(maxWidth)}
|
|
31
|
+
copyable={[true, false]}
|
|
32
|
+
/>
|
|
33
|
+
|
|
34
|
+
<CopyTable
|
|
35
|
+
title="Min-width"
|
|
36
|
+
mdnLink="min-width"
|
|
37
|
+
header={['Class', 'Properties']}
|
|
38
|
+
body={cssStringToTableArray(minWidth)}
|
|
39
|
+
copyable={[true, false]}
|
|
40
|
+
/>
|
|
41
|
+
|
|
42
|
+
<CopyTable
|
|
43
|
+
title="Height"
|
|
44
|
+
mdnLink="height"
|
|
45
|
+
header={['Class', 'Properties']}
|
|
46
|
+
body={cssStringToTableArray(height)}
|
|
47
|
+
copyable={[true, false]}
|
|
48
|
+
/>
|
|
49
|
+
|
|
50
|
+
<CopyTable
|
|
51
|
+
title="Max-height"
|
|
52
|
+
mdnLink="max-height"
|
|
53
|
+
header={['Class', 'Properties']}
|
|
54
|
+
body={cssStringToTableArray(maxHeight)}
|
|
55
|
+
copyable={[true, false]}
|
|
56
|
+
/>
|
|
57
|
+
|
|
58
|
+
<CopyTable
|
|
59
|
+
title="Min-height"
|
|
60
|
+
mdnLink="min-height"
|
|
61
|
+
header={['Class', 'Properties']}
|
|
62
|
+
body={cssStringToTableArray(minHeight)}
|
|
63
|
+
copyable={[true, false]}
|
|
64
|
+
/>
|
|
@@ -0,0 +1,58 @@
|
|
|
1
|
+
import { Meta } from '@storybook/blocks';
|
|
2
|
+
import { parameters } from '../../../utils/docsPage.js';
|
|
3
|
+
import CopyTable from '../../../docs-components/CopyTable/Table.jsx';
|
|
4
|
+
import { cssStringToTableArray } from '../../../utils/parseCss';
|
|
5
|
+
import margin from '../../../../scss/tokens/spacers/_margin.scss?inline';
|
|
6
|
+
import padding from '../../../../scss/tokens/spacers/_padding.scss?inline';
|
|
7
|
+
import fluidMargin from '../../../../scss/tokens/spacers/_fluid-margin.scss?inline';
|
|
8
|
+
import fluidPadding from '../../../../scss/tokens/spacers/_fluid-padding.scss?inline';
|
|
9
|
+
|
|
10
|
+
<Meta title="Styles/Tokens/Spacers" parameters={{ ...parameters }} />
|
|
11
|
+
|
|
12
|
+

|
|
13
|
+
|
|
14
|
+
# Spacer tokens
|
|
15
|
+
|
|
16
|
+
Spacers include tokens that control static and fluid margins and paddings.
|
|
17
|
+
|
|
18
|
+
### What's the difference between "static" and "fluid"?
|
|
19
|
+
|
|
20
|
+
**Static** margin/padding tokens set values that don't change with the size of the viewport. These tokens are best for creating space between block-like elements — divs, pictures, videos, graphics, etc. The tables below contain dozens of levels so you can finely tune spacing, but their values also are at intervals that help you maintain consistent balance on your page.
|
|
21
|
+
|
|
22
|
+
**Fluid** token values _do change_ depending on the size of the device and are specifically designed to pair with our fluid font sizes. These tokens have fewer available levels to help make sure our typography is consistent.
|
|
23
|
+
|
|
24
|
+
As a rule of thumb, if you're setting space between or adjacent to _text elements_, you'll likely want to use **fluid tokens** (`Fluid margin`/`Fluid padding` tables). If you're setting space between _block-like elements_, you probably want **static tokens** (`Margin`/`Padding`).
|
|
25
|
+
|
|
26
|
+
---
|
|
27
|
+
|
|
28
|
+
<CopyTable
|
|
29
|
+
title="Margin"
|
|
30
|
+
mdnLink="margin"
|
|
31
|
+
header={['Class', 'Properties']}
|
|
32
|
+
body={cssStringToTableArray(margin)}
|
|
33
|
+
copyable={[true, false]}
|
|
34
|
+
/>
|
|
35
|
+
|
|
36
|
+
<CopyTable
|
|
37
|
+
title="Padding"
|
|
38
|
+
mdnLink="padding"
|
|
39
|
+
header={['Class', 'Properties']}
|
|
40
|
+
body={cssStringToTableArray(padding)}
|
|
41
|
+
copyable={[true, false]}
|
|
42
|
+
/>
|
|
43
|
+
|
|
44
|
+
<CopyTable
|
|
45
|
+
title="Fluid margin"
|
|
46
|
+
mdnLink="margin"
|
|
47
|
+
header={['Class', 'Include', 'Properties']}
|
|
48
|
+
body={cssStringToTableArray(fluidMargin, true)}
|
|
49
|
+
copyable={[true, (t) => `@include ${t};`, false]}
|
|
50
|
+
/>
|
|
51
|
+
|
|
52
|
+
<CopyTable
|
|
53
|
+
title="Fluid padding"
|
|
54
|
+
mdnLink="margin"
|
|
55
|
+
header={['Class', 'Include', 'Properties']}
|
|
56
|
+
body={cssStringToTableArray(fluidPadding, true)}
|
|
57
|
+
copyable={[true, (t) => `@include ${t};`, false]}
|
|
58
|
+
/>
|
|
@@ -0,0 +1,147 @@
|
|
|
1
|
+
import { Meta } from '@storybook/blocks';
|
|
2
|
+
import { parameters } from '../../../utils/docsPage.js';
|
|
3
|
+
import CopyTable from '../../../docs-components/CopyTable/Table.jsx';
|
|
4
|
+
import { cssStringToTableArray } from '../../../utils/parseCss';
|
|
5
|
+
import role from '../../../../scss/tokens/text/_text-role.scss?inline';
|
|
6
|
+
import color from '../../../../scss/tokens/text/_color.scss?inline';
|
|
7
|
+
import fontFamily from '../../../../scss/tokens/text/_font-family.scss?inline';
|
|
8
|
+
import fontSize from '../../../../scss/tokens/text/_font-size.scss?inline';
|
|
9
|
+
import fontStyle from '../../../../scss/tokens/text/_font-style.scss?inline';
|
|
10
|
+
import fontWeight from '../../../../scss/tokens/text/_font-weight.scss?inline';
|
|
11
|
+
import letterSpacing from '../../../../scss/tokens/text/_letter-spacing.scss?inline';
|
|
12
|
+
import lineHeight from '../../../../scss/tokens/text/_line-height.scss?inline';
|
|
13
|
+
import textAlign from '../../../../scss/tokens/text/_text-align.scss?inline';
|
|
14
|
+
import textDecoration from '../../../../scss/tokens/text/_text-decoration.scss?inline';
|
|
15
|
+
import textStroke from '../../../../scss/tokens/text/_text-stroke.scss?inline';
|
|
16
|
+
import textTransform from '../../../../scss/tokens/text/_text-transform.scss?inline';
|
|
17
|
+
import verticalAlign from '../../../../scss/tokens/text/_vertical-align.scss?inline';
|
|
18
|
+
import whiteSpace from '../../../../scss/tokens/text/_white-space.scss?inline';
|
|
19
|
+
import wordBreak from '../../../../scss/tokens/text/_word-break.scss?inline';
|
|
20
|
+
|
|
21
|
+
import './styles.scss';
|
|
22
|
+
|
|
23
|
+
<Meta title="Styles/Tokens/Typography" parameters={{ ...parameters }} />
|
|
24
|
+
|
|
25
|
+

|
|
26
|
+
|
|
27
|
+
# Typography tokens
|
|
28
|
+
|
|
29
|
+
<CopyTable
|
|
30
|
+
title="Role"
|
|
31
|
+
note="Role tokens group several individual style tokens for common text elements like headers, body text, notes and links. You can use them as a shorthand for our default typography styles."
|
|
32
|
+
header={['Class', 'Include', 'Properties']}
|
|
33
|
+
body={cssStringToTableArray(role, true)}
|
|
34
|
+
copyable={[true, (t) => `@include ${t};`, false]}
|
|
35
|
+
/>
|
|
36
|
+
|
|
37
|
+
<CopyTable
|
|
38
|
+
title="Colour"
|
|
39
|
+
mdnLink="color"
|
|
40
|
+
header={['Class', 'Include', 'Properties']}
|
|
41
|
+
body={cssStringToTableArray(color, true)}
|
|
42
|
+
copyable={[true, (t) => `@include ${t};`, false]}
|
|
43
|
+
/>
|
|
44
|
+
|
|
45
|
+
<CopyTable
|
|
46
|
+
title="Font family"
|
|
47
|
+
mdnLink="font-family"
|
|
48
|
+
header={['Class', 'Include', 'Properties']}
|
|
49
|
+
body={cssStringToTableArray(fontFamily, true)}
|
|
50
|
+
copyable={[true, (t) => `@include ${t};`, false]}
|
|
51
|
+
/>
|
|
52
|
+
|
|
53
|
+
<CopyTable
|
|
54
|
+
title="Font size"
|
|
55
|
+
mdnLink="font-size"
|
|
56
|
+
header={['Class', 'Include', 'Properties']}
|
|
57
|
+
body={cssStringToTableArray(fontSize, true)}
|
|
58
|
+
copyable={[true, (t) => `@include ${t};`, false]}
|
|
59
|
+
/>
|
|
60
|
+
|
|
61
|
+
<CopyTable
|
|
62
|
+
title="Font style"
|
|
63
|
+
mdnLink="font-style"
|
|
64
|
+
header={['Class', 'Properties']}
|
|
65
|
+
body={cssStringToTableArray(fontStyle)}
|
|
66
|
+
copyable={[true, false]}
|
|
67
|
+
/>
|
|
68
|
+
|
|
69
|
+
<CopyTable
|
|
70
|
+
title="Font weight"
|
|
71
|
+
mdnLink="font-weight"
|
|
72
|
+
header={['Class', 'Include', 'Properties']}
|
|
73
|
+
body={cssStringToTableArray(fontWeight, true)}
|
|
74
|
+
copyable={[true, (t) => `@include ${t};`, false]}
|
|
75
|
+
/>
|
|
76
|
+
|
|
77
|
+
<CopyTable
|
|
78
|
+
title="Letter spacing"
|
|
79
|
+
mdnLink="letter-spacing"
|
|
80
|
+
header={['Class', 'Include', 'Properties']}
|
|
81
|
+
body={cssStringToTableArray(letterSpacing, true)}
|
|
82
|
+
copyable={[true, (t) => `@include ${t};`, false]}
|
|
83
|
+
/>
|
|
84
|
+
|
|
85
|
+
<CopyTable
|
|
86
|
+
title="Line height"
|
|
87
|
+
mdnLink="line-height"
|
|
88
|
+
header={['Class', 'Include', 'Properties']}
|
|
89
|
+
body={cssStringToTableArray(lineHeight, true)}
|
|
90
|
+
copyable={[true, (t) => `@include ${t};`, false]}
|
|
91
|
+
/>
|
|
92
|
+
|
|
93
|
+
<CopyTable
|
|
94
|
+
title="Text align"
|
|
95
|
+
mdnLink="text-align"
|
|
96
|
+
header={['Class', 'Properties']}
|
|
97
|
+
body={cssStringToTableArray(textAlign)}
|
|
98
|
+
copyable={[true, false]}
|
|
99
|
+
/>
|
|
100
|
+
|
|
101
|
+
<CopyTable
|
|
102
|
+
title="Text decoration"
|
|
103
|
+
mdnLink="text-decoration"
|
|
104
|
+
header={['Class', 'Properties']}
|
|
105
|
+
body={cssStringToTableArray(textDecoration)}
|
|
106
|
+
copyable={[true, false]}
|
|
107
|
+
/>
|
|
108
|
+
|
|
109
|
+
<CopyTable
|
|
110
|
+
title="Text stroke"
|
|
111
|
+
mdnLink="text-stroke"
|
|
112
|
+
header={['Class', 'Properties']}
|
|
113
|
+
body={cssStringToTableArray(textStroke)}
|
|
114
|
+
copyable={[true, false]}
|
|
115
|
+
/>
|
|
116
|
+
|
|
117
|
+
<CopyTable
|
|
118
|
+
title="Text transform"
|
|
119
|
+
mdnLink="text-transform"
|
|
120
|
+
header={['Class', 'Properties']}
|
|
121
|
+
body={cssStringToTableArray(textTransform)}
|
|
122
|
+
copyable={[true, false]}
|
|
123
|
+
/>
|
|
124
|
+
|
|
125
|
+
<CopyTable
|
|
126
|
+
title="Vertical align"
|
|
127
|
+
mdnLink="vertical-align"
|
|
128
|
+
header={['Class', 'Properties']}
|
|
129
|
+
body={cssStringToTableArray(verticalAlign)}
|
|
130
|
+
copyable={[true, false]}
|
|
131
|
+
/>
|
|
132
|
+
|
|
133
|
+
<CopyTable
|
|
134
|
+
title="White space"
|
|
135
|
+
mdnLink="white-space"
|
|
136
|
+
header={['Class', 'Properties']}
|
|
137
|
+
body={cssStringToTableArray(whiteSpace)}
|
|
138
|
+
copyable={[true, false]}
|
|
139
|
+
/>
|
|
140
|
+
|
|
141
|
+
<CopyTable
|
|
142
|
+
title="Word break"
|
|
143
|
+
mdnLink="word-break"
|
|
144
|
+
header={['Class', 'Properties']}
|
|
145
|
+
body={cssStringToTableArray(wordBreak)}
|
|
146
|
+
copyable={[true, false]}
|
|
147
|
+
/>
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
import { Meta } from '@storybook/blocks';
|
|
2
|
+
import { parameters } from '../../../utils/docsPage.js';
|
|
3
|
+
import CopyTable from '../../../docs-components/CopyTable/Table.jsx';
|
|
4
|
+
import { scssVariablesToTableArray } from '../../../utils/parseCss';
|
|
5
|
+
|
|
6
|
+
import theme from '../../../../scss/tokens/variables/_theme.scss?raw';
|
|
7
|
+
import block from '../../../../scss/tokens/variables/_block.scss?raw';
|
|
8
|
+
|
|
9
|
+
<Meta title="Styles/Tokens/SCSS Variables" parameters={{ ...parameters }} />
|
|
10
|
+
|
|
11
|
+

|
|
12
|
+
|
|
13
|
+
# Token variables
|
|
14
|
+
|
|
15
|
+
These are SCSS mirrors of some of the default CSS variables used in the `Theme`. Use them in places where CSS variables cannot be used. e.g. You can write `media-queries` to target the block widths using the `block` vars, which is not possible using CSS variables.
|
|
16
|
+
|
|
17
|
+
<CopyTable
|
|
18
|
+
title="Theme"
|
|
19
|
+
header={['Variable', 'Properties']}
|
|
20
|
+
body={scssVariablesToTableArray(theme)}
|
|
21
|
+
copyable={[true, false]}
|
|
22
|
+
/>
|
|
23
|
+
|
|
24
|
+
<CopyTable
|
|
25
|
+
title="Block"
|
|
26
|
+
header={['Variable', 'Properties']}
|
|
27
|
+
body={scssVariablesToTableArray(block)}
|
|
28
|
+
copyable={[true, false]}
|
|
29
|
+
/>
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
import { Meta } from '@storybook/blocks';
|
|
2
|
+
import { parameters } from '../utils/docsPage.js';
|
|
3
|
+
|
|
4
|
+
import ThemeBuilder from './../docs-components/ThemeBuilder/ThemeBuilder.jsx';
|
|
5
|
+
|
|
6
|
+
<Meta title="Theming/Theme builder" parameters={{ ...parameters }} />
|
|
7
|
+
|
|
8
|
+

|
|
9
|
+
|
|
10
|
+
# Theme builder
|
|
11
|
+
|
|
12
|
+
Use this tool to create a custom theme for your page then update the `Theme` component in your project.
|
|
13
|
+
|
|
14
|
+
<ThemeBuilder />
|
|
@@ -0,0 +1,107 @@
|
|
|
1
|
+
import { Meta } from '@storybook/blocks';
|
|
2
|
+
import { parameters } from '../utils/docsPage.js';
|
|
3
|
+
|
|
4
|
+
<Meta title="Theming/CSS variables" parameters={{ ...parameters }} />
|
|
5
|
+
|
|
6
|
+

|
|
7
|
+
|
|
8
|
+
# CSS variables
|
|
9
|
+
|
|
10
|
+
The [`Theme`](?path=/docs/components-theme--default) component uses **[CSS variables](https://developer.mozilla.org/en-US/docs/Web/CSS/Using_CSS_custom_properties)** to control major parts of your page's theme.
|
|
11
|
+
|
|
12
|
+
All other components in this library use those variables for styling basic colours and typography, helping keep our pages uniform and making it easier to customise the theme. CSS variables also allow our clients to easily change elements of our theme to match their brand.
|
|
13
|
+
|
|
14
|
+
This doc explains which variables are set and how you can use them in custom components you create.
|
|
15
|
+
|
|
16
|
+
> **Note:** CSS variables do not currently affect [ai2svelte](https://github.com/reuters-graphics/ai2svelte/) graphics, so you should continue to make sure your colours match the theme of your page directly in Adobe Illustrator for those graphics.
|
|
17
|
+
|
|
18
|
+
## Using CSS variables directly
|
|
19
|
+
|
|
20
|
+
If you're new to how CSS variables work, [here's a video](https://www.youtube.com/watch?v=PHO6TBq_auI) that does a decent job explaining what they are, how they work and why they're useful.
|
|
21
|
+
|
|
22
|
+
You can use any of the CSS variables the `Theme` component sets in your own code with the [`var()`](https://www.w3schools.com/css/css3_variables.asp) function.
|
|
23
|
+
|
|
24
|
+
```svelte
|
|
25
|
+
<p>My custom text</p>
|
|
26
|
+
|
|
27
|
+
<style lang="scss">
|
|
28
|
+
p {
|
|
29
|
+
color: var(--theme-colour-text-primary);
|
|
30
|
+
font-family: var(--theme-font-family-sans-serif);
|
|
31
|
+
}
|
|
32
|
+
</style>
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
## Customising variables
|
|
36
|
+
|
|
37
|
+
You can redefine any of the above CSS variables in the `<Theme>` component. Read more in [the docs](/docs/theming-theme--custom-theme) and **use the [Theme builder](/docs/theming-theme-builder--docs)**.
|
|
38
|
+
|
|
39
|
+
```svelte
|
|
40
|
+
<Theme
|
|
41
|
+
base="light"
|
|
42
|
+
theme="{{
|
|
43
|
+
colour: {
|
|
44
|
+
// This replaces the default text-secondary colour '#666666' for light theme
|
|
45
|
+
'text-secondary': '#213310',
|
|
46
|
+
},
|
|
47
|
+
}}"
|
|
48
|
+
>
|
|
49
|
+
<!-- page stuff -->
|
|
50
|
+
</Theme>
|
|
51
|
+
```
|
|
52
|
+
|
|
53
|
+
## Adding extra variables
|
|
54
|
+
|
|
55
|
+
You can even add custom variables through the `Theme` component.
|
|
56
|
+
|
|
57
|
+
For example, let's say you want to define a border radius for some card elements on your page. You can add a custom property to the `theme` prop like this:
|
|
58
|
+
|
|
59
|
+
```svelte
|
|
60
|
+
<Theme
|
|
61
|
+
base="light"
|
|
62
|
+
theme="{{
|
|
63
|
+
style: {
|
|
64
|
+
'border-radius': '22px',
|
|
65
|
+
},
|
|
66
|
+
}}"
|
|
67
|
+
>
|
|
68
|
+
<!-- page stuff -->
|
|
69
|
+
</Theme>
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
... and then access the CSS variable in your code like this:
|
|
73
|
+
|
|
74
|
+
```svelte
|
|
75
|
+
<div class="card"></div>
|
|
76
|
+
|
|
77
|
+
<style lang="scss">
|
|
78
|
+
.card {
|
|
79
|
+
border-radius: var(--theme-style-border-radius);
|
|
80
|
+
}
|
|
81
|
+
</style>
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
Using the `Theme` component for your own CSS variables helps unify important style values across a project. It also lets clients more easily customise those values for whatever matches their brand.
|
|
85
|
+
|
|
86
|
+
You can also change a variable's value based on some condition. For example, to set a smaller border radius on mobile screens, you might:
|
|
87
|
+
|
|
88
|
+
```svelte
|
|
89
|
+
<script>
|
|
90
|
+
// other code
|
|
91
|
+
|
|
92
|
+
let windowWidth;
|
|
93
|
+
</script>
|
|
94
|
+
|
|
95
|
+
<svelte:window bind:innerWidth="{windowWidth}" />
|
|
96
|
+
|
|
97
|
+
<Theme
|
|
98
|
+
base="light"
|
|
99
|
+
theme="{{
|
|
100
|
+
style: {
|
|
101
|
+
'border-radius': windowWidth > 475 ? '22px' : '11px',
|
|
102
|
+
},
|
|
103
|
+
}}"
|
|
104
|
+
>
|
|
105
|
+
<!-- page stuff -->
|
|
106
|
+
</Theme>
|
|
107
|
+
```
|