Add HdyActionRow

This implements a very commonly used list box row pattern and make it
convenient to use. It is going to be used as the base class for many
other commonly used row types.

doc/handy-docs.xml

@@ -36,6 +36,7 @@
 
   <chapter id="core-api">
     <title>Widgets and Objects</title>
+    <xi:include href="xml/hdy-action-row.xml"/>
     <xi:include href="xml/hdy-arrows.xml"/>
     <xi:include href="xml/hdy-column.xml"/>
     <xi:include href="xml/hdy-dialer.xml"/>

glade/libhandy.xml

@@ -24,6 +24,7 @@
   </glade-widget-classes>
 
   <glade-widget-group name="handy" title="Libhandy Widgets">
+    <glade-widget-class-ref name="HdyActionRow"/>
     <glade-widget-class-ref name="HdyArrows"/>
     <glade-widget-class-ref name="HdyColumn"/>
     <glade-widget-class-ref name="HdyDialer"/>

src/handy.gresources.xml

 <?xml version="1.0" encoding="UTF-8"?>
 <gresources>
   <gresource prefix="/sm/puri/handy/dialer/ui">
+    <file preprocess="xml-stripblanks">hdy-action-row.ui</file>
     <file preprocess="xml-stripblanks">hdy-dialer.ui</file>
     <file preprocess="xml-stripblanks">hdy-dialer-button.ui</file>
     <file preprocess="xml-stripblanks">hdy-search-bar.ui</file>

src/handy.h

@@ -25,6 +25,7 @@ G_BEGIN_DECLS
 #endif
 
 #include "hdy-version.h"
+#include "hdy-action-row.h"
 #include "hdy-arrows.h"
 #include "hdy-column.h"
 #include "hdy-dialer-button.h"

src/hdy-action-row.c

