index.js

/**
 * Copyright (c) 2017-present, Facebook, Inc.
 *
 * This source code is licensed under the MIT license found in the
 * LICENSE file in the root directory of this source tree.
 */

import React from 'react'
import useDocusaurusContext from '@docusaurus/useDocusaurusContext'
import {GridBlock} from '../components/GridBlock'
import {Container} from '../components/Container'
import {Showcase} from '../components/Showcase'
import Layout from '@theme/Layout'

const HomeSplash = props => {
  const {language = ''} = props
  const {siteConfig} = useDocusaurusContext()
  const {baseUrl, customFields} = siteConfig
  const docsPart = `${customFields.docsPath ? `${customFields.docsPath}/` : ''}`
  const langPart = `${language ? `${language}/` : ''}`
  const docUrl = doc => `${baseUrl}${docsPart}${langPart}${doc}`

  const SplashContainer = props => (
    <div className="homeContainer">
      <div className="homeSplashFade">
        <div className="wrapper homeWrapper">{props.children}</div>
      </div>
    </div>
  )

  const Logo = props => (
    <div className="projectLogo">
      <img src={props.img_src} alt="Project Logo" />
    </div>
  )

  const ProjectTitle = () => (
    <div>
      <h2 className="projectTitle">{siteConfig.title}</h2>
      <div className="projectTaglineWrapper">
        <p className="projectTagline">{siteConfig.tagline}</p>
      </div>
    </div>
  )

  const Button = props => (
    <a
      className="button button--primary button--outline"
      href={props.href}
      target={props.target}
    >
      {props.children}
    </a>
  )

  return (
    <SplashContainer>
      <Logo img_src={`${baseUrl}img/logo-large.png`} />
      <div className="inner">
        <ProjectTitle siteConfig={siteConfig} />
        <div className="pluginWrapper buttonWrapper">
          <Button href={'/docs/'}>Get Started</Button>
        </div>
      </div>
    </SplashContainer>
  )
}

