VueFire,一个一流的 Vue 和 Firebase 体验 — 包括对 Nuxt 的支持,现在已经稳定了。
Vue 和 Firebase 现在比以往任何时候都更好了。
构建更好的VueFire
去年,我们宣布与 Eduardo San Martin Morote 合作,构建一个成熟的 Vue 和 Firebase 体验。自那时起,我们一直在努力构建我们的特性,如 Nuxt 支持,并使库通过 alpha 和 beta 阶段。我们很高兴地说,库现在是稳定的。
今天,我们很高兴地宣布VueFire现在已经稳定,可以使用了。
在本博客中,我们将介绍 VueFire 帮助简化 Vue 和 Firebase 开发的所有方式,但请务必查看文档以获取完整的详细信息。
VueFire 有什么新功能?
惯用的实时绑定
一行实时数据绑定
VueFire 为您提供了方便的可组合项,以便为 Firestore 和实时数据库创建实时数据绑定。
<script setup>
import { useCollection } from 'vuefire';
import { collection } from 'firebase/firestore';
// This is a composable. It only needs a ref to manage
// the subscription.
const todos = useCollection(collection(db, 'todos'));
</script>
<template>
<ul>
<li v-for="todo in todos" :key="todo.id">
<span>{{ todo.text }}</span>
</li>
</ul>
</template>
只需几行代码,您就拥有一个与本地或远程数据库更改保持同步的 todos
数组。
在幕后,VueFire 依靠 Firebase SDK 使用 onSnapshot()
和 onValue()
等方法完成繁重的工作,剥离所有样板代码,为 Vue 开发人员提供量身定制的开发人员体验。
除了 useCollection()
(适用于 Firestore)外,您还可以使用 useDocument()
找到与文档(document)对应的功能,使用 useDatabaseList()
和 useDatabaseObject()
找到与列表和对象(适用于实时数据库)对应的功能:
import { useDatabaseList, useDatabaseObject, useDatabase } from 'vuefire'
import { ref as dbRef } from 'firebase/database'
const db = useDatabase()
const contacts = useDatabaseList(dbRef(db, 'contacts'))
const someContact = useDatabaseObject(dbRef(db, 'contacts', '24'))
VueFire 允许您传递对文档和集合(collections)的动态引用,并自动解除先前引用的绑定并绑定新引用。例如,我们可以依靠路由参数来绑定到特定文档:
<script setup lang="ts">
import { useRoute } from 'vue'
import { useDocument } from 'vuefire'
import { doc } from 'firebase/firestore'
const route = useRoute()
// note the () => doc() to pass a dynamic reference
const contact = useDocument(() => doc(db, 'contacts', route.params.id))
</script>
<template>
<Contact :contact="contact" />
</template>
当从 /contacts/1
导航到 /contacts/2
时,前一个文档将被解除绑定,而新的文档将被绑定,所有这一切只需将一个函数传递给一个文档,而不仅仅是文档。请注意,这也适用于 computed()
属性和 ref()
变量。
身份验证变得更容易
VueFire 采用 Firebase 的底层身份验证功能,并将其封装到 Vue 组件中,使其可以在您的 Vue 应用程序中轻松、习以为常地使用。
<script setup>
import { useCurrentUser } from 'vuefire'
const user = useCurrentUser()
</script>
<template>
<p v-if="user">Hello {{ user.providerData.displayName }}</p>
</template>
user
变量是响应式的,因此您可以将其与其他 Composition API 函数(例如 computed()
或 watch()
)一起使用。
<script setup>
import { useCurrentUser } from 'vuefire'
import { useRouter } from 'vue-router'
const user = useCurrentUser()
watch(user, user => {
if (user == null) {
router.push('/login')
}
})
</script>
<template>
<!-- ... -->
</template>
如果没有用户经过身份验证,则 user
变量将为 null
,因此您可以看到它只需几行即可重定向到登录页面,如上所示。
忠实于 Firebase SDK
VueFire 会尽量不妨碍您,并让您像平常一样使用 Firebase SDK。它提供了在 Vue 上下文中有用的 API,但您可以而且仍然应该使用 Firebase SDK 来完成许多事情,例如事务、批量写入、转换器等。
尽管有特定的 Vue 集成,您仍然可以通过手动调用 doc()
、 collection()
以及 Firebase SDK 中的其他方法来访问 Firebase 引用。我们相信这有助于我们更接近 Firebase SDK,并使同时使用两者变得更加直观。例如,不能使用VueFire写入绑定数据,必须使用Firebase SDK进行更新操作:
<script setup lang="ts">
import { useFirestore } from 'vuefire'
import { doc, addDoc, serverTimestamp } from "firebase/firestore";
const db = useFirestore()
function addTodo(text: string) {
// ✨ add a new todo
await addDoc(collection(db, "todos"), {
text,
createdAt: serverTimestamp(),
done: false
});
}
</script>
VueFire 并未覆盖所有 Firebase 服务,也没有尝试覆盖所有 Firebase 服务。大多数时候不需要抽象,Firebase SDK 就足够了。例如,您可以直接将消息服务与 Firebase SDK 结合使用:
<script setup>
import { useFirebaseApp } from 'vuefire'
import { getMessaging, onMessage } from 'firebase/messaging'
const firebaseApp = useFirebaseApp()
const messaging = getMessaging(firebaseApp)
onMessage(messaging, payload => {
console.log('Message received. ', payload)
})
</script>
不需要 Vue 集成或 VueFire 特定代码。
Nuxt支持,服务器支持变得简单
VueFire 最令人兴奋的功能之一是它的 Nuxt 模块。它不仅负责 Firebase 初始化,还处理将 Firebase 与 Nuxt 集成的最复杂部分之一:服务器端渲染 (SSR)。为了使用 VueFire 的 Nuxt 模块,请使用您最喜欢的包管理器安装它:
npm install nuxt-vuefire
然后你可以在 Nuxt 配置文件中配置它:
export default defineNuxtConfig({
modules: [
// ... other modules
'nuxt-vuefire',
],
vuefire: {
// Firebase App configuration
config: {
apiKey: '...',
authDomain: '...',
projectId: '...',
appId: '...',
},
},
})
最重要的是,VueFire 的 Nuxt 模块还使得使用 AppCheck、身份验证和模拟器等功能变得非常容易。
App Check 支持,轻松、安全的后端访问
Firebase App Check 是一个额外的安全层,通过证明传入流量来自您的应用程序并阻止没有有效凭据的流量,帮助保护对您的服务的访问。它有助于保护您的后端免遭滥用,例如计费欺诈、网络钓鱼、应用程序假冒和数据中毒。
启用 AppCheck 就像将 appCheck
属性添加到 vuefire
配置对象一样简单:
export default defineNuxtConfig({
// ...
vuefire: {
// Enables AppCheck
appCheck: {
// Allows you to use a debug token in development
debug: process.env.NODE_ENV !== 'production',
provider: 'ReCaptchaEnterprise',
key: '...',
},
},
})
通过使用 debug
选项,您可以在开发中使用调试令牌。无论是在开发期间还是在重要发布之前,这对于在没有模拟器的情况下进行本地测试非常有用。
服务器和客户端身份验证同步
通过客户端和服务器进行同步身份验证可能很难管理。每台机器都需要验证和维护相同的身份验证上下文。这可能需要设置 cookie、后台云函数或其他复杂的方法。
然而,使用 VueFire 的 Nuxt 模块设置身份验证也很容易:
export default defineNuxtConfig({
// ...
vuefire: {
// Enables and initializes the auth module
auth: {
enabled: true,
},
},
})
默认情况下,这不会启用服务器端渲染需要验证用户的页面。在大多数情况下,这样做是没有问题的,因为你不需要对隐藏在身份验证后面的页面进行搜索引擎优化。这还能节省大量计算能力。
但是,可以通过让模块为经过身份验证的用户创建一个 cookie 并在每个请求上使用它来对它们进行身份验证来启用此功能。然后,呈现页面,就像用户已通过身份验证一样:
export default defineNuxtConfig({
// ...
vuefire: {
// Enables and initializes the auth module
auth: {
enabled: true,
sessionCookie: true,
},
},
})
设置完成后,您可以使用 useCurrentUser()
,如上所示。它会自动导入,使其更易于使用。您还可以使用 getCurrentUser()
等待用户在中间件中登录:
export default defineNuxtRouteMiddleware(async to => {
const user = await getCurrentUser()
if (!user) {
// redirect to the login page
return navigateTo({
path: '/login',
query: {
// keep the original path as a query parameter
redirect: to.fullPath,
},
})
}
})
然后在路由中定义页面元数据:
<script setup lang="ts">
definePageMeta({
middleware: ['authenticated'],
});
</script>
模拟器设置变得简单
Firebase 模拟器套件是使用 Firebase 进行开发的推荐方式。这使您可以针对 Firebase 服务的本地实例进行开发,而不是处理需要网络连接或可能产生计费问题的云连接项目。
通常,要使用模拟器,您需要编写代码来告诉 Firebase SDK 连接到模拟器而不是云项目。然而,在 Nuxt 模块中,这一切都会自动发生。
默认情况下,如果您有一个带有 emulators 属性的 firebase.json
文件,VueFire 将在开发过程中自动启用模拟器。
一个全新的文档站点
VueFire 文档位于 https://vuefire.vuejs.org/。
这些文档在主存储库中是开源的。如果您想看到任何更改或添加,请告诉我们!
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。