This commit is contained in:
DCCONSTRUCTIONS
2026-04-18 18:39:25 +03:00
commit 3ba092b60c
4944 changed files with 497564 additions and 0 deletions
@@ -0,0 +1,384 @@
/**
* Copyright (c) 2023-present Plane Software, Inc. and contributors
* SPDX-License-Identifier: AGPL-3.0-only
* See the LICENSE file for details.
*/
import type { Meta, StoryObj } from "@storybook/react-vite";
import { Download, Edit, Share, Star, Archive } from "lucide-react";
import { CopyIcon, TrashIcon } from "../icons";
import { ChevronRightIcon } from "../icons/arrows/chevron-right";
import { ContextMenu } from "./context-menu";
// cannot use satisfies here because base-ui does not have portable types.
const meta: Meta<typeof ContextMenu> = {
title: "Components/ContextMenu",
component: ContextMenu,
subcomponents: {
ContextMenuTrigger: ContextMenu.Trigger,
ContextMenuPortal: ContextMenu.Portal,
ContextMenuContent: ContextMenu.Content,
ContextMenuItem: ContextMenu.Item,
ContextMenuSeparator: ContextMenu.Separator,
ContextMenuSubmenu: ContextMenu.Submenu,
ContextMenuSubmenuTrigger: ContextMenu.SubmenuTrigger,
},
args: {
children: null,
},
parameters: {
layout: "centered",
},
tags: ["autodocs"],
};
export default meta;
type Story = StoryObj<typeof meta>;
export const Default: Story = {
render() {
return (
<ContextMenu>
<ContextMenu.Trigger>
<div className="flex h-[150px] w-[300px] items-center justify-center rounded-md border border-dashed border-strong text-13">
Right click here
</div>
</ContextMenu.Trigger>
<ContextMenu.Portal>
<ContextMenu.Content>
<ContextMenu.Item>Back</ContextMenu.Item>
<ContextMenu.Item>Forward</ContextMenu.Item>
<ContextMenu.Item>Reload</ContextMenu.Item>
<ContextMenu.Separator />
<ContextMenu.Item>More Tools</ContextMenu.Item>
</ContextMenu.Content>
</ContextMenu.Portal>
</ContextMenu>
);
},
};
export const WithIcons: Story = {
render() {
return (
<ContextMenu>
<ContextMenu.Trigger>
<div className="flex h-[150px] w-[300px] items-center justify-center rounded-md border border-dashed border-strong text-13">
Right click here
</div>
</ContextMenu.Trigger>
<ContextMenu.Portal>
<ContextMenu.Content>
<ContextMenu.Item>
<CopyIcon className="mr-2 h-4 w-4" />
Copy
</ContextMenu.Item>
<ContextMenu.Item>
<Edit className="mr-2 h-4 w-4" />
Edit
</ContextMenu.Item>
<ContextMenu.Item>
<Download className="mr-2 h-4 w-4" />
Download
</ContextMenu.Item>
<ContextMenu.Separator />
<ContextMenu.Item>
<Share className="mr-2 h-4 w-4" />
Share
</ContextMenu.Item>
<ContextMenu.Item>
<TrashIcon className="mr-2 h-4 w-4 text-danger-primary" />
<span className="text-danger-primary">Delete</span>
</ContextMenu.Item>
</ContextMenu.Content>
</ContextMenu.Portal>
</ContextMenu>
);
},
};
export const WithSubmenus: Story = {
render() {
return (
<ContextMenu>
<ContextMenu.Trigger>
<div className="flex h-[150px] w-[300px] items-center justify-center rounded-md border border-dashed border-strong text-13">
Right click here
</div>
</ContextMenu.Trigger>
<ContextMenu.Portal>
<ContextMenu.Content>
<ContextMenu.Item>
<CopyIcon className="mr-2 h-4 w-4" />
Copy
</ContextMenu.Item>
<ContextMenu.Item>
<Edit className="mr-2 h-4 w-4" />
Edit
</ContextMenu.Item>
<ContextMenu.Separator />
<ContextMenu.Submenu>
<ContextMenu.SubmenuTrigger>
<Share className="mr-2 h-4 w-4" />
Share
<ChevronRightIcon className="ml-auto h-4 w-4" />
</ContextMenu.SubmenuTrigger>
<ContextMenu.Portal>
<ContextMenu.Content>
<ContextMenu.Item>Email</ContextMenu.Item>
<ContextMenu.Item>Message</ContextMenu.Item>
<ContextMenu.Item>Copy Link</ContextMenu.Item>
</ContextMenu.Content>
</ContextMenu.Portal>
</ContextMenu.Submenu>
<ContextMenu.Separator />
<ContextMenu.Item>
<TrashIcon className="mr-2 h-4 w-4 text-danger-primary" />
<span className="text-danger-primary">Delete</span>
</ContextMenu.Item>
</ContextMenu.Content>
</ContextMenu.Portal>
</ContextMenu>
);
},
};
export const DisabledItems: Story = {
render() {
return (
<ContextMenu>
<ContextMenu.Trigger>
<div className="flex h-[150px] w-[300px] items-center justify-center rounded-md border border-dashed border-strong text-13">
Right click here
</div>
</ContextMenu.Trigger>
<ContextMenu.Portal>
<ContextMenu.Content>
<ContextMenu.Item>
<CopyIcon className="mr-2 h-4 w-4" />
Copy
</ContextMenu.Item>
<ContextMenu.Item disabled>
<Edit className="mr-2 h-4 w-4" />
Edit (Disabled)
</ContextMenu.Item>
<ContextMenu.Item>
<Download className="mr-2 h-4 w-4" />
Download
</ContextMenu.Item>
<ContextMenu.Separator />
<ContextMenu.Item disabled>
<Share className="mr-2 h-4 w-4" />
Share (Disabled)
</ContextMenu.Item>
<ContextMenu.Item>
<TrashIcon className="mr-2 h-4 w-4 text-danger-primary" />
<span className="text-danger-primary">Delete</span>
</ContextMenu.Item>
</ContextMenu.Content>
</ContextMenu.Portal>
</ContextMenu>
);
},
};
export const OnFileCard: Story = {
render() {
return (
<ContextMenu>
<ContextMenu.Trigger>
<div className="w-64 cursor-pointer rounded-lg border border-subtle p-4 hover:bg-layer-1">
<div className="flex items-center gap-3">
<div className="flex h-12 w-12 items-center justify-center rounded-sm bg-accent-primary text-16 text-on-color">
📄
</div>
<div className="flex-1">
<div className="font-medium">Document.pdf</div>
<div className="text-13 text-placeholder">2.4 MB</div>
</div>
</div>
</div>
</ContextMenu.Trigger>
<ContextMenu.Portal>
<ContextMenu.Content>
<ContextMenu.Item>
<Download className="mr-2 h-4 w-4" />
Download
</ContextMenu.Item>
<ContextMenu.Item>
<CopyIcon className="mr-2 h-4 w-4" />
Copy Link
</ContextMenu.Item>
<ContextMenu.Item>
<Star className="mr-2 h-4 w-4" />
Add to Favorites
</ContextMenu.Item>
<ContextMenu.Separator />
<ContextMenu.Item>
<Archive className="mr-2 h-4 w-4" />
Archive
</ContextMenu.Item>
<ContextMenu.Item>
<TrashIcon className="mr-2 h-4 w-4 text-danger-primary" />
<span className="text-danger-primary">Delete</span>
</ContextMenu.Item>
</ContextMenu.Content>
</ContextMenu.Portal>
</ContextMenu>
);
},
};
export const OnImage: Story = {
render() {
return (
<ContextMenu>
<ContextMenu.Trigger>
<div className="relative h-56 w-80 cursor-pointer overflow-hidden rounded-lg bg-layer-1">
<div className="absolute inset-0 flex items-center justify-center text-placeholder">Image Placeholder</div>
</div>
</ContextMenu.Trigger>
<ContextMenu.Portal>
<ContextMenu.Content>
<ContextMenu.Item>
<Download className="mr-2 h-4 w-4" />
Save Image
</ContextMenu.Item>
<ContextMenu.Item>
<CopyIcon className="mr-2 h-4 w-4" />
Copy Image
</ContextMenu.Item>
<ContextMenu.Item>
<CopyIcon className="mr-2 h-4 w-4" />
Copy Image URL
</ContextMenu.Item>
<ContextMenu.Separator />
<ContextMenu.Item>Open Image in New Tab</ContextMenu.Item>
</ContextMenu.Content>
</ContextMenu.Portal>
</ContextMenu>
);
},
};
export const OnText: Story = {
render() {
return (
<ContextMenu>
<ContextMenu.Trigger>
<div className="w-96 rounded-lg border border-subtle p-6">
<h3 className="mb-2 text-16 font-semibold">Context Menu on Text</h3>
<p className="text-tertiary">
Right click anywhere on this text area to see the context menu. This demonstrates how context menus can be
applied to text content areas.
</p>
</div>
</ContextMenu.Trigger>
<ContextMenu.Portal>
<ContextMenu.Content>
<ContextMenu.Item>
<CopyIcon className="mr-2 h-4 w-4" />
Copy
</ContextMenu.Item>
<ContextMenu.Item>
<Edit className="mr-2 h-4 w-4" />
Edit
</ContextMenu.Item>
<ContextMenu.Separator />
<ContextMenu.Item>Select All</ContextMenu.Item>
</ContextMenu.Content>
</ContextMenu.Portal>
</ContextMenu>
);
},
};
export const NestedSubmenus: Story = {
render() {
return (
<ContextMenu>
<ContextMenu.Trigger>
<div className="flex h-[150px] w-[300px] items-center justify-center rounded-md border border-dashed border-strong text-13">
Right click here
</div>
</ContextMenu.Trigger>
<ContextMenu.Portal>
<ContextMenu.Content>
<ContextMenu.Item>New File</ContextMenu.Item>
<ContextMenu.Item>New Folder</ContextMenu.Item>
<ContextMenu.Separator />
<ContextMenu.Submenu>
<ContextMenu.SubmenuTrigger>
Import
<ChevronRightIcon className="ml-auto h-4 w-4" />
</ContextMenu.SubmenuTrigger>
<ContextMenu.Portal>
<ContextMenu.Content>
<ContextMenu.Item>From File</ContextMenu.Item>
<ContextMenu.Item>From URL</ContextMenu.Item>
<ContextMenu.Submenu>
<ContextMenu.SubmenuTrigger>
From Cloud
<ChevronRightIcon className="ml-auto h-4 w-4" />
</ContextMenu.SubmenuTrigger>
<ContextMenu.Portal>
<ContextMenu.Content>
<ContextMenu.Item>Google Drive</ContextMenu.Item>
<ContextMenu.Item>Dropbox</ContextMenu.Item>
<ContextMenu.Item>OneDrive</ContextMenu.Item>
</ContextMenu.Content>
</ContextMenu.Portal>
</ContextMenu.Submenu>
</ContextMenu.Content>
</ContextMenu.Portal>
</ContextMenu.Submenu>
<ContextMenu.Separator />
<ContextMenu.Item>
<TrashIcon className="mr-2 h-4 w-4 text-danger-primary" />
<span className="text-danger-primary">Delete</span>
</ContextMenu.Item>
</ContextMenu.Content>
</ContextMenu.Portal>
</ContextMenu>
);
},
};
export const WithKeyboardShortcuts: Story = {
render() {
return (
<ContextMenu>
<ContextMenu.Trigger>
<div className="flex h-[150px] w-[300px] items-center justify-center rounded-md border border-dashed border-strong text-13">
Right click here
</div>
</ContextMenu.Trigger>
<ContextMenu.Portal>
<ContextMenu.Content>
<ContextMenu.Item>
<CopyIcon className="mr-2 h-4 w-4" />
Copy
<span className="ml-auto text-11 text-placeholder">⌘C</span>
</ContextMenu.Item>
<ContextMenu.Item>
<Edit className="mr-2 h-4 w-4" />
Edit
<span className="ml-auto text-11 text-placeholder">⌘E</span>
</ContextMenu.Item>
<ContextMenu.Item>
<Download className="mr-2 h-4 w-4" />
Download
<span className="ml-auto text-11 text-placeholder">⌘D</span>
</ContextMenu.Item>
<ContextMenu.Separator />
<ContextMenu.Item>
<TrashIcon className="mr-2 h-4 w-4 text-danger-primary" />
<span className="text-danger-primary">Delete</span>
<span className="ml-auto text-11 text-placeholder">⌘⌫</span>
</ContextMenu.Item>
</ContextMenu.Content>
</ContextMenu.Portal>
</ContextMenu>
);
},
};
@@ -0,0 +1,151 @@
/**
* Copyright (c) 2023-present Plane Software, Inc. and contributors
* SPDX-License-Identifier: AGPL-3.0-only
* See the LICENSE file for details.
*/
import * as React from "react";
import { ContextMenu as ContextMenuPrimitive } from "@base-ui-components/react/context-menu";
import { cn } from "../utils";
export interface ContextMenuProps extends React.ComponentProps<typeof ContextMenuPrimitive.Root> {
children: React.ReactNode;
}
export interface ContextMenuTriggerProps extends React.ComponentProps<typeof ContextMenuPrimitive.Trigger> {
children: React.ReactNode;
className?: string;
}
export interface ContextMenuContentProps extends React.ComponentProps<typeof ContextMenuPrimitive.Positioner> {
children: React.ReactNode;
className?: string;
side?: "top" | "right" | "bottom" | "left";
sideOffset?: number;
positionerClassName?: string;
}
export interface ContextMenuItemProps extends React.ComponentProps<typeof ContextMenuPrimitive.Item> {
children: React.ReactNode;
className?: string;
disabled?: boolean;
}
const ContextMenuRoot = React.forwardRef(function ContextMenuRoot(
{ children, ...props }: ContextMenuProps,
_ref: React.ForwardedRef<React.ElementRef<typeof ContextMenuPrimitive.Root>>
) {
return <ContextMenuPrimitive.Root {...props}>{children}</ContextMenuPrimitive.Root>;
});
const ContextMenuTrigger = React.forwardRef(function ContextMenuTrigger(
{ className, children, ...props }: ContextMenuTriggerProps,
ref: React.ForwardedRef<React.ElementRef<typeof ContextMenuPrimitive.Trigger>>
) {
return (
<ContextMenuPrimitive.Trigger ref={ref} className={cn("outline-none", className)} {...props}>
{children}
</ContextMenuPrimitive.Trigger>
);
});
const ContextMenuPortal = ContextMenuPrimitive.Portal;
const ContextMenuContent = React.forwardRef(function ContextMenuContent(
{ positionerClassName, className, children, side = "bottom", sideOffset = 4, ...props }: ContextMenuContentProps,
ref: React.ForwardedRef<React.ElementRef<typeof ContextMenuPrimitive.Positioner>>
) {
return (
<ContextMenuPrimitive.Positioner
ref={ref}
side={side}
sideOffset={sideOffset}
{...props}
className={positionerClassName}
>
<ContextMenuPrimitive.Popup
className={cn(
"shadow-md z-50 min-w-32 overflow-hidden rounded-md border border-subtle bg-surface-1 p-1",
"data-[state=open]:animate-in data-[state=closed]:animate-out data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0",
"data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95",
"data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2",
"data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2",
className
)}
>
{children}
</ContextMenuPrimitive.Popup>
</ContextMenuPrimitive.Positioner>
);
});
const ContextMenuItem = React.forwardRef(function ContextMenuItem(
{ className, disabled, children, ...props }: ContextMenuItemProps,
ref: React.ForwardedRef<React.ElementRef<typeof ContextMenuPrimitive.Item>>
) {
return (
<ContextMenuPrimitive.Item
ref={ref}
className={cn(
"relative flex cursor-default items-center rounded-xs px-2 py-1.5 text-13 outline-none select-none",
"focus:bg-surface-2 focus:text-primary",
"data-[disabled]:pointer-events-none data-[disabled]:opacity-50",
className
)}
disabled={disabled}
{...props}
>
{children}
</ContextMenuPrimitive.Item>
);
});
const ContextMenuSeparator = React.forwardRef(function ContextMenuSeparator(
{ className, ...props }: React.ComponentProps<typeof ContextMenuPrimitive.Separator>,
ref: React.ForwardedRef<React.ElementRef<typeof ContextMenuPrimitive.Separator>>
) {
return (
<ContextMenuPrimitive.Separator ref={ref} className={cn("bg-subtle-1 -mx-1 my-1 h-px", className)} {...props} />
);
});
const ContextMenuSubmenu = ContextMenuPrimitive.SubmenuRoot;
const ContextMenuSubmenuTrigger = React.forwardRef(function ContextMenuSubmenuTrigger(
{ className, children, ...props }: React.ComponentProps<typeof ContextMenuPrimitive.SubmenuTrigger>,
ref: React.ForwardedRef<React.ElementRef<typeof ContextMenuPrimitive.SubmenuTrigger>>
) {
return (
<ContextMenuPrimitive.SubmenuTrigger
ref={ref}
className={cn(
"flex cursor-default items-center rounded-xs px-2 py-1.5 text-13 outline-none select-none focus:outline-none",
"focus:bg-surface-2 data-[state=open]:bg-surface-2",
className
)}
{...props}
>
{children}
</ContextMenuPrimitive.SubmenuTrigger>
);
});
ContextMenuRoot.displayName = "ContextMenu";
ContextMenuTrigger.displayName = "ContextMenuTrigger";
ContextMenuContent.displayName = "ContextMenuContent";
ContextMenuItem.displayName = "ContextMenuItem";
ContextMenuSeparator.displayName = "ContextMenuSeparator";
ContextMenuSubmenuTrigger.displayName = "ContextMenuSubmenuTrigger";
// compound components
const ContextMenu = Object.assign(ContextMenuRoot, {
Trigger: ContextMenuTrigger,
Portal: ContextMenuPortal,
Content: ContextMenuContent,
Item: ContextMenuItem,
Separator: ContextMenuSeparator,
Submenu: ContextMenuSubmenu,
SubmenuTrigger: ContextMenuSubmenuTrigger,
});
export { ContextMenu };
@@ -0,0 +1,13 @@
/**
* Copyright (c) 2023-present Plane Software, Inc. and contributors
* SPDX-License-Identifier: AGPL-3.0-only
* See the LICENSE file for details.
*/
export { ContextMenu } from "./context-menu";
export type {
ContextMenuProps,
ContextMenuTriggerProps,
ContextMenuContentProps,
ContextMenuItemProps,
} from "./context-menu";