\n" \
- "\n" \
diff --git a/doc/offline.qbs b/doc/offline.qbs
index b72320af..3f1401d8 100644
--- a/doc/offline.qbs
+++ b/doc/offline.qbs
@@ -15,8 +15,63 @@ Product {
])
files: [
- "config/*.qdocconf",
- "src/*.qdoc",
+ "config/fluid-project.qdocconf",
+ "config/macros.qdocconf",
+ "src/controls/Action.qdoc",
+ "src/controls/AlertDialog.qdoc",
+ "src/controls/AppBar.qdoc",
+ "src/controls/AppToolBar.qdoc",
+ "src/controls/ApplicationWindow.qdoc",
+ "src/controls/BodyLabel.qdoc",
+ "src/controls/BottomSheet.qdoc",
+ "src/controls/BottomSheetGrid.qdoc",
+ "src/controls/BottomSheetList.qodc",
+ "src/controls/CaptionLabel.qdoc",
+ "src/controls/Card.qdoc",
+ "src/controls/Chip.qdoc",
+ "src/controls/CircleImage.qdoc",
+ "src/controls/DatePickerDialog.qdoc",
+ "src/controls/DateTimePickerDialog.qdoc",
+ "src/controls/DialogLabel.qdoc",
+ "src/controls/DisplayLabel.qdoc",
+ "src/controls/FloatingActionButton.qdoc",
+ "src/controls/HeadlineLabel.qdoc",
+ "src/controls/Icon.qdoc",
+ "src/controls/InputDialog.qdoc",
+ "src/controls/ListItem.qdoc",
+ "src/controls/Loadable.qdoc",
+ "src/controls/NavigationDrawer.qdoc",
+ "src/controls/NavigationListView.qdoc",
+ "src/controls/NoiseBackground.qdoc",
+ "src/controls/OverlayView.qdoc",
+ "src/controls/Page.qdoc",
+ "src/controls/PageSidebar.qdoc",
+ "src/controls/PageStack.qdoc",
+ "src/controls/Placeholder.qdoc",
+ "src/controls/Ripple.qdoc",
+ "src/controls/SearchBar.qdoc",
+ "src/controls/Showable.qdoc",
+ "src/controls/Sidebar.qdoc",
+ "src/controls/SmoothFadeImage.qdoc",
+ "src/controls/SmoothFadeLoader.qdoc",
+ "src/controls/SnackBar.qdoc",
+ "src/controls/Subheader.qdoc",
+ "src/controls/SubheadingLabel.qdoc",
+ "src/controls/Tab.qdoc",
+ "src/controls/TabbedPage.qdoc",
+ "src/controls/ThinDivider.qdoc",
+ "src/controls/TimePickerDialog.qdoc",
+ "src/controls/TitleLabel.qdoc",
+ "src/controls/ToolButton.qdoc",
+ "src/controls/Units.qdoc",
+ "src/controls/Wave.qdoc",
+ "src/deployment.qdoc",
+ "src/fluidcontrols-qmltypes.qdoc",
+ "src/fluidcore-qmltypes.qdoc",
+ "src/fluideffects-qmltypes.qdoc",
+ "src/fluidlayouts-qmltypes.qdoc",
+ "src/fluidtemplates-qmltypes.qdoc",
+ "src/index.qdoc",
]
Group {
@@ -28,7 +83,14 @@ Product {
Group {
name: "Style"
prefix: "template/style/"
- files: "**"
+ files: [
+ "base.css",
+ "liri.css",
+ "liri.eot",
+ "liri.svg",
+ "liri.ttf",
+ "liri.woff",
+ ]
}
Group {
diff --git a/doc/online.qbs b/doc/online.qbs
deleted file mode 100644
index 88735664..00000000
--- a/doc/online.qbs
+++ /dev/null
@@ -1,40 +0,0 @@
-import qbs 1.0
-
-Product {
- name: "fluid-online-doc"
- builtByDefault: false
- type: "qdoc-output"
-
- Depends { name: "lirideployment" }
- Depends { name: "Qt.core"; versionAtLeast: project.minimumQtVersion }
-
- Qt.core.qdocEnvironment: project.qdocEnvironment.concat([
- "SRCDIR=" + path,
- "QT_INSTALL_DOCS=" + Qt.core.docPath,
- "QT_VERSION=" + Qt.core.version
- ])
-
- files: [
- "config/*.qdocconf",
- "src/*.qdoc",
- ]
-
- Group {
- name: "Online qdocconf file"
- files: "fluid-online.qdocconf"
- fileTags: "qdocconf-main"
- }
-
- Group {
- name: "Style"
- prefix: "template/style/"
- files: "**"
- }
-
- Group {
- fileTagsFilter: ["qdoc-output"]
- qbs.install: true
- qbs.installDir: qbs.targetOS.contains("linux") ? lirideployment.docDir + "/fluid/online-html" : "Docs"
- qbs.installSourceBase: Qt.core.qdocOutputDir
- }
-}
diff --git a/doc/src/controls/Action.qdoc b/doc/src/controls/Action.qdoc
new file mode 100644
index 00000000..2d48d916
--- /dev/null
+++ b/doc/src/controls/Action.qdoc
@@ -0,0 +1,62 @@
+/****************************************************************************
+ * This file is part of Fluid.
+ *
+ * Copyright (C) 2018 Pier Luigi Fiorini
+ * Copyright (C) 2018 Michael Spencer
+ *
+ * $BEGIN_LICENSE:FDL$
+ *
+ * Permission is granted to copy, distribute and/or modify this document
+ * under the terms of the GNU Free Documentation License, Version 1.3
+ * or any later version published by the Free Software Foundation;
+ * with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
+ * A copy of the license is included in the section entitled "GNU
+ * Free Documentation License".
+ *
+ * $END_LICENSE$
+ ***************************************************************************/
+
+/*!
+ \qmltype Action
+ \inqmlmodule Fluid.Controls
+ \ingroup fluidcontrols
+
+ \brief Represents an action shown in an action bar, context menu, or list.
+
+ One of the most common uses of actions is displaying actions in the action bar of a page
+ using the \l Page::actions property. See the example for \l Page for more details.
+
+ Actions may contain \l text, an \l icon, a \l toolTip and a \l shortcut.
+
+ \snippet fluidcontrols-action.qml action
+*/
+
+/*!
+ \qmlproperty string Fluid.Controls::Action::toolTip
+
+ The tool tip displayed for the action.
+*/
+
+/*!
+ \qmlproperty bool Fluid.Controls::Action::visible
+
+ Set to \c false to hide the action in the UI.
+
+ This property is \c true by default.
+*/
+
+/*!
+ \qmlproperty bool Fluid.Controls::Action::hasDividerAfter
+
+ Set to \c true to display a divider after the control bound to this action.
+
+ This property is \c false by default.
+*/
+
+/*!
+ \qmlproperty bool Fluid.Controls::Action::hoverAnimation
+
+ Set to \c true to rotate the icon 90 degrees on mouseover.
+
+ This property is \c false by default.
+*/
diff --git a/doc/src/controls/AlertDialog.qdoc b/doc/src/controls/AlertDialog.qdoc
new file mode 100644
index 00000000..2080a1c2
--- /dev/null
+++ b/doc/src/controls/AlertDialog.qdoc
@@ -0,0 +1,41 @@
+/****************************************************************************
+ * This file is part of Fluid.
+ *
+ * Copyright (C) 2018 Pier Luigi Fiorini
+ *
+ * $BEGIN_LICENSE:FDL$
+ *
+ * Permission is granted to copy, distribute and/or modify this document
+ * under the terms of the GNU Free Documentation License, Version 1.3
+ * or any later version published by the Free Software Foundation;
+ * with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
+ * A copy of the license is included in the section entitled "GNU
+ * Free Documentation License".
+ *
+ * $END_LICENSE$
+ ***************************************************************************/
+
+/*!
+ \qmltype AlertDialog
+ \inqmlmodule Fluid.Controls
+ \ingroup fluidcontrols
+
+ \brief Alert dialogs are urgent interruptions to inform the user about a situation.
+
+ An alert dialog is used to interrupt the user's workflow to inform them about
+ a situation that requires their acknowledgement.
+
+ Most alert don't need a title and they summarize a decision in a sentence or two
+ by either asking a question or making a statement related to the action buttons.
+
+ \snippet fluidcontrols-alertdialog.qml file
+
+ For more information you can read the
+ \l{https://material.io/guidelines/components/dialogs.html}{Material Design guidelines}.
+*/
+
+/*!
+ \qmlproperty string Fluid.Controls::AlertDialog::text
+
+ Informative text to display.
+*/
diff --git a/doc/src/controls/AppBar.qdoc b/doc/src/controls/AppBar.qdoc
new file mode 100644
index 00000000..1cf08dd6
--- /dev/null
+++ b/doc/src/controls/AppBar.qdoc
@@ -0,0 +1,154 @@
+/****************************************************************************
+ * This file is part of Fluid.
+ *
+ * Copyright (C) 2018 Pier Luigi Fiorini
+ * Copyright (C) 2018 Michael Spencer
+ *
+ * $BEGIN_LICENSE:FDL$
+ *
+ * Permission is granted to copy, distribute and/or modify this document
+ * under the terms of the GNU Free Documentation License, Version 1.3
+ * or any later version published by the Free Software Foundation;
+ * with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
+ * A copy of the license is included in the section entitled "GNU
+ * Free Documentation License".
+ *
+ * $END_LICENSE$
+ ***************************************************************************/
+
+/*!
+ \qmltype AppBar
+ \inqmlmodule Fluid.Controls
+ \ingroup fluidcontrols
+
+ \brief Application tool bar.
+
+ For more information you can read the
+ \l{https://material.io/guidelines/layout/structure.html#structure-app-bar}{Material Design guidelines}.
+*/
+
+/*!
+ \qmlproperty Action Fluid.Controls::AppBar::leftAction
+
+ The back action to display to the left of the title in the action bar.
+ When used with a page, this will pick up the page's back action, which
+ by default is a back arrow when there is a page behind the current page
+ on the page stack. However, you can customize this, for example, to show
+ a navigation drawer at the root of your app.
+
+ When using an action bar in a page, set the \l Page::leftAction instead of
+ directly setting this property.
+*/
+
+/*!
+ \qmlproperty list Fluid.Controls::AppBar::actions
+
+ A list of actions to show in the action bar. These actions will be shown
+ anchored to the right, and will overflow if there are more than the
+ maximum number of actions as defined in \l maxActionCount.
+
+ When used with a page, the actions will be set to the page's \l Page::actions
+ property, so set that instead of changing this directly.
+*/
+
+/*!
+ \qmlproperty int Fluid.Controls::AppBar::elevation
+
+ The elevation of the action bar. Set to 0 if you want have a header or some
+ other view below the action bar that you want to appear as part of the action bar.
+*/
+
+/*!
+ \qmlproperty color Fluid.Controls::AppBar::backgroundColor
+
+ The background color of the tool bar when the AppBar's page is active.
+ By default this is the primary color defined in \l Material.primaryColor
+
+ \since Fluid.Controls 1.1
+*/
+
+/*!
+ \qmlproperty color Fluid.Controls::AppBar::decorationColor
+
+ The background color of the window decoration when the AppBar's page is active,
+ usually a darker version of \l backgroundColor.
+ By default this is the primary color defined in \l Material.primaryColor with a
+ shade of \l Material.Shade700.
+
+ \since Fluid.Controls 1.1
+*/
+
+/*!
+ \qmlproperty bool Fluid.Controls::AppBar::overflowMenuVisible
+
+ Value indicates if overflow menu is open or not.
+
+ \readonly
+ \since Fluid.Controls 1.1
+*/
+
+/*!
+ \qmlproperty real Fluid.Controls::AppBar::leftKeyline
+
+ Keyline to align contents to the left to be visually appealing.
+*/
+
+/*!
+ \qmlproperty int Fluid.Controls::AppBar::maxActionCount
+
+ The maximum number of actions that can be displayed before they spill over
+ into a drop-down menu. When using an action bar with a page, this inherits
+ from the global \l AppToolBar::maxActionCount. If you are using an action bar
+ for custom purposes outside of a toolbar, this defaults to \c 3.
+
+ Set to \c 0 if you don't want to overflow actions.
+*/
+
+/*!
+ \qmlproperty string Fluid.Controls::AppBar::title
+
+ The title displayed in the action bar. When used in a page, the title will
+ be set to the title of the page, so set the \l Page::title property instead
+ of changing this directly.
+*/
+
+/*!
+ \qmlproperty list Fluid.Controls::AppBar::customContent
+
+ Custom content to show instead of the title.
+
+ \since Fluid.Controls 1.1
+*/
+
+/*!
+ \qmlproperty list Fluid.Controls::AppBar::extendedContent
+
+ A custom view to show under the row containing the title and actions.
+ Causes the action bar to be extend in height to contain this view.
+
+ \since Fluid.Controls 1.1
+*/
+
+/*!
+ \qmlproperty real Fluid.Controls::AppBar::extendedContentHeight
+ \readonly
+
+ The height of the custom view shown under the row containing the
+ title and actions.
+
+ \since Fluid.Controls 1.1
+*/
+
+/*!
+ \qmlproperty AppToolBar Fluid.Controls::AppBar::toolbar
+
+ Tool bar.
+*/
+
+/*!
+ \qmlmethod void Fluid.Controls::AppBar::toggleOverflowMenu()
+
+ Toggle the overflow menu if the number of actions is greater than \l AppBar::maxActionCount.
+
+ \since Fluid.Controls 1.1
+*/
diff --git a/doc/src/controls/AppToolBar.qdoc b/doc/src/controls/AppToolBar.qdoc
new file mode 100644
index 00000000..57d45ae2
--- /dev/null
+++ b/doc/src/controls/AppToolBar.qdoc
@@ -0,0 +1,55 @@
+/****************************************************************************
+ * This file is part of Fluid.
+ *
+ * Copyright (C) 2018 Pier Luigi Fiorini
+ * Copyright (C) 2018 Michael Spencer
+ *
+ * $BEGIN_LICENSE:FDL$
+ *
+ * Permission is granted to copy, distribute and/or modify this document
+ * under the terms of the GNU Free Documentation License, Version 1.3
+ * or any later version published by the Free Software Foundation;
+ * with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
+ * A copy of the license is included in the section entitled "GNU
+ * Free Documentation License".
+ *
+ * $END_LICENSE$
+ ***************************************************************************/
+
+/*!
+ \qmltype AppToolBar
+ \inqmlmodule Fluid.Controls
+ \ingroup fluidcontrols
+
+ \brief Application tool bar.
+ */
+
+/*!
+ \qmlproperty int Fluid.Controls::AppToolBar::maxActionCount
+
+ Maximum actions to be available on this tool bar.
+*/
+
+/*!
+ \qmlproperty real Fluid.Controls::AppToolBar::appBarHeight
+
+ Height of the \l AppBar considering its extended content.
+*/
+
+/*!
+ \qmlmethod void Fluid.Controls::AppToolBar::pop(Page page)
+
+ Pop the \l AppBar that belongs to \a page from the stack.
+*/
+
+/*!
+ \qmlmethod void Fluid.Controls::AppToolBar::push(Page page)
+
+ Push the \l AppBar that belongs to \a page to the stack.
+*/
+
+/*!
+ \qmlmethod void Fluid.Controls::AppToolBar::replace(Page page)
+
+ Replace current \l AppBar with the one that belongs to \a page.
+*/
diff --git a/doc/src/controls/ApplicationWindow.qdoc b/doc/src/controls/ApplicationWindow.qdoc
new file mode 100644
index 00000000..4a00e246
--- /dev/null
+++ b/doc/src/controls/ApplicationWindow.qdoc
@@ -0,0 +1,86 @@
+/****************************************************************************
+ * This file is part of Fluid.
+ *
+ * Copyright (C) 2018 Pier Luigi Fiorini
+ * Copyright (C) 2018 Michael Spencer
+ *
+ * $BEGIN_LICENSE:FDL$
+ *
+ * Permission is granted to copy, distribute and/or modify this document
+ * under the terms of the GNU Free Documentation License, Version 1.3
+ * or any later version published by the Free Software Foundation;
+ * with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
+ * A copy of the license is included in the section entitled "GNU
+ * Free Documentation License".
+ *
+ * $END_LICENSE$
+ ***************************************************************************/
+
+/*!
+ \qmltype ApplicationWindow
+ \inqmlmodule Fluid.Controls
+ \ingroup fluidcontrols
+
+ \brief A window that provides features commonly used for Material Design apps.
+
+ This is normally what you should use as your root component. It provides a \l ToolBar and
+ \l PageStack to provide access to standard features used by Material Design applications.
+
+ Here is a short working example of an application:
+
+ \qml
+ import QtQuick 2.10
+ import Fluid.Controls 1.1 as FluidControls
+
+ FluidControls.ApplicationWindow {
+ title: "Application Name"
+ width: 1024
+ height: 800
+ visible: true
+
+ initialPage: page
+
+ FluidControls.Page {
+ id: page
+ title: "Page Title"
+
+ Label {
+ anchors.centerIn: parent
+ text: "Hello World!"
+ }
+ }
+ }
+ \endqml
+*/
+
+/*!
+ \qmlproperty color Fluid.Controls::ApplicationWindow::decorationColor
+
+ The color of the status bar or window decorations, if the current
+ platform supports it.
+*/
+
+/*!
+ \qmlproperty Theme Fluid.Controls::ApplicationWindow::decorationTheme
+
+ Theme of the status bar or window decoration, if the current
+ platform supports it.
+*/
+
+/*!
+ \qmlproperty AppToolBar Fluid.Controls::ApplicationWindow::appBar
+
+ The tool bar for this application.
+*/
+
+/*!
+ \qmlproperty Page Fluid.Controls::ApplicationWindow::initialPage
+
+ The initial page shown when the application starts.
+*/
+
+/*!
+ \qmlproperty PageStack Fluid.Controls::ApplicationWindow::pageStack
+
+ The \l PageStack used for controlling pages and transitions between pages.
+*/
diff --git a/doc/src/controls/BodyLabel.qdoc b/doc/src/controls/BodyLabel.qdoc
new file mode 100644
index 00000000..716f1290
--- /dev/null
+++ b/doc/src/controls/BodyLabel.qdoc
@@ -0,0 +1,42 @@
+/****************************************************************************
+ * This file is part of Fluid.
+ *
+ * Copyright (C) 2018 Pier Luigi Fiorini
+ *
+ * $BEGIN_LICENSE:FDL$
+ *
+ * Permission is granted to copy, distribute and/or modify this document
+ * under the terms of the GNU Free Documentation License, Version 1.3
+ * or any later version published by the Free Software Foundation;
+ * with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
+ * A copy of the license is included in the section entitled "GNU
+ * Free Documentation License".
+ *
+ * $END_LICENSE$
+ ***************************************************************************/
+
+/*!
+ \qmltype BodyLabel
+ \inqmlmodule Fluid.Controls
+ \ingroup fluidcontrols
+
+ \brief Text label with standard font and styling suitable to body text.
+
+ Text label for the Material Design body text style.
+
+ \snippet fluidcontrols-bodylabel.qml file
+
+ For more information you can read the
+ \l{https://material.io/guidelines/style/typography.html}{Material Design guidelines}.
+*/
+
+/*!
+ \qmlproperty int Fluid.Controls::BodyLabel::level
+
+ This property holds the label level that controls
+ font style and size.
+
+ It can be either 1 or 2.
+
+ Default value is 1.
+*/
diff --git a/doc/src/controls/BottomSheet.qdoc b/doc/src/controls/BottomSheet.qdoc
new file mode 100644
index 00000000..a6d0e449
--- /dev/null
+++ b/doc/src/controls/BottomSheet.qdoc
@@ -0,0 +1,41 @@
+/****************************************************************************
+ * This file is part of Fluid.
+ *
+ * Copyright (C) 2018 Pier Luigi Fiorini
+ *
+ * $BEGIN_LICENSE:FDL$
+ *
+ * Permission is granted to copy, distribute and/or modify this document
+ * under the terms of the GNU Free Documentation License, Version 1.3
+ * or any later version published by the Free Software Foundation;
+ * with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
+ * A copy of the license is included in the section entitled "GNU
+ * Free Documentation License".
+ *
+ * $END_LICENSE$
+ ***************************************************************************/
+
+/*!
+ \qmltype BottomSheet
+ \inqmlmodule Fluid.Controls
+ \ingroup fluidcontrols
+
+ \brief A sheet of paper that slides up from the bottom.
+
+ A sheet of paper that slides up from the bottom edge of the screen and presents
+ a set of clear and simple actions.
+
+ \snippet fluidcontrols-bottomsheet.qml file
+
+ For more information you can read the
+ \l{https://material.io/guidelines/components/bottom-sheets.html}{Material Design guidelines}.
+*/
+
+/*!
+ \qmlproperty int Fluid.Controls::BottomSheet::maxHeight
+
+ Maximum height of the bottom sheet.
+
+ By default it's set to the height of the \c ApplicationWindow
+ minus \c AppBar height.
+*/
diff --git a/doc/src/controls/BottomSheetGrid.qdoc b/doc/src/controls/BottomSheetGrid.qdoc
new file mode 100644
index 00000000..fc211b2a
--- /dev/null
+++ b/doc/src/controls/BottomSheetGrid.qdoc
@@ -0,0 +1,59 @@
+/****************************************************************************
+ * This file is part of Fluid.
+ *
+ * Copyright (C) 2018 Pier Luigi Fiorini
+ *
+ * $BEGIN_LICENSE:FDL$
+ *
+ * Permission is granted to copy, distribute and/or modify this document
+ * under the terms of the GNU Free Documentation License, Version 1.3
+ * or any later version published by the Free Software Foundation;
+ * with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
+ * A copy of the license is included in the section entitled "GNU
+ * Free Documentation License".
+ *
+ * $END_LICENSE$
+ ***************************************************************************/
+
+/*!
+ \qmltype BottomSheetGrid
+ \inqmlmodule Fluid.Controls
+ \ingroup fluidcontrols
+ \inherits BottomSheet
+
+ \brief A sheet of paper with actions and an optional title that slides up from the bottom.
+
+ A sheet of paper that displays actions in a grid and an optional title that slides up
+ from the bottom edge of the screen and presents a set of clear and simple actions.
+
+ \snippet fluidcontrols-bottomsheetgrid.qml file
+
+ For more information you can read the
+ \l{https://material.io/guidelines/components/bottom-sheets.html}{Material Design guidelines}.
+*/
+
+/*!
+ \qmlproperty string Fluid.Controls::BottomSheetGrid::title
+
+ Title.
+*/
+
+/*!
+ \qmlproperty list Fluid.Controls::BottomSheetGrid::actions
+
+ Actions to display in the bottom sheet.
+*/
+
+/*!
+ \qmlproperty int Fluid.Controls::BottomSheetGrid::columns
+
+ Number of columns.
+ By default it's set to fit the screen width.
+*/
+
+/*!
+ \qmlproperty int Fluid.Controls::BottomSheetGrid::rows
+
+ Number of rows.
+ By default it's set to fit the screen size based on the \l columns.
+*/
diff --git a/doc/src/controls/BottomSheetList.qodc b/doc/src/controls/BottomSheetList.qodc
new file mode 100644
index 00000000..d7852d87
--- /dev/null
+++ b/doc/src/controls/BottomSheetList.qodc
@@ -0,0 +1,45 @@
+/****************************************************************************
+ * This file is part of Fluid.
+ *
+ * Copyright (C) 2018 Pier Luigi Fiorini
+ *
+ * $BEGIN_LICENSE:FDL$
+ *
+ * Permission is granted to copy, distribute and/or modify this document
+ * under the terms of the GNU Free Documentation License, Version 1.3
+ * or any later version published by the Free Software Foundation;
+ * with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
+ * A copy of the license is included in the section entitled "GNU
+ * Free Documentation License".
+ *
+ * $END_LICENSE$
+ ***************************************************************************/
+
+/*!
+ \qmltype BottomSheetList
+ \inqmlmodule Fluid.Controls
+ \ingroup fluidcontrols
+ \inherits BottomSheet
+
+ \brief A sheet of paper with actions and an optional title that slides up from the bottom.
+
+ A sheet of paper that displays actions in a list and an optional title that slides up
+ from the bottom edge of the screen and presents a set of clear and simple actions.
+
+ \snippet fluidcontrols-bottomsheetlist.qml file
+
+ For more information you can read the
+ \l{https://material.io/guidelines/components/bottom-sheets.html}{Material Design guidelines}.
+*/
+
+/*!
+ \qmlproperty string Fluid.Controls::BottomSheetList::title
+
+ Title.
+*/
+
+/*!
+ \qmlproperty list Fluid.Controls::BottomSheetList::actions
+
+ Actions to display in the bottom sheet.
+*/
diff --git a/doc/src/controls/CaptionLabel.qdoc b/doc/src/controls/CaptionLabel.qdoc
new file mode 100644
index 00000000..1c653c07
--- /dev/null
+++ b/doc/src/controls/CaptionLabel.qdoc
@@ -0,0 +1,31 @@
+/****************************************************************************
+ * This file is part of Fluid.
+ *
+ * Copyright (C) 2018 Pier Luigi Fiorini
+ *
+ * $BEGIN_LICENSE:FDL$
+ *
+ * Permission is granted to copy, distribute and/or modify this document
+ * under the terms of the GNU Free Documentation License, Version 1.3
+ * or any later version published by the Free Software Foundation;
+ * with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
+ * A copy of the license is included in the section entitled "GNU
+ * Free Documentation License".
+ *
+ * $END_LICENSE$
+ ***************************************************************************/
+
+/*!
+ \qmltype CaptionLabel
+ \inqmlmodule Fluid.Controls
+ \ingroup fluidcontrols
+
+ \brief Text label with standard font and styling suitable to captions.
+
+ Text label for the Material Design caption text style.
+
+ \snippet fluidcontrols-captionlabel.qml file
+
+ For more information you can read the
+ \l{https://material.io/guidelines/style/typography.html}{Material Design guidelines}.
+*/
diff --git a/doc/src/controls/Card.qdoc b/doc/src/controls/Card.qdoc
new file mode 100644
index 00000000..353ed0d9
--- /dev/null
+++ b/doc/src/controls/Card.qdoc
@@ -0,0 +1,29 @@
+/****************************************************************************
+ * This file is part of Fluid.
+ *
+ * Copyright (C) 2018 Pier Luigi Fiorini
+ *
+ * $BEGIN_LICENSE:FDL$
+ *
+ * Permission is granted to copy, distribute and/or modify this document
+ * under the terms of the GNU Free Documentation License, Version 1.3
+ * or any later version published by the Free Software Foundation;
+ * with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
+ * A copy of the license is included in the section entitled "GNU
+ * Free Documentation License".
+ *
+ * $END_LICENSE$
+ ***************************************************************************/
+
+/*!
+ \qmltype Card
+ \inqmlmodule Fluid.Controls
+ \ingroup fluidcontrols
+
+ \brief Cards display content composed of different elements.
+
+ \snippet fluidcontrols-card.qml file
+
+ For more information you can read the
+ \l{https://material.io/guidelines/components/cards.html}{Material Design guidelines}.
+*/
diff --git a/doc/src/controls/Chip.qdoc b/doc/src/controls/Chip.qdoc
new file mode 100644
index 00000000..125351b7
--- /dev/null
+++ b/doc/src/controls/Chip.qdoc
@@ -0,0 +1,111 @@
+/****************************************************************************
+ * This file is part of Fluid.
+ *
+ * Copyright (C) 2018 Pier Luigi Fiorini
+ *
+ * $BEGIN_LICENSE:FDL$
+ *
+ * Permission is granted to copy, distribute and/or modify this document
+ * under the terms of the GNU Free Documentation License, Version 1.3
+ * or any later version published by the Free Software Foundation;
+ * with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
+ * A copy of the license is included in the section entitled "GNU
+ * Free Documentation License".
+ *
+ * $END_LICENSE$
+ ***************************************************************************/
+
+/*!
+ \qmltype Chip
+ \inherits QtQuick.Controls::AbstractButton
+ \inqmlmodule Fluid.Controls
+ \ingroup fluidcontrols
+ \since Fluid.Controls 1.1
+
+ \brief Chips represent complex entities in small blocks, such as a contact.
+
+ For more information you can read the
+ \l{https://material.io/guidelines/components/chips.html}{Material Design guidelines}.
+*/
+
+/*!
+ \qmlproperty bool Fluid.Controls::Chip::expandable
+
+ This property holds whether this chip can expand to show
+ more information or options.
+
+ \sa Fluid.Controls::Chip::model
+ \sa Fluid.Controls::Chip::delegate
+ \sa Fluid.Controls::Chip::selectedItem
+*/
+
+/*!
+ \qmlproperty model Fluid.Controls::Chip::model
+
+ Expandable chips show a popup with a list view when clicked.
+
+ This property holds the model providing data for said list view.
+
+ The following roles are expected to be present:
+
+ \list
+ \li label - Description of the option
+ \li value - Actual value of the option
+ \li imageSource - URL with the image source for the option
+ \endlist
+
+ \sa Fluid.Controls::Chip::expandable
+ \sa Fluid.Controls::Chip::delegate
+ \sa Fluid.Controls::Chip::selectedItem
+*/
+
+/*!
+ \qmlproperty Component Fluid.Controls::Chip::delegate
+
+ Expandable chips show a popup with a list view when clicked.
+
+ The delegate provides a template defining each item instantiated
+ by the list view.
+
+ By default the delegate is a Fluid.Controls::ListItem.
+
+ \sa Fluid.Controls::Chip::expandable
+ \sa Fluid.Controls::Chip::model
+ \sa Fluid.Controls::Chip::selectedItem
+*/
+
+/*!
+ \qmlproperty Component Fluid.Controls::Chip::selectedItem
+ \readonly
+
+ Expandable chips show a popup with a list view when clicked.
+
+ This property holds the currently selected item.
+
+ By default the delegate is a Fluid.Controls::ListItem and the
+ selected item contains the following properties:
+
+ \list
+ \li string label - Description of the option
+ \li string value - Actual value of the option
+ \li url imageSource - URL with the image source for the option
+ \endlist
+
+ \sa Fluid.Controls::Chip::expandable
+ \sa Fluid.Controls::Chip::model
+ \sa Fluid.Controls::Chip::delegate
+*/
+
+
+/*!
+ \qmlproperty bool Fluid.Controls::Chip::deletable
+
+ This property holds whether the chip can be deleted.
+ The default value is \c false.
+*/
+
+/*!
+ \qmlsignal void Fluid.Controls::Chip::deleted()
+
+ Emitted when the user wants to delete the chip.
+*/
diff --git a/doc/src/controls/CircleImage.qdoc b/doc/src/controls/CircleImage.qdoc
new file mode 100644
index 00000000..9df2b578
--- /dev/null
+++ b/doc/src/controls/CircleImage.qdoc
@@ -0,0 +1,81 @@
+/****************************************************************************
+ * This file is part of Fluid.
+ *
+ * Copyright (C) 2018 Pier Luigi Fiorini
+ *
+ * $BEGIN_LICENSE:FDL$
+ *
+ * Permission is granted to copy, distribute and/or modify this document
+ * under the terms of the GNU Free Documentation License, Version 1.3
+ * or any later version published by the Free Software Foundation;
+ * with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
+ * A copy of the license is included in the section entitled "GNU
+ * Free Documentation License".
+ *
+ * $END_LICENSE$
+ ***************************************************************************/
+
+/*!
+ \qmltype CircleImage
+ \inqmlmodule Fluid.Controls
+ \ingroup fluidcontrols
+
+ \brief Circular image.
+
+ An \l Image with a \l CircleMask.
+*/
+
+/*!
+ \qmlproperty url Fluid.Controls::CircleImage::source
+
+ URL of the image to load.
+
+ \sa Image::source
+*/
+
+/*!
+ \qmlproperty enumeration Fluid.Controls::CircleImage::status
+ \list
+ \li Image.Null - no image has been set
+ \li Image.Ready - the image has been loaded
+ \li Image.Loading - the image is currently being loaded
+ \li Image.Error - an error occurred while loading the image
+ \endlist
+
+ Status of the image loading.
+
+ \sa Image::status
+*/
+
+/*!
+ \qmlproperty size Fluid.Controls::CircleImage::sourceSize
+
+ Actual width and height of the loaded image.
+
+ \sa Image::sourceSize
+*/
+
+/*!
+ \qmlproperty bool Fluid.Controls::CircleImage::asynchronous
+
+ Specify whether the image should be loaded asynchronously.
+
+ \sa Image::asynchronous
+*/
+
+/*!
+ \qmlproperty bool Fluid.Controls::CircleImage::cache
+
+ Specify whether the image should be cached.
+
+ \sa Image::cache
+*/
+
+/*!
+ \qmlproperty enumeration Fluid.Controls::CircleImage::fillMode
+
+ Set this property to define what happens when the source image
+ has a different size than the item.
+
+ \sa Image::fillMode
+*/
diff --git a/doc/src/controls/DatePickerDialog.qdoc b/doc/src/controls/DatePickerDialog.qdoc
new file mode 100644
index 00000000..5d04d057
--- /dev/null
+++ b/doc/src/controls/DatePickerDialog.qdoc
@@ -0,0 +1,115 @@
+/****************************************************************************
+ * This file is part of Fluid.
+ *
+ * Copyright (C) 2018 Pier Luigi Fiorini
+ *
+ * $BEGIN_LICENSE:FDL$
+ *
+ * Permission is granted to copy, distribute and/or modify this document
+ * under the terms of the GNU Free Documentation License, Version 1.3
+ * or any later version published by the Free Software Foundation;
+ * with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
+ * A copy of the license is included in the section entitled "GNU
+ * Free Documentation License".
+ *
+ * $END_LICENSE$
+ ***************************************************************************/
+
+/*!
+ \qmltype DatePickerDialog
+ \inqmlmodule Fluid.Controls
+ \ingroup fluidcontrols
+
+ \brief Dialog to select a single date
+
+ Dialog to select a single date from a calendar.
+
+ \code
+ import QtQuick 2.10
+ import Fluid.Controls 1.0 as FluidControls
+
+ Item {
+ width: 600
+ height: 600
+
+ Button {
+ anchors.centerIn: parent
+ text: qsTr("Open")
+ onClicked: datePickerDialog.open()
+ }
+
+ FluidControls.DatePickerDialog {
+ id: datePickerDialog
+ onAccepted: {
+ console.log(selectedDate);
+ }
+ standardButtons: DialogButtonBox.Ok | DialogButtonBox.Cancel
+ }
+ }
+ \endcode
+
+ For more information you can read the
+ \l{https://material.io/guidelines/components/pickers.html}{Material Design guidelines}.
+*/
+
+/*!
+ \qmlproperty enumeration Fluid.Controls::DatePickerDialog::orientation
+
+ This property holds the date picker orientation.
+ The default value is automatically selected based on the device orientation.
+
+ Possible values:
+ \value DatePicker.Landscape The date picker is landscape.
+ \value DatePicker.Portrait The date picker is portrait.
+*/
+
+/*!
+ \qmlproperty bool Fluid.Controls::DatePickerDialog::dayOfWeekRowVisible
+
+ This property determines the visibility of the day of week row.
+*/
+
+/*!
+ \qmlproperty bool Fluid.Controls::DatePickerDialog::weekNumberVisible
+
+ This property determines the visibility of the week number column.
+*/
+
+/*!
+ \qmlproperty date Fluid.Controls::DatePickerDialog::from
+
+ This property holds the start date.
+*/
+
+/*!
+ \qmlproperty date Fluid.Controls::DatePickerDialog::to
+
+ This property holds the end date.
+*/
+
+/*!
+ \qmlproperty date Fluid.Controls::DatePickerDialog::selectedDate
+
+ This property holds the date that has been selected by the user.
+ The default value is the current date.
+*/
+
+/*!
+ \qmlproperty list