Presentation pieces: colour, motion, a code symbol, and two ways to show media
that are not a viewer.
Install
pnpm add @djangocfg/widget-visual @djangocfg/ui-core @djangocfg/i18n
| Subpath | What |
|---|
./color-picker | a colour picker |
./color-palette | a palette built from one seed |
./marquee | a continuous scroll |
./qr-code | a QR code; the encoder is a dynamic import |
./gallery | an image grid, carousel, thumbnails and lightbox |
./lottie-player | a Lottie animation |
What is NOT here
This is the residue of ui-tools' visual/ and media/ folders after the parts
with a real home left, and knowing where they went is half the package:
| Looking for | It is in |
|---|
| an image viewer with zoom and pan | @djangocfg/widget-media |
| an audio or video player | @djangocfg/widget-player |
| a chart or an indicator | @djangocfg/widget-charts |
| a dialog, tour or scroll spy | @djangocfg/widget-overlay |
| a file icon | @djangocfg/widget-data |
What remains genuinely belongs together: each puts something on screen for its
own sake, and none owns state a host has to drive.
Verify
pnpm --filter @djangocfg/widget-visual check-types test
关于 @djangocfg/widget-visual 的常见问题
@djangocfg/widget-visual 是什么？
Presentation pieces: a colour picker and palette, a marquee, a QR code, an image gallery and a Lottie player
如何安装 @djangocfg/widget-visual？
在项目目录运行 npm install @djangocfg/widget-visual，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^19.0.0）、react-dom（^19.0.0）、lucide-react（^1.68.0）、@djangocfg/i18n（^2.1.613）、@djangocfg/ui-core（^2.1.613）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。
@djangocfg/widget-visual 支持 TypeScript 吗？
支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
@djangocfg/widget-visual 支持 ESM 还是 CommonJS？
以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。
@djangocfg/widget-visual 可以商用吗？
@djangocfg/widget-visual 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。
@djangocfg/widget-visual 的下载量有多少？
根据 npm 官方下载统计，@djangocfg/widget-visual 在 2026/10/13 – 2026/11/11 这 30 天内被下载 3,151 次，日均约 105 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
@djangocfg/widget-visual 还在维护吗？
最新版本 0.1.23 发布于 2026/11/05（7 天前）；至今共发布 20 个版本，其中过去 12 个月发布了 20 个；首次发布于 2026/09/09。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。