前段时间开发了一个小插件,功能很简单,引入之后脚本会自动执行一些逻辑,所以在发布时将它打包成了 IIFE 模式的 js 包。
在项目中接入时,直接通过 script
标签引入即可,就像这样:
<script src="https://xxxcdn.com/fehub-plugin.js"></script>
但是在插件的后续使用中,发现有几个参数,如果能够支持自定义的话,使用起来会更加方便。
那么咱们就升级一下,让他支持自定义~
为了避免改动过大,所以第一时间想到的就是通过 script
标签的属性来传递参数,就像这样:
<script src="xxx" param1="fehub" param2="18"></script>
如何获取到参数的值?
好了,参数是设置好了,但是怎样才能取到这个参数呢?
一般情况下,如果我们想要获取某个元素上的属性,可以先通过 querySelector 选择器找到对应的元素,然后再通过 getAttribute 方法获取,就像这样:
<!-- HTML -->
<div id="demo" name="fehub">Hello 👋🏻 ~</div>
<!-- JavaScript -->
const demoEle = document.querySelector("#demo");
console.log(demoEle.getAttribute("name"));
// fehub
所以,可以让用户在接入此脚本的时候,设置一个约定好的固定 id
,然后在脚本内通过 querySelector
获取到此 script
标签,就像这样:
<!-- HTML -->
<script src="https://xxxcdn.com/fehub-plugin.js" id="fehub-plugin" param1="fehub" param2="18"></script>
<!-- JavaScript -->
const script = document.querySelector("#fehub-plugin");
console.log(script);
// <script src="https://xxxcdn.com/fehub-plugin.js" param1="fehub" param2="18"></script>
console.log(script.getAttribute("param1"));
// fehub
console.log(script.getAttribute("param2"));
// 18
但是,这种方法不太可控,如果插件的 id
没有设置,那么就无法达到想要的效果。
原生 API
不过好消息是document
上有一个 currentScript 对象,表示的就是当前正在运行的脚本所属的 script
元素,用起来非常简单,就像这样:
<!-- HTML -->
<script src="https://xxxcdn.com/fehub-plugin.js" param1="fehub" param2="18"></script>
<!-- JavaScript -->
const script = document.currentScript;
console.log(script);
// <script src="https://xxxcdn.com/fehub-plugin.js" param1="fehub" param2="18"></script>
console.log(script.getAttribute("param1"));
// fehub
console.log(script.getAttribute("param2"));
// 18
现在就好多了,直接通过原生 API 即可,而且兼容性也很好:
但是需要注意的是:如果你是以 module 的形式加载的 JavaScript(也就是设置了 type="module"
这个属性),那么 currentScript
这个属性是无效的。
这种情况可以通过 import.meta 的 url
属性配合 querySelector
来获取当前 script
标签元素,就像这样:
<!-- HTML -->
<script type="module" src="https://xxxcdn.com/fehub-plugin.js" param1="fehub" param2="18"></script>
<!-- JavaScript -->
const script = document.querySelector(`script[src="${import.meta.url}"]`);
console.log(script);
// <script src="https://xxxcdn.com/fehub-plugin.js" param1="fehub" param2="18"></script>
console.log(script.getAttribute("param1"));
// fehub
console.log(script.getAttribute("param2"));
// 18
另外,如果想要通过添加自定义属性来传递参数,那么建议使用 data-* 语法设置参数,然后通过 dataset
取值。
可以避免和已有属性出现冲突,也更符合官方标准,就像这样:
<!-- HTML -->
<script src="https://xxxcdn.com/fehub-plugin.js" data-param1="fehub" data-param2="18"></script>
<!-- JavaScript -->
const script = document.currentScript;
console.log(script);
// <script src="https://xxxcdn.com/fehub-plugin.js" data-param1="fehub" data-param2="18"></script>
console.log(script.dataset.param1);
// fehub
console.log(script.dataset.param2);
// 18
关注我
好了,这就是今天分享的全部内容啦 ~
关注我,每天学一个有趣的小知识 😉
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。