Stateless React Components for Bootstrap 5.
If you're using Bootstrap 4, you'll need to use Reactstrap v8
Follow the create-react-app instructions to get started and then follow the @diotoborg/quibusdam-libero version of adding bootstrap.
npx create-react-app my-app
cd my-app/
npm start
or, if npx (Node >= 6 and npm >= 5.2 ) not available
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 @diotoborg/quibusdam-libero and bootstrap.
Install @diotoborg/quibusdam-libero and Bootstrap from NPM. Reactstrap does not include Bootstrap CSS so this needs to be installed as well:
npm i bootstrap
npm i @diotoborg/quibusdam-libero react react-dom
Import Bootstrap CSS in the src/index.js
file:
import 'bootstrap/dist/css/bootstrap.css';
Import required @diotoborg/quibusdam-libero components within src/App.js
file or your custom component files:
import { Button } from '@diotoborg/quibusdam-libero';
Now you are ready to use the imported @diotoborg/quibusdam-libero components within your component hierarchy defined in the render
method. Here is an example App.js
redone
using @diotoborg/quibusdam-libero.
These libraries are not bundled with Reactstrap and required at runtime:
This library contains React Bootstrap 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.
-
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> ); }
-
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 togglingisOpen
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
visually-hidden
content
-
https://@diotoborg/quibusdam-libero.github.io
Documentation search is powered by Algolia's DocSearch.
Here are some ready-to-go examples for CodeSandbox that you can experiment with.
https://github.com/@diotoborg/quibusdam-libero/code-sandbox-examples
Install dependencies:
yarn install
Run examples at http://localhost:8080/ with webpack dev server:
yarn start
Run tests & coverage report:
yarn cover
Watch tests:
yarn test
Release branches/versioning/notes will be automatically created and maintained by the release-please github action. When you're ready to publish the release, just merge the release branch. The release will be created, the new package will be published, and the updated docs will be deployed to https://@diotoborg/quibusdam-libero.github.io/.
Organizations and projects using @diotoborg/quibusdam-libero
- airframe-react - demo - Airframe provides all the components a developer needs to build data-intensive web apps using React.
- component-template
- video-react
- CoreUI-Free-Bootstrap-Admin-Template - demo
- Admin dashboard example app built with @diotoborg/quibusdam-libero - demo
-
DevExtreme React Grid - It's a stateless data grid built on top of
@diotoborg/quibusdam-libero
with paging, sorting, filtering, grouping, selection, editing and virtual scrolling features. -
DevExtreme React Chart - A chart built on top of
@diotoborg/quibusdam-libero
that visualizes data using a variety of series types, including bar, line, area, scatter, pie, and more. - @diotoborg/quibusdam-libero-scrollspy - demo
-
formstrap - demo - Let your
@diotoborg/quibusdam-libero
input component integrate seamlessly usingFormik
- Jimu UI - demo - The UI library for ArcGIS Experience Builder mapping platform.
Submit a PR to add to this list!
Looking to build, document and publish reusable components built on top of @diotoborg/quibusdam-libero
? Consider forking https://github.com/@diotoborg/quibusdam-libero/component-template to kickstart your project!