Skip to content

Commit

Permalink
feat: polishing - guide - quick start
Browse files Browse the repository at this point in the history
  • Loading branch information
AloisSeckar committed Jan 19, 2024
1 parent 0ace1d2 commit 48d8049
Show file tree
Hide file tree
Showing 2 changed files with 31 additions and 31 deletions.
10 changes: 5 additions & 5 deletions src/guide/introduction.md
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ footer: false

## Co je to Vue? {#what-is-vue}

Vue (výslovnost /vjú/) je JavaScriptový framework pro tvorbu uživatelského rozhraní. Je postaven na standardech HTML, CSS a JavaScriptu a poskytuje deklaratorní programovací model orientovaný na komponenty, který pomáhá efektivně vyvíjet jednoduchá i složitá UI.
Vue (výslovnost /vjú/) je JavaScriptový framework pro tvorbu uživatelského rozhraní. Je postaven na standardech HTML, CSS a JavaScriptu a poskytuje deklaratorní programovací model orientovaný na komponenty, který pomáhá efektivně vyvíjet jednoduchá i složitá UI.

Zde je minimální příklad:

Expand Down Expand Up @@ -159,7 +159,7 @@ button {

</div>

SFC je určující vlastnost Vue a je to doporučený postup jak tvořit Vue komponenty, **pokud** vaše použití zahrnuje build fázi. Více o tématu [jak a proč na SFC](/guide/scaling-up/sfc) najdete v příslušné kapitole - prozatím je potřeba vědět, že Vue za vás zvládne veškeré nastavení build nástrojů.
SFC je určující vlastnost Vue a je to doporučený postup jak tvořit Vue komponenty, **pokud** vaše použití zahrnuje build fázi. Více o tématu [jak a proč na SFC](/guide/scaling-up/sfc) najdete v&nbsp;příslušné kapitole - prozatím je potřeba vědět, že Vue za vás zvládne veškeré nastavení build nástrojů.

## API styly {#api-styles}

Expand Down Expand Up @@ -206,9 +206,9 @@ export default {

### Composition API {#composition-api}

S Composition API definujeme komponentu importem API funkcí. V SFC souborech se Compostion API typicky používá spolu se [`<script setup>`](/api/sfc-script-setup). Atritbut `setup` je příznak pro Vue k použití transformací během kompilace, které umožňují použití Composition API s menším množstvím boilerplate kódu. Například importy a proměnné/funkce nejvyšší úrovně deklarované uvnitř `<script setup>` mohou být přímo použity v šabloně.
S Composition API definujeme komponentu importem API funkcí. V SFC souborech se Compostion API typicky používá spolu se [`<script setup>`](/api/sfc-script-setup). Atritbut `setup` je příznak pro Vue k použití transformací během kompilace, které umožňují použití Composition API s&nbsp;menším množstvím boilerplate kódu. Například importy a proměnné/funkce nejvyšší úrovně deklarované uvnitř `<script setup>` mohou být přímo použity v šabloně.

Zde je ta samá komponenta, s úplně stejnou šablonou, ale s použitím Composition API a `<script setup>`:
Zde je ta samá komponenta, s úplně stejnou šablonou, ale s použitím Composition API a&nbsp;`<script setup>`:

```vue
<script setup>
Expand Down Expand Up @@ -239,7 +239,7 @@ onMounted(() => {

Oba API styly jsou schopné běžné případy užití plně pokrýt. Jsou to různá rozhraní nad stejným systémem v pozadí. Options API je vlastně implementováno nad Composition API! Základní koncepty a znalosti o Vue jsou sdíleny nad oběma styly.

Options API se zaměřuje na koncept "instance komponenty" (`this` jak je vidět v příkladu), což je typicky bližší uživatelům zvyklým na mentální model založený na třídách z objektovně orientovaných programovacích jazyků (OOP). Je také lépe přístupnější začátečníkům tím, že abstrahuje detaily o reaktivitě a vynucuje organizaci kódu přes skupiny možností.
Options API se zaměřuje na koncept "instance komponenty" (`this` jak je vidět v&nbsp;příkladu), což je typicky bližší uživatelům zvyklým na mentální model založený na třídách z objektovně orientovaných programovacích jazyků (OOP). Je také lépe přístupnější začátečníkům tím, že abstrahuje detaily o reaktivitě a vynucuje organizaci kódu přes skupiny možností.

Composition API je zaměřeno na deklarování reaktivních proměnných přímo ve funkčním rámci a skládáním stavu dohromady z různých funkcí tak, aby bylo možné zvládnout jejich komplexitu. Je to volnější forma a vyžaduje porozumění, jak funguje reaktivita ve Vue, aby bylo možné ji používat efektivně. Výměnou za to její flexibilita umožňuje silnější vzory pro organizaci a znovupoužití logiky.

Expand Down
52 changes: 26 additions & 26 deletions src/guide/quick-start.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,13 +8,13 @@ import { VTCodeGroup, VTCodeGroupTab } from '@vue/theme'

# Jak začít {#quick-start}

## Vyzkoušejte Vue Online {#try-vue-online}
## Vyzkoušejte Vue online {#try-vue-online}

- Pokud si chcete Vue rychle vyzkoušet, lze použít přímo naše [Hřiště](https://play.vuejs.org/#eNo9jcEKwjAMhl/lt5fpQYfXUQfefAMvvRQbddC1pUuHUPrudg4HIcmXjyRZXEM4zYlEJ+T0iEPgXjn6BB8Zhp46WUZWDjCa9f6w9kAkTtH9CRinV4fmRtZ63H20Ztesqiylphqy3R5UYBqD1UyVAPk+9zkvV1CKbCv9poMLiTEfR2/IXpSoXomqZLtti/IFwVtA9A==).
- Pokud si chcete Vue rychle vyzkoušet, lze ho spustit přímo v našem [Hřišti](https://play.vuejs.org/#eNo9jcEKwjAMhl/lt5fpQYfXUQfefAMvvRQbddC1pUuHUPrudg4HIcmXjyRZXEM4zYlEJ+T0iEPgXjn6BB8Zhp46WUZWDjCa9f6w9kAkTtH9CRinV4fmRtZ63H20Ztesqiylphqy3R5UYBqD1UyVAPk+9zkvV1CKbCv9poMLiTEfR2/IXpSoXomqZLtti/IFwVtA9A==).

- Pokud máte raději čistě HTML setup bez dalších build fází, můžete jako váš počáteční bod využít toto [JSFiddle](https://jsfiddle.net/yyx990803/2ke1ab0z/).
- Pokud máte raději čistě HTML setup bez build fáze, můžete jako počáteční bod využít toto [JSFiddle](https://jsfiddle.net/yyx990803/2ke1ab0z/).

- Pokud už ovládáte Note.js a koncept build nástrojů, můžete si také vyzkoušet kompletní build setup ve vašem prohlížeči na [StackBlitz](https://vite.new/vue).
- Pokud už ovládáte Note.js a koncept build nástrojů, můžete si kompletní build vyzkoušet jen ve vašem prohlížeči na [StackBlitz](https://vite.new/vue).

## Vytvoření Vue aplikace {#creating-a-vue-application}

Expand All @@ -24,9 +24,9 @@ import { VTCodeGroup, VTCodeGroupTab } from '@vue/theme'
- Nainstalovaný [Node.js](https://nodejs.org/) ve verzi 18.0 nebo vyšší
:::

V této sekci si ukážeme jak vystavět základ Vue [Single Page aplikaci](/guide/extras/ways-of-using-vue#single-page-application-spa) na vašem lokálním počítači. Vytvořený projekt bude používat build setup založený na [Vite](https://vitejs.dev) a umožní nám použít Vue [Single-File Components](/guide/scaling-up/sfc) (SFCs).
V této sekci si ukážeme jak vystavět základ Vue [Single Page aplikaci](/guide/extras/ways-of-using-vue#single-page-application-spa) na vašem lokálním počítači. Vytvořený projekt bude používat build setup založený na [Vite](https://vitejs.dev) a umožní nám použít Vue [Single-File komponenty](/guide/scaling-up/sfc) (SFCs).

Zkontrolujte, že máte nainstalovanou aktuální verzi [Node.js](https://nodejs.org/) a váš aktuální pracovní adresář je ten, v němž chcete založit projekt. Spusťte následující příkaz ve vašem příkazovém řádku (bez znaku `$`):
Zkontrolujte, že máte nainstalovanou nejnovější verzi [Node.js](https://nodejs.org/) a váš aktuální pracovní adresář je ten, v němž chcete založit projekt. Spusťte ve vašem příkazovém řádku následující příkaz (bez znaku `$`):

<VTCodeGroup>
<VTCodeGroupTab label="npm">
Expand Down Expand Up @@ -59,7 +59,7 @@ Zkontrolujte, že máte nainstalovanou aktuální verzi [Node.js](https://nodejs
</VTCodeGroupTab>
</VTCodeGroup>

Tento příkaz nainstaluje a spustí [create-vue](https://github.com/vuejs/create-vue), oficiální nástroj Vue pro přípravu základů nové aplikace. Objeví se vstup s několika možnostmi nastavení jako je TypeScript a podpora testování:
Tento příkaz nainstaluje a spustí [create-vue](https://github.com/vuejs/create-vue), oficiální nástroj Vue pro přípravu základů nové aplikace. Objeví se vstup s několika možnostmi nastavení jako je TypeScript a&nbsp;podpora testování:

<div class="language-sh"><pre><code><span style="color:var(--vt-c-green);"></span> <span style="color:#A6ACCD;">Project name: <span style="color:#888;"><span style="color:#89DDFF;">&lt;</span><span style="color:#888;">jmeno-vaseho-projektu</span><span style="color:#89DDFF;">&gt;</span></span></span>
<span style="color:var(--vt-c-green);"></span> <span style="color:#A6ACCD;">Add TypeScript? <span style="color:#888;"><span style="color:#89DDFF;text-decoration:underline">No</span> / Yes</span></span>
Expand All @@ -74,7 +74,7 @@ Tento příkaz nainstaluje a spustí [create-vue](https://github.com/vuejs/creat
<span style="color:#A6ACCD;">Scaffolding project in ./<span style="color:#89DDFF;">&lt;</span><span style="color:#888;">jmeno-vaseho-projektu</span><span style="color:#89DDFF;">&gt;</span>...</span>
<span style="color:#A6ACCD;">Done.</span></code></pre></div>

Pokud si nejste nastavením jisti, zvolte prozatím jednoduše volbu `No` stisknutím Enter. Poté, co je projekt vytvořen, zadejte následující příkazy pro instalaci závislostí a spuštění vývojového (dev) serveru:
Pokud si nejste nastavením jisti, zvolte prozatím jednoduše stisknutím Enter volbu `No`. Poté, co je projekt vytvořen, zadejte následující příkazy pro instalaci závislostí a spuštění vývojového (dev) serveru:

<VTCodeGroup>
<VTCodeGroupTab label="npm">
Expand Down Expand Up @@ -115,11 +115,11 @@ Pokud si nejste nastavením jisti, zvolte prozatím jednoduše volbu `No` stiskn
</VTCodeGroupTab>
</VTCodeGroup>

Nyní by už váš první Vue projekt měl běžet! Všimněte si, že ukázkové komponenty ve vygenerovaném projektu jsou napsány s využitím [Composition API](/guide/introduction#composition-api) a `<script setup>`, a nikoliv v [Options API](/guide/introduction#options-api). Zde jsou nějaké další tipy:
Nyní by už váš první Vue projekt měl běžet! Všimněte si, že ukázkové komponenty ve vygenerovaném projektu jsou napsány s využitím [Composition API](/guide/introduction#composition-api) a `<script setup>`, a&nbsp;nikoliv v [Options API](/guide/introduction#options-api). Zde jsou nějaké další tipy:

- Doporučené vývojové prostředí (IDE) je [Visual Studio Code](https://code.visualstudio.com/) + [plugin Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar). Pokud používáte jiný editor, zkontrolujte [sekci IDE podpory](/guide/scaling-up/tooling#ide-support).
- Více o vývojových nástrojích vč. integrace s frameworky pro backend, je řešeno v sekci [Tooling průvodci](/guide/scaling-up/tooling).
- Pokud se chcete dozvědět víc o build nástroji Vite v pozadí, podívejte se na [Vite dokumentaci](https://vitejs.dev).
- Doporučené vývojové prostředí (IDE) je [Visual Studio Code](https://code.visualstudio.com/) + [plugin Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar). Pokud používáte jiný editor, zkontrolujte [sekci podpory v IDE](/guide/scaling-up/tooling#ide-support).
- Více o vývojových nástrojích vč. integrace s frameworky pro backend, je řešeno v&nbsp;sekci [Nástroje](/guide/scaling-up/tooling).
- Pokud se chcete dozvědět víc o build nástroji Vite v pozadí, podívejte se na [dokumentaci pro Vite](https://vitejs.dev).
- Pokud si vyberete použití TypeScriptu, podívejte se na [průvodce použitím TypeScriptu](typescript/overview).

Jakmile budete připraveni nasadit vaši aplikaci do produkce, spusťte následující:
Expand Down Expand Up @@ -155,7 +155,7 @@ Jakmile budete připraveni nasadit vaši aplikaci do produkce, spusťte následu
</VTCodeGroupTab>
</VTCodeGroup>

Příkaz vytvoří build připravený k produkčnímu nasazení aplikace v podsložce `./dist` uvnitř projektu. Podívejte se na [průvodce Produkčním nasazením](/guide/best-practices/production-deployment), abyste se o nasazování vaší aplikace do produkce dozvěděli víc.
Příkaz vytvoří build připravený k produkčnímu nasazení aplikace v podsložce `./dist` uvnitř projektu. Podívejte se na [průvodce Nasazením do produkce](/guide/best-practices/production-deployment), abyste se o&nbsp;nasazování vaší aplikace do produkce dozvěděli víc.

[Další kroky >](#next-steps)

Expand All @@ -167,13 +167,13 @@ Můžete použít distribuci Vue přímo z CDN úložiště pomocí script tagu:
<script src="https://unpkg.com/vue@3/dist/vue.global.js"></script>
```

Zde jsme použili [unpkg](https://unpkg.com/), ale je možné využití jakékoliv CDN které umí distribuovat npm balíčky, například [jsdelivr](https://www.jsdelivr.com/package/npm/vue) nebo [cdnjs](https://cdnjs.com/libraries/vue). Samozřejmě si můžete soubor také stáhnout a distribuovat sami.
Zde jsme použili [unpkg](https://unpkg.com/), ale je možné využití jakékoliv CDN které umí distribuovat npm balíčky, například [jsdelivr](https://www.jsdelivr.com/package/npm/vue) nebo [cdnjs](https://cdnjs.com/libraries/vue). Samozřejmě si můžete soubor také stáhnout a&nbsp;distribuovat sami.

Při použití Vue z CDN není v procesu žádný "build step". Díky tomu je příprava mnohem jednodušší. Je to vhodné např. pro obohacení statického HTML nebo integraci s backend frameworkem. Nicméně nebudete moci použít Single-File Component (SFC) syntaxi.
Při použití Vue z CDN není v procesu žádná build fáze. Díky tomu je příprava mnohem jednodušší. Je to vhodné např. pro obohacení statického HTML nebo integraci s&nbsp;backend frameworkem. Nicméně nebudete moci použít SFC syntaxi.

### Použití globálního buildu {#using-the-global-build}

výše uvedený odkaz vede na _globalní build_ Vue, kde jsou všechny API nejvyšší úrovně publikované jako vlastnosti globálního `Vue` objektu. Zde je kompletní příklad s použitím globálního buildu:
Výše uvedený odkaz vede na _globalní build_ Vue, kde jsou všechny API nejvyšší úrovně publikované jako vlastnosti globálního `Vue` objektu. Zde je kompletní příklad s použitím globálního buildu:

<div class="options-api">

Expand Down Expand Up @@ -223,14 +223,14 @@ výše uvedený odkaz vede na _globalní build_ Vue, kde jsou všechny API nejvy
[Codepen demo](https://codepen.io/vuejs-examples/pen/eYQpQEG)
:::tip
Řada příkladů pro Composition API napříč celým průvodcem bude používat syntaxi `<script setup>`, která vyžaduje build nástroje. Pokud plánujete používat Composition API bez build fáze, podívejte se na použití [možnosti `setup()`](/api/composition-api-setup).
Řada příkladů pro Composition API napříč celým průvodcem bude používat syntaxi `<script setup>`, která vyžaduje build nástroje. Pokud plánujete používat Composition API bez build fáze, podívejte se na použití [hooku `setup()`](/api/composition-api-setup).
:::
</div>
### Použití ES Module buildu {#using-the-es-module-build}
Ve zbytku dokumentace budeme primárně používat [ES modules](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules) syntaxi. Téměř všechny moderní prohlížeče dnes přirozeně podporují ES moduly, takže můžeme použít Vue z CDN přes nativní ES moduly takto:
Ve zbytku dokumentace budeme primárně používat [ES modules](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Modules) syntaxi. Téměř všechny moderní prohlížeče dnes přirozeně podporují ES moduly, takže můžeme použít Vue z&nbsp;CDN přes nativní ES moduly takto:
<div class="options-api">
Expand Down Expand Up @@ -364,7 +364,7 @@ Import Maps jsou relativně nová funkcionalita prohlížečů. Ujistěte se že
:::
:::warning Poznámka k produkčnímu použití
Dosavadní příklady jsou používány při development buildech Vue - pokud chcete Vue z CDN používat i v produkci, nezapomeňte zkonzultovat [Průvodce produkčním nasazením](/guide/best-practices/production-deployment#without-build-tools).
Dosavadní příklady jsou používány při development buildech Vue - pokud chcete Vue z&nbsp;CDN používat i v produkci, konzultujte s [Průvodcem nasazením do produkce](/guide/best-practices/production-deployment#without-build-tools).
:::
### Rozdělování modulů {#splitting-up-the-modules}
Expand Down Expand Up @@ -406,23 +406,23 @@ export default {
const count = ref(0)
return { count }
},
template: `<div>count is {{ count }}</div>`
template: `<div>Počet je {{ count }}</div>`
}
```
</div>
Pokud otevřete výše uvedené `index.html` v prohlížeči, uvidíte, že stránka vrací chybu, protože ES moduly neumí pracovat přes `file://` protokol, což je protokol, který prohlížeč používá pro otevírání lokálních souborů.
Pokud otevřete výše uvedené `index.html` v prohlížeči, uvidíte, že stránka vrací chybu, protože ES moduly neumí pracovat přes `file://` protokol, který prohlížeč používá pro otevírání lokálních souborů.
Z bezpečnostních důvodů mohou ES moduly fungovat jen přes `http://` protokol používaný prohlížeči při otevírání webových stránek. Aby ES moduly fungovaly i na vašem lokálním stroji, musíme `index.html` servírovat přes `http://` protokol pomocí lokálního HTTP serveru.
Z bezpečnostních důvodů mohou ES moduly fungovat jen přes protokol `http://` používaný prohlížeči při otevírání webových stránek. Aby ES moduly fungovaly i na vašem lokálním stroji, musíme `index.html` servírovat přes `http://` pomocí lokálního HTTP serveru.
Pro spuštění lokálního HTTP serveru napřed nainstalujte [Node.js](https://nodejs.org/en/) a potom zadejte `npx serve` z příkazové řádky ve stejném adresáři, v jakém je váš HTML soubor. Můžete použít i jakýkoliv jiný HTTP server, který umí poskytovat statické soubory se správnými MIME typy.
Pro spuštění lokálního HTTP serveru si napřed nainstalujte [Node.js](https://nodejs.org/en/) a potom zadejte `npx serve` z příkazové řádky ve stejném adresáři, v jakém je váš HTML soubor. Můžete použít i jakýkoliv jiný HTTP server, který umí poskytovat statické soubory se správnými MIME typy.
Mohli jste si povšimnout, že šablona importované komponenty je zapsaná jako inline JavaScript řetězec. Pokud používáte VSCode, můžete nainstalovat [es6-string-html](https://marketplace.visualstudio.com/items?itemName=Tobermory.es6-string-html) rozšíření a uvodit řetězce předponou `/*html*/` pro zapnutí zvýraznění syntaxe.
Mohli jste si povšimnout, že šablona importované komponenty je zapsaná jako inline JavaScript řetězec. Pokud používáte VSCode, můžete nainstalovat rozšíření [es6&#8209;string&#8209;html](https://marketplace.visualstudio.com/items?itemName=Tobermory.es6-string-html) a pro zapnutí zvýraznění syntaxe řetězce uvést předponou `/*html*/`.
## Next Steps {#next-steps}
## Další kroky {#next-steps}
Pokud jste přeskočili [Úvod](/guide/introduction), silně doporučujme přečíst si ho předtím, než se pustíte do zbytku dokumentace.
Pokud jste přeskočili [Úvod](/guide/introduction), silně doporučujme přečíst si ho dřív, než se pustíte do zbytku dokumentace.
<div class="vt-box-container next-steps">
<a class="vt-box" href="/guide/essentials/application">
Expand Down

0 comments on commit 48d8049

Please sign in to comment.