@comicrelief/component-library 8.52.3 → 8.53.1

package/src/components/Organisms/DonateBanner/DonateBanner.md

@@ -0,0 +1,168 @@
+# DonateBanner
+
+## Image banner (widget right), custom padding + background
+
+```js
+import data from './dev-data/data';
+const desktopPictures = require('../../../styleguide/data/data').defaultData;
+const mobilePictures = require('../../../styleguide/data/data').mobileImages;
+
+const imageL = {
+  images: desktopPictures.images,
+  imageLow: desktopPictures.imageLow,
+  alt: 'Background image'
+};
+
+const imageM = {
+  images: desktopPictures.images,
+  imageLow: desktopPictures.imageLow,
+  alt: 'Background image'
+};
+
+const imageS = {
+  images: mobilePictures.images,
+  imageLow: mobilePictures.imageLow,
+  alt: 'Background image'
+};
+
+<DonateBanner
+  pageBackgroundColour="grey_light"
+  paddingAbove="0rem"
+  paddingBelow="2rem"
+  donateOrientation="right"
+  imageL={imageL}
+  imageM={imageM}
+  imageS={imageS}
+  data={data}
+  mbshipID="mbship-1"
+  donateLink="https://donation.comicrelief.com/"
+  clientID="donate"
+  cartID="default-comicrelief"
+  title="Donate Now"
+  subtitle="Please help us fund life-changing projects in the UK and around the world."
+/>;
+```
+
+## Image banner (widget left), monthly title/subtitle + choose amount text overrides
+
+```js
+import data from './dev-data/data';
+const desktopPictures = require('../../../styleguide/data/data').defaultData;
+const mobilePictures = require('../../../styleguide/data/data').mobileImages;
+
+const imageL = {
+  images: desktopPictures.images,
+  imageLow: desktopPictures.imageLow,
+  alt: 'Background image'
+};
+
+const imageM = {
+  images: desktopPictures.images,
+  imageLow: desktopPictures.imageLow,
+  alt: 'Background image'
+};
+
+const imageS = {
+  images: mobilePictures.images,
+  imageLow: mobilePictures.imageLow,
+  alt: 'Background image'
+};
+
+<DonateBanner
+  pageBackgroundColour="grey_light"
+  paddingAbove="2rem"
+  paddingBelow="2rem"
+  donateOrientation="left"
+  imageL={imageL}
+  imageM={imageM}
+  imageS={imageS}
+  data={data}
+  mbshipID="mbship-2"
+  donateLink="https://donation.comicrelief.com/"
+  clientID="donate"
+  cartID="default-comicrelief"
+  title="Donate today"
+  subtitle="Your support can help people facing the toughest times."
+  monthlyTitle="Give monthly"
+  monthlySubtitle="A regular gift helps fund long-term impact."
+  chooseAmountText="Choose a one-off amount"
+  monthlyChooseAmountText="Choose a monthly amount"
+  popUpText="Switching to a single gift means less predictable funding."
+/>;
+```
+
+## Text-only widget (no image), custom widget background + text colour
+
+```js
+import data from './dev-data/data-single';
+
+<DonateBanner
+  donateWidgetIsTextOnly
+  pageBackgroundColour="rnd_25_glitzy_grape"
+  componentBackgroundColour="deep_violet_dark"
+  paddingAbove="2rem"
+  paddingBelow="2rem"
+  donateOrientation="right"
+  data={data}
+  mbshipID="mbship-3"
+  donateLink="https://donation.comicrelief.com/"
+  clientID="donate"
+  cartID="default-comicrelief"
+  title="Donate now"
+  subtitle="Make a difference today."
+  chooseAmountText="Enter an amount to give"
+  noMoneyBuys
+/>;
+```
+
+## Text-only widget (no image), with the usual moneybuys, standard colours
+
+```js
+import data from './dev-data/data';
+
+<DonateBanner
+  donateWidgetIsTextOnly
+  pageBackgroundColour="grey_light"
+  componentBackgroundColour="white"
+  paddingAbove="2rem"
+  paddingBelow="2rem"
+  donateOrientation="right"
+  data={data}
+  mbshipID="mbship-3b"
+  donateLink="https://donation.comicrelief.com/"
+  clientID="donate"
+  cartID="default-comicrelief"
+  title="Donate now"
+  subtitle="Choose an amount or pick a moneybuy."
+/>;
+```
+
+## Different “Other amount” copy for single vs monthly
+
+```js
+import data from './dev-data/data';
+const desktopPictures = require('../../../styleguide/data/data').defaultData;
+
+const imageL = {
+  images: desktopPictures.images,
+  imageLow: desktopPictures.imageLow,
+  alt: 'Background image'
+};
+
+<DonateBanner
+  pageBackgroundColour="grey_light"
+  paddingAbove="0rem"
+  paddingBelow="0rem"
+  donateOrientation="left"
+  imageL={imageL}
+  data={data}
+  mbshipID="mbship-4"
+  donateLink="https://donation.comicrelief.com/"
+  clientID="donate"
+  cartID="default-comicrelief"
+  title="Donate now"
+  subtitle="Help fund life-changing work."
+  otherAmountText="can help support people in crisis."
+  monthlyOtherAmountText="each month can help provide long-term support."
+/>;
+```

