我一直在尝试开发一个基本的 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 );
这将输出到前端的以下脚本标签。
<script type="module" src="http://test.local/wp-content/themes/gearup/static/js/app.js?ver=0.1.0" id="frontend-scripts-js-module"></script>
我的 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';
但是我想要的是像这样导入文件。
// 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 "../".
将其添加到模板 html head 标签中。您可能需要在 php 中渲染此部分，以便获得静态文件夹的动态 url。
<script type="importmap">
{
"imports": {
"utils/": "/wp-content/themes/gearup/static/js/utils/",
"components/": "/wp-content/themes/gearup/static/js/components/"
}
}
</script>
现在有了 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)
<script type="importmap">
{
"imports": {
"utils/": "/wp-content/themes/gearup/static/js/utils/",
"components/": "/wp-content/themes/gearup/static/js/components/",
"ccw/": "https://unpkg.com/cucumber-web-components@0.5.2/dist/"
}
}
</script>
我获取了指向我的 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，看看它们是如何工作的。