+/*
+ * Copyright (C) 2018 Purism SPC
+ *
+ * SPDX-License-Identifier: LGPL-2.1+
+ */
+
+#include "hdy-action-row.h"
+
+#include <glib/gi18n.h>
+
+/**
+ * SECTION:hdy-action-row
+ * @short_description: A #GtkListBox row used to present actions
+ * @Title: HdyActionRow
+ *
+ * The #HdyActionRow widget can have a title, a subtitle and an icon. The row
+ * can receive action widgets at its end, prefix widgets at its start or widgets
+ * below it.
+ *
+ * Note that action widgets are packed starting from the end.
+ *
+ * It is convenient to present a list of preferences and their related actions.
+ *
+ * # HdyActionRow as GtkBuildable
+ *
+ * The GtkWindow implementation of the GtkBuildable interface supports setting a
+ * child as an action widget by specifying “action” as the “type” attribute of a
+ * &lt;child&gt; element.
+ *
+ * It also supports setting a child as a prefix widget by specifying “prefix” as
+ * the “type” attribute of a &lt;child&gt; element.
+ */
+
+typedef struct
+{
+  GtkBox *box;
+  GtkBox *header;
+  GtkImage *image;
+  GtkBox *prefixes;
+  GtkLabel *subtitle;
+  GtkLabel *title;
+  GtkBox *title_box;
+
+  GtkWidget *previous_parent;
+
+  gboolean use_underline;
+} HdyActionRowPrivate;
+
+static void hdy_action_row_buildable_init (GtkBuildableIface *iface);
+
+G_DEFINE_TYPE_WITH_CODE (HdyActionRow, hdy_action_row, GTK_TYPE_LIST_BOX_ROW,
+                         G_ADD_PRIVATE (HdyActionRow)
+                         G_IMPLEMENT_INTERFACE (GTK_TYPE_BUILDABLE,
+                         hdy_action_row_buildable_init))
+
+static GtkBuildableIface *parent_buildable_iface;
+
+enum {
+  PROP_0,
+  PROP_ICON_NAME,
+  PROP_SUBTITLE,
+  PROP_TITLE,
+  PROP_USE_UNDERLINE,
+  LAST_PROP,
+};
+
+static GParamSpec *props[LAST_PROP];
+
+static void
+row_activated_cb (HdyActionRow        *self,
+                  GtkListBoxRow *row)
+{
+  if (self == HDY_ACTION_ROW (row))
+    hdy_action_row_activate (self);
+}
+
+static void
+parent_cb (HdyActionRow *self)
+{
+  HdyActionRowPrivate *priv = hdy_action_row_get_instance_private (self);
+  GtkWidget *parent = gtk_widget_get_parent (GTK_WIDGET (self));
+
+  if (priv->previous_parent != NULL) {
+    g_signal_handlers_disconnect_by_func (priv->previous_parent, G_CALLBACK (row_activated_cb), self);
+    priv->previous_parent = NULL;
+  }
+
+  if (parent == NULL || !GTK_IS_LIST_BOX (parent))
+    return;
+
+  priv->previous_parent = parent;
+  g_signal_connect_swapped (parent, "row-activated", G_CALLBACK (row_activated_cb), self);
+}
+
+static void
+update_subtitle_visibility (HdyActionRow *self)
+{
+  HdyActionRowPrivate *priv = hdy_action_row_get_instance_private (self);
+
+  gtk_widget_set_visible (GTK_WIDGET (priv->subtitle),
+                          gtk_label_get_text (priv->subtitle) != NULL &&
+                          g_strcmp0 (gtk_label_get_text (priv->subtitle), "") != 0);
+}
+
+static void
+hdy_action_row_get_property (GObject    *object,
+                             guint       prop_id,
+                             GValue     *value,
+                             GParamSpec *pspec)
+{
+  HdyActionRow *self = HDY_ACTION_ROW (object);
+
+  switch (prop_id) {
+  case PROP_ICON_NAME:
+    g_value_set_string (value, hdy_action_row_get_icon_name (self));
+    break;
+  case PROP_SUBTITLE:
+    g_value_set_string (value, hdy_action_row_get_subtitle (self));
+    break;
+  case PROP_TITLE:
+    g_value_set_string (value, hdy_action_row_get_title (self));
+    break;
+  case PROP_USE_UNDERLINE:
+    g_value_set_boolean (value, hdy_action_row_get_use_underline (self));
+    break;
+  default:
+    G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
+  }
+}
+
+static void
+hdy_action_row_set_property (GObject      *object,
+                             guint         prop_id,
+                             const GValue *value,
+                             GParamSpec   *pspec)
+{
+  HdyActionRow *self = HDY_ACTION_ROW (object);
+
+  switch (prop_id) {
+  case PROP_ICON_NAME:
+    hdy_action_row_set_icon_name (self, g_value_get_string (value));
+    break;
+  case PROP_SUBTITLE:
+    hdy_action_row_set_subtitle (self, g_value_get_string (value));
+    break;
+  case PROP_TITLE:
+    hdy_action_row_set_title (self, g_value_get_string (value));
+    break;
+  case PROP_USE_UNDERLINE:
+    hdy_action_row_set_use_underline (self, g_value_get_boolean (value));
+    break;
+  default:
+    G_OBJECT_WARN_INVALID_PROPERTY_ID (object, prop_id, pspec);
+  }
+}
+
+static void
+hdy_action_row_dispose (GObject *object)
+{
+  HdyActionRow *self = HDY_ACTION_ROW (object);
+  HdyActionRowPrivate *priv = hdy_action_row_get_instance_private (self);
+
+  if (priv->previous_parent == NULL)
+    return;
+
+  g_signal_handlers_disconnect_by_func (priv->previous_parent, G_CALLBACK (row_activated_cb), self);
+  priv->previous_parent = NULL;
+}
+
+static void
+hdy_action_row_add (GtkContainer *container,
+                    GtkWidget    *child)
+{
+  HdyActionRow *self = HDY_ACTION_ROW (container);
+  HdyActionRowPrivate *priv = hdy_action_row_get_instance_private (self);
+
+  /* When constructing the widget, we want the box to be added as the child of
+   * the GtkListBoxRow, as an implementation detail.
+   */
+  if (priv->box == NULL)
+    GTK_CONTAINER_CLASS (hdy_action_row_parent_class)->add (container, child);
+  else
+    gtk_container_add (GTK_CONTAINER (priv->box), child);
+}
+
+typedef struct {
+  HdyActionRow *row;
+  GtkCallback callback;
+  gpointer callback_data;
+} ForallData;
+
+static void
+for_non_internal_child (GtkWidget *widget,
+                        gpointer   callback_data)
+{
+  ForallData *data = callback_data;
+  HdyActionRowPrivate *priv = hdy_action_row_get_instance_private (data->row);
+
+  if (widget != (GtkWidget *) priv->box &&
+      widget != (GtkWidget *) priv->image &&
+      widget != (GtkWidget *) priv->prefixes &&
+      widget != (GtkWidget *) priv->title_box)
+    data->callback (widget, data->callback_data);
+}
+
+static void
+hdy_action_row_forall (GtkContainer *container,
+                       gboolean      include_internals,
+                       GtkCallback   callback,
+                       gpointer      callback_data)
+{
+  HdyActionRow *self = HDY_ACTION_ROW (container);
+  HdyActionRowPrivate *priv = hdy_action_row_get_instance_private (self);
+  ForallData data;
+
+  if (include_internals) {
+    GTK_CONTAINER_CLASS (hdy_action_row_parent_class)->forall (GTK_CONTAINER (self), include_internals, callback, callback_data);
+
+    return;
+  }
+
+  data.row = self;
+  data.callback = callback;
+  data.callback_data = callback_data;
+
+  GTK_CONTAINER_GET_CLASS (priv->prefixes)->forall (GTK_CONTAINER (priv->prefixes), include_internals, for_non_internal_child, &data);
+  GTK_CONTAINER_GET_CLASS (priv->header)->forall (GTK_CONTAINER (priv->header), include_internals, for_non_internal_child, &data);
+  GTK_CONTAINER_GET_CLASS (priv->box)->forall (GTK_CONTAINER (priv->box), include_internals, for_non_internal_child, &data);
+}
+
+static void
+hdy_action_row_activate_real (HdyActionRow *self)
+{
+}
+
+static void
+hdy_action_row_class_init (HdyActionRowClass *klass)
+{
+  GObjectClass *object_class = G_OBJECT_CLASS (klass);
+  GtkWidgetClass *widget_class = GTK_WIDGET_CLASS (klass);
+  GtkContainerClass *container_class = GTK_CONTAINER_CLASS (klass);
+
+  object_class->get_property = hdy_action_row_get_property;
+  object_class->set_property = hdy_action_row_set_property;
+  object_class->dispose = hdy_action_row_dispose;
+
+  container_class->add = hdy_action_row_add;
+  container_class->forall = hdy_action_row_forall;
+
+  klass->activate = hdy_action_row_activate_real;
+
+  /**
+   * HdyActionRow:icon-name:
+   *
+   * The icon name for this row.
+   */
+  props[PROP_ICON_NAME] =
+    g_param_spec_string ("icon-name",
+                         _("Icon name"),
+                         _("Icon name"),
+                         "",
+                         G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS | G_PARAM_EXPLICIT_NOTIFY);
+
+  /**
+   * HdyActionRow:subtitle:
+   *
+   * The subtitle for this row.
+   */
+  props[PROP_SUBTITLE] =
+    g_param_spec_string ("subtitle",
+                         _("Subtitle"),
+                         _("Subtitle"),
+                         "",
+                         G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS | G_PARAM_EXPLICIT_NOTIFY);
+
+  /**
+   * HdyActionRow:title:
+   *
+   * The title for this row.
+   */
+  props[PROP_TITLE] =
+    g_param_spec_string ("title",
+                         _("Title"),
+                         _("Title"),
+                         "",
+                         G_PARAM_READWRITE | G_PARAM_STATIC_STRINGS | G_PARAM_EXPLICIT_NOTIFY);
+
+  props[PROP_USE_UNDERLINE] =
+    g_param_spec_boolean ("use-underline",
+                          _("Use underline"),
+                          _("If set, an underline in the text indicates the next character should be used for the mnemonic accelerator key"),
+                          FALSE,
+                          G_PARAM_READWRITE | G_PARAM_EXPLICIT_NOTIFY);
+
+  g_object_class_install_properties (object_class, LAST_PROP, props);
+
+  gtk_widget_class_set_template_from_resource (widget_class,
+                                               "/sm/puri/handy/dialer/ui/hdy-action-row.ui");
+  gtk_widget_class_bind_template_child_private (widget_class, HdyActionRow, box);
+  gtk_widget_class_bind_template_child_private (widget_class, HdyActionRow, header);
+  gtk_widget_class_bind_template_child_private (widget_class, HdyActionRow, image);
+  gtk_widget_class_bind_template_child_private (widget_class, HdyActionRow, prefixes);
+  gtk_widget_class_bind_template_child_private (widget_class, HdyActionRow, subtitle);
+  gtk_widget_class_bind_template_child_private (widget_class, HdyActionRow, title);
+  gtk_widget_class_bind_template_child_private (widget_class, HdyActionRow, title_box);
+}
+
+static void
+hdy_action_row_init (HdyActionRow *self)
+{
+  gtk_widget_init_template (GTK_WIDGET (self));
+
+  update_subtitle_visibility (self);
+
+  g_signal_connect (self, "notify::parent", G_CALLBACK (parent_cb), NULL);
+
+}
+
+static void
+hdy_action_row_buildable_add_child (GtkBuildable *buildable,
+                                    GtkBuilder   *builder,
+                                    GObject      *child,
+                                    const gchar  *type)
+{
+  if (type && strcmp (type, "action") == 0)
+    hdy_action_row_add_action (HDY_ACTION_ROW (buildable), GTK_WIDGET (child));
+  else if (type && strcmp (type, "prefix") == 0)
+    hdy_action_row_add_prefix (HDY_ACTION_ROW (buildable), GTK_WIDGET (child));
+  else
+    parent_buildable_iface->add_child (buildable, builder, child, type);
+}
+
+static void
+hdy_action_row_buildable_init (GtkBuildableIface *iface)
+{
+  parent_buildable_iface = g_type_interface_peek_parent (iface);
+  iface->add_child = hdy_action_row_buildable_add_child;
+}
+
+/**
+ * hdy_action_row_new:
+ *
+ * Creates a new #HdyActionRow.
+ *
+ * Returns: a new #HdyActionRow
+ */
+HdyActionRow *
+hdy_action_row_new (void)
+{
+  return g_object_new (HDY_TYPE_ACTION_ROW, NULL);
+}
+
+/**
+ * hdy_action_row_get_title:
+ * @self: a #HdyActionRow
+ *
+ * Gets the title for @self.
+ *
+ * Returns: the title for @self.
+ */
+const gchar *
+hdy_action_row_get_title (HdyActionRow *self)
+{
+  HdyActionRowPrivate *priv;
+
+  g_return_val_if_fail (HDY_IS_ACTION_ROW (self), NULL);
+
+  priv = hdy_action_row_get_instance_private (self);
+
+  return gtk_label_get_text (priv->title);
+}
+
+/**
+ * hdy_action_row_set_title:
+ * @self: a #HdyActionRow
+ * @title: the title
+ *
+ * Sets the title for @self.
+ */
+void
+hdy_action_row_set_title (HdyActionRow *self,
+                          const gchar  *title)
+{
+  HdyActionRowPrivate *priv;
+
+  g_return_if_fail (HDY_IS_ACTION_ROW (self));
+
+  priv = hdy_action_row_get_instance_private (self);
+
+  if (g_strcmp0 (gtk_label_get_text (priv->title), title) == 0)
+    return;
+
+  gtk_label_set_text (priv->title, title);
+  gtk_widget_set_visible (GTK_WIDGET (priv->title),
+                          title != NULL && g_strcmp0 (title, "") != 0);
+
+  g_object_notify_by_pspec (G_OBJECT (self), props[PROP_TITLE]);
+}
+
+/**
+ * hdy_action_row_get_subtitle:
+ * @self: a #HdyActionRow
+ *
+ * Gets the subtitle for @self.
+ *
+ * Returns: the subtitle for @self.
+ */
+const gchar *
+hdy_action_row_get_subtitle (HdyActionRow *self)
+{
+  HdyActionRowPrivate *priv;
+
+  g_return_val_if_fail (HDY_IS_ACTION_ROW (self), NULL);
+
+  priv = hdy_action_row_get_instance_private (self);
+
+  return gtk_label_get_text (priv->subtitle);
+}
+
+/**
+ * hdy_action_row_set_subtitle:
+ * @self: a #HdyActionRow
+ * @subtitle: the subtitle
+ *
+ * Sets the subtitle for @self.
+ */
+void
+hdy_action_row_set_subtitle (HdyActionRow *self,
+                             const gchar  *subtitle)
+{
+  HdyActionRowPrivate *priv;
+
+  g_return_if_fail (HDY_IS_ACTION_ROW (self));
+
+  priv = hdy_action_row_get_instance_private (self);
+
+  if (g_strcmp0 (gtk_label_get_text (priv->subtitle), subtitle) == 0)
+    return;
+
+  gtk_label_set_text (priv->subtitle, subtitle);
+  gtk_widget_set_visible (GTK_WIDGET (priv->subtitle),
+                          subtitle != NULL && g_strcmp0 (subtitle, "") != 0);
+
+  g_object_notify_by_pspec (G_OBJECT (self), props[PROP_SUBTITLE]);
+}
+
+/**
+ * hdy_action_row_get_icon_name:
+ * @self: a #HdyActionRow
+ *
+ * Gets the icon name for @self.
+ *
+ * Returns: the icon name for @self.
+ */
+const gchar *
+hdy_action_row_get_icon_name (HdyActionRow *self)
+{
+  HdyActionRowPrivate *priv;
+  const gchar *icon_name;
+
+  g_return_val_if_fail (HDY_IS_ACTION_ROW (self), NULL);
+
+  priv = hdy_action_row_get_instance_private (self);
+
+  gtk_image_get_icon_name (priv->image, &icon_name, NULL);
+
+  return icon_name;
+}
+
+/**
+ * hdy_action_row_set_icon_name:
+ * @self: a #HdyActionRow
+ * @icon_name: the icon name
+ *
+ * Sets the icon name for @self.
+ */
+void
+hdy_action_row_set_icon_name (HdyActionRow *self,
+                              const gchar  *icon_name)
+{
+  HdyActionRowPrivate *priv;
+  const gchar *old_icon_name;
+
+  g_return_if_fail (HDY_IS_ACTION_ROW (self));
+
+  priv = hdy_action_row_get_instance_private (self);
+
+  gtk_image_get_icon_name (priv->image, &old_icon_name, NULL);
+  if (g_strcmp0 (old_icon_name, icon_name) == 0)
+    return;
+
+  gtk_image_set_from_icon_name (priv->image, icon_name, GTK_ICON_SIZE_INVALID);
+  gtk_widget_set_visible (GTK_WIDGET (priv->image),
+                          icon_name != NULL && g_strcmp0 (icon_name, "") != 0);
+
+  g_object_notify_by_pspec (G_OBJECT (self), props[PROP_ICON_NAME]);
+}
+
+/**
+ * hdy_action_row_get_use_underline:
+ * @self: a #HdyActionRow
+ *
+ * Gets whether an embedded underline in the text of the title and subtitle
+ * labels indicates a mnemonic. See hdy_action_row_set_use_underline().
+ *
+ * Returns: %TRUE if an embedded underline in the title and subtitle labels
+ *          indicates the mnemonic accelerator keys.
+ */
+gboolean
+hdy_action_row_get_use_underline (HdyActionRow *self)
+{
+  HdyActionRowPrivate *priv;
+
+  g_return_val_if_fail (HDY_IS_ACTION_ROW (self), FALSE);
+
+  priv = hdy_action_row_get_instance_private (self);
+
+  return priv->use_underline;
+}
+
+/**
+ * hdy_action_row_set_use_underline:
+ * @self: a #HdyActionRow
+ * @use_underline: %TRUE if underlines in the text indicate mnemonics
+ *
+ * If true, an underline in the text of the title and subtitle labels indicates
+ * the next character should be used for the mnemonic accelerator key.
+ */
+void
+hdy_action_row_set_use_underline (HdyActionRow *self,
+                                  gboolean      use_underline)
+{
+  HdyActionRowPrivate *priv;
+
+  g_return_if_fail (HDY_IS_ACTION_ROW (self));
+
+  priv = hdy_action_row_get_instance_private (self);
+
+  if (priv->use_underline == !!use_underline)
+    return;
+
+  priv->use_underline = !!use_underline;
+  gtk_label_set_use_underline (priv->title, priv->use_underline);
+  gtk_label_set_use_underline (priv->subtitle, priv->use_underline);
+  gtk_label_set_mnemonic_widget (priv->title, GTK_WIDGET (self));
+  gtk_label_set_mnemonic_widget (priv->subtitle, GTK_WIDGET (self));
+
+  g_object_notify_by_pspec (G_OBJECT (self), props[PROP_USE_UNDERLINE]);
+}
+
+/**
+ * hdy_action_row_add_action:
+ * @self: a #HdyActionRow
+ * @widget: (allow-none): the action widget
+ *
+ * Adds an action widget to @self.
+ */
+void
+hdy_action_row_add_action (HdyActionRow *self,
+                           GtkWidget    *widget)
+{
+  HdyActionRowPrivate *priv;
+
+  g_return_if_fail (HDY_IS_ACTION_ROW (self));
+
+  priv = hdy_action_row_get_instance_private (self);
+
+  gtk_box_pack_end (priv->header, widget, FALSE, TRUE, 0);
+}
+
+/**
+ * hdy_action_row_add_prefix:
+ * @self: a #HdyActionRow
+ * @widget: (allow-none): the prefix widget
+ *
+ * Adds a prefix widget to @self.
+ */
+void
+hdy_action_row_add_prefix (HdyActionRow *self,
+                           GtkWidget    *widget)
+{
+  HdyActionRowPrivate *priv;
+
+  g_return_if_fail (HDY_IS_ACTION_ROW (self));
+
+  priv = hdy_action_row_get_instance_private (self);
+
+  gtk_box_pack_start (priv->prefixes, widget, FALSE, TRUE, 0);
+  gtk_widget_show (GTK_WIDGET (priv->prefixes));
+}
+
+void
+hdy_action_row_activate (HdyActionRow *self)
+{
+  g_return_if_fail (HDY_IS_ACTION_ROW (self));
+
+  HDY_ACTION_ROW_GET_CLASS (self)->activate (self);
+}

