express.ui.TagList

express.ui.TagList(self, *args)

Create an HTML tag list (i.e., a fragment of HTML)

Parameters

*args : TagChild = ()

The tag children to add to the list.

Examples

>>> from htmltools import TagList, div
>>> TagList("hello", div(id="foo", class_="bar"))
hello
<div id="foo" class="bar"></div>

Methods

Name Description
append Append tag children to the end of the list.
extend Extend the children by appending an iterable of children.
get_dependencies Get any dependencies needed to render the HTML.
get_html_string Return the HTML string for this tag list.
insert Insert tag children before a given index.
render Get string representation as well as its HTML dependencies.
save_html Save to a HTML file.
show Preview as a complete HTML document.
tagify Convert any tagifiable children to Tag/TagList objects.

append

express.ui.TagList.append(item, *args)

Append tag children to the end of the list.

extend

express.ui.TagList.extend(other)

Extend the children by appending an iterable of children.

get_dependencies

express.ui.TagList.get_dependencies(dedup=True)

Get any dependencies needed to render the HTML.

Parameters

dedup : bool = True

Whether to deduplicate the dependencies.

get_html_string

express.ui.TagList.get_html_string(
    indent=0,
    eol='\n',
    *,
    add_ws=True,
    _escape_strings=True,
)

Return the HTML string for this tag list.

Parameters

indent : int = 0

Number of spaces to indent each line of the HTML.

eol : str = ''

End-of-line character(s).

add_ws : bool = True

Whether to add whitespace between the opening tag and the first child. If either this is True, or the child’s add_ws attribute is True, then whitespace will be added; if they are both False, then no whitespace will be added.

insert

express.ui.TagList.insert(i, item)

Insert tag children before a given index.

render

express.ui.TagList.render()

Get string representation as well as its HTML dependencies.

save_html

express.ui.TagList.save_html(file, *, libdir='lib', include_version=True)

Save to a HTML file.

Parameters

file : str

The file to save to.

libdir : Optional[str] = 'lib'

The directory to save the dependencies to.

include_version : bool = True

Whether to include the version number in the dependency folder name.

Returns

: str

The path to the generated HTML file.

show

express.ui.TagList.show(renderer='auto')

Preview as a complete HTML document.

Parameters

renderer : Literal[‘auto’, ‘ipython’, ‘browser’] = 'auto'

The renderer to use.

tagify

express.ui.TagList.tagify()

Convert any tagifiable children to Tag/TagList objects.