Spaces:
Sleeping
Sleeping
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head> | |
<meta charset="utf-8"> | |
<meta name="generator" content="quarto-1.6.40"> | |
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes"> | |
<meta name="description" content="Simple SVG FT elements"> | |
<title>SVG – fasthtml</title> | |
<style> | |
code{white-space: pre-wrap;} | |
span.smallcaps{font-variant: small-caps;} | |
div.columns{display: flex; gap: min(4vw, 1.5em);} | |
div.column{flex: auto; overflow-x: auto;} | |
div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;} | |
ul.task-list{list-style: none;} | |
ul.task-list li input[type="checkbox"] { | |
width: 0.8em; | |
margin: 0 0.8em 0.2em -1em; /* quarto-specific, see https://github.com/quarto-dev/quarto-cli/issues/4556 */ | |
vertical-align: middle; | |
} | |
/* CSS for syntax highlighting */ | |
pre > code.sourceCode { white-space: pre; position: relative; } | |
pre > code.sourceCode > span { line-height: 1.25; } | |
pre > code.sourceCode > span:empty { height: 1.2em; } | |
.sourceCode { overflow: visible; } | |
code.sourceCode > span { color: inherit; text-decoration: inherit; } | |
div.sourceCode { margin: 1em 0; } | |
pre.sourceCode { margin: 0; } | |
@media screen { | |
div.sourceCode { overflow: auto; } | |
} | |
@media print { | |
pre > code.sourceCode { white-space: pre-wrap; } | |
pre > code.sourceCode > span { display: inline-block; text-indent: -5em; padding-left: 5em; } | |
} | |
pre.numberSource code | |
{ counter-reset: source-line 0; } | |
pre.numberSource code > span | |
{ position: relative; left: -4em; counter-increment: source-line; } | |
pre.numberSource code > span > a:first-child::before | |
{ content: counter(source-line); | |
position: relative; left: -1em; text-align: right; vertical-align: baseline; | |
border: none; display: inline-block; | |
-webkit-touch-callout: none; -webkit-user-select: none; | |
-khtml-user-select: none; -moz-user-select: none; | |
-ms-user-select: none; user-select: none; | |
padding: 0 4px; width: 4em; | |
} | |
pre.numberSource { margin-left: 3em; padding-left: 4px; } | |
div.sourceCode | |
{ } | |
@media screen { | |
pre > code.sourceCode > span > a:first-child::before { text-decoration: underline; } | |
} | |
</style> | |
<script src="https://cdnjs.cloudflare.com/ajax/libs/jquery/3.5.1/jquery.min.js" integrity="sha512-bLT0Qm9VnAYZDflyKcBaQ2gg0hSYNQrJ8RilYldYQ1FxQYoCLtUjuuRuZo+fjqhx/qtq/1itJ0C2ejDxltZVFg==" crossorigin="anonymous"></script><script src="../site_libs/quarto-nav/quarto-nav.js"></script> | |
<script src="../site_libs/quarto-nav/headroom.min.js"></script> | |
<script src="../site_libs/clipboard/clipboard.min.js"></script> | |
<script src="../site_libs/quarto-search/autocomplete.umd.js"></script> | |
<script src="../site_libs/quarto-search/fuse.min.js"></script> | |
<script src="../site_libs/quarto-search/quarto-search.js"></script> | |
<meta name="quarto:offset" content="../"> | |
<link href="../favicon.ico" rel="icon"> | |
<script src="../site_libs/quarto-html/quarto.js"></script> | |
<script src="../site_libs/quarto-html/popper.min.js"></script> | |
<script src="../site_libs/quarto-html/tippy.umd.min.js"></script> | |
<script src="../site_libs/quarto-html/anchor.min.js"></script> | |
<link href="../site_libs/quarto-html/tippy.css" rel="stylesheet"> | |
<link href="../site_libs/quarto-html/quarto-syntax-highlighting-549806ee2085284f45b00abea8c6df48.css" rel="stylesheet" id="quarto-text-highlighting-styles"> | |
<script src="../site_libs/bootstrap/bootstrap.min.js"></script> | |
<link href="../site_libs/bootstrap/bootstrap-icons.css" rel="stylesheet"> | |
<link href="../site_libs/bootstrap/bootstrap-e463c5e664eae906a5c2eb38a07ecc3d.min.css" rel="stylesheet" append-hash="true" id="quarto-bootstrap" data-mode="light"> | |
<script id="quarto-search-options" type="application/json">{ | |
"location": "navbar", | |
"copy-button": false, | |
"collapse-after": 3, | |
"panel-placement": "end", | |
"type": "overlay", | |
"limit": 50, | |
"keyboard-shortcut": [ | |
"f", | |
"/", | |
"s" | |
], | |
"show-item-context": false, | |
"language": { | |
"search-no-results-text": "No results", | |
"search-matching-documents-text": "matching documents", | |
"search-copy-link-title": "Copy link to search", | |
"search-hide-matches-text": "Hide additional matches", | |
"search-more-match-text": "more match in this document", | |
"search-more-matches-text": "more matches in this document", | |
"search-clear-button-title": "Clear", | |
"search-text-placeholder": "", | |
"search-detached-cancel-button-title": "Cancel", | |
"search-submit-button-title": "Submit", | |
"search-label": "Search" | |
} | |
}</script> | |
<script src="https://cdnjs.cloudflare.com/ajax/libs/require.js/2.3.6/require.min.js" integrity="sha512-c3Nl8+7g4LMSTdrm621y7kf9v3SDPnhxLNhcjFJbKECVnmZHTdo+IRO05sNLTH/D3vA6u1X32ehoLC7WFVdheg==" crossorigin="anonymous"></script> | |
<script type="application/javascript">define('jquery', [],function() {return window.jQuery;})</script> | |
<link rel="stylesheet" href="../styles.css"> | |
<meta property="og:title" content="SVG – fasthtml"> | |
<meta property="og:description" content="Simple SVG FT elements"> | |
<meta property="og:site_name" content="fasthtml"> | |
<meta name="twitter:title" content="SVG – fasthtml"> | |
<meta name="twitter:description" content="Simple SVG FT elements"> | |
<meta name="twitter:image" content="https://www.fastht.ml/docs/og-image.png"> | |
<meta name="twitter:creator" content="@jeremyphoward"> | |
<meta name="twitter:site" content="@answerdotai"> | |
<meta name="twitter:card" content="summary_large_image"> | |
<link rel="canonical" href="https://www.fastht.ml/docs/api/svg.html"> | |
</head> | |
<body class="nav-sidebar floating nav-fixed"> | |
<div id="quarto-search-results"></div> | |
<header id="quarto-header" class="headroom fixed-top"> | |
<nav class="navbar navbar-expand-lg " data-bs-theme="dark"> | |
<div class="navbar-container container-fluid"> | |
<div class="navbar-brand-container mx-auto"> | |
<a href="../index.html" class="navbar-brand navbar-brand-logo"> | |
<img src="../logo.svg" alt="" class="navbar-logo"> | |
</a> | |
</div> | |
<div id="quarto-search" class="" title="Search"></div> | |
<button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarCollapse" aria-controls="navbarCollapse" role="menu" aria-expanded="false" aria-label="Toggle navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }"> | |
<span class="navbar-toggler-icon"></span> | |
</button> | |
<div class="collapse navbar-collapse" id="navbarCollapse"> | |
<ul class="navbar-nav navbar-nav-scroll me-auto"> | |
<li class="nav-item"> | |
<a class="nav-link" href="https://fastht.ml"> | |
<span class="menu-text">Home</span></a> | |
</li> | |
<li class="nav-item"> | |
<a class="nav-link" href="https://fastht.ml/about"> | |
<span class="menu-text">Learn</span></a> | |
</li> | |
</ul> | |
<ul class="navbar-nav navbar-nav-scroll ms-auto"> | |
<li class="nav-item compact"> | |
<a class="nav-link" href="https://github.com/answerdotai/fasthtml"> <i class="bi bi-github" role="img"> | |
</i> | |
<span class="menu-text"></span></a> | |
</li> | |
<li class="nav-item compact"> | |
<a class="nav-link" href="https://x.com/answerdotai"> <i class="bi bi-twitter" role="img" aria-label="Fast.ai Twitter"> | |
</i> | |
<span class="menu-text"></span></a> | |
</li> | |
</ul> | |
</div> <!-- /navcollapse --> | |
<div class="quarto-navbar-tools"> | |
</div> | |
</div> <!-- /container-fluid --> | |
</nav> | |
<nav class="quarto-secondary-nav"> | |
<div class="container-fluid d-flex"> | |
<button type="button" class="quarto-btn-toggle btn" data-bs-toggle="collapse" role="button" data-bs-target=".quarto-sidebar-collapse-item" aria-controls="quarto-sidebar" aria-expanded="false" aria-label="Toggle sidebar navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }"> | |
<i class="bi bi-layout-text-sidebar-reverse"></i> | |
</button> | |
<nav class="quarto-page-breadcrumbs" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="../api/core.html">Source</a></li><li class="breadcrumb-item"><a href="../api/svg.html">SVG</a></li></ol></nav> | |
<a class="flex-grow-1" role="navigation" data-bs-toggle="collapse" data-bs-target=".quarto-sidebar-collapse-item" aria-controls="quarto-sidebar" aria-expanded="false" aria-label="Toggle sidebar navigation" onclick="if (window.quartoToggleHeadroom) { window.quartoToggleHeadroom(); }"> | |
</a> | |
</div> | |
</nav> | |
</header> | |
<!-- content --> | |
<div id="quarto-content" class="quarto-container page-columns page-rows-contents page-layout-article page-navbar"> | |
<!-- sidebar --> | |
<nav id="quarto-sidebar" class="sidebar collapse collapse-horizontal quarto-sidebar-collapse-item sidebar-navigation floating overflow-auto"> | |
<div class="sidebar-menu-container"> | |
<ul class="list-unstyled mt-1"> | |
<li class="sidebar-item"> | |
<div class="sidebar-item-container"> | |
<a href="../index.html" class="sidebar-item-text sidebar-link"> | |
<span class="menu-text">Get Started</span></a> | |
</div> | |
</li> | |
<li class="sidebar-item sidebar-item-section"> | |
<div class="sidebar-item-container"> | |
<a href="../tutorials/index.html" class="sidebar-item-text sidebar-link"> | |
<span class="menu-text">Tutorials</span></a> | |
<a class="sidebar-item-toggle text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-1" role="navigation" aria-expanded="true" aria-label="Toggle section"> | |
<i class="bi bi-chevron-right ms-2"></i> | |
</a> | |
</div> | |
<ul id="quarto-sidebar-section-1" class="collapse list-unstyled sidebar-section depth1 show"> | |
<li class="sidebar-item"> | |
<div class="sidebar-item-container"> | |
<a href="../tutorials/by_example.html" class="sidebar-item-text sidebar-link"> | |
<span class="menu-text">FastHTML By Example</span></a> | |
</div> | |
</li> | |
<li class="sidebar-item"> | |
<div class="sidebar-item-container"> | |
<a href="../tutorials/quickstart_for_web_devs.html" class="sidebar-item-text sidebar-link"> | |
<span class="menu-text">Web Devs Quickstart</span></a> | |
</div> | |
</li> | |
<li class="sidebar-item"> | |
<div class="sidebar-item-container"> | |
<a href="../tutorials/e2e.html" class="sidebar-item-text sidebar-link"> | |
<span class="menu-text">JS App Walkthrough</span></a> | |
</div> | |
</li> | |
<li class="sidebar-item"> | |
<div class="sidebar-item-container"> | |
<a href="../tutorials/best_practice.html" class="sidebar-item-text sidebar-link"> | |
<span class="menu-text">FastHTML Best Practices</span></a> | |
</div> | |
</li> | |
<li class="sidebar-item"> | |
<div class="sidebar-item-container"> | |
<a href="../tutorials/jupyter_and_fasthtml.html" class="sidebar-item-text sidebar-link"> | |
<span class="menu-text">Using Jupyter to write FastHTML</span></a> | |
</div> | |
</li> | |
</ul> | |
</li> | |
<li class="sidebar-item sidebar-item-section"> | |
<div class="sidebar-item-container"> | |
<a class="sidebar-item-text sidebar-link text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-2" role="navigation" aria-expanded="true"> | |
<span class="menu-text">Explanations</span></a> | |
<a class="sidebar-item-toggle text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-2" role="navigation" aria-expanded="true" aria-label="Toggle section"> | |
<i class="bi bi-chevron-right ms-2"></i> | |
</a> | |
</div> | |
<ul id="quarto-sidebar-section-2" class="collapse list-unstyled sidebar-section depth1 show"> | |
<li class="sidebar-item"> | |
<div class="sidebar-item-container"> | |
<a href="../explains/background_tasks.html" class="sidebar-item-text sidebar-link"> | |
<span class="menu-text">Background Tasks</span></a> | |
</div> | |
</li> | |
<li class="sidebar-item"> | |
<div class="sidebar-item-container"> | |
<a href="../explains/explaining_xt_components.html" class="sidebar-item-text sidebar-link"> | |
<span class="menu-text"><strong>FT</strong> Components</span></a> | |
</div> | |
</li> | |
<li class="sidebar-item"> | |
<div class="sidebar-item-container"> | |
<a href="../explains/faq.html" class="sidebar-item-text sidebar-link"> | |
<span class="menu-text">FAQ</span></a> | |
</div> | |
</li> | |
<li class="sidebar-item"> | |
<div class="sidebar-item-container"> | |
<a href="../explains/minidataapi.html" class="sidebar-item-text sidebar-link"> | |
<span class="menu-text">MiniDataAPI Spec</span></a> | |
</div> | |
</li> | |
<li class="sidebar-item"> | |
<div class="sidebar-item-container"> | |
<a href="../explains/oauth.html" class="sidebar-item-text sidebar-link"> | |
<span class="menu-text">OAuth</span></a> | |
</div> | |
</li> | |
<li class="sidebar-item"> | |
<div class="sidebar-item-container"> | |
<a href="../explains/routes.html" class="sidebar-item-text sidebar-link"> | |
<span class="menu-text">Routes</span></a> | |
</div> | |
</li> | |
<li class="sidebar-item"> | |
<div class="sidebar-item-container"> | |
<a href="../explains/stripe.html" class="sidebar-item-text sidebar-link"> | |
<span class="menu-text">Stripe</span></a> | |
</div> | |
</li> | |
<li class="sidebar-item"> | |
<div class="sidebar-item-container"> | |
<a href="../explains/websockets.html" class="sidebar-item-text sidebar-link"> | |
<span class="menu-text">WebSockets</span></a> | |
</div> | |
</li> | |
</ul> | |
</li> | |
<li class="sidebar-item sidebar-item-section"> | |
<div class="sidebar-item-container"> | |
<a class="sidebar-item-text sidebar-link text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-3" role="navigation" aria-expanded="true"> | |
<span class="menu-text">Reference</span></a> | |
<a class="sidebar-item-toggle text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-3" role="navigation" aria-expanded="true" aria-label="Toggle section"> | |
<i class="bi bi-chevron-right ms-2"></i> | |
</a> | |
</div> | |
<ul id="quarto-sidebar-section-3" class="collapse list-unstyled sidebar-section depth1 show"> | |
<li class="sidebar-item"> | |
<div class="sidebar-item-container"> | |
<a href="../ref/concise_guide.html" class="sidebar-item-text sidebar-link"> | |
<span class="menu-text">Concise reference</span></a> | |
</div> | |
</li> | |
<li class="sidebar-item"> | |
<div class="sidebar-item-container"> | |
<a href="../ref/best_practice.html" class="sidebar-item-text sidebar-link"> | |
<span class="menu-text">FastHTML Best Practices</span></a> | |
</div> | |
</li> | |
<li class="sidebar-item"> | |
<div class="sidebar-item-container"> | |
<a href="../ref/defining_xt_component.html" class="sidebar-item-text sidebar-link"> | |
<span class="menu-text">Custom Components</span></a> | |
</div> | |
</li> | |
<li class="sidebar-item"> | |
<div class="sidebar-item-container"> | |
<a href="../ref/handlers.html" class="sidebar-item-text sidebar-link"> | |
<span class="menu-text">Handling handlers</span></a> | |
</div> | |
</li> | |
<li class="sidebar-item"> | |
<div class="sidebar-item-container"> | |
<a href="../ref/live_reload.html" class="sidebar-item-text sidebar-link"> | |
<span class="menu-text">Live Reloading</span></a> | |
</div> | |
</li> | |
<li class="sidebar-item"> | |
<div class="sidebar-item-container"> | |
<a href="../ref/response_types.html" class="sidebar-item-text sidebar-link"> | |
<span class="menu-text">Response Types</span></a> | |
</div> | |
</li> | |
</ul> | |
</li> | |
<li class="sidebar-item sidebar-item-section"> | |
<div class="sidebar-item-container"> | |
<a class="sidebar-item-text sidebar-link text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-4" role="navigation" aria-expanded="true"> | |
<span class="menu-text">Source</span></a> | |
<a class="sidebar-item-toggle text-start" data-bs-toggle="collapse" data-bs-target="#quarto-sidebar-section-4" role="navigation" aria-expanded="true" aria-label="Toggle section"> | |
<i class="bi bi-chevron-right ms-2"></i> | |
</a> | |
</div> | |
<ul id="quarto-sidebar-section-4" class="collapse list-unstyled sidebar-section depth1 show"> | |
<li class="sidebar-item"> | |
<div class="sidebar-item-container"> | |
<a href="../api/core.html" class="sidebar-item-text sidebar-link"> | |
<span class="menu-text">Core</span></a> | |
</div> | |
</li> | |
<li class="sidebar-item"> | |
<div class="sidebar-item-container"> | |
<a href="../api/components.html" class="sidebar-item-text sidebar-link"> | |
<span class="menu-text">Components</span></a> | |
</div> | |
</li> | |
<li class="sidebar-item"> | |
<div class="sidebar-item-container"> | |
<a href="../api/xtend.html" class="sidebar-item-text sidebar-link"> | |
<span class="menu-text">Component extensions</span></a> | |
</div> | |
</li> | |
<li class="sidebar-item"> | |
<div class="sidebar-item-container"> | |
<a href="../api/js.html" class="sidebar-item-text sidebar-link"> | |
<span class="menu-text">Javascript examples</span></a> | |
</div> | |
</li> | |
<li class="sidebar-item"> | |
<div class="sidebar-item-container"> | |
<a href="../api/pico.html" class="sidebar-item-text sidebar-link"> | |
<span class="menu-text">Pico.css components</span></a> | |
</div> | |
</li> | |
<li class="sidebar-item"> | |
<div class="sidebar-item-container"> | |
<a href="../api/svg.html" class="sidebar-item-text sidebar-link active"> | |
<span class="menu-text">SVG</span></a> | |
</div> | |
</li> | |
<li class="sidebar-item"> | |
<div class="sidebar-item-container"> | |
<a href="../api/jupyter.html" class="sidebar-item-text sidebar-link"> | |
<span class="menu-text">Jupyter compatibility</span></a> | |
</div> | |
</li> | |
<li class="sidebar-item"> | |
<div class="sidebar-item-container"> | |
<a href="../api/oauth.html" class="sidebar-item-text sidebar-link"> | |
<span class="menu-text">OAuth</span></a> | |
</div> | |
</li> | |
<li class="sidebar-item"> | |
<div class="sidebar-item-container"> | |
<a href="../api/cli.html" class="sidebar-item-text sidebar-link"> | |
<span class="menu-text">Command Line Tools</span></a> | |
</div> | |
</li> | |
</ul> | |
</li> | |
</ul> | |
</div> | |
</nav> | |
<div id="quarto-sidebar-glass" class="quarto-sidebar-collapse-item" data-bs-toggle="collapse" data-bs-target=".quarto-sidebar-collapse-item"></div> | |
<!-- margin-sidebar --> | |
<div id="quarto-margin-sidebar" class="sidebar margin-sidebar"> | |
<nav id="TOC" role="doc-toc" class="toc-active"> | |
<h2 id="toc-title">On this page</h2> | |
<ul> | |
<li><a href="#svg" id="toc-svg" class="nav-link active" data-scroll-target="#svg">Svg</a></li> | |
<li><a href="#ft_svg" id="toc-ft_svg" class="nav-link" data-scroll-target="#ft_svg">ft_svg</a></li> | |
<li><a href="#basic-shapes" id="toc-basic-shapes" class="nav-link" data-scroll-target="#basic-shapes">Basic shapes</a> | |
<ul class="collapse"> | |
<li><a href="#rect" id="toc-rect" class="nav-link" data-scroll-target="#rect">Rect</a></li> | |
<li><a href="#circle" id="toc-circle" class="nav-link" data-scroll-target="#circle">Circle</a></li> | |
<li><a href="#ellipse" id="toc-ellipse" class="nav-link" data-scroll-target="#ellipse">Ellipse</a></li> | |
<li><a href="#transformd" id="toc-transformd" class="nav-link" data-scroll-target="#transformd">transformd</a></li> | |
<li><a href="#line" id="toc-line" class="nav-link" data-scroll-target="#line">Line</a></li> | |
<li><a href="#polyline" id="toc-polyline" class="nav-link" data-scroll-target="#polyline">Polyline</a></li> | |
<li><a href="#polygon" id="toc-polygon" class="nav-link" data-scroll-target="#polygon">Polygon</a></li> | |
<li><a href="#text" id="toc-text" class="nav-link" data-scroll-target="#text">Text</a></li> | |
</ul></li> | |
<li><a href="#paths" id="toc-paths" class="nav-link" data-scroll-target="#paths">Paths</a> | |
<ul class="collapse"> | |
<li><a href="#pathft" id="toc-pathft" class="nav-link" data-scroll-target="#pathft">PathFT</a></li> | |
<li><a href="#path" id="toc-path" class="nav-link" data-scroll-target="#path">Path</a></li> | |
<li><a href="#pathft.m" id="toc-pathft.m" class="nav-link" data-scroll-target="#pathft.m">PathFT.M</a></li> | |
<li><a href="#pathft.l" id="toc-pathft.l" class="nav-link" data-scroll-target="#pathft.l">PathFT.L</a></li> | |
<li><a href="#pathft.h" id="toc-pathft.h" class="nav-link" data-scroll-target="#pathft.h">PathFT.H</a></li> | |
<li><a href="#pathft.v" id="toc-pathft.v" class="nav-link" data-scroll-target="#pathft.v">PathFT.V</a></li> | |
<li><a href="#pathft.z" id="toc-pathft.z" class="nav-link" data-scroll-target="#pathft.z">PathFT.Z</a></li> | |
<li><a href="#pathft.c" id="toc-pathft.c" class="nav-link" data-scroll-target="#pathft.c">PathFT.C</a></li> | |
<li><a href="#pathft.s" id="toc-pathft.s" class="nav-link" data-scroll-target="#pathft.s">PathFT.S</a></li> | |
<li><a href="#pathft.q" id="toc-pathft.q" class="nav-link" data-scroll-target="#pathft.q">PathFT.Q</a></li> | |
<li><a href="#pathft.t" id="toc-pathft.t" class="nav-link" data-scroll-target="#pathft.t">PathFT.T</a></li> | |
<li><a href="#pathft.a" id="toc-pathft.a" class="nav-link" data-scroll-target="#pathft.a">PathFT.A</a></li> | |
</ul></li> | |
<li><a href="#htmx-helpers" id="toc-htmx-helpers" class="nav-link" data-scroll-target="#htmx-helpers">HTMX helpers</a> | |
<ul class="collapse"> | |
<li><a href="#svgoob" id="toc-svgoob" class="nav-link" data-scroll-target="#svgoob">SvgOob</a></li> | |
<li><a href="#svginb" id="toc-svginb" class="nav-link" data-scroll-target="#svginb">SvgInb</a></li> | |
</ul></li> | |
</ul> | |
<div class="toc-actions"><ul><li><a href="https://github.com/AnswerDotAI/fasthtml/issues/new" class="toc-action"><i class="bi bi-github"></i>Report an issue</a></li></ul></div><div class="quarto-alternate-formats"><h2>Other Formats</h2><ul><li><a href="svg.html.md"><i class="bi bi-file-code"></i>CommonMark</a></li></ul></div></nav> | |
</div> | |
<!-- main --> | |
<main class="content" id="quarto-document-content"> | |
<header id="title-block-header" class="quarto-title-block default"><nav class="quarto-page-breadcrumbs quarto-title-breadcrumbs d-none d-lg-block" aria-label="breadcrumb"><ol class="breadcrumb"><li class="breadcrumb-item"><a href="../api/core.html">Source</a></li><li class="breadcrumb-item"><a href="../api/svg.html">SVG</a></li></ol></nav> | |
<div class="quarto-title"> | |
<h1 class="title">SVG</h1> | |
</div> | |
<div> | |
<div class="description"> | |
Simple SVG FT elements | |
</div> | |
</div> | |
<div class="quarto-title-meta"> | |
</div> | |
</header> | |
<!-- WARNING: THIS FILE WAS AUTOGENERATED! DO NOT EDIT! --> | |
<div id="cell-2" class="cell"> | |
<div class="sourceCode cell-code" id="cb1"><pre class="sourceCode python code-with-copy"><code class="sourceCode python"><span id="cb1-1"><a href="#cb1-1" aria-hidden="true" tabindex="-1"></a><span class="im">from</span> nbdev.showdoc <span class="im">import</span> show_doc</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div> | |
</div> | |
<p>You can create SVGs directly from strings, for instance (as always, use <code>NotStr</code> or <code>Safe</code> to tell FastHTML to not escape the text):</p> | |
<div id="cell-4" class="cell"> | |
<div class="sourceCode cell-code" id="cb2"><pre class="sourceCode python code-with-copy"><code class="sourceCode python"><span id="cb2-1"><a href="#cb2-1" aria-hidden="true" tabindex="-1"></a>svg <span class="op">=</span> <span class="st">'<svg width="50" height="50"><circle cx="20" cy="20" r="15" fill="red"></circle></svg>'</span></span> | |
<span id="cb2-2"><a href="#cb2-2" aria-hidden="true" tabindex="-1"></a>show(NotStr(svg))</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div> | |
<div class="cell-output cell-output-display"> | |
<svg width="50" height="50"><circle cx="20" cy="20" r="15" fill="red"></circle></svg> | |
</div> | |
</div> | |
<p>You can also use libraries such as <a href="https://www.fastht.ml/docs/fa6-icons/">fa6-icons</a>.</p> | |
<p>To create and modify SVGs using a Python API, use the FT elements in <code>fasthtml.svg</code>, discussed below.</p> | |
<p><strong>Note</strong>: <code>fasthtml.common</code> does NOT automatically export SVG elements. To get access to them, you need to import <code>fasthtml.svg</code> like so</p> | |
<div class="sourceCode" id="cb3"><pre class="sourceCode python code-with-copy"><code class="sourceCode python"><span id="cb3-1"><a href="#cb3-1" aria-hidden="true" tabindex="-1"></a><span class="im">from</span> fasthtml.svg <span class="im">import</span> <span class="op">*</span></span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div> | |
<hr> | |
<p><a href="https://github.com/AnswerDotAI/fasthtml/blob/main/fasthtml/svg.py#L34" target="_blank" style="float:right; font-size:smaller">source</a></p> | |
<section id="svg" class="level3"> | |
<h3 class="anchored" data-anchor-id="svg">Svg</h3> | |
<blockquote class="blockquote"> | |
<pre><code> Svg (*args, viewBox=None, h=None, w=None, height=None, width=None, | |
xmlns='http://www.w3.org/2000/svg', **kwargs)</code></pre> | |
</blockquote> | |
<p><em>An SVG tag; xmlns is added automatically, and viewBox defaults to height and width if not provided</em></p> | |
<p>To create your own SVGs, use <code>SVG</code>. It will automatically set the <code>viewBox</code> from height and width if not provided.</p> | |
<p>All of our shapes will have some convenient kwargs added by using <a href="https://www.fastht.ml/docs/api/svg.html#ft_svg"><code>ft_svg</code></a>:</p> | |
<hr> | |
<p><a href="https://github.com/AnswerDotAI/fasthtml/blob/main/fasthtml/svg.py#L43" target="_blank" style="float:right; font-size:smaller">source</a></p> | |
</section> | |
<section id="ft_svg" class="level3"> | |
<h3 class="anchored" data-anchor-id="ft_svg">ft_svg</h3> | |
<blockquote class="blockquote"> | |
<pre><code> ft_svg (tag:str, *c, transform=None, opacity=None, clip=None, mask=None, | |
filter=None, vector_effect=None, pointer_events=None, | |
target_id=None, hx_vals=None, hx_target=None, id=None, cls=None, | |
title=None, style=None, accesskey=None, contenteditable=None, | |
dir=None, draggable=None, enterkeyhint=None, hidden=None, | |
inert=None, inputmode=None, lang=None, popover=None, | |
spellcheck=None, tabindex=None, translate=None, hx_get=None, | |
hx_post=None, hx_put=None, hx_delete=None, hx_patch=None, | |
hx_trigger=None, hx_swap=None, hx_swap_oob=None, hx_include=None, | |
hx_select=None, hx_select_oob=None, hx_indicator=None, | |
hx_push_url=None, hx_confirm=None, hx_disable=None, | |
hx_replace_url=None, hx_disabled_elt=None, hx_ext=None, | |
hx_headers=None, hx_history=None, hx_history_elt=None, | |
hx_inherit=None, hx_params=None, hx_preserve=None, | |
hx_prompt=None, hx_request=None, hx_sync=None, hx_validate=None, | |
hx_on_blur=None, hx_on_change=None, hx_on_contextmenu=None, | |
hx_on_focus=None, hx_on_input=None, hx_on_invalid=None, | |
hx_on_reset=None, hx_on_select=None, hx_on_submit=None, | |
hx_on_keydown=None, hx_on_keypress=None, hx_on_keyup=None, | |
hx_on_click=None, hx_on_dblclick=None, hx_on_mousedown=None, | |
hx_on_mouseenter=None, hx_on_mouseleave=None, | |
hx_on_mousemove=None, hx_on_mouseout=None, hx_on_mouseover=None, | |
hx_on_mouseup=None, hx_on_wheel=None, hx_on__abort=None, | |
hx_on__after_on_load=None, hx_on__after_process_node=None, | |
hx_on__after_request=None, hx_on__after_settle=None, | |
hx_on__after_swap=None, hx_on__before_cleanup_element=None, | |
hx_on__before_on_load=None, hx_on__before_process_node=None, | |
hx_on__before_request=None, hx_on__before_swap=None, | |
hx_on__before_send=None, hx_on__before_transition=None, | |
hx_on__config_request=None, hx_on__confirm=None, | |
hx_on__history_cache_error=None, hx_on__history_cache_miss=None, | |
hx_on__history_cache_miss_error=None, | |
hx_on__history_cache_miss_load=None, hx_on__history_restore=None, | |
hx_on__before_history_save=None, hx_on__load=None, | |
hx_on__no_sse_source_error=None, hx_on__on_load_error=None, | |
hx_on__oob_after_swap=None, hx_on__oob_before_swap=None, | |
hx_on__oob_error_no_target=None, hx_on__prompt=None, | |
hx_on__pushed_into_history=None, hx_on__replaced_in_history=None, | |
hx_on__response_error=None, hx_on__send_abort=None, | |
hx_on__send_error=None, hx_on__sse_error=None, | |
hx_on__sse_open=None, hx_on__swap_error=None, | |
hx_on__target_error=None, hx_on__timeout=None, | |
hx_on__validation_validate=None, hx_on__validation_failed=None, | |
hx_on__validation_halted=None, hx_on__xhr_abort=None, | |
hx_on__xhr_loadend=None, hx_on__xhr_loadstart=None, | |
hx_on__xhr_progress=None)</code></pre> | |
</blockquote> | |
<p><em>Create a standard <code>FT</code> element with some SVG-specific attrs</em></p> | |
</section> | |
<section id="basic-shapes" class="level2"> | |
<h2 class="anchored" data-anchor-id="basic-shapes">Basic shapes</h2> | |
<p>We’ll define a simple function to display SVG shapes in this notebook:</p> | |
<div id="cell-11" class="cell"> | |
<div class="sourceCode cell-code" id="cb6"><pre class="sourceCode python code-with-copy"><code class="sourceCode python"><span id="cb6-1"><a href="#cb6-1" aria-hidden="true" tabindex="-1"></a><span class="kw">def</span> demo(el, h<span class="op">=</span><span class="dv">50</span>, w<span class="op">=</span><span class="dv">50</span>): <span class="cf">return</span> show(Svg(h<span class="op">=</span>h,w<span class="op">=</span>w)(el))</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div> | |
</div> | |
<hr> | |
<p><a href="https://github.com/AnswerDotAI/fasthtml/blob/main/fasthtml/svg.py#L51" target="_blank" style="float:right; font-size:smaller">source</a></p> | |
<section id="rect" class="level3"> | |
<h3 class="anchored" data-anchor-id="rect">Rect</h3> | |
<blockquote class="blockquote"> | |
<pre><code> Rect (width, height, x=0, y=0, fill=None, stroke=None, stroke_width=None, | |
rx=None, ry=None, transform=None, opacity=None, clip=None, | |
mask=None, filter=None, vector_effect=None, pointer_events=None, | |
target_id=None, hx_vals=None, hx_target=None, id=None, cls=None, | |
title=None, style=None, accesskey=None, contenteditable=None, | |
dir=None, draggable=None, enterkeyhint=None, hidden=None, | |
inert=None, inputmode=None, lang=None, popover=None, | |
spellcheck=None, tabindex=None, translate=None, hx_get=None, | |
hx_post=None, hx_put=None, hx_delete=None, hx_patch=None, | |
hx_trigger=None, hx_swap=None, hx_swap_oob=None, hx_include=None, | |
hx_select=None, hx_select_oob=None, hx_indicator=None, | |
hx_push_url=None, hx_confirm=None, hx_disable=None, | |
hx_replace_url=None, hx_disabled_elt=None, hx_ext=None, | |
hx_headers=None, hx_history=None, hx_history_elt=None, | |
hx_inherit=None, hx_params=None, hx_preserve=None, hx_prompt=None, | |
hx_request=None, hx_sync=None, hx_validate=None, hx_on_blur=None, | |
hx_on_change=None, hx_on_contextmenu=None, hx_on_focus=None, | |
hx_on_input=None, hx_on_invalid=None, hx_on_reset=None, | |
hx_on_select=None, hx_on_submit=None, hx_on_keydown=None, | |
hx_on_keypress=None, hx_on_keyup=None, hx_on_click=None, | |
hx_on_dblclick=None, hx_on_mousedown=None, hx_on_mouseenter=None, | |
hx_on_mouseleave=None, hx_on_mousemove=None, hx_on_mouseout=None, | |
hx_on_mouseover=None, hx_on_mouseup=None, hx_on_wheel=None, | |
hx_on__abort=None, hx_on__after_on_load=None, | |
hx_on__after_process_node=None, hx_on__after_request=None, | |
hx_on__after_settle=None, hx_on__after_swap=None, | |
hx_on__before_cleanup_element=None, hx_on__before_on_load=None, | |
hx_on__before_process_node=None, hx_on__before_request=None, | |
hx_on__before_swap=None, hx_on__before_send=None, | |
hx_on__before_transition=None, hx_on__config_request=None, | |
hx_on__confirm=None, hx_on__history_cache_error=None, | |
hx_on__history_cache_miss=None, | |
hx_on__history_cache_miss_error=None, | |
hx_on__history_cache_miss_load=None, hx_on__history_restore=None, | |
hx_on__before_history_save=None, hx_on__load=None, | |
hx_on__no_sse_source_error=None, hx_on__on_load_error=None, | |
hx_on__oob_after_swap=None, hx_on__oob_before_swap=None, | |
hx_on__oob_error_no_target=None, hx_on__prompt=None, | |
hx_on__pushed_into_history=None, hx_on__replaced_in_history=None, | |
hx_on__response_error=None, hx_on__send_abort=None, | |
hx_on__send_error=None, hx_on__sse_error=None, | |
hx_on__sse_open=None, hx_on__swap_error=None, | |
hx_on__target_error=None, hx_on__timeout=None, | |
hx_on__validation_validate=None, hx_on__validation_failed=None, | |
hx_on__validation_halted=None, hx_on__xhr_abort=None, | |
hx_on__xhr_loadend=None, hx_on__xhr_loadstart=None, | |
hx_on__xhr_progress=None)</code></pre> | |
</blockquote> | |
<p><em>A standard SVG <code>rect</code> element</em></p> | |
<p>All our shapes just create regular <code>FT</code> elements. The only extra functionality provided by most of them is to add additional defined kwargs to improve auto-complete in IDEs and notebooks, and re-order parameters so that positional args can also be used to save a bit of typing, e.g:</p> | |
<div id="cell-14" class="cell"> | |
<div class="sourceCode cell-code" id="cb8"><pre class="sourceCode python code-with-copy"><code class="sourceCode python"><span id="cb8-1"><a href="#cb8-1" aria-hidden="true" tabindex="-1"></a>demo(Rect(<span class="dv">30</span>, <span class="dv">30</span>, fill<span class="op">=</span><span class="st">'blue'</span>, rx<span class="op">=</span><span class="dv">8</span>, ry<span class="op">=</span><span class="dv">8</span>))</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div> | |
<div class="cell-output cell-output-display"> | |
<svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 50 50" height="50" width="50"><rect width="30" height="30" fill="blue" rx="8" ry="8"></rect></svg> | |
</div> | |
</div> | |
<hr> | |
<p><a href="https://github.com/AnswerDotAI/fasthtml/blob/main/fasthtml/svg.py#L58" target="_blank" style="float:right; font-size:smaller">source</a></p> | |
</section> | |
<section id="circle" class="level3"> | |
<h3 class="anchored" data-anchor-id="circle">Circle</h3> | |
<blockquote class="blockquote"> | |
<pre><code> Circle (r, cx=0, cy=0, fill=None, stroke=None, stroke_width=None, | |
transform=None, opacity=None, clip=None, mask=None, filter=None, | |
vector_effect=None, pointer_events=None, target_id=None, | |
hx_vals=None, hx_target=None, id=None, cls=None, title=None, | |
style=None, accesskey=None, contenteditable=None, dir=None, | |
draggable=None, enterkeyhint=None, hidden=None, inert=None, | |
inputmode=None, lang=None, popover=None, spellcheck=None, | |
tabindex=None, translate=None, hx_get=None, hx_post=None, | |
hx_put=None, hx_delete=None, hx_patch=None, hx_trigger=None, | |
hx_swap=None, hx_swap_oob=None, hx_include=None, hx_select=None, | |
hx_select_oob=None, hx_indicator=None, hx_push_url=None, | |
hx_confirm=None, hx_disable=None, hx_replace_url=None, | |
hx_disabled_elt=None, hx_ext=None, hx_headers=None, | |
hx_history=None, hx_history_elt=None, hx_inherit=None, | |
hx_params=None, hx_preserve=None, hx_prompt=None, | |
hx_request=None, hx_sync=None, hx_validate=None, hx_on_blur=None, | |
hx_on_change=None, hx_on_contextmenu=None, hx_on_focus=None, | |
hx_on_input=None, hx_on_invalid=None, hx_on_reset=None, | |
hx_on_select=None, hx_on_submit=None, hx_on_keydown=None, | |
hx_on_keypress=None, hx_on_keyup=None, hx_on_click=None, | |
hx_on_dblclick=None, hx_on_mousedown=None, hx_on_mouseenter=None, | |
hx_on_mouseleave=None, hx_on_mousemove=None, hx_on_mouseout=None, | |
hx_on_mouseover=None, hx_on_mouseup=None, hx_on_wheel=None, | |
hx_on__abort=None, hx_on__after_on_load=None, | |
hx_on__after_process_node=None, hx_on__after_request=None, | |
hx_on__after_settle=None, hx_on__after_swap=None, | |
hx_on__before_cleanup_element=None, hx_on__before_on_load=None, | |
hx_on__before_process_node=None, hx_on__before_request=None, | |
hx_on__before_swap=None, hx_on__before_send=None, | |
hx_on__before_transition=None, hx_on__config_request=None, | |
hx_on__confirm=None, hx_on__history_cache_error=None, | |
hx_on__history_cache_miss=None, | |
hx_on__history_cache_miss_error=None, | |
hx_on__history_cache_miss_load=None, hx_on__history_restore=None, | |
hx_on__before_history_save=None, hx_on__load=None, | |
hx_on__no_sse_source_error=None, hx_on__on_load_error=None, | |
hx_on__oob_after_swap=None, hx_on__oob_before_swap=None, | |
hx_on__oob_error_no_target=None, hx_on__prompt=None, | |
hx_on__pushed_into_history=None, hx_on__replaced_in_history=None, | |
hx_on__response_error=None, hx_on__send_abort=None, | |
hx_on__send_error=None, hx_on__sse_error=None, | |
hx_on__sse_open=None, hx_on__swap_error=None, | |
hx_on__target_error=None, hx_on__timeout=None, | |
hx_on__validation_validate=None, hx_on__validation_failed=None, | |
hx_on__validation_halted=None, hx_on__xhr_abort=None, | |
hx_on__xhr_loadend=None, hx_on__xhr_loadstart=None, | |
hx_on__xhr_progress=None)</code></pre> | |
</blockquote> | |
<p><em>A standard SVG <code>circle</code> element</em></p> | |
<div id="cell-16" class="cell"> | |
<div class="sourceCode cell-code" id="cb10"><pre class="sourceCode python code-with-copy"><code class="sourceCode python"><span id="cb10-1"><a href="#cb10-1" aria-hidden="true" tabindex="-1"></a>demo(Circle(<span class="dv">20</span>, <span class="dv">25</span>, <span class="dv">25</span>, stroke<span class="op">=</span><span class="st">'red'</span>, stroke_width<span class="op">=</span><span class="dv">3</span>))</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div> | |
<div class="cell-output cell-output-display"> | |
<svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 50 50" height="50" width="50"><circle r="20" cx="25" cy="25" stroke="red" stroke-width="3"></circle></svg> | |
</div> | |
</div> | |
<hr> | |
<p><a href="https://github.com/AnswerDotAI/fasthtml/blob/main/fasthtml/svg.py#L64" target="_blank" style="float:right; font-size:smaller">source</a></p> | |
</section> | |
<section id="ellipse" class="level3"> | |
<h3 class="anchored" data-anchor-id="ellipse">Ellipse</h3> | |
<blockquote class="blockquote"> | |
<pre><code> Ellipse (rx, ry, cx=0, cy=0, fill=None, stroke=None, stroke_width=None, | |
transform=None, opacity=None, clip=None, mask=None, filter=None, | |
vector_effect=None, pointer_events=None, target_id=None, | |
hx_vals=None, hx_target=None, id=None, cls=None, title=None, | |
style=None, accesskey=None, contenteditable=None, dir=None, | |
draggable=None, enterkeyhint=None, hidden=None, inert=None, | |
inputmode=None, lang=None, popover=None, spellcheck=None, | |
tabindex=None, translate=None, hx_get=None, hx_post=None, | |
hx_put=None, hx_delete=None, hx_patch=None, hx_trigger=None, | |
hx_swap=None, hx_swap_oob=None, hx_include=None, hx_select=None, | |
hx_select_oob=None, hx_indicator=None, hx_push_url=None, | |
hx_confirm=None, hx_disable=None, hx_replace_url=None, | |
hx_disabled_elt=None, hx_ext=None, hx_headers=None, | |
hx_history=None, hx_history_elt=None, hx_inherit=None, | |
hx_params=None, hx_preserve=None, hx_prompt=None, | |
hx_request=None, hx_sync=None, hx_validate=None, | |
hx_on_blur=None, hx_on_change=None, hx_on_contextmenu=None, | |
hx_on_focus=None, hx_on_input=None, hx_on_invalid=None, | |
hx_on_reset=None, hx_on_select=None, hx_on_submit=None, | |
hx_on_keydown=None, hx_on_keypress=None, hx_on_keyup=None, | |
hx_on_click=None, hx_on_dblclick=None, hx_on_mousedown=None, | |
hx_on_mouseenter=None, hx_on_mouseleave=None, | |
hx_on_mousemove=None, hx_on_mouseout=None, hx_on_mouseover=None, | |
hx_on_mouseup=None, hx_on_wheel=None, hx_on__abort=None, | |
hx_on__after_on_load=None, hx_on__after_process_node=None, | |
hx_on__after_request=None, hx_on__after_settle=None, | |
hx_on__after_swap=None, hx_on__before_cleanup_element=None, | |
hx_on__before_on_load=None, hx_on__before_process_node=None, | |
hx_on__before_request=None, hx_on__before_swap=None, | |
hx_on__before_send=None, hx_on__before_transition=None, | |
hx_on__config_request=None, hx_on__confirm=None, | |
hx_on__history_cache_error=None, hx_on__history_cache_miss=None, | |
hx_on__history_cache_miss_error=None, | |
hx_on__history_cache_miss_load=None, | |
hx_on__history_restore=None, hx_on__before_history_save=None, | |
hx_on__load=None, hx_on__no_sse_source_error=None, | |
hx_on__on_load_error=None, hx_on__oob_after_swap=None, | |
hx_on__oob_before_swap=None, hx_on__oob_error_no_target=None, | |
hx_on__prompt=None, hx_on__pushed_into_history=None, | |
hx_on__replaced_in_history=None, hx_on__response_error=None, | |
hx_on__send_abort=None, hx_on__send_error=None, | |
hx_on__sse_error=None, hx_on__sse_open=None, | |
hx_on__swap_error=None, hx_on__target_error=None, | |
hx_on__timeout=None, hx_on__validation_validate=None, | |
hx_on__validation_failed=None, hx_on__validation_halted=None, | |
hx_on__xhr_abort=None, hx_on__xhr_loadend=None, | |
hx_on__xhr_loadstart=None, hx_on__xhr_progress=None)</code></pre> | |
</blockquote> | |
<p><em>A standard SVG <code>ellipse</code> element</em></p> | |
<div id="cell-18" class="cell"> | |
<div class="sourceCode cell-code" id="cb12"><pre class="sourceCode python code-with-copy"><code class="sourceCode python"><span id="cb12-1"><a href="#cb12-1" aria-hidden="true" tabindex="-1"></a>demo(Ellipse(<span class="dv">20</span>, <span class="dv">10</span>, <span class="dv">25</span>, <span class="dv">25</span>))</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div> | |
<div class="cell-output cell-output-display"> | |
<svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 50 50" height="50" width="50"><ellipse rx="20" ry="10" cx="25" cy="25"></ellipse></svg> | |
</div> | |
</div> | |
<hr> | |
<p><a href="https://github.com/AnswerDotAI/fasthtml/blob/main/fasthtml/svg.py#L69" target="_blank" style="float:right; font-size:smaller">source</a></p> | |
</section> | |
<section id="transformd" class="level3"> | |
<h3 class="anchored" data-anchor-id="transformd">transformd</h3> | |
<blockquote class="blockquote"> | |
<pre><code> transformd (translate=None, scale=None, rotate=None, skewX=None, | |
skewY=None, matrix=None)</code></pre> | |
</blockquote> | |
<p><em>Create an SVG <code>transform</code> kwarg dict</em></p> | |
<div id="cell-20" class="cell"> | |
<div class="sourceCode cell-code" id="cb14"><pre class="sourceCode python code-with-copy"><code class="sourceCode python"><span id="cb14-1"><a href="#cb14-1" aria-hidden="true" tabindex="-1"></a>rot <span class="op">=</span> transformd(rotate<span class="op">=</span>(<span class="dv">45</span>, <span class="dv">25</span>, <span class="dv">25</span>))</span> | |
<span id="cb14-2"><a href="#cb14-2" aria-hidden="true" tabindex="-1"></a>rot</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div> | |
<div class="cell-output cell-output-display"> | |
<pre><code>{'transform': 'rotate(45,25,25)'}</code></pre> | |
</div> | |
</div> | |
<div id="cell-21" class="cell"> | |
<div class="sourceCode cell-code" id="cb16"><pre class="sourceCode python code-with-copy"><code class="sourceCode python"><span id="cb16-1"><a href="#cb16-1" aria-hidden="true" tabindex="-1"></a>demo(Ellipse(<span class="dv">20</span>, <span class="dv">10</span>, <span class="dv">25</span>, <span class="dv">25</span>, <span class="op">**</span>rot))</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div> | |
<div class="cell-output cell-output-display"> | |
<svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 50 50" height="50" width="50"><ellipse transform="rotate(45,25,25)" rx="20" ry="10" cx="25" cy="25"></ellipse></svg> | |
</div> | |
</div> | |
<hr> | |
<p><a href="https://github.com/AnswerDotAI/fasthtml/blob/main/fasthtml/svg.py#L82" target="_blank" style="float:right; font-size:smaller">source</a></p> | |
</section> | |
<section id="line" class="level3"> | |
<h3 class="anchored" data-anchor-id="line">Line</h3> | |
<blockquote class="blockquote"> | |
<pre><code> Line (x1, y1, x2=0, y2=0, stroke='black', w=None, stroke_width=1, | |
transform=None, opacity=None, clip=None, mask=None, filter=None, | |
vector_effect=None, pointer_events=None, target_id=None, | |
hx_vals=None, hx_target=None, id=None, cls=None, title=None, | |
style=None, accesskey=None, contenteditable=None, dir=None, | |
draggable=None, enterkeyhint=None, hidden=None, inert=None, | |
inputmode=None, lang=None, popover=None, spellcheck=None, | |
tabindex=None, translate=None, hx_get=None, hx_post=None, | |
hx_put=None, hx_delete=None, hx_patch=None, hx_trigger=None, | |
hx_swap=None, hx_swap_oob=None, hx_include=None, hx_select=None, | |
hx_select_oob=None, hx_indicator=None, hx_push_url=None, | |
hx_confirm=None, hx_disable=None, hx_replace_url=None, | |
hx_disabled_elt=None, hx_ext=None, hx_headers=None, | |
hx_history=None, hx_history_elt=None, hx_inherit=None, | |
hx_params=None, hx_preserve=None, hx_prompt=None, hx_request=None, | |
hx_sync=None, hx_validate=None, hx_on_blur=None, hx_on_change=None, | |
hx_on_contextmenu=None, hx_on_focus=None, hx_on_input=None, | |
hx_on_invalid=None, hx_on_reset=None, hx_on_select=None, | |
hx_on_submit=None, hx_on_keydown=None, hx_on_keypress=None, | |
hx_on_keyup=None, hx_on_click=None, hx_on_dblclick=None, | |
hx_on_mousedown=None, hx_on_mouseenter=None, hx_on_mouseleave=None, | |
hx_on_mousemove=None, hx_on_mouseout=None, hx_on_mouseover=None, | |
hx_on_mouseup=None, hx_on_wheel=None, hx_on__abort=None, | |
hx_on__after_on_load=None, hx_on__after_process_node=None, | |
hx_on__after_request=None, hx_on__after_settle=None, | |
hx_on__after_swap=None, hx_on__before_cleanup_element=None, | |
hx_on__before_on_load=None, hx_on__before_process_node=None, | |
hx_on__before_request=None, hx_on__before_swap=None, | |
hx_on__before_send=None, hx_on__before_transition=None, | |
hx_on__config_request=None, hx_on__confirm=None, | |
hx_on__history_cache_error=None, hx_on__history_cache_miss=None, | |
hx_on__history_cache_miss_error=None, | |
hx_on__history_cache_miss_load=None, hx_on__history_restore=None, | |
hx_on__before_history_save=None, hx_on__load=None, | |
hx_on__no_sse_source_error=None, hx_on__on_load_error=None, | |
hx_on__oob_after_swap=None, hx_on__oob_before_swap=None, | |
hx_on__oob_error_no_target=None, hx_on__prompt=None, | |
hx_on__pushed_into_history=None, hx_on__replaced_in_history=None, | |
hx_on__response_error=None, hx_on__send_abort=None, | |
hx_on__send_error=None, hx_on__sse_error=None, | |
hx_on__sse_open=None, hx_on__swap_error=None, | |
hx_on__target_error=None, hx_on__timeout=None, | |
hx_on__validation_validate=None, hx_on__validation_failed=None, | |
hx_on__validation_halted=None, hx_on__xhr_abort=None, | |
hx_on__xhr_loadend=None, hx_on__xhr_loadstart=None, | |
hx_on__xhr_progress=None)</code></pre> | |
</blockquote> | |
<p><em>A standard SVG <code>line</code> element</em></p> | |
<div id="cell-23" class="cell"> | |
<div class="sourceCode cell-code" id="cb18"><pre class="sourceCode python code-with-copy"><code class="sourceCode python"><span id="cb18-1"><a href="#cb18-1" aria-hidden="true" tabindex="-1"></a>demo(Line(<span class="dv">20</span>, <span class="dv">30</span>, w<span class="op">=</span><span class="dv">3</span>))</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div> | |
<div class="cell-output cell-output-display"> | |
<svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 50 50" height="50" width="50"><line x1="20" y1="30" stroke="black" stroke-width="3"></line></svg> | |
</div> | |
</div> | |
<hr> | |
<p><a href="https://github.com/AnswerDotAI/fasthtml/blob/main/fasthtml/svg.py#L89" target="_blank" style="float:right; font-size:smaller">source</a></p> | |
</section> | |
<section id="polyline" class="level3"> | |
<h3 class="anchored" data-anchor-id="polyline">Polyline</h3> | |
<blockquote class="blockquote"> | |
<pre><code> Polyline (*args, points=None, fill=None, stroke=None, stroke_width=None, | |
transform=None, opacity=None, clip=None, mask=None, | |
filter=None, vector_effect=None, pointer_events=None, | |
target_id=None, hx_vals=None, hx_target=None, id=None, | |
cls=None, title=None, style=None, accesskey=None, | |
contenteditable=None, dir=None, draggable=None, | |
enterkeyhint=None, hidden=None, inert=None, inputmode=None, | |
lang=None, popover=None, spellcheck=None, tabindex=None, | |
translate=None, hx_get=None, hx_post=None, hx_put=None, | |
hx_delete=None, hx_patch=None, hx_trigger=None, hx_swap=None, | |
hx_swap_oob=None, hx_include=None, hx_select=None, | |
hx_select_oob=None, hx_indicator=None, hx_push_url=None, | |
hx_confirm=None, hx_disable=None, hx_replace_url=None, | |
hx_disabled_elt=None, hx_ext=None, hx_headers=None, | |
hx_history=None, hx_history_elt=None, hx_inherit=None, | |
hx_params=None, hx_preserve=None, hx_prompt=None, | |
hx_request=None, hx_sync=None, hx_validate=None, | |
hx_on_blur=None, hx_on_change=None, hx_on_contextmenu=None, | |
hx_on_focus=None, hx_on_input=None, hx_on_invalid=None, | |
hx_on_reset=None, hx_on_select=None, hx_on_submit=None, | |
hx_on_keydown=None, hx_on_keypress=None, hx_on_keyup=None, | |
hx_on_click=None, hx_on_dblclick=None, hx_on_mousedown=None, | |
hx_on_mouseenter=None, hx_on_mouseleave=None, | |
hx_on_mousemove=None, hx_on_mouseout=None, | |
hx_on_mouseover=None, hx_on_mouseup=None, hx_on_wheel=None, | |
hx_on__abort=None, hx_on__after_on_load=None, | |
hx_on__after_process_node=None, hx_on__after_request=None, | |
hx_on__after_settle=None, hx_on__after_swap=None, | |
hx_on__before_cleanup_element=None, hx_on__before_on_load=None, | |
hx_on__before_process_node=None, hx_on__before_request=None, | |
hx_on__before_swap=None, hx_on__before_send=None, | |
hx_on__before_transition=None, hx_on__config_request=None, | |
hx_on__confirm=None, hx_on__history_cache_error=None, | |
hx_on__history_cache_miss=None, | |
hx_on__history_cache_miss_error=None, | |
hx_on__history_cache_miss_load=None, | |
hx_on__history_restore=None, hx_on__before_history_save=None, | |
hx_on__load=None, hx_on__no_sse_source_error=None, | |
hx_on__on_load_error=None, hx_on__oob_after_swap=None, | |
hx_on__oob_before_swap=None, hx_on__oob_error_no_target=None, | |
hx_on__prompt=None, hx_on__pushed_into_history=None, | |
hx_on__replaced_in_history=None, hx_on__response_error=None, | |
hx_on__send_abort=None, hx_on__send_error=None, | |
hx_on__sse_error=None, hx_on__sse_open=None, | |
hx_on__swap_error=None, hx_on__target_error=None, | |
hx_on__timeout=None, hx_on__validation_validate=None, | |
hx_on__validation_failed=None, hx_on__validation_halted=None, | |
hx_on__xhr_abort=None, hx_on__xhr_loadend=None, | |
hx_on__xhr_loadstart=None, hx_on__xhr_progress=None)</code></pre> | |
</blockquote> | |
<p><em>A standard SVG <code>polyline</code> element</em></p> | |
<div id="cell-25" class="cell"> | |
<div class="sourceCode cell-code" id="cb20"><pre class="sourceCode python code-with-copy"><code class="sourceCode python"><span id="cb20-1"><a href="#cb20-1" aria-hidden="true" tabindex="-1"></a>demo(Polyline((<span class="dv">0</span>,<span class="dv">0</span>), (<span class="dv">10</span>,<span class="dv">10</span>), (<span class="dv">20</span>,<span class="dv">0</span>), (<span class="dv">30</span>,<span class="dv">10</span>), (<span class="dv">40</span>,<span class="dv">0</span>),</span> | |
<span id="cb20-2"><a href="#cb20-2" aria-hidden="true" tabindex="-1"></a> fill<span class="op">=</span><span class="st">'yellow'</span>, stroke<span class="op">=</span><span class="st">'blue'</span>, stroke_width<span class="op">=</span><span class="dv">2</span>))</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div> | |
<div class="cell-output cell-output-display"> | |
<svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 50 50" height="50" width="50"><polyline points="0,0 10,10 20,0 30,10 40,0" fill="yellow" stroke="blue" stroke-width="2"></polyline></svg> | |
</div> | |
</div> | |
<div id="cell-26" class="cell"> | |
<div class="sourceCode cell-code" id="cb21"><pre class="sourceCode python code-with-copy"><code class="sourceCode python"><span id="cb21-1"><a href="#cb21-1" aria-hidden="true" tabindex="-1"></a>demo(Polyline(points<span class="op">=</span><span class="st">'0,0 10,10 20,0 30,10 40,0'</span>, fill<span class="op">=</span><span class="st">'purple'</span>, stroke_width<span class="op">=</span><span class="dv">2</span>))</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div> | |
<div class="cell-output cell-output-display"> | |
<svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 50 50" height="50" width="50"><polyline points="0,0 10,10 20,0 30,10 40,0" fill="purple" stroke-width="2"></polyline></svg> | |
</div> | |
</div> | |
<hr> | |
<p><a href="https://github.com/AnswerDotAI/fasthtml/blob/main/fasthtml/svg.py#L96" target="_blank" style="float:right; font-size:smaller">source</a></p> | |
</section> | |
<section id="polygon" class="level3"> | |
<h3 class="anchored" data-anchor-id="polygon">Polygon</h3> | |
<blockquote class="blockquote"> | |
<pre><code> Polygon (*args, points=None, fill=None, stroke=None, stroke_width=None, | |
transform=None, opacity=None, clip=None, mask=None, filter=None, | |
vector_effect=None, pointer_events=None, target_id=None, | |
hx_vals=None, hx_target=None, id=None, cls=None, title=None, | |
style=None, accesskey=None, contenteditable=None, dir=None, | |
draggable=None, enterkeyhint=None, hidden=None, inert=None, | |
inputmode=None, lang=None, popover=None, spellcheck=None, | |
tabindex=None, translate=None, hx_get=None, hx_post=None, | |
hx_put=None, hx_delete=None, hx_patch=None, hx_trigger=None, | |
hx_swap=None, hx_swap_oob=None, hx_include=None, hx_select=None, | |
hx_select_oob=None, hx_indicator=None, hx_push_url=None, | |
hx_confirm=None, hx_disable=None, hx_replace_url=None, | |
hx_disabled_elt=None, hx_ext=None, hx_headers=None, | |
hx_history=None, hx_history_elt=None, hx_inherit=None, | |
hx_params=None, hx_preserve=None, hx_prompt=None, | |
hx_request=None, hx_sync=None, hx_validate=None, | |
hx_on_blur=None, hx_on_change=None, hx_on_contextmenu=None, | |
hx_on_focus=None, hx_on_input=None, hx_on_invalid=None, | |
hx_on_reset=None, hx_on_select=None, hx_on_submit=None, | |
hx_on_keydown=None, hx_on_keypress=None, hx_on_keyup=None, | |
hx_on_click=None, hx_on_dblclick=None, hx_on_mousedown=None, | |
hx_on_mouseenter=None, hx_on_mouseleave=None, | |
hx_on_mousemove=None, hx_on_mouseout=None, hx_on_mouseover=None, | |
hx_on_mouseup=None, hx_on_wheel=None, hx_on__abort=None, | |
hx_on__after_on_load=None, hx_on__after_process_node=None, | |
hx_on__after_request=None, hx_on__after_settle=None, | |
hx_on__after_swap=None, hx_on__before_cleanup_element=None, | |
hx_on__before_on_load=None, hx_on__before_process_node=None, | |
hx_on__before_request=None, hx_on__before_swap=None, | |
hx_on__before_send=None, hx_on__before_transition=None, | |
hx_on__config_request=None, hx_on__confirm=None, | |
hx_on__history_cache_error=None, hx_on__history_cache_miss=None, | |
hx_on__history_cache_miss_error=None, | |
hx_on__history_cache_miss_load=None, | |
hx_on__history_restore=None, hx_on__before_history_save=None, | |
hx_on__load=None, hx_on__no_sse_source_error=None, | |
hx_on__on_load_error=None, hx_on__oob_after_swap=None, | |
hx_on__oob_before_swap=None, hx_on__oob_error_no_target=None, | |
hx_on__prompt=None, hx_on__pushed_into_history=None, | |
hx_on__replaced_in_history=None, hx_on__response_error=None, | |
hx_on__send_abort=None, hx_on__send_error=None, | |
hx_on__sse_error=None, hx_on__sse_open=None, | |
hx_on__swap_error=None, hx_on__target_error=None, | |
hx_on__timeout=None, hx_on__validation_validate=None, | |
hx_on__validation_failed=None, hx_on__validation_halted=None, | |
hx_on__xhr_abort=None, hx_on__xhr_loadend=None, | |
hx_on__xhr_loadstart=None, hx_on__xhr_progress=None)</code></pre> | |
</blockquote> | |
<p><em>A standard SVG <code>polygon</code> element</em></p> | |
<div id="cell-28" class="cell"> | |
<div class="sourceCode cell-code" id="cb23"><pre class="sourceCode python code-with-copy"><code class="sourceCode python"><span id="cb23-1"><a href="#cb23-1" aria-hidden="true" tabindex="-1"></a>demo(Polygon((<span class="dv">25</span>,<span class="dv">5</span>), (<span class="fl">43.3</span>,<span class="dv">15</span>), (<span class="fl">43.3</span>,<span class="dv">35</span>), (<span class="dv">25</span>,<span class="dv">45</span>), (<span class="fl">6.7</span>,<span class="dv">35</span>), (<span class="fl">6.7</span>,<span class="dv">15</span>), </span> | |
<span id="cb23-2"><a href="#cb23-2" aria-hidden="true" tabindex="-1"></a> fill<span class="op">=</span><span class="st">'lightblue'</span>, stroke<span class="op">=</span><span class="st">'navy'</span>, stroke_width<span class="op">=</span><span class="dv">2</span>))</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div> | |
<div class="cell-output cell-output-display"> | |
<svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 50 50" height="50" width="50"><polygon points="25,5 43.3,15 43.3,35 25,45 6.7,35 6.7,15" fill="lightblue" stroke="navy" stroke-width="2"></polygon></svg> | |
</div> | |
</div> | |
<div id="cell-29" class="cell"> | |
<div class="sourceCode cell-code" id="cb24"><pre class="sourceCode python code-with-copy"><code class="sourceCode python"><span id="cb24-1"><a href="#cb24-1" aria-hidden="true" tabindex="-1"></a>demo(Polygon(points<span class="op">=</span><span class="st">'25,5 43.3,15 43.3,35 25,45 6.7,35 6.7,15'</span>,</span> | |
<span id="cb24-2"><a href="#cb24-2" aria-hidden="true" tabindex="-1"></a> fill<span class="op">=</span><span class="st">'lightgreen'</span>, stroke<span class="op">=</span><span class="st">'darkgreen'</span>, stroke_width<span class="op">=</span><span class="dv">2</span>))</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div> | |
<div class="cell-output cell-output-display"> | |
<svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 50 50" height="50" width="50"><polygon points="25,5 43.3,15 43.3,35 25,45 6.7,35 6.7,15" fill="lightgreen" stroke="darkgreen" stroke-width="2"></polygon></svg> | |
</div> | |
</div> | |
<hr> | |
<p><a href="https://github.com/AnswerDotAI/fasthtml/blob/main/fasthtml/svg.py#L103" target="_blank" style="float:right; font-size:smaller">source</a></p> | |
</section> | |
<section id="text" class="level3"> | |
<h3 class="anchored" data-anchor-id="text">Text</h3> | |
<blockquote class="blockquote"> | |
<pre><code> Text (*args, x=0, y=0, font_family=None, font_size=None, fill=None, | |
text_anchor=None, dominant_baseline=None, font_weight=None, | |
font_style=None, text_decoration=None, transform=None, | |
opacity=None, clip=None, mask=None, filter=None, | |
vector_effect=None, pointer_events=None, target_id=None, | |
hx_vals=None, hx_target=None, id=None, cls=None, title=None, | |
style=None, accesskey=None, contenteditable=None, dir=None, | |
draggable=None, enterkeyhint=None, hidden=None, inert=None, | |
inputmode=None, lang=None, popover=None, spellcheck=None, | |
tabindex=None, translate=None, hx_get=None, hx_post=None, | |
hx_put=None, hx_delete=None, hx_patch=None, hx_trigger=None, | |
hx_swap=None, hx_swap_oob=None, hx_include=None, hx_select=None, | |
hx_select_oob=None, hx_indicator=None, hx_push_url=None, | |
hx_confirm=None, hx_disable=None, hx_replace_url=None, | |
hx_disabled_elt=None, hx_ext=None, hx_headers=None, | |
hx_history=None, hx_history_elt=None, hx_inherit=None, | |
hx_params=None, hx_preserve=None, hx_prompt=None, hx_request=None, | |
hx_sync=None, hx_validate=None, hx_on_blur=None, hx_on_change=None, | |
hx_on_contextmenu=None, hx_on_focus=None, hx_on_input=None, | |
hx_on_invalid=None, hx_on_reset=None, hx_on_select=None, | |
hx_on_submit=None, hx_on_keydown=None, hx_on_keypress=None, | |
hx_on_keyup=None, hx_on_click=None, hx_on_dblclick=None, | |
hx_on_mousedown=None, hx_on_mouseenter=None, hx_on_mouseleave=None, | |
hx_on_mousemove=None, hx_on_mouseout=None, hx_on_mouseover=None, | |
hx_on_mouseup=None, hx_on_wheel=None, hx_on__abort=None, | |
hx_on__after_on_load=None, hx_on__after_process_node=None, | |
hx_on__after_request=None, hx_on__after_settle=None, | |
hx_on__after_swap=None, hx_on__before_cleanup_element=None, | |
hx_on__before_on_load=None, hx_on__before_process_node=None, | |
hx_on__before_request=None, hx_on__before_swap=None, | |
hx_on__before_send=None, hx_on__before_transition=None, | |
hx_on__config_request=None, hx_on__confirm=None, | |
hx_on__history_cache_error=None, hx_on__history_cache_miss=None, | |
hx_on__history_cache_miss_error=None, | |
hx_on__history_cache_miss_load=None, hx_on__history_restore=None, | |
hx_on__before_history_save=None, hx_on__load=None, | |
hx_on__no_sse_source_error=None, hx_on__on_load_error=None, | |
hx_on__oob_after_swap=None, hx_on__oob_before_swap=None, | |
hx_on__oob_error_no_target=None, hx_on__prompt=None, | |
hx_on__pushed_into_history=None, hx_on__replaced_in_history=None, | |
hx_on__response_error=None, hx_on__send_abort=None, | |
hx_on__send_error=None, hx_on__sse_error=None, | |
hx_on__sse_open=None, hx_on__swap_error=None, | |
hx_on__target_error=None, hx_on__timeout=None, | |
hx_on__validation_validate=None, hx_on__validation_failed=None, | |
hx_on__validation_halted=None, hx_on__xhr_abort=None, | |
hx_on__xhr_loadend=None, hx_on__xhr_loadstart=None, | |
hx_on__xhr_progress=None)</code></pre> | |
</blockquote> | |
<p><em>A standard SVG <code>text</code> element</em></p> | |
<div id="cell-31" class="cell"> | |
<div class="sourceCode cell-code" id="cb26"><pre class="sourceCode python code-with-copy"><code class="sourceCode python"><span id="cb26-1"><a href="#cb26-1" aria-hidden="true" tabindex="-1"></a>demo(Text(<span class="st">"Hello!"</span>, x<span class="op">=</span><span class="dv">10</span>, y<span class="op">=</span><span class="dv">30</span>))</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div> | |
<div class="cell-output cell-output-display"> | |
<svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 50 50" height="50" width="50"><text x="10" y="30">Hello!</text></svg> | |
</div> | |
</div> | |
</section> | |
</section> | |
<section id="paths" class="level2"> | |
<h2 class="anchored" data-anchor-id="paths">Paths</h2> | |
<p>Paths in SVGs are more complex, so we add a small (optional) fluent interface for constructing them:</p> | |
<hr> | |
<p><a href="https://github.com/AnswerDotAI/fasthtml/blob/main/fasthtml/svg.py#L111" target="_blank" style="float:right; font-size:smaller">source</a></p> | |
<section id="pathft" class="level3"> | |
<h3 class="anchored" data-anchor-id="pathft">PathFT</h3> | |
<blockquote class="blockquote"> | |
<pre><code> PathFT (tag:str, cs:tuple, attrs:dict=None, void_=False, **kwargs)</code></pre> | |
</blockquote> | |
<p><em>A ‘Fast Tag’ structure, containing <code>tag</code>,<code>children</code>,and <code>attrs</code></em></p> | |
<hr> | |
<p><a href="https://github.com/AnswerDotAI/fasthtml/blob/main/fasthtml/svg.py#L159" target="_blank" style="float:right; font-size:smaller">source</a></p> | |
</section> | |
<section id="path" class="level3"> | |
<h3 class="anchored" data-anchor-id="path">Path</h3> | |
<blockquote class="blockquote"> | |
<pre><code> Path (d='', fill=None, stroke=None, stroke_width=None, transform=None, | |
opacity=None, clip=None, mask=None, filter=None, | |
vector_effect=None, pointer_events=None, target_id=None, | |
hx_vals=None, hx_target=None, id=None, cls=None, title=None, | |
style=None, accesskey=None, contenteditable=None, dir=None, | |
draggable=None, enterkeyhint=None, hidden=None, inert=None, | |
inputmode=None, lang=None, popover=None, spellcheck=None, | |
tabindex=None, translate=None, hx_get=None, hx_post=None, | |
hx_put=None, hx_delete=None, hx_patch=None, hx_trigger=None, | |
hx_swap=None, hx_swap_oob=None, hx_include=None, hx_select=None, | |
hx_select_oob=None, hx_indicator=None, hx_push_url=None, | |
hx_confirm=None, hx_disable=None, hx_replace_url=None, | |
hx_disabled_elt=None, hx_ext=None, hx_headers=None, | |
hx_history=None, hx_history_elt=None, hx_inherit=None, | |
hx_params=None, hx_preserve=None, hx_prompt=None, hx_request=None, | |
hx_sync=None, hx_validate=None, hx_on_blur=None, hx_on_change=None, | |
hx_on_contextmenu=None, hx_on_focus=None, hx_on_input=None, | |
hx_on_invalid=None, hx_on_reset=None, hx_on_select=None, | |
hx_on_submit=None, hx_on_keydown=None, hx_on_keypress=None, | |
hx_on_keyup=None, hx_on_click=None, hx_on_dblclick=None, | |
hx_on_mousedown=None, hx_on_mouseenter=None, hx_on_mouseleave=None, | |
hx_on_mousemove=None, hx_on_mouseout=None, hx_on_mouseover=None, | |
hx_on_mouseup=None, hx_on_wheel=None, hx_on__abort=None, | |
hx_on__after_on_load=None, hx_on__after_process_node=None, | |
hx_on__after_request=None, hx_on__after_settle=None, | |
hx_on__after_swap=None, hx_on__before_cleanup_element=None, | |
hx_on__before_on_load=None, hx_on__before_process_node=None, | |
hx_on__before_request=None, hx_on__before_swap=None, | |
hx_on__before_send=None, hx_on__before_transition=None, | |
hx_on__config_request=None, hx_on__confirm=None, | |
hx_on__history_cache_error=None, hx_on__history_cache_miss=None, | |
hx_on__history_cache_miss_error=None, | |
hx_on__history_cache_miss_load=None, hx_on__history_restore=None, | |
hx_on__before_history_save=None, hx_on__load=None, | |
hx_on__no_sse_source_error=None, hx_on__on_load_error=None, | |
hx_on__oob_after_swap=None, hx_on__oob_before_swap=None, | |
hx_on__oob_error_no_target=None, hx_on__prompt=None, | |
hx_on__pushed_into_history=None, hx_on__replaced_in_history=None, | |
hx_on__response_error=None, hx_on__send_abort=None, | |
hx_on__send_error=None, hx_on__sse_error=None, | |
hx_on__sse_open=None, hx_on__swap_error=None, | |
hx_on__target_error=None, hx_on__timeout=None, | |
hx_on__validation_validate=None, hx_on__validation_failed=None, | |
hx_on__validation_halted=None, hx_on__xhr_abort=None, | |
hx_on__xhr_loadend=None, hx_on__xhr_loadstart=None, | |
hx_on__xhr_progress=None)</code></pre> | |
</blockquote> | |
<p><em>Create a standard <code>path</code> SVG element. This is a special object</em></p> | |
<p>Let’s create a square shape, but using <a href="https://www.fastht.ml/docs/api/svg.html#path"><code>Path</code></a> instead of <a href="https://www.fastht.ml/docs/api/svg.html#rect"><code>Rect</code></a>:</p> | |
<ul> | |
<li>M(10, 10): Move to starting point (10, 10)</li> | |
<li>L(40, 10): Line to (40, 10) - top edge</li> | |
<li>L(40, 40): Line to (40, 40) - right edge</li> | |
<li>L(10, 40): Line to (10, 40) - bottom edge</li> | |
<li>Z(): Close path - connects back to start</li> | |
</ul> | |
<p>M = Move to, L = Line to, Z = Close path</p> | |
<div id="cell-37" class="cell"> | |
<div class="sourceCode cell-code" id="cb29"><pre class="sourceCode python code-with-copy"><code class="sourceCode python"><span id="cb29-1"><a href="#cb29-1" aria-hidden="true" tabindex="-1"></a>demo(Path(fill<span class="op">=</span><span class="st">'none'</span>, stroke<span class="op">=</span><span class="st">'purple'</span>, stroke_width<span class="op">=</span><span class="dv">2</span></span> | |
<span id="cb29-2"><a href="#cb29-2" aria-hidden="true" tabindex="-1"></a> ).M(<span class="dv">10</span>, <span class="dv">10</span>).L(<span class="dv">40</span>, <span class="dv">10</span>).L(<span class="dv">40</span>, <span class="dv">40</span>).L(<span class="dv">10</span>, <span class="dv">40</span>).Z())</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div> | |
<div class="cell-output cell-output-display"> | |
<svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 50 50" height="50" width="50"><path d=" M10 10 L40 10 L40 40 L10 40 Z" fill="none" stroke="purple" stroke-width="2"></path></svg> | |
</div> | |
</div> | |
<p>Using curves we can create a spiral:</p> | |
<div id="cell-39" class="cell"> | |
<div class="sourceCode cell-code" id="cb30"><pre class="sourceCode python code-with-copy"><code class="sourceCode python"><span id="cb30-1"><a href="#cb30-1" aria-hidden="true" tabindex="-1"></a>p <span class="op">=</span> (Path(fill<span class="op">=</span><span class="st">'none'</span>, stroke<span class="op">=</span><span class="st">'purple'</span>, stroke_width<span class="op">=</span><span class="dv">2</span>)</span> | |
<span id="cb30-2"><a href="#cb30-2" aria-hidden="true" tabindex="-1"></a> .M(<span class="dv">25</span>, <span class="dv">25</span>)</span> | |
<span id="cb30-3"><a href="#cb30-3" aria-hidden="true" tabindex="-1"></a> .C(<span class="dv">25</span>, <span class="dv">25</span>, <span class="dv">20</span>, <span class="dv">20</span>, <span class="dv">30</span>, <span class="dv">20</span>)</span> | |
<span id="cb30-4"><a href="#cb30-4" aria-hidden="true" tabindex="-1"></a> .C(<span class="dv">40</span>, <span class="dv">20</span>, <span class="dv">40</span>, <span class="dv">30</span>, <span class="dv">30</span>, <span class="dv">30</span>)</span> | |
<span id="cb30-5"><a href="#cb30-5" aria-hidden="true" tabindex="-1"></a> .C(<span class="dv">20</span>, <span class="dv">30</span>, <span class="dv">20</span>, <span class="dv">15</span>, <span class="dv">35</span>, <span class="dv">15</span>)</span> | |
<span id="cb30-6"><a href="#cb30-6" aria-hidden="true" tabindex="-1"></a> .C(<span class="dv">50</span>, <span class="dv">15</span>, <span class="dv">50</span>, <span class="dv">35</span>, <span class="dv">25</span>, <span class="dv">35</span>)</span> | |
<span id="cb30-7"><a href="#cb30-7" aria-hidden="true" tabindex="-1"></a> .C(<span class="dv">0</span>, <span class="dv">35</span>, <span class="dv">0</span>, <span class="dv">10</span>, <span class="dv">40</span>, <span class="dv">10</span>)</span> | |
<span id="cb30-8"><a href="#cb30-8" aria-hidden="true" tabindex="-1"></a> .C(<span class="dv">80</span>, <span class="dv">10</span>, <span class="dv">80</span>, <span class="dv">40</span>, <span class="dv">25</span>, <span class="dv">40</span>))</span> | |
<span id="cb30-9"><a href="#cb30-9" aria-hidden="true" tabindex="-1"></a>demo(p, <span class="dv">50</span>, <span class="dv">100</span>)</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div> | |
<div class="cell-output cell-output-display"> | |
<svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 100 50" height="50" width="100"><path d=" M25 25 C25 25 20 20 30 20 C40 20 40 30 30 30 C20 30 20 15 35 15 C50 15 50 35 25 35 C0 35 0 10 40 10 C80 10 80 40 25 40" fill="none" stroke="purple" stroke-width="2"></path></svg> | |
</div> | |
</div> | |
<p>Using arcs and curves we can create a map marker icon:</p> | |
<div id="cell-41" class="cell"> | |
<div class="sourceCode cell-code" id="cb31"><pre class="sourceCode python code-with-copy"><code class="sourceCode python"><span id="cb31-1"><a href="#cb31-1" aria-hidden="true" tabindex="-1"></a>p <span class="op">=</span> (Path(fill<span class="op">=</span><span class="st">'red'</span>)</span> | |
<span id="cb31-2"><a href="#cb31-2" aria-hidden="true" tabindex="-1"></a> .M(<span class="dv">25</span>,<span class="dv">45</span>)</span> | |
<span id="cb31-3"><a href="#cb31-3" aria-hidden="true" tabindex="-1"></a> .C(<span class="dv">25</span>,<span class="dv">45</span>,<span class="dv">10</span>,<span class="dv">35</span>,<span class="dv">10</span>,<span class="dv">25</span>)</span> | |
<span id="cb31-4"><a href="#cb31-4" aria-hidden="true" tabindex="-1"></a> .A(<span class="dv">15</span>,<span class="dv">15</span>,<span class="dv">0</span>,<span class="dv">1</span>,<span class="dv">1</span>,<span class="dv">40</span>,<span class="dv">25</span>)</span> | |
<span id="cb31-5"><a href="#cb31-5" aria-hidden="true" tabindex="-1"></a> .C(<span class="dv">40</span>,<span class="dv">35</span>,<span class="dv">25</span>,<span class="dv">45</span>,<span class="dv">25</span>,<span class="dv">45</span>)</span> | |
<span id="cb31-6"><a href="#cb31-6" aria-hidden="true" tabindex="-1"></a> .Z())</span> | |
<span id="cb31-7"><a href="#cb31-7" aria-hidden="true" tabindex="-1"></a>demo(p)</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div> | |
<div class="cell-output cell-output-display"> | |
<svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 50 50" height="50" width="50"><path d=" M25 45 C25 45 10 35 10 25 A15 15 0 1 1 40 25 C40 35 25 45 25 45 Z" fill="red"></path></svg> | |
</div> | |
</div> | |
<p>Behind the scenes it’s just creating regular SVG path <code>d</code> attr – you can pass <code>d</code> in directly if you prefer.</p> | |
<div id="cell-43" class="cell"> | |
<div class="sourceCode cell-code" id="cb32"><pre class="sourceCode python code-with-copy"><code class="sourceCode python"><span id="cb32-1"><a href="#cb32-1" aria-hidden="true" tabindex="-1"></a><span class="bu">print</span>(p.d)</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div> | |
<div class="cell-output cell-output-stdout"> | |
<pre><code> M25 45 C25 45 10 35 10 25 A15 15 0 1 1 40 25 C40 35 25 45 25 45 Z</code></pre> | |
</div> | |
</div> | |
<div id="cell-44" class="cell"> | |
<div class="sourceCode cell-code" id="cb34"><pre class="sourceCode python code-with-copy"><code class="sourceCode python"><span id="cb34-1"><a href="#cb34-1" aria-hidden="true" tabindex="-1"></a>demo(Path(d<span class="op">=</span><span class="st">'M25 45 C25 45 10 35 10 25 A15 15 0 1 1 40 25 C40 35 25 45 25 45 Z'</span>))</span></code><button title="Copy to Clipboard" class="code-copy-button"><i class="bi"></i></button></pre></div> | |
<div class="cell-output cell-output-display"> | |
<svg xmlns="http://www.w3.org/2000/svg" viewbox="0 0 50 50" height="50" width="50"><path d="M25 45 C25 45 10 35 10 25 A15 15 0 1 1 40 25 C40 35 25 45 25 45 Z"></path></svg> | |
</div> | |
</div> | |
<hr> | |
<p><a href="https://github.com/AnswerDotAI/fasthtml/blob/main/fasthtml/svg.py#L117" target="_blank" style="float:right; font-size:smaller">source</a></p> | |
</section> | |
<section id="pathft.m" class="level3"> | |
<h3 class="anchored" data-anchor-id="pathft.m">PathFT.M</h3> | |
<blockquote class="blockquote"> | |
<pre><code> PathFT.M (x, y)</code></pre> | |
</blockquote> | |
<p><em>Move to.</em></p> | |
<hr> | |
<p><a href="https://github.com/AnswerDotAI/fasthtml/blob/main/fasthtml/svg.py#L121" target="_blank" style="float:right; font-size:smaller">source</a></p> | |
</section> | |
<section id="pathft.l" class="level3"> | |
<h3 class="anchored" data-anchor-id="pathft.l">PathFT.L</h3> | |
<blockquote class="blockquote"> | |
<pre><code> PathFT.L (x, y)</code></pre> | |
</blockquote> | |
<p><em>Line to.</em></p> | |
<hr> | |
<p><a href="https://github.com/AnswerDotAI/fasthtml/blob/main/fasthtml/svg.py#L125" target="_blank" style="float:right; font-size:smaller">source</a></p> | |
</section> | |
<section id="pathft.h" class="level3"> | |
<h3 class="anchored" data-anchor-id="pathft.h">PathFT.H</h3> | |
<blockquote class="blockquote"> | |
<pre><code> PathFT.H (x)</code></pre> | |
</blockquote> | |
<p><em>Horizontal line to.</em></p> | |
<hr> | |
<p><a href="https://github.com/AnswerDotAI/fasthtml/blob/main/fasthtml/svg.py#L129" target="_blank" style="float:right; font-size:smaller">source</a></p> | |
</section> | |
<section id="pathft.v" class="level3"> | |
<h3 class="anchored" data-anchor-id="pathft.v">PathFT.V</h3> | |
<blockquote class="blockquote"> | |
<pre><code> PathFT.V (y)</code></pre> | |
</blockquote> | |
<p><em>Vertical line to.</em></p> | |
<hr> | |
<p><a href="https://github.com/AnswerDotAI/fasthtml/blob/main/fasthtml/svg.py#L133" target="_blank" style="float:right; font-size:smaller">source</a></p> | |
</section> | |
<section id="pathft.z" class="level3"> | |
<h3 class="anchored" data-anchor-id="pathft.z">PathFT.Z</h3> | |
<blockquote class="blockquote"> | |
<pre><code> PathFT.Z ()</code></pre> | |
</blockquote> | |
<p><em>Close path.</em></p> | |
<hr> | |
<p><a href="https://github.com/AnswerDotAI/fasthtml/blob/main/fasthtml/svg.py#L137" target="_blank" style="float:right; font-size:smaller">source</a></p> | |
</section> | |
<section id="pathft.c" class="level3"> | |
<h3 class="anchored" data-anchor-id="pathft.c">PathFT.C</h3> | |
<blockquote class="blockquote"> | |
<pre><code> PathFT.C (x1, y1, x2, y2, x, y)</code></pre> | |
</blockquote> | |
<p><em>Cubic Bézier curve.</em></p> | |
<hr> | |
<p><a href="https://github.com/AnswerDotAI/fasthtml/blob/main/fasthtml/svg.py#L141" target="_blank" style="float:right; font-size:smaller">source</a></p> | |
</section> | |
<section id="pathft.s" class="level3"> | |
<h3 class="anchored" data-anchor-id="pathft.s">PathFT.S</h3> | |
<blockquote class="blockquote"> | |
<pre><code> PathFT.S (x2, y2, x, y)</code></pre> | |
</blockquote> | |
<p><em>Smooth cubic Bézier curve.</em></p> | |
<hr> | |
<p><a href="https://github.com/AnswerDotAI/fasthtml/blob/main/fasthtml/svg.py#L145" target="_blank" style="float:right; font-size:smaller">source</a></p> | |
</section> | |
<section id="pathft.q" class="level3"> | |
<h3 class="anchored" data-anchor-id="pathft.q">PathFT.Q</h3> | |
<blockquote class="blockquote"> | |
<pre><code> PathFT.Q (x1, y1, x, y)</code></pre> | |
</blockquote> | |
<p><em>Quadratic Bézier curve.</em></p> | |
<hr> | |
<p><a href="https://github.com/AnswerDotAI/fasthtml/blob/main/fasthtml/svg.py#L149" target="_blank" style="float:right; font-size:smaller">source</a></p> | |
</section> | |
<section id="pathft.t" class="level3"> | |
<h3 class="anchored" data-anchor-id="pathft.t">PathFT.T</h3> | |
<blockquote class="blockquote"> | |
<pre><code> PathFT.T (x, y)</code></pre> | |
</blockquote> | |
<p><em>Smooth quadratic Bézier curve.</em></p> | |
<hr> | |
<p><a href="https://github.com/AnswerDotAI/fasthtml/blob/main/fasthtml/svg.py#L153" target="_blank" style="float:right; font-size:smaller">source</a></p> | |
</section> | |
<section id="pathft.a" class="level3"> | |
<h3 class="anchored" data-anchor-id="pathft.a">PathFT.A</h3> | |
<blockquote class="blockquote"> | |
<pre><code> PathFT.A (rx, ry, x_axis_rotation, large_arc_flag, sweep_flag, x, y)</code></pre> | |
</blockquote> | |
<p><em>Elliptical Arc.</em></p> | |
</section> | |
</section> | |
<section id="htmx-helpers" class="level2"> | |
<h2 class="anchored" data-anchor-id="htmx-helpers">HTMX helpers</h2> | |
<hr> | |
<p><a href="https://github.com/AnswerDotAI/fasthtml/blob/main/fasthtml/svg.py#L167" target="_blank" style="float:right; font-size:smaller">source</a></p> | |
<section id="svgoob" class="level3"> | |
<h3 class="anchored" data-anchor-id="svgoob">SvgOob</h3> | |
<blockquote class="blockquote"> | |
<pre><code> SvgOob (*args, **kwargs)</code></pre> | |
</blockquote> | |
<p><em>Wraps an SVG shape as required for an HTMX OOB swap</em></p> | |
<p>When returning an SVG shape out-of-band (OOB) in HTMX, you need to wrap it with <a href="https://www.fastht.ml/docs/api/svg.html#svgoob"><code>SvgOob</code></a> to have it appear correctly. (<a href="https://www.fastht.ml/docs/api/svg.html#svgoob"><code>SvgOob</code></a> is just a shortcut for <code>Template(Svg(...))</code>, which is the trick that makes SVG OOB swaps work.)</p> | |
<hr> | |
<p><a href="https://github.com/AnswerDotAI/fasthtml/blob/main/fasthtml/svg.py#L172" target="_blank" style="float:right; font-size:smaller">source</a></p> | |
</section> | |
<section id="svginb" class="level3"> | |
<h3 class="anchored" data-anchor-id="svginb">SvgInb</h3> | |
<blockquote class="blockquote"> | |
<pre><code> SvgInb (*args, **kwargs)</code></pre> | |
</blockquote> | |
<p><em>Wraps an SVG shape as required for an HTMX inband swap</em></p> | |
<p>When returning an SVG shape in-band in HTMX, either have the calling element include <code>hx_select='svg>*'</code>, or <code>**svg_inb</code> (which are two ways of saying the same thing), or wrap the response with <a href="https://www.fastht.ml/docs/api/svg.html#svginb"><code>SvgInb</code></a> to have it appear correctly. (<a href="https://www.fastht.ml/docs/api/svg.html#svginb"><code>SvgInb</code></a> is just a shortcut for the tuple <code>(Svg(...), HtmxResponseHeaders(hx_reselect='svg>*'))</code>, which is the trick that makes SVG in-band swaps work.)</p> | |
</section> | |
</section> | |
</main> <!-- /main --> | |
<script id="quarto-html-after-body" type="application/javascript"> | |
window.document.addEventListener("DOMContentLoaded", function (event) { | |
const toggleBodyColorMode = (bsSheetEl) => { | |
const mode = bsSheetEl.getAttribute("data-mode"); | |
const bodyEl = window.document.querySelector("body"); | |
if (mode === "dark") { | |
bodyEl.classList.add("quarto-dark"); | |
bodyEl.classList.remove("quarto-light"); | |
} else { | |
bodyEl.classList.add("quarto-light"); | |
bodyEl.classList.remove("quarto-dark"); | |
} | |
} | |
const toggleBodyColorPrimary = () => { | |
const bsSheetEl = window.document.querySelector("link#quarto-bootstrap"); | |
if (bsSheetEl) { | |
toggleBodyColorMode(bsSheetEl); | |
} | |
} | |
toggleBodyColorPrimary(); | |
const icon = ""; | |
const anchorJS = new window.AnchorJS(); | |
anchorJS.options = { | |
placement: 'right', | |
icon: icon | |
}; | |
anchorJS.add('.anchored'); | |
const isCodeAnnotation = (el) => { | |
for (const clz of el.classList) { | |
if (clz.startsWith('code-annotation-')) { | |
return true; | |
} | |
} | |
return false; | |
} | |
const onCopySuccess = function(e) { | |
// button target | |
const button = e.trigger; | |
// don't keep focus | |
button.blur(); | |
// flash "checked" | |
button.classList.add('code-copy-button-checked'); | |
var currentTitle = button.getAttribute("title"); | |
button.setAttribute("title", "Copied!"); | |
let tooltip; | |
if (window.bootstrap) { | |
button.setAttribute("data-bs-toggle", "tooltip"); | |
button.setAttribute("data-bs-placement", "left"); | |
button.setAttribute("data-bs-title", "Copied!"); | |
tooltip = new bootstrap.Tooltip(button, | |
{ trigger: "manual", | |
customClass: "code-copy-button-tooltip", | |
offset: [0, -8]}); | |
tooltip.show(); | |
} | |
setTimeout(function() { | |
if (tooltip) { | |
tooltip.hide(); | |
button.removeAttribute("data-bs-title"); | |
button.removeAttribute("data-bs-toggle"); | |
button.removeAttribute("data-bs-placement"); | |
} | |
button.setAttribute("title", currentTitle); | |
button.classList.remove('code-copy-button-checked'); | |
}, 1000); | |
// clear code selection | |
e.clearSelection(); | |
} | |
const getTextToCopy = function(trigger) { | |
const codeEl = trigger.previousElementSibling.cloneNode(true); | |
for (const childEl of codeEl.children) { | |
if (isCodeAnnotation(childEl)) { | |
childEl.remove(); | |
} | |
} | |
return codeEl.innerText; | |
} | |
const clipboard = new window.ClipboardJS('.code-copy-button:not([data-in-quarto-modal])', { | |
text: getTextToCopy | |
}); | |
clipboard.on('success', onCopySuccess); | |
if (window.document.getElementById('quarto-embedded-source-code-modal')) { | |
const clipboardModal = new window.ClipboardJS('.code-copy-button[data-in-quarto-modal]', { | |
text: getTextToCopy, | |
container: window.document.getElementById('quarto-embedded-source-code-modal') | |
}); | |
clipboardModal.on('success', onCopySuccess); | |
} | |
var localhostRegex = new RegExp(/^(?:http|https):\/\/localhost\:?[0-9]*\//); | |
var mailtoRegex = new RegExp(/^mailto:/); | |
var filterRegex = new RegExp("https:\/\/www\.fastht\.ml\/docs\/"); | |
var isInternal = (href) => { | |
return filterRegex.test(href) || localhostRegex.test(href) || mailtoRegex.test(href); | |
} | |
// Inspect non-navigation links and adorn them if external | |
var links = window.document.querySelectorAll('a[href]:not(.nav-link):not(.navbar-brand):not(.toc-action):not(.sidebar-link):not(.sidebar-item-toggle):not(.pagination-link):not(.no-external):not([aria-hidden]):not(.dropdown-item):not(.quarto-navigation-tool):not(.about-link)'); | |
for (var i=0; i<links.length; i++) { | |
const link = links[i]; | |
if (!isInternal(link.href)) { | |
// undo the damage that might have been done by quarto-nav.js in the case of | |
// links that we want to consider external | |
if (link.dataset.originalHref !== undefined) { | |
link.href = link.dataset.originalHref; | |
} | |
} | |
} | |
function tippyHover(el, contentFn, onTriggerFn, onUntriggerFn) { | |
const config = { | |
allowHTML: true, | |
maxWidth: 500, | |
delay: 100, | |
arrow: false, | |
appendTo: function(el) { | |
return el.parentElement; | |
}, | |
interactive: true, | |
interactiveBorder: 10, | |
theme: 'quarto', | |
placement: 'bottom-start', | |
}; | |
if (contentFn) { | |
config.content = contentFn; | |
} | |
if (onTriggerFn) { | |
config.onTrigger = onTriggerFn; | |
} | |
if (onUntriggerFn) { | |
config.onUntrigger = onUntriggerFn; | |
} | |
window.tippy(el, config); | |
} | |
const noterefs = window.document.querySelectorAll('a[role="doc-noteref"]'); | |
for (var i=0; i<noterefs.length; i++) { | |
const ref = noterefs[i]; | |
tippyHover(ref, function() { | |
// use id or data attribute instead here | |
let href = ref.getAttribute('data-footnote-href') || ref.getAttribute('href'); | |
try { href = new URL(href).hash; } catch {} | |
const id = href.replace(/^#\/?/, ""); | |
const note = window.document.getElementById(id); | |
if (note) { | |
return note.innerHTML; | |
} else { | |
return ""; | |
} | |
}); | |
} | |
const xrefs = window.document.querySelectorAll('a.quarto-xref'); | |
const processXRef = (id, note) => { | |
// Strip column container classes | |
const stripColumnClz = (el) => { | |
el.classList.remove("page-full", "page-columns"); | |
if (el.children) { | |
for (const child of el.children) { | |
stripColumnClz(child); | |
} | |
} | |
} | |
stripColumnClz(note) | |
if (id === null || id.startsWith('sec-')) { | |
// Special case sections, only their first couple elements | |
const container = document.createElement("div"); | |
if (note.children && note.children.length > 2) { | |
container.appendChild(note.children[0].cloneNode(true)); | |
for (let i = 1; i < note.children.length; i++) { | |
const child = note.children[i]; | |
if (child.tagName === "P" && child.innerText === "") { | |
continue; | |
} else { | |
container.appendChild(child.cloneNode(true)); | |
break; | |
} | |
} | |
if (window.Quarto?.typesetMath) { | |
window.Quarto.typesetMath(container); | |
} | |
return container.innerHTML | |
} else { | |
if (window.Quarto?.typesetMath) { | |
window.Quarto.typesetMath(note); | |
} | |
return note.innerHTML; | |
} | |
} else { | |
// Remove any anchor links if they are present | |
const anchorLink = note.querySelector('a.anchorjs-link'); | |
if (anchorLink) { | |
anchorLink.remove(); | |
} | |
if (window.Quarto?.typesetMath) { | |
window.Quarto.typesetMath(note); | |
} | |
if (note.classList.contains("callout")) { | |
return note.outerHTML; | |
} else { | |
return note.innerHTML; | |
} | |
} | |
} | |
for (var i=0; i<xrefs.length; i++) { | |
const xref = xrefs[i]; | |
tippyHover(xref, undefined, function(instance) { | |
instance.disable(); | |
let url = xref.getAttribute('href'); | |
let hash = undefined; | |
if (url.startsWith('#')) { | |
hash = url; | |
} else { | |
try { hash = new URL(url).hash; } catch {} | |
} | |
if (hash) { | |
const id = hash.replace(/^#\/?/, ""); | |
const note = window.document.getElementById(id); | |
if (note !== null) { | |
try { | |
const html = processXRef(id, note.cloneNode(true)); | |
instance.setContent(html); | |
} finally { | |
instance.enable(); | |
instance.show(); | |
} | |
} else { | |
// See if we can fetch this | |
fetch(url.split('#')[0]) | |
.then(res => res.text()) | |
.then(html => { | |
const parser = new DOMParser(); | |
const htmlDoc = parser.parseFromString(html, "text/html"); | |
const note = htmlDoc.getElementById(id); | |
if (note !== null) { | |
const html = processXRef(id, note); | |
instance.setContent(html); | |
} | |
}).finally(() => { | |
instance.enable(); | |
instance.show(); | |
}); | |
} | |
} else { | |
// See if we can fetch a full url (with no hash to target) | |
// This is a special case and we should probably do some content thinning / targeting | |
fetch(url) | |
.then(res => res.text()) | |
.then(html => { | |
const parser = new DOMParser(); | |
const htmlDoc = parser.parseFromString(html, "text/html"); | |
const note = htmlDoc.querySelector('main.content'); | |
if (note !== null) { | |
// This should only happen for chapter cross references | |
// (since there is no id in the URL) | |
// remove the first header | |
if (note.children.length > 0 && note.children[0].tagName === "HEADER") { | |
note.children[0].remove(); | |
} | |
const html = processXRef(null, note); | |
instance.setContent(html); | |
} | |
}).finally(() => { | |
instance.enable(); | |
instance.show(); | |
}); | |
} | |
}, function(instance) { | |
}); | |
} | |
let selectedAnnoteEl; | |
const selectorForAnnotation = ( cell, annotation) => { | |
let cellAttr = 'data-code-cell="' + cell + '"'; | |
let lineAttr = 'data-code-annotation="' + annotation + '"'; | |
const selector = 'span[' + cellAttr + '][' + lineAttr + ']'; | |
return selector; | |
} | |
const selectCodeLines = (annoteEl) => { | |
const doc = window.document; | |
const targetCell = annoteEl.getAttribute("data-target-cell"); | |
const targetAnnotation = annoteEl.getAttribute("data-target-annotation"); | |
const annoteSpan = window.document.querySelector(selectorForAnnotation(targetCell, targetAnnotation)); | |
const lines = annoteSpan.getAttribute("data-code-lines").split(","); | |
const lineIds = lines.map((line) => { | |
return targetCell + "-" + line; | |
}) | |
let top = null; | |
let height = null; | |
let parent = null; | |
if (lineIds.length > 0) { | |
//compute the position of the single el (top and bottom and make a div) | |
const el = window.document.getElementById(lineIds[0]); | |
top = el.offsetTop; | |
height = el.offsetHeight; | |
parent = el.parentElement.parentElement; | |
if (lineIds.length > 1) { | |
const lastEl = window.document.getElementById(lineIds[lineIds.length - 1]); | |
const bottom = lastEl.offsetTop + lastEl.offsetHeight; | |
height = bottom - top; | |
} | |
if (top !== null && height !== null && parent !== null) { | |
// cook up a div (if necessary) and position it | |
let div = window.document.getElementById("code-annotation-line-highlight"); | |
if (div === null) { | |
div = window.document.createElement("div"); | |
div.setAttribute("id", "code-annotation-line-highlight"); | |
div.style.position = 'absolute'; | |
parent.appendChild(div); | |
} | |
div.style.top = top - 2 + "px"; | |
div.style.height = height + 4 + "px"; | |
div.style.left = 0; | |
let gutterDiv = window.document.getElementById("code-annotation-line-highlight-gutter"); | |
if (gutterDiv === null) { | |
gutterDiv = window.document.createElement("div"); | |
gutterDiv.setAttribute("id", "code-annotation-line-highlight-gutter"); | |
gutterDiv.style.position = 'absolute'; | |
const codeCell = window.document.getElementById(targetCell); | |
const gutter = codeCell.querySelector('.code-annotation-gutter'); | |
gutter.appendChild(gutterDiv); | |
} | |
gutterDiv.style.top = top - 2 + "px"; | |
gutterDiv.style.height = height + 4 + "px"; | |
} | |
selectedAnnoteEl = annoteEl; | |
} | |
}; | |
const unselectCodeLines = () => { | |
const elementsIds = ["code-annotation-line-highlight", "code-annotation-line-highlight-gutter"]; | |
elementsIds.forEach((elId) => { | |
const div = window.document.getElementById(elId); | |
if (div) { | |
div.remove(); | |
} | |
}); | |
selectedAnnoteEl = undefined; | |
}; | |
// Handle positioning of the toggle | |
window.addEventListener( | |
"resize", | |
throttle(() => { | |
elRect = undefined; | |
if (selectedAnnoteEl) { | |
selectCodeLines(selectedAnnoteEl); | |
} | |
}, 10) | |
); | |
function throttle(fn, ms) { | |
let throttle = false; | |
let timer; | |
return (...args) => { | |
if(!throttle) { // first call gets through | |
fn.apply(this, args); | |
throttle = true; | |
} else { // all the others get throttled | |
if(timer) clearTimeout(timer); // cancel #2 | |
timer = setTimeout(() => { | |
fn.apply(this, args); | |
timer = throttle = false; | |
}, ms); | |
} | |
}; | |
} | |
// Attach click handler to the DT | |
const annoteDls = window.document.querySelectorAll('dt[data-target-cell]'); | |
for (const annoteDlNode of annoteDls) { | |
annoteDlNode.addEventListener('click', (event) => { | |
const clickedEl = event.target; | |
if (clickedEl !== selectedAnnoteEl) { | |
unselectCodeLines(); | |
const activeEl = window.document.querySelector('dt[data-target-cell].code-annotation-active'); | |
if (activeEl) { | |
activeEl.classList.remove('code-annotation-active'); | |
} | |
selectCodeLines(clickedEl); | |
clickedEl.classList.add('code-annotation-active'); | |
} else { | |
// Unselect the line | |
unselectCodeLines(); | |
clickedEl.classList.remove('code-annotation-active'); | |
} | |
}); | |
} | |
const findCites = (el) => { | |
const parentEl = el.parentElement; | |
if (parentEl) { | |
const cites = parentEl.dataset.cites; | |
if (cites) { | |
return { | |
el, | |
cites: cites.split(' ') | |
}; | |
} else { | |
return findCites(el.parentElement) | |
} | |
} else { | |
return undefined; | |
} | |
}; | |
var bibliorefs = window.document.querySelectorAll('a[role="doc-biblioref"]'); | |
for (var i=0; i<bibliorefs.length; i++) { | |
const ref = bibliorefs[i]; | |
const citeInfo = findCites(ref); | |
if (citeInfo) { | |
tippyHover(citeInfo.el, function() { | |
var popup = window.document.createElement('div'); | |
citeInfo.cites.forEach(function(cite) { | |
var citeDiv = window.document.createElement('div'); | |
citeDiv.classList.add('hanging-indent'); | |
citeDiv.classList.add('csl-entry'); | |
var biblioDiv = window.document.getElementById('ref-' + cite); | |
if (biblioDiv) { | |
citeDiv.innerHTML = biblioDiv.innerHTML; | |
} | |
popup.appendChild(citeDiv); | |
}); | |
return popup.innerHTML; | |
}); | |
} | |
} | |
}); | |
</script> | |
</div> <!-- /content --> | |
<footer class="footer"><div class="nav-footer"><div class="nav-footer-center"><div class="toc-actions d-sm-block d-md-none"><ul><li><a href="https://github.com/AnswerDotAI/fasthtml/issues/new" class="toc-action"><i class="bi bi-github"></i>Report an issue</a></li></ul></div></div></div></footer></body></html> |