Class Ext.MasterTemplate

Package:	Ext
Class:	MasterTemplate
Extends:	Template
Defined In:	Template.js

Provides a template that can have child templates. The syntax is:

var t = new Ext.MasterTemplate(
	'<select name="{name}">',
		'<tpl name="options"><option value="{value:trim}">{text:ellipsis(10)}</option></tpl>',
	'</select>'
);
t.add('options', {value: 'foo', text: 'bar'});
// or you can add multiple child elements in one shot
t.addAll('options', [
    {value: 'foo', text: 'bar'},
    {value: 'foo2', text: 'bar2'},
    {value: 'foo3', text: 'bar3'}
]);
// then append, applying the master template values
t.append('my-form', {name: 'my-select'});

A name attribute for the child template is not required if you have only one child template or you want to refer to them by index.

属性 - 方法 - 事件

公共属性

属性		定义对象
	disableFormats : Boolean	Template
	True to disable format functions (default to false)	Template
	re : RegExp	Template
	The regular expression used to match template variables	Template
	subTemplateRe : RegExp	MasterTemplate
	The regular expression used to match sub templates	MasterTemplate

公共方法

方法		定义对象
	MasterTemplate.from(`String/HTMLElement el`) : void	MasterTemplate
	<static> Creates a template from the passed element's value (display:none textarea, preferred) or innerHTML. e....	MasterTemplate
	add([`String/Number name`], `Array/Object values`) : MasterTemplate	MasterTemplate
	Applies the passed values to a child template.	MasterTemplate
	addAll() : void	MasterTemplate
	Alias for fill().	MasterTemplate
	append(`String/HTMLElement/Element el`, `Object values`, [`Boolean returnElement`]) : HTMLElement	Template
	Applies the supplied values to the template and append the new node(s) to el	Template
	apply() : void	Template
	Alias for applyTemplate	Template
	applyTemplate(`Object values`) : String	Template
	Returns an HTML fragment of this template with the specified values applied	Template
	compile() : void	Template
	Compiles the template into an internal function, eliminating the RegEx overhead	Template
	fill([`String/Number name`], `Array values`, [`Boolean reset`]) : MasterTemplate	MasterTemplate
	Applies all the passed values to a child template.	MasterTemplate
	insertAfter(`String/HTMLElement/Element el`, `Object values`, [`Boolean returnElement`]) : HTMLElement	Template
	Applies the supplied values to the template and inserts the new node(s) after el	Template
	insertBefore(`String/HTMLElement/Element el`, `Object values`, [`Boolean returnElement`]) : HTMLElement	Template
	Applies the supplied values to the template and inserts the new node(s) before el	Template
	insertFirst(`String/HTMLElement/Element el`, `Object values`, [`Boolean returnElement`]) : HTMLElement	Template
	Applies the supplied values to the template and inserts the new node(s) as the first child of el	Template
	overwrite(`String/HTMLElement/Element el`, `Object values`, [`Boolean returnElement`]) : HTMLElement	Template
	Applies the supplied values to the template and overwrites the content of el with the new node(s)	Template
	reset() : MasterTemplate	MasterTemplate
	Resets the template for reuse	MasterTemplate
	set(`String html`, [`Boolean compile`]) : Template	Template
	Sets the html used as the template and optionally compiles it	Template

公共事件

此类没有公共事件。

属性详情

disableFormats

public Boolean disableFormats

True to disable format functions (default to false)

This property is defined by Template.

re

public RegExp re

The regular expression used to match template variables

This property is defined by Template.

subTemplateRe

public RegExp subTemplateRe

The regular expression used to match sub templates

This property is defined by MasterTemplate.

方法详情

MasterTemplate.from

public function MasterTemplate.from(String/HTMLElement el)

<static> Creates a template from the passed element's value (display:none textarea, preferred) or innerHTML. e.g. var tpl = Ext.MasterTemplate.from('element-id');

参数：

el : String/HTMLElement

返回：

void

