前言
React在很早之前的版本中加了
useId
，用于生成唯一ID。在Vue3.5版本中，终于也有了期待已久的
useId
。这篇文章来带你搞清楚
useId
有哪些应用场景，以及他是如何实现的。
关注公众号：【前端欧阳】，给自己一个进阶vue的机会
useId的作用
他的作用也是生成唯一ID，同一个Vue应用里面每次调用
useId
生成的ID都不同。
使用方法也很简单，代码如下：
<script setup lang="ts">
import { useId } from 'vue'
const id0 = useId();
console.log(id0); // v-0
const id1 = useId();
console.log(id1); // v-1
const id2 = useId();
console.log(id2); // v-2
</script>
看到这里有的小伙伴会有问题，你上面的例子都是在同一组件里面调用
useId
。那如果我在不同的组件里面分别调用
useId
，这些组件生成的ID还是唯一的吗？
比如下面这个例子，父组件代码如下：
<template>
<div>
<UseIdChild1 />
<UseIdChild2 />
</div>
</template>
子组件
UseIdChild1
代码如下：
<script setup lang="ts">
import { useId } from "vue";
const id0 = useId();
const id1 = useId();
console.log(id0);
console.log(id1);
</script>
子组件
UseIdChild2
代码如下：
<script setup lang="ts">
import { useId } from "vue";
const id0 = useId();
const id1 = useId();
console.log(id0);
console.log(id1);
</script>
从上面的代码可以看到两个子组件里面的代码实际是一样的，那你猜猜子组件
UseIdChild1
中打印的
id0
、
id1
和子组件
UseIdChild2
中打印的
id0
、
id1
是不是一样的呢？
答案是：
不一样
。
UseIdChild1
中打印的
id0
的值为
v-0
，
id1
的值为
v-1
。
UseIdChild2
中打印的
id0
的值为
v-2
，
id1
的值为
v-3
。
通过上面的这两个例子，我想你应该猜出来
useId
函数生成唯一ID的规律：“字符串
v-
加上
自增的数字
”。
其中的前缀
v
可以通过
app.config.idPrefix
进行自定义。
有的时候我们要渲染一个列表数据，需要列表的每一个item中有一个唯一的id，此时我们就可以使用
useId
去给每个item生成唯一的id。
这个是最简单的使用场景，接下来我们看看在服务端渲染(SSR)中
useId
的使用场景。
在服务端渲染(SSR)中使用useId
首先我们要搞清楚服务端渲染时有哪些痛点？
我们来看一个服务端渲染的例子，代码如下：
<template>
<div>
<label :htmlFor="id">Do you like Vue3.5?</label>
<input type="checkbox" name="vue3.5" :id="id" />
</div>
</template>
<script setup lang="ts">
const id = Math.random();
</script>
上面的代码如果是跑在客户端渲染时没有任何问题，但是如果在服务端渲染时就会有警告了。如下图：
上面的警告意思是，在服务端时生成的id的值为
0.4050816845323888
。但是在客户端时生成的id的值却是
0.4746900241123273
，这两次生成的id值不同，所以才会出现警告。
可能有的小伙伴会有疑问，为什么在服务端生成一次id后，在客户端又去生成一次id呢？
为了解答上面这个问题，我们先来了解一下服务端渲染(SSR)的流程：
-
首先会在服务端(Node.js环境)发起接口请求，从后端拿到页面渲染需要的数据。
-
根据拿到的数据去生成页面的HTML字符串，此时就会在服务端生成一次id，这一步叫
dehydrate
（脱水）。 -
将服务端生成的HTML字符串发送给客户端(浏览器)。
-
浏览器拿到了服务端生成的HTML字符串可以将其作为首屏内容，直接渲染到页面上。但是此时click之类的事件还没绑定在DOM上，所以在客户端需要再渲染一次。就会在客户端再次生成一次id，这一步叫
hydrate
（注水）。
由于我们这里是使用
Math.random()
去生成的id，在服务端和客户端每次执行
Math.random()
生成的id值当然就不同了，所以才会出现上面的警告。
有了
useId
后，解决上面的警告就很简单了，只需要把
Math.random()
改成
useId()
就可以了。代码如下：
<template>
<div>
<label :htmlFor="id">Do you like Vue3.5?</label>
<input type="checkbox" name="vue3.5" :id="id" />
</div>
</template>
<script setup lang="ts">
const id = useId();
</script>
因为
useId
在服务端渲染时会生成
v-0
，在客户端渲染时依然还是
v-0
。
可能有的小伙伴有疑问，前面不是讲的
useId
每执行一次会给后面的数字
+1
。那么服务端执行一次后，再去客户端执行一次，讲道理应该生成的ID不一样吧？？
useId
生成的“自增数字部分”是维护在vue实例上面的
ids
属性上，服务端渲染时会在Node.js端生成一个vue实例。但是客户端渲染时又会在浏览器中重新生成一个新的vue实例，此时vue实例上的
ids
属性也会被重置，所以在服务端和客户端执行
useId
生成的值是一样的。
useId是如何实现的
我们来看看
useId
的源码，非常简单！！简化后的代码如下：
function useId(): string {
const i = getCurrentInstance()
if (i) {
return (i.appContext.config.idPrefix || 'v') + '-' + i.ids[0] + i.ids[1]++
}
return ''
}
这个
getCurrentInstance
函数我想很多同学都比较熟悉，他的作用是返回当前vue实例。
给
useId
打个断点，来看一下当前vue实例
i
，如下图：
从上图中可以看到vue实例上的
ids
属性是一个数组，数组的第一项是空字符串，第二项是数字0，第三项也是数字0
我们再来看看
useId
是如何返回唯一ID的，如下：
return (i.appContext.config.idPrefix || 'v') + '-' + i.ids[0] + i.ids[1]++
生成的唯一ID由三部分组成：
-
第一部分为前缀，从
app.config.idPrefix
中取的。如果没有配置，那么就是字符串
v
。 -
第二部分为写死的字符串
-
。 -
第三部分为
i.ids[0] + i.ids[1]++
，其中
ids[0]
的值为空字符串。
i.ids[1]++
这里是先取值，然后再执行
++
，所以第三部分的值为数字
0
。再次调用
useId
时，由于上一次执行过一次
++
了。此时的数字值为
1
，并且再次执行
++
。
看到这里有的小伙伴又有疑问了，这里看上去
ids
属性是存在vue实例上面的。每个vue组件都有一个vue实例，那么每个组件都有各自维护的
ids
属性。
那你前面的那个例子中
UseIdChild1
子组件和
UseIdChild2
子组件中各自生成的
id0
的值应该是一样的
v-0
吧，为什么一个是
v-0
，另外一个是
v-2
呢？
答案其实很简单，所有vue实例上面的
ids
属性都是同一个数组，指向的是顶层组件实例上面的那个
ids
属性。创建vue实例的源码如下图：
从上图中可以看到当没有父组件时，也就是最顶层的vue组件实例，就将其
ids
属性设置为数组
['', 0, 0]
。
当生成子组件的vue实例时，由于父组件上面有
ids
属性，所以就用父组件上面的了。指针都是指向的是最顶层vue实例上面的
ids
属性，所以才会说所有的vue组件实例上面的
ids
属性都是指向同一个数组。
这也就是为什么
UseIdChild1
子组件和
UseIdChild2
子组件中各自生成的
id0
的值一个是
v-0
，另外一个是
v-2
。
总结
Vue3.5新增的
useId
可以在Vue应用内生成唯一的ID，我们可以使用
useId
给列表数据中的每一个item生成一个唯一的id。
并且在服务端渲染(SSR)场景中，服务端和客户端执行
useId
生成的是同一个ID。利用这个特点我们可以使用
useId
解决一些在 SSR 应用中，服务器端和客户端生成的 ID 不一致导致的警告。
最后我们讲了
useId
的实现也很简单，生成的ID分为三部分：
-
第一部分为前缀：
app.config.idPrefix
，如果没有配置，那么就是字符串
v
。 -
第二部分字符串：
-
。 -
第三部分的值为一个自增的数字，存在vue实例上面的
ids
属性，所有的vue实例上面的
ids
属性都是指向同一个数组。这也就是为什么说
useId
可以在
Vue应用内
生成唯一的ID，而不是在
Vue组件内
生成唯一的ID。
关注公众号：【前端欧阳】，给自己一个进阶vue的机会
另外欧阳写了一本开源电子书
vue3编译原理揭秘
，看完这本书可以让你对vue编译的认知有质的提升。这本书初、中级前端能看懂，完全免费，只求一个star。
