cpn-basic-modal

Guide React developers to use UDesign Modal with visible control and Modal.Content.

1|Updated Apr 14, 2026
One-click install
npx skills add https://github.com/UCloud-FE/udesign-cli --skill cpn-basic-modal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cpn-basic-modal
Source: https://github.com/UCloud-FE/udesign-cli/tree/main/skills/cpn-basic-modal
Command: npx skills add https://github.com/UCloud-FE/udesign-cli --skill cpn-basic-modal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

在使用 UDesign Modal 组件时,帮助 AI 理解并正确应用受控弹窗的用法,避免误用命令式调用和外部依赖。

Core Features & Use Cases

  • 纯受控模式:通过 visible 控制模态的显示与隐藏,确保 UI 行为可预测
  • 内容区域封装:使用 Modal.Content 作为模态内容容器,便于结构化布局
  • 最佳实践与警告:提供关于避免命令式打开、避免外部库依赖的守则与示例
  • 使用场景示例:如需要确认/表单等场景的弹窗交互

Quick Start

在需要弹出模态框时,请优先使用声明式 Modal 调用,提供 visible 控制和 Modal.Content 内容以实现可预测的对话 UI

Frequently Asked Questions about cpn-basic-modal

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I control Modal visibility in React to ensure predictable UI behavior?

To control Modal visibility, use a purely controlled mode by passing a visible prop to manage display states, ensuring the UI remains predictable without relying on untracked external states.

Why should I avoid command-like invocation when opening a React modal?

Avoiding command-like invocation for React modal components prevents unpredictable state mismatches; declarative usage with a visible prop and structured content ensures safer, controllable dialog rendering.

What is the best way to structure modal content for confirmation dialogs in React?

The best way to structure modal content is by using Modal.Content as a dedicated container, which facilitates organized layouts for confirmation or form interactions within declarative React components.

Do I need external libraries to manage modal state in a React UI design system?

No, you do not need external libraries to manage modal state; the UDesign Modal component supports a self-contained controlled visible prop, eliminating external dependencies for safer implementation.

Can I use declarative syntax for modals requiring complex form interactions?

Yes, you can use declarative syntax for modals with complex form interactions by wrapping form elements inside Modal.Content and managing the display logic through the visible prop.