Tags
Note
Tags, or Air Tags, are explained in the concepts document about tags.
Adds s-expression HTML tags to air.
Tag
Tag(*children, **kwargs)
Sets four attributes, name, module, children, and attrs. These are important for Starlette view responses, as nested objects get auto-serialized to JSON and need to be rebuilt. Without the values of these attributes, the object reconstruction can't occur
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
CaseTag
CaseTag(*children, **kwargs)
Bases: Tag
This is for case-sensitive tags like those used in SVG generation.
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
SafeStr
Bases: str
A string subclass that doesn't trigger html.escape() when called by Tag.render()
Example
sample = SafeStr('Hello, world')
Html
Html(*children, **kwargs)
Bases: Tag
Defines the root of an HTML document
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
RawHTML
RawHTML(*args, **kwargs)
Bases: Tag
Renders raw HTML content without escaping.
Parameters:
Name | Type | Description | Default |
---|---|---|---|
html_string
|
A single string containing raw HTML to render |
required |
Raises:
Type | Description |
---|---|
TypeError
|
If non-string content is provided |
ValueError
|
If multiple arguments are provided |
Example
RawHTML('Bold text') 'Bold text'
Use with other tags
Div( ... P("Safe content"), ... RawHTML('
'), ... P("More safe content") ... )
Initialize RawHTML with a single string argument.
Parameters:
Name | Type | Description | Default |
---|---|---|---|
*args
|
Should be exactly one string argument |
()
|
|
**kwargs
|
Ignored (for consistency with Tag interface) |
{}
|
Source code in src/air/tags.py
174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 |
|
render
render()
Render the raw HTML string without escaping.
Source code in src/air/tags.py
191 192 193 |
|
NoEscapeTag
NoEscapeTag(*children, **kwargs)
Bases: Tag
Custom tag that does not escape its children.
This is used for tags like Script and Style where content should not be HTML-escaped.
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
render
render()
Render the tag with unescaped content.
Source code in src/air/tags.py
203 204 205 206 |
|
Script
Script(*children, **kwargs)
Bases: NoEscapeTag
Defines a client-side script
Warning: Script tag does not protect against code injection.
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Style
Style(*children, **kwargs)
Bases: NoEscapeTag
Defines style information for a document
Warning: Style tag does not protect against code injection.
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
A
A(*children, **kwargs)
Bases: Tag
Defines a hyperlink
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Abbr
Abbr(*children, **kwargs)
Bases: Tag
Defines an abbreviation or an acronym
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Address
Address(*children, **kwargs)
Bases: Tag
Defines contact information for the author/owner of a document
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Area
Area(*children, **kwargs)
Bases: Tag
Defines an area inside an image map
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Article
Article(*children, **kwargs)
Bases: Tag
Defines an article
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Aside
Aside(*children, **kwargs)
Bases: Tag
Defines content aside from the page content
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Audio
Audio(*children, **kwargs)
Bases: Tag
Defines embedded sound content
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
B
B(*children, **kwargs)
Bases: Tag
Defines bold text
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Base
Base(*children, **kwargs)
Bases: Tag
Specifies the base URL/target for all relative URLs in a document
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Bdi
Bdi(*children, **kwargs)
Bases: Tag
Isolates a part of text that might be formatted in a different direction from other text outside it
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Bdo
Bdo(*children, **kwargs)
Bases: Tag
Overrides the current text direction
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Blockquote
Blockquote(*children, **kwargs)
Bases: Tag
Defines a section that is quoted from another source
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Body
Body(*children, **kwargs)
Bases: Tag
Defines the document's body
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Br
Br(*children, **kwargs)
Bases: Tag
Defines a single line break
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Button
Button(*children, **kwargs)
Bases: Tag
Defines a clickable button
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Canvas
Canvas(*children, **kwargs)
Bases: Tag
Used to draw graphics, on the fly, via scripting (usually JavaScript)
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Caption
Caption(*children, **kwargs)
Bases: Tag
Defines a table caption
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Cite
Cite(*children, **kwargs)
Bases: Tag
Defines the title of a work
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Code
Code(*children, **kwargs)
Bases: Tag
Defines a piece of computer code
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Col
Col(*children, **kwargs)
Bases: Tag
Specifies column properties for each column within a
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Colgroup
Colgroup(*children, **kwargs)
Bases: Tag
Specifies a group of one or more columns in a table for formatting
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Data
Data(*children, **kwargs)
Bases: Tag
Adds a machine-readable translation of a given content
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Datalist
Datalist(*children, **kwargs)
Bases: Tag
Specifies a list of pre-defined options for input controls
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Dd
Dd(*children, **kwargs)
Bases: Tag
Defines a description/value of a term in a description list
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Del
Del(*children, **kwargs)
Bases: Tag
Defines text that has been deleted from a document
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Details
Details(*children, **kwargs)
Bases: Tag
Defines additional details that the user can view or hide
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Dfn
Dfn(*children, **kwargs)
Bases: Tag
Specifies a term that is going to be defined within the content
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Dialog
Dialog(*children, **kwargs)
Bases: Tag
Defines a dialog box or window
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Div
Div(*children, **kwargs)
Bases: Tag
Defines a section in a document
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Dl
Dl(*children, **kwargs)
Bases: Tag
Defines a description list
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Dt
Dt(*children, **kwargs)
Bases: Tag
Defines a term/name in a description list
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Em
Em(*children, **kwargs)
Bases: Tag
Defines emphasized text
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Embed
Embed(*children, **kwargs)
Bases: Tag
Defines a container for an external application
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Fieldset
Fieldset(*children, **kwargs)
Bases: Tag
Groups related elements in a form
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Figcaption
Figcaption(*children, **kwargs)
Bases: Tag
Defines a caption for a
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Figure
Figure(*children, **kwargs)
Bases: Tag
Specifies self-contained content
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Footer
Footer(*children, **kwargs)
Bases: Tag
Defines a footer for a document or section
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Form
Form(*children, **kwargs)
Bases: Tag
Defines an HTML form for user input
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
H1
H1(*children, **kwargs)
Bases: Tag
H1 header
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
H2
H2(*children, **kwargs)
Bases: Tag
H2 header
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
H3
H3(*children, **kwargs)
Bases: Tag
H3 header
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
H4
H4(*children, **kwargs)
Bases: Tag
H4 header
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
H5
H5(*children, **kwargs)
Bases: Tag
H5 header
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
H6
H6(*children, **kwargs)
Bases: Tag
H6 header
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Head
Head(*children, **kwargs)
Bases: Tag
Contains metadata/information for the document
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Header
Header(*children, **kwargs)
Bases: Tag
Defines a header for a document or section
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Hgroup
Hgroup(*children, **kwargs)
Bases: Tag
Defines a header and related content
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Hr
Hr(*children, **kwargs)
Bases: Tag
Defines a thematic change in the content
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
I
I(*children, **kwargs)
Bases: Tag
Defines a part of text in an alternate voice or mood
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Iframe
Iframe(*children, **kwargs)
Bases: Tag
Defines an inline frame
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Img
Img(*children, **kwargs)
Bases: Tag
Defines an image
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Input
Input(*children, **kwargs)
Bases: Tag
Defines an input control
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Ins
Ins(*children, **kwargs)
Bases: Tag
Defines a text that has been inserted into a document
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Kbd
Kbd(*children, **kwargs)
Bases: Tag
Defines keyboard input
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Label
Label(*children, **kwargs)
Bases: Tag
Defines a label for an element
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Li
Li(*children, **kwargs)
Bases: Tag
Defines a list item
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Link
Link(*children, **kwargs)
Bases: Tag
Defines the relationship between a document and an external resource (most used to link to style sheets)
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Main
Main(*children, **kwargs)
Bases: Tag
Specifies the main content of a document
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Map
Map(*children, **kwargs)
Bases: Tag
Defines an image map
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Mark
Mark(*children, **kwargs)
Bases: Tag
Defines marked/highlighted text
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Menu
Menu(*children, **kwargs)
Bases: Tag
Defines an unordered list
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Meta
Meta(*children, **kwargs)
Bases: Tag
Defines metadata about an HTML document
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Meter
Meter(*children, **kwargs)
Bases: Tag
Defines a scalar measurement within a known range (a gauge)
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Nav
Nav(*children, **kwargs)
Bases: Tag
Defines navigation links
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Noscript
Noscript(*children, **kwargs)
Bases: Tag
Defines an alternate content for users that do not support client-side scripts
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Object
Object(*children, **kwargs)
Bases: Tag
Defines a container for an external application
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Ol
Ol(*children, **kwargs)
Bases: Tag
Defines an ordered list
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Optgroup
Optgroup(*children, **kwargs)
Bases: Tag
Defines a group of related options in a drop-down list
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Option
Option(*children, **kwargs)
Bases: Tag
Defines an option in a drop-down list
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Output
Output(*children, **kwargs)
Bases: Tag
Defines the result of a calculation
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
P
P(*children, **kwargs)
Bases: Tag
Defines a paragraph
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Param
Param(*children, **kwargs)
Bases: Tag
Defines a parameter for an object
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Picture
Picture(*children, **kwargs)
Bases: Tag
Defines a container for multiple image resources
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Pre
Pre(*children, **kwargs)
Bases: Tag
Defines preformatted text
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Progress
Progress(*children, **kwargs)
Bases: Tag
Represents the progress of a task
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Q
Q(*children, **kwargs)
Bases: Tag
Defines a short quotation
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Rp
Rp(*children, **kwargs)
Bases: Tag
Defines what to show in browsers that do not support ruby annotations
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Rt
Rt(*children, **kwargs)
Bases: Tag
Defines an explanation/pronunciation of characters (for East Asian typography)
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Ruby
Ruby(*children, **kwargs)
Bases: Tag
Defines a ruby annotation (for East Asian typography)
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
S
S(*children, **kwargs)
Bases: Tag
Defines text that is no longer correct
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Samp
Samp(*children, **kwargs)
Bases: Tag
Defines sample output from a computer program
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Search
Search(*children, **kwargs)
Bases: Tag
Defines a search section
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Section
Section(*children, **kwargs)
Bases: Tag
Defines a section in a document
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Select
Select(*children, **kwargs)
Bases: Tag
Defines a drop-down list
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Small
Small(*children, **kwargs)
Bases: Tag
Defines smaller text
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Source
Source(*children, **kwargs)
Bases: Tag
Defines multiple media resources for media elements (
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Span
Span(*children, **kwargs)
Bases: Tag
Defines a section in a document
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Strong
Strong(*children, **kwargs)
Bases: Tag
Defines important text
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Sub
Sub(*children, **kwargs)
Bases: Tag
Defines subscripted text
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Summary
Summary(*children, **kwargs)
Bases: Tag
Defines a visible heading for a
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Sup
Sup(*children, **kwargs)
Bases: Tag
Defines superscripted text
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Table
Table(*children, **kwargs)
Bases: Tag
Defines a table
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Tbody
Tbody(*children, **kwargs)
Bases: Tag
Groups the body content in a table
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Td
Td(*children, **kwargs)
Bases: Tag
Defines a cell in a table
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Template
Template(*children, **kwargs)
Bases: Tag
Defines a container for content that should be hidden when the page loads
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Textarea
Textarea(*children, **kwargs)
Bases: Tag
Defines a multiline input control (text area)
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Tfoot
Tfoot(*children, **kwargs)
Bases: Tag
Groups the footer content in a table
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Th
Th(*children, **kwargs)
Bases: Tag
Defines a header cell in a table
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Thead
Thead(*children, **kwargs)
Bases: Tag
Groups the header content in a table
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Time
Time(*children, **kwargs)
Bases: Tag
Defines a specific time (or datetime)
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Title
Title(*children, **kwargs)
Bases: Tag
Defines a title for the document
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Tr
Tr(*children, **kwargs)
Bases: Tag
Defines a row in a table
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Track
Track(*children, **kwargs)
Bases: Tag
Defines text tracks for media elements (
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
U
U(*children, **kwargs)
Bases: Tag
Defines some text that is unarticulated and styled differently from normal text
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Ul
Ul(*children, **kwargs)
Bases: Tag
Defines an unordered list
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Var
Var(*children, **kwargs)
Bases: Tag
Defines a variable
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Video
Video(*children, **kwargs)
Bases: Tag
Defines embedded video content
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
Wbr
Wbr(*children, **kwargs)
Bases: Tag
Defines a possible line-break
Source code in src/air/tags.py
70 71 72 73 74 75 76 77 |
|
clean_html_attr_key
clean_html_attr_key(key)
Clean up HTML attribute keys to match the standard W3C HTML spec.
Parameters:
Name | Type | Description | Default |
---|---|---|---|
key
|
str
|
An uncleaned HTML attribute key |
required |
Returns:
Cleaned HTML attribute key
Source code in src/air/tags.py
52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 |
|