Skip to content

Commit 3fa7515

Browse files
dgdg
committed
Forms: added missing parameters
1 parent ca00a67 commit 3fa7515

16 files changed

+384
-384
lines changed

‎forms/bg/controls.texy

+24-24
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,8 @@
55
Преглед на вградените контроли на формуляра.
66

77

8-
addText(string|int $name, $label=null): TextInput .[method]
9-
===========================================================
8+
addText(string|int $name, $label=null, $cols, ?int $maxLength=null): TextInput .[method]
9+
========================================================================================
1010

1111
Добавя текстово поле с един ред (клас [TextInput |api:Nette\Forms\Controls\TextInput]). Ако потребителят не попълни полето, се връща празен низ `''`, или използвайте `setNullable()`, за да върнете `null`.
1212

@@ -78,8 +78,8 @@ $form->addFloat('level', 'Level:')
7878
Nette и браузърът Chrome приемат както запетая, така и точка като десетични разделители. За да направите тази функционалност достъпна във Firefox, се препоръчва да зададете атрибута `lang` или за конкретния елемент, или за цялата страница, например, `<html lang="cs">`.
7979

8080

81-
addEmail(string|int $name, $label=null): TextInput .[method]
82-
============================================================
81+
addEmail(string|int $name, $label=null, int $maxLength=255): TextInput .[method]
82+
================================================================================
8383

8484
Добавя валидирано поле за имейл адрес (клас [TextInput |api:Nette\Forms\Controls\TextInput]). Ако потребителят не е попълнил полето, се връща празен низ `''` или използвайте `setNullable()`, за да върнете `null`.
8585

