Components

Using built-in components

You can import any standard HTML components from the view.components module:

from view.components import html, title, head, body, h1
from view import new_app

app = new_app()

@app.get("/")
async def index():
    return html(
        head(
            title("Hello, view.py!"),
        ),
        body(
            h1("This is my website!"),
        ),
    )

app.run()

The above would translate to the following HTML snippet:

<html>
    <head>
    <title>Hello, view.py!</title>
    <body>
        <h1>This is my website!</h1>
    </body>
</html>

Children

You can pass an infinite number of children to a component, and it will be translated to the proper HTML:

div(p("a"), p("b"), p("c"))

Would translate to:

<div>
    <p>a</p>
    <p>b</p>
    <p>c</p>
</div>

Attributes

All built in components come with their respected attributes, per the HTML specification:

@app.get("/")
async def index():
    return html(lang="en")

Classes

Since the class keyword is reserved in Python, view.py uses the parameter name cls instead:

div(cls="hello")

Custom Components

There's no need for any fancy mechanics when making a custom component, so you can just use a normal function:

def my_header(content: str):
    return div(h1(content))

Running

Parameters