fluentui-svelte 0.5.0 → 0.7.0

package/dist/components/tag/tag.svelte

@@ -0,0 +1,459 @@
+<script lang="ts">
+	import DismissRegular from 'fluentui-icons-svelte/DismissRegular.svelte';
+	import { RenderSoC } from '../../internal/index.js';
+	import { PREFIX } from '../../internal/constants.js';
+	import { getTagGroupContext } from './tag-group.js';
+	import type { TagProps } from './types.js';
+
+	const ID = $props.id();
+	const FALLBACK_ID = PREFIX + '-tag-' + ID;
+
+	let {
+		appearance,
+		size,
+		shape = 'circular',
+		disabled,
+		selected = false,
+		dismissible,
+		interactive = false,
+		value = FALLBACK_ID,
+		icon,
+		media,
+		secondaryText,
+		dismissIcon = DismissRegular,
+		dismissLabel = 'Dismiss',
+		onDismiss,
+		onclick,
+		onkeydown,
+		primaryButtonAttributes,
+		dismissButtonAttributes,
+		class: classes,
+		ref = $bindable(null),
+		children,
+		...attributes
+	}: TagProps = $props();
+
+	const group = getTagGroupContext();
+
+	const _appearance = $derived(appearance ?? group?.config.appearance ?? 'filled');
+	const _size = $derived(size ?? group?.config.size ?? 'medium');
+	const _dismissible = $derived(dismissible ?? group?.config.dismissible ?? false);
+	const _disabled = $derived(!!(disabled || group?.config.disabled));
+	const _selected = $derived(interactive && group ? group.state.selectedValues.includes(value) : selected);
+
+	/** A plain tag is the dismiss button itself when it is dismissible. An interactive one holds its own buttons. */
+	const tag = $derived(interactive ? 'div' : _dismissible ? 'button' : 'span');
+
+	const primaryId = $derived(primaryButtonAttributes?.id ?? `${FALLBACK_ID}-primary`);
+	const dismissId = $derived(dismissButtonAttributes?.id ?? `${FALLBACK_ID}-dismiss`);
+
+	/** The dismiss icon names the button, unless the consumer named the tag itself. */
+	const named = $derived(!!(attributes['aria-label'] || attributes['aria-labelledby']));
+
+	const dismiss = (e: MouseEvent | KeyboardEvent) => {
+		onDismiss?.(e, value);
+		group?.methods.dismiss(e, value);
+	};
+
+	const handleClick = (e: MouseEvent) => {
+		onclick?.(e);
+		dismiss(e);
+	};
+
+	const handlePrimaryClick = (e: MouseEvent) => {
+		onclick?.(e);
+		group?.methods.select(e, value);
+	};
+
+	const handleKeydown = (e: KeyboardEvent) => {
+		onkeydown?.(e);
+		if (_dismissible && !_disabled && (e.key === 'Delete' || e.key === 'Backspace')) dismiss(e);
+	};
+
+	const rootClick = $derived(tag === 'button' ? handleClick : tag === 'span' ? onclick : undefined);
+</script>
+
+<!--
+	@component
+	Fluent UI Tag: A visual representation of an attribute, person or asset.
+	It can be dismissible, and with `interactive` it becomes an interaction tag that has a primary action of its own.
+	- Usage:
+    ```tsx
+		<script>
+			import { Tag } from 'fluentui-svelte';
+			import { CalendarMonthRegular } from 'fluentui-icons-svelte';
+		</script>
+
+		<Tag icon={CalendarMonthRegular} dismissible onDismiss={(e, value) => remove(value)}>
+			Primary text
+		</Tag>
+		```
+-->
+{#snippet content()}
+	{#if media}
+		<span class="fs-tag-media"><RenderSoC SoC={media} /></span>
+	{:else if icon}
+		<span class="fs-tag-icon" aria-hidden="true"><RenderSoC SoC={icon} /></span>
+	{/if}
+	<span class="fs-tag-primary-text">{@render children?.()}</span>
+	{#if secondaryText}
+		<span class="fs-tag-secondary-text">
+			{#if typeof secondaryText === 'string'}
+				{secondaryText}
+			{:else}
+				{@render secondaryText()}
+			{/if}
+		</span>
+	{/if}
+{/snippet}
+
+<svelte:element
+	this={tag}
+	{...attributes}
+	bind:this={ref}
+	class={[
+		'fs-tag',
+		_size,
+		_appearance,
+		shape,
+		interactive && 'interactive',
+		_selected && 'selected',
+		_disabled && 'disabled',
+		_dismissible && 'dismissible',
+		(media || icon) && 'leading',
+		secondaryText && 'with-secondary',
+		classes
+	]}
+	type={tag === 'button' ? 'button' : undefined}
+	disabled={tag === 'button' ? _disabled : undefined}
+	onclick={rootClick}
+	onkeydown={handleKeydown}
+>
+	{#if interactive}
+		<button
+			{...primaryButtonAttributes}
+			type="button"
+			class={['fs-tag-primary', primaryButtonAttributes?.class]}
+			id={primaryId}
+			disabled={_disabled}
+			aria-pressed={group ? _selected : undefined}
+			onclick={handlePrimaryClick}
+		>
+			{@render content()}
+		</button>
+		{#if _dismissible}
+			<button
+				{...dismissButtonAttributes}
+				type="button"
+				class={['fs-tag-dismiss', dismissButtonAttributes?.class]}
+				id={dismissId}
+				disabled={_disabled}
+				aria-label={dismissButtonAttributes?.['aria-label'] ?? dismissLabel}
+				aria-labelledby={dismissButtonAttributes?.['aria-labelledby'] ??
+					(dismissButtonAttributes?.['aria-label'] ? undefined : `${primaryId} ${dismissId}`)}
+				onclick={dismiss}
+			>
+				<RenderSoC SoC={dismissIcon} />
+			</button>
+		{/if}
+	{:else}
+		{@render content()}
+		{#if _dismissible}
+			<span
+				class="fs-tag-dismiss-icon"
+				role={named ? undefined : 'img'}
+				aria-label={named ? undefined : dismissLabel}
+				aria-hidden={named ? 'true' : undefined}
+			>
+				<RenderSoC SoC={dismissIcon} />
+			</span>
+		{/if}
+	{/if}
+</svelte:element>
+
+<style>
+	.fs-tag {
+		--tag-spacing: 0.4375rem;
+		--tag-icon-size: 1.25rem;
+		--tag-icon-gap: 0.25rem;
+		--tag-media-gap: 0.5rem;
+		--tag-dismiss-spacing: 0.3125rem;
+		--tag-height: 2rem;
+		--tag-font-size: var(--fs-body2-font-size);
+		--tag-line-height: var(--fs-body2-line-height);
+		--tag-radius: var(--fs-control-border-radius);
+		/* Changed from original --fs-control-fill-quaternary to --fs-control-fill-secondary */
+		--tag-bg: var(--fs-control-fill-secondary);
+		--tag-bg-hover: var(--fs-control-alt-fill-quaternary);
+		--tag-bg-pressed: var(--fs-control-alt-fill-secondary);
+		--tag-fg: var(--fs-text-primary);
+		--tag-border: var(--fs-control-stroke-default);
+		--tag-divider: var(--fs-control-stroke-secondary);
+		--tag-danger: var(--fs-system-critical);
+		--tag-danger-pressed: color-mix(in srgb, var(--fs-system-critical), black 15%);
+
+		box-sizing: border-box;
+		width: fit-content;
+		height: var(--tag-height);
+		margin: 0;
+		color: var(--tag-fg);
+		font-family: inherit;
+		font-size: var(--tag-font-size);
+		line-height: var(--tag-line-height);
+		text-align: start;
+		user-select: none;
+		border-radius: var(--tag-radius);
+
+		&.small {
+			--tag-spacing: 0.3125rem;
+			--tag-icon-size: 1rem;
+			--tag-icon-gap: 0.125rem;
+			--tag-media-gap: 0.375rem;
+			--tag-dismiss-spacing: 0.1875rem;
+			--tag-height: 1.5rem;
+			--tag-font-size: var(--fs-caption-font-size);
+			--tag-line-height: var(--fs-caption-line-height);
+		}
+		&.extra-small {
+			--tag-spacing: 0.3125rem;
+			--tag-icon-size: 0.75rem;
+			--tag-icon-gap: 0.125rem;
+			--tag-media-gap: 0.375rem;
+			--tag-height: 1.25rem;
+			--tag-font-size: var(--fs-caption-font-size);
+			--tag-line-height: var(--fs-caption-line-height);
+		}
+		&.circular {
+			--tag-radius: 9999rem;
+		}
+		&.square {
+			--tag-radius: 0;
+		}
+
+		&.outline {
+			--tag-bg: transparent;
+			--tag-bg-hover: var(--fs-subtle-fill-secondary);
+			--tag-bg-pressed: var(--fs-subtle-fill-tertiary);
+			--tag-border: var(--fs-control-stroke-secondary);
+		}
+		&.brand {
+			--tag-bg: var(--fs-system-attention-bg);
+			--tag-bg-hover: color-mix(in srgb, var(--fs-system-attention-bg), rgb(var(--fs-accent-base)) 10%);
+			--tag-bg-pressed: color-mix(in srgb, var(--fs-system-attention-bg), rgb(var(--fs-accent-base)) 18%);
+			--tag-fg: var(--fs-accent-text-primary);
+			--tag-divider: color-mix(in srgb, rgb(var(--fs-accent-base)), transparent 70%);
+		}
+		&.selected {
+			--tag-bg: var(--fs-accent-fill-default);
+			--tag-bg-hover: var(--fs-accent-fill-secondary);
+			--tag-bg-pressed: var(--fs-accent-fill-tertiary);
+			--tag-fg: var(--fs-text-on-accent-primary);
+			--tag-border: var(--fs-accent-fill-default);
+			--tag-divider: var(--fs-control-stroke-on-accent-secondary);
+		}
+		&.disabled {
+			--tag-bg: var(--fs-control-alt-fill-secondary);
+			--tag-bg-hover: var(--fs-control-alt-fill-secondary);
+			--tag-bg-pressed: var(--fs-control-alt-fill-secondary);
+			--tag-fg: var(--fs-text-disabled);
+			--tag-border: transparent;
+			--tag-divider: var(--fs-control-stroke-default);
+			&.outline {
+				--tag-bg: transparent;
+				--tag-bg-hover: transparent;
+				--tag-bg-pressed: transparent;
+				--tag-border: var(--fs-control-stroke-default);
+			}
+		}
+
+		/* A plain tag: a single box, a button when it is dismissible. */
+		&:not(.interactive) {
+			display: inline-grid;
+			grid-template-areas:
+				'media primary dismiss'
+				'media secondary dismiss';
+			align-items: center;
+			padding: 0;
+			padding-inline: var(--tag-spacing);
+			background: var(--tag-bg);
+			border: 1px solid var(--tag-border);
+			&.leading {
+				padding-inline-start: 0;
+			}
+			&.dismissible {
+				padding-inline-end: 0;
+			}
+			&:focus-visible {
+				outline: 0.125rem solid var(--fs-focus-stroke-outer);
+				outline-offset: 0.063rem;
+			}
+		}
+		&.disabled:not(.interactive) {
+			cursor: not-allowed;
+		}
+
+		/* An interaction tag: a primary button, followed by the dismiss button. */
+		&.interactive {
+			display: inline-flex;
+			align-items: center;
+		}
+
+		& .fs-tag-primary,
+		& .fs-tag-dismiss {
+			box-sizing: border-box;
+			height: 100%;
+			margin: 0;
+			padding: 0;
+			color: inherit;
+			font: inherit;
+			background: var(--tag-bg);
+			border: 1px solid var(--tag-border);
+			cursor: pointer;
+			&:hover {
+				background: var(--tag-bg-hover);
+			}
+			&:active {
+				background: var(--tag-bg-pressed);
+			}
+			&:focus-visible {
+				position: relative;
+				z-index: 1;
+				outline: 0.125rem solid var(--fs-focus-stroke-outer);
+				outline-offset: 0.063rem;
+			}
+			&:disabled {
+				cursor: not-allowed;
+				background: var(--tag-bg);
+			}
+		}
+		& .fs-tag-primary {
+			display: inline-grid;
+			grid-template-areas:
+				'media primary'
+				'media secondary';
+			align-items: center;
+			text-align: start;
+			border-radius: var(--tag-radius);
+			padding-inline: var(--tag-spacing);
+		}
+		&.leading .fs-tag-primary {
+			padding-inline-start: 0;
+		}
+		&.dismissible .fs-tag-primary {
+			border-inline-end: none;
+			border-start-end-radius: 0;
+			border-end-end-radius: 0;
+		}
+		& .fs-tag-dismiss {
+			display: flex;
+			align-items: center;
+			padding-inline: var(--tag-dismiss-spacing);
+			font-size: var(--tag-icon-size);
+			border-inline-start-color: var(--tag-divider);
+			border-start-start-radius: 0;
+			border-end-start-radius: 0;
+			border-start-end-radius: var(--tag-radius);
+			border-end-end-radius: var(--tag-radius);
+			&:hover {
+				color: var(--tag-danger);
+			}
+			&:active {
+				color: var(--tag-danger-pressed);
+			}
+		}
+		/* The selected hover and pressed fills are translucent: drop the opaque rim so the fill is a single colour. */
+		&.selected .fs-tag-primary,
+		&.selected .fs-tag-dismiss {
+			&:hover,
+			&:active {
+				border-color: transparent;
+			}
+		}
+		&.selected .fs-tag-dismiss {
+			&:hover,
+			&:active {
+				color: var(--tag-fg);
+				border-inline-start-color: var(--tag-divider);
+			}
+		}
+		&.disabled .fs-tag-dismiss:hover {
+			color: inherit;
+		}
+
+		& .fs-tag-media,
+		& .fs-tag-icon {
+			grid-area: media;
+			display: flex;
+			align-items: center;
+		}
+		& .fs-tag-media {
+			padding-inline: 1px var(--tag-media-gap);
+		}
+		& .fs-tag-icon {
+			box-sizing: content-box;
+			width: var(--tag-icon-size);
+			padding-inline: var(--tag-spacing) var(--tag-icon-gap);
+			font-size: var(--tag-icon-size);
+		}
+		& .fs-tag-primary-text {
+			grid-area: primary;
+			grid-row: 1 / 3;
+			padding-inline: 0.125rem;
+			white-space: nowrap;
+		}
+		&.with-secondary .fs-tag-primary-text {
+			grid-row: 1;
+			margin-block-start: -0.125rem;
+			font-size: var(--fs-caption-font-size);
+			line-height: var(--fs-caption-line-height);
+		}
+		& .fs-tag-secondary-text {
+			grid-area: secondary;
+			padding-inline: 0.125rem;
+			font-size: var(--fs-caption2-font-size);
+			line-height: var(--fs-caption2-line-height);
+			white-space: nowrap;
+		}
+		& .fs-tag-dismiss-icon {
+			grid-area: dismiss;
+			display: flex;
+			align-items: center;
+			align-self: stretch;
+			padding-inline: var(--tag-icon-gap) var(--tag-spacing);
+			font-size: var(--tag-icon-size);
+			border-start-end-radius: calc(var(--tag-radius) - 1px);
+			border-end-end-radius: calc(var(--tag-radius) - 1px);
+			&:hover {
+				cursor: pointer;
+				color: var(--tag-danger);
+			}
+			&:active {
+				color: var(--tag-danger-pressed);
+			}
+		}
+		&.selected .fs-tag-dismiss-icon:hover,
+		&.selected .fs-tag-dismiss-icon:active {
+			color: var(--tag-fg);
+		}
+		/* A selected tag lightens the area of the dismiss, as the dismiss button of an interactive one does. */
+		&.selected:not(.disabled) .fs-tag-dismiss-icon {
+			&:hover {
+				background: color-mix(in srgb, var(--tag-fg) 16%, transparent);
+			}
+			&:active {
+				background: color-mix(in srgb, var(--tag-fg) 33%, transparent);
+			}
+		}
+		&.disabled .fs-tag-dismiss-icon {
+			&:hover {
+				cursor: not-allowed;
+				color: inherit;
+			}
+		}
+
+		& :global(svg) {
+			width: var(--tag-icon-size);
+			height: var(--tag-icon-size);
+		}
+	}
+</style>

package/dist/components/tag/tag.svelte.d.ts

@@ -0,0 +1,19 @@
+import type { TagProps } from './types.ts';
+/**
+ * Fluent UI Tag: A visual representation of an attribute, person or asset.
+ * It can be dismissible, and with `interactive` it becomes an interaction tag that has a primary action of its own.
+ * - Usage:
+ *    ```tsx
+ * 	<script>
+ * 		import { Tag } from 'fluentui-svelte';
+ * 		import { CalendarMonthRegular } from 'fluentui-icons-svelte';
+ * 	</script>
+ *
+ * 	<Tag icon={CalendarMonthRegular} dismissible onDismiss={(e, value) => remove(value)}>
+ * 		Primary text
+ * 	</Tag>
+ * 	```
+ */
+declare const Tag: import("svelte").Component<TagProps, {}, "ref">;
+type Tag = ReturnType<typeof Tag>;
+export default Tag;

package/dist/components/tag/types.d.ts

@@ -0,0 +1,137 @@
+import type { Component, Snippet } from 'svelte';
+import type { HTMLAttributes, HTMLButtonAttributes, SVGAttributes } from 'svelte/elements';
+import type { FSContext } from '../../internal/index.js';
+import type { PolymorphicProps, Shapes } from '../../types/index.js';
+export type TagAppearance = 'filled' | 'outline' | 'brand';
+export type TagSize = 'extra-small' | 'small' | 'medium';
+/** @propsmith TagProps */
+export type TagProps = {
+    /** The tag can have a filled, outlined or brand appearance. Falls back to the `appearance` of the `TagGroup` it is in.
+     * @default 'filled'
+     */
+    appearance?: TagAppearance;
+    /** The tag comes in three sizes. Falls back to the `size` of the `TagGroup` it is in.
+     * @default 'medium'
+     */
+    size?: TagSize;
+    /** The tag can have a circular, rounded or square shape.
+     * @default 'circular'
+     */
+    shape?: Shapes;
+    /** Shows that the tag cannot be interacted with. A tag inside a disabled `TagGroup` is disabled too.
+     * @default false
+     */
+    disabled?: boolean;
+    /** Paints the tag as selected. Inside a `TagGroup` an interactive tag takes its selected state from the `selectedValues` of the group instead.
+     * @default false
+     */
+    selected?: boolean;
+    /** Shows a dismiss icon and lets the tag be dismissed. Falls back to the `dismissible` of the `TagGroup` it is in.
+     * A tag that is not interactive becomes a single button: activating it, or pressing Delete or Backspace on it, dismisses it.
+     * @default false
+     */
+    dismissible?: boolean;
+    /** Renders the tag as an interaction tag: a primary button that carries the action, followed, when the tag is dismissible, by a separate dismiss button.
+     * Use it for a tag that has a primary action, and a plain tag for one that does not.
+     * @default false
+     */
+    interactive?: boolean;
+    /** Identifies the tag inside a `TagGroup`. It is what `onDismiss` and `onTagSelect` report. Falls back to a generated id. */
+    value?: string;
+    /** An icon rendered before the text. Do not use it together with `media`.
+     * @type Snippet | Component
+     */
+    icon?: Snippet<[SVGAttributes<SVGElement>]> | Component<SVGAttributes<SVGElement>>;
+    /** A visual element rendered before the text, usually an `Avatar`. Do not use it together with `icon`.
+     * @type Snippet | Component
+     */
+    media?: Snippet | Component;
+    /** A second line of text that describes or complements the main text.
+     * @type string | Snippet
+     */
+    secondaryText?: string | Snippet;
+    /** The icon of the dismiss control.
+     * @default DismissRegular
+     * @type Snippet | Component
+     */
+    dismissIcon?: Snippet<[SVGAttributes<SVGElement>]> | Component<SVGAttributes<SVGElement>>;
+    /** The accessible name of the dismiss control. When the tag is named through `aria-label` or `aria-labelledby`
+     * instead, the dismiss icon is hidden from assistive technologies.
+     * @default 'Dismiss'
+     */
+    dismissLabel?: string;
+    /** Called when the tag is dismissed. The consumer owns the data: the tag does not remove itself. */
+    onDismiss?: (e: MouseEvent | KeyboardEvent, value: string) => void;
+    /** Called when the tag is activated. On an interactive tag it is the click of the primary button. */
+    onclick?: (e: MouseEvent) => void;
+    /** Called when a key is pressed on the tag. */
+    onkeydown?: (e: KeyboardEvent) => void;
+    /** Attributes for the primary button of an interactive tag, for example `aria-haspopup`. If you give it
+     * a custom `id`, the dismiss button is named after it.
+     * @type HTMLButtonAttributes
+     */
+    primaryButtonAttributes?: Omit<HTMLButtonAttributes, 'children' | 'onclick'>;
+    /** Attributes for the dismiss button of an interactive tag. Use `aria-label` together with
+     * `aria-labelledby: undefined` to give the button a name that stands on its own.
+     * @type HTMLButtonAttributes
+     */
+    dismissButtonAttributes?: Omit<HTMLButtonAttributes, 'children' | 'onclick'>;
+    /** The primary text of the tag. */
+    children?: Snippet;
+    /** The DOM reference of the tag element.
+     * @bindable
+     */
+    ref?: HTMLElement | null;
+} & Omit<PolymorphicProps<'span'>, 'children' | 'onclick' | 'onkeydown'>;
+/** @propsmith TagGroupProps */
+export type TagGroupProps = {
+    /** The size given to the tags of the group that do not set their own.
+     * @default 'medium'
+     */
+    size?: TagSize;
+    /** The appearance given to the tags of the group that do not set their own. */
+    appearance?: TagAppearance;
+    /** Disables every tag of the group.
+     * @default false
+     */
+    disabled?: boolean;
+    /** Makes the tags of the group that do not set their own dismissible. */
+    dismissible?: boolean;
+    /** The values of the selected interactive tags.
+     * @default []
+     * @bindable
+     */
+    selectedValues?: string[];
+    /** Called when an interactive tag of the group is activated, with the value it toggles. */
+    onTagSelect?: (e: MouseEvent, data: {
+        value: string;
+        selected: boolean;
+    }) => void;
+    /** Called when a tag of the group is dismissed. The consumer owns the data: the group does not remove the tag. */
+    onDismiss?: (e: MouseEvent | KeyboardEvent, data: {
+        value: string;
+    }) => void;
+    /** The role of the group. Use `list` together with `role="listitem"` on each tag when none of them is actionable.
+     * @default 'toolbar'
+     */
+    role?: HTMLAttributes<HTMLDivElement>['role'];
+    /** The tags of the group. */
+    children?: Snippet;
+    /** The DOM reference of the group element.
+     * @bindable
+     */
+    ref?: HTMLDivElement | null;
+} & Omit<PolymorphicProps<'div'>, 'children' | 'role'>;
+export type TagGroupContext = FSContext<{
+    readonly size?: TagSize;
+    readonly appearance?: TagAppearance;
+    readonly disabled?: boolean;
+    readonly dismissible?: boolean;
+}, {
+    readonly selectedValues: string[];
+}, null, {
+    /** Toggles the value in `selectedValues` and reports it. */
+    select: (e: MouseEvent, value: string) => void;
+    /** Reports the dismissed value. */
+    dismiss: (e: MouseEvent | KeyboardEvent, value: string) => void;
+}>;

package/dist/components/tag/types.js

@@ -0,0 +1 @@
+export {};