"use client"
import {
ActionBarContent,
ActionBarRoot,
ActionBarSelectionTrigger,
ActionBarSeparator,
} from "@/components/ui/action-bar"
import { Button } from "@/components/ui/button"
import { Checkbox } from "@/components/ui/checkbox"
import { useState } from "react"
import { LuShare, LuTrash2 } from "react-icons/lu"
const Demo = () => {
const [checked, setChecked] = useState(false)
return (
<>
<Checkbox onCheckedChange={(e) => setChecked(!!e.checked)}>
Show Action bar
</Checkbox>
<ActionBarRoot open={checked}>
<ActionBarContent>
<ActionBarSelectionTrigger>2 selected</ActionBarSelectionTrigger>
<ActionBarSeparator />
<Button variant="outline" size="sm">
<LuTrash2 />
Delete
</Button>
<Button variant="outline" size="sm">
<LuShare />
Share
</Button>
</ActionBarContent>
</ActionBarRoot>
</>
)
}
Setup
If you don't already have the snippet, run the following command to add the
action-bar
snippet
npx @chakra-ui/cli snippet add action-bar
The snippet includes a closed component composition based on the Popover
component.
Usage
The action bar is designed to be controlled by table or checkbox selections. It provides a set of actions that can be performed on the selected items.
import {
ActionBarCloseTrigger,
ActionBarContent,
ActionBarRoot,
ActionBarSelectionTrigger,
ActionBarSeparator,
} from "@/components/ui/action-bar"
<ActionBarRoot>
<ActionBarContent>
<ActionBarCloseTrigger />
<ActionBarSelectionTrigger />
<ActionBarSeparator />
<Button />
</ActionBarContent>
</ActionBarRoot>
Examples
Close Trigger
Render the ActionBarCloseTrigger
to close the action bar, and pass the
onOpenChange
handler to control the visibility of the action bar.
"use client"
import {
ActionBarCloseTrigger,
ActionBarContent,
ActionBarRoot,
ActionBarSelectionTrigger,
ActionBarSeparator,
} from "@/components/ui/action-bar"
import { Button } from "@/components/ui/button"
import { Checkbox } from "@/components/ui/checkbox"
import { useState } from "react"
import { LuShare, LuTrash2 } from "react-icons/lu"
const Demo = () => {
const [checked, setChecked] = useState(false)
return (
<>
<Checkbox
checked={checked}
onCheckedChange={(e) => setChecked(!!e.checked)}
>
Show Action bar
</Checkbox>
<ActionBarRoot
open={checked}
onOpenChange={(e) => setChecked(e.open)}
closeOnInteractOutside={false}
>
<ActionBarContent>
<ActionBarSelectionTrigger>2 selected</ActionBarSelectionTrigger>
<ActionBarSeparator />
<Button variant="outline" size="sm">
<LuTrash2 />
Delete
</Button>
<Button variant="outline" size="sm">
<LuShare />
Share
</Button>
<ActionBarCloseTrigger />
</ActionBarContent>
</ActionBarRoot>
</>
)
}
Within Dialog
Here's an example of composing the ActionBar
and the Dialog
to perform a
delete action on a set of selected items.
"use client"
import { DialogHeader } from "@chakra-ui/react"
import {
ActionBarContent,
ActionBarRoot,
ActionBarSelectionTrigger,
ActionBarSeparator,
} from "@/components/ui/action-bar"
import { Button } from "@/components/ui/button"
import { Checkbox } from "@/components/ui/checkbox"
import {
DialogBody,
DialogContent,
DialogDescription,
DialogFooter,
DialogRoot,
DialogTitle,
DialogTrigger,
} from "@/components/ui/dialog"
import { useState } from "react"
import { LuPlusSquare, LuTrash2 } from "react-icons/lu"
const Demo = () => {
const [checked, setChecked] = useState(false)
return (
<>
<Checkbox onCheckedChange={(e) => setChecked(!!e.checked)}>
Check to select projects
</Checkbox>
<ActionBarRoot open={checked}>
<ActionBarContent>
<ActionBarSelectionTrigger>4 selected</ActionBarSelectionTrigger>
<ActionBarSeparator />
<Button variant="outline" size="sm">
<LuPlusSquare />
Add to collection
</Button>
<DialogRoot placement="center">
<DialogTrigger asChild>
<Button variant="surface" colorPalette="red" size="sm">
<LuTrash2 />
Delete projects
</Button>
</DialogTrigger>
<DialogContent>
<DialogHeader>
<DialogTitle>Delete projects</DialogTitle>
</DialogHeader>
<DialogBody>
<DialogDescription>
Are you sure you want to delete 4 projects?
</DialogDescription>
</DialogBody>
<DialogFooter>
<Button variant="outline">Cancel</Button>
<Button colorPalette="red">Delete</Button>
</DialogFooter>
</DialogContent>
</DialogRoot>
</ActionBarContent>
</ActionBarRoot>
</>
)
}
Props
Root
Prop | Default | Type |
---|---|---|
No props to display |