@react-querybuilder/chakra

@react-querybuilder/chakra

Official react-querybuilder components for Chakra UI.

To see them in action, check out the react-querybuilder demo or load the example in CodeSandbox.

Full documentation

Installation

npm i --save react-querybuilder @react-querybuilder/chakra @chakra-ui/icons @chakra-ui/react @chakra-ui/system @emotion/react @emotion/styled framer-motion
# OR
yarn add react-querybuilder @react-querybuilder/chakra @chakra-ui/icons @chakra-ui/react @chakra-ui/system @emotion/react @emotion/styled framer-motion

Usage

To render Chakra-compatible components in the query builder, wrap the <QueryBuilder /> element in <QueryBuilderChakra />.

import { ChakraProvider, extendTheme } from '@chakra-ui/react';
import { QueryBuilderChakra } from '@react-querybuilder/chakra';
import { QueryBuilder, RuleGroupType } from 'react-querybuilder';

const chakraTheme = extendTheme();

const fields = [
  { name: 'firstName', label: 'First Name' },
  { name: 'lastName', label: 'Last Name' },
];

const App = () => {
  const [query, setQuery] = useState<RuleGroupType>({ combinator: 'and', rules: [] });

  return (
    <ChakraProvider theme={chakraTheme}>
      <QueryBuilderChakra>
        <QueryBuilder fields={fields} query={query} onQueryChange={q => setQuery(q)} />
      </QueryBuilderChakra>
    </ChakraProvider>
  );
};

Notes

• Some additional styling may be necessary, e.g.:

  .queryBuilder .chakra-select__wrapper {
    width: fit-content;
    display: inline-block;
  }
  
  .queryBuilder .chakra-input {
    width: auto;
    display: inline-block;
  }
  
  .queryBuilder .chakra-radio-group {
    display: inline-block;
  }
  

• This package exports chakraControlElements which can be assigned directly to the controlElements prop on <QueryBuilder /> (and also exports each component individually), but this method does not support customized Chakra themes like <QueryBuilderChakra />.

Changelog

[v5.1.2] - 2022-11-21

Fixed

• [#399]/[#401] When dragging a rule or group over a group header, the dndOver class is no longer applied to child group headers.