The anigif has reduced quality. See a real recording here.
QtSheet is a simple and easy-to-use library for creating a sliding sheet in Qt.
QtSheet provides a simple animated sliding sheet that can be used in any Qt application. The sheet can be used to display additional information or options to the user. The sheet's content is a just QWidget and completely up to you.
You can customize the
- side of the sheet (left or right)
- the width of the sheet (set to 400px by default)
- the animation duration of the sheet (set to 300ms by default)
/* ... */
m_sheet = new Sheet(sheetContent, this);
m_sheet->setSheetWidth(600);
m_sheet->setShowDurationMs(500);
m_sheet->setHideDurationMs(500);
/* ... */- Hitting the ESC key will close the sheet
In the spirit of Shadcn (A web component framework), just copy the sheet.h and sheet.cpp files into your project and use the sheet.
#include "sheet.h"
MainWindow::MainWindow(QWidget *parent) {
/* ... */
// setup the sheet's content
m_sheetContent = new QWidget(this);
auto sheetLayout = new QVBoxLayout(m_sheetContent);
auto header = new QLabel(this);
header->setText(R"(<html>
<h2>About QtEmpty</h2>
<p>Qt Empty is an example project for qt.
The branch features Tablemodels, Popup-Menus
and the sliding sidepanel.
</p>)");
header->setWordWrap(true);
sheetLayout->setContentsMargins(9, 0, 13, 0);
sheetLayout->addWidget(header);
sheetLayout->addStretch();
// add another close button to the sheet
auto sheetButton = new QPushButton("Close", this);
connect(sheetButton, &QPushButton::clicked, this, [this] {
this->m_sheetPanel->hideSheet();
});
sheetLayout->addWidget(sheetButton, 0, Qt::AlignRight);
// create the sheet panel
m_sheet = new Sheet(m_sheetContent, this);
// add a button to open the sheet
auto sheetButton = new QPushButton("Open Sheet", this);
connect(sheetButton, &QPushButton::clicked, this, [this] {
this->m_sheet->showSheet(this, Sheet::Side::Right);
});
/* ... */
}To compile the example using cmake into a folder called build, you can use the following command:
# first create a build directory
cmake -S . -B build
# then compile the example
cmake --build build
# to clean up the build directory
cmake --build build --target clean
# to run the example
./build/qtsheetIf this does not work, delete the build directory and start over but set the CMAKE_PREFIX_PATH to the Qt installation directory. Set it to a Qt-Version and Compiler. For example:
cmake -S . -B build -DCMAKE_PREFIX_PATH=/path/to/Qt/6.8.2/gcc_64The image shown in the example is not covered by the License of qtsheet, but is provided by Pexels. You can find the image here.
QtSheet is written by Stepan Rutz and released under the WTFPL License. It comes with no warranty and as-is. The WTFPL License is provided as a file in this source-tree and is very permissive (to say the least).
I develop jumping back and forth between QtCreator and VSCode, both open at the same time on the same source tree and it works just fine. To make it work with VSCode, you need to install the following extensions:
- CMake
- CMake Tools
- C++
- C++ Extension Pack
- IntelliSense for C++
Then you can open the folder in VSCode and it will automatically detect the CMakeLists.txt file and configure the project for you. You can then build and run the project from within VSCode.