@zendeskgarden/react-buttons

What is @zendeskgarden/react-buttons?

@zendeskgarden/react-buttons is a package that provides a set of accessible and customizable button components for React applications. It is part of the Zendesk Garden design system, which aims to offer a consistent and cohesive set of UI components.

What are @zendeskgarden/react-buttons's main functionalities?

Basic Button

This is a basic button component that can be used to trigger actions in a React application. It is styled according to the Zendesk Garden design system.

<Button>Click me</Button>

Button Sizes

The package provides buttons in different sizes, allowing developers to choose the appropriate size for their UI needs.

<Button size="small">Small Button</Button>
<Button size="large">Large Button</Button>

Button Variants

Different button variants are available, such as primary and danger, to convey different actions or states to the user.

<Button isPrimary>Primary Button</Button>
<Button isDanger>Danger Button</Button>

Icon Buttons

Icon buttons are available for actions that can be represented with an icon, providing a more compact and visually appealing option.

<IconButton aria-label="Settings"><SettingsIcon /></IconButton>

Other packages similar to @zendeskgarden/react-buttons

react-bootstrap

React-Bootstrap is a popular library that provides Bootstrap components as React components. It offers a wide range of button styles and sizes similar to @zendeskgarden/react-buttons, but with the Bootstrap design system.

material-ui

Material-UI (now MUI) is a comprehensive library of React components that implement Google's Material Design. It offers a variety of button components with extensive customization options, similar to @zendeskgarden/react-buttons, but follows the Material Design guidelines.

chakra-ui

Chakra UI is a modern React component library that provides a set of accessible and composable components, including buttons. It offers similar functionality to @zendeskgarden/react-buttons with a focus on simplicity and ease of use.

README

@zendeskgarden/react-buttons

This package includes components relating to buttons in the Garden Design System.

Installation

npm install @zendeskgarden/react-buttons

# Peer Dependencies - Also Required
npm install react react-dom styled-components @zendeskgarden/react-theming

Usage

Button

import { ThemeProvider } from '@zendeskgarden/react-theming';
import { Button } from '@zendeskgarden/react-buttons';

/**
 * Place a `ThemeProvider` at the root of your React application
 */
<ThemeProvider>
  <>
    <Button onClick={() => alert('clicked')}>Default</Button>
    <Button isPrimary isDanger>
      Primary danger button
    </Button>
  </>
</ThemeProvider>;

Media button

import React, { useState } from 'react';
import { Button } from '@zendeskgarden/react-buttons';
import StartIcon from '@zendeskgarden/icons/src/16/shield-stroke.svg';
import EndIcon from '@zendeskgarden/icons/src/16/chevron-down-stroke.svg';

const MediaButton = ({ children, ...props }) => {
  const [isRotated, setRotated] = useState(false);

  return (
    <Button onClick={() => setRotated(!isRotated)} {...props}>
      <Button.StartIcon>
        <StartIcon />
      </Button.StartIcon>
      {children}
      <Button.EndIcon isRotated={isRotated}>
        <EndIcon />
      </Button.EndIcon>
    </Button>
  );
};

Changelog

v9.0.0-next.27 (2024-09-26)

:rocket: New Feature

• loaders, theming
  • #1926 feat(loaders): allow color props to receive color variable keys in addition to hex values (@jzempel)

:bug: Bug Fix

• dropdowns
  • #1930 fix(dropdowns): ensure focus is returned to menu trigger before calling onChange (@ze-flo)
• colorpickers, modals, theming
  • #1929 chore: v9 QA sweep (@jzempel)
    • decrease space between ColorPickerDialog/ColorSwatchDialog and trigger
    • prevent render thrashing on getColor storybook demo
    • split migration guides out of historical changelogs for improved website documentation
• avatars, colorpickers
  • #1927 fix(colorpickers): prevent arrow from positioning over a ColorSwatchDialog tooltip (@jzempel)

:memo: Documentation

• #1922 docs: adds verbosity to initial v9 migration steps (@geotrev)

:seedling: Internal

• breadcrumbs
  • #1932 chore(breadcrumbs): remove Anchor underline in demo (@jzempel)
• Other
  • #1924 chore(deps-dev): bump rollup from 4.21.0 to 4.22.4 (@dependabot[bot])