块编辑器开发文档

@wordpress/browserslist-config

💡 云策文档标注

概述

@wordpress/browserslist-config 是 WordPress 提供的可共享 Browserslist 配置包,用于定义项目支持的浏览器范围。它作为 Gutenberg 项目的一部分,通过 npm 发布,便于开发者在构建工具中统一浏览器兼容性设置。

关键要点

  • 安装方式:通过 npm install browserslist @wordpress/browserslist-config --save-dev 安装,需 Node.js LTS 版本支持。
  • 配置方法:在 package.json 的 browserslist 字段或 .browserslistrc 文件中使用 extends @wordpress/browserslist-config 来继承配置。
  • 返回数据:导入包后返回一个支持的浏览器数组,可与 Autoprefixer、Babel 等工具集成。
  • 项目背景:属于 Gutenberg 项目的独立包,采用 monorepo 结构,贡献指南请参考项目主文档。

📄 原文内容

WordPress Browserslist shareable config for Browserslist.

Installation

Install the module

$ npm install browserslist @wordpress/browserslist-config --save-dev

Note: This package requires Node.js version with long-term support status (check Active LTS or Maintenance LTS releases). It is not compatible with older versions.

Usage

Add this to your package.json file:

"browserslist": [
    "extends @wordpress/browserslist-config"
]

Alternatively, add this to .browserslistrc file:

extends @wordpress/browserslist-config

This package when imported returns an array of supported browsers, for more configuration examples including Autoprefixer, Babel, ESLint, PostCSS, and stylelint see the Browserslist examples repo.

Contributing to this package

This is an individual package that’s part of the Gutenberg project. The project is organized as a monorepo. It’s made up of multiple self-contained software packages, each with a specific purpose. The packages in this monorepo are published to npm and used by WordPress as well as other software projects.

To find out more about contributing to this package or Gutenberg as a whole, please read the project’s main contributor guide.