npm 包 quincy-cize 使用教程

简介

quincy-cize 是一个用于处理 CSS 样式的 npm 包。它可以帮助前端开发者快速、方便地进行 CSS 样式的自适应处理,从而在不同屏幕尺寸下保证页面呈现效果的一致性。

该包基于 postcss-px-to-viewport 实现。我们在其基础上进行了一些优化和改进,使得使用 quincy-cize 能够更加方便、灵活、高效。

安装

通过 npm 安装 quincy-cize

--- ------- ---------- -----------

如果你使用的是 yarn,可以使用以下命令:

---- --- -- -----------

使用

在项目中引入

在项目中的 postcss.config.js 文件中添加 quincy-cize 插件,例如:

-------------- - -
  -------- -
    ------------------------
      -- ----
      -- ---
    ---
    -- ---
  -
-

在配置文件中添加选项

在上述代码中,由于我们在插件传入的选项中并没有传入任何配置,因此 quincy-cize 会使用默认配置来进行转换。如果你需要修改默认配置,可以在插件选项中传入相应的配置。

以下是 quincy-cize 支持的配置选项:

  • viewportWidth:设计稿宽度,该值必须传入,单位为像素(px)。
  • viewportHeight:设计稿高度,可选,若未传入则默认为 667 像素(iPhone 6/7/8)。
  • unitPrecision:转换时保留的小数位数,可选,若未传入则默认为 5。

完整的配置示例:

-
  -------------- ----  -- -----
  --------------- -----  -- -----
  -------------- -  -- ----------
-

示例代码

在实际项目中,我们可以在 css 文件中使用像素(px)作为单位,而不必考虑不同屏幕尺寸的问题。quincy-cize 会自动将 css 样式中的像素单位(px)转换为视口单位(vw、vh、vmin 或 vmax)。

例如,假设我们的设计稿宽度为 750 像素,我们需要将某一元素的宽度设置为 300 像素。在 css 文件中,我们可以这样写:

-------- -
  ------ ------
-

使用 quincy-cize 后,该样式会被转换为:

-------- -
  ------ -----
-

注意事项

在使用 quincy-cize 进行样式转换时,需要注意以下事项:

  1. 仅跟随数字左侧的第一个空格进行转换。例如,border: 2px solid #f00 会被转换,但 box-shadow: 1px 1px 10px rgba(0, 0, 0, .5) 不会被转换。
  2. 转换由 postcss 插件完成。因此,必须先使用 postcss 对 css 进行预处理,才能够使用 quincy-cize 进行样式转换。在使用 create-react-app 创建项目时,默认已安装 postcss 插件。

总结

quincy-cize 是一个方便、高效的前端工具,可以帮助开发者快速实现对于不同屏幕尺寸的自适应处理。在开发过程中,我们可以根据设计稿宽度,使用像素(px)作为单位进行样式设置,从而更加方便快捷地进行开发。

来源:JavaScript中文网 ,转载请联系管理员! 本文地址:https://www.javascriptcn.com/post/6005731781e8991b448e94da


