Class Ext

Package:	Global
Class:	Ext
Extends:	Object
Defined In:	Ext.js

Ext core utilties and functions

This class is a singleton and cannot be created directly.

Properties - Methods - Events

Public Properties

Property		Defined By
	BLANK_IMAGE_URL : String	Ext
	URL to a 1x1 transparent gif image used by Ext to create inline icons with CSS background images. (Defaults to "http:...	Ext
	SSL_SECURE_URL : String	Ext
	URL to a blank file used by Ext when in secure mode for iframe src and onReady src to prevent the IE insecure content...	Ext
	isStrict : Boolean	Ext
	True if the browser is in strict mode	Ext
	useShims : Boolean	Ext
	By default, Ext intelligently decides whether floating elements should be shimmed. If you are using flash, you ...	Ext

Public Methods

Method		Defined By
	apply(`Object obj`, `Object config`, `Object defaults`) : Object	Ext
	* Copies all the properties of config to obj.	Ext
	applyIf(`Object obj`, `Object config`) : Object	Ext
	Copies all the properties of config to obj if they don't already exist.	Ext
	decode() : void	Ext
	Shorthand for Ext.util.JSON.decode	Ext
	each(`Array/NodeList/Mixed array`, `Function fn`, `Object scope`) : void	Ext
	Iterates an array calling the passed function with each item, stopping if your function returns false. If the passed ...	Ext
	encode() : void	Ext
	Shorthand for Ext.util.JSON.encode	Ext
	escapeRe(`String str`) : String	Ext
	Escapes the passed string for use in a regular expression	Ext
	extend(`Object subclass`, `Object superclass`, [`Object overrides`]) : void	Ext
	Extends one class with another class and optionally overrides members with the passed literal. This class also adds t...	Ext
	fly(`String/HTMLElement el`, [`String named`]) : Element	Ext
	<static> Gets the globally shared flyweight Element, with the passed node as the active element. Do not store a...	Ext
	get(`String/HTMLElement/Element el`) : Element	Ext
	Static method to retreive Element objects. Uses simple caching to consistently return the same object. Automatically...	Ext
	getDom(`String/HTMLElement/Element) el`) : HTMLElement	Ext
	Return the dom node for the passed string (id), dom node, or Ext.Element	Ext
	id([`String/HTMLElement/Element el`], [`String prefix`]) : void	Ext
	Generates unique ids. If the element already has an id, it is unchanged	Ext
	namespace(`String namespace1`, `String namespace2`, `String etc`) : void	Ext
	Creates namespaces but does not assume YAHOO is the root.	Ext
	onReady(`Function fn`, `Object scope`, `boolean override`) : void	Ext
	Fires when the document is ready (before onload and before images are loaded). Shorthand of Ext.EventManager.onDocum...	Ext
	query(`String path`, [`Node root`]) : Array	Ext
	Selects an array of DOM nodes by CSS/XPath selector. Shorthand of Ext.DomQuery.select	Ext
	select(`String/Array selector`, [`Boolean unique`]) : CompositeElementLite/CompositeElement	Ext
	Selects elements based on the passed CSS selector to enable working on them as 1.	Ext
	urlDecode(`String string`, [`Boolean overwrite`]) : Object	Ext
	Takes an encoded URL and and converts it to an object. e.g. Ext.urlDecode("foo=1&bar=2"); would return {foo: 1, bar: ...	Ext
	urlEncode(`Object o`) : String	Ext
	Takes an object and converts it to an encoded URL. e.g. Ext.urlEncode({foo: 1, bar: 2}); would return "foo=1&bar=2". ...	Ext

Public Events

This class has no public events.

Property Details

BLANK_IMAGE_URL

public String BLANK_IMAGE_URL

URL to a 1x1 transparent gif image used by Ext to create inline icons with CSS background images. (Defaults to "http://extjs.com/s.gif" and you should change this to a URL on your server).

This property is defined by Ext.

SSL_SECURE_URL

public String SSL_SECURE_URL

URL to a blank file used by Ext when in secure mode for iframe src and onReady src to prevent the IE insecure content warning (defaults to javascript:false).

This property is defined by Ext.

isStrict

public Boolean isStrict

True if the browser is in strict mode

This property is defined by Ext.

useShims

public Boolean useShims

By default, Ext intelligently decides whether floating elements should be shimmed. If you are using flash, you may want to set this to true.

This property is defined by Ext.

Method Details

apply

public function apply(Object obj, Object config, Object defaults)

* Copies all the properties of config to obj.

Parameters:

obj : Object
The receiver of the properties
config : Object
The source of the properties
defaults : Object
A different object that will also be applied for default values

Returns:

Object
returns obj

This method is defined by Ext.

applyIf

public function applyIf(Object obj, Object config)

Copies all the properties of config to obj if they don't already exist.

Parameters:

obj : Object
The receiver of the properties
config : Object
The source of the properties

Returns:

Object
returns obj

This method is defined by Ext.

decode

public function decode()

Shorthand for Ext.util.JSON.decode

Parameters:

None.

Returns:

void

This method is defined by Ext.

each

public function each(Array/NodeList/Mixed array, Function fn, Object scope)

Iterates an array calling the passed function with each item, stopping if your function returns false. If the passed array is not really an array, your function is called once with it. The supplied function is called with (Object item, Number index, Array allItems).

Parameters:

array : Array/NodeList/Mixed
fn : Function
scope : Object

Returns:

void

This method is defined by Ext.

encode

public function encode()

Shorthand for Ext.util.JSON.encode

Parameters:

None.

Returns:

void

This method is defined by Ext.

escapeRe

public function escapeRe(String str)

Escapes the passed string for use in a regular expression

Parameters:

str : String

Returns:

String

This method is defined by Ext.

extend

public function extend(Object subclass, Object superclass, [Object overrides])

Extends one class with another class and optionally overrides members with the passed literal. This class also adds the function "override()" to the class that can be used to override members on an instance.

Parameters:

subclass : Object
The class inheriting the functionality
superclass : Object
The class being extended
overrides : Object
(optional) A literal with members

Returns:

void

This method is defined by Ext.

fly

public function fly(String/HTMLElement el, [String named])

<static> Gets the globally shared flyweight Element, with the passed node as the active element. Do not store a reference to this element - the dom node can be overwritten by other code. Shorthand of Ext.Element.fly

Parameters:

el : String/HTMLElement
The dom node or id
named : String
(optional) Allows for creation of named reusable flyweights to prevent conflicts (e.g. internally Ext uses "_internal")

Returns:

Element
The shared Element object

This method is defined by Ext.

get

public function get(String/HTMLElement/Element el)

Static method to retreive Element objects. Uses simple caching to consistently return the same object. Automatically fixes if an object was recreated with the same id via AJAX or DOM. Shorthand of Ext.Element.get

Parameters:

el : String/HTMLElement/Element
The id of the node, a DOM Node or an existing Element.

Returns:

Element
The Element object

This method is defined by Ext.

getDom

public function getDom(String/HTMLElement/Element) el)

Return the dom node for the passed string (id), dom node, or Ext.Element

Parameters:

el : String/HTMLElement/Element)