This method is defined by MasterTemplate.

add

public function add([String/Number name], Array/Object values)

Applies the passed values to a child template.

参数：

name : String/Number
（可选） The name or index of the child template
values : Array/Object
The values to be applied to the template

返回：

MasterTemplate
this

This method is defined by MasterTemplate.

addAll

public function addAll()

Alias for fill().

参数：

无。

返回：

void

This method is defined by MasterTemplate.

append

public function append(String/HTMLElement/Element el, Object values, [Boolean returnElement])

Applies the supplied values to the template and append the new node(s) to el

参数：

el : String/HTMLElement/Element
The context element
values : Object
The template values. Can be an array if your params are numeric (i.e. {0}) or an object (i.e. {foo: 'bar'})
returnElement : Boolean
（可选） true to return a Ext.Element

返回：

HTMLElement
The new node

This method is defined by Template.

apply

public function apply()

Alias for applyTemplate

参数：

无。

返回：

void

This method is defined by Template.

applyTemplate

public function applyTemplate(Object values)

Returns an HTML fragment of this template with the specified values applied

参数：

values : Object
The template values. Can be an array if your params are numeric (i.e. {0}) or an object (i.e. {foo: 'bar'})

返回：

String

This method is defined by Template.

compile

public function compile()

Compiles the template into an internal function, eliminating the RegEx overhead

参数：

无。

返回：

void

This method is defined by Template.

fill

public function fill([String/Number name], Array values, [Boolean reset])

Applies all the passed values to a child template.

参数：

name : String/Number
（可选） The name or index of the child template
values : Array
The values to be applied to the template, this should be an array of objects.
reset : Boolean
（可选） True to reset the template first

返回：

MasterTemplate
this

This method is defined by MasterTemplate.

insertAfter

public function insertAfter(String/HTMLElement/Element el, Object values, [Boolean returnElement])

Applies the supplied values to the template and inserts the new node(s) after el

参数：

el : String/HTMLElement/Element
The context element
values : Object
The template values. Can be an array if your params are numeric (i.e. {0}) or an object (i.e. {foo: 'bar'})
returnElement : Boolean
（可选） true to return a Ext.Element

返回：

HTMLElement
The new node

This method is defined by Template.

insertBefore

public function insertBefore(String/HTMLElement/Element el, Object values, [Boolean returnElement])

Applies the supplied values to the template and inserts the new node(s) before el

参数：

el : String/HTMLElement/Element
The context element
values : Object
The template values. Can be an array if your params are numeric (i.e. {0}) or an object (i.e. {foo: 'bar'})
returnElement : Boolean
（可选） true to return a Ext.Element

返回：

HTMLElement
The new node

This method is defined by Template.

insertFirst

public function insertFirst(String/HTMLElement/Element el, Object values, [Boolean returnElement])

Applies the supplied values to the template and inserts the new node(s) as the first child of el

参数：

el : String/HTMLElement/Element
The context element
values : Object
The template values. Can be an array if your params are numeric (i.e. {0}) or an object (i.e. {foo: 'bar'})
returnElement : Boolean
（可选） true to return a Ext.Element

返回：

HTMLElement
The new node

This method is defined by Template.

overwrite

public function overwrite(String/HTMLElement/Element el, Object values, [Boolean returnElement])

Applies the supplied values to the template and overwrites the content of el with the new node(s)

参数：

el : String/HTMLElement/Element
The context element
values : Object
The template values. Can be an array if your params are numeric (i.e. {0}) or an object (i.e. {foo: 'bar'})
returnElement : Boolean
（可选） true to return a Ext.Element

返回：

HTMLElement
The new node

This method is defined by Template.

reset

public function reset()

Resets the template for reuse

参数：

无。

返回：

MasterTemplate
this

This method is defined by MasterTemplate.

set

public function set(String html, [Boolean compile])

Sets the html used as the template and optionally compiles it

参数：

html : String
compile : Boolean
（可选）

返回：

Template
this

This method is defined by Template.