| | 285 | |
| | 286 | == Klasa TextInput == |
| | 287 | {{{ |
| | 288 | /** Konstruktor |
| | 289 | * Nadaje wartość domyślną, przywraca wartość ze schowka, przechwytuje wartość |
| | 290 | * formularza HTML. Na żądanie waliduje czy pole puste. |
| | 291 | * @param $name nazwa tagu INPUT |
| | 292 | * @param $defaultValue domyślna wartość pola |
| | 293 | * @param $mandatory flaga kontroli obowiązkowego wypełnienia |
| | 294 | */ |
| | 295 | function TextInput($name, $defaultValue = NULL, $mandatory = FALSE, $maxLength = NULL, $password = FALSE); |
| | 296 | |
| | 297 | /** Set placeholder */ |
| | 298 | public function setPlaceholder($text) ; |
| | 299 | |
| | 300 | /** Ustawia maksymalną długość treści pola */ |
| | 301 | function setMaxLength($maxLength); |
| | 302 | |
| | 303 | /** Ustawia walidator z warunkiem niepustości */ |
| | 304 | function makeMandatory(); |
| | 305 | |
| | 306 | /** Pokazuje element HTML */ |
| | 307 | function show(); |
| | 308 | |
| | 309 | /** Ukrywa element HTML */ |
| | 310 | function hide(); |
| | 311 | |
| | 312 | /** Zwraca stan widoczności elementu HTML */ |
| | 313 | function isVisible(); |
| | 314 | |
| | 315 | /** Ustawia tryb tylko do odczytu elementu HTML |
| | 316 | * przywrocone by tswienty potrzebne do disablowania formularzy |
| | 317 | * @param $ro flaga read-only |
| | 318 | */ |
| | 319 | function setReadOnly($ro); |
| | 320 | |
| | 321 | /** Ustawia element HTML do zapisu */ |
| | 322 | function enable(); |
| | 323 | |
| | 324 | /** Ustawia element HTML tylko do odczytu */ |
| | 325 | function disable(); |
| | 326 | |
| | 327 | /** Zwraca stan ustawienia do zapisu |
| | 328 | * @return boolean dostępny do zapisu |
| | 329 | */ |
| | 330 | function isEnabled(); |
| | 331 | |
| | 332 | /** Zapamiętuje stan elementu */ |
| | 333 | function store(); |
| | 334 | |
| | 335 | /** Przywraca stan elementu */ |
| | 336 | function restore(); |
| | 337 | |
| | 338 | /** Ustawia wartość pola tagu |
| | 339 | * @param $v wartość pola |
| | 340 | */ |
| | 341 | function setValue($v); |
| | 342 | |
| | 343 | /** Zwraca zawartość pola tagu */ |
| | 344 | function getValue(); |
| | 345 | |
| | 346 | /** Czyści wartość pola tagu i ustawia flagę wyczyszczenia */ |
| | 347 | function reset(); |
| | 348 | |
| | 349 | /** Clear */ |
| | 350 | function clear(); |
| | 351 | |
| | 352 | /** Ustawia klasę i styl CSS tagu HTML |
| | 353 | * @param $class string, klasa CSS |
| | 354 | * @param $style string, styl inline CSS |
| | 355 | */ |
| | 356 | function setCSSFormatting($class = NULL, $style = NULL); |
| | 357 | |
| | 358 | /** Ustawia parametry formatujące tag HTML |
| | 359 | * Przykład: <code>setHtmlFormatting('width', '100%')</code> |
| | 360 | * @param $k klucz tagu |
| | 361 | * @param $v wartość klucza |
| | 362 | */ |
| | 363 | function setHtmlFormatting($k, $v); |
| | 364 | |
| | 365 | /** Zwraca string formatujący tag HTML */ |
| | 366 | function getHtmlFormatting(); |
| | 367 | |
| | 368 | /** Ustawia fokus na elemencie, gdy user przesunie nad nim wskaźnik myszy |
| | 369 | * @since 0.21.5 |
| | 370 | */ |
| | 371 | function setHoverFocus(); |
| | 372 | |
| | 373 | /** Ustawia element, który będzie kliknięty po naciśnięciu Enter |
| | 374 | * @since 0.21.5 |
| | 375 | */ |
| | 376 | function setAutoSubmit($buttonName); |
| | 377 | |
| | 378 | /** Ustawia warunek walidacji |
| | 379 | * @param $regExp wyrażenie regularne walidujące |
| | 380 | * @param $errorMsg komunikat błędu, domyślnie symbol wykrzyknika |
| | 381 | */ |
| | 382 | function setValidator($regExp, $errorMsg); |
| | 383 | |
| | 384 | /** Waliduje |
| | 385 | * @return boolean, wynik walidacji |
| | 386 | */ |
| | 387 | function isRequestValid(); |
| | 388 | |
| | 389 | /** Zwraca komunikat walidatora */ |
| | 390 | function getErrorMessage(); |
| | 391 | |
| | 392 | /** Ustawia komunikat błędu |
| | 393 | * @param $errorMessage komunikat z błędem, domyślnie błąd z walidatora |
| | 394 | * @since 0.21.4 |
| | 395 | */ |
| | 396 | function setErrorMessage($errorMessage = TRUE); |
| | 397 | |
| | 398 | /** Usuwa komunikat błędu |
| | 399 | * @since 0.21.4 |
| | 400 | */ |
| | 401 | function clearErrorMessage(); |
| | 402 | |
| | 403 | /** Get name */ |
| | 404 | function getName(); |
| | 405 | |
| | 406 | /** Serializuje do HTML */ |
| | 407 | function onEnterGoTo($domElement); |
| | 408 | |
| | 409 | /** To HTML */ |
| | 410 | function toHtml(); |
| | 411 | |
| | 412 | }}} |