From 3b3ff86310d3d33c80bdb6f8ecbbec3b845d6f55 Mon Sep 17 00:00:00 2001
From: HANA <hana@truss.works>
Date: Tue, 5 May 2020 10:10:05 -0500
Subject: [PATCH] Add medium footer  (#126)

* Add FooterNav, SocialLinks components
* Add medium Footer story
* Add medium styles to Logo, Address components
---
 src/components/Footer/Address/Address.tsx     |  46 +++++--
 src/components/Footer/Footer.stories.tsx      | 123 ++++++++++++------
 src/components/Footer/Footer.tsx              |  23 ++--
 .../Footer/FooterNav/FooterNav.stories.tsx    |  37 ++++++
 .../Footer/FooterNav/FooterNav.test.tsx       |  23 ++++
 src/components/Footer/FooterNav/FooterNav.tsx |  36 +++++
 src/components/Footer/Logo/Logo.tsx           |   9 +-
 .../SocialLinks/SocialLinks.stories.tsx       |  28 ++++
 .../Footer/SocialLinks/SocialLinks.test.tsx   |  29 +++++
 .../Footer/SocialLinks/SocialLinks.tsx        |  22 ++++
 10 files changed, 309 insertions(+), 67 deletions(-)
 create mode 100644 src/components/Footer/FooterNav/FooterNav.stories.tsx
 create mode 100644 src/components/Footer/FooterNav/FooterNav.test.tsx
 create mode 100644 src/components/Footer/FooterNav/FooterNav.tsx
 create mode 100644 src/components/Footer/SocialLinks/SocialLinks.stories.tsx
 create mode 100644 src/components/Footer/SocialLinks/SocialLinks.test.tsx
 create mode 100644 src/components/Footer/SocialLinks/SocialLinks.tsx

diff --git a/src/components/Footer/Address/Address.tsx b/src/components/Footer/Address/Address.tsx
index 599f202f88..29a8e2850e 100644
--- a/src/components/Footer/Address/Address.tsx
+++ b/src/components/Footer/Address/Address.tsx
@@ -1,6 +1,9 @@
 import React from 'react'
-
+import classnames from 'classnames'
 type AddressProps = {
+  big?: boolean
+  medium?: boolean
+  slim?: boolean
   /* 
     Contact info items - e.g. anchor tags or text for email, phone, website, etc.
   */
@@ -8,17 +11,34 @@ type AddressProps = {
 }
 
 export const Address = ({
+  big,
+  medium,
+  slim,
   items,
-}: AddressProps & React.HTMLAttributes<HTMLElement>): React.ReactElement => (
-  <address className="usa-footer__address">
-    <div className="grid-row grid-gap">
-      {items.map((item, i) => (
-        <div
-          className="grid-col-auto mobile-lg:grid-col-12 desktop:grid-col-auto"
-          key={`addressItem-${i}`}>
-          <div className="usa-footer__contact-info">{item}</div>
+}: AddressProps & React.HTMLAttributes<HTMLElement>): React.ReactElement => {
+  const itemClasses = classnames({
+    'grid-col-auto': big || medium,
+    'grid-col-auto mobile-lg:grid-col-12 desktop:grid-col-auto': slim,
+  })
+  return (
+    <address className="usa-footer__address">
+      {slim ? (
+        <div className="grid-row grid-gap">
+          {items.map((item, i) => (
+            <div className={itemClasses} key={`addressItem-${i}`}>
+              <div className="usa-footer__contact-info">{item}</div>
+            </div>
+          ))}
+        </div>
+      ) : (
+        <div className="usa-footer__contact-info grid-row grid-gap">
+          {items.map((item, i) => (
+            <div className={itemClasses} key={`addressItem-${i}`}>
+              {item}
+            </div>
+          ))}
         </div>
-      ))}
-    </div>
-  </address>
-)
+      )}
+    </address>
+  )
+}
diff --git a/src/components/Footer/Footer.stories.tsx b/src/components/Footer/Footer.stories.tsx
index abd9d67afe..c77187f5fe 100644
--- a/src/components/Footer/Footer.stories.tsx
+++ b/src/components/Footer/Footer.stories.tsx
@@ -1,11 +1,12 @@
 /*  eslint-disable jsx-a11y/anchor-is-valid */
 import React from 'react'
-import classnames from 'classnames'
 
 import { Address } from './Address/Address'
 import { Button } from '../Button/Button'
 import { Footer } from './Footer'
