flexideo

Metody v Object

Metody umístěné ve jmenném prostoru Object.


Metoda add

Vytvoří nový podřízený element a vloží ho na požadovanou pozici.

Pouze typ objektu element.

typ: method; celé jméno: COMEX.HTML.Object.add;


Parametry:

$node

● hodnota typu String

název tagu nového elementu

● hodnota typu Element

vkládaný element

$before

● hodnota typu Element (výchozí: null)

element, před který má být element vložen

● hodnota typu null (výchozí: null)

null znamená na konec


Vrací:

vytvořený a vložený element

example
var $rslt = "<button onclick=\"o$(this).sup.add('button').val(COMEX.Time.stamp)\">click</button>";

( umístěno v souboru /comex/scripts/comex.js )


Metoda attr

Vrátí hodnotu atributu a pokud je předána hodnota, nastaví jej na tuto hodnotu.

Pouze typ objektu window, document, element.

typ: method; celé jméno: COMEX.HTML.Object.attr;


Parametry:

$attribute

● hodnota typu String

název atributu

$value

● hodnota typu String (výchozí: undefined)

hodnota atributu

● hodnota typu null (výchozí: undefined)

pokud je hodnota nastavena na null, je atribut odstraněn


Vrací:

hodnota atributu

null, pokud atribut neexistuje

example
var $rslt = "<textarea onclick=\"o$(this).attr('data-demo', new Date());this.value = this.attr('data-demo');\"></textarea>";

( umístěno v souboru /comex/scripts/comex.js )


Metoda code

Vrátí HTML kód elementu a pokud je předána hodnota, přepíše jeho kód na tuto hodnotu.

Pouze typ objektu element.

typ: method; celé jméno: COMEX.HTML.Object.code;


Parametry:

$code

● hodnota typu String (výchozí: undefined)

nový HTML kód


Vrací:

vnější HTML kód elementu

example
var $rslt = "<button ondblclick=\"o$(this).code(this.code()+this.code());\">dblclick</button>";

( umístěno v souboru /comex/scripts/comex.js )


Metoda create

Vytvoří nový element.

fragment - fragment dokumentu

text - textový nod

nazev_tagu - element dle specifikovaného názvu tagu

Pouze typ objektu window, document, element.

typ: method; celé jméno: COMEX.HTML.Object.create;


Parametry:

$tag

● hodnota typu String

název tagu


Vrací:

nový element

example
var $rslt = "<button onclick=\"var $i = o$(this).create('button').val(COMEX.Time.stamp);this.sup.insertBefore($i,null)\">click</button>";

( umístěno v souboru /comex/scripts/comex.js )


Metoda csc

Vrátí CSS třídu a pokud je předána hodnota, nastaví ji na tuto hodnotu.

Pouze typ objektu element.

typ: method; celé jméno: COMEX.HTML.Object.csc;


Parametry:

$class

● hodnota typu String (výchozí: undefined)

CSS třída/y

$action

● hodnota typu extended Boolean (výchozí: null)

akce (true = přidat, false = odebrat, null = nastavit)

$space

● hodnota typu Boolean (výchozí: true)

true, pokud má být třída přidána / odebrána i s mezerou, jinak false


Vrací:

CSS třída

example
var $rslt = "<textarea onkeyup=\"o$(this).csc('opaque' + Math.max(1, 10 - this.value.length));\"></textarea>";

( umístěno v souboru /comex/scripts/comex.js )


Metoda css

Vrátí hodnotu vlastnosti stylu a pokud je předána hodnota, nastaví ji na tuto hodnotu.

Pouze typ objektu element.

typ: method; celé jméno: COMEX.HTML.Object.css;


Parametry:

$property

● hodnota typu String

název vlastnosti stylu

$value

● hodnota typu String (výchozí: undefined)

hodnota vlastnosti stylu

● hodnota typu null (výchozí: undefined)

pokud je hodnota nastavena na null, je vlastnost odstraněna


Vrací:

hodnota vlastnosti stylu

null, pokud vlastnost neexistuje

example
var $rslt = "<textarea onkeyup=\"o$(this).css('outline-color', 'rgb(' + COMEX.rand(0, 255) + ',' + COMEX.rand(0, 255) + ',' + COMEX.rand(0, 255) + ')');\"></textarea>";

( umístěno v souboru /comex/scripts/comex.js )


Metoda enabled

Vrátí příznak, zda je objekt aktivní a pokud je předána hodnota, nastaví příznak na tuto hodnotu.

Pouze typ objektu element.

typ: method; celé jméno: COMEX.HTML.Object.enabled;


