src/dolphinnavigatorswidgetaction.cpp

   1 /*
   2     This file is part of the KDE project
   3     SPDX-FileCopyrightText: 2020 Felix Ernst <felixernst@kde.org>
   4
   5     SPDX-License-Identifier: LGPL-2.1-only OR LGPL-3.0-only OR LicenseRef-KDE-Accepted-LGPL
   6 */
   7
   8 #include "dolphinnavigatorswidgetaction.h"
   9
  10 #include "trash/dolphintrash.h"
  11
  12 #include <KCoreAddons>
  13 #include <KLocalizedString>
  14 #include <KNotificationJobUiDelegate>
  15 #include <KService>
  16
  17 #include <KIO/ApplicationLauncherJob>
  18
  19 #include <QApplication>
  20 #include <QHBoxLayout>
  21 #include <QPushButton>
  22 #include <QStyle>
  23 #include <QToolBar>
  24
  25 #include <limits>
  26
  27 DolphinNavigatorsWidgetAction::DolphinNavigatorsWidgetAction(QWidget *parent)
  28     : QWidgetAction{parent}
  29     , m_splitter{new QSplitter(Qt::Horizontal)}
  30     , m_adjustSpacingTimer{new QTimer(this)}
  31     , m_viewGeometriesHelper{m_splitter.get(), this}
  32 {
  33     updateText();
  34     setIcon(QIcon::fromTheme(QStringLiteral("dialog-scripts")));
  35
  36     m_splitter->setChildrenCollapsible(false);
  37
  38     m_splitter->addWidget(createNavigatorWidget(Primary));
  39     m_splitter->setFocusProxy(primaryUrlNavigator());
  40
  41     m_adjustSpacingTimer->setInterval(100);
  42     m_adjustSpacingTimer->setSingleShot(true);
  43     connect(m_adjustSpacingTimer.get(), &QTimer::timeout, this, &DolphinNavigatorsWidgetAction::adjustSpacing);
  44 }
  45
  46 void DolphinNavigatorsWidgetAction::adjustSpacing()
  47 {
  48     m_previousWindowWidth = qobject_cast<QWidget *>(parent())->window()->width();
  49     auto viewGeometries = m_viewGeometriesHelper.viewGeometries();
  50     const int widthOfSplitterPrimary = viewGeometries.globalXOfPrimary + viewGeometries.widthOfPrimary - viewGeometries.globalXOfNavigatorsWidget;
  51     const QList<int> splitterSizes = {widthOfSplitterPrimary, m_splitter->width() - widthOfSplitterPrimary - m_splitter->handleWidth()};
  52     m_splitter->setSizes(splitterSizes);
  53
  54     // primary side of m_splitter
  55     int leadingSpacing = viewGeometries.globalXOfPrimary - viewGeometries.globalXOfNavigatorsWidget;
  56     if (leadingSpacing < 0) {
  57         leadingSpacing = 0;
  58     }
  59     int trailingSpacing = (viewGeometries.globalXOfNavigatorsWidget + m_splitter->width()) - (viewGeometries.globalXOfPrimary + viewGeometries.widthOfPrimary);
  60     if (trailingSpacing < 0 || emptyTrashButton(Primary)->isVisible() || networkFolderButton(Primary)->isVisible()) {
  61         trailingSpacing = 0;
  62     }
  63     const int widthLeftForUrlNavigator = m_splitter->widget(0)->width() - leadingSpacing - trailingSpacing;
  64     const int widthNeededForUrlNavigator = primaryUrlNavigator()->sizeHint().width() - widthLeftForUrlNavigator;
  65     if (widthNeededForUrlNavigator > 0) {
  66         trailingSpacing -= widthNeededForUrlNavigator;
  67         if (trailingSpacing < 0) {
  68             leadingSpacing += trailingSpacing;
  69             trailingSpacing = 0;
  70         }
  71         if (leadingSpacing < 0) {
  72             leadingSpacing = 0;
  73         }
  74     }
  75     spacing(Primary, Leading)->setMinimumWidth(leadingSpacing);
  76     spacing(Primary, Trailing)->setFixedWidth(trailingSpacing);
  77
  78     // secondary side of m_splitter
  79     if (viewGeometries.globalXOfSecondary == INT_MIN) {
  80         Q_ASSERT(viewGeometries.widthOfSecondary == INT_MIN);
  81         return;
  82     }
  83     spacing(Primary, Trailing)->setFixedWidth(0);
  84
  85     trailingSpacing = (viewGeometries.globalXOfNavigatorsWidget + m_splitter->width()) - (viewGeometries.globalXOfSecondary + viewGeometries.widthOfSecondary);
  86     if (trailingSpacing < 0 || emptyTrashButton(Secondary)->isVisible() || networkFolderButton(Secondary)->isVisible()) {
  87         trailingSpacing = 0;
  88     } else {
  89         const int widthLeftForUrlNavigator2 = m_splitter->widget(1)->width() - trailingSpacing;
  90         const int widthNeededForUrlNavigator2 = secondaryUrlNavigator()->sizeHint().width() - widthLeftForUrlNavigator2;
  91         if (widthNeededForUrlNavigator2 > 0) {
  92             trailingSpacing -= widthNeededForUrlNavigator2;
  93             if (trailingSpacing < 0) {
  94                 trailingSpacing = 0;
  95             }
  96         }
  97     }
  98     spacing(Secondary, Trailing)->setMinimumWidth(trailingSpacing);
  99 }
 100
 101 void DolphinNavigatorsWidgetAction::createSecondaryUrlNavigator()
 102 {
 103     Q_ASSERT(m_splitter->count() == 1);
 104     m_splitter->addWidget(createNavigatorWidget(Secondary));
 105     Q_ASSERT(m_splitter->count() == 2);
 106 #if KIO_VERSION >= QT_VERSION_CHECK(6, 14, 0)
 107     secondaryUrlNavigator()->setBackgroundEnabled(primaryUrlNavigator()->isBackgroundEnabled());
 108 #endif
 109     updateText();
 110 }
 111
 112 void DolphinNavigatorsWidgetAction::followViewContainersGeometry(QWidget *primaryViewContainer, QWidget *secondaryViewContainer)
 113 {
 114     m_viewGeometriesHelper.setViewContainers(primaryViewContainer, secondaryViewContainer);
 115     adjustSpacing();
 116 }
 117
 118 bool DolphinNavigatorsWidgetAction::isInToolbar() const
 119 {
 120     return qobject_cast<QToolBar *>(m_splitter->parentWidget());
 121 }
 122
 123 DolphinUrlNavigator *DolphinNavigatorsWidgetAction::primaryUrlNavigator() const
 124 {
 125     Q_ASSERT(m_splitter);
 126     return m_splitter->widget(0)->findChild<DolphinUrlNavigator *>();
 127 }
 128
 129 DolphinUrlNavigator *DolphinNavigatorsWidgetAction::secondaryUrlNavigator() const
 130 {
 131     Q_ASSERT(m_splitter);
 132     if (m_splitter->count() < 2) {
 133         return nullptr;
 134     }
 135     return m_splitter->widget(1)->findChild<DolphinUrlNavigator *>();
 136 }
 137
 138 void DolphinNavigatorsWidgetAction::setSecondaryNavigatorVisible(bool visible)
 139 {
 140     if (visible) {
 141         Q_ASSERT(m_splitter->count() == 2);
 142         m_splitter->widget(0)->setContentsMargins(0, 0, m_splitter->style()->pixelMetric(QStyle::PM_LayoutRightMargin), 0);
 143         m_splitter->widget(1)->setContentsMargins(m_splitter->style()->pixelMetric(QStyle::PM_LayoutLeftMargin), 0, 0, 0);
 144         m_splitter->widget(1)->setVisible(true);
 145     } else if (m_splitter->count() > 1) {
 146         m_splitter->widget(1)->setVisible(false);
 147         m_splitter->widget(0)->setContentsMargins(0, 0, 0, 0);
 148         m_splitter->widget(1)->setContentsMargins(0, 0, 0, 0);
 149         // Fix an unlikely event of wrong trash button visibility.
 150         emptyTrashButton(Secondary)->setVisible(false);
 151     }
 152     updateText();
 153 }
 154
 155 void DolphinNavigatorsWidgetAction::setBackgroundEnabled(bool enabled)
 156 {
 157 #if KIO_VERSION >= QT_VERSION_CHECK(6, 14, 0)
 158     m_splitter->setAutoFillBackground(!enabled);
 159     m_splitter->setBackgroundRole(enabled ? QPalette::Window : QPalette::Base);
 160     primaryUrlNavigator()->setBackgroundEnabled(enabled);
 161     if (secondaryUrlNavigator()) {
 162         secondaryUrlNavigator()->setBackgroundEnabled(enabled);
 163     }
 164 #else
 165     Q_UNUSED(enabled);
 166 #endif
 167 }
 168
 169 QWidget *DolphinNavigatorsWidgetAction::createWidget(QWidget *parent)
 170 {
 171     QWidget *oldParent = m_splitter->parentWidget();
 172     if (oldParent && oldParent->layout()) {
 173         oldParent->layout()->removeWidget(m_splitter.get());
 174         QGridLayout *layout = qobject_cast<QGridLayout *>(oldParent->layout());
 175         if (qobject_cast<QToolBar *>(parent) && layout) {
 176             // in DolphinTabPage::insertNavigatorsWidget the minimumHeight of this row was
 177             // set to fit the m_splitter. Since we are now removing it again, the
 178             // minimumHeight can be reset to 0.
 179             layout->setRowMinimumHeight(0, 0);
 180         }
 181     }
 182     m_splitter->setParent(parent);
 183     return m_splitter.get();
 184 }
 185
 186 void DolphinNavigatorsWidgetAction::deleteWidget(QWidget *widget)
 187 {
 188     Q_UNUSED(widget)
 189     m_splitter->setParent(nullptr);
 190 }
 191
 192 QWidget *DolphinNavigatorsWidgetAction::createNavigatorWidget(Side side) const
 193 {
 194     auto navigatorWidget = new QWidget(m_splitter.get());
 195     auto layout = new QHBoxLayout{navigatorWidget};
 196     layout->setSpacing(0);
 197     layout->setContentsMargins(0, 0, 0, 0);
 198
 199     if (side == Primary) {
 200         auto leadingSpacing = new QWidget{navigatorWidget};
 201         layout->addWidget(leadingSpacing);
 202     }
 203     auto urlNavigator = new DolphinUrlNavigator(navigatorWidget);
 204     layout->addWidget(urlNavigator);
 205
 206     auto emptyTrashButton = newEmptyTrashButton(urlNavigator, navigatorWidget);
 207     layout->addWidget(emptyTrashButton);
 208
 209     auto networkFolderButton = newNetworkFolderButton(urlNavigator, navigatorWidget);
 210     layout->addWidget(networkFolderButton);
 211
 212     connect(
 213         urlNavigator,
 214         &KUrlNavigator::urlChanged,
 215         this,
 216         [urlNavigator, this]() {
 217             // Update URL navigator to show a server URL entry placeholder text if we
 218             // just loaded the remote:/ page, to make it easier for users to figure out
 219             // that they can enter arbitrary remote URLs. See bug 414670
 220             if (urlNavigator->locationUrl().scheme() == QLatin1String("remote")) {
 221                 if (!urlNavigator->isUrlEditable()) {
 222                     urlNavigator->setUrlEditable(true);
 223                 }
 224                 urlNavigator->clearText();
 225                 urlNavigator->setPlaceholderText(i18n("Enter server URL (e.g. smb://[ip address])"));
 226             } else {
 227                 urlNavigator->setPlaceholderText(QString());
 228             }
 229
 230             // We have to wait for DolphinUrlNavigator::sizeHint() to update which
 231             // happens a little bit later than when urlChanged is emitted.
 232             this->m_adjustSpacingTimer->start();
 233         },
 234         Qt::QueuedConnection);
 235
 236     auto trailingSpacing = new QWidget{navigatorWidget};
 237     layout->addWidget(trailingSpacing);
 238     return navigatorWidget;
 239 }
 240
 241 QPushButton *DolphinNavigatorsWidgetAction::emptyTrashButton(DolphinNavigatorsWidgetAction::Side side)
 242 {
 243     int sideIndex = (side == Primary ? 0 : 1);
 244     if (side == Primary) {
 245         return static_cast<QPushButton *>(m_splitter->widget(sideIndex)->layout()->itemAt(2)->widget());
 246     }
 247     return static_cast<QPushButton *>(m_splitter->widget(sideIndex)->layout()->itemAt(1)->widget());
 248 }
 249
 250 QPushButton *DolphinNavigatorsWidgetAction::newEmptyTrashButton(const DolphinUrlNavigator *urlNavigator, QWidget *parent) const
 251 {
 252     auto emptyTrashButton = new QPushButton(QIcon::fromTheme(QStringLiteral("edit-delete")), i18nc("@action:button", "Empty Trash"), parent);
 253     emptyTrashButton->setToolTip(i18n("Empties Trash to create free space"));
 254
 255     emptyTrashButton->setFlat(true);
 256     connect(emptyTrashButton, &QPushButton::clicked, this, [parent]() {
 257         Trash::empty(parent);
 258     });
 259     connect(&Trash::instance(), &Trash::emptinessChanged, emptyTrashButton, &QPushButton::setDisabled);
 260     emptyTrashButton->hide();
 261     connect(urlNavigator, &KUrlNavigator::urlChanged, this, [emptyTrashButton, urlNavigator]() {
 262         emptyTrashButton->setVisible(urlNavigator->locationUrl().scheme() == QLatin1String("trash"));
 263     });
 264     emptyTrashButton->setDisabled(Trash::isEmpty());
 265     return emptyTrashButton;
 266 }
 267
 268 QPushButton *DolphinNavigatorsWidgetAction::networkFolderButton(DolphinNavigatorsWidgetAction::Side side)
 269 {
 270     int sideIndex = (side == Primary ? 0 : 1);
 271     if (side == Primary) {
 272         return static_cast<QPushButton *>(m_splitter->widget(sideIndex)->layout()->itemAt(3)->widget());
 273     }
 274     return static_cast<QPushButton *>(m_splitter->widget(sideIndex)->layout()->itemAt(2)->widget());
 275 }
 276
 277 QPushButton *DolphinNavigatorsWidgetAction::newNetworkFolderButton(const DolphinUrlNavigator *urlNavigator, QWidget *parent) const
 278 {
 279     auto networkFolderButton = new QPushButton(QIcon::fromTheme(QStringLiteral("folder-add")), i18nc("@action:button", "Add Network Folder"), parent);
 280     networkFolderButton->setFlat(true);
 281     connect(networkFolderButton, &QPushButton::clicked, this, [networkFolderButton]() {
 282         const KService::Ptr service = KService::serviceByDesktopName(QStringLiteral("org.kde.knetattach"));
 283         auto *job = new KIO::ApplicationLauncherJob(service, networkFolderButton);
 284         auto *delegate = new KNotificationJobUiDelegate;
 285         delegate->setAutoErrorHandlingEnabled(true);
 286         job->setUiDelegate(delegate);
 287         job->start();
 288     });
 289     networkFolderButton->hide();
 290     connect(urlNavigator, &KUrlNavigator::urlChanged, this, [networkFolderButton, urlNavigator]() {
 291         if (urlNavigator->locationUrl().scheme() == QLatin1String("remote")) {
 292             // Looking up a service can be a bit slow, so we only do it now when it becomes necessary.
 293             const KService::Ptr service = KService::serviceByDesktopName(QStringLiteral("org.kde.knetattach"));
 294             networkFolderButton->setVisible(service);
 295         } else {
 296             networkFolderButton->setVisible(false);
 297         }
 298     });
 299     return networkFolderButton;
 300 }
 301
 302 QWidget *DolphinNavigatorsWidgetAction::spacing(Side side, Position position) const
 303 {
 304     int sideIndex = (side == Primary ? 0 : 1);
 305     if (position == Leading) {
 306         Q_ASSERT(side == Primary); // The secondary side of the splitter has no leading spacing.
 307         return m_splitter->widget(sideIndex)->layout()->itemAt(0)->widget();
 308     }
 309     if (side == Primary) {
 310         return m_splitter->widget(sideIndex)->layout()->itemAt(4)->widget();
 311     }
 312     return m_splitter->widget(sideIndex)->layout()->itemAt(3)->widget();
 313 }
 314
 315 void DolphinNavigatorsWidgetAction::updateText()
 316 {
 317     const int urlNavigatorsAmount = m_splitter->count() > 1 && m_splitter->widget(1)->isVisible() ? 2 : 1;
 318     setText(i18ncp("@action:inmenu", "Location Bar", "Location Bars", urlNavigatorsAmount));
 319 }
 320
 321 DolphinNavigatorsWidgetAction::ViewGeometriesHelper::ViewGeometriesHelper(QWidget *navigatorsWidget, DolphinNavigatorsWidgetAction *navigatorsWidgetAction)
 322     : m_navigatorsWidget{navigatorsWidget}
 323     , m_navigatorsWidgetAction{navigatorsWidgetAction}
 324 {
 325     Q_CHECK_PTR(navigatorsWidget);
 326     Q_CHECK_PTR(navigatorsWidgetAction);
 327 }
 328
 329 bool DolphinNavigatorsWidgetAction::ViewGeometriesHelper::eventFilter(QObject *watched, QEvent *event)
 330 {
 331     if (event->type() == QEvent::Resize) {
 332         if (qobject_cast<QWidget*>(m_navigatorsWidgetAction->parent())->window()->width() != m_navigatorsWidgetAction->m_previousWindowWidth) {
 333             // The window is being resized which means not all widgets have gotten their new sizes yet.
 334             // Let's wait a bit so the sizes of the navigatorsWidget and the viewContainers have all
 335             // had a chance to be updated.
 336             m_navigatorsWidgetAction->m_adjustSpacingTimer->start();
 337         } else {
 338             m_navigatorsWidgetAction->adjustSpacing();
 339             // We could always use the m_adjustSpacingTimer instead of calling adjustSpacing() directly
 340             // here but then the navigatorsWidget doesn't fluently align with the viewContainers when
 341             // the DolphinTabPage::m_expandViewAnimation is animating.
 342         }
 343         return false;
 344     }
 345     return QObject::eventFilter(watched, event);
 346 }
 347
 348 void DolphinNavigatorsWidgetAction::ViewGeometriesHelper::setViewContainers(QWidget *primaryViewContainer, QWidget *secondaryViewContainer)
 349 {
 350     Q_CHECK_PTR(primaryViewContainer);
 351     if (m_primaryViewContainer) {
 352         m_primaryViewContainer->removeEventFilter(this);
 353     }
 354     primaryViewContainer->installEventFilter(this);
 355     m_primaryViewContainer = primaryViewContainer;
 356
 357     // It is not possible to resize the secondaryViewContainer without simultaneously
 358     // resizing the primaryViewContainer so we don't have to installEventFilter() here.
 359     m_secondaryViewContainer = secondaryViewContainer;
 360 }
 361
 362 DolphinNavigatorsWidgetAction::ViewGeometriesHelper::Geometries DolphinNavigatorsWidgetAction::ViewGeometriesHelper::viewGeometries()
 363 {
 364     Q_ASSERT(m_primaryViewContainer);
 365     Geometries geometries;
 366
 367     // width
 368     geometries.widthOfPrimary = m_primaryViewContainer->width();
 369     if (m_secondaryViewContainer) {
 370         geometries.widthOfSecondary = m_secondaryViewContainer->width();
 371     } else {
 372         geometries.widthOfSecondary = INT_MIN;
 373     }
 374
 375     // globalX
 376     if (QApplication::layoutDirection() == Qt::LeftToRight) {
 377         geometries.globalXOfNavigatorsWidget = m_navigatorsWidget->mapToGlobal(QPoint(0, 0)).x();
 378         geometries.globalXOfPrimary = m_primaryViewContainer->mapToGlobal(QPoint(0, 0)).x();
 379         geometries.globalXOfSecondary = !m_secondaryViewContainer ? INT_MIN : m_secondaryViewContainer->mapToGlobal(QPoint(0, 0)).x();
 380     } else {
 381         // When the direction is reversed, globalX does not change.
 382         // For the adjustSpacing() code to work we need globalX to measure from right to left
 383         // and to measure up to the rightmost point of a widget instead of the leftmost.
 384         geometries.globalXOfNavigatorsWidget = (-1) * (m_navigatorsWidget->mapToGlobal(QPoint(0, 0)).x() + m_navigatorsWidget->width());
 385         geometries.globalXOfPrimary = (-1) * (m_primaryViewContainer->mapToGlobal(QPoint(0, 0)).x() + geometries.widthOfPrimary);
 386         geometries.globalXOfSecondary =
 387             !m_secondaryViewContainer ? INT_MIN : (-1) * (m_secondaryViewContainer->mapToGlobal(QPoint(0, 0)).x() + geometries.widthOfSecondary);
 388     }
 389     return geometries;
 390 }
 391
 392 #include "moc_dolphinnavigatorswidgetaction.cpp"