src/hdy-action-row.h

+/*
+ * Copyright (C) 2018 Purism SPC
+ *
+ * SPDX-License-Identifier: LGPL-2.1+
+ */
+
+#pragma once
+
+#if !defined(_HANDY_INSIDE) && !defined(HANDY_COMPILATION)
+#error "Only <handy.h> can be included directly."
+#endif
+
+#include <gtk/gtk.h>
+
+G_BEGIN_DECLS
+
+#define HDY_TYPE_ACTION_ROW (hdy_action_row_get_type())
+
+G_DECLARE_DERIVABLE_TYPE (HdyActionRow, hdy_action_row, HDY, ACTION_ROW, GtkListBoxRow)
+
+/**
+ * HdyActionRowClass
+ * @parent_class: The parent class
+ * @activate: Activates the row to trigger its main action.
+ */
+struct _HdyActionRowClass
+{
+  GtkListBoxRowClass parent_class;
+
+  void (*activate) (HdyActionRow *self);
+};
+
+HdyActionRow *hdy_action_row_new (void);
+
+const gchar *hdy_action_row_get_title (HdyActionRow *self);
+void         hdy_action_row_set_title (HdyActionRow *self,
+                                       const gchar  *title);
+
+const gchar *hdy_action_row_get_subtitle (HdyActionRow *self);
+void         hdy_action_row_set_subtitle (HdyActionRow *self,
+                                          const gchar  *subtitle);
+
+const gchar *hdy_action_row_get_icon_name (HdyActionRow *self);
+void         hdy_action_row_set_icon_name (HdyActionRow *self,
+                                           const gchar  *icon_name);
+
+gboolean hdy_action_row_get_use_underline (HdyActionRow *self);
+void     hdy_action_row_set_use_underline (HdyActionRow *self,
+                                           gboolean      use_underline);
+
+void hdy_action_row_add_action (HdyActionRow *self,
+                                GtkWidget    *widget);
+
+void hdy_action_row_add_prefix (HdyActionRow *self,
+                                GtkWidget    *widget);
+
+void hdy_action_row_activate (HdyActionRow *self);
+
+G_END_DECLS

