Split into category packages; module github.com/ZacharyZhang-NY/MujicaUI

feedback/empty_state.go

@@ -0,0 +1,90 @@
+package feedback
+
+import (
+	"cmp"
+	"fmt"
+
+	"github.com/egoist/mygo/ui"
+
+	"github.com/ZacharyZhang-NY/MujicaUI/core"
+	"github.com/ZacharyZhang-NY/MujicaUI/icons"
+	"github.com/ZacharyZhang-NY/MujicaUI/input"
+	"github.com/ZacharyZhang-NY/MujicaUI/theme"
+)
+
+// EmptyKind tells why there is nothing to show. The zero value is EmptyNoData.
+type EmptyKind int
+
+const (
+	// EmptyNoData: the collection itself is empty.
+	EmptyNoData EmptyKind = iota
+	// EmptyNoResults: a search or filter matched nothing.
+	EmptyNoResults
+)
+
+// EmptyStateOptions configure an EmptyState. Empty texts use the kind's built-in copy.
+type EmptyStateOptions struct {
+	Kind        EmptyKind
+	Title       string
+	Description string
+	// Query, for EmptyNoResults, is named in the default description.
+	Query string
+	// Icon replaces the kind's icon (inbox or search); NoIcon shows none.
+	Icon   *ui.SVG
+	NoIcon bool
+	// Action labels a button, such as "Clear search"; empty shows none.
+	Action string
+}
+
+// EmptyStateResult is what an EmptyState built and reported this frame.
+type EmptyStateResult struct {
+	Element *ui.Element
+	Action  bool
+}
+
+// EmptyState explains an empty view and offers a next step.
+func EmptyState(c *ui.Context, opts EmptyStateOptions) EmptyStateResult {
+	if opts.NoIcon && opts.Icon != nil {
+		panic("mujica: EmptyState with both Icon and NoIcon")
+	}
+	k := core.Tokens(c)
+	u := core.Density(c).Unit()
+	title, desc, icon := opts.Title, opts.Description, opts.Icon
+	switch opts.Kind {
+	case EmptyNoData:
+		if opts.Query != "" {
+			panic("mujica: EmptyState Query needs EmptyNoResults")
+		}
+		title = cmp.Or(title, core.Msg(c, "empty_state.no_data.title"))
+		desc = cmp.Or(desc, core.Msg(c, "empty_state.no_data.description"))
+		if icon == nil {
+			icon = icons.Must("inbox")
+		}
+	case EmptyNoResults:
+		title = cmp.Or(title, core.Msg(c, "empty_state.no_results.title"))
+		if desc == "" && opts.Query != "" {
+			desc = fmt.Sprintf(core.Msg(c, "empty_state.no_results.query"), opts.Query)
+		}
+		desc = cmp.Or(desc, core.Msg(c, "empty_state.no_results.description"))
+		if icon == nil {
+			icon = icons.Must("search")
+		}
+	default:
+		panic(fmt.Sprintf("mujica: unknown EmptyKind %d", int(opts.Kind)))
+	}
+	var res EmptyStateResult
+	res.Element = ui.Column(c).FillWidth().AlignItems(ui.Center).Gap(u*2).Padding(u*8, u*4).Role(ui.RoleGroup).Label(title)
+	res.Element.Children(func() {
+		if !opts.NoIcon {
+			ui.Icon(c, icon).Size(32, 32).TextColor(k.TextMuted).Margin(0, 0, u*2, 0)
+		}
+		ui.Text(c, title).Font(theme.SerifFont).FontSize(core.FontSize(c, theme.H3Size)).TextColor(k.Text).TextAlign(ui.Center)
+		ui.Text(c, desc).TextColor(k.TextMuted).TextAlign(ui.Center).MaxWidth(360).LineHeight(theme.LineHeight)
+		if opts.Action != "" {
+			ui.Box(c).Margin(u*2, 0, 0, 0).Children(func() {
+				res.Action = input.Button(c, opts.Action, input.ButtonOptions{Variant: input.Secondary}).Clicked()
+			})
+		}
+	})
+	return res
+}