New Power Manual

    uiuiui

    0.6.6 • Public • Published

    uiuiui

    Simple, accessible, React controls and form elements.

    ⚠ Until the first stable release (1.0.0) the API is considered unstable and will be changing quite a bit. Use cautiously!

    See an online demo.

    Usage

    Install uiuiui as a dependency to your project:

    # using npm 
    npm install uiuiui
     
    # using yarn 
    yarn add --dev uiuiui

    It's bundled for both CJS and ES modules, so either way of using it works:

    let uiuiui = require('uiuiui'); // CommonJS
    import { Slider } from 'uiuiui'; // ES Modules

    You also need some way to import the CSS into your project:

    import "uiuiui/build/uiuiui.css"

    Rationale

    When I started working on this React UI component library, there were a few things I had in mind:

    Interaction: Subtlety and accessibility

    A control should react to all the subtle interactions available in a browser, which sometimes tend to be ignored. Inclusive Components by Heydon Pickering is an example of things to be mindful of.

    CSS: Responsiveness and flexibility

    A control should delegate as much of the styling as possible to the user, and provide helpful hooks for them to do so. It should be unassuming about the context in which it's going to be used, and that means steering clear of hardcoded dimensions and other anti-patterns which may crop up in React projects.

    The project uses a consistent CSS naming system based on the BEM methodology, which I've found makes more sense for me when building complex interfaces.

    Architecture: Structure and clarity

    The project aims to provide the user with useful primitives with which to build they can build their own controls. That means keeping all the components short and sweet, so that rewriting any of them to match your needs is not a hassle. Everything should be swappable.

    Comprehensively documented

    Along with its main use as a component library to be used directly, the code should be clear and heavily annotated to provide information on how each component is built, how it works, and how one might implement similar components.

    API Reference

    Low-level components

    UI components

    Development

    To develop uiuiui, see CONTRIBUTING.md.

    Keywords

    none

    Install

    npm i uiuiui

    DownloadsWeekly Downloads

    134

    Version

    0.6.6

    License

    MIT

    Unpacked Size

    219 kB

    Total Files

    9

    Last publish

    Collaborators

    • danburzo
    • darung
    • adig