npmpackage.info

Gathering detailed insights and metrics for @chakra-ui/popper

Other packages similar to @chakra-ui/popper

@chakra-ui/tooltip

2.3.1

A React Component for rendering dynamically positioned Tooltips

@chakra-ui/popover

2.2.1

A React component to render that renders its content in a popover

@chakra-ui/c-popper

1.0.0-alpha.14

Chakra UI Vue | Position engine for vue bult on popperjs core component

@hackr/chakra-ui-popper

1.0.0-rc.9

A React component and hooks wrapper for popper.js

Gathering detailed insights and metrics for @chakra-ui/popper

@chakra-ui/popper - 3.1.0 | npmpackage.info

@chakra-ui/popper

Chakra UI is a component system for building SaaS products with speed ⚡️

3.1.0

39,352

MIT

TypeScript

140.49 kB

4.4

Installations

npm install @chakra-ui/popper

Developer Guide

BETA

Typescript

Yes

Module System

CommonJS, ESM

Node Version

18.16.1

NPM Version

9.5.1 Score

98.4

Supply Chain

100

Quality

76.2

Maintenance

100

Vulnerability

100

License

Pull Requests

Open

8

Total

3,822

Closed

1,038

Merged

2,776

Issues

Open

2

Total

4,112

Closed

4,110

Releases

3,516

@chakra-ui/cli@3.22.0

Updated on Jul 07, 2025

@chakra-ui/panda-preset@3.22.0

Updated on Jul 07, 2025

@chakra-ui/react@3.22.0

Updated on Jul 07, 2025

@chakra-ui/charts@3.22.0

Updated on Jul 07, 2025

@chakra-ui/panda-preset@3.21.1

Updated on Jun 28, 2025

@chakra-ui/charts@3.21.1

Updated on Jun 28, 2025

View All 3,516 releases

Languages

TypeScript

MDX

JavaScript

CSS

HTML

Dockerfile

TypeScript (82.19%)

MDX (16.96%)

JavaScript (0.71%)

CSS (0.07%)

HTML (0.06%)

Dockerfile (0.01%)

Developer

chakra-ui

Download Statistics

Total Downloads

Last Day

Last Week

Last Month

Last Year

GitHub Statistics

MIT License

39,352 Stars

10,957 Commits

3,443 Forks

201 Watchers

10 Branches

694 Contributors

Updated on Jul 12, 2025

Maintainers

View All 694 Contributors

Package Meta Information

Latest Version

3.1.0

Package Id

@chakra-ui/popper@3.1.0

Unpacked Size

140.49 kB

Size

21.33 kB

File Count

NPM Version

9.5.1

Node Version

18.16.1

Published on

Jul 18, 2023

Total Downloads

Cumulative downloads

Total Downloads

NaN

Last Day

NaN

Compared to previous day

Last Week

NaN

Compared to previous week

Last Month

NaN

Compared to previous month

Last Year

NaN

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

Popper

A React hooks wrapper for popper.js to dynamic positioning of containers around a reference.

This is an internal hook of Chakra-UI, and it's not covered by semver, and may cause unexpected or broken application behavior. Use them at your own risk.

Installation

1yarn add @chakra-ui/popper

Basic usage

By default, the usePopper hook returns props for the popper, reference and arrow.

1import { Box } from "@chakra-ui/layout"
2import { Button } from "@chakra-ui/button"
3import { useDisclosure } from "@chakra-ui/hooks"
4import { usePopper } from "@chakra-ui/popper"
5
6function Example() {
7  const { isOpen, onToggle } = useDisclosure()
8  const { popperRef, referenceRef, getArrowProps } = usePopper()
9  return (
10    <>
11      <Button ref={referenceRef} onClick={onToggle} mb={2}>
12        {isOpen ? "Click me to see less" : "Click me to see more"}
13      </Button>
14      {isOpen && (
15        <Box ref={popperRef} bg="red">
16          <div
17            {...getArrowProps({
18              style: {
19                background: "red",
20              },
21            })}
22          />
23          This is a popover for the button!
24        </Box>
25      )}
26    </>
27  )
28}

Parameters

Changing the placement

You can change the placement of the popper by passing the placement option to usePopper and set it to the popper.js placement.

1const { popperRef, referenceRef } = usePopper({
2  placement: "right-start",
3})

Match reference's width

In some cases, you might want to allow the popper take the width of the reference. For example, autocomplete, select, etc.

To achieve this, pass the matchWidth option and set it to true

1const { popperRef, referenceRef } = usePopper({
2  matchWidth: true,
3})

Place the popper next to the reference

You can place the popper next to the reference without margin or distance between them. Useful to create an autocomplete or typeahead feature.

1const { popperRef, referenceRef } = usePopper({
2  gutter: 0,
3})

Using inside a fixed container

If the reference element is inside a fixed container, you should use the fixed strategy.

