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 包 @mgol/jquery-color 使用教程

    前言 在前端开发中,颜色选择器是一个常见的组件。对于开发人员来说,编写一个自定义的颜色选择器需要费时费力。但是,使用 @mgol/jquery-color 这个 npm 包可以轻松的实现一个颜色选择器...

    3 年前
  • npm包 aframe-input-mapping-component使用教程

    介绍 aframe-input-mapping-component是一款专门用于WebVR框架A-Frame的npm包,它提供了一种简单快速的方式,让开发者定义虚拟现实设备输入并将其映射到可视化对象的...

    3 年前
  • npm 包 bencoder-js 使用教程

    介绍 bencoder-js 是一个用 JavaScript 实现的 bencode 编码和解码工具。Bencode 是 BitTorrent 协议的一部分,通常用于在 BitTorrent 群集中传...

    3 年前
  • npm 包 deep-equal-ext 使用教程

    简介 deep-equal-ext 是一个在 JavaScript 中对比两个对象是否相等的工具库。相比于 lodash.isEqual(),deep-equal-ext 在某些特定场景下性能更优,同...

    3 年前
  • npm 包 mellotron 使用教程

    在前端开发中,音频合成是一个非常有趣和实用的工具。mellotron 是一个基于 JavaScript 的音频合成工具包,利用人工选择的音频来生成自然的语音。 本文将介绍如何在前端项目中使用 mell...

    3 年前
  • npm 包 vue-in-out 使用教程

    简介 vue-in-out 是一个 Vue.js 的过渡动画插件,它能够在组件进入和离开时添加动画效果,让页面更加生动和有趣。 在本篇文章中,我们将介绍如何使用 vue-in-out,并演示如何自定义...

    3 年前
  • npm 包 vue-draggable-resizable-aone 使用教程

    概述 vue-draggable-resizable-aone 是一个 Vue.js 组件,用于实现元素的拖动和调整大小。它非常易于使用,并提供了丰富的配置选项。本篇文章将介绍如何使用该组件。

    3 年前
  • npm 包 stroff 使用教程

    本文将详细介绍 npm 包 stroff 的使用方法,该包是一个在前端页面中展示字符串的工具。它可以让你以多种方式展示和处理字符串,包括渲染高亮代码、插入 Emoji 表情、自定义字体大小等,从而提高...

    3 年前
  • npm 包 systemnotification 使用教程

    在前端开发中,经常会用到系统通知,比如浏览器的通知,桌面通知等等。而 npm 包 systemnotification 就是用来实现这一功能的,本文就来详细介绍这个包的使用方法。

    3 年前
  • npm 包 stron 使用教程

    在前端开发中,我们经常需要使用各种各样的第三方库和工具,而 npm (Node Package Manager) 就是一个非常重要的包管理工具。它可以帮助我们简单快捷地安装、管理和更新我们项目中的依赖...

    3 年前
  • **npm 包 vue-simple-upload-component 使用教程**

    介绍 vue-simple-upload-component 是一个基于 Vue.js 的简单易用的上传组件,可以帮助前端开发者快速、方便地实现上传图片、文件等功能。

    3 年前
  • npm 包 quasar-helper-json 使用教程

    在前端开发中,我们经常需要处理 JSON 数据。而 quasar-helper-json 是一个封装了一些非常实用的 JSON 处理方法的 npm 包。本文将向您介绍这个 npm 包的基础使用以及常用...

    3 年前
  • npm 包 gulp-json-edit 使用教程

    简介 JSON 是一种常用的数据格式,它广泛用于前端和后端的数据传递和存储。gulp-json-edit 是一个 NPM 包,它提供了一种轻量级的、流畅的方法来编辑 JSON 文件。

    3 年前
  • npm 包 maparraytoobject 使用教程

    在前端开发过程中,我们经常需要使用数组来存储数据。在某些情况下,我们希望把数组转换成对象,这时就需要使用到 npm 包 maparraytoobject。 maparraytoobject 可以非常方...

    3 年前
  • npm 包 polish-plurals 使用教程

    如果你在前端开发过程中需要处理多元化的数据,polish-plurals 包将是你的好帮手。polish-plurals 是一个用于处理波兰语复数的 NPM 包,它提供了简单的 API 来处理以数字为...

    3 年前
  • npm 包 parse-server-test-runner 使用教程

    简介 parse-server-test-runner 是一个用来测试 Parse Server 的 npm 包,它可以帮助我们快速构建基于 Node.js 的测试环境,进行各种自动化测试。

    3 年前
  • npm 包 mangodb-client 使用教程

    介绍 mangodb-client 是一个用于在 Node.js 中连接 MongoDB 数据库的 npm 包。本文将详细介绍该 npm 包的使用方法,旨在帮助前端开发者更好地使用 MongoDB 数...

    3 年前
  • npm 包 gulp-awspublish-redirects 使用教程

    简介 gulp-awspublish-redirects 是一个支持 AWS S3 重定向发布的 gulp 插件。AWS S3 重定向是一种非常有用的功能,可以帮助我们实现网站重定向,提高网站 SEO...

    3 年前
  • npm 包 quincy-egg-mongoose 使用教程

    在前端开发中,经常需要在后端使用数据库来存储数据。mongoose 是一个非常流行的 MongoDB ORM 库。而在 egg.js 中,我们可以通过 quincy-egg-mongoose 插件来更...

    3 年前
  • npm 包 scouter 使用教程

    什么是 scouter? scouter 是一款专门用于监测前端性能的 npm 包。它通过采集浏览器端的性能数据来帮助开发者找出性能瓶颈,从而进行优化。scouter 采用的是完全客户端的解决方案,不...

    3 年前

相关推荐

    暂无文章