让开源，少一点语言距离。
npm包中文文档

@cloud-ru/ds-popup-private

中文文档
1.1.20发布于 2026/11/11Apache-2.0TypeScriptESM + CJS近 30 天下载 1.7万

@cloud-ru/ds-popup-private —— 说

中文使用文档
中文原文
文档目录24 节
  1. 页脚动作
  2. 道具 FooterActionsProps
  3. 综艺 叙事
  4. 道具
  5. 叠加表面提供器
  6. 道具 OverlaySurfaceProviderProps
  7. 弹出Body
  8. 道具 PopupBodyProps
  9. 弹出关闭按钮
  10. 道具 PopupCloseButtonProps
  11. 弹出福特
  12. 道具 PopupFooterProps
  13. 弹出页眉
  14. 道具 PopupHeaderProps
  15. 弹出媒体
  16. 道具 MediaProps
  17. 苏维埃 TOKEN 单元
  18. 道具
  19. 使用 OverlayBodyHeightAuto 软件
  20. 道具
  21. 使用重叠页
  22. 道具
  23. 使用 Surface Token 组件
  24. 道具

私人弹出

@cloud-ru/ds-popup-private —— 说

页脚动作

道具 FooterActionsProps

Prop类型默认说明
actionsClassNamestring—— 说Доп. CSS-на ButtonGroup (поверх也.
additionalButtonBottomSheetActionButton—— 说Дополнительная (третья)кнопка (по) view='simple', (中文(简体) ), appearance='neutral') (中文(简体) ).
approveButtonBottomSheetActionButton—— 说Основная(по) view='filled', (中文(简体) ), appearance='primary') (中文(简体) ).
cancelButtonBottomSheetActionButton—— 说Кнопка(по) view='outline', (中文(简体) ), appearance='neutral') (中文(简体) ).
footerActionsOrientation"horizontal" | "vertical"horizontal{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢.
size"l" | "m" | "s"—— 说Размер. {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}我... {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}我.. ButtonGroup) , не
{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}我还得去 {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢
размера (календарные:24 / 32 / 40 s. * 模式、抽屉 *
底表相克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克克 l {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}你觉得呢
передают size='l' явно.
surface"bottomSheet" | "window"window{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}请说:
- 说吧 window (桌面, : : : 3 : : : ).
- 说吧 bottomSheet (移动): 1 ~ ~ , 2 ~ 空位相间, 3 ~ ~ (主).
testIdsFooterActionsTestIds—— 说{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢bottom-sheet 编号 : modal 编号 : drawer) (中文(简体) ).

  • BottomSheetActionButton =: Omit<ButtonProps<"button">, "size" | "fullWidth"> | Omit<ButtonProps<"a">, "size" | "fullWidth">

  • FooterActionsOrientation =: "horizontal" | "vertical"

页脚动作测试

Prop类型默认说明
additionalstring—— 说
approvestring—— 说
cancelstring—— 说
  • SurfaceTokenSegment =: "bottomSheet" | "window"

综艺 叙事

道具

Prop类型默认说明

叠加表面提供器

道具 OverlaySurfaceProviderProps

Prop类型默认说明
bodyHeightAutobooleanfalse抽屉: Body {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}你觉得呢.
childrenstring | number | boolean | ReactElement<any, string | JSXElementConstructor<any>> | Iterable<ReactNode> | ReactPortal | null | undefined—— 说
surface"drawer" | "modal" | "sheet"—— 说Поверхность,в也.
  • OverlaySurface =: "drawer" | "modal" | "sheet"

弹出Body

道具 PopupBodyProps

Prop类型默认说明
bodyPaddingbooleantrue{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}身体 身体 {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}我刚说 При false -=ytet -伊甸园字幕组=- 翻译:
для,изображений也. (图) padding=false。 。 。 .
childrenstring | number | boolean | ReactElement<any, string | JSXElementConstructor<any>> | Iterable<ReactNode> | ReactPortal | null | undefined—— 说
classNamestring—— 说CSS - класс body.
contentReactNode—— 说体 (альтернатива) children) (中文(简体) ).
data-test-idstring—— 说
innerRefRef<HTMLElement>—— 说{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}身体 {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}是的 {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}是的.

弹出关闭按钮

道具 PopupCloseButtonProps

Prop类型默认说明
aria-labelstring | undefined—— 说定义标记当前元素的字符串值.
Доступное. По close popup。 。 。 .
classNamestring—— 说(原始内容存档于2018-09-31). CSS-Q.
data-test-idstring—— 说
onClick() => void—— 说Действие.

弹出福特

道具 PopupFooterProps

Prop类型默认说明
childrenstring | number | boolean | ReactElement<any, string | JSXElementConstructor<any>> | Iterable<ReactNode> | ReactPortal | null | undefined—— 说
classNamestring—— 说(原始内容存档于2018-09-31) (英语). CSS - класс fower' à.
data-test-idstring—— 说

弹出页眉

道具 PopupHeaderProps

Prop类型默认说明
actionButtonReactNode—— 说QQ头条 ReactNode时 Button ) (中文(简体) ).
classNamestring—— 说(原始内容存档于2018-10-21) (英语). CSS -класс-класс-头'а.
data-test-idstring—— 说
onBackButtonClick(() => void)—— 说回叫QQ回叫 (слева:"слева").
{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}请回电 Button view='function' icon={<ArrowLeftSVG />}。 。 。 .
slotAfterTitleReactNode—— 说QQ 标题, QuestionTooltip из @cloud-ru/ds-tooltip) (中文(简体) ).
slotSecondTitleReactNode—— 说时间轴: SearchBar, (中文(简体) ), SegmentControl или Filter。 。 。 .
说吧 secondWrapper {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}你应该知道 {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}你是谁 bottomSheet, (中文(简体) ),
subHeadlineWrapper {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}你应该知道 {\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}你是谁 window (模式/抽屉).
subtitleReactNode—— 说(图) subtitleWrapper) (中文(简体) ). {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢.
testIdsPopupHeaderTestIds—— 说Переопределение data-test-id слотов. {\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得呢 TEST_IDS。 。 。 .
{\fn黑体\fs20\shad2\2aH82\3aH20\4aH33\fscx95\3cH592001\be1}(绘画家/模式) {\fn黑体\fs20\shad2\2aH82\3aH20\4aH33\fscx95\3cH592001\be1}♪# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #.
titleReactNode—— 说Заголовок. 说吧 title-l 床单, headline-s qq窗口(模式/绘图).
titleIdstring—— 说id - заголовка связи связи aria-labelledby 对话框' á(可访问名称) .
truncate{ title?: number; subtitle?: number; } | undefined—— 说Усечение title编号 :subtitle через TruncateString (число. Применяется
{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得怎么样? * 窗口(模式/绘图),
{\fn黑体\fs22\bord1\shad0\3ahbe\4ah00\fscx67\fscy66\2chffffff\3ch808080}你觉得呢.

弹出页头测试

Prop类型默认说明
actionButtonstring | undefined—— 说
backButtonstring | undefined—— 说
headerstring | undefined—— 说
slotAfterTitlestring | undefined—— 说
slotSecondTitlestring | undefined—— 说
subtitlestring | undefined—— 说
titlestring | undefined—— 说

弹出媒体

道具 MediaProps

Prop类型默认说明
altstring—— 说Альтернативный (a11y).
classNamestring—— 说
kind"icon" | "image"imageРежим:
- 说吧 'image' . . . . . 184px),[к
{\fn黑体\fs22\bord1\shad0\3aHBE\4aH00\fscx67\fscy66\2cHFFFFFF\3cH808080}你觉得怎样? * 身体 * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
используйте bodyPadding={false} отдельно.
- 说吧 'icon' - иконка с padding-top: 24px。 。 。 .
srcstring—— 说(原始内容存档于2018-09-29). URL QQ/QQ.
  • MediaKind =: "icon" | "image"

苏维埃 TOKEN 单元

道具

Prop类型默认说明

使用 OverlayBodyHeightAuto 软件

道具

Prop类型默认说明

使用重叠页

道具

Prop类型默认说明

使用 Surface Token 组件

道具

Prop类型默认说明

版本与发布记录

@cloud-ru/ds-popup-private 共发布 107 个版本，首次发布于 2026/08/18；过去 12 个月发布了 107 个版本。

版本发布日期距今
1.1.20latest2026/11/11今天
1.1.20-preview-e8fe6b56.0preview2026/11/11今天
1.1.20-preview-c0e895ed.02026/11/11今天
1.1.20-preview-90b10112.02026/11/11今天
1.1.20-preview-fd7dd437.02026/11/101 天前
1.1.20-preview-9a75a2a9.02026/11/101 天前

关于 @cloud-ru/ds-popup-private 的常见问题

@cloud-ru/ds-popup-private 是什么？

@cloud-ru/ds-popup-private —— 说

如何安装 @cloud-ru/ds-popup-private？

在项目目录运行 npm install @cloud-ru/ds-popup-private，或使用 pnpm add / yarn add / bun add。

@cloud-ru/ds-popup-private 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

@cloud-ru/ds-popup-private 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require() 都可以使用，打包工具会自动选择合适的版本。

@cloud-ru/ds-popup-private 可以商用吗？

@cloud-ru/ds-popup-private 使用 Apache-2.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

@cloud-ru/ds-popup-private 的下载量有多少？

根据 npm 官方下载统计，@cloud-ru/ds-popup-private 在 2026/10/10 – 2026/11/08 这 30 天内被下载 17,194 次，日均约 573 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

@cloud-ru/ds-popup-private 还在维护吗？

最新版本 1.1.20 发布于 2026/11/11（今天）；至今共发布 107 个版本，其中过去 12 个月发布了 107 个；首次发布于 2026/08/18。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。