1const { popperRef, referenceRef } = usePopper({
2  strategy: "fixed",
3})

Adding transition

When add transitions to a popper component, it is usually advised to apply popper and transition to different elements.

1// 1. Import components
2import { useDisclosure } from "@chakra-ui/hooks"
3import { usePopper } from "@chakra-ui/popper"
4import { motion, AnimatePresence, Variants } from "framer-motion"
5
6export function Example() {
7  // 2. Create toggle state
8  const { isOpen, onToggle } = useDisclosure()
9
10  // 3. Create motion variants
11  const slide: Variants = {
12    exit: {
13      y: -2,
14      opacity: 0,
15    },
16    enter: {
17      y: 0,
18      opacity: 1,
19    },
20  }
21
22  // 4. Consume the `usePopper` hook
23  const { getPopperProps, getReferenceProps, getArrowProps, transformOrigin } =
24    usePopper({
25      placement: "bottom-start",
26    })
27
28  return (
29    <>
30      <button {...getReferenceProps({ onClick: onToggle })}>Toggle</button>
31      <div {...getPopperProps()}>
32        <AnimatePresence>
33          {isOpen && (
34            <motion.div
35              transition={{
36                type: "spring",
37                duration: 0.2,
38              }}
39              variants={slide}
40              initial="exit"
41              animate="enter"
42              exit="exit"
43              style={{
44                background: "red",
45                width: 200,
46                transformOrigin,
47                borderRadius: 4,
48              }}
49            >
50              Testing
51              <div
52                {...getArrowProps({
53                  style: {
54                    background: "red",
55                  },
56                })}
57              />
58            </motion.div>
59          )}
60        </AnimatePresence>
61      </div>
62    </>
63  )
64}

When not rendering the popper conditionally, we recommend using visibility: hidden instead of hidden or display: none

No vulnerabilities found.

10

Maintained

Determines if the project is "actively maintained".

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

License

Determines if the project has defined a license.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

3

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

2

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

2

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

Reason

dependency not pinned by hash detected -- score normalized to 2

Details

Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/issue-stale.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/chakra-ui/chakra-ui/issue-stale.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/quality.yml:43: update your workflow using https://app.stepsecurity.io/secureworkflow/chakra-ui/chakra-ui/quality.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/quality.yml:56: update your workflow using https://app.stepsecurity.io/secureworkflow/chakra-ui/chakra-ui/quality.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/quality.yml:69: update your workflow using https://app.stepsecurity.io/secureworkflow/chakra-ui/chakra-ui/quality.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/quality.yml:17: update your workflow using https://app.stepsecurity.io/secureworkflow/chakra-ui/chakra-ui/quality.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/quality.yml:30: update your workflow using https://app.stepsecurity.io/secureworkflow/chakra-ui/chakra-ui/quality.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:20: update your workflow using https://app.stepsecurity.io/secureworkflow/chakra-ui/chakra-ui/release.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:33: update your workflow using https://app.stepsecurity.io/secureworkflow/chakra-ui/chakra-ui/release.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yml:46: update your workflow using https://app.stepsecurity.io/secureworkflow/chakra-ui/chakra-ui/release.yml/main?enable=pin
Warn: containerImage not pinned by hash: sandbox/react-router/Dockerfile:1
Warn: containerImage not pinned by hash: sandbox/react-router/Dockerfile:6
Warn: containerImage not pinned by hash: sandbox/react-router/Dockerfile:11
Warn: containerImage not pinned by hash: sandbox/react-router/Dockerfile:17: pin your Docker image by updating node:20-alpine to node:20-alpine@sha256:fa316946c0cb1f041fe46dda150f3085b71168555e5706ec0c7466a5bae12244
Info: 0 out of 8 GitHub-owned GitHubAction dependencies pinned
Info: 0 out of 1 third-party GitHubAction dependencies pinned
Info: 0 out of 4 containerImage dependencies pinned
Info: 2 out of 2 npmCommand dependencies pinned

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Security-Policy

Determines if the project has published a security policy.

0

Fuzzing

Determines if the project uses fuzzing.

0

SAST

Determines if the project uses static code analysis.

Score

4.4

/10

Last Scanned on 2025-07-07

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More

Other packages similar to @chakra-ui/popper

Other packages similar to @chakra-ui/popper

@chakra-ui/popper

Installations

Developer Guide

Yes

CommonJS, ESM

18.16.1

9.5.1

Score

Pull Requests

8

3,822

1,038

2,776

Issues

2

4,112

4,110

Releases

Languages

Developer

Download Statistics

GitHub Statistics

Maintainers

Package Meta Information

Total Downloads

NaN

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

Peer Dependencies

Dev Dependencies

Popper

Installation

Basic usage

Parameters

Changing the placement

Match reference's width

Place the popper next to the reference

Using inside a fixed container

Adding transition

10

10

10

10

3

2

2

0

0

0

0

0

4.4

/10