SVG ornaments
Astromer 的 SVG ornament 是明確選用的呈現元件。它們不會自動加到 Button、Card 或其他基礎元件上,也不需要額外的全域 SVG sprite、JavaScript 或 ornament stylesheet。
---import OrbitFrame from "@astromer/core/components/OrbitFrame.astro";import Spark from "@astromer/core/components/Spark.astro";---
<OrbitFrame variant="double"> <article> <Spark rays={8} size="sm" /> <h2>讓內容保有自己的軌道</h2> <p>框架只襯托內容,不改變內容順序或語意。</p> </article></OrbitFrame>Orbit frame
細線軌道只包圍這段內容。軌道與符號都是裝飾。
Corner frame
短角線襯托標題與內文,不裁切內容或控制項的 focus ring。
Editorial frame
內框與側邊索引線適合短篇編輯內容。實際文字仍由 HTML 提供。
| 元件 | Props | 用途 |
|---|---|---|
Spark |
rays 為 4 或 8;size 為 sm、md 或 lg |
單一星芒符號;射線數與尺寸可獨立選擇。 |
OrbitFrame |
variant 為 single 或 double |
一條或兩條靜態橢圓軌道。 |
CornerFrame |
inset 為 sm 或 md |
四角短線框架。 |
EditorialFrame |
— | 內框與稀疏側邊標記。 |
四個元件都接受可選的 class。符號和 SVG 框線只傳達裝飾,不應承載必要資訊。幾何採用 currentColor;--am-ornament-color、--am-ornament-line-width 與 --am-ornament-opacity 可在 consumer CSS 中調整裝飾色、線寬與透明度,不會改變 frame slot 的文字色。框架保留 default slot 原有的 HTML 結構與順序,並避免裁切鍵盤焦點外框。
所有圖形目前都是靜態 SVG,沒有動畫,也不會在 prefers-reduced-motion 下改變內容或狀態。若幾何需要隱藏或呈現方式不同,請直接用正常的 HTML/CSS 控制內容;不要把資訊只放在裝飾圖形裡。
這些元件沿用 core 的 Astro component subpath export。由於它們是版面呈現工具,不是可序列化的內容區塊,所以不列入面向編輯器的 registry。當下元件成熟度為漸進增強;consumer package artifact 驗證完成前,請把它們視為可選的視覺工具。
Celestial 視覺 Theme CSS 是另一個選用層,請參考主題指南與Celestial Playground。