export default class Index extends React.Component {
  render() {
    const {config: siteConfig, language = ''} = this.props
    const {baseUrl} = siteConfig

    const Block = props => (
      <Container
        padding={['bottom', 'top']}
        id={props.id}
        background={props.background}
      >
        <GridBlock
          align={props.align || 'center'}
          imageAlign={props.imageAlign || 'center'}
          contents={props.children}
          layout={props.layout}
        />
      </Container>
    )

    const FeatureCallout = () => (
      <Container className="" background={'light'} padding={['top', 'bottom']}>
        <div style={{textAlign: 'center'}}>
          <p>
            <i>
              The more your tests resemble the way your software is used, <br />
              the more confidence they can give you.
            </i>
          </p>
        </div>
      </Container>
    )

    const Problem = () => (
      <React.Fragment>
        <Block background={'light'} align="left">
          {[
            {
              title: '',
              content:
                "## The Problem \n - You want tests for your UI that avoid including implementation details and rather focus on making your tests give you the confidence for which they are intended. \n - You want your tests to be maintainable so refactors _(changes to implementation but not functionality)_ don't break your tests and slow you and your team down.",
              image: `${baseUrl}img/interrobang-128x128.png`,
              imageAlt: 'The problem (picture of a question mark)',
              imageAlign: 'left',
            },
          ]}
        </Block>
      </React.Fragment>
    )

    const Solution = () => [
      <Block background={null} align="left">
        {[
          {
            title: '',
            image: `${baseUrl}img/star-128x128.png`,
            imageAlign: 'right',
            imageAlt: 'The solution (picture of a star)',
            content:
              '## The Solution \n The Testing Library family of libraries is a very light-weight solution for testing without all the implementation details. The main utilities it provides involve querying for nodes similarly to how users would find them. In this way, testing-library helps ensure your tests give you confidence in your UI code.',
          },
        ]}
      </Block>,
      <Block background={'light'} align="left">
        {[
          {
            title: 'Guiding Principle',
            image: `${baseUrl}img/trophy-128x128.png`,
            imageAlign: 'left',
            imageAlt: 'The guiding principle (picture of a brick wall)',
            content:
              '_The more your tests resemble the way your software is used, the more confidence they can give you._',
          },
        ]}
      </Block>,
    ]

    const Features = () => (
      <Block layout="twoColumn">
        {[
          {
            content:
              'Tests only break when your app breaks, not implementation details',
            image: `${baseUrl}img/wrench-128x128.png`,
            imageAlign: 'top',
            title: 'Write Maintainable Tests',
          },
          {
            content: 'Interact with your app the same way as your users',
            image: `${baseUrl}img/check-128x128.png`,
            imageAlign: 'top',
            title: 'Develop with Confidence',
          },
          {
            content:
              'Built-in selectors find elements the way users do to help you write inclusive code',
            image: `${baseUrl}img/tada-128x128.png`,
            imageAlign: 'top',
            title: 'Accessible by Default',
          },
        ]}
      </Block>
    )

    const Ecosystem = () => (
      <Block layout="fourColumn" background={null}>
        {[
          {
            image: `${baseUrl}img/react-128x128.png`,
            imageAlign: 'top',
            title: '[React](./docs/react-testing-library/intro)',
          },
          {
            image: `${baseUrl}img/cypress-128x128.png`,
            imageAlign: 'top',
            title: '[Cypress](./docs/cypress-testing-library/intro)',
          },
          {
            image: `${baseUrl}img/testcafe-128x128.jpg`,
            imageAlign: 'top',
            title: `[Testcafe](./docs/testcafe-testing-library/intro)`,
          },
          {
            image: `${baseUrl}img/svelte-logo.png`,
            imageAlign: 'top',
            title: '[Svelte](./docs/svelte-testing-library/intro)',
          },
          {
            image: `${baseUrl}img/vue-400x400.png`,
            imageAlign: 'top',
            title: '[Vue](./docs/vue-testing-library/intro)',
          },
          {
            image: `${baseUrl}img/angular-250x250.png`,
            imageAlign: 'top',
            title: '[Angular](./docs/angular-testing-library/intro)',
          },
          {
            image: `${baseUrl}img/reason-200x200.png`,
            imageAlign: 'top',
            title: '[ReasonReact](./docs/bs-react-testing-library/intro)',
          },
          {
            image: `${baseUrl}img/puppeteer-275x275.png`,
            imageAlign: 'top',
            title: '[Puppeteer](./docs/pptr-testing-library/intro)',
          },
          {
            image: `${baseUrl}img/react-native-128x128.png`,
            imageAlign: 'top',
            title: '[React Native](./docs/react-native-testing-library/intro)',
          },
          {
            image: `${baseUrl}img/preact-128x128.png`,
            imageAlign: 'top',
            title: '[Preact](./docs/preact-testing-library/intro)',
          },
          {
            image: `${baseUrl}img/nightwatch-128x128.png`,
            imageAlign: 'top',
            title: '[Nightwatch](./docs/nightwatch-testing-library/intro)',
          },
          {
            image: `${baseUrl}img/construction-128x128.png`,
            imageAlign: 'top',
            title: '[And more...](./docs/ecosystem-user-event)',
          },
        ]}
      </Block>
    )

    const ShowcaseWrapper = () => {
      if ((siteConfig.customFields.users || []).length === 0) {
        return null
      }

      const pageUrl = page => baseUrl + (language ? `${language}/` : '') + page

      return (
        <div className="productShowcaseSection paddingBottom paddingTop">
          <h2>Who is Using This?</h2>
          <div className="logos">
            <Showcase
              users={siteConfig.customFields.users.filter(u => u.pinned)}
            />
          </div>
          <a
            className="button button--primary button--outline"
            href={pageUrl('users')}
          >
            More {siteConfig.title} Users
          </a>
        </div>
      )
    }

    const Awards = () => {
      return (
        <div className="awardsSection paddingBottom paddingTop">
          <h2>Awards</h2>
          <Block layout="threeColumn" background={null}>
            {[
              {
                image: `${baseUrl}img/impactful-contribution-award-399x544.png`,
                imageAlign: 'top',
                imageLink: 'https://osawards.com/react/2019',
                imageAlt:
                  'Winner of the Open Source Awards 2019 in the category "The most impactful contribution to the community"',
              },
              {
                image: `${baseUrl}img/highest-satisfaction-638x574.png`,
                imageAlign: 'top',
                imageLink: 'https://2020.stateofjs.com/en-US/awards/',
                imageAlt:
                  'Winner of the State of JS 2020 award for the technology with the highest percentage of satisfied users',
              },
            ]}
          </Block>
        </div>
      )
    }

    return (
      <Layout
        permalink="/"
        title={siteConfig.title}
        description={siteConfig.tagline}
      >
        <HomeSplash siteConfig={siteConfig} language={language} />
        <div className="mainContainer">
          <FeatureCallout />
          <Features />
          <Problem />
          <Solution />
          <ShowcaseWrapper />
          <Ecosystem />
          <Awards />
        </div>
      </Layout>
    )
  }
}