FamilyProperties Type — astro Architecture

Source Code

packages/astro/src/assets/fonts/types.ts lines 60–89

export interface FamilyProperties {
	/**
	 * @default `"swap"`
	 *
	 * Defines [how a font displays](https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-display) based on when it is downloaded and ready for use.
	 */
	display?: Display | undefined;
	/**
	 * A [font stretch](https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-stretch).
	 */
	stretch?: string | undefined;
	/**
	 * Controls the [typographic font features](https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-feature-settings) (e.g. ligatures, small caps, or swashes).
	 */
	featureSettings?: string | undefined;
	/**
	 * Font [variation settings](https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/font-variation-settings).
	 */
	variationSettings?: string | undefined;
	/**
	 * Determines when a font must be downloaded and used based on a specific [range of unicode characters](https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face/unicode-range).
	 * If a character on the page matches the configured range, the browser will download the font and all characters will be available for use on the page. To configure a subset of
	 * characters preloaded for a single font, see the [subsets](#fontsubsets) property instead.
	 *
	 * This can be useful for localization to avoid unnecessary font downloads when a specific part of your website uses a different alphabet and will be displayed with a separate
	 * font. For example, a website that offers both English and Japanese versions can prevent the browser from downloading the Japanese font on English versions of the page that do
	 * not contain any of the Japanese characters provided in `unicodeRange`.
	 */
	unicodeRange?: [string, ...Array<string>] | undefined;
}