usePreviewMode

预览模式允许您查看更改将如何在现场站点上显示，而不会向用户透露它们。

您可以使用内置的 usePreviewMode 组合工具来访问和控制 Nuxt 中的预览状态。如果组合工具检测到预览模式，它将自动强制任何必要的更新，以便为 useAsyncData 和 useFetch 重新渲染预览内容。

const { enabled, state } = usePreviewMode()

选项

自定义 enable 检查

您可以为启用预览模式指定一种自定义方式。默认情况下，usePreviewMode 组合工具如果 url 中有一个 preview 参数，并且等于 true（例如，http://localhost:3000?preview=true），将启用预览模式。您可以将 usePreviewMode 组合工具包装到自定义组合工具中，以保持选项的一致性，并防止任何错误。

export function useMyPreviewMode () {
  return usePreviewMode({
    shouldEnable: () => {
      return !!route.query.customPreview
    }
  });
}

修改默认状态

usePreviewMode 将尝试在状态中存储 url 中 token 参数的值。您可以修改此状态，并且它将在所有 usePreviewMode 调用中可用。

const data1 = ref('data1')

const { enabled, state } = usePreviewMode({
  getState: (currentState) => {
    return { data1, data2: 'data2' }
  }
})

自定义 onEnable 和 onDisable 回调

默认情况下，当启用 usePreviewMode 时，它将调用 refreshNuxtData() 来重新从服务器获取所有数据。

当禁用预览模式时，组合将附加一个回调来在后续路由导航后调用 refreshNuxtData()。

您可以通过为 onEnable 和 onDisable 选项提供自定义函数来指定要触发的自定义回调。

const { enabled, state } = usePreviewMode({
  onEnable: () => {
    console.log('preview mode has been enabled')
  },
  onDisable: () => {
    console.log('preview mode has been disabled')
  }
})

示例

下面的示例创建了一个页面，该页面的一部分内容仅在预览模式下渲染。

<script setup>
const { enabled, state } = usePreviewMode()

const { data } = await useFetch('/api/preview', {
  query: {
    apiKey: state.token
  }
})
</script>

<template>
  <div>
    一些基本内容
    <p v-if="enabled">
      仅预览内容: {{ state.token }}
      <br>
      <button @click="enabled = false">
        disable preview mode
      </button>
    </p>
  </div>
</template>

现在，您可以生成您的网站并为其提供服务：

npx nuxi generate
npx nuxi preview

现在您可以通过在您想看到的页面末尾添加查询参数 preview 来生成您的站点并提供它：

?preview=true