JavaScript Shell
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github/ISSUE_TEMPLATE chore(GitHub): update issue templates Jul 17, 2018
__mocks__ chore(deps): Update react to 16 (#610) Nov 15, 2017
docs feat(Modal): trap focus in modal (#1161) Aug 13, 2018
scripts docs(release): update the release docs in readme Jun 28, 2018
src feat(Modal): return focus after modal closes (#1175) Aug 16, 2018
.babelrc build(rollup): Optimize CommonJS and module build (#477) Jun 28, 2017
.eslintignore initial commit Feb 19, 2016
.eslintrc.js docs(*): add eslint configuration for docs (#755) Jan 2, 2018
.gitignore chore(release): adding 6.4.0 (#1176) Aug 17, 2018
.travis.yml chore(travis): bump node version Aug 17, 2018
CHANGELOG.md chore(release): adding 6.4.0 (#1176) Aug 17, 2018
CONTRIBUTING.md docs(contributing): update resources Sep 5, 2016
ISSUE_TEMPLATE.md chore(issueTemplate): update demo link May 4, 2018
LICENSE chore(license): Update year to include present Oct 21, 2017
PULL_REQUEST_TEMPLATE.md chore(GitHub): add PR template Jul 17, 2018
README.md docs(readme): update link to create-react-app guide (#1140) Jul 23, 2018
package.json chore(release): adding 6.4.0 (#1176) Aug 17, 2018
rollup.config.js chore(release): adding 5.0.0-alpha.4 (#690) Nov 16, 2017
webpack.base.config.js feat(transitions) update react transition group (#557) Sep 16, 2017
webpack.config.js build(webpack): update configs for release Mar 14, 2016
webpack.dev.config.js feat(Modal): trap focus in modal (#1161) Aug 13, 2018
yarn.lock refactor(TabContent): componentWillReceiveProps to getDerivedStateFro… ( Jun 7, 2018

README.md

reactstrap

CDNJS NPM Version Build Status Coverage Status License

reactstrap

Stateless React Components for Bootstrap 4.

Getting Started

Follow the create-react-app instructions up to the Adding Bootstrap section and instead follow the reactstrap version of adding bootstrap.

tl;dr

npm install -g create-react-app

create-react-app my-app
cd my-app/
npm start

Then open http://localhost:3000/ to see your app. The initial structure of your app is setup. Next, let's add reactstrap and bootstrap.

Adding Bootstrap

Install reactstrap and Bootstrap from NPM. Reactstrap does not include Bootstrap CSS so this needs to be installed as well:

npm install --save bootstrap@4.1.1
npm install --save reactstrap react@^16.3.2 react-dom@^16.3.2

Import Bootstrap CSS in the src/index.js file:

import 'bootstrap/dist/css/bootstrap.css';

Import required reactstrap components within src/App.js file or your custom component files:

import { Button } from 'reactstrap';

Now you are ready to use the imported reactstrap components within your component hierarchy defined in the render method. Here is an example App.js redone using reactstrap.

Dependencies

Required Peer Dependencies

These libraries are not bundled with Reactstrap and required at runtime:

Optional Dependencies

These libraries are not included in the main distribution file reactstrap.min.js and need to be manually included when using components that require transitions or popover effects (e.g. Tooltip, Modal, etc).

CDN

If you prefer to include Reactstrap globally by marking reactstrap as external in your application, the reactstrap library provides various single-file distributions, which are hosted on the following CDNs:

<!-- Main version -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/reactstrap/6.0.1/reactstrap.min.js"></script>

<!-- All optional dependencies version -->
<script src="https://cdnjs.cloudflare.com/ajax/libs/reactstrap/6.0.1/reactstrap.full.min.js"></script>
<!-- Main version -->
<script src="https://unpkg.com/reactstrap@6.0.1/dist/reactstrap.min.js"></script>

<!-- All optional dependencies version -->
<script src="https://unpkg.com/reactstrap@6.0.1/dist/reactstrap.full.min.js"></script>

Note: To load a specific version of Reactstrap replace 6.0.1 with the version number.

Versions

Reactstrap has two primary distribution versions:

  1. reactstrap.min.js

    This file excludes the optional dependencies – react-popper and react-transition-group. This is the recommended approach (similar approach in Bootstrap's JavaScript components) for including Reactstrap as it reduces the filesize and gives more flexibility in configuring needed dependencies.

    Recommended use cases:

    • Small, medium, or large applications
    • Applications that do not use any transitions or popper components
    • Applications that directly use react-popper or react-transition-group – Reactstrap and your application will use the single global version included
  2. reactstrap.full.min.js

    This file includes the optional dependencies – react-popper and react-transition-group

    Recommended use cases:

    • Small applications

Example

<!doctype html>
<html lang="en">
  <head>
    <!-- Required dependencies -->
    <script type="text/javascript" src="//cdnjs.cloudflare.com/ajax/libs/prop-types/15.6.1/prop-types.min.js"></script>
    <script type="text/javascript" src="//cdnjs.cloudflare.com/ajax/libs/react/16.3.2/umd/react.production.min.js"></script>
    <script type="text/javascript" src="//cdnjs.cloudflare.com/ajax/libs/react-dom/16.3.2/umd/react-dom.production.min.js"></script>
    <!-- Optional dependencies -->
    <script type="text/javascript" src="//cdnjs.cloudflare.com/ajax/libs/react-transition-group/2.2.1/react-transition-group.min.js"></script>
    <script type="text/javascript" src="//cdnjs.cloudflare.com/ajax/libs/popper.js/1.14.3/umd/popper.min.js"></script>
    <script type="text/javascript" src="//cdnjs.cloudflare.com/ajax/libs/react-popper/0.10.4/umd/react-popper.min.js"></script>
    <!-- Reactstrap -->
    <script type="text/javascript" src="//cdnjs.cloudflare.com/ajax/libs/reactstrap/6.0.1/reactstrap.min.js"></script>
    <!-- Lastly, include your app's bundle -->
    <script type="text/javascript" src="/assets/bundle.js"></script>
  </head>
  <body>
    <div id="my-app" />
  </body>
</html>

About the Project

This library contains React Bootstrap 4 components that favor composition and control. The library does not depend on jQuery or Bootstrap javascript. However, Poppers.js via react-popper is relied upon for advanced positioning of content like Tooltips, Popovers, and auto-flipping Dropdowns.

There are a few core concepts to understand in order to make the most out of this library.

  1. Your content is expected to be composed via props.children rather than using named props to pass in Components.

    // Content passed in via props
    const Example = (props) => {
      return (
        <p>This is a tooltip <TooltipTrigger tooltip={TooltipContent}>example</TooltipTrigger>!</p>
      );
    }
    
    // Content passed in as children (Preferred)
    const PreferredExample = (props) => {
      return (
        <p>
          This is a <a href="#" id="TooltipExample">tooltip</a> example.
          <Tooltip target="TooltipExample">
            <TooltipContent/>
          </Tooltip>
        </p>
      );
    }
  2. Attributes in this library are used to pass in state, conveniently apply modifier classes, enable advanced functionality (like tether), or automatically include non-content based elements.

    Examples:

    • isOpen - current state for items like dropdown, popover, tooltip
    • toggle - callback for toggling isOpen in the controlling component
    • color - applies color classes, ex: <Button color="danger"/>
    • size - for controlling size classes. ex: <Button size="sm"/>
    • tag - customize component output by passing in an element name or Component
    • boolean based props (attributes) when possible for alternative style classes or sr-only content

Documentation

https://reactstrap.github.io

Documentation search is powered by Algolia's DocSearch.

Contributing

Development

Install dependencies:

npm install

Run examples at http://localhost:8080/ with webpack dev server:

npm start

Run tests & coverage report:

npm test

Watch tests:

npm run test-watch

Releasing

Create Release Branch

Note: you must have the GITHUB_TOKEN environment variable set to a valid GitHub token with write access to your repo.

To create a release branch and changelog, run the following command, optionally with a semantic release type (major, minor, patch) (if not provided, it will default to semver (it's best to let it default)):

./scripts/release <release-type>

Verify changelog in branch. Create a PR if everything looks good. Merge when tests are green.

Tagging and Publishing

Note: you must have write permission to this repo do perform this action

Once the release branch is merged, checkout master and run:

./scripts/publish

This will build the current state of master, tag it based on the release version and push the tag up to GitHub. Travis will detect the new tag and publish to npm.

OR

You can create a new tag via the GitHub user interface. If you do it this way, make sure to use the correct version as the tag name (eg. 6.2.0).

In the wild

Organizations and projects using reactstrap

Submit a PR to add to this list!

Looking to build, document and publish reusable components built on top of reactstrap? Consider forking https://github.com/reactstrap/component-template to kickstart your project!