umi4项目提交css样式display: -webkit-box会被修改为display: box问题解决

umi4 项目样式提交 display: -webkit-box 报错

.description {
  height: 44px;
  overflow: hidden;
  text-overflow: ellipsis;
  -webkit-box-orient: vertical;
  -webkit-line-clamp: 2;
  display: -webkit-box;
}

提交代码时,display: -webkit-box 会被修改为 display: box直接提交。

原因是文件中存在配置

//.lintstagedrc
{
    "*.{css,less}": [
    "max lint --fix --stylelint-only",
    "prettier --cache --write"
  ],
}
  • max lint --fix --stylelint-only,校验和修正所有的 css 或 less 文件
  • prettier --cache --write, prettier 解析器会解析缓存的 css 或 less 文件,将格式化后的结果写回原文件,而不是仅仅输出到控制台

报错

Unexpected vendor-prefix "-webkit-box" value-no-vendor-prefix

这是因为禁止值使用浏览器前缀。

查看:https://stylelint.io/user-guide/rules/value-no-vendor-prefix/

value-no-vendor-prefix: 禁止值添加供应商前缀

解决

//.stylelintrc.js
module.exports = {
  extends: require.resolve("@umijs/max/stylelint"),
  rules: {
    "value-no-vendor-prefix": [
      true,
      {
        ignoreValues: ["box"],
      },
    ],
  },
};

stylelint 的一些其他配置

umi4 项目中.lintstagedrc 文件

{
  "*.{md,json}": [
    "prettier --cache --write"
    //格式md,json文件 --cache表示只修复暂存区改动过的文件
  ],
  "*.{js,jsx}": [
    // 支持只校验和 修正 js、jsx 类型文件;--fix 修正代码   max lint --eslint-only 支持只校验 js、ts、tsx、jsx 类型文件
    "max lint --fix --eslint-only",
    "prettier --cache --write"
  ],
  "*.{css,less}": [
    // umi lint --stylelint-only  支持只校验 css、less 等样式文
    "max lint --fix --stylelint-only",
    "prettier --cache --write"
  ],
  "*.ts?(x)": [
    "max lint --fix --eslint-only",
    "prettier --cache --parser=typescript --write"
    // --parser=typescript: 指定Prettier解析器应使用TypeScript解析器来处理这些文件,这对于正确理解TypeScript特有的语法结构至关重要。
    // --write: 或 -w,这是一个标志,指示Prettier直接修改文件内容,将格式化后的结果写回原文件,而不是仅仅输出到控制台。
    // --cache: 启用缓存功能,这样Prettier在格式化文件时会检查是否有先前格式化过的版本且未发生变化,以加快处理速度。
    // --no-error-on-unmatched-pattern: 如果没有找到匹配此glob模式的文件,Prettier不会抛出错误并中断进程。
  ]
}
<think>嗯,用户问的是在Umi项目中安装postcss-px-to-viewport插件后,是否会自动进行px到viewport单位的转换。我需要先回忆一下Umi的配置机制。 首先,Umi默认集成了PostCSS,所以很多PostCSS插件只需要安装并配置就可以生效。postcss-px-to-viewport这个插件的作用是将px单位转换为vw或vh等视口单位,常用于移动端适配。 然后,用户可能没有仔细阅读文档,或者对Umi的配置流程不太熟悉。需要明确的是,安装插件后,是否还需要手动配置才能生效。根据经验,大多数PostCSS插件在Umi中需要手动在配置文件中添加设置,因为Umi虽然集成了PostCSS,但具体插件的参数需要用户自定义。 接下来,需要确认正确的配置步骤。通常在Umi中,配置PostCSS插件是在.umirc.ts或config/config.ts中的extraPostCSSPlugins里添加。比如: ```javascript export default { extraPostCSSPlugins: [ require('postcss-px-to-viewport')({ viewportWidth: 375, // 其他配置项 }) ] } ``` 用户可能会遗漏这一步,导致插件安装后没有效果。这时候需要提醒用户检查配置文件是否正确添加了插件实例,并且配置项是否合理。 另外,可能遇到的问题包括配置未生效,这时候需要建议用户检查版本兼容性,或者是否有其他配置覆盖了该插件。比如,Umi的版本是否支持当前的插件版本,或者是否存在多个PostCSS配置导致冲突。 还有,用户可能对配置参数不太了解,比如viewportWidth、unitPrecision等,需要给出常见配置示例,并说明各个参数的作用,帮助用户根据项目需求调整。 最后,总结一下,安装后必须正确配置才能自动转换,否则插件不会生效。需要分步骤引导用户完成安装和配置,并验证是否成功。</think>在 Umi 项目中安装 `postcss-px-to-viewport` 插件后,并不会完全自动完成转换,需要手动配置生效。以下是分步说明: --- ### 一、核心逻辑 1. **安装 ≠ 自动生效** 安装插件只是将其引入项目,需通过配置明确告诉 Umi 如何执行转换。 2. **Umi 的 PostCSS 机制** Umi 默认集成了 PostCSS 处理样式,但需要手动配置插件参数才能触发转换逻辑。 --- ### 二、正确操作步骤 #### 1. 安装插件 ```bash npm install postcss-px-to-viewport --save-dev # 或 yarn add postcss-px-to-viewport -D ``` #### 2. 配置 Umi 在 `.umirc.ts` 或 `config/config.ts` 中添加: ```typescript export default { extraPostCSSPlugins: [ require('postcss-px-to-viewport')({ viewportWidth: 375, // 设计稿宽度(与 iPhone 6/7/8 一致) unitToConvert: 'px', // 需要转换的单位 viewportUnit: 'vw', // 转换后的单位 fontViewportUnit: 'vw', // 字体转换单位 selectorBlackList: [], // 不转换的选择器(如正则表达式) minPixelValue: 1, // 最小转换像素值 mediaQuery: false // 是否转换媒体查询中的 px }) ] } ``` --- ### 三、验证是否生效 #### 1. 编写测试代码 ```css /* src/styles/demo.css */ .container { width: 750px; /* 预期转换为 100vw (750/375*100) */ font-size: 28px; } ``` #### 2. 编译后检查 输出结果应为: ```css .container { width: 100vw; font-size: 7.46667vw; /* 28/375*100 */ } ``` --- ### 四、常见问题排查 #### 1. 未生效的可能原因 - ❌ 配置未正确写入 Umi 配置文件 - ❌ 使用了 `selectorBlackList` 过滤了目标选择器 - ❌ 未重启开发服务器(执行 `umi dev` 后修改配置需重启) #### 2. 高级技巧 - **保留原始单位**:通过 `replace` 配置项控制是否保留原始值 - **多设备适配**:结合 `@media` 媒体查询实现不同视口差异化适配 --- ### 五、扩展知识 - **VW 适配原理** `1vw = 1% 视口宽度`,通过将设计稿尺寸除以基准视口宽度实现等比缩放 - **兼容性方案** 可配合 `postcss-viewport-units` 插件自动添加 `content` 属性,解决部分 Android 4.4 兼容性问题 通过以上步骤即可在 Umi 项目中正确使用该插件实现像素到视口单位的自动转换。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值