Skip to content

Commit 26c380f

Browse files
mildabredg
authored andcommitted
form: improvements (#995)(#996)(#997)(#998)
1 parent cc2cbab commit 26c380f

33 files changed

+273
-177
lines changed

forms/bg/rendering.texy

Lines changed: 16 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
Изобразяване на форми
22
*********************
33

4-
Външният вид на формите може да варира значително. Всъщност има две крайности. Първият е, че се налага да създадете отново набор от много сходни формуляри с малко или никакви усилия. Обикновено това са формуляри в задната част на системата.
4+
Външният вид на формите може да бъде много разнообразен. На практика можем да се сблъскаме с две крайности. От една страна, има нужда от визуализиране на поредица от формуляри в дадено приложение, които визуално си приличат един на друг, и оценяваме лесното визуализиране без шаблон с помощта на `$form->render()`. Такъв обикновено е случаят с административните интерфейси.
55

6-
На другия полюс са малки, сладки форми, всяка от които е произведение на изкуството. Тяхното оформление е най-добре да бъде написано в HTML. Разбира се, отвъд тези крайности има много междинни форми.
6+
От друга страна, има различни формуляри, в които всеки един е уникален. Техният външен вид се описва най-добре с помощта на езика HTML в шаблона. И разбира се, освен двете споменати крайности, ще срещнем много форми, които попадат някъде по средата.
77

88

9-
Latte .[#toc-latte]
10-
===================
9+
Рендъринг с Latte .[#toc-rendering-with-latte]
10+
==============================================
1111

1212
[Системата за шаблони Latte |latte:] улеснява значително изчертаването на форми и техните елементи. Първо ще ви покажем как да визуализирате формулярите ръчно, елемент по елемент, за да получите пълен контрол върху кода. По-късно ще ви покажем как да [автоматизирате |#Automatic-Rendering] такова визуализиране.
1313

@@ -152,6 +152,12 @@ protected function createComponentSignInForm(): Form
152152
```
153153

154154

155+
`{form}`
156+
--------
157+
158+
Етикети `{form signInForm}...{/form}` са алтернатива на `<form n:name="signInForm">...</form>`.
159+
160+
155161
Автоматично визуализиране .[#toc-automatic-rendering]
156162
-----------------------------------------------------
157163

@@ -256,8 +262,8 @@ protected function createComponentSignInForm(): Form
256262
```
257263

258264

259-
Без Latte .[#toc-without-latte]
260-
===============================
265+
Изобразяване без Latte .[#toc-rendering-without-latte]
266+
======================================================
261267

262268
Най-лесният начин за показване на формата е да извикате
263269

@@ -321,13 +327,13 @@ Renderer .[#toc-renderer]
321327
<tr class="required">
322328
<th><label class="required" for="frm-name">Name:</label></th>
323329

324-
<td><input type="text" class="text" name="name" id="frm-name" value=""></td>
330+
<td><input type="text" class="text" name="name" id="frm-name" required value=""></td>
325331
</tr>
326332

327333
<tr class="required">
328334
<th><label class="required" for="frm-age">Age:</label></th>
329335

330-
<td><input type="text" class="text" name="age" id="frm-age" value=""></td>
336+
<td><input type="text" class="text" name="age" id="frm-age" required value=""></td>
331337
</tr>
332338

333339
<tr>
@@ -357,12 +363,12 @@ $form->render();
357363
<dl>
358364
<dt><label class="required" for="frm-name">Name:</label></dt>
359365

360-
<dd><input type="text" class="text" name="name" id="frm-name" value=""></dd>
366+
<dd><input type="text" class="text" name="name" id="frm-name" required value=""></dd>
361367

362368

363369
<dt><label class="required" for="frm-age">Age:</label></dt>
364370

365-
<dd><input type="text" class="text" name="age" id="frm-age" value=""></dd>
371+
<dd><input type="text" class="text" name="age" id="frm-age" required value=""></dd>
366372

367373

368374
<dt><label>Gender:</label></dt>

forms/cs/rendering.texy

Lines changed: 16 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
Vykreslování formulářů
22
**********************
33

4-
Vzhled formulářů může být velmi různorodý. V praxi můžeme narazit na dva extrémy. Na jedné straně stojí potřeba v aplikaci vykreslovat řadu formulářů, které jsou si vizuálně podobné jako vejce vejci, a oceníme snadné vykreslení pomocí `$form->render()`. Jde obvykle o případ administračních rozhraní.
4+
Vzhled formulářů může být velmi různorodý. V praxi můžeme narazit na dva extrémy. Na jedné straně stojí potřeba v aplikaci vykreslovat řadu formulářů, které jsou si vizuálně podobné jako vejce vejci, a oceníme snadné vykreslení bez šablony pomocí `$form->render()`. Jde obvykle o případ administračních rozhraní.
55

6-
Na druhé straně tu jsou rozmanité formuláře, kde platí: co kus, to originál. Jejich podobu nejlépe popíšeme jazykem HTML. A samozřejmě kromě obou zmíněných extrémů narazíme na spoustu formulářů, které se pohybují někde mezi.
6+
Na druhé straně tu jsou rozmanité formuláře, kde platí: co kus, to originál. Jejich podobu nejlépe popíšeme jazykem HTML v šabloně formuláře. A samozřejmě kromě obou zmíněných extrémů narazíme na spoustu formulářů, které se pohybují někde mezi.
77

88

9-
Latte
10-
=====
9+
Vykreslení pomocí Latte
10+
=======================
1111

1212
[Šablonovací sytém Latte|latte:] zásadně usnadňuje vykreslení formulářů a jejich prvků. Nejprve si ukážeme, jak formuláře vykreslovat ručně po jednotlivých prvcích a tím získat plnou kontrolu nad kódem. Později si ukážeme, jak lze takové vykreslování [zautomatizovat |#Automatické vykreslování].
1313

@@ -152,6 +152,12 @@ Přítomnost chyby můžeme zjistit metodou `hasErrors()` a podle toho nastavit
152152
```
153153

154154

155+
`{form}`
156+
--------
157+
158+
Značky `{form signInForm}...{/form}` jsou alternativou k `<form n:name="signInForm">...</form>`.
159+
160+
155161
Automatické vykreslování
156162
------------------------
157163

@@ -256,8 +262,8 @@ S vykreslením prvků uvnitř formulářového kontejneru pomůže tag `{formCon
256262
```
257263

258264

259-
Bez Latte
260-
=========
265+
Vykreslení bez Latte
266+
====================
261267

262268
Nejjednodušší způsob, jak vykreslit formulář, je zavolat:
263269

@@ -321,13 +327,13 @@ Pokud nenastavíme vlastní renderer, bude použit výchozí vykreslovač [api:N
321327
<tr class="required">
322328
<th><label class="required" for="frm-name">Jméno:</label></th>
323329

324-
<td><input type="text" class="text" name="name" id="frm-name" value=""></td>
330+
<td><input type="text" class="text" name="name" id="frm-name" required value=""></td>
325331
</tr>
326332

327333
<tr class="required">
328334
<th><label class="required" for="frm-age">Věk:</label></th>
329335

330-
<td><input type="text" class="text" name="age" id="frm-age" value=""></td>
336+
<td><input type="text" class="text" name="age" id="frm-age" required value=""></td>
331337
</tr>
332338

333339
<tr>
@@ -357,12 +363,12 @@ Výsledkem je tento HTML kód:
357363
<dl>
358364
<dt><label class="required" for="frm-name">Jméno:</label></dt>
359365

360-
<dd><input type="text" class="text" name="name" id="frm-name" value=""></dd>
366+
<dd><input type="text" class="text" name="name" id="frm-name" required value=""></dd>
361367

362368

363369
<dt><label class="required" for="frm-age">Věk:</label></dt>
364370

365-
<dd><input type="text" class="text" name="age" id="frm-age" value=""></dd>
371+
<dd><input type="text" class="text" name="age" id="frm-age" required value=""></dd>
366372

367373

368374
<dt><label>Pohlaví:</label></dt>

forms/de/rendering.texy

Lines changed: 16 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
Formulare Rendering
22
*******************
33

4-
Das Erscheinungsbild von Formularen kann sehr unterschiedlich sein. In der Tat gibt es zwei Extreme. Die eine Seite ist die Notwendigkeit, eine Reihe sehr ähnlicher Formulare mit wenig bis gar keinem Aufwand immer wieder neu zu rendern. In der Regel sind das Verwaltungen und Back-Ends.
4+
Das Erscheinungsbild von Formularen kann sehr unterschiedlich sein. In der Praxis können wir auf zwei Extreme stoßen. Einerseits besteht die Notwendigkeit, eine Reihe von Formularen in einer Anwendung darzustellen, die sich optisch ähneln, und wir schätzen die einfache Darstellung ohne Vorlage mit `$form->render()`. Dies ist normalerweise bei Verwaltungsschnittstellen der Fall.
55

6-
Die andere Seite sind kleine, süße Formulare, von denen jedes einzelne ein Kunstwerk ist. Ihr Layout kann am besten in HTML geschrieben werden. Natürlich gibt es neben diesen Extremen auch viele Formulare, die genau dazwischen liegen.
6+
Andererseits gibt es verschiedene Formulare, von denen jedes einzelne einzigartig ist. Ihr Aussehen wird am besten durch die HTML-Sprache in der Vorlage beschrieben. Und natürlich werden wir neben den beiden genannten Extremen auch viele Formulare finden, die irgendwo dazwischen liegen.
77

88

9-
Latte .[#toc-latte]
10-
===================
9+
Rendering mit Latte .[#toc-rendering-with-latte]
10+
================================================
1111

1212
Das [Latte-Templating-System |latte:] erleichtert das Rendern von Formularen und ihren Elementen grundlegend. Wir werden zunächst zeigen, wie man Formulare manuell, Element für Element, rendern kann, um die volle Kontrolle über den Code zu erhalten. Später werden wir zeigen, wie man dieses Rendering [automatisieren |#Automatic rendering] kann.
1313

@@ -152,6 +152,12 @@ Wir können das Vorhandensein eines Fehlers mit der Methode `hasErrors()` erkenn
152152
```
153153

154154

155+
`{form}`
156+
--------
157+
158+
Tags `{form signInForm}...{/form}` sind eine Alternative zu `<form n:name="signInForm">...</form>`.
159+
160+
155161
Automatisches Rendering .[#toc-automatic-rendering]
156162
---------------------------------------------------
157163

@@ -256,8 +262,8 @@ Das Tag `formContainer` hilft beim Rendern von Eingaben innerhalb eines Formular
256262
```
257263

258264

259-
Ohne Latte .[#toc-without-latte]
260-
================================
265+
Rendering ohne Latte .[#toc-rendering-without-latte]
266+
====================================================
261267

262268
Der einfachste Weg, ein Formular zu rendern, ist der Aufruf:
263269

@@ -321,13 +327,13 @@ Wenn wir keinen benutzerdefinierten Renderer festlegen, wird der Standard-Render
321327
<tr class="required">
322328
<th><label class="required" for="frm-name">Name:</label></th>
323329

324-
<td><input type="text" class="text" name="name" id="frm-name" value=""></td>
330+
<td><input type="text" class="text" name="name" id="frm-name" required value=""></td>
325331
</tr>
326332

327333
<tr class="required">
328334
<th><label class="required" for="frm-age">Age:</label></th>
329335

330-
<td><input type="text" class="text" name="age" id="frm-age" value=""></td>
336+
<td><input type="text" class="text" name="age" id="frm-age" required value=""></td>
331337
</tr>
332338

333339
<tr>
@@ -357,12 +363,12 @@ Das Ergebnis ist der folgende Ausschnitt:
357363
<dl>
358364
<dt><label class="required" for="frm-name">Name:</label></dt>
359365

360-
<dd><input type="text" class="text" name="name" id="frm-name" value=""></dd>
366+
<dd><input type="text" class="text" name="name" id="frm-name" required value=""></dd>
361367

362368

363369
<dt><label class="required" for="frm-age">Age:</label></dt>
364370

365-
<dd><input type="text" class="text" name="age" id="frm-age" value=""></dd>
371+
<dd><input type="text" class="text" name="age" id="frm-age" required value=""></dd>
366372

367373

368374
<dt><label>Gender:</label></dt>

forms/el/rendering.texy

Lines changed: 16 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
Μορφές απόδοσης
22
***************
33

4-
Η εμφάνιση των φορμών μπορεί να διαφέρει σημαντικά. Στην πραγματικότητα, υπάρχουν δύο ακραίες καταστάσεις. Η μία πλευρά είναι η ανάγκη να αποδώσετε ένα σύνολο πολύ παρόμοιων φορμών από την αρχή, με ελάχιστη έως καθόλου προσπάθεια. Συνήθως πρόκειται για διαχειρίσεις και back-ends.
4+
Η εμφάνιση των μορφών μπορεί να είναι πολύ διαφορετική. Στην πράξη, μπορούμε να συναντήσουμε δύο άκρα. Από τη μία πλευρά, υπάρχει η ανάγκη απόδοσης μιας σειράς φορμών σε μια εφαρμογή που είναι οπτικά παρόμοιες μεταξύ τους και εκτιμούμε την εύκολη απόδοση χωρίς πρότυπο με τη χρήση του `$form->render()`. Αυτή είναι συνήθως η περίπτωση των διοικητικών διεπαφών.
55

6-
Η άλλη πλευρά είναι οι μικροσκοπικές γλυκές φόρμες, κάθε μία από τις οποίες είναι ένα κομμάτι τέχνης. Η διάταξή τους μπορεί να γραφτεί καλύτερα σε HTML. Φυσικά, εκτός από αυτά τα άκρα, υπάρχουν πολλές φόρμες ακριβώς στο ενδιάμεσο.
6+
Από την άλλη πλευρά, υπάρχουν διάφορες φόρμες όπου η κάθε μία είναι μοναδική. Η εμφάνισή τους περιγράφεται καλύτερα με τη χρήση της γλώσσας HTML στο πρότυπο. Και φυσικά, εκτός από τα δύο προαναφερθέντα άκρα, θα συναντήσουμε πολλές φόρμες που βρίσκονται κάπου ενδιάμεσα.
77

88

9-
Latte .[#toc-latte]
10-
===================
9+
Απεικόνιση με Latte .[#toc-rendering-with-latte]
10+
================================================
1111

1212
Το [σύστημα προτύπων Latte |latte:] διευκολύνει ουσιαστικά την απόδοση των μορφών και των στοιχείων τους. Αρχικά, θα δείξουμε πώς να αποδίδουμε τις φόρμες χειροκίνητα, στοιχείο προς στοιχείο, για να αποκτήσουμε πλήρη έλεγχο του κώδικα. Αργότερα θα δείξουμε πώς να [αυτοματοποιήσουμε |#Automatic rendering] την εν λόγω απόδοση.
1313

@@ -152,6 +152,12 @@ protected function createComponentSignInForm(): Form
152152
```
153153

154154

155+
`{form}`
156+
--------
157+
158+
Ετικέτες `{form signInForm}...{/form}` είναι μια εναλλακτική λύση για `<form n:name="signInForm">...</form>`.
159+
160+
155161
Αυτόματη απόδοση .[#toc-automatic-rendering]
156162
--------------------------------------------
157163

@@ -256,8 +262,8 @@ protected function createComponentSignInForm(): Form
256262
```
257263

258264

259-
Χωρίς Latte .[#toc-without-latte]
260-
=================================
265+
Εκτέλεση χωρίς Latte .[#toc-rendering-without-latte]
266+
====================================================
261267

262268
Ο ευκολότερος τρόπος για να αποδώσετε μια φόρμα είναι να καλέσετε:
263269

@@ -321,13 +327,13 @@ Renderer .[#toc-renderer]
321327
<tr class="required">
322328
<th><label class="required" for="frm-name">Name:</label></th>
323329

324-
<td><input type="text" class="text" name="name" id="frm-name" value=""></td>
330+
<td><input type="text" class="text" name="name" id="frm-name" required value=""></td>
325331
</tr>
326332

327333
<tr class="required">
328334
<th><label class="required" for="frm-age">Age:</label></th>
329335

330-
<td><input type="text" class="text" name="age" id="frm-age" value=""></td>
336+
<td><input type="text" class="text" name="age" id="frm-age" required value=""></td>
331337
</tr>
332338

333339
<tr>
@@ -357,12 +363,12 @@ $form->render();
357363
<dl>
358364
<dt><label class="required" for="frm-name">Name:</label></dt>
359365

360-
<dd><input type="text" class="text" name="name" id="frm-name" value=""></dd>
366+
<dd><input type="text" class="text" name="name" id="frm-name" required value=""></dd>
361367

362368

363369
<dt><label class="required" for="frm-age">Age:</label></dt>
364370

365-
<dd><input type="text" class="text" name="age" id="frm-age" value=""></dd>
371+
<dd><input type="text" class="text" name="age" id="frm-age" required value=""></dd>
366372

367373

368374
<dt><label>Gender:</label></dt>

forms/en/rendering.texy

Lines changed: 16 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
Forms Rendering
22
***************
33

4-
Forms' appearances can differ greatly. In fact, there are two extremes. One side is the need to render a set of very similar forms all over again, with little to none effort. Usually administrations and back-ends.
4+
The appearance of forms can be very diverse. In practice, we can encounter two extremes. On one hand, there is a need to render a series of forms in an application that are visually similar to each other, and we appreciate the easy rendering without a template using `$form->render()`. This is usually the case with administrative interfaces.
55

6-
The other side is tiny sweet forms, each one being a piece of art. Their layout can best be written in HTML. Of course, besides those extremes, there are many forms just in between.
6+
On the other hand, there are various forms where each one is unique. Their appearance is best described using HTML language in the template. And of course, in addition to both mentioned extremes, we will encounter many forms that fall somewhere in between.
77

88

9-
Latte
10-
=====
9+
Rendering With Latte
10+
====================
1111

1212
The [Latte templating system|latte:] fundamentally facilitates the rendering of forms and their elements. First, we'll show how to render forms manually, element by element, to gain full control over the code. Later we will show how to [automate |#Automatic rendering] such rendering.
1313

@@ -152,6 +152,12 @@ We can detect the presence of an error using the `hasErrors()` method and set th
152152
```
153153

154154

155+
`{form}`
156+
--------
157+
158+
Tags `{form signInForm}...{/form}` are an alternative to `<form n:name="signInForm">...</form>`.
159+
160+
155161
Automatic Rendering
156162
-------------------
157163

@@ -256,8 +262,8 @@ Tag `formContainer` helps with rendering of inputs inside a form container.
256262
```
257263

258264

259-
Without Latte
260-
=============
265+
Rendering Without Latte
266+
=======================
261267

262268
The easiest way to render a form is to call:
263269

@@ -321,13 +327,13 @@ If we don't set a custom renderer, the default renderer [api:Nette\Forms\Renderi
321327
<tr class="required">
322328
<th><label class="required" for="frm-name">Name:</label></th>
323329

324-
<td><input type="text" class="text" name="name" id="frm-name" value=""></td>
330+
<td><input type="text" class="text" name="name" id="frm-name" required value=""></td>
325331
</tr>
326332

327333
<tr class="required">
328334
<th><label class="required" for="frm-age">Age:</label></th>
329335

330-
<td><input type="text" class="text" name="age" id="frm-age" value=""></td>
336+
<td><input type="text" class="text" name="age" id="frm-age" required value=""></td>
331337
</tr>
332338

333339
<tr>
@@ -357,12 +363,12 @@ Results into the following snippet:
357363
<dl>
358364
<dt><label class="required" for="frm-name">Name:</label></dt>
359365

360-
<dd><input type="text" class="text" name="name" id="frm-name" value=""></dd>
366+
<dd><input type="text" class="text" name="name" id="frm-name" required value=""></dd>
361367

362368

363369
<dt><label class="required" for="frm-age">Age:</label></dt>
364370

365-
<dd><input type="text" class="text" name="age" id="frm-age" value=""></dd>
371+
<dd><input type="text" class="text" name="age" id="frm-age" required value=""></dd>
366372

367373

368374
<dt><label>Gender:</label></dt>

0 commit comments

Comments
 (0)