RSForm! Pro - omezení počtu znaků v textovém poli

Poměrně často jsem dotazován, jak jsem udělal omezení počtu použitých znaků v textovém poli včetně odpočtu zbývajících znaků ve formuláři na stránce kontaktu - přišel čas se o tuto techniku podělit, upozorňuji však, že to vyžaduje alespoň základní znalost práce s RSForm! - nemám čas to vysvětlovat polopaticky a blbuvzdorně :-)

Příprava

V první řadě je potřeba do vaší instalace RSForm! doplnit jeden javaskript soubor - ten jsem doplnil do poslední verze češtiny pro tuto komponentu, zároveň s češtinou si tak tedy do složky components/com_rsform nainstalujete i soubor limit.js - než přistoupíte k dalším krokům, doporučuji stáhnout a nainstalovat.

První kroky...

Otevřte si formulář, ve kterém chcete omezení provést a

1. klikněte na záložku Vlastnosti,
2. pak klikněte na záložku Skripty
3. a zde do pole Skript volaný při zobrazení formuláře vložte tento kód a uložte.

$doc = &JFactory::getDocument();
$doc->addScript('/components/com_rsform/limit.js');
JHTML::_('behavior.tooltip');

Nastavení textového pole...

4. Klikněte na záložku Prvky
5. a zde buď založte novou textovou plochu nebo klikněte na úpravu plochy, kterou již máte založenou,
6. zde na kartě atributy vložte do pole Další atributy
7. následující kód:

class="editlinktip hasTip" title="Zpráva::Zapište text zprávy,<br /> můžete použít max.<br />250 znaků."
on-KeyDown="limitText(this.form['form[zprava]'],this.form.countdown,250);" on-KeyUp="limitText(this.form['form[zprava]'],this.form.countdown,250);"

V kódu je několik proměnných, kterým je potřeba se věnovat:

1. title="Zpráva... - zde můžet uvést vlastní tip nápovědy - pozor na správný uvedený počet znaků.
2. form[zprava] - zprava je unikátní název prvku (viz karta Obecné dotčené textové plochy), u kterého chcete omezit počet znaků - zde musíte napsat ten váš název.
3. this.form.countdown,250 - číslice určuje počet znaků, na které bude obsah omezen.

Finále

8. Vraťte se na záložku Vlastnosti a zde klikněte na Rozvržení formuláře, do pole HTML rozvržení doplňte ke kódu dotčeného prvku následující kód:

<br />
<span>Zbývá napsat <input readonly id="chars" type="text" name="countdown" size="3" value="250"> znaků.</span>

Opět pozor na zápis, ať vám sedí počet znaků.

A to je asi tak všechno...