src/hdy-action-row.ui

+<?xml version="1.0" encoding="UTF-8"?>
+<interface>
+  <template class="HdyActionRow" parent="GtkListBoxRow">
+    <child>
+      <object class="GtkBox" id="box">
+        <property name="orientation">vertical</property>
+        <property name="visible">True</property>
+        <child>
+          <object class="GtkBox" id="header">
+            <property name="can_focus">False</property>
+            <property name="height_request">50</property>
+            <property name="margin_end">12</property>
+            <property name="margin_start">12</property>
+            <property name="spacing">12</property>
+            <property name="valign">center</property>
+            <property name="visible">True</property>
+            <child>
+              <object class="GtkBox" id="prefixes">
+                <property name="can_focus">False</property>
+                <property name="spacing">12</property>
+                <property name="visible">False</property>
+              </object>
+            </child>
+            <child>
+              <object class="GtkImage" id="image">
+                <property name="pixel_size">32</property>
+                <property name="valign">center</property>
+              </object>
+            </child>
+            <child>
+              <object class="GtkBox" id="title_box">
+                <property name="can_focus">False</property>
+                <property name="halign">start</property>
+                <property name="margin_bottom">8</property>
+                <property name="margin_top">8</property>
+                <property name="orientation">vertical</property>
+                <property name="valign">center</property>
+                <property name="visible">True</property>
+                <child>
+                  <object class="GtkLabel" id="title">
+                    <property name="can_focus">False</property>
+                    <property name="ellipsize">end</property>
+                    <property name="halign">start</property>
+                    <property name="hexpand">True</property>
+                    <property name="visible">True</property>
+                    <property name="xalign">0</property>
+                  </object>
+                </child>
+                <child>
+                  <object class="GtkLabel" id="subtitle">
+                    <property name="can_focus">False</property>
+                    <property name="ellipsize">end</property>
+                    <property name="halign">start</property>
+                    <property name="hexpand">True</property>
+                    <property name="xalign">0</property>
+                    <style>
+                      <class name="dim-label" />
+                    </style>
+                    <attributes>
+                      <attribute name="scale" value="0.8" />
+                    </attributes>
+                  </object>
+                </child>
+              </object>
+            </child>
+          </object>
+        </child>
+      </object>
+    </child>
+  </template>
+</interface>

