Skip to content

About

可视化 CSS 界面装饰生成器:自适应气泡、卡片丝带、优惠券缺口。实时预览,复制 HTML/CSS,纯浏览器运行。

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Repository files navigation

CSS Shape Studio

面向前端开发者的界面装饰工作台:把气泡边框、卡片丝带、优惠券缺口等细节,调成可以直接用于项目的 HTML 和 CSS。

在线使用 · 气泡生成器 · 卡片丝带 · 优惠券

CI & Pages

由 cssTriangle 升级而来,优先解决完整场景里的尺寸、内容和挂靠关系,同时保留原有五种基础图形。

CSS Shape Studio 工作台

卡片丝带:连同挂靠关系一起导出 优惠券:缺口、分隔线与轮廓阴影
卡片丝带 优惠券

功能

  • 八种模板:对话气泡、卡片丝带、优惠券,以及三角形、五角星、爱心、无限符号、月牙。
  • 精确调整:方向按钮、尺寸滑块与数字输入、可选宽高比例锁定、颜色与旋转。
  • 内容自适应气泡:按内容换行、增高,也可指定尺寸;支持四向箭头、圆角、内边距、边框颜色与宽度、阴影。箭头和气泡使用连续的填充与边框。
  • 完整卡片丝带:支持左上、右上、左下、右下挂靠,调整卡片尺寸、边距与圆角,编辑丝带文字和卡片内容。长文字不会遮住正文;导出包含卡片结构。
  • 优惠券:调整缺口半径、分隔位置、圆角和阴影,编辑优惠标题、说明和优惠码。内容增高时缺口与分隔线一起移动;外层阴影沿券面轮廓绘制。
  • 画布工具:浅色、暖色、深色背景,网格开关和预览缩放;预览缩放不会改变导出尺寸。
  • 复制与导出:分别复制 HTML / CSS,或下载可独立打开的完整 HTML;预览和导出共用生成逻辑。
  • 撤销 / 重做:保留最近 100 步设计变更。
  • 保存与分享:设计自动保存到当前浏览器;分享链接携带完整参数。不同设备的本地保存不会同步,打开分享链接即可恢复设计。
  • 响应式工作台:桌面三栏布局,手机上依次展示模板、画布、参数和代码。

所有形状在浏览器本地生成,无需账号、后端或模型 API。分享链接中的文字和参数对获得链接的人可见。

每种模板有独立入口,例如 /?template=bubble、/?template=ribbon、/?template=coupon。分享具体参数时使用页面的「分享设计」。

使用导出代码

将 HTML 和 CSS 一起复制到页面,或下载完整 HTML 查看效果。保留气泡的文字容器、丝带的卡片容器和优惠券的两层结构;它们负责自适应排版和阴影。

气泡的「指定尺寸」模式可能裁切过长文字,可切换「内容自适应」。优惠券高度是最小值,上下区块会随内容增长。优惠码只是展示文本,不包含领取或核销服务。优惠券遮罩需要支持 CSS mask 的现代浏览器。

开发

需要 Node.js 22.12+(或 24+)和 pnpm 11.22.0,与发布工作流保持一致。

pnpm install --frozen-lockfile
pnpm dev

打开终端输出的本地地址。

pnpm typecheck
pnpm test
pnpm lint
pnpm build
pnpm preview

dist/ 为静态构建产物,可部署到 GitHub Pages 等静态托管服务。构建使用相对资源路径,支持子目录部署。

自动发布

推送到 master 后,GitHub Actions 依次执行 Lint、类型检查、测试和构建。全部通过后上传本次构建产物,并发布到 GitHub Pages。Pull Request 和 main 分支仅执行检查。

发布使用仓库的 github-pages 环境和工作流临时令牌,无需配置个人访问令牌。Pages 发布来源为 GitHub Actions,不再使用 gh-pages 分支;dist/ 由工作流构建,不纳入版本管理。

需要重新发布时,在 CI & Pages 中选择 Run workflow,分支选择 master。

代码入口

  • src/studio.ts:设计参数、输入校验、形状 CSS 与独立 HTML 导出。
  • src/decorations.ts:气泡、完整卡片丝带、优惠券的 HTML / CSS 模板。
  • src/components/DecorationControls.tsx:场景专属参数与内容编辑。
  • src/pages/index.tsx:工作台交互、历史记录、保存与分享。
  • src/pages/studio.css:工作台视觉与响应式布局。
  • src/utils/css.ts:沿用的边框三角形与伪元素图形生成逻辑。

图形调整使用原生表单控件,生成代码不依赖 React 或其他运行时。丝带导出包含其卡片;气泡预览中的聊天头像属于示例,不会导出。

项目定位、范围与下一步验证见 产品方向。

About

可视化 CSS 界面装饰生成器:自适应气泡、卡片丝带、优惠券缺口。实时预览,复制 HTML/CSS,纯浏览器运行。

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Contributors

Languages