Skip to main content

ns-illustration

Introduction#

Illustrations are visual symbols used to bring the warmth of British Gas brand and personality to the website.

Illustrations simplify products and services to users in a friendly manner. Illustrations always accompany content.

Best practice#

๐Ÿ’š Do's๐Ÿ’” Don'ts
Use them to convey depthMake the illustrations small
Use them to differentiate or define the contentUse on their own as the primary visual element
Use them to help signpostUse instead of icons
Check existing usageAlter the colours or apply visual effects

Considerations of best practices#

When choosing an illustration from the available set in Nucleus, it should be relevant to the content. Each has a descriptive name to help aid selection. (See Usage below).

Avoid unnecessary duplication of an illustration on a page. Be aware of existing usage elsewhere.

Usage#

View example on Storybook

Component placement#

The ns-illustration component can be used in a number of components to help create bespoke user interfaces (UIs).

Specification#

AttributePropertyTypeDefaultOptionsDescription
typetypestringstandardstandardType of illustration.
namenamestringgasappliance, appliance-cover, appliance-repair, battery, boiler, boiler-cover, boiler-repair, bulb, calendar, central-heating, chat, clock, compass, cosmo, document, dual-fuel, electric-charging-station, electric-vehicle, electrics, engineer, error, fix, fixed-sa, gas, green-leaf, help, home, home-insurance, laptop, low-carbon, multiple-people, oven, phone, pipe-and-drain, protect, radiator, savings, settings, sms, tap, track-engineer, van, whats-app, yellow-shield See Illustration component in StorybookPicks the illustration that is to be shown.
sizesizenumber'''', 1, 2, 3, 4, 5Changes the size of the illustration, with 1 being the smallest.
inactiveinactivestringfalsetrue, falseWill grey out the illustration.

Specification notes#

Size#

  • If you pass an empty size the icon will fill the parent element

Inactive#

  • This is for decorative purposes only (does not work in IE11).

Creating new illustrations#

If you are looking to create a new illustration, please check if there is not something similar already in use. If there is no suitable option, liaise with the brand team to define a new one and let us know so we can help with the required specification for adding it to the design system.

Read our illustration foundation page for more information on creating illustrations.

Feedback#

  • Do you have insights or concerns to share? You can raise an issue via Github bugs.
  • See all the issues already raised via Github issues.

๐Ÿ’ฉ ๐ŸŽ‰ ๐Ÿฆ„ If you have any questions, contact us on Microsoft Teams in the Nucleus Design System channels.

Related links#

  • Creating an engaging experience through illustrations and the difference between icons and illustrations in Brand Guidelines.