src/meson.build

@@ -48,6 +48,7 @@ libhandy_public_sources += [hdy_enums[0]]
 libhandy_generated_headers += [hdy_enums[1]]
 
 src_headers = [
+  'hdy-action-row.h',
   'hdy-arrows.h',
   'hdy-column.h',
   'hdy-dialer-button.h',
@@ -75,6 +76,7 @@ libhandy_init_public_types = custom_target('hdy-public-types.c',
 
 src_sources = [
   'gtkprogresstracker.c',
+  'hdy-action-row.c',
   'hdy-arrows.c',
   'hdy-column.c',
   'hdy-dialer-button.c',

tests/meson.build

@@ -19,6 +19,7 @@ test_link_args = [
 ]
 
 test_names = [
+  'test-action-row',
   'test-arrows',
   'test-dialer',
   'test-dialer-cycle-button',

tests/test-action-row.c

+/*
+ * Copyright (C) 2018 Purism SPC
+ *
+ * SPDX-License-Identifier: LGPL-2.1+
+ */
+
+#define HANDY_USE_UNSTABLE_API
+#include <handy.h>
+
+
+static void
+test_hdy_action_row_add (void)
+{
+  g_autoptr (HdyActionRow) row = NULL;
+  GtkWidget *sw;
+
+  row = g_object_ref_sink (HDY_ACTION_ROW (hdy_action_row_new ()));
+  g_assert_nonnull (row);
+
+  sw = gtk_switch_new ();
+  g_assert_nonnull (sw);
+
+  gtk_container_add (GTK_CONTAINER (row), sw);
+}
+
+
+static void
+test_hdy_action_row_add_action (void)
+{
+  g_autoptr (HdyActionRow) row = NULL;
+  GtkWidget *sw;
+
+  row = g_object_ref_sink (HDY_ACTION_ROW (hdy_action_row_new ()));
+  g_assert_nonnull (row);
+
+  sw = gtk_switch_new ();
+  g_assert_nonnull (sw);
+
+  hdy_action_row_add_action (row, sw);
+}
+
+
+static void
+test_hdy_action_row_add_prefix (void)
+{
+  g_autoptr (HdyActionRow) row = NULL;
+  GtkWidget *radio;
+
+  row = g_object_ref_sink (HDY_ACTION_ROW (hdy_action_row_new ()));
+  g_assert_nonnull (row);
+
+  radio = gtk_radio_button_new (NULL);
+  g_assert_nonnull (radio);
+
+  hdy_action_row_add_prefix (row, radio);
+}
+
+
+static void
+test_hdy_action_row_title (void)
+{
+  g_autoptr (HdyActionRow) row = NULL;
+
+  row = g_object_ref_sink (HDY_ACTION_ROW (hdy_action_row_new ()));
+  g_assert_nonnull (row);
+
+  g_assert_cmpstr (hdy_action_row_get_title (row), ==, "");
+
+  hdy_action_row_set_title (row, "Dummy title");
+  g_assert_cmpstr (hdy_action_row_get_title (row), ==, "Dummy title");
+}
+
+
+static void
+test_hdy_action_row_subtitle (void)
+{
+  g_autoptr (HdyActionRow) row = NULL;
+
+  row = g_object_ref_sink (HDY_ACTION_ROW (hdy_action_row_new ()));
+  g_assert_nonnull (row);
+
+  g_assert_cmpstr (hdy_action_row_get_subtitle (row), ==, "");
+
+  hdy_action_row_set_subtitle (row, "Dummy subtitle");
+  g_assert_cmpstr (hdy_action_row_get_subtitle (row), ==, "Dummy subtitle");
+}
+
+
+static void
+test_hdy_action_row_icon_name (void)
+{
+  g_autoptr (HdyActionRow) row = NULL;
+
+  row = g_object_ref_sink (HDY_ACTION_ROW (hdy_action_row_new ()));
+  g_assert_nonnull (row);
+
+  g_assert_null (hdy_action_row_get_icon_name (row));
+
+  hdy_action_row_set_icon_name (row, "dummy-icon-name");
+  g_assert_cmpstr (hdy_action_row_get_icon_name (row), ==, "dummy-icon-name");
+}
+
+
+static void
+test_hdy_action_row_use_undeline (void)
+{
+  g_autoptr (HdyActionRow) row = NULL;
+
+  row = g_object_ref_sink (HDY_ACTION_ROW (hdy_action_row_new ()));
+  g_assert_nonnull (row);
+
+  g_assert_false (hdy_action_row_get_use_underline (row));
+
+  hdy_action_row_set_use_underline (row, TRUE);
+  g_assert_true (hdy_action_row_get_use_underline (row));
+
+  hdy_action_row_set_use_underline (row, FALSE);
+  g_assert_false (hdy_action_row_get_use_underline (row));
+}
+
+
+gint
+main (gint argc,
+      gchar *argv[])
+{
+  gtk_test_init (&argc, &argv, NULL);
+
+  g_test_add_func("/Handy/ActionRow/add", test_hdy_action_row_add);
+  g_test_add_func("/Handy/ActionRow/add_action", test_hdy_action_row_add_action);
+  g_test_add_func("/Handy/ActionRow/add_prefix", test_hdy_action_row_add_prefix);
+  g_test_add_func("/Handy/ActionRow/title", test_hdy_action_row_title);
+  g_test_add_func("/Handy/ActionRow/subtitle", test_hdy_action_row_subtitle);
+  g_test_add_func("/Handy/ActionRow/icon_name", test_hdy_action_row_icon_name);
+  g_test_add_func("/Handy/ActionRow/use_underline", test_hdy_action_row_use_undeline);
+
+  return g_test_run();
+}