loco-rs 1.0.1

The one-person framework for Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118

---
// Docs version switcher (v1.0 ▾) shown beside the wordmark in the docs
// header. Extracted from the former SiteTitleWithVersion override: the docs
// Header (src/components/starlight/Header.astro) now renders the marketing
// brand directly and drops it in next to the wordmark, so this no longer
// wraps Starlight's SiteTitle. See src/lib/versions.ts for the version list.
import { docVersions } from '../lib/versions';

const current = docVersions.find((v) => v.current) ?? docVersions[0];
---

<details class="ver-switcher" data-version-switcher>
  <summary class="ver" aria-label={`Docs version: ${current.label}`}>
    {current.label}
    <span class="chevron" aria-hidden="true">▾</span>
  </summary>
  <ul class="ver-menu" role="list">
    {
      docVersions.map((v) => (
        <li>
          <a href={v.href} aria-current={v.current ? 'true' : undefined}>
            {v.label}
          </a>
        </li>
      ))
    }
  </ul>
</details>

<script>
  // Native <details> stays open on outside click/Escape by default; close it
  // to match the conventional dropdown behavior.
  document.querySelectorAll<HTMLDetailsElement>('[data-version-switcher]').forEach((el) => {
    document.addEventListener('click', (e) => {
      if (el.open && !el.contains(e.target as Node)) el.open = false;
    });
    el.addEventListener('keydown', (e) => {
      if (e.key === 'Escape' && el.open) {
        el.open = false;
        el.querySelector('summary')?.focus();
      }
    });
  });
</script>

<style>
  .ver-switcher {
    position: relative;
    flex-shrink: 0;
  }
  .ver {
    display: flex;
    align-items: center;
    gap: 0.3rem;
    font-family: var(--sl-font-mono, var(--mono));
    font-size: 0.72rem;
    color: var(--ink-2);
    border: 1px solid var(--line);
    background: var(--card);
    padding: 0.19rem 0.55rem;
    border-radius: 0.45rem;
    cursor: pointer;
    user-select: none;
    list-style: none;
    white-space: nowrap;
  }
  .ver::-webkit-details-marker {
    display: none;
  }
  .ver:hover {
    border-color: var(--ink-3);
    color: var(--ink);
  }
  .ver-switcher[open] .ver {
    border-color: var(--red);
    color: var(--ink);
  }
  .chevron {
    font-size: 0.65rem;
    transition: transform 0.15s ease;
  }
  .ver-switcher[open] .chevron {
    transform: rotate(180deg);
  }
  .ver-menu {
    position: absolute;
    top: calc(100% + 0.4rem);
    left: 0;
    min-width: 6rem;
    margin: 0;
    padding: 0.35rem;
    background: var(--card);
    border: 1px solid var(--line);
    border-radius: 0.55rem;
    box-shadow: 0 12px 24px -12px rgba(0, 0, 0, 0.35);
    z-index: 30;
  }
  .ver-menu li {
    list-style: none;
  }
  .ver-menu a {
    display: block;
    padding: 0.3rem 0.55rem;
    border-radius: 0.35rem;
    font-family: var(--sl-font-mono, var(--mono));
    font-size: 0.8rem;
    color: var(--ink-2);
    text-decoration: none;
  }
  .ver-menu a:hover {
    background: var(--paper-2);
    color: var(--ink);
  }
  .ver-menu a[aria-current='true'] {
    color: var(--red-ink);
    font-weight: 650;
  }
</style>