Skip to content

Commit

Permalink
added docs
Browse files Browse the repository at this point in the history
  • Loading branch information
dg committed Jan 19, 2023
1 parent ad65f04 commit 00285f5
Show file tree
Hide file tree
Showing 20 changed files with 4,464 additions and 0 deletions.
1 change: 1 addition & 0 deletions .gitattributes
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@
.github export-ignore
ncs.* export-ignore
phpstan.neon export-ignore
docs/ export-ignore
tests/ export-ignore

*.sh eol=lf
Expand Down
34 changes: 34 additions & 0 deletions docs/cs/@home.texy
Original file line number Diff line number Diff line change
@@ -0,0 +1,34 @@
Formuláře
*********

<div class=perex>

Nette Forms přinesly revoluci do tvorby webových formulářů. Najednou stačilo napsat několik srozumitelných řádků kódu a měli jste hotový formulář včetně vykreslení, JavaScriptové i serverové validace a navíc špičkově zabezpečený. Ukážeme si, jak

- vytvářet přívětivé formuláře
- validovat odeslaná data
- vykreslovat prvky přesně podle potřeby

</div>


Použitím Nette Forms se vyhnete celé řadě rutinních úkolů, jako je třeba psaní validace (navíc dvojí, na straně serveru a klienta), minimalizujete pravděpodobnost vzniku chyb a bezpečnostních děr.

Formuláře můžete používat buď jako součást Nette Aplikace (tedy v presenterech), nebo úplně samostatně. Protože v obou případech se používání trošku liší, připravili jsme pro vás dva návody:

<div class="wiki-buttons">
<div> "Formuláře v presenterech .[wiki-button]":in-presenter </div>
<div> "Formuláře samostatně .[wiki-button]":standalone </div>
</div>


Instalace
=========

Knihovnu stáhěte a nainstalujete pomocí nástroje [Composer|/best-practices/composer]:

```shell
composer require nette/forms
```

{{composer: nette/forms}}
16 changes: 16 additions & 0 deletions docs/cs/@left-menu.texy
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@


Formuláře
---------
- [Úvod |@home]
- [Formuláře v presenterech|in-presenter]
- [Formuláře samostatně|standalone]
- [Formulářové prvky |controls]
- [Validace |validation]
- [Vykreslování |rendering]
- [Konfigurace |configuration]


Další četba
-----------
- [Návody a postupy |/best-practices/@home]
33 changes: 33 additions & 0 deletions docs/cs/configuration.texy
Original file line number Diff line number Diff line change
@@ -0,0 +1,33 @@
Konfigurace formulářů
*********************

.[perex]
V konfiguraci lze změnit výchozí [chybové hlášky formulářů|validation].

```neon
forms:
messages:
EQUAL: 'Zadejte %s.'
NOT_EQUAL: 'Tato hodnota by neměla být %s.'
FILLED: 'Toto pole je povinné.'
BLANK: 'Toto pole by mělo být prázdné.'
MIN_LENGTH: 'Zadejte prosím alespoň %d znaků.'
MAX_LENGTH: 'Zadejte prosím maximálně %d znaků.'
LENGTH: 'Zadejte prosím hodnotu %d až %d znaků dlouho.'
EMAIL: 'Zadejte platnou e-mailovou adresu.'
URL: 'Zadejte prosím platné URL.'
INTEGER: 'Zadejte platné celé číslo.'
FLOAT: 'Zadejte platné číslo.'
MIN: 'Zadejte prosím hodnotu větší nebo rovnou %d.'
MAX: 'Zadejte prosím hodnotu menší nebo rovnou %d.'
RANGE: 'Zadejte hodnotu mezi %d a %d.'
MAX_FILE_SIZE: 'Velikost nahraného souboru může být nejvýše %d bytů.'
MAX_POST_SIZE: 'Nahraná data překračují limit %d bytů.'
MIME_TYPE: 'Nahraný soubor není v očekávaném formátu.'
IMAGE: 'Nahraný soubor musí být obraz ve formátu JPEG, GIF, PNG nebo WebP.'
Nette\Forms\Controls\SelectBox::VALID: 'Vyberte prosím platnou možnost.'
Nette\Forms\Controls\UploadControl::VALID: 'Při nahrávání souboru došlo k chybě.'
Nette\Forms\Controls\CsrfProtection::PROTECTION: 'Vaše relace vypršela. Vraťte se na domovskou stránku a zkuste to znovu.'
```

Pokud nepoužívate celý framework a tedy ani konfigurační soubory, můžete změnit výchozí chybové hlášky přímo v poli `Nette\Forms\Validator::$messages`.
Loading

0 comments on commit 00285f5

Please sign in to comment.