1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626 |
- /*
- * Copyright 2011, The gwtquery team.
- *
- * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
- * in compliance with the License. You may obtain a copy of the License at
- *
- * http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software distributed under the License
- * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
- * or implied. See the License for the specific language governing permissions and limitations under
- * the License.
- */
- package com.google.gwt.query.client;
-
- import com.google.gwt.dom.client.Element;
- import com.google.gwt.dom.client.NativeEvent;
- import com.google.gwt.dom.client.Node;
- import com.google.gwt.dom.client.NodeList;
- import com.google.gwt.query.client.GQuery.Offset;
- import com.google.gwt.query.client.css.HasCssValue;
- import com.google.gwt.query.client.css.TakesCssValue;
- import com.google.gwt.query.client.css.TakesCssValue.CssSetter;
- import com.google.gwt.query.client.js.JsNamedArray;
- import com.google.gwt.query.client.js.JsNodeArray;
- import com.google.gwt.query.client.plugins.Effects;
- import com.google.gwt.query.client.plugins.effects.PropertiesAnimation.Easing;
- import com.google.gwt.safehtml.shared.SafeHtml;
- import com.google.gwt.user.client.ui.Widget;
-
- import java.util.List;
-
- /**
- * LazyGQuery.
- * @param <T>
- */
- public interface LazyGQuery<T> extends LazyBase<T> {
-
- /**
- * Add elements to the set of matched elements if they are not included yet.
- *
- * It construct a new GQuery object and does not modify the original ones.
- *
- * It also update the selector appending the new one.
- */
- LazyGQuery<T> add(GQuery elementsToAdd);
-
- /**
- * Add elements to the set of matched elements if they are not included yet.
- */
- LazyGQuery<T> add(String selector);
-
- /**
- * Add the previous selection to the current selection. Useful for traversing elements, and then
- * adding something that was matched before the last traversal.
- */
- LazyGQuery<T> addBack();
-
- /**
- * Adds the specified classes to each matched element.
- */
- LazyGQuery<T> addClass(String... classes);
-
- /**
- * Insert content after each of the matched elements. The elements must already be inserted into
- * the document (you can't insert an element after another if it's not in the page).
- */
- LazyGQuery<T> after(GQuery query);
-
- /**
- * Insert content after each of the matched elements. The elements must already be inserted into
- * the document (you can't insert an element after another if it's not in the page).
- */
- LazyGQuery<T> after(Node n);
-
- /**
- * Insert content after each of the matched elements. The elements must already be inserted into
- * the document (you can't insert an element after another if it's not in the page).
- */
- LazyGQuery<T> after(String html);
-
- /**
- * Insert content after each of the matched elements. The elements must already be inserted into
- * the document (you can't insert an element after another if it's not in the page).
- */
- LazyGQuery<T> after(SafeHtml safeHtml);
-
- /**
- *
- * The animate() method allows you to create animation effects on any numeric HTML Attribute,
- * CSS property, or color CSS property.
- *
- * Concerning to numeric properties, values are treated as a number of pixels unless otherwise
- * specified. The units em and % can be specified where applicable.
- *
- * By default animate considers css properties, if you wanted to animate element attributes you
- * should to prepend the symbol dollar to the attribute name. It's useful to animate svg elements.
- *
- * NOTE: The ability of animating attribute values is only available in gquery but not jquery
- *
- * Example:
- *
- * <pre class="code">
- * // move the element from its original position to left:500px
- * $("#foo").animate("left:'500'");
- *
- * // Change the width html attribute of a table, note the symbol '$' to
- * // tell gquery which it is an html-attribute instead of a css-property.
- * $("table").animate("$width:'500'");
- * </pre>
- *
- * In addition to numeric values, each property can take the strings 'show', 'hide', and 'toggle'.
- * These shortcuts allow for custom hiding and showing animations that take into account the
- * display type of the element. Animated properties can also be relative. If a value is supplied
- * with a leading += or -= sequence of characters, then the target value is computed by adding or
- * subtracting the given number from the current value of the property.
- *
- * Example:
- *
- * <pre class="code">
- * // move the element from its original position to 500px to the left for 500ms and
- * // change the background color of the element at the end of the animation
- *
- * $("#foo").animate("left:'+=500'", new Function(){
- * public void f(Element e){
- * $(e).css(CSS.BACKGROUND_COLOR.with(RGBColor.RED);
- * }
- * });
- * </pre>
- *
- * The default duration of the animation is 500ms.
- *
- * For color css properties, values can be specified via hexadecimal or rgb or literal values.
- *
- * Example:
- *
- * <pre class="code">
- * $("#foo").animate("backgroundColor:'red', color:'#ffffff', borderColor:'rgb(129, 0, 70)'");
- * </pre>
- *
- * @param stringOrProperties the property to animate : "cssName:'value'"
- * @param funcs an array of {@link Function} called once the animation is complete
- */
- LazyGQuery<T> animate(Object stringOrProperties, Function... funcs);
-
- /**
- *
- * The animate() method allows you to create animation effects on any numeric HTML Attribute,
- * CSS property, or color CSS property.
- *
- * Concerning to numeric properties, values are treated as a number of pixels unless otherwise
- * specified. The units em and % can be specified where applicable.
- *
- * By default animate considers css properties, if you wanted to animate element attributes you
- * should to prepend the symbol dollar to the attribute name. It's useful to animate svg elements.
- *
- * NOTE: The ability of animating attribute values is only available in gquery but not jquery
- *
- * Example:
- *
- * <pre class="code">
- * // move the element from its original position to left:500px for 500ms using a swing easing
- * $("#foo").animate("left:'500'", 500, Easing.SWING);
- *
- * // Change the width html attribute of a table, note the symbol '$' to
- * // tell gquery which it is an html-attribute instead of a css-property.
- * // the animation will last 400ms, and we use the LINEAR easing algorithm
- * $("table").animate(Properties.create("{$width: '500', $border: '10'}"), 400, Easing.LINEAR);
- * </pre>
- *
- * In addition to numeric values, each property can take the strings 'show', 'hide', and 'toggle'.
- * These shortcuts allow for custom hiding and showing animations that take into account the
- * display type of the element. Animated properties can also be relative. If a value is supplied
- * with a leading += or -= sequence of characters, then the target value is computed by adding or
- * subtracting the given number from the current value of the property.
- *
- * Example:
- *
- * <pre class="code">
- * // move the element from its original position to 500px to the left and 5OOpx down for 400ms.
- * // use a swing easing function for the transition
- * $("#foo").animate(Properties.create("{top:'+=500px',left:'+=500px'}"), 400, Easing.SWING);
- * </pre>
- *
- * For color css properties, values can be specified via hexadecimal or rgb or literal values.
- *
- * Example:
- *
- * <pre class="code">
- * $("#foo").animate("backgroundColor:'red', color:'#ffffff', borderColor:'rgb(129, 0, 70)'"), 400, Easing.SWING);
- * </pre>
- *
- * @param stringOrProperties a String or a {@link Properties} object containing css properties to
- * animate.
- * @param funcs an array of {@link Function} called once the animation is complete
- * @param duration the duration in milliseconds of the animation
- * @param easing the easing function to use for the transition
- */
- LazyGQuery<T> animate(Object stringOrProperties, int duration, Easing easing, Function... funcs);
-
- /**
- * The animate() method allows you to create animation effects on any numeric HTML Attribute,
- * CSS property, or color CSS property.
- *
- * Concerning to numeric properties, values are treated as a number of pixels unless otherwise
- * specified. The units em and % can be specified where applicable.
- *
- * By default animate considers css properties, if you wanted to animate element attributes you
- * should to prepend the symbol dollar to the attribute name. It's useful to animate svg elements.
- *
- * NOTE: The ability of animating attribute values is only available in gquery but not jquery
- *
- * Example:
- *
- * <pre class="code">
- * // move the element from its original position to left:500px for 500ms
- * $("#foo").animate("left:'500'", 500);
- *
- * // Change the width html attribute of a table, note the symbol '$' to
- * // tell gquery which it is an html-attribute instead of a css-property.
- * // the animation will last 400ms
- * $("table").animate("$width:'500'"), 400);
- * </pre>
- *
- * In addition to numeric values, each property can take the strings 'show', 'hide', and 'toggle'.
- * These shortcuts allow for custom hiding and showing animations that take into account the
- * display type of the element. Animated properties can also be relative. If a value is supplied
- * with a leading += or -= sequence of characters, then the target value is computed by adding or
- * subtracting the given number from the current value of the property.
- *
- * Example:
- *
- * <pre class="code">
- * // move the element from its original position to 500px to the left for 1000ms and
- * // change the background color of the element at the end of the animation
- * $("#foo").animate("left:'+=500'", 1000, new Function(){
- * public void f(Element e){
- * $(e).css(CSS.BACKGROUND_COLOR.with(RGBColor.RED);
- * }
- * });
- * </pre>
- *
- * For color css properties, values can be specified via hexadecimal or rgb or literal values.
- *
- * Example:
- *
- * <pre class="code">
- * $("#foo").animate("backgroundColor:'red', color:'#ffffff', borderColor:'rgb(129, 0, 70)', 1000");
- * </pre>
- *
- * @param stringOrProperties the set of properties to animate : "cssName:'value'"
- * @param funcs an array of {@link Function} called once the animation is complete.
- */
- LazyGQuery<T> animate(Object stringOrProperties, int duration, Function... funcs);
-
- /**
- * Append content to the inside of every matched element. This operation is similar to doing an
- * appendChild to all the specified elements, adding them into the document.
- */
- LazyGQuery<T> append(GQuery query);
-
- /**
- * Append content to the inside of every matched element. This operation is similar to doing an
- * appendChild to all the specified elements, adding them into the document.
- */
- LazyGQuery<T> append(Node n);
-
- /**
- * Append content to the inside of every matched element. This operation is similar to doing an
- * appendChild to all the specified elements, adding them into the document.
- */
- LazyGQuery<T> append(String html);
-
- /**
- * Append content to the inside of every matched element. This operation is similar to doing an
- * appendChild to all the specified elements, adding them into the document.
- */
- LazyGQuery<T> append(SafeHtml safeHtml);
-
- /**
- * All of the matched set of elements will be inserted at the end of the element(s) specified by
- * the parameter other.
- *
- * The operation $(A).appendTo(B) is, essentially, the reverse of doing a regular $(A).append(B),
- * instead of appending B to A, you're appending A to B.
- */
- LazyGQuery<T> appendTo(GQuery other);
-
- /**
- * All of the matched set of elements will be inserted at the end of the element(s) specified by
- * the parameter other.
- *
- * The operation $(A).appendTo(B) is, essentially, the reverse of doing a regular $(A).append(B),
- * instead of appending B to A, you're appending A to B.
- */
- LazyGQuery<T> appendTo(Node n);
-
- /**
- * All of the matched set of elements will be inserted at the end of the element(s) specified by
- * the parameter other.
- *
- * The operation $(A).appendTo(B) is, essentially, the reverse of doing a regular $(A).append(B),
- * instead of appending B to A, you're appending A to B.
- */
- LazyGQuery<T> appendTo(String html);
-
- /**
- * All of the matched set of elements will be inserted at the end of the element(s) specified by
- * the parameter other.
- *
- * The operation $(A).appendTo(B) is, essentially, the reverse of doing a regular $(A).append(B),
- * instead of appending B to A, you're appending A to B.
- */
- LazyGQuery<T> appendTo(SafeHtml safeHtml);
-
- /**
- * Convert to Plugin interface provided by Class literal.
- */
- <T extends GQuery> T as(Class<T> plugin);
-
- /**
- * Set a key/value object as properties to all matched elements.
- *
- * Example: $("img").attr(new Properties("src: 'test.jpg', alt: 'Test Image'"))
- */
- LazyGQuery<T> attr(Properties properties);
-
- /**
- * Access a property on the first matched element. This method makes it easy to retrieve a
- * property value from the first matched element. If the element does not have an attribute with
- * such a name, empty string is returned. Attributes include title, alt, src, href, width, style,
- * etc.
- */
- String attr(String name);
-
- /**
- * Set a single property to a computed value, on all matched elements.
- */
- LazyGQuery<T> attr(String key, Function closure);
-
- /**
- * Set a single property to a value, on all matched elements.
- */
- LazyGQuery<T> attr(String key, Object value);
-
- /**
- * Insert content before each of the matched elements. The elements must already be inserted into
- * the document (you can't insert an element before another if it's not in the page).
- */
- LazyGQuery<T> before(GQuery query);
-
- /**
- * Insert content before each of the matched elements. The elements must already be inserted into
- * the document (you can't insert an element before another if it's not in the page).
- */
- LazyGQuery<T> before(Node n);
-
- /**
- * Insert content before each of the matched elements. The elements must already be inserted into
- * the document (you can't insert an element before another if it's not in the page).
- */
- LazyGQuery<T> before(String html);
-
- /**
- * Binds a set of handlers to a particular Event for each matched element.
- *
- * The event handlers are passed as Functions that you can use to prevent default behavior. To
- * stop both default action and event bubbling, the function event handler has to return false.
- *
- * You can pass an additional Object data to your Function as the second parameter
- *
- */
- LazyGQuery<T> bind(int eventbits, Object data, Function... funcs);
-
- /**
- * Binds a set of handlers to a particular Event for each matched element.
- *
- * The event handlers are passed as Functions that you can use to prevent default behavior. To
- * stop both default action and event bubbling, the function event handler has to return false.
- *
- */
- LazyGQuery<T> bind(int eventbits, Function... funcs);
-
- /**
- * Binds a set of handlers to a particular Event for each matched element.
- *
- * The event handlers are passed as Functions that you can use to prevent default behavior. To
- * stop both default action and event bubbling, the function event handler has to return false.
- *
- * You can pass an additional Object data to your Function as the second parameter
- *
- */
- LazyGQuery<T> bind(String eventType, Object data, Function... funcs);
-
- /**
- * Binds a set of handlers to a particular Event for each matched element.
- *
- * The event handlers are passed as Functions that you can use to prevent default behavior. To
- * stop both default action and event bubbling, the function event handler has to return false.
- *
- */
- LazyGQuery<T> bind(String eventType, Function... funcs);
-
- /**
- * Bind a set of functions to the blur event of each matched element. Or trigger the blur event if
- * no functions are provided.
- */
- LazyGQuery<T> blur(Function... f);
-
- /**
- * Bind a set of functions to the change event of each matched element. Or trigger the event if no
- * functions are provided.
- */
- LazyGQuery<T> change(Function... f);
-
- /**
- * Get a set of elements containing all of the unique immediate children of each of the matched
- * set of elements. Also note: while parents() will look at all ancestors, children() will only
- * consider immediate child elements.
- */
- LazyGQuery<T> children();
-
- /**
- * Get a set of elements containing all of the unique children of each of the matched set of
- * elements. This set is filtered with the expressions that will cause only elements matching any
- * of the selectors to be collected.
- */
- LazyGQuery<T> children(String... filters);
-
- /**
- * Remove from the Effects queue all {@link Function} that have not yet been run.
- */
- LazyGQuery<T> clearQueue();
-
- /**
- * Remove from the queue all {@link Function} that have not yet been run.
- */
- LazyGQuery<T> clearQueue(String queueName);
-
- /**
- * Bind a set of functions to the click event of each matched element. Or trigger the event if no
- * functions are provided.
- */
- LazyGQuery<T> click(Function... f);
-
- /**
- * Clone matched DOM Elements and select the clones. This is useful for moving copies of the
- * elements to another location in the DOM.
- */
- LazyGQuery<T> clone();
-
- /**
- * Get the first ancestor element that matches the selector (for each matched element), beginning
- * at the current element and progressing up through the DOM tree.
- *
- * @param selector
- * @return
- */
- LazyGQuery<T> closest(String selector);
-
- /**
- * Get the first ancestor element that matches the selector (for each matched element), beginning
- * at the current element and progressing up through the DOM tree until reach the
- * <code>context</code> node.
- *
- * If no context is passed in then the context of the gQuery object will be used instead.
- *
- */
- LazyGQuery<T> closest(String selector, Node context);
-
- /**
- * Returns a {@link Map} object as key a selector and as value the list of ancestor elements
- * matching this selectors, beginning at the first matched element and progressing up through the
- * DOM. This method allows retrieving the list of ancestors matching many selectors by traversing
- * the DOM only one time.
- *
- * @return
- */
- JsNamedArray<NodeList<Element>> closest(String[] selectors);
-
- /**
- * Returns a {@link Map} object as key a selector and as value the list of ancestor elements
- * matching this selectors, beginning at the first matched element and progressing up through the
- * DOM until reach the <code>context</code> node.. This method allows retrieving the list of
- * ancestors matching many selectors by traversing the DOM only one time.
- *
- * @return
- */
- JsNamedArray<NodeList<Element>> closest(String[] selectors, Node context);
-
- /**
- * Filter the set of elements to those that contain the specified text.
- */
- LazyGQuery<T> contains(String text);
-
- /**
- * Find all the child nodes inside the matched elements (including text nodes), or the content
- * document, if the element is an iframe.
- */
- LazyGQuery<T> contents();
-
- /**
- * Set CSS a single style property on every matched element using type-safe enumerations.
- *
- * The best way to use this method (i.e. to generate a CssSetter) is to take the desired css
- * property defined in {@link CSS} class and call the {@link TakesCssValue#with(HasCssName)}
- * method on it.
- *
- * ex :
- *
- * <pre class="code">
- * $("#myDiv").css(CSS.TOP.with(Length.cm(15)));
- * $("#myDiv").css(CSS.BACKGROUND.with(RGBColor.SILVER, ImageValue.url(""),
- * BackgroundRepeat.NO_REPEAT, BackgroundAttachment.FIXED,
- * BackgroundPosition.CENTER));
- * $("#myDiv").css(CSS.BACKGROUND_ATTACHMENT.with(BackgroundAttachment.FIXED));
- *
- * </pre>
- *
- */
- LazyGQuery<T> css(CssSetter... cssSetter);
-
- /**
- * Return a style property on the first matched element using type-safe enumerations.
- *
- * Ex : $("#myId").css(CSS.BACKGROUND_COLOR);
- */
- String css(HasCssValue property);
-
- /**
- * Return a style property on the first matched element using type-safe enumerations.
- *
- * The parameter force has a special meaning here: - When force is false, returns the value of the
- * css property defined in the style attribute of the element. - Otherwise it returns the real
- * computed value.
- *
- * For instance if you define 'display=none' not in the element style but in the css stylesheet,
- * it returns an empty string unless you pass the parameter force=true.
- *
- * Ex : $("#myId").css(CSS.WIDTH, true);
- */
- String css(HasCssValue property, boolean force);
-
- /**
- * Set a key/value object as style properties to all matched elements. This serves as the best way
- * to set a large number of style properties on all matched elements. You can use either js maps
- * or pure css syntax.
- *
- * Example:
- *
- * <pre class="code">
- * $(".item").css(Properties.create("color: 'red', background:'blue'"))
- * $(".item").css(Properties.create("color: red; background: blue;"))
- * </pre>
- */
- LazyGQuery<T> css(Properties properties);
-
- /**
- * Return a style property on the first matched element.
- */
- String css(String name);
-
- /**
- * Return a style property on the first matched element.
- *
- * The parameter force has a special meaning here:
- * <ul>
- * <li>When force is false, returns the value of the css property defined in the style attribute
- * of the element.
- * <li>Otherwise it returns the real computed value.
- * </ul>
- *
- * For instance if you don't define 'display=none'in the element style but in the css stylesheet,
- * it returns an empty string unless you pass the parameter force=true.
- */
- String css(String name, boolean force);
-
- /**
- * Set a single style property to a value, on all matched elements.
- *
- */
- LazyGQuery<T> css(String prop, String val);
-
- /**
- * Set CSS a single style property on every matched element using type-safe enumerations. This
- * method allows you to set manually the value or set <i>inherit</i> value
- *
- * ex :
- *
- * <pre class="code">
- * $(#myId).css(CSS.TEXT_DECORATION, CSS.INHERIT);
- * </pre>
- */
- LazyGQuery<T> css(TakesCssValue<?> cssProperty, String value);
-
- /**
- * Returns the numeric value of a css property.
- */
- double cur(String prop);
-
- /**
- * Returns the numeric value of a css property.
- *
- * The parameter force has a special meaning: - When force is false, returns the value of the css
- * property defined in the set of style attributes. - When true returns the real computed value.
- */
- double cur(String prop, boolean force);
-
- /**
- * Return the value at the named data store for the first element in the set of matched
- * elements.
- */
- <T> T data(String name);
-
- /**
- * Return the value at the named data store for the first element in the set of matched
- * elements, as set by data(name, value), with desired return type.
- *
- * @param clz return type class literal
- */
- <T> T data(String name, Class<? extends T> clz);
-
- /**
- * Store arbitrary data associated with the matched elements in the named data store.
- */
- LazyGQuery<T> data(String name, Object value);
-
- /**
- * Bind a set of functions to the dblclick event of each matched element. Or trigger the event if
- * no functions are provided.
- */
- LazyGQuery<T> dblclick(Function... f);
-
- /**
- * Insert a delay (in ms) in the GQuery queue, and optionally execute one o more functions if
- * provided when the delay finishes. It uses the effects queue namespace, so you can stack any of
- * the methods in the effects plugin.
- *
- * Example:
- *
- * <pre class="code">
- * $("#foo").slideUp(300)
- * .delay(800)
- * .fadeIn(400);
- * </pre>
- *
- * When this statement is executed, the element slides up for 300 milliseconds and then pauses for
- * 800 milliseconds before fading in for 400 milliseconds. Aditionally after those 800
- * milliseconds the element color is set to red.
- *
- * NOTE that this methods affects only methods which uses the queue like effects. So the following
- * example is wrong:
- *
- * <pre>
- * $("#foo").css(CSS.COLOR.with(RGBColor.RED)).delay(800).css(CSS.COLOR.with(RGBColor.BLACK));
- * </pre>
- *
- * The code above will not insert a delay of 800 ms between the css() calls ! For this kind of
- * behavior, you should execute these methods puting them in inline functions passed as argument
- * to the delay() method, or adding them to the queue.
- *
- * <pre>
- * $("#foo").css(CSS.COLOR.with(RGBColor.RED)).delay(800, lazy().css(CSS.COLOR.with(RGBColor.BLACK)).done());
- * $("#foo").css(CSS.COLOR.with(RGBColor.RED)).delay(800).queue(lazy().css(CSS.COLOR.with(RGBColor.BLACK)).dequeue().done());
- * </pre>
- */
- LazyGQuery<T> delay(int milliseconds, Function... f);
-
- /**
- * Insert a delay (in ms) in the queue identified by the <code>queueName</code> parameter, and
- * optionally execute one o more functions if provided when the delay finishes.
- *
- * If <code>queueName</code> is null or equats to 'fx', the delay will be inserted to the Effects
- * queue.
- *
- * Example :
- *
- * <pre class="code">
- * $("#foo").queue("colorQueue", lazy().css(CSS.COLOR.with(RGBColor.RED)).dequeue("colorQueue").done())
- * .delay(800, "colorQueue")
- * .queue("colorQueue", lazy().css(CSS.COLOR.with(RGBColor.BLACK)).dequeue("colorQueue").done());
- * </pre>
- *
- * When this statement is executed, the text color of the element changes to red and then wait for
- * 800 milliseconds before changes the text color to black.
- *
- */
- LazyGQuery<T> delay(int milliseconds, String queueName, Function... f);
-
- /**
- * Attach <code>handlers</code> to one or more events for all elements that match the
- * <code>selector</code>, now or in the future, based on a specific set of root elements.
- *
- * Example:
- *
- * <pre>
- * $("table").delegate("td", Event.ONCLICK, new Function(){
- * public void f(Element e){
- * $(e).css(CSS.BACKGROUND_COLOR.with(RGBColor.RED));
- * }
- * });
- * </pre>
- *
- * This code above add an handler on click event on all cell (the existing oneand the future cell)
- * of all table. This code is equivalent to :
- *
- * <pre>
- * $("table").each(new Function(){
- * public void f(Element table){
- * $("td", table).live(Event.ONCLICK, new Function(){
- * public void f(Element e){
- * $(e).css(CSS.BACKGROUND_COLOR.with(RGBColor.RED));
- * }
- * }
- * });
- *
- * </pre>
- *
- * You can attach the handlers to many events by using the '|' operator ex:
- *
- * <pre>
- * $("div.main").delegate(".subMain", Event.ONCLICK | Event.ONDBLCLICK, new Function(){...});
- * </pre>
- * @deprecated use {@link #on(String, String, Function...)}
- */
- LazyGQuery<T> delegate(String selector, int eventbits, Function... handlers);
-
- /**
- * Attach <code>handlers</code> to one or more events for all elements that match the
- * <code>selector</code>, now or in the future, based on a specific set of root elements. The
- * <code>data</code> parameter allows us to pass data to the handler.
- *
- * Example:
- *
- * <pre>
- * $("table").delegate("td", "click", new Function(){
- * public void f(Element e){
- * $(e).css(CSS.BACKGROUND_COLOR.with(RGBColor.RED));
- * }
- * });
- * </pre>
- *
- * This code above add an handler on click event on all cell (the existing oneand the future cell)
- * of all table. This code is equivalent to :
- *
- * <pre>
- * $("table").each(new Function(){
- * public void f(Element table){
- * $("td", table).live("click", new Function(){
- * public void f(Element e){
- * $(e).css(CSS.BACKGROUND_COLOR.with(RGBColor.RED));
- * }
- * }
- * });
- *
- * </pre>
- *
- * You can pass attach the handlers to many events by using the '|' operator ex:
- *
- * <pre>
- * $("div.main").delegate(".subMain", Event.ONCLICK | Event.ONDBLCLICK, new Function(){...});
- * </pre>
- * @deprecated use {@link #on(String, String, Object, Function...)}
- */
- LazyGQuery<T> delegate(String selector, int eventbits, Object data, Function... handlers);
-
- /**
- * Attach <code>handlers</code> to one or more events for all elements that match the
- * <code>selector</code>, now or in the future, based on a specific set of root elements.
- *
- * Example:
- *
- * <pre>
- * $("table").delegate("td", "click", new Function(){
- * public void f(Element e){
- * $(e).css(CSS.BACKGROUND_COLOR.with(RGBColor.RED));
- * }
- * });
- * </pre>
- *
- * This code above add an handler on click event on all cell (the existing oneand the future cell)
- * of all table. This code is equivalent to :
- *
- * <pre>
- * $("table").each(new Function(){
- * public void f(Element table){
- * $("td", table).live("click", new Function(){
- * public void f(Element e){
- * $(e).css(CSS.BACKGROUND_COLOR.with(RGBColor.RED));
- * }
- * }
- * });
- *
- * </pre>
- *
- * You can pass attach the handlers to many events by specifying a String with espaced event type.
- * ex:
- *
- * <pre>
- * $("div.main").delegate(".subMain", "click dblclick", new Function(){...});
- * </pre>
- *
- * </pre>
- * @deprecated use {@link #on(String, String, Function...)}
- */
- LazyGQuery<T> delegate(String selector, String eventType, Function... handlers);
-
- /**
- * Attach <code>handlers</code> to one or more events for all elements that match the
- * <code>selector</code>, now or in the future, based on a specific set of root elements.
- *
- * Example:
- *
- * <pre>
- * $("table").delegate("td", "click", new Function(){
- * public void f(Element e){
- * $(e).css(CSS.BACKGROUND_COLOR.with(RGBColor.RED));
- * }
- * });
- * </pre>
- *
- * This code above add an handler on click event on all cell (the existing oneand the future cell)
- * of all table. This code is equivalent to :
- *
- * <pre>
- * $("table").each(new Function(){
- * public void f(Element table){
- * $("td", table).live("click", new Function(){
- * public void f(Element e){
- * $(e).css(CSS.BACKGROUND_COLOR.with(RGBColor.RED));
- * }
- * }
- * });
- *
- * You can pass attach the handlers to many events by specifying a String with espaced event type.
- * ex:
- *
- * <pre>
- * $("div.main").delegate(".subMain", "click dblclick", new Function(){...});
- * </pre>
- *
- * </pre>
- * @deprecated use {@link #on(String, String, Object, Function...)}
- */
- LazyGQuery<T> delegate(String selector, String eventType, Object data, Function... handlers);
-
- /**
- * Execute the next function on the Effects queue for the matched elements. This method is usefull
- * to tell when a function you add in the Effects queue is ended and so the next function in the
- * queue can start.
- *
- * Note: you should be sure to call dequeue() in all functions of a queue chain, otherwise the
- * queue execution will be stopped.
- */
- LazyGQuery<T> dequeue();
-
- /**
- * Execute the next function on the queue named as queueName for the matched elements. This method
- * is usefull to tell when a function you add in the Effects queue is ended and so the next
- * function in the queue can start.
- */
- LazyGQuery<T> dequeue(String queueName);
-
- /**
- * Detach all matched elements from the DOM. This method is the same than {@link #remove()} method
- * except all data and event handlers are not remove from the element. This method is useful when
- * removed elements are to be reinserted into the DOM at a later time.
- */
- LazyGQuery<T> detach();
-
- /**
- * Detach from the DOM all matched elements filtered by the <code>filter</code>.. This method is
- * the same than {@link #remove(String)} method except all data and event handlers are not remove
- * from the element. This method is useful when removed elements are to be reinserted into the DOM
- * at a later time.
- */
- LazyGQuery<T> detach(String filter);
-
- /**
- * Remove all event handlers previously attached using {@link #live(String, Function)}. In order
- * for this method to function correctly, the selector used with it must match exactly the
- * selector initially used with {@link #live(String, Function)}.
- *
- * @deprecated use {@link #off(String, String)} instead
- */
- LazyGQuery<T> die();
-
- /**
- * Remove an event handlers previously attached using {@link #live(int, Function)} In order for
- * this method to function correctly, the selector used with it must match exactly the selector
- * initially used with {@link #live(int, Function)}.
- * @deprecated use {@link #off(String)}
- */
- LazyGQuery<T> die(int eventbits);
-
- /**
- * Remove an event handlers previously attached using {@link #live(String, Function)} In order for
- * this method to function correctly, the selector used with it must match exactly the selector
- * initially used with {@link #live(String, Function)}.
- */
- LazyGQuery<T> die(String eventName);
-
- /**
- * Run one or more Functions over each element of the GQuery. You have to override one of these
- * funcions: public void f(Element e) public String f(Element e, int i)
- */
- LazyGQuery<T> each(Function... f);
-
- /**
- * Returns the working set of nodes as a Java array. <b>Do NOT</b> attempt to modify this array,
- * e.g. assign to its elements, or call Arrays.sort()
- */
- Element[] elements();
-
- /**
- * Remove all child nodes from the set of matched elements. In the case of a document element, it
- * removes all the content You should call this method whenever you create a new iframe and you
- * want to add dynamic content to it.
- */
- LazyGQuery<T> empty();
-
- /**
- * Revert the most recent 'destructive' operation, changing the set of matched elements to its
- * previous state (right before the destructive operation).
- */
- LazyGQuery<T> end();
-
- /**
- * Reduce GQuery to element in the specified position. This method accept negative index. A
- * negative index is counted from the end of the matched set:
- *
- * Example:
- *
- * <pre>
- * $("div").eq(0) will reduce the matched set to the first matched div
- * $("div").eq(1) will reduce the matched set to the second matched div
- *
- * $("div").eq(-1) will reduce the matched set to the last matched div
- * $("div").eq(-2) will reduce the matched set to the second-to-last matched div
- * ...
- * </pre>
- */
- LazyGQuery<T> eq(int pos);
-
- /**
- * Bind a set of functions to the error event of each matched element. Or trigger the event if no
- * functions are provided.
- */
- LazyGQuery<T> error(Function... f);
-
- /**
- * Fade in all matched elements by adjusting their opacity. The effect will take 1000 milliseconds
- * to complete
- */
- LazyGQuery<T> fadeIn(Function... f);
-
- /**
- * Fade in all matched elements by adjusting their opacity.
- */
- LazyGQuery<T> fadeIn(int millisecs, Function... f);
-
- /**
- * Fade the opacity of all matched elements to a specified opacity and firing
- * an optional callback after completion. Only the opacity is adjusted for
- * this animation, meaning that all of the matched elements should already
- * have some form of height and width associated with them.
- */
- LazyGQuery<T> fadeTo(int millisecs, double opacity, Function... f);
-
- /**
- * Fade the opacity of all matched elements to a specified opacity and firing
- * an optional callback after completion. Only the opacity is adjusted for
- * this animation, meaning that all of the matched elements should already
- * have some form of height and width associated with them.
- */
- LazyGQuery<T> fadeTo(double opacity, Function... f);
-
- /**
- * Fade out all matched elements by adjusting their opacity. The effect will take 1000
- * milliseconds to complete
- */
- LazyGQuery<T> fadeOut(Function... f);
-
- /**
- * Fade out all matched elements by adjusting their opacity.
- */
- LazyGQuery<T> fadeOut(int millisecs, Function... f);
-
- /**
- * Toggle the visibility of all matched elements by adjusting their opacity and firing an optional
- * callback after completion. Only the opacity is adjusted for this animation, meaning that all of
- * the matched elements should already have some form of height and width associated with them.
- */
- Effects fadeToggle(int millisecs, Function... f);
-
- /**
- * Removes all elements from the set of matched elements that do not match the specified function.
- * The function is called with a context equal to the current element. If the function returns
- * false, then the element is removed - anything else and the element is kept.
- */
- LazyGQuery<T> filter(Predicate filterFn);
-
- /**
- * Removes all elements from the set of matched elements that do not pass the specified css
- * expression. This method is used to narrow down the results of a search.
- * By default it works for either detached and attached elements unless
- * {@link SelectorEngine#filterDetached} is set to false.
- */
- LazyGQuery<T> filter(String... filters);
-
- /**
- * Removes all elements from the set of matched elements that do not pass the specified css
- * expression. This method is used to narrow down the results of a search.
- * Setting filterDetached parameter to true, means that we should consider detached elements
- * as well which implies some performance penalty.
- */
- LazyGQuery<T> filter(boolean filterDetached, String... filters);
-
- /**
- * Removes all elements from the set of matched elements that do not pass the specified css
- * expression. This method is used to narrow down the results of a search.
- * Setting considerDetached parameter to true, means that we should consider detached elements
- * as well which implies some performance penalties.
- */
- LazyGQuery<T> filter(boolean filterDetached, String selector);
-
- /**
- * Searches for all elements that match the specified css expression. This method is a good way to
- * find additional descendant elements with which to process.
- *
- * Provide a comma-separated list of expressions to apply multiple filters at once.
- */
- LazyGQuery<T> find(String... filters);
-
- /**
- * Reduce the set of matched elements to the first in the set.
- */
- LazyGQuery<T> first();
-
- /**
- * Bind a set of functions to the focus event of each matched element. Or trigger the event and
- * move the input focus to the first element if no functions are provided.
- */
- LazyGQuery<T> focus(Function... f);
-
- /**
- * Return all elements matched in the GQuery as a NodeList. @see #elements() for a method which
- * returns them as an immutable Java array.
- */
- NodeList<Element> get();
-
- /**
- * Return the ith element matched. This method accept negative index. A negative index is counted
- * from the end of the matched set.
- *
- * Example:
- *
- * <pre>
- * $("div").get(0) will return the first matched div
- * $("div").get(1) will return the second matched div
- *
- * $("div").get(-1) will return the last matched div
- * $("div").get(-2) will return the secont-to-last matched div
- * ...
- * </pre>
- */
- Element get(int i);
-
- Node getContext();
-
- /**
- * Return the previous set of matched elements prior to the last destructive operation (e.g.
- * query)
- */
- LazyGQuery<T> getPreviousObject();
-
- /**
- * Return the selector representing the current set of matched elements.
- */
- String getSelector();
-
- /**
- * Returns true any of the specified classes are present on any of the matched Reduce the set of
- * matched elements to all elements after a given position. The position of the element in the set
- * of matched elements starts at 0 and goes to length - 1.
- */
- LazyGQuery<T> gt(int pos);
-
- /**
- * Reduce the set of matched elements to those that have a descendant that matches the Element.
- */
- LazyGQuery<T> has(Element elem);
-
- /**
- * Reduce the set of matched elements to those that have a descendant that matches the selector.
- */
- LazyGQuery<T> has(String selector);
-
- /**
- * Returns true any of the specified classes are present on any of the matched elements.
- */
- boolean hasClass(String... classes);
-
- /**
- * Get the current computed, pixel, height of the first matched element. It does not include
- * margin, padding nor border.
- */
- int height();
-
- /**
- * Set the height of every element in the matched set.
- */
- LazyGQuery<T> height(int height);
-
- /**
- * Set the height style property of every matched element. It's useful for using 'percent' or 'em'
- * units Example: $(".a").height("100%")
- */
- LazyGQuery<T> height(String height);
-
- /**
- * Make invisible all matched elements.
- */
- LazyGQuery<T> hide();
-
- /**
- * Bind a function to the mouseover event of each matched element. A method for simulating
- * hovering (moving the mouse on, and off, an object). This is a custom method which provides an
- * 'in' to a frequent task. Whenever the mouse cursor is moved over a matched element, the first
- * specified function is fired. Whenever the mouse moves off of the element, the second specified
- * function fires.
- *
- * Since GQuery 1.4.0, this method binds handlers for both mouseenter and mouseleave events.
- */
- LazyGQuery<T> hover(Function fover, Function fout);
-
- /**
- * Get the innerHTML of the first matched element.
- */
- String html();
-
- /**
- * Set the innerHTML of every matched element.
- */
- LazyGQuery<T> html(String html);
-
- /**
- * Set the innerHTML of every matched element.
- */
- LazyGQuery<T> html(SafeHtml safeHtml);
-
- /**
- * Get the id of the first matched element.
- */
- String id();
-
- /**
- * Set the id of the first matched element.
- */
- LazyGQuery<T> id(String id);
-
- /**
- * Find the index of the specified Element.
- */
- int index(Element element);
-
- /**
- * Return the position of the first matched element in relation with its sibblings.
- */
- int index();
-
- /**
- * Returns the inner height of the first matched element, including padding but not the vertical
- * scrollbar height, border, or margin.
- */
- int innerHeight();
-
- /**
- * Returns the inner width of the first matched element, including padding but not the vertical
- * scrollbar width, border, or margin.
- */
- int innerWidth();
-
- /**
- * Insert all of the matched elements after another, specified, set of elements.
- */
- LazyGQuery<T> insertAfter(Element elem);
-
- /**
- * Insert all of the matched elements after another, specified, set of elements.
- */
- LazyGQuery<T> insertAfter(GQuery query);
-
- /**
- * Insert all of the matched elements after another, specified, set of elements.
- */
- LazyGQuery<T> insertAfter(String selector);
-
- /**
- * Insert all of the matched elements before another, specified, set of elements.
- *
- * The elements must already be inserted into the document (you can't insert an element after
- * another if it's not in the page).
- */
- LazyGQuery<T> insertBefore(Element item);
-
- /**
- * Insert all of the matched elements before another, specified, set of elements.
- *
- * The elements must already be inserted into the document (you can't insert an element after
- * another if it's not in the page).
- */
- LazyGQuery<T> insertBefore(GQuery query);
-
- /**
- * Insert all of the matched elements before another, specified, set of elements.
- *
- * The elements must already be inserted into the document (you can't insert an element after
- * another if it's not in the page).
- */
- LazyGQuery<T> insertBefore(String selector);
-
- /**
- * Checks the current selection against an expression and returns true, if at least one element of
- * the selection fits the given expression. Does return false, if no element fits or the
- * expression is not valid.
- */
- boolean is(String... filters);
-
- /**
- * Returns true if the number of matched elements is 0.
- */
- boolean isEmpty();
-
- /**
- * Return true if the first element is visible.isVisible.
- */
- boolean isVisible();
-
- /**
- * Bind a set of functions to the keydown event of each matched element. Or trigger the event if
- * no functions are provided.
- */
- LazyGQuery<T> keydown(Function... f);
-
- /**
- * Trigger a keydown event passing the key pushed.
- */
- LazyGQuery<T> keydown(int key);
-
- /**
- * Bind a set of functions to the keypress event of each matched element. Or trigger the event if
- * no functions are provided.
- */
- LazyGQuery<T> keypress(Function... f);
-
- /**
- * Trigger a keypress event passing the key pushed.
- */
- LazyGQuery<T> keypress(int key);
-
- /**
- * Bind a set of functions to the keyup event of each matched element. Or trigger the event if no
- * functions are provided.
- */
- LazyGQuery<T> keyup(Function... f);
-
- /**
- * Trigger a keyup event passing the key pushed.
- */
- LazyGQuery<T> keyup(int key);
-
- /**
- * Reduce the set of matched elements to the final one in the set.
- */
- LazyGQuery<T> last();
-
- /**
- * Returns the computed left position of the first element matched.
- */
- int left();
-
- /**
- * Returns the number of elements currently matched. The size function will return the same value.
- */
- int length();
-
- /**
- * Attach a handler for this event to all elements which match the current selector, now and in
- * the future.
- * @deprecated use {@link #on(String, Function...)}
- */
- LazyGQuery<T> live(int eventbits, Function... funcs);
-
- /**
- * Attach a handler for this event to all elements which match the current selector, now and in
- * the future.
- * @deprecated use {@link #on(String, Object, Function...)}
- */
- LazyGQuery<T> live(int eventbits, Object data, Function... funcs);
-
- /**
- * <p>
- * Attach a handler for this event to all elements which match the current selector, now and in
- * the future.
- * <p>
- * Ex :
- *
- * <pre>
- * $(".clickable").live("click", new Function(){
- * public void f(Element e){
- * $(e).css(CSS.COLOR.with(RGBColor.RED));
- * }
- * });
- * </pre>
- *
- * With this code, all elements with class "clickable" present in the DOM or added to the DOM in
- * the future will be clickable. The text color will be changed to red when they will be clicked.
- * So if after in the code, you add another element :
- *
- * <pre>
- * $("body").append("<div class='clickable'>Click me and I will be red</div>");
- * </pre>
- *
- * The click on this new element will also trigger the handler.
- * </p>
- * <p>
- * In the same way, if you add "clickable" class on some existing element, these elements will be
- * clickable also.
- * </p>
- * <p>
- * <h3>important remarks</h3>
- * <ul>
- * <li>
- * The live method should be always called after a selector</li>
- * <li>
- * Live events are bound to the context of the {@link GQuery} object :
- *
- * <pre>
- * $(".clickable", myElement).live("click", new Function(){
- * public void f(Element e){
- * $(e).css(CSS.COLOR.with(RGBColor.RED));
- * }
- * });
- * </pre>
- * The {@link Function} will be called only on elements having the class "clickable" and being
- * descendant of myElement.</li>
- * </ul>
- * </p>
- * @deprecated use {@link #on(String, Function...)}
- */
- LazyGQuery<T> live(String eventName, Function... funcs);
-
- /**
- * <p>
- * Attach a handler for this event to all elements which match the current selector, now and in
- * the future. The <code>data</code> parameter allows us to pass data to the handler.
- * <p>
- * Ex :
- *
- * <pre>
- * $(".clickable").live("click", new Function(){
- * public void f(Element e){
- * $(e).css(CSS.COLOR.with(RGBColor.RED));
- * }
- * });
- * </pre>
- *
- * With this code, all elements with class "clickable" present in the DOM or added to the DOM in
- * the future will be clickable. The text color will be changed to red when they will be clicked.
- * So if after in the code, you add another element :
- *
- * <pre>
- * $("body").append("<div class='clickable'>Click me and I will be red</div>");
- * </pre>
- *
- * The click on this new element will also trigger the handler.
- * </p>
- * <p>
- * In the same way, if you add "clickable" class on some existing element, these elements will be
- * clickable also.
- * </p>
- * <p>
- * <h3>important remarks</h3>
- * <ul>
- * <li>
- * The live method should be always called after a selector</li>
- * <li>
- * Live events are bound to the context of the {@link GQuery} object :
- *
- * <pre>
- * $(".clickable", myElement).live("click", new Function(){
- * public void f(Element e){
- * $(e).css(CSS.COLOR.with(RGBColor.RED));
- * }
- * });
- * </pre>
- * The {@link Function} will be called only on elements having the class "clickable" and being
- * descendant of myElement.</li>
- * </ul>
- * </p>
- * @deprecated use {@link #on(String, Object, Function...)}
- */
- LazyGQuery<T> live(String eventName, Object data, Function... funcs);
-
- /**
- * Load data from the server and place the returned HTML into the matched element.
- *
- * The url allows us to specify a portion of the remote document to be inserted. This is achieved
- * with a special syntax for the url parameter. If one or more space characters are included in
- * the string, the portion of the string following the first space is assumed to be a GQuery
- * selector that determines the content to be loaded.
- *
- */
- LazyGQuery<T> load(String url);
-
- /**
- * Load data from the server and place the returned HTML into the matched element.
- *
- * The url allows us to specify a portion of the remote document to be inserted. This is achieved
- * with a special syntax for the url parameter. If one or more space characters are included in
- * the string, the portion of the string following the first space is assumed to be a GQuery
- * selector that determines the content to be loaded.
- *
- */
- LazyGQuery<T> load(String url, IsProperties data, Function onSuccess);
-
- /**
- * Reduce the set of matched elements to all elements before a given position. The position of the
- * element in the set of matched elements starts at 0 and goes to length - 1.
- */
- LazyGQuery<T> lt(int pos);
-
- /**
- * Pass each element in the current matched set through a function, producing a new array
- * containing the return values. When the call to the function returns a null it is not added to
- * the array.
- */
- <W> List<W> map(Function f);
-
- /**
- * Bind a set of functions to the mousedown event of each matched element. Or trigger the event if
- * no functions are provided.
- */
- LazyGQuery<T> mousedown(Function... f);
-
- /**
- * Bind an event handler to be fired when the mouse enter an element, or trigger that handler on
- * an element if no functions are provided.
- *
- * The mouseenter event differs from mouseover in the way it handles event bubbling. When
- * mouseover is used on an element having inner element(s), then when the mouse pointer moves hover
- * of the Inner element, the handler would be triggered. This is usually undesirable behavior. The
- * mouseenter event, on the other hand, only triggers its handler when the mouse enters the
- * element it is bound to, not a descendant.
- */
- LazyGQuery<T> mouseenter(Function... f);
-
- /**
- * Bind an event handler to be fired when the mouse leaves an element, or trigger that handler on
- * an element if no functions are provided.
- *
- * The mouseleave event differs from mouseout in the way it handles event bubbling. When
- * mouseout is used on an element having inner element(s), then when the mouse pointer moves out
- * of the Inner element, the handler would be triggered. This is usually undesirable behavior. The
- * mouseleave event, on the other hand, only triggers its handler when the mouse leaves the
- * element it is bound to, not a descendant.
- */
- LazyGQuery<T> mouseleave(Function... f);
-
- /**
- * Bind a set of functions to the mousemove event of each matched element. Or trigger the event if
- * no functions are provided.
- */
- LazyGQuery<T> mousemove(Function... f);
-
- /**
- * Bind a set of functions to the mouseout event of each matched element. Or trigger the event if
- * no functions are provided.
- */
- LazyGQuery<T> mouseout(Function... f);
-
- /**
- * Bind a set of functions to the mouseover event of each matched element. Or trigger the event if
- * no functions are provided.
- */
- LazyGQuery<T> mouseover(Function... f);
-
- /**
- * Bind a set of functions to the mouseup event of each matched element. Or trigger the event if
- * no functions are provided.
- */
- LazyGQuery<T> mouseup(Function... f);
-
- /**
- * Get a set of elements containing the unique next siblings of each of the given set of elements.
- * next only returns the very next sibling for each element, not all next siblings see {#nextAll}.
- */
- LazyGQuery<T> next();
-
- /**
- * Get a set of elements containing the unique next siblings of each of the given set of elements
- * filtered by 1 or more selectors. next only returns the very next sibling for each element, not
- * all next siblings see {#nextAll}.
- */
- LazyGQuery<T> next(String... selectors);
-
- /**
- * Get all following siblings of each element in the set of matched elements.
- */
- LazyGQuery<T> nextAll();
-
- /**
- * Get all following siblings of each element in the set of matched elements, filtered by a
- * selector.
- */
- LazyGQuery<T> nextAll(String filter);
-
- /**
- * Get all following siblings of each element up to but not including the element matched by the
- * selector.
- *
- * @param selector
- * @return
- */
- LazyGQuery<T> nextUntil(String selector);
-
- /**
- * Get all following siblings of each element up to but not including the element matched by the
- * selector, filtered by a selector.
- *
- * @param selector
- * @return
- */
- LazyGQuery<T> nextUntil(String selector, String filter);
-
- /**
- * Get all following siblings of each element up to but not including the element matched by the
- * DOM node.
- *
- * @param selector
- * @return
- */
- LazyGQuery<T> nextUntil(Element until);
-
- /**
- * Get all following siblings of each element up to but not including the element matched by the
- * DOM node, filtered by a selector.
- *
- * @return
- */
- LazyGQuery<T> nextUntil(Element until, String filter);
-
- /**
- * Get all following siblings of each element up to but not including the element matched by the
- * GQuery object.
- *
- * @return
- */
- LazyGQuery<T> nextUntil(GQuery until);
-
- /**
- * Get all following siblings of each element up to but not including the element matched by the
- * GQuery object, filtered by a selector.
- *
- * @return
- */
- LazyGQuery<T> nextUntil(GQuery until, String filter);
-
- /**
- * Removes the specified Element from the set of matched elements. This method is used to remove a
- * single Element from a jQuery object.
- */
- LazyGQuery<T> not(Element elem);
-
- /**
- * Removes any elements inside the passed set of elements from the set of matched elements.
- */
- LazyGQuery<T> not(GQuery gq);
-
- /**
- * Removes elements matching the specified expression from the set of matched elements.
- */
- LazyGQuery<T> not(String... filters);
-
- /**
- * Get the current offset of the first matched element, in pixels, relative to the document. The
- * returned object contains two integer properties, top and left. The method works only with
- * visible elements.
- */
- Offset offset();
-
- /**
- * Set the current coordinates of every element in the set of matched elements, relative to the document.
- */
- LazyGQuery<T> offset(Offset offset);
-
- /**
- * Set the current coordinates of every element in the set of matched elements, relative to the document.
- */
- LazyGQuery<T> offset(int top, int left);
-
- /**
- * Returns a GQuery collection with the positioned parent of the first matched element. This is
- * the first parent of the element that has position (as in relative or absolute). This method
- * only works with visible elements.
- */
- LazyGQuery<T> offsetParent();
-
- /**
- * Attach an event handler function for one or more events to the selected elements.
- */
- LazyGQuery<T> on(String eventName, Function... funcs);
-
- /**
- * Attach an event handler function for one or more events to the selected elements.
- */
- LazyGQuery<T> on(String eventName, Object data, Function... funcs);
-
- /**
- * Attach an event handler function for one or more events to the selected elements.
- */
- LazyGQuery<T> on(String eventName, String selector, Function... funcs);
-
- /**
- * Attach an event handler function for one or more events to the selected elements.
- */
- LazyGQuery<T> on(String eventName, String selector, Object data, Function... funcs);
-
- /**
- * Remove all event handlers.
- */
- LazyGQuery<T> off();
-
- /**
- * Remove an event handler.
- */
- LazyGQuery<T> off(String eventName);
-
- /**
- * Remove an event handler.
- */
- LazyGQuery<T> off(String eventName, Function f);
-
- /**
- * Remove an event handler.
- */
- LazyGQuery<T> off(String eventName, String selector);
-
- /**
- * Binds a handler to a particular Event (like Event.ONCLICK) for each matched element. The
- * handler is executed only once for each element.
- *
- * The event handler is passed as a Function that you can use to prevent default behavior. To stop
- * both default action and event bubbling, the function event handler has to return false.
- *
- * You can pass an additional Object data to your Function as the second parameter
- */
- LazyGQuery<T> one(int eventbits, Object data, Function f);
-
- /**
- * Get the current computed height for the first element in the set of matched elements, including
- * padding, border, but not the margin.
- */
- int outerHeight();
-
- /**
- * Get the current computed height for the first element in the set of matched elements, including
- * padding, border, and optionally margin.
- */
- int outerHeight(boolean includeMargin);
-
- /**
- * Get the current computed width for the first element in the set of matched elements, including
- * padding, border, but not the margin.
- */
- int outerWidth();
-
- /**
- * Get the current computed width for the first element in the set of matched elements, including
- * padding and border and optionally margin.
- */
- int outerWidth(boolean includeMargin);
-
- /**
- * Get a set of elements containing the unique parents of the matched set of elements.
- */
- LazyGQuery<T> parent();
-
- /**
- * Get a set of elements containing the unique parents of the matched set of elements. You may use
- * an optional expressions to filter the set of parent elements that will match one of them.
- */
- LazyGQuery<T> parent(String... filters);
-
- /**
- * Get a set of elements containing the unique ancestors of the matched set of elements (except
- * for the root element).
- */
- LazyGQuery<T> parents();
-
- /**
- * Get a set of elements containing the unique ancestors of the matched set of elements (except
- * for the root element). The matched elements are filtered, returning those that match any of the
- * filters.
- */
- LazyGQuery<T> parents(String... filters);
-
- /**
- * Get the ancestors of each element in the current set of matched elements, up to but not
- * including the element matched by the selector.
- */
- LazyGQuery<T> parentsUntil(String selector);
-
- /**
- * Get the ancestors of each element in the current set of matched elements, up to but not
- * including the node.
- */
- LazyGQuery<T> parentsUntil(Node node);
-
- /**
- * Gets the top and left position of an element relative to its offset parent. The returned object
- * contains two Integer properties, top and left. For accurate calculations make sure to use pixel
- * values for margins, borders and padding. This method only works with visible elements.
- */
- Offset position();
-
- /**
- * Prepend content to the inside of every matched element. This operation is the best way to
- * insert elements inside, at the beginning, of all matched elements.
- */
- LazyGQuery<T> prepend(GQuery query);
-
- /**
- * Prepend content to the inside of every matched element. This operation is the best way to
- * insert elements inside, at the beginning, of all matched elements.
- */
- LazyGQuery<T> prepend(Node n);
-
- /**
- * Prepend content to the inside of every matched element. This operation is the best way to
- * insert elements inside, at the beginning, of all matched elements.
- */
- LazyGQuery<T> prepend(String html);
-
- /**
- * All of the matched set of elements will be inserted at the beginning of the element(s)
- * specified by the parameter other.
- *
- * The operation $(A).prependTo(B) is, essentially, the reverse of doing a regular
- * $(A).prepend(B), instead of prepending B to A, you're prepending A to B.
- */
- LazyGQuery<T> prependTo(GQuery other);
-
- /**
- * All of the matched set of elements will be inserted at the beginning of the element(s)
- * specified by the parameter other.
- *
- * The operation $(A).prependTo(B) is, essentially, the reverse of doing a regular
- * $(A).prepend(B), instead of prepending B to A, you're prepending A to B.
- */
- LazyGQuery<T> prependTo(Node n);
-
- /**
- * All of the matched set of elements will be inserted at the beginning of the element(s)
- * specified by the parameter other.
- *
- * The operation $(A).prependTo(B) is, essentially, the reverse of doing a regular
- * $(A).prepend(B), instead of prepending B to A, you're prepending A to B.
- */
- LazyGQuery<T> prependTo(String html);
-
- /**
- * Get a set of elements containing the unique previous siblings of each of the matched set of
- * elements. Only the immediately previous sibling is returned, not all previous siblings.
- */
- LazyGQuery<T> prev();
-
- /**
- * Get a set of elements containing the unique previous siblings of each of the matched set of
- * elements filtered by selector. Only the immediately previous sibling is returned, not all
- * previous siblings.
- */
- LazyGQuery<T> prev(String... selectors);
-
- /**
- * Get all preceding siblings of each element in the set of matched elements.
- */
- LazyGQuery<T> prevAll();
-
- /**
- * Get all preceding siblings of each element in the set of matched elements filtered by a
- * selector.
- */
- LazyGQuery<T> prevAll(String selector);
-
- /**
- * Get all preceding siblings of each element up to but not including the element matched by the
- * <code>selector</code>.
- *
- * The elements are returned in order from the closest sibling to the farthest.
- */
- LazyGQuery<T> prevUntil(String selector);
-
- /**
- * Get all preceding siblings of each element up to but not including the <code>until</code>
- * element.
- *
- * The elements are returned in order from the closest sibling to the farthest.
- */
- LazyGQuery<T> prevUntil(Element until);
-
- /**
- * Get all preceding siblings of each element up to but not including the <code>until</code>
- * element.
- *
- * The elements are returned in order from the closest sibling to the farthest.
- */
- LazyGQuery<T> prevUntil(GQuery until);
-
- /**
- * Get all preceding siblings of each element matching the <code>filter</code> up to but not
- * including the element matched by the <code>selector</code>.
- *
- * The elements are returned in order from the closest sibling to the farthest.
- */
- LazyGQuery<T> prevUntil(String selector, String filter);
-
- /**
- * Get all preceding siblings of each element matching the <code>filter</code> up to but not
- * including the <code>until</code> element.
- *
- */
- LazyGQuery<T> prevUntil(Element until, String filter);
-
- /**
- * Get all preceding siblings of each element matching the <code>filter</code> up to but not
- * including the element matched by the <code>until</code> element.
- *
- */
- LazyGQuery<T> prevUntil(GQuery until, String filter);
-
- /**
- * Returns a dynamically generated Promise that is resolved once all actions
- * in the queue have ended.
- */
- Promise promise();
-
- /**
- * Returns a dynamically generated Promise that is resolved once all actions
- * in the named queue have ended.
- */
- Promise promise(String name);
-
- /**
- * Get the value of a property for the first element in the set of matched elements.
- *
- * @param key the name of the property to be accessed
- * @return the value of the property, in the case the property is a 'boolean' it
- * returns a Boolean object, and a Double if is a 'number', so be prepared
- * if you cast to other numeric objects. In the case of the property is undefined
- * it returns null.
- */
- <T> T prop(String key);
-
- /**
- * Get the value of a property for the first element in the set of matched elements.
- *
- * @param key the name of the property to be accessed
- * @param clz the class of the type to return
- *
- * @return the value of the property, it safely check the type passed as parameter
- * and preform the aproproate transformations for numbers and booleans.
- * In the case of the property is undefined it returns null.
- */
- <T> T prop(String key, Class<? extends T> clz);
-
- /**
- * Sets a property to a value on all matched elements.
- *
- * @param key the name of the boolean property to be set
- * @param value the value specified. In the case the value is a Number, it is set
- * as a 'number' in the javascript object and the same with Boolean.
- *
- * @return this <code>GQuery</code> object
- *
- */
- LazyGQuery<T> prop(String key, Object value);
-
- /**
- * Sets a boolean property to a computed value on all matched elements.
- *
- * @param key the name of the boolean property to be set
- * @param closure the closure to be used to compute the value the specified boolean property
- * should be set to; the <code>closure</code> is
- * {@linkplain Function#f(com.google.gwt.dom.client.Element, int) passed} the target
- * element and its index as arguments and is expected to return either a
- * <code>Boolean</code> value or an object whose textual representation is converted to a
- * <code>Boolean</code> value; <code>null</code> return values are ignored
- *
- * @return this <code>GQuery</code> object
- *
- */
- LazyGQuery<T> prop(String key, Function closure);
-
- /**
- * Show the number of functions in the efects queue to be executed on the first matched element.
- */
- int queue();
-
- /**
- * Put a set of {@link Function} at the end of the Effects queue.
- *
- * Example:
- *
- * <pre class="code">
- * $("#foo").animate("left:'+=500'", 400)
- * .queue(new Function(){
- * public void f(Element e){
- * $(e).css(CSS.BACKGROUNG_COLOR.with(RGBColor.RED));
- * $(e).dequeue();
- * }
- * })
- * .animate("left:'-=500'", 400)
- * .queue(lazy().css("color", "yellow");
- *
- * </pre>
- *
- * When this statement is executed, the element move to 500 px to left for 400 ms, then its
- * background color is changed to red and then move to 500px to right for 400ms, and finally its
- * color is set to yellow.
- *
- * Please note that {@link #dequeue()} function is needed at the end of your function to start the
- * next function in the queue. In lazy() methods you should call dequeue() just before the done()
- * call. {@see #dequeue()}
- */
- LazyGQuery<T> queue(Function... f);
-
- /**
- * Show the number of functions in the queued named as queueName to be executed on the first
- * matched element.
- */
- int queue(String queueName);
-
- /**
- * Put a set of {@link Function} at the end of a queue.
- *
- * Example:
- *
- * <pre class="code">
- * $("#foo").queue("myQueue", new Function(){
- * public void f(Element e){
- * $(e).css(CSS.BACKGROUNG_COLOR.with(RGBColor.RED));
- * dequeue("myQueue");
- * }
- * })
- * .delay(500, "myQueue")
- * .queue("myQueue", lazy().css(CSS.COLOR.with(RGBColor.YELLOW)).dequeue("myQueue").done());
- * </pre>
- *
- * When this statement is executed, the background color of the element is set to red, then wait
- * 500ms before to set the text color of the element to yellow. right for 400ms.
- *
- * Please note that {@link #dequeue()} function is needed at the end of your function to start the
- * next function in the queue. In lazy() methods you should call dequeue() just before the done()
- * call. {@see #dequeue()}
- */
- LazyGQuery<T> queue(String queueName, Function... f);
-
- /**
- * Specify a function to execute when the DOM is fully loaded.
- *
- * While JavaScript provides the load event for executing code when a page is rendered, this event
- * is not seen if we attach an event listener after the document has been loaded.
- * This guarantees that our gwt code will be executed either it's executed synchronously before the
- * DOM has been rendered (ie: single script linker in header) or asynchronously.
- */
- Promise ready(Function... fncs);
-
- /**
- * Removes all matched elements from the DOM.
- */
- LazyGQuery<T> remove();
-
- /**
- * Removes from the DOM all matched elements filtered by the <code>filter</code>.
- */
- LazyGQuery<T> remove(String filter);
-
- /**
- * Remove the named attribute from every element in the matched set.
- */
- LazyGQuery<T> removeAttr(String key);
-
- /**
- * Removes the specified classes to each matched element.
- *
- * If no arguments are provided, it removes all classes like jquery does.
- */
- LazyGQuery<T> removeClass(String... classes);
-
- /**
- * Removes named data store from an element.
- */
- LazyGQuery<T> removeData(String name);
-
- /**
- * Remove a property for the set of matched elements.
- */
- LazyGQuery<T> removeProp(String name);
-
- /**
- * Replaces the element <code>elem</code> by the specified selector with the matched elements.
- * This function is the complement to replaceWith() which does the same task with the parameters
- * reversed.
- *
- * @return a {@link GQuery} object containing the new elements.
- */
- LazyGQuery<T> replaceAll(Element elem);
-
- /**
- * Replaces the elements matched by the target with the selected elements. This function is the
- * complement to replaceWith() which does the same task with the parameters reversed.
- *
- * @return a {@link GQuery} object containing the new elements.
- */
- LazyGQuery<T> replaceAll(GQuery target);
-
- /**
- * Replaces the elements matched by the specified selector with the matched elements. This
- * function is the complement to replaceWith() which does the same task with the parameters
- * reversed.
- *
- * @return a {@link GQuery} object containing the new elements.
- */
- LazyGQuery<T> replaceAll(String selector);
-
- /**
- * Replaces all matched elements with the specified element.
- *
- * @return the GQuery element that was just replaced, which has been removed from the DOM and not
- * the new element that has replaced it.
- */
- LazyGQuery<T> replaceWith(Element elem);
-
- /**
- * Replaces all matched elements with elements selected by <code>target</code> .
- *
- * @return the GQuery element that was just replaced, which has been removed from the DOM and not
- * the new element that has replaced it.
- */
- LazyGQuery<T> replaceWith(GQuery target);
-
- /**
- * Replaces all matched elements with the specified HTML.
- *
- * @return the GQuery element that was just replaced, which has been removed from the DOM and not
- * the new element that has replaced it.
- */
- LazyGQuery<T> replaceWith(String html);
-
- /**
- * Bind a set of functions to the resize event of each matched element, or tigger the resize event
- * if no functions are provided.
- *
- * Note that although all elements can be configured to handle resize events, by default only
- * window will trigger it when it is resized, for an arbitrary element you have to trigger the
- * event after resizing the object.
- *
- */
- LazyGQuery<T> resize(Function... f);
-
- /**
- * Bind an event handler to the "resize" JavaScript event, or trigger that event on an element.
- */
- LazyGQuery<T> resize(Function f);
-
- /**
- * Save a set of Css properties of every matched element.
- */
- void restoreCssAttrs(String... cssProps);
-
- /**
- * Restore a set of previously saved Css properties in every matched element.
- */
- void saveCssAttrs(String... cssProps);
-
- /**
- * Bind a set of functions to the scroll event of each matched element. Or trigger the event if no
- * functions are provided.
- */
- LazyGQuery<T> scroll(Function... f);
-
- /**
- * Scrolls the first matched element into view.
- */
- LazyGQuery<T> scrollIntoView();
-
- /**
- * Scrolls the first matched element into view.
- *
- * If ensure == true, it crawls up the DOM hierarchy, adjusting the scrollLeft and scrollTop
- * properties of each scroll-able element to ensure that the specified element is completely in
- * view. It adjusts each scroll position by the minimum amount necessary.
- */
- LazyGQuery<T> scrollIntoView(boolean ensure);
-
- /**
- * Gets the scroll left offset of the first matched element. This method works for both visible
- * and hidden elements.
- */
- int scrollLeft();
-
- /**
- * The scroll left offset is set to the passed value on all matched elements. This method works
- * for both visible and hidden elements.
- */
- LazyGQuery<T> scrollLeft(int left);
-
- /**
- *
- * Scrolls the contents of all matched elements to the specified co-ordinate becoming the top left
- * corner of the viewable area.
- *
- * This method is only useful where there are areas of the document not viewable within the
- * current viewable area of the window and the visible property of the window's scrollbar must be
- * set to true.
- *
- */
- LazyGQuery<T> scrollTo(int left, int top);
-
- /**
- * Gets the scroll top offset of the first matched element. This method works for both visible and
- * hidden elements.
- */
- int scrollTop();
-
- /**
- * The scroll top offset is set to the passed value on all matched elements. This method works for
- * both visible and hidden elements.
- */
- LazyGQuery<T> scrollTop(int top);
-
- LazyGQuery<T> select();
-
- /**
- * Force the current matched set of elements to become the specified array of elements.
- */
- LazyGQuery<T> setArray(NodeList<Element> list);
-
- LazyGQuery<T> setPreviousObject(GQuery previousObject);
-
- LazyGQuery<T> setSelector(String selector);
-
- /**
- * Make all matched elements visible.
- */
- LazyGQuery<T> show();
-
- /**
- * Get a set of elements containing all of the unique siblings of each of the matched set of
- * elements.
- */
- LazyGQuery<T> siblings();
-
- /**
- * Get a set of elements containing all of the unique siblings of each of the matched set of
- * elements filtered by the provided set of selectors.
- */
- LazyGQuery<T> siblings(String... selectors);
-
- /**
- * Return the number of elements in the matched set.
- */
- int size();
-
- /**
- * Selects a subset of the matched elements.
- */
- LazyGQuery<T> slice(int start, int end);
-
- /**
- * Reveal all matched elements by adjusting their height and firing an optional callback after
- * completion.
- */
- Effects slideDown(Function... f);
-
- /**
- * Reveal all matched elements by adjusting their height and firing an optional callback after
- * completion.
- */
- Effects slideDown(int millisecs, Function... f);
-
- /**
- * Toggle the visibility of all matched elements by adjusting their height and firing an optional
- * callback after completion. Only the height is adjusted for this animation, causing all matched
- * elements to be hidden or shown in a "sliding" manner
- */
- Effects slideToggle(Function... f);
-
- /**
- * Toggle the visibility of all matched elements by adjusting their height and firing an optional
- * callback after completion. Only the height is adjusted for this animation, causing all matched
- * elements to be hidden or shown in a "sliding" manner
- */
- Effects slideToggle(int millisecs, Function... f);
-
- /**
- * Hide all matched elements by adjusting their height and firing an optional callback after
- * completion.
- */
- Effects slideUp(Function... f);
-
- /**
- * Hide all matched elements by adjusting their height and firing an optional callback after
- * completion.
- */
- Effects slideUp(int millisecs, Function... f);
-
- /**
- * When .stop() is called on an element, the currently-running animation (if any) is immediately
- * stopped. If, for instance, an element is being hidden with .slideUp() when .stop() is called,
- * the element will now still be displayed, but will be a fraction of its previous height.
- * Callback functions are not called but the next animation in the queue begins immediately.
- */
- LazyGQuery<T> stop();
-
- /**
- * When .stop() is called on an element, the currently-running animation (if any) is immediately
- * stopped. If, for instance, an element is being hidden with .slideUp() when .stop() is called,
- * the element will now still be displayed, but will be a fraction of its previous height.
- * Callback functions are not called but the next animation in the queue begins immediately.
- *
- * If the clearQueue parameter is provided with a value of true, then the rest of the animations
- * in the queue are removed and never run.
- */
- LazyGQuery<T> stop(boolean clearQueue);
-
- /**
- * When .stop() is called on an element, the currently-running animation (if any) is immediately
- * stopped. If, for instance, an element is being hidden with .slideUp() when .stop() is called,
- * the element will now still be displayed, but will be a fraction of its previous height.
- * Callback functions are not called but the next animation in the queue begins immediately.
- *
- * If the clearQueue parameter is provided with a value of true, then the rest of the animations
- * in the queue are removed and never run.
- *
- * If the jumpToEnd property is provided with a value of true, the current animation stops, but
- * the element is immediately given its target values for each CSS property. The callback
- * functions are then immediately called, if provided.
- */
- LazyGQuery<T> stop(boolean clearQueue, boolean jumpToEnd);
-
- /**
- * Bind a set of functions to the submit event of each matched element. Or submit a form if no
- * functions are provided.
- */
- LazyGQuery<T> submit(Function... funcs);
-
- /**
- * Return the concatened text contained in the matched elements.
- */
- String text();
-
- /**
- * Set the innerText of every matched element.
- */
- LazyGQuery<T> text(String txt);
-
- /**
- * Toggle visibility of elements.
- */
- LazyGQuery<T> toggle();
-
- /**
- * Toggle among two or more function calls every other click.
- */
- LazyGQuery<T> toggle(Function... fn);
-
- /**
- * Adds or removes the specified classes to each matched element depending on the class's
- * presence.
- */
- LazyGQuery<T> toggleClass(String... classes);
-
- /**
- * Adds or removes the specified classes to each matched element depending on the value of the
- * switch argument.
- *
- * if addOrRemove is true, the class is added and in the case of false it is removed.
- */
- LazyGQuery<T> toggleClass(String clz, boolean addOrRemove);
-
- /**
- * Returns the computed top position of the first element matched.
- */
- int top();
-
- /**
- * Produces a string representation of the matched elements.
- */
- String toString();
-
- /**
- * Produces a string representation of the matched elements.
- */
- String toString(boolean pretty);
-
- /**
- * Trigger a browser native event on each matched element.
- */
- LazyGQuery<T> trigger(NativeEvent event);
-
- /**
- * Trigger a set of events on each matched element.
- *
- * For keyboard events you can pass a second parameter which represents the key-code of the pushed
- * key.
- *
- * Example: fire(Event.ONCLICK | Event.ONFOCUS) Example: fire(Event.ONKEYDOWN. 'a');
- */
- LazyGQuery<T> trigger(int eventbits, int... keys);
-
- /**
- * Trigger a event in all matched elements.
- *
- * @param eventName An string representing the type of the event desired
- * @param datas Additional parameters to pass along to the event handlers.
- */
- LazyGQuery<T> trigger(String eventName, Object... datas);
-
- /**
- * Removes all events that match the eventbits.
- */
- LazyGQuery<T> unbind(int eventbits);
-
- /**
- * Removes the function passed from the set of events which match the eventbits.
- */
- LazyGQuery<T> unbind(int eventbits, Function f);
-
- /**
- * Removes all events that match the eventList.
- */
- LazyGQuery<T> unbind(String eventList);
-
- /**
- * Removes all events that match the eventList.
- */
- LazyGQuery<T> unbind(String eventList, Function f);
-
- /**
- * Remove all event delegation that have been bound using
- * {@link #delegate(String, int, Function...)} {@link #live(int, Function...)} methods.
- *
- * @deprecated use {@link #off()}
- */
- LazyGQuery<T> undelegate();
-
- /**
- * Undelegate is a way of removing event handlers that have been bound using
- * {@link #delegate(String, int, Function...)} method.
- *
- * @deprecated use {@link #off(String)}
- */
- LazyGQuery<T> undelegate(String selector);
-
- /**
- * Undelegate is a way of removing event handlers that have been bound using
- * {@link #delegate(String, int, Function...)} method.
- *
- * @deprecated use {@link #off(String)}
- */
- LazyGQuery<T> undelegate(String selector, int eventBit);
-
- /**
- * Undelegate is a way of removing event handlers that have been bound using
- * {@link #delegate(String, int, Function...)} method.
- *
- * @deprecated use {@link #off(String, String)}
- */
- LazyGQuery<T> undelegate(String selector, String eventName);
-
- /**
- * Remove all duplicate elements from an array of elements. Note that this only works on arrays of
- * DOM elements, not strings or numbers.
- */
- JsNodeArray unique(NodeList<Element> result);
-
- /**
- * This method removes the element's parent. The matched elements replaces their parents within
- * the DOM structure. It is the inverse of {@link GQuery#wrap(GQuery)} method.
- *
- * @return
- */
- LazyGQuery<T> unwrap();
-
- /**
- * Gets the content of the value attribute of the first matched element, returns only the first
- * value even if it is a multivalued element. To get an array of all values in multivalues
- * elements use vals().
- *
- * When the first element is a radio-button and is not checked, then it looks for the first
- * checked radio-button that has the same name in the list of matched elements.
- *
- * When there are not matched elements it returns null.
- */
- String val();
-
- /**
- * Sets the value attribute of every matched element based in the return value of the function
- * evaluated for this element.
- *
- * NOTE: in jquery the function receives the arguments in different way, first index and them the
- * actual value, but we use the normal way in gquery Function, first the element and second the
- * index.
- */
- LazyGQuery<T> val(Function f);
-
- /**
- * Sets the 'value' attribute of every matched element, but does not set the checked flag to
- * checkboxes or radiobuttons.
- *
- * If you wanted to set values in collections of checkboxes o radiobuttons use val(String[])
- * instead
- */
- LazyGQuery<T> val(String value);
-
- /**
- * Sets the value of every matched element.
- *
- * There is a different behaviour depending on the element type:
- * <ul>
- * <li>select multiple: options whose value match any of the passed values will be set.
- * <li>select single: the last option whose value matches any of the passed values will be set.
- * <li>input radio: the last input whose value matches any of the passed values will be set.
- * <li>input checkbox: inputs whose value match any of the passed values will be set.
- * <li>textarea, button, and other input: value will set to a string result of joining with coma,
- * all passed values
- * </ul>
- *
- * NOTE: if you wanted call this function with just one parameter, you have to pass an array
- * signature to avoid call the overloaded val(String) method:
- *
- * $(...).val(new String[]{"value"});
- */
- LazyGQuery<T> val(String... values);
-
- /**
- * Gets the content of the value attribute of the first matched element, returns more than one
- * value if it is a multiple select.
- *
- * When the first element is a radio-button and is not checked, then it looks for a the first
- * checked radio-button that has the same name in the list of matched elements.
- *
- * This method always returns an array. If no valid value can be determined the array will be
- * empty, otherwise it will contain one or more values.
- */
- String[] vals();
-
- /**
- * Return the first non null attached widget from the matched elements or null if there isn't any.
- */
- <W extends Widget> W widget();
-
- /**
- * Return the nth non null attached widget from the matched elements or null if there isn't any.
- */
- <W extends Widget> W widget(int n);
-
- /**
- * return the list of attached widgets matching the query.
- */
- List<Widget> widgets();
-
- /**
- * Return the list of attached widgets instance of the provided class matching the query.
- *
- * This method is very useful for decoupled views, so as we can access widgets from other views
- * without maintaining methods which export them.
- *
- */
- <W extends Widget> List<W> widgets(Class<W> clazz);
-
- /**
- * Get the current computed, pixel, width of the first matched element. It does not include
- * margin, padding nor border.
- */
- int width();
-
- /**
- * Set the width of every matched element.
- */
- LazyGQuery<T> width(int width);
-
- /**
- * Set the width style property of every matched element. It's useful for using 'percent' or 'em'
- * units Example: $(".a").width("100%")
- */
- LazyGQuery<T> width(String width);
-
- /**
- * Wrap each matched element with the specified HTML content. This wrapping process is most useful
- * for injecting additional structure into a document, without ruining the original semantic
- * qualities of a document. This works by going through the first element provided (which is
- * generated, on the fly, from the provided HTML) and finds the deepest descendant element within
- * its structure -- it is that element that will enwrap everything else.
- */
- LazyGQuery<T> wrap(Element elem);
-
- /**
- * Wrap each matched element with the specified HTML content. This wrapping process is most useful
- * for injecting additional structure into a document, without ruining the original semantic
- * qualities of a document. This works by going through the first element provided (which is
- * generated, on the fly, from the provided HTML) and finds the deepest descendant element within
- * its structure -- it is that element that will enwrap everything else.
- */
- LazyGQuery<T> wrap(GQuery query);
-
- /**
- * Wrap each matched element with the specified HTML content. This wrapping process is most useful
- * for injecting additional structure into a document, without ruining the original semantic
- * qualities of a document. This works by going through the first element provided (which is
- * generated, on the fly, from the provided HTML) and finds the deepest descendant element within
- * its structure -- it is that element that will enwrap everything else.
- */
- LazyGQuery<T> wrap(String html);
-
- /**
- * Wrap each matched element with the specified SafeHtml content. This wrapping process is most useful
- * for injecting additional structure into a document, without ruining the original semantic
- * qualities of a document. This works by going through the first element provided (which is
- * generated, on the fly, from the provided SafeHtml) and finds the deepest descendant element within
- * its structure -- it is that element that will enwrap everything else.
- */
- LazyGQuery<T> wrap(SafeHtml safeHtml);
-
- /**
- * Wrap all the elements in the matched set into a single wrapper element. This is different from
- * .wrap() where each element in the matched set would get wrapped with an element. This wrapping
- * process is most useful for injecting additional structure into a document, without ruining the
- * original semantic qualities of a document.
- *
- * This works by going through the first element provided (which is generated, on the fly, from
- * the provided HTML) and finds the deepest descendant element within its structure -- it is that
- * element that will enwrap everything else.
- */
- LazyGQuery<T> wrapAll(Element elem);
-
- /**
- * Wrap all the elements in the matched set into a single wrapper element. This is different from
- * .wrap() where each element in the matched set would get wrapped with an element. This wrapping
- * process is most useful for injecting additional structure into a document, without ruining the
- * original semantic qualities of a document.
- *
- * This works by going through the first element provided (which is generated, on the fly, from
- * the provided HTML) and finds the deepest descendant element within its structure -- it is that
- * element that will enwrap everything else.
- */
- LazyGQuery<T> wrapAll(GQuery query);
-
- /**
- * Wrap all the elements in the matched set into a single wrapper element. This is different from
- * .wrap() where each element in the matched set would get wrapped with an element. This wrapping
- * process is most useful for injecting additional structure into a document, without ruining the
- * original semantic qualities of a document.
- *
- * This works by going through the first element provided (which is generated, on the fly, from
- * the provided HTML) and finds the deepest descendant element within its structure -- it is that
- * element that will enwrap everything else.
- */
- LazyGQuery<T> wrapAll(String html);
-
- /**
- * Wrap all the elements in the matched set into a single wrapper element. This is different from
- * .wrap() where each element in the matched set would get wrapped with an element. This wrapping
- * process is most useful for injecting additional structure into a document, without ruining the
- * original semantic qualities of a document.
- *
- * This works by going through the first element provided (which is generated, on the fly, from
- * the provided SafeHtml) and finds the deepest descendant element within its structure -- it is that
- * element that will enwrap everything else.
- */
- LazyGQuery<T> wrapAll(SafeHtml safeHtml);
-
- /**
- * Wrap the inner child contents of each matched element (including text nodes) with an HTML
- * structure. This wrapping process is most useful for injecting additional structure into a
- * document, without ruining the original semantic qualities of a document. This works by going
- * through the first element provided (which is generated, on the fly, from the provided HTML) and
- * finds the deepest ancestor element within its structure -- it is that element that will enwrap
- * everything else.
- */
- LazyGQuery<T> wrapInner(Element elem);
-
- /**
- * Wrap the inner child contents of each matched element (including text nodes) with an HTML
- * structure. This wrapping process is most useful for injecting additional structure into a
- * document, without ruining the original semantic qualities of a document. This works by going
- * through the first element provided (which is generated, on the fly, from the provided HTML) and
- * finds the deepest ancestor element within its structure -- it is that element that will enwrap
- * everything else.
- */
- LazyGQuery<T> wrapInner(GQuery query);
-
- /**
- * Wrap the inner child contents of each matched element (including text nodes) with an HTML
- * structure. This wrapping process is most useful for injecting additional structure into a
- * document, without ruining the original semantic qualities of a document. This works by going
- * through the first element provided (which is generated, on the fly, from the provided HTML) and
- * finds the deepest ancestor element within its structure -- it is that element that will enwrap
- * everything else.
- */
- LazyGQuery<T> wrapInner(String html);
-
- /**
- * Wrap the inner child contents of each matched element (including text nodes) with an SafeHtml
- * structure. This wrapping process is most useful for injecting additional structure into a
- * document, without ruining the original semantic qualities of a document. This works by going
- * through the first element provided (which is generated, on the fly, from the provided SafeHtml) and
- * finds the deepest ancestor element within its structure -- it is that element that will enwrap
- * everything else.
- */
- LazyGQuery<T> wrapInner(SafeHtml safeHtml);
-
- }
|