组件

大约 5 分钟

通过使用vuepress-plugin-components，你可以在你的 Markdown 文件中导入和使用一些组件。

可用组件:

ArtPlayer
AudioPlayer
Badge
BiliBili
CodePen
FontIcon
PDF
Replit
SiteInfo
StackBlitz
VideoPlayer
YouTube

默认情况下，<Badge /> 和 <FontIcon /> 是启用的。

要启用组件，你应该使用组件名称数组设置 plugin.components.components。

// .vuepress/config.ts
import { defineUserConfig } from "vuepress";
import { hopeTheme } from "vuepress-theme-hope";

export default defineUserConfig({
  theme: hopeTheme({
    plugins: {
      components: {
        // 你想使用的组件
        components: [
          "AudioPlayer",
          "Badge",
          "BiliBili",
          "CodePen",
          "PDF",
          "Replit",
          "StackBlitz",
          "VideoPlayer",
          "YouTube",
        ],
      },
    },
  }),
});

// .vuepress/config.js
import { hopeTheme } from "vuepress-theme-hope";

export default {
  theme: hopeTheme({
    plugins: {
      components: {
        // 你想使用的组件
        components: [
          "AudioPlayer",
          "Badge",
          "BiliBili",
          "CodePen",
          "PDF",
          "Replit",
          "StackBlitz",
          "VideoPlayer",
          "YouTube",
        ],
      },
    },
  }),
};

ArtPlayer

一个视频播放器:

<ArtPlayer src="https://mse-demo.u2sb.com/caminandes_03_llamigos_720p.mp4" />

一个包含了封面的播放器:

<ArtPlayer
  src="https://mse-demo.u2sb.com/caminandes_03_llamigos_720p.mp4"
  poster="/poster.svg"
/>

一个包含自定义设置的播放器:

<ArtPlayer
  src="https://mse-demo.u2sb.com/caminandes_03_llamigos_720p.mp4"
  airplay
  aspect-ratio
  auto-size
  auto-orientation
  auto-playback
  fast-forward
  flip
  fullscreen-web
  lock
  loop
  is-live
  muted
  mini-progress-bar
  pip
  screenshot
  subtitle-offset
/>

有关可用属性，请参阅 ArtPlayer 页面。

AudioPlayer

一个音频播放器:

An audio

<AudioPlayer src="/assets/assets/sample.mp3" />

一个拥有标题和封面的音频播放器:

A Sample Audio

<AudioPlayer
  src="/assets/assets/sample.mp3"
  title="A Sample Audio"
  poster="/logo.svg"
/>

有关可用属性，请参阅 AudioPlayer 页面。

Badge

支持自定义颜色的徽章。

tip
warning
danger
info
note

有关可用属性，请参阅 Badge 页面。

BiliBili

在 Markdown 文件中嵌入 B 站视频。

一个 B 站视频:

<BiliBili bvid="BV1kt411o7C3" />

一个自定义空降地址且自动播放的 B 站视频:

<BiliBili aid="34304064" cid="109293122" ratio="9:16" time="60" autoplay page="2" />

有关可用属性，请参阅 BiliBili 页面。

CodePen

一个允许你嵌入 CodePen 演示的组件。

一个使用用户和 Slug Hash 的案例:

See the Pen Solar System animation - Pure CSS by kowlor on CodePen.

<CodePen
  user="kowlor"
  slug-hash="ZYYQoy"
  title="Solar System animation - Pure CSS"
  :default-tab="['css','result']"
  :theme="$isDarkmode? 'dark': 'light'"
/>

一个使用链接的案例:

See the Pen Solar System animation - Pure CSS by kowlor on CodePen.

<CodePen
  link="https://codepen.io/kowlor/pen/ZYYQoy"
  title="Solar System animation - Pure CSS"
  :default-tab="['css','result']"
  :theme="$isDarkmode? 'dark': 'light'"
/>

一个加载运行的案例:

See the Pen Solar System animation - Pure CSS by keginaring on CodePen.