+import { FooterNav } from './FooterNav/FooterNav'
 import { Logo } from './Logo/Logo'
+import { SocialLinks } from './SocialLinks/SocialLinks'
 
 export default {
   title: 'Footer',
@@ -18,42 +19,6 @@ export default {
   },
 }
 
-type SizeProps = {
-  big?: boolean
-  medium?: boolean
-  slim?: boolean
-}
-
-// Placeholder until a dynamic Nav is built out and can be used
-const MockNav = ({ medium, slim }: SizeProps): React.ReactElement => {
-  const itemClasses = classnames(
-    'desktop:grid-col-auto usa-footer__primary-content',
-    {
-      'mobile-lg:grid-col-4': medium,
-      'mobile-lg:grid-col-6': slim,
-    }
-  )
-
-  const items = Array(4).fill({
-    href: 'javascript:void(0);',
-    heading: 'Primary Link',
-  })
-
-  return (
-    <nav className="usa-footer__nav" aria-label="Footer navigation">
-      <ul className="grid-row grid-gap">
-        {items.map((item, i) => (
-          <li key={`navItem-${i}`} className={itemClasses}>
-            <a className="usa-footer__primary-link" href={item.href}>
-              {item.heading}
-            </a>
-          </li>
-        ))}
-      </ul>
-    </nav>
-  )
-}
-
 const returnToTop = (
   <div className="grid-container usa-footer__return-to-top">
     <Button type="button" unstyled>
@@ -69,10 +34,18 @@ export const SlimFooter = (): React.ReactElement => (
     primary={
       <div className="usa-footer__primary-container grid-row">
         <div className="mobile-lg:grid-col-8">
-          <MockNav slim />
+          <FooterNav
+            slim
+            links={Array(4).fill(
+              <a className="usa-footer__primary-link" href="#">
+                Primary Link
+              </a>
+            )}
+          />
         </div>
         <div className="tablet:grid-col-4">
           <Address
+            slim
             items={[
               <a key="telephone" href="tel:1-800-555-5555">
                 (800) CALL-GOVT
@@ -100,3 +73,77 @@ export const SlimFooter = (): React.ReactElement => (
     }
   />
 )
+
+export const MediumFooter = (): React.ReactElement => (
+  <Footer
+    medium
+    returnToTop={returnToTop}
+    primary={
+      <FooterNav
+        medium
+        links={Array(4).fill(
+          <a className="usa-footer__primary-link" href="#">
+            Primary Link
+          </a>
+        )}
+      />
+    }
+    secondary={
+      <div className="grid-row grid-gap">
+        <Logo
+          medium
+          image={
+            <img
+              className="usa-footer__logo-img"
+              src="/logo-img.png"
+              alt="img alt text"
+            />
+          }
+          heading={<h3 className="usa-footer__logo-heading">Name of Agency</h3>}
+        />
+        <div className="usa-footer__contact-links mobile-lg:grid-col-6">
+          <SocialLinks
+            links={[
+              <a
+                key="facebook"
+                className="usa-social-link usa-social-link--facebook"
+                href="#">
+                <span>Facebook</span>
+              </a>,
+              <a
+                key="twitter"
+                className="usa-social-link usa-social-link--twitter"
+                href="#">
+                <span>Twitter</span>
+              </a>,
+              <a
+                key="youtube"
+                className="usa-social-link usa-social-link--youtube"
+                href="#">
+                <span>YouTube</span>
+              </a>,
+              <a
+                key="rss"
+                className="usa-social-link usa-social-link--rss"
+                href="#">
+                <span>RSS</span>
+              </a>,
+            ]}
+          />
+          <h3 className="usa-footer__contact-heading">Agency Contact Center</h3>
+          <Address
+            medium
+            items={[
+              <a key="telephone" href="tel:1-800-555-5555">
+                (800) CALL-GOVT
+              </a>,
+              <a key="email" href="mailto:info@agency.gov">
+                info@agency.gov
+              </a>,
+            ]}
+          />
+        </div>
+      </div>
+    }
+  />
+)
diff --git a/src/components/Footer/Footer.tsx b/src/components/Footer/Footer.tsx
index 2ade39aeae..a550a7252e 100644
--- a/src/components/Footer/Footer.tsx
+++ b/src/components/Footer/Footer.tsx
@@ -19,20 +19,15 @@ type FooterProps = {
   secondary: React.ReactNode
 }
 
-// TODO: Add in "Return to Top" handling
-export const Footer = (
-  props: FooterProps & React.HTMLAttributes<HTMLElement>
-): React.ReactElement => {
-  const {
-    big,
-    medium,
-    slim,
-    returnToTop,
-    primary,
-    secondary,
-    ...footerAttributes
-  } = props
-
+export const Footer = ({
+  big,
+  medium,
+  slim,
+  returnToTop,
+  primary,
+  secondary,
+  ...footerAttributes
+}: FooterProps & React.HTMLAttributes<HTMLElement>): React.ReactElement => {
   const classes = classnames(
     'usa-footer',
     {
diff --git a/src/components/Footer/FooterNav/FooterNav.stories.tsx b/src/components/Footer/FooterNav/FooterNav.stories.tsx
new file mode 100644
index 0000000000..87f73408a3
--- /dev/null
+++ b/src/components/Footer/FooterNav/FooterNav.stories.tsx
@@ -0,0 +1,37 @@
+/*  eslint-disable jsx-a11y/anchor-is-valid */
+import React from 'react'
+
+import { FooterNav } from './FooterNav'
+
+export default {
+  title: 'FooterNav',
+  parameters: {
+    info: `
+    Used in USWDS 2.0 Footer component
+    
+    Source: https://designsystem.digital.gov/components/form-controls/#footer
+    `,
+  },
+}
+
+export const SlimFooterNav = (): React.ReactElement => (
+  <FooterNav
+    slim
+    links={Array(4).fill(
+      <a className="usa-footer__primary-link" href="#">
+        PrimaryLink
+      </a>
+    )}
+  />
+)
+
+export const MediumFooterNav = (): React.ReactElement => (
+  <FooterNav
+    medium
+    links={Array(4).fill(
+      <a className="usa-footer__primary-link" href="#">
+        PrimaryLink
+      </a>
+    )}
+  />
+)
diff --git a/src/components/Footer/FooterNav/FooterNav.test.tsx b/src/components/Footer/FooterNav/FooterNav.test.tsx
new file mode 100644
index 0000000000..fb671f1f1a
--- /dev/null
+++ b/src/components/Footer/FooterNav/FooterNav.test.tsx
@@ -0,0 +1,23 @@
+/*  eslint-disable jsx-a11y/anchor-is-valid */
+import React from 'react'
+import { render } from '@testing-library/react'
+
+import { FooterNav } from './FooterNav'
+
+const links = Array(4).fill(
+  <a className="usa-footer__primary-link" href="#">
+    Primary Link
+  </a>
+)
+describe('FooterNav component', () => {
+  it('renders without errors', () => {
+    const { getByRole } = render(<FooterNav links={links} />)
+    expect(getByRole('navigation')).toBeInTheDocument()
+  })
+
+  it('renders links', () => {
+    const { container, getAllByText } = render(<FooterNav links={links} />)
+    expect(container.querySelectorAll('a').length).toBe(4)
+    expect(getAllByText('Primary Link').length).toBe(4)
+  })
+})
diff --git a/src/components/Footer/FooterNav/FooterNav.tsx b/src/components/Footer/FooterNav/FooterNav.tsx
new file mode 100644
index 0000000000..97f380b332
--- /dev/null
+++ b/src/components/Footer/FooterNav/FooterNav.tsx
@@ -0,0 +1,36 @@
+import React from 'react'
+import classnames from 'classnames'
+
+type FooterNavProps = {
+  big?: boolean
+  medium?: boolean
+  slim?: boolean
+  links: React.ReactNode[]
+}
+
+export const FooterNav = (
+  props: FooterNavProps & React.HTMLAttributes<HTMLElement>
+): React.ReactElement => {
+  const { medium, slim, links, ...elementAttributes } = props
+
+  const navClasses = classnames(`usa-footer__nav`, elementAttributes.className)
+  const listItemClasses = classnames(
+    'desktop:grid-col-auto usa-footer__primary-content',
+    {
+      'mobile-lg:grid-col-4': medium,
+      'mobile-lg:grid-col-6': slim,
+    }
+  )
+
+  return (
+    <nav className={navClasses} aria-label="Footer navigation">
+      <ul className="grid-row grid-gap">
+        {links.map((link, i) => (
+          <li key={`navLink-${i}`} className={listItemClasses}>
+            {link}
+          </li>
+        ))}
+      </ul>
+    </nav>
+  )
+}
diff --git a/src/components/Footer/Logo/Logo.tsx b/src/components/Footer/Logo/Logo.tsx
index d473fd74af..6110a01d07 100644
--- a/src/components/Footer/Logo/Logo.tsx
+++ b/src/components/Footer/Logo/Logo.tsx
@@ -26,11 +26,16 @@ export const Logo = ({
     elementAttributes.className
   )
 
+  const columnClasses = classnames({
+    'mobile-lg:grid-col-auto': big || medium,
+    'grid-col-auto': slim,
+  })
+
   return (
     <div className={containerClasses} data-testid="footerLogo">
       <>
-        <div className="grid-col-auto">{image}</div>
-        {heading && <div className="grid-col-auto">{heading}</div>}
+        <div className={columnClasses}>{image}</div>
+        {heading && <div className={columnClasses}>{heading}</div>}
       </>
     </div>
   )
diff --git a/src/components/Footer/SocialLinks/SocialLinks.stories.tsx b/src/components/Footer/SocialLinks/SocialLinks.stories.tsx
new file mode 100644
index 0000000000..ac27efd544
--- /dev/null
+++ b/src/components/Footer/SocialLinks/SocialLinks.stories.tsx
@@ -0,0 +1,28 @@
+/*  eslint-disable jsx-a11y/anchor-is-valid */
+import React from 'react'
+import { SocialLinks } from './SocialLinks'
+
+const links = [
+  <a
+    key="facebook"
+    className="usa-social-link usa-social-link--facebook"
+    href="#">
+    <span>Facebook</span>
+  </a>,
+  <a
+    key="twitter"
+    className="usa-social-link usa-social-link--twitter"
+    href="#">
+    <span>Twitter</span>
+  </a>,
+  <a
+    key="youtube"
+    className="usa-social-link usa-social-link--youtube"
+    href="#">
+    <span>YouTube</span>
+  </a>,
+  <a key="rss" className="usa-social-link usa-social-link--rss" href="#">
+    <span>RSS</span>
+  </a>,
+]
+export const Example = (): React.ReactElement => <SocialLinks links={links} />
diff --git a/src/components/Footer/SocialLinks/SocialLinks.test.tsx b/src/components/Footer/SocialLinks/SocialLinks.test.tsx
new file mode 100644
index 0000000000..ebc552e860
--- /dev/null
+++ b/src/components/Footer/SocialLinks/SocialLinks.test.tsx
@@ -0,0 +1,29 @@
+/*  eslint-disable jsx-a11y/anchor-is-valid */
+import React from 'react'
+import { render } from '@testing-library/react'
+
+import { SocialLinks } from './SocialLinks'
+
+const links = [
+  <a key="fb" href="#">
+    <span>Facebooked</span>
+  </a>,
+  <a key="ig" href="#">
+    <span>Finstagram</span>
+  </a>,
+]
+
+describe('SocialLinks component', () => {
+  it('renders without errors', () => {
+    const { container } = render(<SocialLinks links={links} />)
+    expect(
+      container.querySelector('.usa-footer__social-links')
+    ).toBeInTheDocument()
+  })
+
+  it('renders social links', () => {
+    const { getByText } = render(<SocialLinks links={links} />)
+    expect(getByText('Facebooked')).toBeInTheDocument()
+    expect(getByText('Finstagram')).toBeInTheDocument()
+  })
+})
diff --git a/src/components/Footer/SocialLinks/SocialLinks.tsx b/src/components/Footer/SocialLinks/SocialLinks.tsx
new file mode 100644
index 0000000000..93608b9677
--- /dev/null
+++ b/src/components/Footer/SocialLinks/SocialLinks.tsx
@@ -0,0 +1,22 @@
+/*  eslint-disable jsx-a11y/anchor-is-valid */
+import React from 'react'
+
+type SocialLinksProps = {
+  links: React.ReactNode[]
+}
+
+export const SocialLinks = (
+  props: SocialLinksProps & React.HTMLAttributes<HTMLElement>
+): React.ReactElement => {
+  const { links } = props
+
+  return (
+    <div className="usa-footer__social-links grid-row grid-gap-1">
+      {links.map((link, i) => (
+        <div key={`socialLink${i}`} className="grid-col-auto">
+          {link}
+        </div>
+      ))}
+    </div>
+  )
+}