package/src/components/Organisms/DonateBanner/DonateBanner.style.js

@@ -0,0 +1,320 @@
+import styled, { css } from 'styled-components';
+
+import Input from '../../Atoms/Input/Input';
+import Text from '../../Atoms/Text/Text';
+import spacing from '../../../theme/shared/spacing';
+import Picture from '../../Atoms/Picture/Picture';
+import zIndex from '../../../theme/shared/zIndex';
+
+const Container = styled.div`
+  position: relative;
+  display: flex;
+  flex-direction: column;
+  justify-content: center;
+  align-items: center;
+  height: auto;
+  margin: ${({ paddingAbove, paddingBelow }) => `${paddingAbove} 0 ${paddingBelow}`};
+  background-color: ${({ theme, pageBackgroundColour }) => theme.color(pageBackgroundColour)};
+  width: 100%;
+  padding: 2rem;
+`;
+
+const InnerContainer = styled.div`
+  position: relative;
+  background-color: ${({ theme, componentBackgroundColour }) => theme.color(componentBackgroundColour)};
+  border-radius: 1rem;
+  overflow: hidden;
+  padding: none;
+  width: 100%;
+  box-sizing: border-box;
+  @media ${({ theme }) => theme.allBreakpoints('L')} {
+    padding: ${spacing('l')};
+    ${({ $donateWidgetIsTextOnly }) => $donateWidgetIsTextOnly && css`
+      padding-top: 7.5rem;
+      padding-bottom: 7.5rem;
+    `}
+  }
+  @media ${({ theme }) => theme.allBreakpoints('XL')} {
+    padding-left: ${spacing('xxl')};
+    padding-right: ${spacing('xxl')};
+  }
+  max-width: 1500px;
+`;
+
+const BgImage = styled(Picture)`
+  display: block;
+  position: absolute;
+  bottom: 0;
+  left: 0;
+  right: 0;
+  height: 100%;
+`;
+
+const Wrapper = styled.div`
+  position: relative;
+  text-align: center;
+  align-items: center;
+  display: block;
+  width: 100%;
+
+  ${({ hasTopImage, shouldShowTitleSection }) => hasTopImage && !shouldShowTitleSection && css`
+    padding: 0;
+  `}
+
+  ${({ noTitlesAtAll }) => noTitlesAtAll === true && css`
+    justify-content: center;
+  `};
+
+
+  @media ${({ theme }) => theme.allBreakpoints('L')} {
+    display: flex;
+    padding: ${spacing('l')} ${spacing('md')};
+    gap: ${spacing('l')};
+    flex-direction: row;
+  }
+`;
+
+const TitleWrapperOuter = styled.div`
+  width: 100%;
+  display: flex;
+  font-family: ${({ theme }) => theme.fontFamilies(theme.font.regular)};
+  padding-bottom: ${spacing('l')};
+  @media ${({ theme }) => theme.allBreakpoints('L')} {
+    flex: 1 1 0;
+    width: auto;
+    padding: 0;
+    align-items: center;
+    order: ${({ donateOrientation }) => (donateOrientation === 'left' ? 2 : 1)};
+  }
+`;
+
+const TitleWrapperInner = styled.div`
+  position: relative;
+  text-align: left;
+`;
+
+const FormWrapper = styled.div`
+  position: relative;
+  font-family: ${({ theme }) => theme.fontFamilies(theme.font.regular)};
+  @media ${({ theme }) => theme.allBreakpoints('L')} {
+    flex: 1 1 0;
+    min-width: 0;
+    width: auto;
+    display: flex;
+    justify-content: ${({ donateOrientation }) => (
+    donateOrientation === 'left' ? 'flex-start' : 'flex-end'
+  )};
+    order: ${({ donateOrientation }) => (donateOrientation === 'left' ? 1 : 2)};
+  }
+`;
+
+const Error = styled(Text)`
+  color: ${({ theme }) => theme.color('red')};
+  font-size: ${({ theme }) => theme.fontSize('s')};
+  font-weight: 500;
+  margin-top: ${spacing('l')};
+`;
+
+const Form = styled.form`
+  position: relative;
+  width: 100%;
+  background-color: ${({ theme }) => theme.color('white')};
+  box-shadow: 0px 0px 16px rgba(0, 0, 0, 0.15);
+
+  margin-left: auto;
+  margin-right: auto;
+
+  ${({ hasTopImage, shouldShowTitleSection }) => hasTopImage && !shouldShowTitleSection && css`
+    margin-top: 0;
+  `}
+
+  h3 {
+    margin-top: ${spacing('md')};
+  }
+
+  input {
+    max-width: 100%;
+    margin: 0;
+  }
+  input[type='submit'] {
+    margin: ${spacing('l')} 0;
+  }
+
+  @media ${({ theme }) => theme.allBreakpoints('M')} {
+    width: 100%;
+    margin-right: auto;
+    margin-left: auto;
+  }
+
+  @media ${({ theme }) => theme.allBreakpoints('L')} {
+    margin-top: ${spacing('md')};
+    border-radius: 0.5rem;
+    max-width: 461px;
+    min-width: 400px;
+    /* Alignment is handled by the outer wrapper on desktop. */
+    margin-left: 0;
+    margin-right: 0;
+  }
+`;
+
+const OuterFieldset = styled.fieldset`
+  color: ${({ theme }) => theme.color('black')};
+  padding: 0 ${spacing('md')} ${spacing('md')};
+  margin: 0;
+  border: none;
+  @media ${({ theme }) => theme.allBreakpoints('M')} {
+    padding: 0 ${spacing('l')} ${spacing('l')};
+  }
+
+  input[type='submit'] {
+    margin-bottom: 0;
+  }
+`;
+
+const Legend = styled.legend`
+  margin: 0;
+  padding: ${spacing('l')} ${spacing('sm')} 0 ${spacing('sm')};
+  display: block;
+  width: 100%;
+`;
+
+const PrimaryTitleText = styled(Text)`
+  display: block;
+  text-align: left;
+  font-size: ${({ theme }) => theme.fontSize('s')};
+  font-weight: 700;
+`;
+
+const SecondaryTitleText = styled(Text)`
+  display: block;
+  text-align: left;
+  font-size: ${({ theme }) => theme.fontSize('s')};
+  line-height: 1.5;
+  margin-top: ${spacing('sm')};
+`;
+
+const MoneyBuys = styled.div`
+  display: flex;
+  justify-content: space-between;
+  flex-direction: column;
+  margin-bottom: ${spacing('md')};
+  @media ${({ theme }) => theme.allBreakpoints('M')} {
+    flex-direction: row;
+    margin-top: ${spacing('m')};
+  }
+  label {
+    flex: 0 0 31%;
+    margin-bottom: ${spacing('sm')};
+    @media ${({ theme }) => theme.allBreakpoints('M')} {
+      margin-bottom: 0;
+    }
+    input {
+      cursor: pointer;
+      padding: ${spacing('sm')}  ${spacing('m')};
+    }
+  }
+`;
+
+const FormFieldset = styled.div`
+  display: flex;
+  flex-direction: column;
+  align-items: flex-start;
+  justify-content: flex-start;
+`;
+
+const Label = styled(Text)`
+  margin-bottom: ${spacing('sm')};
+`;
+
+const AmountField = styled(Input)`
+  position: relative;
+  flex-basis: 50%;
+  flex-shrink: 0;
+  flex-grow: 0;
+  font-weight: 400;
+  display: block;
+
+  ${({ $noMoneyBuys }) => $noMoneyBuys === true && css`
+    margin-top: ${spacing('sm')};
+  `}
+
+  @media ${({ theme }) => theme.allBreakpoints('M')} {
+    flex-basis: 60%;
+  }
+
+  span {
+    position: absolute;
+    font-size: 20px;
+    top: 50%;
+    transform: translateY(-50%);
+    left: 0px;
+    font-weight: 500;
+    padding: 0px 15px;
+    ${zIndex('high')};
+  }
+
+  input {
+    height: 48px;
+    border: 1px solid ${({ theme }) => theme.color('grey')};
+    background: ${({ theme }) => theme.color('grey_light')};
+    border-radius: 0.5rem;
+    padding: ${spacing('sm')} ${spacing('md')} ${spacing('sm')} ${spacing('l')};
+    &:focus {
+      outline: none;
+      border: 1px solid ${({ theme }) => theme.color('grey')};
+    }
+  }
+`;
+
+const Copy = styled.p`
+  line-height: 1.5;
+  margin-top: ${spacing('l')};
+  color: ${({ theme }) => theme.color('black')};
+`;
+
+const Button = styled.button`
+  width: 100%;
+  margin: ${spacing('sm')} 0 ${spacing('sm')};
+  color: ${({ theme }) => theme.color('white')};
+  font-size: ${({ theme }) => theme.fontSize('s')};
+  font-weight: bold;
+  cursor: pointer;
+  min-height: 48px;
+  background: ${({ theme, color }) => theme.color(color)};
+  text-decoration: none;
+  border-radius: 0.5rem;
+  border: none;
+  appearance: none;
+  :active,
+  :focus,
+  :hover {
+    outline: none;
+    background-color: ${({ theme }) => theme.color('coral_dark')};
+  }
+
+  @media ${({ theme }) => theme.allBreakpoints('M')} {
+    padding: ${spacing('md')} ${spacing('l')};
+  }
+`;
+
+export {
+  BgImage,
+  Button,
+  Copy,
+  Container,
+  InnerContainer,
+  Error,
+  FormFieldset,
+  FormWrapper,
+  TitleWrapperInner,
+  TitleWrapperOuter,
+  Label,
+  Wrapper,
+  Form,
+  MoneyBuys,
+  AmountField,
+  OuterFieldset,
+  Legend,
+  PrimaryTitleText,
+  SecondaryTitleText
+};