猜你喜欢

  • npm 包 cherow-do-expressions-plugin 的使用教程

    随着前端技术的不断发展,JavaScript 的应用范围也越来越广泛。作为一种常用的编程语言,JavaScript 也在不断更新、升级,因此有时候需要使用一些工具来提高代码的效率和质量。

    3 年前
  • npm 包 @sarahjs/core 使用教程

    简介 @sarahjs/core 是一个 Node.js 的包,它提供了一些有用的工具类和工具函数,帮助您快速搭建现代化的 Web 前端应用程序。它支持模块化开发,同时又包含了最常用的前端功能模块,是...

    3 年前
  • npm 包 haraka-plugin-qmail-deliverable 使用教程

    在进行邮件发送时,经常需要对邮件地址进行验证,以确认是否允许发送。而 haraka-plugin-qmail-deliverable 就是一款用来验证邮件地址是否可达的 npm 包,本文将为大家介绍如...

    3 年前
  • npm 包 lock-cli 使用教程

    前言 在前端开发中,我们会经常使用到 npm 包来管理我们所需要的前端库和工具。然而,由于 npm 包的版本更新非常频繁,我们在安装和升级包的时候可能会遇到一些问题。

    3 年前
  • npm 包 markdown-plus 使用教程

    介绍 Markdown 是一种轻量级的标记语言,它可以让你使用易于阅读、写作和发布的纯文本格式来编写结构化的文档。markdown-plus 是一个支持嵌入 HTML 和 LaTeX 语法的增强版 M...

    3 年前
  • npm包pubg-api-redis使用教程

    介绍 pubg-api-redis是一个npm包,可以用来获取玩家的PUBG游戏数据。它的好处是提供了一个快速的缓存机制,通过redis支持,可以大幅度减少对PUBG API的请求次数,支持局部更新数...

    3 年前
  • npm 包 react-image-mappers 使用教程

    在前端开发中,我们经常需要在图片上添加热点,以实现跳转链接或触发事件等功能。react-image-mappers 是一款可以轻松实现图片热点的 npm 包,本文将为大家介绍如何使用该包来实现图片热点...

    3 年前
  • npm 包 cordova-plugin-qucoon-ussd 使用教程

    简介 如果你正在开发一个移动 app,可能会用到 USSD(Unstructured Supplementary Service Data) 技术。而 cordova-plugin-qucoon-us...

    3 年前
  • npm 包 gm-palette 使用教程

    什么是 gm-palette gm-palette 是一种用于生成肉眼能够感知的图像颜色主题的 npm 包,其支持多种颜色主题生成算法,并且提供了简单易用的 API 接口供开发者使用,可以轻松地将 g...

    3 年前
  • npm 包 insight-api-dinero 使用教程

    介绍 insight-api-dinero 是一个 npm 包,它提供了一组钱包 API,可以连接到不同的比特币钱包节点。它包括一些基本的 api,如获取钱包余额,地址历史等等。

    3 年前
  • npm 包 insight-ui-dinero 使用教程

    简介 insight-ui-dinero 是一个基于 React 和 Material-UI 的 UI 库,它提供了一套简单易用的 UI 组件和样式,方便前端开发人员快速构建美观、易用的网站和应用程序...

    3 年前
  • npm 包 interact-lib 使用教程

    在前端开发中,常常需要实现拥有交互性的页面效果。而要实现这些效果,我们经常需要使用 JavaScript 库来辅助实现。其中,一个重要的库就是 interact-lib。

    3 年前
  • npm 包 iscloudx-weex-ui 使用教程

    简介 iscloudx-weex-ui 是一个基于 weex 和 Vue.js 的开源 UI 库,提供了一系列的 UI 组件,方便开发者在 weex 中快速构建高质量的移动端交互界面。

    3 年前
  • npm包 node-onload使用教程

    什么是node-onload? node-onload是一个npm包,用于在Node.js项目中管理并处理异步加载资源。它可以定义加载顺序,设置依赖关系和触发回调函数。

    3 年前
  • npm 包 react-password-strength-zaratan 使用教程

    在前端开发中,密码安全是一个比较重要的问题。React 是一个常用的前端框架,而 react-password-strength-zaratan 是一个 React 的密码强度检测的 npm 包,可以...

    3 年前
  • npm 包 swarms 使用教程

    什么是 swarms ? swarms 是一个基于 Node.js 的分布式网络框架,使用 BitTorrent 协议进行通信,方便数据共享和节点发现。它支持浏览器客户端和 Node.js 服务器端。

    3 年前
  • npm 包 vue-txt-number 使用教程

    在前端开发中,我们经常需要处理数字的显示格式问题,比如将数字转化为货币格式、四舍五入、去掉小数点等等。而 vue-txt-number 这个 npm 包可以帮助我们快速处理这些问题。

    3 年前
  • npm 包 vue-birthday-input 使用教程

    简介 vue-birthday-input 是一个能够提供用户选择生日的 Vue 组件库。它可以让你快速的添加生日选择功能,并且支持常用的格式,如年龄、生日、星座等。

    3 年前
  • npm 包 vvvebjs 使用教程

    在前端开发中,有很多工具和库可以帮助我们提高效率和降低工作量。其中,npm 包是前端开发中少不了的一部分。在本文中,我们将介绍一款名为 vvvebjs 的 npm 包,它是一款基于 Bootstrap...

    3 年前
  • npm 包 @dxcli/example-multi-cli-javascript 使用教程

    在前端开发中,使用一些工具提高开发效率是非常常见的。而在这些工具中,命令行工具的使用是一个值得关注的话题。在这里,我们介绍了一个npm包 @dxcli/example-multi-cli-javasc...

    3 年前

相关推荐

    暂无文章