diff --git a/.vitepress/theme/components/Home.vue b/.vitepress/theme/components/Home.vue index 9a80b577..bf5f6ec0 100644 --- a/.vitepress/theme/components/Home.vue +++ b/.vitepress/theme/components/Home.vue @@ -84,7 +84,7 @@ onMounted(async () => { 中國區鉑金贊助位 點擊瞭解更多中國區鉑金贊助位 點擊了解更多 diff --git a/README.md b/README.md index 823992fd..768f8df3 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@ 本倉庫是[官方文檔倉庫](https://github.com/vuejs/docs)的鏡像翻譯倉庫。我們僅對原文進行內容同步與翻譯,**不包含**基於英文原版的補充、刪改或演繹等。如對原文有任何意見或建議,歡迎到[官方文檔倉庫](https://github.com/vuejs/docs)提出 issue 或發起 PR。 -有勞訪問我們的 [wiki](https://github.com/vuejs-translations/docs-zh-cn/wiki) 瞭解相關注意事項。 +有勞訪問我們的 [wiki](https://github.com/vuejs-translations/docs-zh-cn/wiki) 了解相關注意事項。 目前網站處於長期維護狀態,我們會定期同步英文版的更新,包括文檔內容和前端代碼等。歡迎大家: diff --git a/src/about/community-guide.md b/src/about/community-guide.md index 8208442d..38a386b4 100644 --- a/src/about/community-guide.md +++ b/src/about/community-guide.md @@ -70,7 +70,7 @@ Vue 核心庫提供了一份[貢獻指南](https://github.com/vuejs/core/blob/ma 我希望現在你正在使用你的首選語言閱讀這篇文檔,如果不是,你願意幫助我們翻譯它嗎? -請參閱[翻譯指南](/translations/),瞭解如何參與的細節。 +請參閱[翻譯指南](/translations/),了解如何參與的細節。 ### 領導社區 {#become-a-community-leader} diff --git a/src/about/faq.md b/src/about/faq.md index 91b4da8d..82c399e1 100644 --- a/src/about/faq.md +++ b/src/about/faq.md @@ -2,7 +2,7 @@ ## 誰在維護 Vue? {#who-maintains-vue} -Vue 是一個獨立的社區驅動的項目。它是由[尤雨溪](https://twitter.com/yuxiyou)在 2014 年作為其個人項目創建的。今天,Vue 由[來自世界各地的全職成員和志願者組成的團隊](/about/team)積極活躍地維護著,並由尤雨溪擔任項目負責人。你可以在[這部紀錄片](https://www.youtube.com/watch?v=OrxmtDw4pVI)中瞭解更多關於 Vue 的故事。 +Vue 是一個獨立的社區驅動的項目。它是由[尤雨溪](https://twitter.com/yuxiyou)在 2014 年作為其個人項目創建的。今天,Vue 由[來自世界各地的全職成員和志願者組成的團隊](/about/team)積極活躍地維護著,並由尤雨溪擔任項目負責人。你可以在[這部紀錄片](https://www.youtube.com/watch?v=OrxmtDw4pVI)中了解更多關於 Vue 的故事。 自 2016 年以來,Vue 的發展主要是通過贊助來保障的,我們在財務上是可維續的。如果你或你的企業從 Vue 中受益,請考慮[贊助](/sponsor/)我們,以支持 Vue 的發展! @@ -47,7 +47,7 @@ Vue 3 是性能最強的主流前端框架之一,可以輕鬆處理大多數 w 請注意,像上面這樣的跑分的側重點在於原始渲染性能在特定情況下的優化,因此不能完全代表真實世界的性能結果。如果你更關心頁面加載性能,歡迎用 [WebPageTest](https://www.webpagetest.org/lighthouse) 或是 [PageSpeed Insights](https://pagespeed.web.dev/) 來測試本站。本文檔站是一個完全由 Vue 本身構建,通過靜態生成預渲染,並在客戶端進行 hydration 的單頁應用。它在模擬 4 倍 CPU 降速的 Moto G4 + 低速 4G 網絡的情況下依然能獲得 100 分的性能得分。 -你可以在[渲染機制](/guide/extras/rendering-mechanism)章節瞭解更多關於 Vue 如何自動優化運行時性能的信息,也可以在[性能優化指南](/guide/best-practices/performance)中瞭解如何在特別苛刻的情況下優化 Vue 應用。 +你可以在[渲染機制](/guide/extras/rendering-mechanism)章節了解更多關於 Vue 如何自動優化運行時性能的信息,也可以在[性能優化指南](/guide/best-practices/performance)中了解如何在特別苛刻的情況下優化 Vue 應用。 ## Vue 體積小嗎? {#is-vue-lightweight} @@ -95,7 +95,7 @@ Vue 是在 Web Components 出現之前被創建的,Vue 在某些方面的設 Web Components 規範相對底層一些,因為它們是以自定義元素為中心的。作為一個框架,Vue 解決了更多上層的問題,如高效的 DOM 渲染、響應式狀態管理、工具鏈、客戶端路由和服務器端渲染等。 -Vue 完全支持在 Vue 組件中使用原生自定義元素,也支持將 Vue 組件導出為原生自定義元素——請參閱 [Vue 和 Web Components 指南](/guide/extras/web-components)以瞭解更多細節。 +Vue 完全支持在 Vue 組件中使用原生自定義元素,也支持將 Vue 組件導出為原生自定義元素——請參閱 [Vue 和 Web Components 指南](/guide/extras/web-components)以了解更多細節。 diff --git a/src/about/team/TeamPage.vue b/src/about/team/TeamPage.vue index b34a8981..9b277804 100644 --- a/src/about/team/TeamPage.vue +++ b/src/about/team/TeamPage.vue @@ -40,7 +40,7 @@ shuffleMembers(membersPartnerData as Member[]) diff --git a/src/about/translation.md b/src/about/translation.md index f8099156..f3038c42 100644 --- a/src/about/translation.md +++ b/src/about/translation.md @@ -37,7 +37,7 @@ aside: deep ### 提交規範 -可以參考 [這個網站](https://www.conventionalcommits.org/) 瞭解提交信息的既定書寫格式: +可以參考 [這個網站](https://www.conventionalcommits.org/) 了解提交信息的既定書寫格式: ```text (): diff --git a/src/guide/essentials/class-and-style.md b/src/guide/essentials/class-and-style.md index 94358d88..46b40786 100644 --- a/src/guide/essentials/class-and-style.md +++ b/src/guide/essentials/class-and-style.md @@ -241,7 +241,7 @@ Class 的綁定也是同樣的: This is a child component ``` -你可以在[透傳 Attribute](/guide/components/attrs) 一章中瞭解更多組件的 attribute 繼承的細節。 +你可以在[透傳 Attribute](/guide/components/attrs) 一章中了解更多組件的 attribute 繼承的細節。 ## 綁定內聯樣式 {#binding-inline-styles} diff --git a/src/guide/essentials/component-basics.md b/src/guide/essentials/component-basics.md index 74ab07e4..e0ddbf4d 100644 --- a/src/guide/essentials/component-basics.md +++ b/src/guide/essentials/component-basics.md @@ -174,7 +174,7 @@ import ButtonCounter from './ButtonCounter.vue' ``` -請看 [DOM 內模板解析注意事項](#in-dom-template-parsing-caveats)瞭解更多細節。 +請看 [DOM 內模板解析注意事項](#in-dom-template-parsing-caveats)了解更多細節。 ## 傳遞 props {#passing-props} @@ -501,7 +501,7 @@ Something bad happened. ## 動態組件 {#dynamic-components} -有些場景會需要在兩個組件間來回切換,比如 Tab 界面: +有些場景會需要在兩個組件間來回切換,例如 Tab 界面:
diff --git a/src/guide/essentials/event-handling.md b/src/guide/essentials/event-handling.md index eb5d5b7b..270730a1 100644 --- a/src/guide/essentials/event-handling.md +++ b/src/guide/essentials/event-handling.md @@ -112,12 +112,12 @@ methods: {
-你也可以看看[為事件處理器標註類型](/guide/typescript/composition-api#typing-event-handlers)這一章瞭解更多。 +你也可以看看[為事件處理器標註類型](/guide/typescript/composition-api#typing-event-handlers)這一章了解更多。
-你也可以看看[為事件處理器標註類型](/guide/typescript/options-api#typing-event-handlers)這一章瞭解更多。 +你也可以看看[為事件處理器標註類型](/guide/typescript/options-api#typing-event-handlers)這一章了解更多。
diff --git a/src/guide/essentials/list.md b/src/guide/essentials/list.md index 59262983..0d4241f0 100644 --- a/src/guide/essentials/list.md +++ b/src/guide/essentials/list.md @@ -273,7 +273,7 @@ Vue 默認按照“就地更新”的策略來更新通過 `v-for` 渲染的元 ## 組件上使用 `v-for` {#v-for-with-a-component} -> 這一小節假設你已瞭解[組件](/guide/essentials/component-basics)的相關知識,或者你也可以先跳過這裡,之後再回來看。 +> 這一小節假設你已了解[組件](/guide/essentials/component-basics)的相關知識,或者你也可以先跳過這裡,之後再回來看。 我們可以直接在組件上使用 `v-for`,和在一般的元素上使用沒有區別 (別忘記提供一個 `key`): diff --git a/src/guide/essentials/template-refs.md b/src/guide/essentials/template-refs.md index b81ef44f..261592f4 100644 --- a/src/guide/essentials/template-refs.md +++ b/src/guide/essentials/template-refs.md @@ -167,7 +167,7 @@ export default { ## 組件上的 ref {#ref-on-component} -> 這一小節假設你已瞭解[組件](/guide/essentials/component-basics)的相關知識,或者你也可以先跳過這裡,之後再回來看。 +> 這一小節假設你已了解[組件](/guide/essentials/component-basics)的相關知識,或者你也可以先跳過這裡,之後再回來看。 模板引用也可以被用在一個子組件上。這種情況下引用中獲得的值是組件實例: diff --git a/src/guide/essentials/template-syntax.md b/src/guide/essentials/template-syntax.md index 29e7e8b2..9baf69a1 100644 --- a/src/guide/essentials/template-syntax.md +++ b/src/guide/essentials/template-syntax.md @@ -60,7 +60,7 @@ Vue 使用一種基於 HTML 的模板語法,使我們能夠聲明式地將其
``` -開頭為 `:` 的屬性可能和一般的 HTML 屬性看起來不太一樣,但它的確是合法的屬性名稱字符,並且所有支持 Vue 的瀏覽器都能正確解析它。此外,他們不會出現在最終渲染的 DOM 中。簡寫語法是可選的,但相信在你瞭解了它更多的用處後,你應該會更喜歡它。 +開頭為 `:` 的屬性可能和一般的 HTML 屬性看起來不太一樣,但它的確是合法的屬性名稱字符,並且所有支持 Vue 的瀏覽器都能正確解析它。此外,他們不會出現在最終渲染的 DOM 中。簡寫語法是可選的,但相信在你了解了它更多的用處後,你應該會更喜歡它。 > 接下來的指引中,我們都將在示例中使用簡寫語法,因為這是在實際開發中更常見的用法。 diff --git a/src/guide/introduction.md b/src/guide/introduction.md index 01342849..e1a63149 100644 --- a/src/guide/introduction.md +++ b/src/guide/introduction.md @@ -87,7 +87,7 @@ const count = ref(0) - **響應性**:Vue 會自動跟蹤 JavaScript 狀態並在其發生變化時響應式地更新 DOM。 -你可能已經有了些疑問——先別急,在後續的文檔中我們會詳細介紹每一個細節。現在,請繼續看下去,以確保你對 Vue 作為一個框架到底提供了什麼有一個宏觀的瞭解。 +你可能已經有了些疑問——先別急,在後續的文檔中我們會詳細介紹每一個細節。現在,請繼續看下去,以確保你對 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) 概述來檢驗你的知識水平。如果之前有其他框架的經驗會很有幫助,但並不是必須的。 @@ -106,7 +106,7 @@ Vue 是一個框架,也是一個生態。其功能覆蓋了大部分前端開 如果你是初學者,可能會覺得這些概念有些複雜。別擔心!理解教程和指南的內容只需要具備基礎的 HTML 和 JavaScript 知識。即使你不是這些方面的專家,也能夠跟得上。 -如果你是有經驗的開發者,希望瞭解如何以最合適的方式在項目中引入 Vue,或者是對上述的這些概念感到好奇,我們在[使用 Vue 的多種方式](/guide/extras/ways-of-using-vue)中討論了有關它們的更多細節。 +如果你是有經驗的開發者,希望了解如何以最合適的方式在項目中引入 Vue,或者是對上述的這些概念感到好奇,我們在[使用 Vue 的多種方式](/guide/extras/ways-of-using-vue)中討論了有關它們的更多細節。 無論再怎樣靈活,Vue 的核心知識在所有這些用例中都是通用的。即使你現在只是一個初學者,隨著你的不斷成長,到未來有能力實現更復雜的項目時,這一路上獲得的知識依然會適用。如果你已經是一個老手,你可以根據實際場景來選擇使用 Vue 的最佳方式,在各種場景下都可以保持同樣的開發效率。這就是為什麼我們將 Vue 稱為“漸進式框架”:它是一個可以與你共同成長、適應你不同需求的框架。 @@ -160,7 +160,7 @@ button {
-單文件組件是 Vue 的標誌性功能。如果你的用例需要進行構建,我們推薦用它來編寫 Vue 組件。你可以在後續相關章節裡瞭解更多關於[單文件組件的用法及用途](/guide/scaling-up/sfc)。但你暫時只需要知道 Vue 會幫忙處理所有這些構建工具的配置就好。 +單文件組件是 Vue 的標誌性功能。如果你的用例需要進行構建,我們推薦用它來編寫 Vue 組件。你可以在後續相關章節裡了解更多關於[單文件組件的用法及用途](/guide/scaling-up/sfc)。但你暫時只需要知道 Vue 會幫忙處理所有這些構建工具的配置就好。 ## API 風格 {#api-styles} @@ -244,7 +244,7 @@ onMounted(() => { 組合式 API 的核心思想是直接在函數作用域內定義響應式狀態變量,並將從多個函數中得到的狀態組合起來處理複雜問題。這種形式更加自由,也需要你對 Vue 的響應式系統有更深的理解才能高效使用。相應的,它的靈活性也使得組織和重用邏輯的模式變得更加強大。 -在[組合式 API FAQ](/guide/extras/composition-api-faq) 章節中,你可以瞭解更多關於這兩種 API 風格的對比以及組合式 API 所帶來的潛在收益。 +在[組合式 API FAQ](/guide/extras/composition-api-faq) 章節中,你可以了解更多關於這兩種 API 風格的對比以及組合式 API 所帶來的潛在收益。 如果你是使用 Vue 的新手,這裡是我們的大致建議: @@ -273,7 +273,7 @@ onMounted(() => { -

該指南會帶你深入瞭解框架所有方面的細節。

+

該指南會帶你深入了解框架所有方面的細節。

diff --git a/src/guide/quick-start.md b/src/guide/quick-start.md index 63cf8124..83294895 100644 --- a/src/guide/quick-start.md +++ b/src/guide/quick-start.md @@ -429,7 +429,7 @@ export default {
-

該指南會帶你深入瞭解框架所有方面的細節。

+

該指南會帶你深入了解框架所有方面的細節。

diff --git a/src/guide/scaling-up/ssr.md b/src/guide/scaling-up/ssr.md index a6830fcf..75a7ce48 100644 --- a/src/guide/scaling-up/ssr.md +++ b/src/guide/scaling-up/ssr.md @@ -284,7 +284,7 @@ export function createApp() { } ``` -像 Pinia 這樣的狀態管理庫在設計時就考慮到了這一點。請參考 [Pinia 的 SSR 指南](https://pinia.vuejs.org/zh/ssr/)以瞭解更多細節。 +像 Pinia 這樣的狀態管理庫在設計時就考慮到了這一點。請參考 [Pinia 的 SSR 指南](https://pinia.vuejs.org/zh/ssr/)以了解更多細節。 ### 激活不匹配 {#hydration-mismatch} diff --git a/src/guide/scaling-up/testing.md b/src/guide/scaling-up/testing.md index dce5845f..54261716 100644 --- a/src/guide/scaling-up/testing.md +++ b/src/guide/scaling-up/testing.md @@ -83,7 +83,7 @@ describe('increment', () => { ### 組合式函數 {#composables} 有一類 Vue 應用中特有的函數被稱為 [組合式函數](/guide/reusability/composables),在測試過程中可能需要特殊處理。 -你可以跳轉到下方查看 [測試組合式函數](#testing-composables) 瞭解更多細節。 +你可以跳轉到下方查看 [測試組合式函數](#testing-composables) 了解更多細節。 ### 組件的單元測試 {#unit-testing-components} @@ -95,7 +95,7 @@ describe('increment', () => { 2. 黑盒:組件測試 - 黑盒測試不知曉一個組件的實現細節。這些測試儘可能少地模擬,以測試組件在整個系統中的集成情況。它們通常會渲染所有子組件,因而會被認為更像一種“集成測試”。請查看下方的[組件測試建議](#component-testing)作進一步瞭解。 + 黑盒測試不知曉一個組件的實現細節。這些測試儘可能少地模擬,以測試組件在整個系統中的集成情況。它們通常會渲染所有子組件,因而會被認為更像一種“集成測試”。請查看下方的[組件測試建議](#component-testing)作進一步了解。 ### 推薦方案 {#recommendation} @@ -124,7 +124,7 @@ describe('increment', () => { 在下面的例子中,我們展示了一個步進器(Stepper)組件,它擁有一個標記為 `increment` 的可點擊的 DOM 元素。我們還傳入了一個名為 `max` 的 prop 防止步進器增長超過 `2`,因此如果我們點擊了按鈕 3 次,視圖將仍然顯示 `2`。 - 我們不瞭解這個步進器的實現細節,只知道“輸入”是這個 `max` prop,“輸出”是這個組件狀態所呈現出的視圖。 + 我們不了解這個步進器的實現細節,只知道“輸入”是這個 `max` prop,“輸出”是這個組件狀態所呈現出的視圖。 @@ -205,7 +205,7 @@ describe('increment', () => { - [Cypress 組件測試](https://on.cypress.io/component) 會預期其準確地渲染樣式或者觸發原生 DOM 事件。它可以搭配 [@testing-library/cypress](https://testing-library.com/docs/cypress-testing-library/intro) 這個庫一同進行測試。 -Vitest 和基於瀏覽器的運行器之間的主要區別是速度和執行上下文。簡而言之,基於瀏覽器的運行器,如 Cypress,可以捕捉到基於 Node 的運行器(如 Vitest)所不能捕捉的問題(例如樣式問題、原生 DOM 事件、Cookies、本地存儲和網絡故障),但基於瀏覽器的運行器比 Vitest *慢幾個數量級*,因為它們要執行打開瀏覽器,編譯樣式表以及其他步驟。Cypress 是一個基於瀏覽器的運行器,支持組件測試。請閱讀 [Vitest 文檔的“比較”這一章](https://vitest.dev/guide/comparisons.html#cypress) 瞭解 Vitest 和 Cypress 最新的比較信息。 +Vitest 和基於瀏覽器的運行器之間的主要區別是速度和執行上下文。簡而言之,基於瀏覽器的運行器,如 Cypress,可以捕捉到基於 Node 的運行器(如 Vitest)所不能捕捉的問題(例如樣式問題、原生 DOM 事件、Cookies、本地存儲和網絡故障),但基於瀏覽器的運行器比 Vitest *慢幾個數量級*,因為它們要執行打開瀏覽器,編譯樣式表以及其他步驟。Cypress 是一個基於瀏覽器的運行器,支持組件測試。請閱讀 [Vitest 文檔的“比較”這一章](https://vitest.dev/guide/comparisons.html#cypress) 了解 Vitest 和 Cypress 最新的比較信息。 ### 組件掛載庫 {#mounting-libraries} @@ -245,7 +245,7 @@ Vitest 和基於瀏覽器的運行器之間的主要區別是速度和執行上 #### 跨瀏覽器測試 {#cross-browser-testing} -端到端測試的一個主要優點是你可以瞭解你的應用在多個不同瀏覽器上運行的情況。儘管理想情況應該是 100% 的跨瀏覽器覆蓋率,但很重要的一點是跨瀏覽器測試對團隊資源的回報是逐渐减小的,因為需要額外的時間和機器來持續運行它們。因此,在選擇應用所需的跨瀏覽器測試的數量時,注意權衡是很有必要的。 +端到端測試的一個主要優點是你可以了解你的應用在多個不同瀏覽器上運行的情況。儘管理想情況應該是 100% 的跨瀏覽器覆蓋率,但很重要的一點是跨瀏覽器測試對團隊資源的回報是逐渐减小的,因為需要額外的時間和機器來持續運行它們。因此,在選擇應用所需的跨瀏覽器測試的數量時,注意權衡是很有必要的。 #### 更快的反饋 {#faster-feedback-loops} @@ -257,7 +257,7 @@ Vitest 和基於瀏覽器的運行器之間的主要區別是速度和執行上 #### 無頭模式下的可見性 {#visibility-in-headless-mode} -當端到端測試在 CI/CD 管道中運行時,它們通常在無頭瀏覽器(即不帶界面的瀏覽器)中運行。因此,當錯誤發生時,現代端到端測試框架的一個關鍵特性是能夠在不同的測試階段查看應用的快照、視頻,從而深入瞭解錯誤的原因。而在很早以前,要手動維護這些集成是非常繁瑣的。 +當端到端測試在 CI/CD 管道中運行時,它們通常在無頭瀏覽器(即不帶界面的瀏覽器)中運行。因此,當錯誤發生時,現代端到端測試框架的一個關鍵特性是能夠在不同的測試階段查看應用的快照、視頻,從而深入了解錯誤的原因。而在很早以前,要手動維護這些集成是非常繁瑣的。 ### 推薦方案 {#recommendation-2} @@ -267,7 +267,7 @@ Vitest 和基於瀏覽器的運行器之間的主要區別是速度和執行上 ### 其他選項 {#other-options-2} -- [Playwright](https://playwright.dev/) 也是一個非常好的端到端測試解決方案,支持測試範圍更廣的瀏覽器品類(主要是 WebKit 型的)。查看這篇文章 [《為什麼選擇 Playwright》](https://playwright.dev/docs/why-playwright) 瞭解更多細節。 +- [Playwright](https://playwright.dev/) 也是一個非常好的端到端測試解決方案,支持測試範圍更廣的瀏覽器品類(主要是 WebKit 型的)。查看這篇文章 [《為什麼選擇 Playwright》](https://playwright.dev/docs/why-playwright) 了解更多細節。 - [Nightwatch](https://nightwatchjs.org/) 是一個基於 [Selenium WebDriver](https://www.npmjs.com/package/selenium-webdriver) 的端到端測試解決方案。它的瀏覽器品類支持範圍是最廣的。