Returns:

HTMLElement

This method is defined by Ext.

id

public function id([String/HTMLElement/Element el], [String prefix])

Generates unique ids. If the element already has an id, it is unchanged

Parameters:

el : String/HTMLElement/Element
(optional) The element to generate an id for
prefix : String
(optional) Id prefix (defaults "ext-gen")

Returns:

void

This method is defined by Ext.

namespace

public function namespace(String namespace1, String namespace2, String etc)

Creates namespaces but does not assume YAHOO is the root.

Parameters:

namespace1 : String
namespace2 : String
etc : String

Returns:

void

This method is defined by Ext.

onReady

public function onReady(Function fn, Object scope, boolean override)

Fires when the document is ready (before onload and before images are loaded). Shorthand of Ext.EventManager.onDocumentReady.

Parameters:

fn : Function
The method the event invokes
scope : Object
An object that becomes the scope of the handler
override : boolean
If true, the obj passed in becomes the execution scope of the listener

Returns:

void

This method is defined by Ext.

query

public function query(String path, [Node root])

Selects an array of DOM nodes by CSS/XPath selector. Shorthand of Ext.DomQuery.select

Parameters:

path : String
The selector/xpath query
root : Node
(optional) The start of the query (defaults to document).

Returns:

Array

This method is defined by Ext.

select

public function select(String/Array selector, [Boolean unique])

Selects elements based on the passed CSS selector to enable working on them as 1.

Parameters:

selector : String/Array
The CSS selector or an array of elements
unique : Boolean
(optional) true to create a unique Ext.Element for each element (defaults to a shared flyweight object)

Returns:

CompositeElementLite/CompositeElement

This method is defined by Ext.

urlDecode

public function urlDecode(String string, [Boolean overwrite])

Takes an encoded URL and and converts it to an object. e.g. Ext.urlDecode("foo=1&bar=2"); would return {foo: 1, bar: 2} or Ext.urlDecode("foo=1&bar=2&bar=3&bar=4", true); would return {foo: 1, bar: [2, 3, 4]}.

Parameters:

string : String
overwrite : Boolean
(optional) Items of the same name will overwrite previous values instead of creating an an array (Defaults to false).

Returns:

Object
A literal with members

This method is defined by Ext.

urlEncode

public function urlEncode(Object o)

Takes an object and converts it to an encoded URL. e.g. Ext.urlEncode({foo: 1, bar: 2}); would return "foo=1&bar=2". Optionally, property values can be arrays, instead of keys and the resulting string that's returned will contain a name/value pair for each array value.

Parameters:

o : Object

Returns:

String

This method is defined by Ext.