ki-source
@kimen/elements/ki-source- Source
- Agent reference
Put ki-source directly inside a Sources disclosure.
Give it an id or guarded source-id, a web href, and a readable title.
The optional snippet adds a short plain-text excerpt. The disclosure
derives the hostname from the resolved destination and shows the title
as the link’s name. Use sourceTitle for the title prop in JSX.
When to use: As a direct child of ki-sources. In HTML provide an id, href and title; in guarded specs provide source-id, href and title. Use the same identifier on any citation of the source.
When not to use: For standalone links outside a source list; use ki-link.
Properties & attributes
| Attribute | Property | Type | Default | Description |
|---|---|---|---|---|
href | href | string | – | Source destination. Accepts HTTP(S) URLs and relative web references. The source list shows the resolved hostname. |
snippet | snippet | string | undefined | – | Optional plain-text excerpt displayed in the source card. |
source-id | sourceId | string | undefined | – | Source identifier in this document or shadow root. Overrides the native HTML id when set. Use this value in guarded specs and in citation refs. |
title | sourceTitle | string | – | Required plain-text source title. In HTML use the title attribute. |
CSS custom properties
The public styling contract of ki-source: reassign these tokens at :root or on a subtree — never override internals.
| Token | Description |
|---|---|
--ki-typography-family-body | semantic font family for typography family body. |