@@ -92,8 +92,8 @@ $form->addEmail('email', 'Имейл:');
9292
Максималната дължина може да бъде ограничена с помощта на `setMaxLength()`. Функцията [addFilter() |validation#Modifying-Input-Values] ви позволява да промените стойността, въведена от потребителя. Можете да зададете така наречената "празна стойност", като използвате `setEmptyValue()`.
9393

9494

95-
addPassword(string|int $name, $label=null): TextInput .[method]
96-
===============================================================
95+
addPassword(string|int $name, $label=null, $cols, ?int $maxLength=null): TextInput .[method]
96+
============================================================================================
9797

9898
Добавя поле за парола (клас [TextInput |api:Nette\Forms\Controls\TextInput]).
9999

@@ -118,8 +118,8 @@ $form->addCheckbox('agree', 'Я согласен с условиями')
118118
```
119119

120120

121-
addCheckboxList(string|int $name, $label=null, array $items=null): CheckboxList .[method]
122-
=========================================================================================
121+
addCheckboxList(string|int $name, $label=null, ?array $items=null): CheckboxList .[method]
122+
==========================================================================================
123123

124124
Добавя списък с квадратчета за избор на няколко елемента (клас [CheckboxList |api:Nette\Forms\Controls\CheckboxList]). Връща масив от ключове на избрани елементи. Методът `getSelectedItems()` връща стойности вместо ключове.
125125

@@ -146,8 +146,8 @@ $form->setHtmlAttribute('data-nette-compact');
146146
```
147147

148148

149-
addRadioList(string|int $name, $label=null, array $items=null): RadioList .[method]
150-
===================================================================================
149+
addRadioList(string|int $name, $label=null, ?array $items=null): RadioList .[method]
150+
====================================================================================
151151

152152
Добавя радио бутони (клас [RadioList |api:Nette\Forms\Controls\RadioList]). Връща ключа на избрания елемент или `null`, ако потребителят не е избрал нищо. Методът `getSelectedItem()` връща стойност вместо ключ.
153153

@@ -168,8 +168,8 @@ $form->addRadioList('gender', 'Пол:', $sex);
168168
При настройката по подразбиране се проверява дали това е един от предлаганите елементи, в противен случай се подава изключение. Тази проверка може да бъде деактивирана с помощта на `checkDefaultValue(false)`.
169169

170170

171-
addSelect(string|int $name, $label=null, array $items=null): SelectBox .[method]
172-
================================================================================
171+
addSelect(string|int $name, $label=null, ?array $items=null, ?int $size=null): SelectBox .[method]
172+
==================================================================================================
173173

174174
Добавя поле за избор (клас [SelectBox |api:Nette\Forms\Controls\SelectBox]). Връща ключа на избрания елемент или `null`, ако потребителят не е избрал нищо. Методът `getSelectedItem()` връща стойност вместо ключ.
175175

@@ -213,8 +213,8 @@ $form->addSelect('country', 'Страна:', $countries)
213213
При настройката по подразбиране се проверява дали това е един от предлаганите елементи, в противен случай се подава изключение. Тази проверка може да бъде деактивирана с помощта на `checkDefaultValue(false)`.
214214

215215

216-
addMultiSelect(string|int $name, $label=null, array $items=null): MultiSelectBox .[method]
217-
==========================================================================================
216+
addMultiSelect(string|int $name, $label=null, ?array $items=null, ?int $size=null): MultiSelectBox .[method]
217+
============================================================================================================
218218

219219
Добавя поле за множествен избор (клас [MultiSelectBox |api:Nette\Forms\Controls\MultiSelectBox]). Връща масив от ключове на избрани елементи. Методът `getSelectedItems()` връща стойности вместо ключове.
220220

@@ -287,8 +287,8 @@ $form->addDate('date', 'Date:')
287287
```
288288

289289

290-
addTime(string|int $name, $label=null, bool $withSeconds = false): DateTimeControl .[method]{data-version:3.1.14}
291-
=================================================================================================================
290+
addTime(string|int $name, $label=null, bool $withSeconds=false): DateTimeControl .[method]{data-version:3.1.14}
291+
===============================================================================================================
292292

293293
Добавя поле, което позволява на потребителя лесно да въвежда време, състоящо се от часове, минути и по избор секунди (клас [DateTimeControl |api:Nette\Forms\Controls\DateTimeControl]).
294294

@@ -307,8 +307,8 @@ $form->addTime('time', 'Time:')
307307
```
308308

309309

310-
addDateTime(string|int $name, $label=null, bool $withSeconds = false): DateTimeControl .[method]{data-version:3.1.14}
311-
=====================================================================================================================
310+
addDateTime(string|int $name, $label=null, bool $withSeconds=false): DateTimeControl .[method]{data-version:3.1.14}
311+
===================================================================================================================
312312

313313
Добавя поле, което позволява на потребителя лесно да въвежда както дата, така и час, състоящи се от година, месец, ден, часове, минути и по желание секунди (клас [DateTimeControl |api:Nette\Forms\Controls\DateTimeControl]).
314314

@@ -339,8 +339,8 @@ $form->addColor('color', 'Color:')
339339
```
340340

341341

342-
addHidden(string|int $name, string $default=null): HiddenField .[method]
343-
========================================================================
342+
addHidden(string|int $name, ?string $default=null): HiddenField .[method]
343+
=========================================================================
344344

345345
Добавя скрито поле (клас [HiddenField |api:Nette\Forms\Controls\HiddenField]).
346346

@@ -391,8 +391,8 @@ $form->addButton('raise', 'Поднять зарплату')
391391
```
392392

393393

394-
addImageButton(string|int $name, string $src=null, string $alt=null): ImageButton .[method]
395-
===========================================================================================
394+
addImageButton(string|int $name, ?string $src=null, ?string $alt=null): ImageButton .[method]
395+
=============================================================================================
396396

397397
Добавя бутон за изпращане като изображение (клас [ImageButton |api:Nette\Forms\Controls\ImageButton]).
398398

@@ -525,8 +525,8 @@ $form->addComponent(new DateInput('Дата:'), 'date');
525525
```php
526526
use Nette\Forms\Container;
527527

528-
// метод addZip(string $name, string $label = null)
529-
Container::extensionMethod('addZip', function (Container $form, string $name, string $label = null) {
528+
// метод addZip(string $name, ?string $label = null)
529+
Container::extensionMethod('addZip', function (Container $form, string $name, ?string $label = null) {
530530
return $form->addText($name, $label)
531531
->addRule($form::Pattern, 'Не менее 5 номеров', '[0-9]{5}');
532532
});

‎forms/cs/controls.texy

+24-24
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,8 @@ Formulářové prvky
55
Přehled standardních formulářových prvků.
66

77

8-
addText(string|int $name, $label=null): TextInput .[method]
9-
===========================================================
8+
addText(string|int $name, $label=null, $cols, ?int $maxLength=null): TextInput .[method]
9+
========================================================================================
1010

1111
Přidá jednořádkové textové políčko (třída [TextInput |api:Nette\Forms\Controls\TextInput]). Pokud uživatel pole nevyplní, vrací prázdný řetězec `''`, nebo pomocí `setNullable()` lze určit, aby vracel `null`.
1212

@@ -78,8 +78,8 @@ Prvek se vykresluje jako `<input type="numeric">`. Použitím metody `setHtmlTyp
7878
Nette a prohlížeč Chrome akceptují jako oddělovač desetinných míst jak čárku, tak tečku. Aby byla tato funkcionalita dostupná i ve Firefoxu, je doporučeno nastavit atribut `lang` buď pro daný prvek nebo pro celou stránku, například `<html lang="cs">`.
7979

8080

81-
addEmail(string|int $name, $label=null): TextInput .[method]
82-
============================================================
81+
addEmail(string|int $name, $label=null, int $maxLength=255): TextInput .[method]
82+
================================================================================
8383

8484
Přidá políčko pro zadání e-mailové adresy (třída [TextInput |api:Nette\Forms\Controls\TextInput]). Pokud uživatel pole nevyplní, vrací prázdný řetězec `''`, nebo pomocí `setNullable()` lze určit, aby vracel `null`.
8585

@@ -92,8 +92,8 @@ Ověří, zda je hodnota platná e-mailová adresa. Neověřuje se, zda doména
9292
Maximální délku lze omezit pomocí `setMaxLength()`. Pozměnit uživatelem vloženou hodnotu umožňuje [addFilter()|validation#Úprava vstupu]. Lze nastavit tzv. empty-value pomocí `setEmptyValue()`.
9393

9494

95-
addPassword(string|int $name, $label=null): TextInput .[method]
96-
===============================================================
95+
addPassword(string|int $name, $label=null, $cols, ?int $maxLength=null): TextInput .[method]
96+
============================================================================================
9797

9898
Přidá políčko pro zadání hesla (třída [TextInput |api:Nette\Forms\Controls\TextInput]).
9999

@@ -118,8 +118,8 @@ $form->addCheckbox('agree', 'Souhlasím s podmínkami')
118118
```
119119

120120

121-
addCheckboxList(string|int $name, $label=null, array $items=null): CheckboxList .[method]
122-
=========================================================================================
121+
addCheckboxList(string|int $name, $label=null, ?array $items=null): CheckboxList .[method]
122+
==========================================================================================
123123

124124
Přidá zaškrtávací políčka pro výběr více položek (třída [CheckboxList |api:Nette\Forms\Controls\CheckboxList]). Vrací pole klíčů vybraných položek. Metoda `getSelectedItems()` vrací hodnoty místo klíčů.
125125

@@ -146,8 +146,8 @@ $form->setHtmlAttribute('data-nette-compact');
146146
```
147147

148148

149-
addRadioList(string|int $name, $label=null, array $items=null): RadioList .[method]
150-
===================================================================================
149+
addRadioList(string|int $name, $label=null, ?array $items=null): RadioList .[method]
150+
====================================================================================
151151

152152
Přidá přepínací tlačítka (třída [RadioList |api:Nette\Forms\Controls\RadioList]). Vrací klíč vybrané položky, nebo `null`, pokud uživatel nic nevybral. Metoda `getSelectedItem()` vrací hodnotu místo klíče.
153153

@@ -168,8 +168,8 @@ Prvek automaticky kontroluje, že nedošlo k podvržení a že vybraná položka
168168
Při nastavení výchozí vybrané položky také kontroluje, že jde o jednou z nabízených, jinak vyhodí výjimku. Tuto kontrolu lze vypnout pomocí `checkDefaultValue(false)`.
169169

170170

171-
addSelect(string|int $name, $label=null, array $items=null): SelectBox .[method]
172-
================================================================================
171+
addSelect(string|int $name, $label=null, ?array $items=null, ?int $size=null): SelectBox .[method]
172+
==================================================================================================
173173

174174
Přidá select box (třída [SelectBox |api:Nette\Forms\Controls\SelectBox]). Vrací klíč vybrané položky, nebo `null`, pokud uživatel nic nevybral. Metoda `getSelectedItem()` vrací hodnotu místo klíče.
175175

@@ -213,8 +213,8 @@ Prvek automaticky kontroluje, že nedošlo k podvržení a že vybraná položka
213213
Při nastavení výchozí vybrané položky také kontroluje, že jde o jednou z nabízených, jinak vyhodí výjimku. Tuto kontrolu lze vypnout pomocí `checkDefaultValue(false)`.
214214

215215

216-
addMultiSelect(string|int $name, $label=null, array $items=null): MultiSelectBox .[method]
217-
==========================================================================================
216+
addMultiSelect(string|int $name, $label=null, ?array $items=null, ?int $size=null): MultiSelectBox .[method]
217+
============================================================================================================
218218

219219
Přidá select box pro výběr více položek (třída [MultiSelectBox |api:Nette\Forms\Controls\MultiSelectBox]). Vrací pole klíčů vybraných položek. Metoda `getSelectedItems()` vrací hodnoty místo klíčů.
220220

@@ -287,8 +287,8 @@ $form->addDate('date', 'Datum:')
287287
```
288288

289289

290-
addTime(string|int $name, $label=null, bool $withSeconds = false): DateTimeControl .[method]{data-version:3.1.14}
291-
=================================================================================================================
290+
addTime(string|int $name, $label=null, bool $withSeconds=false): DateTimeControl .[method]{data-version:3.1.14}
291+
===============================================================================================================
292292

293293
Přidá políčko, které umožní uživateli snadno zadat čas skládající se z hodin, minut a volitelně i sekund (třída [DateTimeControl |api:Nette\Forms\Controls\DateTimeControl]).
294294

@@ -307,8 +307,8 @@ $form->addTime('time', 'Čas:')
307307
```
308308

309309

310-
addDateTime(string|int $name, $label=null, bool $withSeconds = false): DateTimeControl .[method]{data-version:3.1.14}
311-
=====================================================================================================================
310+
addDateTime(string|int $name, $label=null, bool $withSeconds=false): DateTimeControl .[method]{data-version:3.1.14}
311+
===================================================================================================================
312312

313313
Přidá políčko, které umožní uživateli snadno zadat datum a čas skládající se z roku, měsíce, dne, hodin, minut a volitelně i sekund (třída [DateTimeControl |api:Nette\Forms\Controls\DateTimeControl]).
314314

@@ -339,8 +339,8 @@ $form->addColor('color', 'Barva:')
339339
```
340340

341341

342-
addHidden(string|int $name, string $default=null): HiddenField .[method]
343-
========================================================================
342+
addHidden(string|int $name, ?string $default=null): HiddenField .[method]
343+
=========================================================================
344344

345345
Přidá skryté pole (třída [HiddenField |api:Nette\Forms\Controls\HiddenField]).
346346

@@ -391,8 +391,8 @@ $form->addButton('raise', 'Zvýšit plat')
391391
```
392392

393393

394-
addImageButton(string|int $name, string $src=null, string $alt=null): ImageButton .[method]
395-
===========================================================================================
394+
addImageButton(string|int $name, ?string $src=null, ?string $alt=null): ImageButton .[method]
395+
=============================================================================================
396396

397397
Přidá odesílací tlačítko v podobě obrázku (třída [ImageButton |api:Nette\Forms\Controls\ImageButton]).
398398

@@ -525,8 +525,8 @@ Existuje způsob, jak definovat nové metody formuláře sloužící k přidáv
525525
```php
526526
use Nette\Forms\Container;
527527

528-
// přidáme metodu addZip(string $name, string $label = null)
529-
Container::extensionMethod('addZip', function (Container $form, string $name, string $label = null) {
528+
// přidáme metodu addZip(string $name, ?string $label = null)
529+
Container::extensionMethod('addZip', function (Container $form, string $name, ?string $label = null) {
530530
return $form->addText($name, $label)
531531
->addRule($form::Pattern, 'Alespoň 5 čísel', '[0-9]{5}');
532532
});

0 commit comments

Comments
 (0)