JSPM

  • Created
  • Published
  • Downloads 54273
  • Score
    100M100P100Q155563F

A universal headless Button component for React Native, Next.js & React

Package Exports

    This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@gluestack-ui/button) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

    Readme

    @gluestack-ui/button

    Installation

    To use @gluestack-ui/button, all you need to do is install the @gluestack-ui/button package:

    $ yarn add @gluestack-ui/button
    
    # or
    
    $ npm i @gluestack-ui/button

    Usage

    A button component is a graphical user interface element that enables users to act by clicking or tapping. It can be customized in size, shape, color, and behavior to fit the design of the application or website. Here's an example how to use this package to create one:

    import { createButton } from '@gluestack-ui/button';
    import {
      Root,
      Text,
      Group,
      GroupHSpacer,
      GroupVSpacer,
      Spinner,
      Icon,
    } from './styled-components';
    
    export const Button = createButton({
      Root,
      Text,
      Group,
      GroupHSpacer,
      GroupVSpacer,
      Spinner,
      Icon,
    });

    Customizing the Button:

    Default styling of all these components can be found in the components/core/button file. For reference, you can view the source code of the styled Button components.

    // import the styles
    import {
      Root,
      Text,
      Group,
      GroupHSpacer,
      GroupVSpacer,
      Spinner,
    } from '../components/core/button/styled-components';
    
    // import the createButton function
    import { createButton } from '@gluestack-ui/button';
    
    // Understanding the API
    const Button = createButton({
      Root,
      Text,
      Group,
      GroupHSpacer,
      GroupVSpacer,
      Spinner,
    });
    
    // Using the button component
    export default () => (
      <ButtonGroup>
        <Button>
          <ButtonText />
          <ButtonSpinner />
          <ButtonIcon />
        </Button>
      </ButtonGroup>
    );

    More guides on how to get started are available here.