335 lines
11 KiB
Swift
335 lines
11 KiB
Swift
//
|
|
// AnyView+.swift
|
|
// Adwaita
|
|
//
|
|
// Created by david-swift on 16.10.24.
|
|
//
|
|
|
|
@_exported import Core
|
|
import Foundation
|
|
|
|
extension AnyView {
|
|
|
|
/// Add an about dialog to the parent window.
|
|
/// - Parameters:
|
|
/// - visible: Whether the dialog is presented.
|
|
/// - app: The app's name.
|
|
/// - developer: The developer's name.
|
|
/// - version: The version string.
|
|
/// - icon: The app icon.
|
|
/// - website: The app's website.
|
|
/// - issues: Website for reporting issues.
|
|
public func aboutDialog(
|
|
visible: Binding<Bool>,
|
|
app: String? = nil,
|
|
developer: String? = nil,
|
|
version: String? = nil,
|
|
icon: Icon? = nil,
|
|
website: URL? = nil,
|
|
issues: URL? = nil
|
|
) -> AnyView {
|
|
AboutDialog(
|
|
visible: visible,
|
|
child: self,
|
|
appName: app,
|
|
developer: developer,
|
|
version: version,
|
|
icon: icon,
|
|
website: website,
|
|
issues: issues
|
|
)
|
|
}
|
|
|
|
/// Add an alert dialog to the parent window.
|
|
/// - Parameters:
|
|
/// - visible: Whether the dialog is presented.
|
|
/// - heading: The heading.
|
|
/// - body: The body text.
|
|
public func alertDialog(
|
|
visible: Binding<Bool>,
|
|
heading: String,
|
|
body: String = "",
|
|
id: String? = nil
|
|
) -> AlertDialog {
|
|
.init(
|
|
visible: visible,
|
|
child: self,
|
|
id: id ?? "no-id",
|
|
heading: heading,
|
|
body: body
|
|
)
|
|
}
|
|
|
|
/// Add a dialog to the parent window.
|
|
/// - Parameters:
|
|
/// - visible: Whether the dialog is presented.
|
|
/// - title: The dialog's title.
|
|
/// - width: The dialog's width.
|
|
/// - height: The dialog's height.
|
|
/// - content: The dialog's content.
|
|
public func dialog(
|
|
visible: Binding<Bool>,
|
|
title: String? = nil,
|
|
id: String? = nil,
|
|
width: Int? = nil,
|
|
height: Int? = nil,
|
|
@ViewBuilder content: () -> Body
|
|
) -> AnyView {
|
|
Dialog(
|
|
visible: visible,
|
|
child: self,
|
|
id: id ?? "",
|
|
content: content(),
|
|
title: title,
|
|
width: width,
|
|
height: height
|
|
)
|
|
}
|
|
|
|
/// Add a preferences dialog to the parent window.
|
|
/// - Parameters:
|
|
/// - visible: Whether the dialog is presented.
|
|
/// - id: The dialog's id.
|
|
/// - Returns: The view.
|
|
public func preferencesDialog(
|
|
visible: Binding<Bool>,
|
|
id: String? = nil
|
|
) -> PreferencesDialog {
|
|
.init(
|
|
visible: visible,
|
|
child: self,
|
|
id: id ?? ""
|
|
)
|
|
}
|
|
|
|
/// Create an importer file dialog.
|
|
/// - Parameters:
|
|
/// - open: The signal to open the dialog.
|
|
/// - initialFolder: The URL to the folder open when being opened.
|
|
/// - extensions: The accepted file extensions.
|
|
/// - folders: Whether folders are accepted.
|
|
/// - onOpen: Run this when a file for importing has been chosen.
|
|
/// - onClose: Run this when the user cancelled the action.
|
|
public func fileImporter(
|
|
open: Signal,
|
|
initialFolder: URL? = nil,
|
|
extensions: [String]? = nil,
|
|
onOpen: @escaping (URL) -> Void,
|
|
onClose: @escaping () -> Void
|
|
) -> AnyView {
|
|
FileDialog(
|
|
importer: true,
|
|
open: open,
|
|
child: self,
|
|
result: onOpen,
|
|
cancel: onClose,
|
|
initialFolder: initialFolder,
|
|
initialName: nil,
|
|
extensions: extensions
|
|
)
|
|
}
|
|
|
|
/// Create an exporter file dialog.
|
|
/// - Parameters:
|
|
/// - exporter: The signal to open the dialog.
|
|
/// - initialFolder: The URL to the folder open when being opened.
|
|
/// - initialName: The default file name.
|
|
/// - onSave: Run this when a path for exporting has been chosen.
|
|
/// - onClose: Run this when the user cancelled the action.
|
|
public func fileExporter(
|
|
open: Signal,
|
|
initialFolder: URL? = nil,
|
|
initialName: String? = nil,
|
|
onSave: @escaping (URL) -> Void,
|
|
onClose: @escaping () -> Void
|
|
) -> AnyView {
|
|
FileDialog(
|
|
importer: false,
|
|
open: open,
|
|
child: self,
|
|
result: onSave,
|
|
cancel: onClose,
|
|
initialFolder: initialFolder,
|
|
initialName: initialName
|
|
)
|
|
}
|
|
|
|
/// Add a popover on top of the view.
|
|
/// - Parameters:
|
|
/// - visible: Whether the popover is displayed.
|
|
/// - content: The popover's content.
|
|
/// - Returns: The view.
|
|
public func popover(visible: Binding<Bool>, @ViewBuilder content: @escaping () -> Body) -> Overlay {
|
|
overlay {
|
|
Popover(visible: visible)
|
|
.child(content)
|
|
}
|
|
}
|
|
|
|
/// Set the view's maximum width.
|
|
/// - Parameter maxWidth: The maximum width.
|
|
/// - Returns: A view.
|
|
public func frame(maxWidth: Int? = nil) -> Clamp {
|
|
.init()
|
|
.child { self }
|
|
.maximumSize(maxWidth ?? -1)
|
|
}
|
|
|
|
/// Set the view's maximum height.
|
|
/// - Parameter maxHeight: The maximum height.
|
|
/// - Returns: A view.
|
|
public func frame(maxHeight: Int? = nil) -> Clamp {
|
|
.init(vertical: true)
|
|
.child { self }
|
|
.maximumSize(maxHeight ?? -1)
|
|
}
|
|
|
|
/// Add padding around a view.
|
|
/// - Parameters:
|
|
/// - padding: The size of the padding.
|
|
/// - edges: The edges which are affected by the padding.
|
|
/// - Returns: A view.
|
|
public func padding(_ padding: Int = 10, _ edges: Set<Edge> = .all) -> AnyView {
|
|
ModifierWrapper(content: self, padding: padding, edges: edges)
|
|
}
|
|
|
|
/// Enable or disable the horizontal expansion.
|
|
/// - Parameter enabled: Whether it is enabled or disabled.
|
|
/// - Returns: A view.
|
|
public func hexpand(_ enabled: Bool = true) -> AnyView {
|
|
ModifierWrapper(content: self, hexpand: enabled)
|
|
}
|
|
|
|
/// Enable or disable the vertical expansion.
|
|
/// - Parameter enabled: Whether it is enabled or disabled.
|
|
/// - Returns: A view.
|
|
public func vexpand(_ enabled: Bool = true) -> AnyView {
|
|
ModifierWrapper(content: self, vexpand: enabled)
|
|
}
|
|
|
|
/// Set the horizontal alignment.
|
|
/// - Parameter align: The alignment.
|
|
/// - Returns: A view.
|
|
public func halign(_ align: Alignment) -> AnyView {
|
|
ModifierWrapper(content: self, halign: align)
|
|
}
|
|
|
|
/// Set the vertical alignment.
|
|
/// - Parameter align: The alignment.
|
|
/// - Returns: A view.
|
|
public func valign(_ align: Alignment) -> AnyView {
|
|
ModifierWrapper(content: self, valign: align)
|
|
}
|
|
|
|
/// Set the view's minimal width or height.
|
|
/// - Parameters:
|
|
/// - minWidth: The minimal width.
|
|
/// - minHeight: The minimal height.
|
|
/// - Returns: A view.
|
|
public func frame(minWidth: Int? = nil, minHeight: Int? = nil) -> AnyView {
|
|
ModifierWrapper(content: self, minWidth: minWidth, minHeight: minHeight)
|
|
}
|
|
|
|
/// Add a style class to the view.
|
|
/// - Parameters:
|
|
/// - style: The style class.
|
|
/// - active: Whether the style is currently applied.
|
|
/// - Returns: A view.
|
|
public func style(_ style: String, active: Bool = true) -> AnyView {
|
|
ModifierWrapper(content: self, style: style, styleActive: active)
|
|
}
|
|
|
|
/// Make the view insensitive (useful e.g. in overlays).
|
|
/// - Parameter insensitive: Whether the view is insensitive.
|
|
/// - Returns: A view.
|
|
public func insensitive(_ insensitive: Bool = true) -> AnyView {
|
|
ModifierWrapper(content: self, insensitive: insensitive)
|
|
}
|
|
|
|
/// Set the view's visibility.
|
|
/// - Parameter visible: Whether the view is visible.
|
|
/// - Returns: A view.
|
|
public func visible(_ visible: Bool = true) -> AnyView {
|
|
ModifierWrapper(content: self, visible: visible)
|
|
}
|
|
|
|
/// Add a tooltip to the widget.
|
|
/// - Parameter tooltip: The tooltip text.
|
|
/// - Returns: A view.
|
|
public func tooltip(_ tooltip: String) -> AnyView {
|
|
ModifierWrapper(content: self, tooltip: tooltip)
|
|
}
|
|
|
|
/// Present a toast when the signal gets activated.
|
|
/// - Parameters:
|
|
/// - title: The title of the toast.
|
|
/// - signal: The signal which activates the presentation of a toast.
|
|
/// - Returns: A view.
|
|
public func toast(_ title: String, signal: Signal) -> ToastOverlay {
|
|
.init(title, signal: signal)
|
|
.child { self }
|
|
}
|
|
|
|
/// Present a toast with a button when the signal gets activated.
|
|
/// - Parameters:
|
|
/// - title: The title of the toast.
|
|
/// - signal: The signal which activates the presentation of a toast.
|
|
/// - button: The button's label.
|
|
/// - handler: The handler for the button.
|
|
/// - Returns: A view.
|
|
public func toast(_ title: String, signal: Signal, button: String, handler: @escaping () -> Void) -> ToastOverlay {
|
|
.init(title, signal: signal)
|
|
.child { self }
|
|
.action(button: button, handler: handler)
|
|
}
|
|
|
|
/// Add a breakpoint.
|
|
/// - Parameters:
|
|
/// - maxWidth: The maximum width.
|
|
/// - matches: Whether the content view matches the breakpoint.
|
|
public func breakpoint(maxWidth: Int, matches: Binding<Bool>) -> AnyView {
|
|
BreakpointBin(condition: .maxWidth(maxWidth), matches: matches) { self }
|
|
}
|
|
|
|
/// Add a breakpoint.
|
|
/// - Parameters:
|
|
/// - minWidth: The minimum width.
|
|
/// - matches: Whether the content view matches the breakpoint.
|
|
public func breakpoint(minWidth: Int, matches: Binding<Bool>) -> AnyView {
|
|
BreakpointBin(condition: .minWidth(minWidth), matches: matches) { self }
|
|
}
|
|
|
|
/// Add a breakpoint.
|
|
/// - Parameters:
|
|
/// - maxHeight: The maximum height.
|
|
/// - matches: Whether the content view matches the breakpoint.
|
|
public func breakpoint(maxHeight: Int, matches: Binding<Bool>) -> AnyView {
|
|
BreakpointBin(condition: .maxHeight(maxHeight), matches: matches) { self }
|
|
}
|
|
|
|
/// Add a breakpoint.
|
|
/// - Parameters:
|
|
/// - minHeight: The minimum height.
|
|
/// - matches: Whether the content view matches the breakpoint.
|
|
public func breakpoint(minHeight: Int, matches: Binding<Bool>) -> AnyView {
|
|
BreakpointBin(condition: .minHeight(minHeight), matches: matches) { self }
|
|
}
|
|
|
|
/// Whether the view has a width higher or equal to its natural width.
|
|
/// - Parameters:
|
|
/// - matches: Whether the content view matches the breakpoint.
|
|
/// - padding: Increase the natural width by a certain padding.
|
|
public func naturalWidth(matches: Binding<Bool>, padding: Int = 0) -> AnyView {
|
|
BreakpointBin(condition: .naturalWidth(padding: padding), matches: matches) { self }
|
|
}
|
|
|
|
/// Whether the view has a height higher or equal to its natural height.
|
|
/// - Parameters:
|
|
/// - matches: Whether the content view matches the breakpoint.
|
|
/// - padding: Increase the natural height by a certain padding.
|
|
public func naturalHeight(matches: Binding<Bool>, padding: Int = 0) -> AnyView {
|
|
BreakpointBin(condition: .naturalHeight(padding: padding), matches: matches) { self }
|
|
}
|
|
|
|
}
|