Skip to content

Commit

Permalink
fun: not 2024-04-01 (#897)
Browse files Browse the repository at this point in the history
  • Loading branch information
warmthsea committed Apr 1, 2024
1 parent 86486bb commit 60916c0
Show file tree
Hide file tree
Showing 4 changed files with 35 additions and 35 deletions.
4 changes: 2 additions & 2 deletions .vitepress/config.ts
Original file line number Diff line number Diff line change
Expand Up @@ -593,8 +593,8 @@ export default defineConfigWithTheme<ThemeConfig>({
extends: baseConfig,

lang: 'zh-CN',
title: '威优易',
description: '威优易 - 渐进式的 JavaScript 框架',
title: 'Vue.js',
description: 'Vue.js - 渐进式的 JavaScript 框架',
srcDir: 'src',
srcExclude: ['tutorial/**/description.md'],

Expand Down
20 changes: 10 additions & 10 deletions .vitepress/theme/components/Home.vue
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,8 @@ onMounted(async () => {
<template>
<section id="hero">
<h1 class="tagline">
<span class="accent">威优易</span>
<span class="accent">渐进式</span>
<br />JavaScript 框架
</h1>
<p class="description">
易学易用,性能出色,适用场景丰富的 Web 前端框架。
Expand Down Expand Up @@ -92,20 +93,20 @@ onMounted(async () => {

<section id="highlights" class="vt-box-container">
<div class="vt-box">
<h2 class="accent">威</h2>
<h2>易学易用</h2>
<p>
丰富的、可渐进式集成的生态系统,可以根据应用规模在库和框架间切换自如。
基于标准 HTML、CSS 和 JavaScript 构建,提供容易上手的 API
和一流的文档。
</p>
</div>
<div class="vt-box">
<h2 class="accent">优</h2>
<h2>性能出色</h2>
<p>经过编译器优化、完全响应式的渲染系统,几乎不需要手动优化。</p>
</div>
<div class="vt-box">
<h2 class="accent">易</h2>
<h2>灵活多变</h2>
<p>
基于标准 HTML、CSS 和 JavaScript 构建,提供容易上手的 API
和一流的文档。
丰富的、可渐进式集成的生态系统,可以根据应用规模在库和框架间切换自如。
</p>
</div>
</section>
Expand Down Expand Up @@ -271,12 +272,11 @@ html:not(.dark) .accent,
#highlights h2 {
font-weight: 600;
font-size: 48px;
font-size: 20px;
letter-spacing: -0.4px;
color: var(--vt-c-text-1);
transition: color 0.5s;
padding: 0.75em 0;
width: 1em;
margin-bottom: 0.75em;
}
#highlights p {
Expand Down
44 changes: 22 additions & 22 deletions src/guide/introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,10 +4,10 @@ footer: false

# 简介 {#introduction}

:::info 你正在阅读的是威优易 3 的文档!
:::info 你正在阅读的是 Vue 3 的文档!

- 威优易 2 已于 **2023 年 12 月 31 日**停止维护。详见[威优易 2 终止支持 (EOL)](https://v2.cn.vuejs.org/eol/)
- 想从威优易 2 升级?请参考[迁移指南](https://v3-migration.vuejs.org/)
- Vue 2 已于 **2023 年 12 月 31 日**停止维护。详见 [Vue 2 终止支持 (EOL)](https://v2.cn.vuejs.org/eol/)
- 想从 Vue 2 升级?请参考[迁移指南](https://v3-migration.vuejs.org/)
:::

<style src="@theme/styles/vue-mastery.css"></style>
Expand All @@ -16,16 +16,16 @@ footer: false
<div class="banner-wrapper">
<img class="banner" alt="Vue Mastery banner" width="96px" height="56px" src="https://storage.googleapis.com/vue-mastery.appspot.com/flamelink/media/vuemastery-graphical-link-96x56.png" />
</div>
<p class="description">在 <span>VueMastery</span> 上观看视频课程学习威优易</p>
<p class="description">在 <span>VueMastery</span> 上观看视频课程学习 Vue</p>
<div class="logo-wrapper">
<img alt="Vue Mastery Logo" width="25px" src="https://storage.googleapis.com/vue-mastery.appspot.com/flamelink/media/vue-mastery-logo.png" />
</div>
</a>
</div>

## 什么是威优易? {#what-is-vue}
## 什么是 Vue? {#what-is-vue}

威优易 (发音为 **V-U-E**) 是一款用于构建用户界面的 JavaScript 框架。它基于标准 HTML、CSS 和 JavaScript 构建,并提供了一套声明式的、组件化的编程模型,帮助你高效地开发用户界面。无论是简单还是复杂的界面,威优易都可以胜任
Vue (发音为 /vjuː/,类似 **view**) 是一款用于构建用户界面的 JavaScript 框架。它基于标准 HTML、CSS 和 JavaScript 构建,并提供了一套声明式的、组件化的编程模型,帮助你高效地开发用户界面。无论是简单还是复杂的界面,Vue 都可以胜任

下面是一个最基本的示例:

Expand Down Expand Up @@ -81,21 +81,21 @@ const count = ref(0)
</button>
</div>

上面的示例展示了威优易的两个核心功能
上面的示例展示了 Vue 的两个核心功能

- **声明式渲染**威优易基于标准 HTML 拓展了一套模板语法,使得我们可以声明式地描述最终输出的 HTML 和 JavaScript 状态之间的关系。
- **声明式渲染**Vue 基于标准 HTML 拓展了一套模板语法,使得我们可以声明式地描述最终输出的 HTML 和 JavaScript 状态之间的关系。

- **响应性**威优易会自动跟踪 JavaScript 状态并在其发生变化时响应式地更新 DOM。
- **响应性**Vue 会自动跟踪 JavaScript 状态并在其发生变化时响应式地更新 DOM。

你可能已经有了些疑问——先别急,在后续的文档中我们会详细介绍每一个细节。现在,请继续看下去,以确保你对威优易作为一个框架到底提供了什么有一个宏观的了解
你可能已经有了些疑问——先别急,在后续的文档中我们会详细介绍每一个细节。现在,请继续看下去,以确保你对 Vue 作为一个框架到底提供了什么有一个宏观的了解

:::tip 预备知识
文档接下来的内容会假设你对 HTML、CSS 和 JavaScript 已经基本熟悉。如果你对前端开发完全陌生,最好不要直接从一个框架开始进行入门学习——最好是掌握了基础知识再回到这里。如有需要,你可以通过这些 [JavaScript](https://developer.mozilla.org/zh-CN/docs/Web/JavaScript/A_re-introduction_to_JavaScript)[HTML](https://developer.mozilla.org/zh-CN/docs/Learn/HTML/Introduction_to_HTML)[CSS](https://developer.mozilla.org/zh-CN/docs/Learn/CSS/First_steps) 概述来检验你的知识水平。如果之前有其他框架的经验会很有帮助,但也不是必须的。
:::

## 渐进式框架 {#the-progressive-framework}

威优易是一个框架,也是一个生态。其功能覆盖了大部分前端开发常见的需求。但 Web 世界是十分多样化的,不同的开发者在 Web 上构建的东西可能在形式和规模上会有很大的不同。考虑到这一点,威优易的设计非常注重灵活性和“可以被逐步集成”这个特点。根据你的需求场景,你可以用不同的方式使用威优易
Vue 是一个框架,也是一个生态。其功能覆盖了大部分前端开发常见的需求。但 Web 世界是十分多样化的,不同的开发者在 Web 上构建的东西可能在形式和规模上会有很大的不同。考虑到这一点,Vue 的设计非常注重灵活性和“可以被逐步集成”这个特点。根据你的需求场景,你可以用不同的方式使用 Vue

- 无需构建步骤,渐进式增强静态的 HTML
- 在任何页面中作为 Web Components 嵌入
Expand All @@ -106,13 +106,13 @@ const count = ref(0)

如果你是初学者,可能会觉得这些概念有些复杂。别担心!理解教程和指南的内容只需要具备基础的 HTML 和 JavaScript 知识。即使你不是这些方面的专家,也能够跟得上。

如果你是有经验的开发者,希望了解如何以最合适的方式在项目中引入威优易,或者是对上述的这些概念感到好奇,我们在[使用威优易的多种方式](/guide/extras/ways-of-using-vue)中讨论了有关它们的更多细节。
如果你是有经验的开发者,希望了解如何以最合适的方式在项目中引入 Vue,或者是对上述的这些概念感到好奇,我们在[使用 Vue 的多种方式](/guide/extras/ways-of-using-vue)中讨论了有关它们的更多细节。

无论再怎么灵活,威优易的核心知识在所有这些用例中都是通用的。即使你现在只是一个初学者,随着你的不断成长,到未来有能力实现更复杂的项目时,这一路上获得的知识依然会适用。如果你已经是一个老手,你可以根据实际场景来选择使用威优易的最佳方式,在各种场景下都可以保持同样的开发效率。这就是为什么我们将威优易称为“渐进式框架”:它是一个可以与你共同成长、适应你不同需求的框架。
无论再怎么灵活,Vue 的核心知识在所有这些用例中都是通用的。即使你现在只是一个初学者,随着你的不断成长,到未来有能力实现更复杂的项目时,这一路上获得的知识依然会适用。如果你已经是一个老手,你可以根据实际场景来选择使用 Vue 的最佳方式,在各种场景下都可以保持同样的开发效率。这就是为什么我们将 Vue 称为“渐进式框架”:它是一个可以与你共同成长、适应你不同需求的框架。

## 单文件组件 {#single-file-components}

在大多数启用了构建工具的威优易项目中,我们可以使用一种类似 HTML 格式的文件来书写威优易组件,它被称为**单文件组件** (也被称为 `*.vue` 文件,英文 Single-File Components,缩写为 **SFC**)。顾名思义,威优易的单文件组件会将一个组件的逻辑 (JavaScript),模板 (HTML) 和样式 (CSS) 封装在同一个文件里。下面我们将用单文件组件的格式重写上面的计数器示例:
在大多数启用了构建工具的 Vue 项目中,我们可以使用一种类似 HTML 格式的文件来书写 Vue 组件,它被称为**单文件组件** (也被称为 `*.vue` 文件,英文 Single-File Components,缩写为 **SFC**)。顾名思义,Vue 的单文件组件会将一个组件的逻辑 (JavaScript),模板 (HTML) 和样式 (CSS) 封装在同一个文件里。下面我们将用单文件组件的格式重写上面的计数器示例:

<div class="options-api">

Expand Down Expand Up @@ -160,11 +160,11 @@ button {

</div>

单文件组件是威优易的标志性功能。如果你的用例需要进行构建,我们推荐用它来编写威优易组件。你可以在后续相关章节里了解更多关于[单文件组件的用法及用途](/guide/scaling-up/sfc)但你暂时只需要知道威优易会帮忙处理所有这些构建工具的配置就好
单文件组件是 Vue 的标志性功能。如果你的用例需要进行构建,我们推荐用它来编写 Vue 组件。你可以在后续相关章节里了解更多关于[单文件组件的用法及用途](/guide/scaling-up/sfc)但你暂时只需要知道 Vue 会帮忙处理所有这些构建工具的配置就好

## API 风格 {#api-styles}

威优易的组件可以按两种不同的风格书写**选项式 API****组合式 API**
Vue 的组件可以按两种不同的风格书写**选项式 API****组合式 API**

### 选项式 API (Options API) {#options-api}

Expand Down Expand Up @@ -207,7 +207,7 @@ export default {
### 组合式 API (Composition API) {#composition-api}


通过组合式 API,我们可以使用导入的 API 函数来描述组件逻辑。在单文件组件中,组合式 API 通常会与 [`<script setup>`](/api/sfc-script-setup) 搭配使用。这个 `setup` attribute 是一个标识,告诉威优易需要在编译时进行一些处理,让我们可以更简洁地使用组合式 API。比如,`<script setup>` 中的导入和顶层变量/函数都能够在模板中直接使用。
通过组合式 API,我们可以使用导入的 API 函数来描述组件逻辑。在单文件组件中,组合式 API 通常会与 [`<script setup>`](/api/sfc-script-setup) 搭配使用。这个 `setup` attribute 是一个标识,告诉 Vue 需要在编译时进行一些处理,让我们可以更简洁地使用组合式 API。比如,`<script setup>` 中的导入和顶层变量/函数都能够在模板中直接使用。

下面是使用了组合式 API 与 `<script setup>` 改造后和上面的模板完全一样的组件:

Expand Down Expand Up @@ -238,23 +238,23 @@ onMounted(() => {

### 该选哪一个?{#which-to-choose}

两种 API 风格都能够覆盖大部分的应用场景。它们只是同一个底层系统所提供的两套不同的接口。实际上,选项式 API 是在组合式 API 的基础上实现的!关于威优易的基础概念和知识在它们之间都是通用的
两种 API 风格都能够覆盖大部分的应用场景。它们只是同一个底层系统所提供的两套不同的接口。实际上,选项式 API 是在组合式 API 的基础上实现的!关于 Vue 的基础概念和知识在它们之间都是通用的

选项式 API 以“组件实例”的概念为中心 (即上述例子中的 `this`),对于有面向对象语言背景的用户来说,这通常与基于类的心智模型更为一致。同时,它将响应性相关的细节抽象出来,并强制按照选项来组织代码,从而对初学者而言更为友好。

组合式 API 的核心思想是直接在函数作用域内定义响应式状态变量,并将从多个函数中得到的状态组合起来处理复杂问题。这种形式更加自由,也需要你对威优易的响应式系统有更深的理解才能高效使用。相应的,它的灵活性也使得组织和重用逻辑的模式变得更加强大。
组合式 API 的核心思想是直接在函数作用域内定义响应式状态变量,并将从多个函数中得到的状态组合起来处理复杂问题。这种形式更加自由,也需要你对 Vue 的响应式系统有更深的理解才能高效使用。相应的,它的灵活性也使得组织和重用逻辑的模式变得更加强大。

[组合式 API FAQ](/guide/extras/composition-api-faq) 章节中,你可以了解更多关于这两种 API 风格的对比以及组合式 API 所带来的潜在收益。

如果你是使用威优易的新手,这里是我们的大致建议:
如果你是使用 Vue 的新手,这里是我们的大致建议:

- 在学习的过程中,推荐采用更易于自己理解的风格。再强调一下,大部分的核心概念在这两种风格之间都是通用的。熟悉了一种风格以后,你也能够很快地理解另一种风格。

- 在生产项目中:

- 当你不需要使用构建工具,或者打算主要在低复杂度的场景中使用威优易,例如渐进增强的应用场景,推荐采用选项式 API。
- 当你不需要使用构建工具,或者打算主要在低复杂度的场景中使用 Vue,例如渐进增强的应用场景,推荐采用选项式 API。

- 当你打算用威优易构建完整的单页应用,推荐采用组合式 API + 单文件组件。
- 当你打算用 Vue 构建完整的单页应用,推荐采用组合式 API + 单文件组件。

在学习阶段,你不必只固守一种风格。在接下来的文档中我们会为你提供一系列两种风格的代码供你参考,你可以随时通过左上角的 **API 风格偏好**来做切换。

Expand Down
2 changes: 1 addition & 1 deletion src/index.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
page: true
title: 威优易 - 渐进式 JavaScript 框架
title: Vue.js - 渐进式 JavaScript 框架
---

<script setup>
Expand Down

5 comments on commit 60916c0

@View12138
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

谁允许你提前结束愚人节的😡

@luyuhong0329
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

结束了 0.0

@warmthsea
Copy link
Contributor Author

@warmthsea warmthsea commented on 60916c0 Apr 1, 2024

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

蚌埠住了🤪

@Jinjiang
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

traditionally on April Fool’s Day all pranks are supposed to stop at 12 noon sharp
https://www.historic-uk.com/CultureUK/April-Fools-Day-1st-April/

严格说中午就结束了

@Mr-chen1
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

回来吧 我的威优易 我最骄傲的信仰~

Please sign in to comment.