aboutsummaryrefslogtreecommitdiffstats
path: root/examples/quickcontrols2/swipetoremove/doc/src/qtquickcontrols2-swipetoremove.qdoc
blob: 095bd837dc6cf6e9e730de1e9fe24137b2f05bb8 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
/****************************************************************************
**
** Copyright (C) 2017 The Qt Company Ltd.
** Contact: https://www.qt.io/licensing/
**
** This file is part of the documentation of the Qt Toolkit.
**
** $QT_BEGIN_LICENSE:FDL$
** Commercial License Usage
** Licensees holding valid commercial Qt licenses may use this file in
** accordance with the commercial license agreement provided with the
** Software or, alternatively, in accordance with the terms contained in
** a written agreement between you and The Qt Company. For licensing terms
** and conditions see https://www.qt.io/terms-conditions. For further
** information use the contact form at https://www.qt.io/contact-us.
**
** GNU Free Documentation License Usage
** Alternatively, this file may be used under the terms of the GNU Free
** Documentation License version 1.3 as published by the Free Software
** Foundation and appearing in the file included in the packaging of
** this file. Please review the following information to ensure
** the GNU Free Documentation License version 1.3 requirements
** will be met: https://www.gnu.org/licenses/fdl-1.3.html.
** $QT_END_LICENSE$
**
****************************************************************************/

/*!
    \example swipetoremove
    \title Qt Quick Controls 2 - Swipe to Remove
    \ingroup qtquickcontrols2-examples
    \brief Demonstrates removing list items by swipe.

    This example demonstrates how \l SwipeDelegate can be used to implement
    removal of list items by swipe. This UI pattern is often used in touch
    user interfaces.

    \image qtquickcontrols2-swipetoremove.png

    Each list item can be swiped to the left, which reveals a label on the
    \l {SwipeDelegate::swipe}{right} side indicating that the item will be
    removed if the swipe is completed. The following snippet contains the
    implementation of the side item.

    \snippet swipetoremove/swipetoremove.qml delegate

    The following snippet presents how the logic of removing items is
    implemented. When the swipe is \l {SwipeDelegate::swipe}{completed}, it
    starts a timer tha waits a few seconds to let the user undo the remove
    action. Once the undo timer triggers, the item is removed from the list:

    \snippet swipetoremove/swipetoremove.qml removal

    Finally, the removal of an item triggers the following transitions. The
    \l {ListView::} {remove} transition applies to the item that is removed,
    and the \l {ListView::}{displaced} transition applies to the other items
    that got displaced due to the removal:

    \snippet swipetoremove/swipetoremove.qml transitions

    \include examples-run.qdocinc
*/