Parametry:

$enable

● hodnota typu Boolean (výchozí: undefined)

true, pokud má být objekt aktivní, jinak false


Vrací:

true, pokud je objekt aktivní, jinak false

example
var $rslt = "<textarea></textarea><button onclick=\"var $e = o$(this).prev.enabled();o$(this).prev.enabled(!$e);o$(this).prev.val(!$e)\">enable / disable</button>";

( umístěno v souboru /comex/scripts/comex.js )


Metoda hide

Skryje element.

Pouze typ objektu element.

typ: method; celé jméno: COMEX.HTML.Object.hide;


Vrací:

bez návratové hodnoty

example
var $rslt = "<textarea onblur=\"o$(this).show();\" onfocus=\"o$(this).hide();\"></textarea>";

( umístěno v souboru /comex/scripts/comex.js )


Metoda inert

Zamezí výběru textu a obrázků z elementu.

Pouze typ objektu element.

typ: method; celé jméno: COMEX.HTML.Object.inert;


Vrací:

bez návratové hodnoty

example
var $rslt = "<textarea onfocus=\"o$(this).inert();\"></textarea>";

( umístěno v souboru /comex/scripts/comex.js )


Metoda node

Vrátí přímo podřízený element.

Pouze typ objektu element.

typ: method; celé jméno: COMEX.HTML.Object.node;


Možné výjimky:

COMEX.Exceptions.MismatchException


Parametry:

$index

● hodnota typu Integer (výchozí: 0)

pořadí elementu (počítá se od 0, záporný index počítá od konce)

$elements

● hodnota typu Boolean (výchozí: true)

true, pokud má být vybrán pouze element, jinak false


Vrací:

podřízený element

null, pokud neexistuje

example 
var $rslt = [];
$rslt.push(document.tag("html").node(0).nodeName);
$rslt.push(document.tag("html").node(-1).nodeName);
$rslt.push(document.tag("html").node(99));

( umístěno v souboru /comex/scripts/comex.js )


Metoda nodes

Vrátí pole přímo podřízených elementů.

Pouze typ objektu element.

typ: method; celé jméno: COMEX.HTML.Object.nodes;


Možné výjimky:

COMEX.Exceptions.MismatchException


Parametry:

$elements

● hodnota typu Boolean (výchozí: true)

true, pokud mají být vybrány pouze elementy, jinak false


Vrací:

pole podřízených elementů

example
var $rslt = document.tag("head").nodes().length;

( umístěno v souboru /comex/scripts/comex.js )


Metoda on

Vrátí posluchače události a případně přiřadí posluchači předaný handler.

Pouze typ objektu window, document, element.

U objektu typu document je možné použít speciální událost:

ready - událost je vyvolána po dokončení načítání dokumentu.

U objektu typu element je možné použít speciální události:

insert - událost je vyvolána po vložení elementu do DOMu.

remove - událost je vyvolána po odstranění elementu z DOMu.

show - událost je vyvolána po zavolání metody show.

hide - událost je vyvolána po zavolání metody hide.

typ: method; celé jméno: COMEX.HTML.Object.on;


Parametry:

$type

● hodnota typu String

typ události (click, keyup, mouseout, ...)

$function

● hodnota typu Function (výchozí: undefined)

handler volané funkce

$id

● hodnota typu String (výchozí: undefined)

id, pod kterým je posluchač registrovaný

$priority

● hodnota typu Integer (výchozí: undefined)

priorita spouštění handlerů


Vrací:

posluchač události

example
var $rslt = "<textarea onfocus=\"o$(this).on('keyup', function($event){$event.source.css('color', 'rgb(' + COMEX.rand(0, 255) + ',' + COMEX.rand(0, 255) + ',' + COMEX.rand(0, 255) + ')');})\"></textarea>";

( umístěno v souboru /comex/scripts/comex.js )


Metoda query

Vrátí pole unifikovaných COMEX objektů na základě dotazu.

Pouze typ objektu window, document, element.

typ: method; celé jméno: COMEX.HTML.Object.query;


Parametry:

$query

● hodnota typu String

strukturovaný dotaz dle selektorů CSS (pro MSIE 8 pouze do verze 2.1)


Vrací:

pole unifikovaných objektů

example 
var $rslt = [];
$rslt['table'] = document.query('table').length;
$rslt['table>tr>td'] = document.query('table>tr>td').length;
$rslt['table tr>td'] = document.query('table tr>td').length;
$rslt['h2'] = document.query('h2').length;
$rslt['h3'] = document.query('h3').length;
$rslt['h2, h3'] = document.query('h2, h3').length;
$rslt['div[id]'] = document.query('div[id]').length;

