Home

Welcome to the react-bootstrap wiki!

These wiki pages are primarily intended to aid in documenting patterns and practices used in developing this library. User documentation can be found at http://react-bootstrap.github.io/

1.0.0 Roadmap [DRAFT]

While @stevoland and @pieterv have done an amazing job at getting this project started we have a lot of work to do to declare this library ready for a 1.0.0 release. As mentioned in the Maintaining - Releases documentation we will do everything in power to ensure that semver guidelines are followed. The question is when do we draw a line in the sand where we are comfortable that a 1.0.0 release is ready. The following guidelines should be considered to make that declaration.

• Consistent API - From component to component we should ensure that similar concepts are implemented in a clear an intuitive manner.
  • onClick handlers - function signature function(event, [eventKey])
    • on anchors we don't call e.preventDefault() that should be left to the consumer.
  • onSelect handlers - Ongoing conversation #419
• styleMap - https://github.com/react-bootstrap/react-bootstrap/blob/master/src/styleMaps.js Trevor Robinson did some great work to make this better than it was, but this is being used blindly by many components still. There are still issues with this where not all components apply all classes. For example a Button component does not have css defined for tabs or pills which this implementation will allow. Some investigation to a proper solution is still needed.
• Accessibility - Each component needs to be thoroughly investigated to ensure Web Accessibility standards are being accounted for. There's some great documentation on this by WebAim which is a non-profit organization that is an advocate for Web Accessibility standards and implementation. This is an important element for those organizations which must meet strict guidelines required by law in both the United States and Internationally. It's important to note that seeking after this will not only benefit those with disabilities. For example keyboard functionality with each of these components can be used by most people regardless of their capabilities.
  • Accordion
  • Affix
  • Alert
  • Badge
  • Button
  • ButtonGroup
  • ButtonToolbar
  • CollapsableNav
  • Carousel
  • CarouselItem
  • Col
  • DropdownButton
  • DropdownMenu
  • Glyphicon
  • Grid
  • Input
  • Interpolate
  • Jumbotron
  • Label
  • ListGroup
  • ListGroupItem
  • MenuItem
  • Modal
  • Nav
  • Navbar
  • NavItem
  • ModalTrigger
  • OverlayTrigger
  • PageHeader
  • Panel
  • PanelGroup
  • PageItem
  • Pager
  • Popover
  • ProgressBar
  • Row
  • SplitButton
  • SubNav
  • TabbedArea
  • Table
  • TabPane
  • Tooltip
  • Well