Namespace

Adw – 1

Building blocks for modern GNOME applications

Version1.5.0
AuthorsPurism SPC
LicenseLGPL-2.1-or-later
Websitehttps://gnome.pages.gitlab.gnome.org/libadwaita
Sourcehttps://gitlab.gnome.org/GNOME/libadwaita/

Build

C headersadwaita.h
pkg-config fileslibadwaita-1

Dependencies

GObject—2.0 The base type system library
Browse documentation
Gtk—4.0 The GTK toolkit
Browse documentation

Classes

AboutDialog

A dialog showing information about the application.

since: 1.5

AboutWindow

A window showing information about the application.

since: 1.2

ActionRow

A GtkListBoxRow used to present actions.

AlertDialog

A dialog presenting a message or a question.

since: 1.5

Animation

A base class for animations.

AnimationTarget

Represents a value AdwAnimation can animate.

Application

A base class for Adwaita applications.

ApplicationWindow

A freeform application window.

Avatar

A widget displaying an image, with a generated fallback.

Banner

A bar with contextual information.

since: 1.3

Bin

A widget with one child.

Breakpoint

Describes a breakpoint for AdwWindow or AdwDialog.

since: 1.4

BreakpointBin

A widget that changes layout based on available size.

since: 1.4

ButtonContent

A helper widget for creating buttons.

CallbackAnimationTarget

An AdwAnimationTarget that calls a given callback during the animation.

Carousel

A paginated scrolling widget.

CarouselIndicatorDots

A dots indicator for AdwCarousel.

CarouselIndicatorLines

A lines indicator for AdwCarousel.

Clamp

A widget constraining its child to a given size.

ClampLayout

A layout manager constraining its children to a given size.

ClampScrollable

A scrollable AdwClamp.

ComboRow

A GtkListBoxRow used to choose from a list of items.

Dialog

An adaptive dialog container.

since: 1.5

EntryRow

A GtkListBoxRow with an embedded text entry.

since: 1.2

EnumListItem

AdwEnumListItem is the type of items in a AdwEnumListModel.

EnumListModel

A GListModel representing values of a given enum.

ExpanderRow

A GtkListBoxRow used to reveal widgets.

Flap

An adaptive container acting like a box or an overlay.

deprecated: 1.4 

HeaderBar

A title bar widget.

Leaflet

An adaptive container acting like a box or a stack.

deprecated: 1.4 

LeafletPage

An auxiliary class used by AdwLeaflet.

deprecated: 1.4 

MessageDialog

A dialog presenting a message or a question.

since: 1.2

NavigationPage

A page within AdwNavigationView or AdwNavigationSplitView.

since: 1.4

NavigationSplitView

A widget presenting sidebar and content side by side or as a navigation view.

since: 1.4

NavigationView

A page-based navigation container.

since: 1.4

OverlaySplitView

A widget presenting sidebar and content side by side or as an overlay.

since: 1.4

PasswordEntryRow

A AdwEntryRow tailored for entering secrets.

since: 1.2

PreferencesDialog

A dialog showing application’s preferences.

since: 1.5

PreferencesGroup

A group of preference rows.

PreferencesPage

A page from AdwPreferencesDialog.

PreferencesRow

A GtkListBoxRow used to present preferences.

PreferencesWindow

A window to present an application’s preferences.

PropertyAnimationTarget

An AdwAnimationTarget changing the value of a property of a GObject instance.

since: 1.2

SpinRow

An AdwActionRow with an embedded spin button.

since: 1.4

SplitButton

A combined button and dropdown widget.

SpringAnimation

A spring-based AdwAnimation.

Squeezer

A best fit container.

deprecated: 1.4 

SqueezerPage

An auxiliary class used by AdwSqueezer.

deprecated: 1.4 

StatusPage

A page used for empty/error states and similar use-cases.

StyleManager

A class for managing application-wide styling.

SwipeTracker

A swipe tracker used in AdwCarousel, AdwNavigationView and AdwOverlaySplitView.

SwitchRow

A GtkListBoxRow used to represent two states.

since: 1.4

TabBar

A tab bar for AdwTabView.

TabButton

A button that displays the number of AdwTabView pages.

since: 1.3

TabOverview

A tab overview for AdwTabView.

since: 1.3

TabPage