( umístěno v souboru /comex/scripts/comex.js )


Metoda redraw

Překreslí element.

Pouze typ objektu element.

typ: method; celé jméno: COMEX.HTML.Object.redraw;


Vrací:

bez návratové hodnoty

example
var $rslt = "<textarea onfocus=\"o$(this).redraw();\"></textarea>";

( umístěno v souboru /comex/scripts/comex.js )


Metoda rem

Odstraní objekt.

Všechny typy objektů kromě window a document.

typ: method; celé jméno: COMEX.HTML.Object.rem;


Vrací:

bez návratové hodnoty

example
var $rslt = "<textarea ondblclick=\"o$(this).rem();\"></textarea>";

( umístěno v souboru /comex/scripts/comex.js )


Metoda show

Zobrazí element.

Pouze typ objektu element.

typ: method; celé jméno: COMEX.HTML.Object.show;


Parametry:

$display

● hodnota typu String (výchozí: 'block')

jak má být element zobrazen


Vrací:

bez návratové hodnoty

example
var $rslt = "<textarea onblur=\"o$(this).show();\" onfocus=\"o$(this).hide();\"></textarea>";

( umístěno v souboru /comex/scripts/comex.js )


Metoda squery

Vrátí unifikovaný COMEX objekt 1. odpovídajícího elementu na základě dotazu.

Pouze typ objektu window, document, element.

typ: method; celé jméno: COMEX.HTML.Object.squery;


Parametry:

$query

● hodnota typu String

strukturovaný dotaz dle selektorů CSS (pro MSIE 8 pouze do verze 2.1)


Vrací:

unifikovaný objekt 1. odpovídajícího elementu

null, pokud nebyl nalezen

( umístěno v souboru /comex/scripts/comex.js )


Metoda tag

Vrátí podřízený element podle tagu.

Pouze typ objektu window, document, element.

typ: method; celé jméno: COMEX.HTML.Object.tag;


Možné výjimky:

COMEX.Exceptions.MismatchException


Parametry:

$tag

● hodnota typu String

tag

$index

● hodnota typu Integer (výchozí: 0)

pořadí elementu (počítá se od 0, záporný index počítá od konce)


Vrací:

podřízený element

null, pokud neexistuje

example
var $rslt = document.tag("a", -2);

( umístěno v souboru /comex/scripts/comex.js )


Metoda tags

Vrátí pole podřízených elementů podle tagu.

Pouze typ objektu window, document, element.

typ: method; celé jméno: COMEX.HTML.Object.tags;


Parametry:

$tag

● hodnota typu String

tag


Vrací:

pole podřízených elementů

example
var $rslt = document.tags("a").length;

( umístěno v souboru /comex/scripts/comex.js )


Metoda toString

Vrátí textovou reprezentaci objektu.

Pouze typ objektu element, text.

typ: method; celé jméno: COMEX.HTML.Object.toString;


Vrací:

textová reprezentace objektu

example
var $rslt = document.tag("a").toString().replace(/</g, "&amp;lt;");

( umístěno v souboru /comex/scripts/comex.js )


Metoda val

Vrátí obsah objektu a pokud je předána hodnota, nastaví jeho obsah na tuto hodnotu.

U textu a obecných elementů se pracuje s obsahem, u vstupních elementů s jejich vlastností value.

Pouze typ objektu element, text.

typ: method; celé jméno: COMEX.HTML.Object.val;


Parametry:

$value

● hodnota typu String (výchozí: undefined)

hodnota

$escape

● hodnota typu Boolean (výchozí: true)

true, pokud mají být v obsahu HTML elementu nahrazeny nebezpečné znaky, jinak false


Vrací:

obsah objektu

example
var $rslt = document.tag('a').val().replace(/</g, '&amp;lt;');

( umístěno v souboru /comex/scripts/comex.js )


Metoda view

Přenese element do viditelné části obrazovky.

Pouze typ objektu element.

typ: method; celé jméno: COMEX.HTML.Object.view;


Parametry:

$position

● hodnota typu extended Boolean (výchozí: null)

pozice (true = na vrchu obrazovky, null = uprostřed, false = dole)


Vrací:

bez návratové hodnoty

example
var $rslt = "<button onclick=\"o$(this).view(true);\">top</button><button onclick=\"o$(this).view();\">center</button><button onclick=\"o$(this).view(false);\">bottom</button>";

( umístěno v souboru /comex/scripts/comex.js )

Vlastnosti v ObjectMetody v Object