<CodePen
  link="https://codepen.io/kowlor/pen/ZYYQoy"
  title="Envelope w/ Hearts"
  status="clicktorun"
  :theme="$isDarkmode? 'dark': 'light'"
/>

有关可用属性，请参阅 CodePen 页面。

FontIcon

允许你显示字体图标的组件。

主页图标:
一个大绿分享图标:

- 主页图标: <FontIcon icon="home" />

- 一个大绿分享图标: <FontIcon icon="share" color="#3eaf7c" size="32" />

有关可用属性，请参阅 FontIcon 页面。

PDF

PDF 浏览器组件。

默认 PDF 阅读器:

<PDF url="/assets/sample.pdf" />

禁用工具栏且初始页面为第二页的阅读器:

<PDF url="/assets/sample.pdf" page="2" no-toolbar />

有关可用属性，请参阅 PDF 页面。

Replit

一个嵌入的 repl:

<Replit user="FuckDoctors" repl="Java-Test" />

一个嵌入的 repl，并且显示指定的文件:

<Replit user="FuckDoctors" repl="Java-Test" file="Main.java" />

一个 repl 链接:

<Replit user="FuckDoctors" repl="Java-Test" plain />

SiteInfo

基础站点信息:

Mr.Hope's Blog

<SiteInfo name="Mr.Hope's Blog" url="https://mrhope.site" preview="https://theme-hope.vuejs.press/assets/image/mrhope.jpg" />

有更多属性的站点信息:

Mr.Hope's Blog

Where there is light, there is hope

<SiteInfo
  name="Mr.Hope's Blog"
  desc="Where there is light, there is hope"
  url="https://mrhope.site"
  logo="https://mrhope.site/logo.svg"
  repo="https://github.com/Mister-Hope/Mister-Hope.github.io"
  preview="https://theme-hope.vuejs.press/assets/image/mrhope.jpg"
/>

有关可用属性，请参阅 SiteInfo 页面。

StackBlitz

在 Markdown 文件中嵌入 StackBlitz 演示。

一个 StackBlitz 项目:

<StackBlitz id="vuepress-theme-hope" />

一个自定义设置的 StackBlitz 项目:

<StackBlitz id="vuepress-theme-hope" hideExplorer hideNavigation hideDevtools />

有关可用属性，请参阅 StackBlitz 页面。

VideoPlayer

在 Markdown 文件中嵌入视频。

一个视频播放器:

<VideoPlayer src="https://upload.wikimedia.org/wikipedia/commons/transcoded/f/f1/Sintel_movie_4K.webm/Sintel_movie_4K.webm.1080p.vp9.webm" />

一个包含了封面和字幕的播放器:

<VideoPlayer
  src="https://upload.wikimedia.org/wikipedia/commons/transcoded/f/f1/Sintel_movie_4K.webm/Sintel_movie_4K.webm.1080p.vp9.webm"
  poster="/assets/poster.svg"
  :tracks="[
    {
      default: true,
      src: '/assets/subtitles/en.vtt',
      kind: 'subtitles',
      label: 'English',
      srcLang: 'en',
    },
    {
      src: '/assets/subtitles/fr.vtt',
      kind: 'subtitles',
      label: 'French',
      srcLang: 'fr',
    },
  ]"
/>

有关可用属性，请参阅 VideoPlayer 页面。

YouTube

在 Markdown 文件中嵌入 YouTube 视频。

一个 YouTube 视频:

<YouTube id="0JJPfz5dg20" />

一个自定义设置的 YouTube 视频:

<YouTube id="0JJPfz5dg20" disable-fullscreen />

一个 YouTube 播放列表:

<YouTube list-type="playlist" list="PLJNLwTPak6dhCRzVelZIs2-DfBp01NX_1" />

有关可用属性，请参阅 YouTube 页面。

组件

# ArtPlayer

# AudioPlayer

# Badge

# BiliBili

# CodePen

# FontIcon

# PDF

# Replit

# SiteInfo

# StackBlitz

# VideoPlayer

# YouTube