如何在 WordPress 网站中使用 Importmap

我一直在尝试开发一个基本的 wordpress 经典主题，无需构建步骤，我可以将其用作入门主题，以便将来开发客户端站点。在撰写本文时，我没有做任何自由职业，因为我正在为一家网络机构工作，并且我们正在构建的网站都涉及构建步骤。所以我想写一个关于如何在 wordpress 主题中使用 importmap 的简短教程。

career tracker 是我现有的一个副项目，它已经使用了 importmap，无需构建步骤，但它是一个纯 javascript 应用程序。

让我们看看如何在 wordpress 世界中做到这一点。

入队模块脚本

在我的主题functions.php中，我使用wordpress中的wp_enqueue_script_module函数将我的javascript文件app.js作为模块脚本排入队列。

wp_enqueue_script_module( 'frontend-scripts', gearup_theme_url . '/static/js/app.js', [], gearup_theme_version, true );

这将输出到前端的以下脚本标签。

我的 javascript 文件被放置在主题文件夹的 static 文件夹中。

static
├── css
│   ├── app.css
│   ├── global.css
│   ├── reset.css
│   ├── utils.css
│   └── variables.css
└── js
    ├── admin.js
    ├── app.js
    ├── components
    │   └── menu.js
    └── utils
        └── index.js

正如您在此文件结构中所看到的，我需要将 utils 文件夹中的 index.js 和 components 文件夹中的 menu.js 导入到我的 app.js 中。在添加 importmap 之前，让我们看看当我在 app.js 中导入这两个文件时它的样子。

// utils
import { ondocumentready } from './utils/index.js';
// components
import menu from './components/menu.js';

但是我想要的是像这样导入文件。

Shopxp网上购物系统

Shopxp购物系统历经多年的考验，并在推出shopxp免费购物系统下载之后，收到用户反馈的各种安全、漏洞、BUG、使用问题进行多次修补，已经从成熟迈向经典，再好的系统也会有问题，在完善的系统也从在安全漏洞，该系统完全开源可编辑，当您下载这套商城系统之后，可以结合自身的技术情况，进行开发完善，当然您如果有更好的建议可从官方网站提交给我们。Shopxp网上购物系统完整可用，无任何收费项目。该系统经过

下载

// utils
import { ondocumentready } from 'utils/index.js';
// components
import menu from 'components/menu.js';

一旦我将导入更改为这种格式，浏览器将在控制台中抛出此错误。

uncaught typeerror: failed to resolve module specifier "utils/index.js". relative references must start with either "/", "./", or "../".

importmap 来救援

将其添加到模板 html head 标签中。您可能需要在 php 中渲染此部分，以便获得静态文件夹的动态 url。

在我的 app.js 中使用它

现在有了 importmap 设置，即使这不是 node 环境，我们仍然可以在我们熟悉的结构下导入文件。请记住，文件需要以 .js 结尾。

// utils
import { ondocumentready } from 'utils/index.js';
// components
import menu from 'components/menu.js';

如果我将 .js 从 utils/index.js 删除到 utils/index，那么浏览器将在控制台中记录此错误。

get http://test.local/wp-content/themes/gearup/static/js/utils/index net::err_aborted 404 (not found)

将 cdn 中的文件添加到我们的导入映射中

我获取了指向我的 web 组件集合的 cdn 链接，并将其添加到我的导入映射中。添加后，现在我们可以像这样将 web 组件导入到 app.js 中。这不是很漂亮吗？

import "ccw/side-nav/index.js";
import "ccw/side-nav-item/index.js";
import "ccw/icon/index.js";
import "ccw/form-layout/index.js";
import "ccw/text-field/index.js";
import "ccw/email-field/index.js";
import "ccw/date-picker/index.js";
import "ccw/option/index.js";
import "ccw/select/index.js";

对于 web 组件，显然我没有在我的 wordpress 主题中使用它，但你可以检查我在开头提到的副项目 career tracker，看看它们是如何工作的。