Loading, empty, and error states with AdwStatusPage and AdwSpinner — placeholder icons, titles, action buttons. Use when an app view can be empty, loading, or failed.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
설치 방법 보기설치하기 전에 에이전트에게 전달되는 지시 내용을 확인할 수 있습니다.
Blueprint:
Adw.StatusPage {
title: _("Open a Document");
description: _("Create a new document (Ctrl+N), or open an existing one (Ctrl+O)");
icon-name: "document-open-symbolic";
child: Gtk.Button {
label: _("_New Empty File");
use-underline: true;
halign: center;
styles ["suggested-action", "large-button", "pill"];
};
}
XML:
<object class="AdwStatusPage" id="empty">
<property name="title" translatable="yes">Nothing Installed</property>
<property name="description" translatable="yes">Packages you install will appear here.</property>
<property name="icon-name">package-x-generic-symbolic</property>
<property name="child">
<object class="GtkButton">
<property name="label" translatable="yes">_Install Packages</property>
<property name="halign">center</property>
<style>
<class name="suggested-action"/>
<class name="large-button"/>
<class name="pill"/>
</style>
</object>
</property>
</object>
Properties:
| Property | Type | Notes |
|---|---|---|
title | string | Required — main message |
description | string | Optional — instruction text |
icon-name | string | Symbolic icon (recommended) |
child | widget | Action button (optional) |
Blueprint:
Stack loading_stack {
transition-type: crossfade;
StackPage {
name: "loading";
child: Box {
orientation: vertical;
valign: center;
halign: center;
spacing: 12;
Gtk.Spinner {
width-request: 32;
height-request: 32;
}
Label {
label: _("Loading packages…");
styles ["dim-label"];
}
};
}
StackPage {
name: "content";
child: /* actual content */;
}
}
Always use GtkStack + transition-type: crossfade to switch between loading/empty/content states. Never overlay spinners on content.
Three standard pages:
| StackPage name | When | Contents |
|---|---|---|
"loading" | Initial load | Spinner + label |
"empty" | No data | AdwStatusPage |
"content" | Data loaded | Actual content |
Box {
orientation: vertical;
valign: center;
halign: center;
spacing: 6;
Gtk.Spinner {
width-request: 64;
height-request: 64;
margin-bottom: 18;
}
Label {
label: _("Loading…");
styles ["title-3"];
}
ProgressBar { /* optional: determinate progress */
width-request: 280;
valign: center;
}
}
crossfade transition for smooth state changessuggested-action + large-button + pill아직 리뷰가 없습니다. 사용해 본 소감을 남겨 주세요.
로그인 없이 쓸 수 있습니다. 사용 후기, 질문, 작동하지 않은 환경 등을 편하게 남겨 주세요.
아직 댓글이 없습니다. 첫 댓글을 남겨 보세요.
Add a standard AdwAboutDialog wired to app metadata, plus the AppStream metainfo file it should share data with. Use when adding an About entry, release notes, credits, or preparing app metadata.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
Make a GTK4/libadwaita app accessible — accessible labels and roles, tooltips on icon-only buttons, keyboard navigation, contrast, and testing with Orca/Accerciser. Use when fixing a11y issues or running the accessibility category of a HIG audit.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
Responsive GNOME layouts: AdwBreakpoint conditions, BreakpointBin, MultiLayoutView, BottomSheet, narrow/wide layout swaps. Use when making an app work on phones or narrow windows.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
Onboarding tour with AdwCarousel and navigation dots, skippable welcome screens. Use when adding a first-run tour or feature showcase to a GNOME app.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
Implement GNOME's 4-tier destructive-action pattern: undo toasts instead of confirmation dialogs, AdwAlertDialog for irreversible actions. Use when adding delete, remove, clear, or other destructive actions.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.
Package a GNOME app as a Flatpak — manifest for the GNOME runtime, sandbox permissions, build/run/test loop, and Flathub submission checklist. Use when packaging, distributing, or preparing a GNOME app for Flathub.
한국어 요약은 준비 중입니다. 원문 설명을 표시하고 있습니다.