package/src/components/Organisms/DonateBanner/DonateBanner.test.js

@@ -0,0 +1,151 @@
+import React from 'react';
+import 'jest-styled-components';
+import renderWithTheme from '../../../../tests/hoc/shallowWithTheme';
+import DonateBanner from './DonateBanner';
+import data from './dev-data/data';
+import singleData from './dev-data/data-single';
+
+const defaultData = require('../../../styleguide/data/data').defaultData;
+
+it('Monthly donation renders correctly', () => {
+  const imageL = {
+    images: defaultData.pictures.images,
+    imageLow: defaultData.pictures.imageLow,
+    alt: 'Background image'
+  };
+  const imageM = {
+    images: defaultData.pictures.images,
+    imageLow: defaultData.pictures.imageLow,
+    alt: 'Background image'
+  };
+  const imageS = {
+    images: defaultData.pictures.images,
+    imageLow: defaultData.pictures.imageLow,
+    alt: 'Background image'
+  };
+
+  const tree = renderWithTheme(
+    <DonateBanner
+      pageBackgroundColour="grey_light"
+      paddingAbove="0rem"
+      paddingBelow="2rem"
+      donateOrientation="right"
+      imageL={imageL}
+      imageM={imageM}
+      imageS={imageS}
+      data={data}
+      mbshipID="mbship-1"
+      donateLink="https://donation.comicrelief.com/"
+      clientID="donate"
+      cartID="default-comicrelief"
+      title="Donate Now"
+      subtitle="Please help us fund life-changing projects in the UK and around the world."
+    />
+  ).toJSON();
+
+  expect(tree).toMatchSnapshot();
+});
+
+it('Single donation renders correctly', () => {
+  const imageL = {
+    images: defaultData.pictures.images,
+    imageLow: defaultData.pictures.imageLow,
+    alt: 'Background image'
+  };
+  const imageM = {
+    images: defaultData.pictures.images,
+    imageLow: defaultData.pictures.imageLow,
+    alt: 'Background image'
+  };
+  const imageS = {
+    images: defaultData.pictures.images,
+    imageLow: defaultData.pictures.imageLow,
+    alt: 'Background image'
+  };
+
+  const tree = renderWithTheme(
+    <DonateBanner
+      pageBackgroundColour="grey_light"
+      paddingAbove="2rem"
+      paddingBelow="2rem"
+      donateOrientation="left"
+      imageL={imageL}
+      imageM={imageM}
+      imageS={imageS}
+      data={singleData}
+      mbshipID="mbship-1"
+      donateLink="https://donation.comicrelief.com/"
+      clientID="donate"
+      cartID="default-comicrelief"
+      title="Donate Now"
+      subtitle="Please help us fund life-changing projects in the UK and around the world."
+    />
+  ).toJSON();
+
+  expect(tree).toMatchSnapshot();
+});
+
+it('Single donation with no Money Buys renders correctly', () => {
+  const imageL = {
+    images: defaultData.pictures.images,
+    imageLow: defaultData.pictures.imageLow,
+    alt: 'Background image'
+  };
+  const imageM = {
+    images: defaultData.pictures.images,
+    imageLow: defaultData.pictures.imageLow,
+    alt: 'Background image'
+  };
+  const imageS = {
+    images: defaultData.pictures.images,
+    imageLow: defaultData.pictures.imageLow,
+    alt: 'Background image'
+  };
+
+  const tree = renderWithTheme(
+    <DonateBanner
+      pageBackgroundColour="grey_light"
+      paddingAbove="0rem"
+      paddingBelow="0rem"
+      donateOrientation="right"
+      imageL={imageL}
+      imageM={imageM}
+      imageS={imageS}
+      data={singleData}
+      mbshipID="mbship-1"
+      donateLink="https://donation.comicrelief.com/"
+      clientID="donate"
+      cartID="default-comicrelief"
+      title="Donate Now"
+      noMoneyBuys
+      subtitle="Please help us fund life-changing projects in the UK and around the world."
+      chooseAmountText="Overridden choose amount text"
+    />
+  ).toJSON();
+
+  expect(tree).toMatchSnapshot();
+});
+
+it('Text-only donate widget renders correctly', () => {
+  const tree = renderWithTheme(
+    <DonateBanner
+      donateWidgetIsTextOnly
+      pageBackgroundColour="grey_light"
+      componentBackgroundColour="deep_violet_dark"
+      paddingAbove="2rem"
+      paddingBelow="2rem"
+      donateOrientation="right"
+      data={data}
+      mbshipID="mbship-4"
+      donateLink="https://donation.comicrelief.com/"
+      clientID="donate"
+      cartID="default-comicrelief"
+      title="Donate Now"
+      noMoneyBuys
+      subtitle="Please help us fund life-changing projects in the UK and around the world."
+      chooseAmountText="Enter an amount to give"
+    />
+  ).toJSON();
+
+  expect(tree).toMatchSnapshot();
+});