全局设置

设计稿转代码全局设置

配置项

你可以在配置页设置转码、图片相关配置。
配置项描述类型定义
转码模式样式框架的不同, scss、tailwind 或 emotion。开启 tailwind 后将无法在 CodeSandbox 预览'jsx+scss' | 'jsx+tailwind' | 'jsx+emotion'
转码优化可选 Scss 重复样式提取为 Mixin、去除冗余节点、修正图层结构、修正矩形背景。使用文档
BoxSizing影响宽高的计算,需与你的项目设置保持一致。在 Tailwind 项目一般需要开启'content-box' | 'border-box '
颜色格式可选 hex 或 rgb。hex 没有透明度时,不添加最后两位。rgb 使用的语法是 rgb(R G B[ / A])
转码倍率
更新
用于出码时等比例缩放 CSS 尺寸,适用于设计稿是 2 倍稿或者 n 倍稿场景场景。使用文档number
使用 margin 代替 gap出码时使用 margin 替换为 column-gap 或 row-gap
复制代码模式影响点击复制按钮时的拷贝内容。整个文件包含组件和引用,仅JSX 仅包含模板代码'file' | 'template'
图片接口自定义图片上传接口时选择 custom'default' | 'extranet' | 'custom'

Tailwind 配置

转码模式选择 jsx+tailwind 后,样式将会匹配为 tailwind 默认的 class。
tailwind 打开后,可在插件配置 Tailwind 的 config.js 文件。D2C 过程中根据颜色和尺寸实际值,自动映射到 tailwindcss 的主题。
下图展示了使用 Tailwind 配置文件和默认生成的 class 的区别,使用配置文件后,将会匹配项目中预设的类名以及 css 变量。
点击 D2C 支持 tailwindcss 主题配置 查看如何使用。

自定义图床

图片上传接口用于上传转码时的图片、js、css、json 文件。社区版插件默认接口上传后的文件仅会保存 3h,如需存储更长时间,需要自定义图片上传服务。
D2C 插件会直接请求你的图片地址,不会存储你的图床信息。

鉴权方式

你可以选择以下方式进行鉴权,配置后将透传到你请求的接口:
  • query:将鉴权 token 直接拼接在 URL 里
  • header:将鉴权 token 通过 header 传递
  • body:将鉴权 token 通过 body 传递
如不配置鉴权,请注意不要将你的图床接口暴露给外部。

返回值

接口返回值需要包含图片的 url,类型如下。

类型定义

注意

  • 注意请求体通过 multipart/form-data 编码,所以你需要有对应的库解析请求体
  • 对文件进行处理时,请注意文件的 key 为 file。请求体的其他字段是你自定义的
  • 根据你使用的框架配置跨域的响应头
    • Access-Control-Allow-Origin: https://semi.design
    • Access-Control-Allow-Methods: POST, GET, OPTIONS
  • 接口必须为 https 协议,调试时浏览器对 localhost 无此限制

示例

  • 开始
    • 介绍
    • 快速开始
    • 选型对比
    • 相关术语
    • 常见问题
    • 更新日志
      更新
  • 研发使用手册
    • 代码转译
    • 标记组件库
    • 标记图标库
    • 标记图层
    • 设计稿检查
      更新
    • 转码插件
      更新
    • 故障排除
    • 基础转换原理
    • 支持组件列表
    • 全局设置
      更新
  • 设计使用手册
    • 使用 Semi Variants
    • 自定义 Variants
    • 设计稿规范
    • 使用 Table 组件
    • 使用 Form 组件
    • 迁移旧设计稿
  • 更多
    • 联系我们
    • 路线图
    • JSON Schema
    • 已知问题