Docs for DIV
Description
<type 'type'> extends (<class 'gluon.html.XmlComponent'>,)
|
Attributes
DIV.__add__ |
<type 'instancemethod'>
belongs to class <type 'instancemethod'>
|
DIV.__class__ |
<type 'type'> extends (<type 'object'>,)
belongs to class <type 'type'>
type(object) -> the object's type type(name, bases, dict) -> a new type |
DIV.__delattr__ |
<type 'wrapper_descriptor'>
belongs to class <type 'wrapper_descriptor'>
x.__delattr__('name') <==> del x.name |
DIV.__delitem__ |
<type 'instancemethod'>
belongs to class <type 'instancemethod'>
Deletes attribute with name 'i' or component #i. Args: i: index. If i is a string: the name of the attribute otherwise references to number of the component |
DIV.__dict__ |
<type 'dictproxy'>
belongs to class <type 'dictproxy'>
|
DIV.__doc__ |
<type 'str'>
belongs to class <type 'str'>
str(object='') -> string Return a nice string representation of the object. If the argument is a string, the return value is the same object. |
DIV.__format__ |
<type 'method_descriptor'>
belongs to class <type 'method_descriptor'>
default object formatter |
DIV.__getattribute__ |
<type 'wrapper_descriptor'>
belongs to class <type 'wrapper_descriptor'>
x.__getattribute__('name') <==> x.name |
DIV.__getitem__ |
<type 'instancemethod'>
belongs to class <type 'instancemethod'>
Gets attribute with name 'i' or component #i. If attribute 'i' is not found returns None Args: i: index. If i is a string: the name of the attribute otherwise references to number of the component |
DIV.__hash__ |
<type 'wrapper_descriptor'>
belongs to class <type 'wrapper_descriptor'>
x.__hash__() <==> hash(x) |
DIV.__init__ |
<type 'instancemethod'>
belongs to class <type 'instancemethod'>
Args: components: any components that should be nested in this element attributes: any attributes you want to give to this element Raises: SyntaxError: when a stand alone tag receives components |
DIV.__len__ |
<type 'instancemethod'>
belongs to class <type 'instancemethod'>
Returns the number of included components |
DIV.__module__ |
<type 'str'>
belongs to class <type 'str'>
str(object='') -> string Return a nice string representation of the object. If the argument is a string, the return value is the same object. |
DIV.__mul__ |
<type 'instancemethod'>
belongs to class <type 'instancemethod'>
|
DIV.__new__ |
<type 'builtin_function_or_method'>
belongs to class <type 'builtin_function_or_method'>
T.__new__(S, ...) -> a new object with type S, a subtype of T |
DIV.__nonzero__ |
<type 'instancemethod'>
belongs to class <type 'instancemethod'>
Always returns True |
DIV.__reduce__ |
<type 'method_descriptor'>
belongs to class <type 'method_descriptor'>
helper for pickle |
DIV.__reduce_ex__ |
<type 'method_descriptor'>
belongs to class <type 'method_descriptor'>
helper for pickle |
DIV.__repr__ |
<type 'wrapper_descriptor'>
belongs to class <type 'wrapper_descriptor'>
x.__repr__() <==> repr(x) |
DIV.__setattr__ |
<type 'wrapper_descriptor'>
belongs to class <type 'wrapper_descriptor'>
x.__setattr__('name', value) <==> x.name = value |
DIV.__setitem__ |
<type 'instancemethod'>
belongs to class <type 'instancemethod'>
Sets attribute with name 'i' or component #i. Args: i: index. If i is a string: the name of the attribute otherwise references to number of the component value: the new value |
DIV.__sizeof__ |
<type 'method_descriptor'>
belongs to class <type 'method_descriptor'>
__sizeof__() -> int size of object in memory, in bytes |
DIV.__str__ |
<type 'instancemethod'>
belongs to class <type 'instancemethod'>
str(COMPONENT) returns COMPONENT.xml() |
DIV.__subclasshook__ |
<type 'builtin_function_or_method'>
belongs to class <type 'builtin_function_or_method'>
Abstract classes can override this to customize issubclass(). This is invoked early on by abc.ABCMeta.__subclasscheck__(). It should return True, False or NotImplemented. If it returns NotImplemented, the normal algorithm is used. Otherwise, it overrides the normal algorithm (and the outcome is cached). |
DIV.__weakref__ |
<type 'getset_descriptor'>
belongs to class <type 'getset_descriptor'>
list of weak references to the object (if defined) |
DIV._fixup |
<type 'instancemethod'>
belongs to class <type 'instancemethod'>
Handling of provided components. Nothing to fixup yet. May be overridden by subclasses, eg for wrapping some components in another component or blocking them. |
DIV._postprocessing |
<type 'instancemethod'>
belongs to class <type 'instancemethod'>
Handling of attributes (normally the ones not prefixed with '_'). Nothing to postprocess yet. May be overridden by subclasses |
DIV._setnode |
<type 'instancemethod'>
belongs to class <type 'instancemethod'>
|
DIV._traverse |
<type 'instancemethod'>
belongs to class <type 'instancemethod'>
|
DIV._validate |
<type 'instancemethod'>
belongs to class <type 'instancemethod'>
nothing to validate yet. May be overridden by subclasses |
DIV._wrap_components |
<type 'instancemethod'>
belongs to class <type 'instancemethod'>
helper for _fixup. Checks if a component is in allowed_parents, otherwise wraps it in wrap_parent Args: allowed_parents: (tuple) classes that the component should be an instance of wrap_parent: the class to wrap the component in, if needed wrap_lambda: lambda to use for wrapping, if needed |
DIV._xml |
<type 'instancemethod'>
belongs to class <type 'instancemethod'>
Helper for xml generation. Returns separately: - the component attributes - the generated xml of the inner components Component attributes start with an underscore ('_') and do not have a False or None value. The underscore is removed. A value of True is replaced with the attribute name. Returns: tuple: (attributes, components) |
DIV.add_class |
<type 'instancemethod'>
belongs to class <type 'instancemethod'>
add a class to _class attribute |
DIV.append |
<type 'instancemethod'>
belongs to class <type 'instancemethod'>
list style appending of components Examples: >>> a=DIV() >>> a.append(SPAN('x')) >>> print a <div><span>x</span></div> |
DIV.element |
<type 'instancemethod'>
belongs to class <type 'instancemethod'>
Finds the first component that matches the supplied attribute dictionary, or None if nothing could be found Also the components of the components are searched. |
DIV.elements |
<type 'instancemethod'>
belongs to class <type 'instancemethod'>
Find all components that match the supplied attribute dictionary, or None if nothing could be found All components of the components are searched. Examples: >>> a = DIV(DIV(SPAN('x'),3,DIV(SPAN('y')))) >>> for c in a.elements('span',first_only=True): c[0]='z' >>> print a <div><div><span>z</span>3<div><span>y</span></div></div></div> >>> for c in a.elements('span'): c[0]='z' >>> print a <div><div><span>z</span>3<div><span>z</span></div></div></div> It also supports a syntax compatible with jQuery Examples: >>> a=TAG('<div><span><a id="1-1" u:v=$>hello</a></span><p class="this is a test">world</p></div>') >>> for e in a.elements('div a#1-1, p.is'): print e.flatten() hello world >>> for e in a.elements('#1-1'): print e.flatten() hello >>> a.elements('a[u:v=$]')[0].xml() '<a id="1-1" u:v="$">hello</a>' >>> a=FORM( INPUT(_type='text'), SELECT(range(1)), TEXTAREA() ) >>> for c in a.elements('input, select, textarea'): c['_disabled'] = 'disabled' >>> a.xml() '<form action="#" enctype="multipart/form-data" method="post"><input disabled="disabled" type="text" /><select disabled="disabled"><option value="0">0</option></select><textarea cols="40" disabled="disabled" rows="10"></textarea></form>' Elements that are matched can also be replaced or removed by specifying a "replace" argument (note, a list of the original matching elements is still returned as usual). Examples: >>> a = DIV(DIV(SPAN('x', _class='abc'), DIV(SPAN('y', _class='abc'), SPAN('z', _class='abc')))) >>> b = a.elements('span.abc', replace=P('x', _class='xyz')) >>> print a <div><div><p class="xyz">x</p><div><p class="xyz">x</p><p class="xyz">x</p></div></div></div> "replace" can be a callable, which will be passed the original element and should return a new element to replace it. Examples: >>> a = DIV(DIV(SPAN('x', _class='abc'), DIV(SPAN('y', _class='abc'), SPAN('z', _class='abc')))) >>> b = a.elements('span.abc', replace=lambda el: P(el[0], _class='xyz')) >>> print a <div><div><p class="xyz">x</p><div><p class="xyz">y</p><p class="xyz">z</p></div></div></div> If replace=None, matching elements will be removed completely. Examples: >>> a = DIV(DIV(SPAN('x', _class='abc'), DIV(SPAN('y', _class='abc'), SPAN('z', _class='abc')))) >>> b = a.elements('span', find='y', replace=None) >>> print a <div><div><span class="abc">x</span><div><span class="abc">z</span></div></div></div> If a "find_text" argument is specified, elements will be searched for text components that match find_text, and any matching text components will be replaced (find_text is ignored if "replace" is not also specified). Like the "find" argument, "find_text" can be a string or a compiled regex. Examples: >>> a = DIV(DIV(SPAN('x', _class='abc'), DIV(SPAN('y', _class='abc'), SPAN('z', _class='abc')))) >>> b = a.elements(find_text=re.compile('x|y|z'), replace='hello') >>> print a <div><div><span class="abc">hello</span><div><span class="abc">hello</span><span class="abc">hello</span></div></div></div> If other attributes are specified along with find_text, then only components that match the specified attributes will be searched for find_text. Examples: >>> a = DIV(DIV(SPAN('x', _class='abc'), DIV(SPAN('y', _class='efg'), SPAN('z', _class='abc')))) >>> b = a.elements('span.efg', find_text=re.compile('x|y|z'), replace='hello') >>> print a <div><div><span class="abc">x</span><div><span class="efg">hello</span><span class="abc">z</span></div></div></div> |
DIV.flatten |
<type 'instancemethod'>
belongs to class <type 'instancemethod'>
Returns the text stored by the DIV object rendered by the render function the render function must take text, tagname, and attributes `render=None` is equivalent to `render=lambda text, tag, attr: text` Examples: >>> markdown = lambda text,tag=None,attributes={}: {None: re.sub('\s+',' ',text), 'h1':'#'+text+'\n\n', 'p':text+'\n'}.get(tag,text) >>> a=TAG('<h1>Header</h1><p>this is a test</p>') >>> a.flatten(markdown) '#Header\n\nthis is a test\n' |
DIV.insert |
<type 'instancemethod'>
belongs to class <type 'instancemethod'>
List-style inserting of components Examples: >>> a=DIV() >>> a.insert(0,SPAN('x')) >>> print a <div><span>x</span></div> |
DIV.regex_attr |
<type '_sre.SRE_Pattern'>
belongs to class <type '_sre.SRE_Pattern'>
Compiled regular expression objects |
DIV.regex_class |
<type '_sre.SRE_Pattern'>
belongs to class <type '_sre.SRE_Pattern'>
Compiled regular expression objects |
DIV.regex_id |
<type '_sre.SRE_Pattern'>
belongs to class <type '_sre.SRE_Pattern'>
Compiled regular expression objects |
DIV.regex_tag |
<type '_sre.SRE_Pattern'>
belongs to class <type '_sre.SRE_Pattern'>
Compiled regular expression objects |
DIV.remove_class |
<type 'instancemethod'>
belongs to class <type 'instancemethod'>
remove a class from _class attribute |
DIV.sibling |
<type 'instancemethod'>
belongs to class <type 'instancemethod'>
Finds the first sibling component that match the supplied argument list and attribute dictionary, or None if nothing could be found |
DIV.siblings |
<type 'instancemethod'>
belongs to class <type 'instancemethod'>
Finds all sibling components that match the supplied argument list and attribute dictionary, or None if nothing could be found |
DIV.tag |
<type 'str'>
belongs to class <type 'str'>
str(object='') -> string Return a nice string representation of the object. If the argument is a string, the return value is the same object. |
DIV.update |
<type 'instancemethod'>
belongs to class <type 'instancemethod'>
dictionary like updating of the tag attributes |
DIV.xml |
<type 'instancemethod'>
belongs to class <type 'instancemethod'>
generates the xml for this component. |