An auxiliary class used by AdwTabView.

TabView

A dynamic tabbed container.

TimedAnimation

A time-based AdwAnimation.

Toast

A helper object for AdwToastOverlay.

ToastOverlay

A widget showing toasts above its content.

ToolbarView

A widget containing a page, as well as top and/or bottom bars.

since: 1.4

ViewStack

A view container for AdwViewSwitcher.

ViewStackPage

An auxiliary class used by AdwViewStack.

ViewStackPages

An auxiliary class used by AdwViewStack.

since: 1.4

ViewSwitcher

An adaptive view switcher.

ViewSwitcherBar

A view switcher action bar.

ViewSwitcherTitle

A view switcher title.

deprecated: 1.4 

Window

A freeform window.

WindowTitle

A helper widget for setting a window’s title and subtitle.

Interfaces

Swipeable

An interface for swipeable widgets.

Structs

BreakpointCondition

Describes condition for an AdwBreakpoint.

since: 1.4

SpringParams

Physical parameters of a spring for AdwSpringAnimation.

Enumerations

AnimationState

Describes the possible states of an AdwAnimation.

BreakpointConditionLengthType

Describes length types for AdwBreakpointCondition.

since: 1.4

BreakpointConditionRatioType

Describes ratio types for AdwBreakpointCondition.

since: 1.4

CenteringPolicy

Describes title centering behavior of a AdwHeaderBar widget.

ColorScheme

Application color schemes for AdwStyleManager:color-scheme.

DialogPresentationMode

Describes the available presentation modes for AdwDialog.

since: 1.5

Easing

Describes the available easing functions for use with AdwTimedAnimation.

FlapFoldPolicy

Describes the possible folding behavior of a AdwFlap widget.

deprecated: 1.4 

FlapTransitionType

Describes transitions types of a AdwFlap widget.

deprecated: 1.4 

FoldThresholdPolicy

Determines when AdwFlap and AdwLeaflet will fold.

deprecated: 1.4 

LeafletTransitionType

Describes the possible transitions in a AdwLeaflet widget.

deprecated: 1.4 

LengthUnit

Describes length units.

since: 1.4

NavigationDirection

Describes the direction of a swipe navigation gesture.

ResponseAppearance

Describes the possible styles of AdwAlertDialog response buttons.

since: 1.2

SqueezerTransitionType

Describes the possible transitions in a AdwSqueezer widget.

deprecated: 1.4 

ToastPriority

AdwToast behavior when another toast is already displayed.

ToolbarStyle

Describes the possible top or bottom bar styles in an AdwToolbarView widget.

since: 1.4

ViewSwitcherPolicy

Describes the adaptive modes of AdwViewSwitcher.

Bitfields

TabViewShortcuts

Describes available shortcuts in an AdwTabView.

since: 1.2

Callbacks

AnimationTargetFunc

Prototype for animation targets based on user callbacks.

Functions

get_enable_animations

Checks whether animations are enabled for widget.

get_major_version

Returns the major version number of the Adwaita library.

get_micro_version

Returns the micro version number of the Adwaita library.

get_minor_version

Returns the minor version number of the Adwaita library.

init

Initializes Libadwaita.

is_initialized

Use this function to check if libadwaita has been initialized with adw_init().

lerp

Computes the linear interpolation between a and b for t.

show_about_dialog

A convenience function for showing an application’s about dialog.

since: 1.5

show_about_dialog_from_appdata

A convenience function for showing an application’s about dialog from AppStream metadata.

since: 1.5

show_about_window

A convenience function for showing an application’s about window.

since: 1.2

show_about_window_from_appdata

A convenience function for showing an application’s about window from AppStream metadata.

since: 1.4

Function Macros

CHECK_VERSION

Compile-time version checking. Evaluates to TRUE if the version of Adwaita is greater than the required one.

Constants

DURATION_INFINITE

Indicates an AdwAnimation with an infinite duration.

MAJOR_VERSION

Adwaita major version component (e.g. 1 if the version is 1.2.3).

MICRO_VERSION

Adwaita micro version component (e.g. 3 if the version is 1.2.3).

MINOR_VERSION

Adwaita minor version component (e.g. 2 if the version is 1.2.3).

VERSION_S

Adwaita version, encoded as a string, useful for printing and concatenation.