├── .github └── workflows │ ├── analyze.yml │ ├── format.yml │ └── test.yml ├── .gitignore ├── .metadata ├── .pubignore ├── CHANGELOG.md ├── LICENSE ├── README.md ├── docs ├── _config.yml ├── _includes │ └── header.html ├── _layouts │ └── default.html ├── column_v3.png ├── combined_v3.png ├── divider_theme_v2.png ├── divider_theme_v3.png ├── docking_buttons_build_v2.png ├── docking_layout_uml_v3.png ├── docking_layout_uml_v4.png ├── docking_layout_uml_v5.png ├── docking_v3.png ├── index.md ├── index_1_12_0.md ├── index_1_13_0.md ├── item_buttons_v2.png ├── item_leading_v1.png ├── nonclosable_v2.png ├── nonmaximizable_v1.png ├── old_versions.md ├── row_v3.png ├── tabs_theme_v2.png ├── tabs_v2.png └── versions.md ├── example ├── .gitignore ├── .metadata ├── README.md ├── analysis_options.yaml ├── android │ ├── .gitignore │ ├── app │ │ ├── build.gradle │ │ └── src │ │ │ ├── debug │ │ │ └── AndroidManifest.xml │ │ │ ├── main │ │ │ ├── AndroidManifest.xml │ │ │ ├── kotlin │ │ │ │ └── com │ │ │ │ │ └── example │ │ │ │ │ └── example │ │ │ │ │ └── MainActivity.kt │ │ │ └── res │ │ │ │ ├── drawable-v21 │ │ │ │ └── launch_background.xml │ │ │ │ ├── drawable │ │ │ │ └── launch_background.xml │ │ │ │ ├── mipmap-hdpi │ │ │ │ └── ic_launcher.png │ │ │ │ ├── mipmap-mdpi │ │ │ │ └── ic_launcher.png │ │ │ │ ├── mipmap-xhdpi │ │ │ │ └── ic_launcher.png │ │ │ │ ├── mipmap-xxhdpi │ │ │ │ └── ic_launcher.png │ │ │ │ ├── mipmap-xxxhdpi │ │ │ │ └── ic_launcher.png │ │ │ │ ├── values-night │ │ │ │ └── styles.xml │ │ │ │ └── values │ │ │ │ └── styles.xml │ │ │ └── profile │ │ │ └── AndroidManifest.xml │ ├── build.gradle │ ├── gradle.properties │ ├── gradle │ │ └── wrapper │ │ │ └── gradle-wrapper.properties │ └── settings.gradle ├── ios │ ├── .gitignore │ ├── Flutter │ │ ├── AppFrameworkInfo.plist │ │ ├── Debug.xcconfig │ │ └── Release.xcconfig │ ├── Runner.xcodeproj │ │ ├── project.pbxproj │ │ ├── project.xcworkspace │ │ │ ├── contents.xcworkspacedata │ │ │ └── xcshareddata │ │ │ │ ├── IDEWorkspaceChecks.plist │ │ │ │ └── WorkspaceSettings.xcsettings │ │ └── xcshareddata │ │ │ └── xcschemes │ │ │ └── Runner.xcscheme │ ├── Runner.xcworkspace │ │ ├── contents.xcworkspacedata │ │ └── xcshareddata │ │ │ ├── IDEWorkspaceChecks.plist │ │ │ └── WorkspaceSettings.xcsettings │ ├── Runner │ │ ├── AppDelegate.swift │ │ ├── Assets.xcassets │ │ │ ├── AppIcon.appiconset │ │ │ │ ├── Contents.json │ │ │ │ ├── Icon-App-1024x1024@1x.png │ │ │ │ ├── Icon-App-20x20@1x.png │ │ │ │ ├── Icon-App-20x20@2x.png │ │ │ │ ├── Icon-App-20x20@3x.png │ │ │ │ ├── Icon-App-29x29@1x.png │ │ │ │ ├── Icon-App-29x29@2x.png │ │ │ │ ├── Icon-App-29x29@3x.png │ │ │ │ ├── Icon-App-40x40@1x.png │ │ │ │ ├── Icon-App-40x40@2x.png │ │ │ │ ├── Icon-App-40x40@3x.png │ │ │ │ ├── Icon-App-60x60@2x.png │ │ │ │ ├── Icon-App-60x60@3x.png │ │ │ │ ├── Icon-App-76x76@1x.png │ │ │ │ ├── Icon-App-76x76@2x.png │ │ │ │ └── Icon-App-83.5x83.5@2x.png │ │ │ └── LaunchImage.imageset │ │ │ │ ├── Contents.json │ │ │ │ ├── LaunchImage.png │ │ │ │ ├── LaunchImage@2x.png │ │ │ │ ├── LaunchImage@3x.png │ │ │ │ └── README.md │ │ ├── Base.lproj │ │ │ ├── LaunchScreen.storyboard │ │ │ └── Main.storyboard │ │ ├── Info.plist │ │ └── Runner-Bridging-Header.h │ └── RunnerTests │ │ └── RunnerTests.swift ├── lib │ └── main.dart ├── linux │ ├── .gitignore │ ├── CMakeLists.txt │ ├── flutter │ │ ├── CMakeLists.txt │ │ ├── generated_plugin_registrant.cc │ │ ├── generated_plugin_registrant.h │ │ └── generated_plugins.cmake │ ├── main.cc │ ├── my_application.cc │ └── my_application.h ├── macos │ ├── .gitignore │ ├── Flutter │ │ ├── Flutter-Debug.xcconfig │ │ ├── Flutter-Release.xcconfig │ │ └── GeneratedPluginRegistrant.swift │ ├── Runner.xcodeproj │ │ ├── project.pbxproj │ │ ├── project.xcworkspace │ │ │ └── xcshareddata │ │ │ │ └── IDEWorkspaceChecks.plist │ │ └── xcshareddata │ │ │ └── xcschemes │ │ │ └── Runner.xcscheme │ ├── Runner.xcworkspace │ │ ├── contents.xcworkspacedata │ │ └── xcshareddata │ │ │ └── IDEWorkspaceChecks.plist │ ├── Runner │ │ ├── AppDelegate.swift │ │ ├── Assets.xcassets │ │ │ └── AppIcon.appiconset │ │ │ │ ├── Contents.json │ │ │ │ ├── app_icon_1024.png │ │ │ │ ├── app_icon_128.png │ │ │ │ ├── app_icon_16.png │ │ │ │ ├── app_icon_256.png │ │ │ │ ├── app_icon_32.png │ │ │ │ ├── app_icon_512.png │ │ │ │ └── app_icon_64.png │ │ ├── Base.lproj │ │ │ └── MainMenu.xib │ │ ├── Configs │ │ │ ├── AppInfo.xcconfig │ │ │ ├── Debug.xcconfig │ │ │ ├── Release.xcconfig │ │ │ └── Warnings.xcconfig │ │ ├── DebugProfile.entitlements │ │ ├── Info.plist │ │ ├── MainFlutterWindow.swift │ │ └── Release.entitlements │ └── RunnerTests │ │ └── RunnerTests.swift ├── pubspec.lock ├── pubspec.yaml ├── web │ ├── favicon.png │ ├── icons │ │ ├── Icon-192.png │ │ ├── Icon-512.png │ │ ├── Icon-maskable-192.png │ │ └── Icon-maskable-512.png │ ├── index.html │ └── manifest.json └── windows │ ├── .gitignore │ ├── CMakeLists.txt │ ├── flutter │ ├── CMakeLists.txt │ ├── generated_plugin_registrant.cc │ ├── generated_plugin_registrant.h │ └── generated_plugins.cmake │ └── runner │ ├── CMakeLists.txt │ ├── Runner.rc │ ├── flutter_window.cpp │ ├── flutter_window.h │ ├── main.cpp │ ├── resource.h │ ├── resources │ └── app_icon.ico │ ├── runner.exe.manifest │ ├── utils.cpp │ ├── utils.h │ ├── win32_window.cpp │ └── win32_window.h ├── lib ├── docking.dart └── src │ ├── docking.dart │ ├── docking_buttons_builder.dart │ ├── docking_icons.dart │ ├── drag_over_position.dart │ ├── internal │ ├── debug.dart │ ├── docking_provider.dart │ ├── layout │ │ ├── add_item.dart │ │ ├── drop_item.dart │ │ ├── layout_factory.dart │ │ ├── layout_modifier.dart │ │ ├── layout_stringify.dart │ │ ├── layout_tokenizer.dart │ │ ├── move_item.dart │ │ ├── remove_item.dart │ │ └── remove_item_by_id.dart │ └── widgets │ │ ├── docking_item_widget.dart │ │ ├── docking_tabs_widget.dart │ │ ├── draggable_config_mixin.dart │ │ └── drop │ │ ├── content_wrapper.dart │ │ ├── drop_anchor_widget.dart │ │ └── drop_feedback_widget.dart │ ├── layout │ ├── area_builder.dart │ ├── docking_area_type.dart │ ├── docking_layout.dart │ ├── drop_position.dart │ └── layout_parser.dart │ ├── on_item_close.dart │ ├── on_item_selection.dart │ └── theme │ ├── docking_theme.dart │ └── docking_theme_data.dart ├── pubspec.lock ├── pubspec.yaml ├── svgs └── restore.svg ├── test ├── add_test.dart ├── constructors_test.dart ├── defaults_test.dart ├── exceptions.dart ├── find_test.dart ├── layout_index_test.dart ├── layout_stringify_test.dart ├── move_test.dart ├── remove_by_id_test.dart ├── remove_test.dart └── utils.dart └── uml └── layout.uml /.github/workflows/analyze.yml: -------------------------------------------------------------------------------- 1 | # This workflow uses actions that are not certified by GitHub. 2 | # They are provided by a third-party and are governed by 3 | # separate terms of service, privacy policy, and support 4 | # documentation. 5 | 6 | name: Analyze 7 | 8 | on: 9 | push: 10 | branches: [ "main" ] 11 | pull_request: 12 | branches: [ "main" ] 13 | 14 | jobs: 15 | build: 16 | runs-on: ubuntu-latest 17 | 18 | steps: 19 | - uses: actions/checkout@v3 20 | 21 | - uses: subosito/flutter-action@v2 22 | with: 23 | channel: 'stable' # or: 'beta' or 'master' 24 | 25 | - run: flutter --version 26 | 27 | - name: Install dependencies 28 | run: flutter pub get 29 | 30 | - name: Analyze project source 31 | run: flutter analyze 32 | -------------------------------------------------------------------------------- /.github/workflows/format.yml: -------------------------------------------------------------------------------- 1 | # This workflow uses actions that are not certified by GitHub. 2 | # They are provided by a third-party and are governed by 3 | # separate terms of service, privacy policy, and support 4 | # documentation. 5 | 6 | name: Format 7 | 8 | on: 9 | push: 10 | branches: [ "main" ] 11 | pull_request: 12 | branches: [ "main" ] 13 | 14 | jobs: 15 | build: 16 | runs-on: ubuntu-latest 17 | 18 | steps: 19 | - uses: actions/checkout@v3 20 | 21 | - uses: subosito/flutter-action@v2 22 | with: 23 | channel: 'stable' # or: 'beta' or 'master' 24 | 25 | - run: flutter --version 26 | 27 | - name: Install dependencies 28 | run: flutter pub get 29 | 30 | - name: Verify formatting 31 | run: dart format --output=none --set-exit-if-changed . 32 | -------------------------------------------------------------------------------- /.github/workflows/test.yml: -------------------------------------------------------------------------------- 1 | # This workflow uses actions that are not certified by GitHub. 2 | # They are provided by a third-party and are governed by 3 | # separate terms of service, privacy policy, and support 4 | # documentation. 5 | 6 | name: Test 7 | 8 | on: 9 | push: 10 | branches: [ "main" ] 11 | pull_request: 12 | branches: [ "main" ] 13 | 14 | jobs: 15 | build: 16 | runs-on: ubuntu-latest 17 | 18 | steps: 19 | - uses: actions/checkout@v3 20 | 21 | - uses: subosito/flutter-action@v2 22 | with: 23 | channel: 'stable' # or: 'beta' or 'master' 24 | 25 | - run: flutter --version 26 | 27 | - name: Install dependencies 28 | run: flutter pub get 29 | 30 | - name: Run tests 31 | run: flutter test 32 | -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | # Miscellaneous 2 | *.class 3 | *.log 4 | *.pyc 5 | *.swp 6 | .DS_Store 7 | .atom/ 8 | .buildlog/ 9 | .history 10 | .svn/ 11 | 12 | # IntelliJ related 13 | *.iml 14 | *.ipr 15 | *.iws 16 | .idea/ 17 | 18 | # The .vscode folder contains launch configuration and tasks you configure in 19 | # VS Code which you may wish to be included in version control, so this line 20 | # is commented out by default. 21 | #.vscode/ 22 | 23 | # Flutter/Dart/Pub related 24 | **/doc/api/ 25 | .dart_tool/ 26 | .flutter-plugins 27 | .flutter-plugins-dependencies 28 | .packages 29 | .pub-cache/ 30 | .pub/ 31 | build/ 32 | 33 | # Android related 34 | **/android/**/gradle-wrapper.jar 35 | **/android/.gradle 36 | **/android/captures/ 37 | **/android/gradlew 38 | **/android/gradlew.bat 39 | **/android/local.properties 40 | **/android/**/GeneratedPluginRegistrant.java 41 | 42 | # iOS/XCode related 43 | **/ios/**/*.mode1v3 44 | **/ios/**/*.mode2v3 45 | **/ios/**/*.moved-aside 46 | **/ios/**/*.pbxuser 47 | **/ios/**/*.perspectivev3 48 | **/ios/**/*sync/ 49 | **/ios/**/.sconsign.dblite 50 | **/ios/**/.tags* 51 | **/ios/**/.vagrant/ 52 | **/ios/**/DerivedData/ 53 | **/ios/**/Icon? 54 | **/ios/**/Pods/ 55 | **/ios/**/.symlinks/ 56 | **/ios/**/profile 57 | **/ios/**/xcuserdata 58 | **/ios/.generated/ 59 | **/ios/Flutter/App.framework 60 | **/ios/Flutter/Flutter.framework 61 | **/ios/Flutter/Flutter.podspec 62 | **/ios/Flutter/Generated.xcconfig 63 | **/ios/Flutter/ephemeral 64 | **/ios/Flutter/app.flx 65 | **/ios/Flutter/app.zip 66 | **/ios/Flutter/flutter_assets/ 67 | **/ios/Flutter/flutter_export_environment.sh 68 | **/ios/ServiceDefinitions.json 69 | **/ios/Runner/GeneratedPluginRegistrant.* 70 | 71 | # Exceptions to above rules. 72 | !**/ios/**/default.mode1v3 73 | !**/ios/**/default.mode2v3 74 | !**/ios/**/default.pbxuser 75 | !**/ios/**/default.perspectivev3 76 | -------------------------------------------------------------------------------- /.metadata: -------------------------------------------------------------------------------- 1 | # This file tracks properties of this Flutter project. 2 | # Used by Flutter tool to assess capabilities and perform upgrades etc. 3 | # 4 | # This file should be version controlled and should not be manually edited. 5 | 6 | version: 7 | revision: d79295af24c3ed621c33713ecda14ad196fd9c31 8 | channel: stable 9 | 10 | project_type: package 11 | -------------------------------------------------------------------------------- /.pubignore: -------------------------------------------------------------------------------- 1 | docs/ 2 | 3 | # Miscellaneous 4 | *.class 5 | *.log 6 | *.pyc 7 | *.swp 8 | .DS_Store 9 | .atom/ 10 | .buildlog/ 11 | .history 12 | .svn/ 13 | 14 | # IntelliJ related 15 | *.iml 16 | *.ipr 17 | *.iws 18 | .idea/ 19 | 20 | # The .vscode folder contains launch configuration and tasks you configure in 21 | # VS Code which you may wish to be included in version control, so this line 22 | # is commented out by default. 23 | #.vscode/ 24 | 25 | # Flutter/Dart/Pub related 26 | # Libraries should not include pubspec.lock, per https://dart.dev/guides/libraries/private-files#pubspeclock. 27 | /pubspec.lock 28 | **/doc/api/ 29 | .dart_tool/ 30 | .packages 31 | build/ 32 | -------------------------------------------------------------------------------- /CHANGELOG.md: -------------------------------------------------------------------------------- 1 | ## 1.16.1 2 | 3 | * Bugfix 4 | * The `removeItemById` method does not preserving id. 5 | 6 | ## 1.16.0 7 | 8 | * `Docking` 9 | * Allow to disable draggable 10 | 11 | ## 1.15.0 12 | 13 | * `DockingLayout` 14 | * Method `findDockingTabsWithItem` to finds a `DockingTabs` that has a `DockingItem` with the given id. 15 | * Theme 16 | * The `DockingTheme` class has been added to provide icons customization. 17 | 18 | ## 1.14.1 19 | 20 | * Bugfix 21 | * Fixing the issue that reset the weight after using the `DockingLayout.addItemOn` method. 22 | 23 | ## 1.14.0 24 | 25 | * The `id` attribute has been moved from the `DockingItem` to the `DockingArea`. 26 | * `DockingLayout` 27 | * The `findDockingArea` method has been added to locate any area given an id. 28 | * Save/Load layout feature. 29 | * The `stringify` and `load` methods have been added to convert the layout to String and to load a layout given a String. 30 | 31 | ## 1.13.0 32 | 33 | * Allow `DockingTabs` to be initialized with only 1 child. 34 | 35 | ## 1.12.0 36 | 37 | * `tabbed_view` dependency updated to 1.18.0 38 | * Tab reordering 39 | * `DropPosition` 40 | * The `center` value has been removed. 41 | * `DockingLayout` 42 | * Methods `addItemOnRoot`, `addItemOn` and `moveItem` 43 | * New optional parameter: `dropIndex` 44 | * The `dropPostion` parameter has become optional. 45 | 46 | ## 1.11.2 47 | 48 | * Bugfix 49 | * Error with GlobalKey when expanding a DockingTabs. 50 | 51 | ## 1.11.1 52 | 53 | * Bugfix 54 | * Newer tabbed_view dependency being used causing incompatibility. 55 | 56 | ## 1.11.0 57 | 58 | * `DockingLayout` 59 | * New method: `removeItemByIds` 60 | * Bugfix 61 | * `Docking` is not updating itself after being instantiated with new `DockingLayout` 62 | 63 | ## 1.10.0 64 | 65 | * `DockingItem` 66 | * Allow changing attributes. 67 | * The `clone` method has been removed. 68 | * `DockingLayout` 69 | * New method: `findDockingItem`. 70 | 71 | ## 1.9.0 72 | 73 | * `DockingRow`, `DockingColumn` and `DockingTabs` 74 | * New optional constructor parameters: `size`, `weight`, `minimalWeight` and `minimalSize` 75 | 76 | ## 1.8.0 77 | 78 | * `DockingArea` 79 | * Allowing to configure the initial and minimum size and weight. 80 | 81 | ## 1.7.0 82 | 83 | * `multi_split_view` dependency updated to 2.3.1 84 | * `Docking` 85 | * New parameter: `antiAliasingWorkaround`. 86 | * Bugfix 87 | * The anti-aliasing workaround is clipping a pixel. 88 | 89 | ## 1.6.0 90 | 91 | * `multi_split_view` dependency updated to 2.2.0 92 | * `tabbed_view` dependency updated to 1.16.0 93 | * Exporting dependencies `tabbed_view` and `multi_split_view` along with this package. 94 | * Item leading widget. 95 | 96 | ## 1.5.0 97 | 98 | * `tabbed_view` dependency updated to 1.15.0 99 | 100 | ## 1.4.1+1 101 | 102 | * `tabbed_view` dependency updated to 1.14.0+1 103 | 104 | ## 1.4.1 105 | 106 | * Bugfix 107 | * Maximizing DockingItem disposes DockingItem's where keepAlive is set true. 108 | * `tabbed_view` dependency updated to 1.14.0 109 | 110 | ## 1.4.0 111 | 112 | * New `Docking` parameter: `maximizableTabsArea` 113 | * `Docking.maximizableTabs` parameter has been renamed to `Docking.maximizableTab` 114 | * Bugfix 115 | * Non maximizable `DockingItem` can be maximized. 116 | 117 | ## 1.3.0 118 | 119 | * Allow changing DockingLayout root. 120 | * Bugfix 121 | * Memory leak in DockingLayout listeners. 122 | * `tabbed_view` dependency updated to 1.13.0+1 123 | * `multi_split_view` dependency updated to 2.1.0 124 | 125 | ## 1.2.0+1 126 | 127 | * Updating the README 128 | 129 | ## 1.2.0 130 | 131 | * `multi_split_view` dependency updated to 1.11.0 132 | 133 | ## 1.1.0 134 | 135 | * `multi_split_view` dependency updated to 1.9.0 136 | 137 | ## 1.0.0 138 | 139 | * Feature to maximize docking areas 140 | 141 | ## 0.6.1 142 | 143 | * `multi_split_view` dependency updated to 1.7.2 144 | 145 | ## 0.6.0 146 | 147 | * Feature to keep the state alive 148 | * `DockingButtonsBuilder` typedef 149 | 150 | ## 0.5.0 151 | 152 | * Dynamic value in `DockingItem` 153 | * Non-Closable `DockingItem` 154 | * `DockingItem` 155 | * selection listener 156 | * close listener 157 | * close interceptor 158 | * buttons 159 | 160 | ## 0.4.0 161 | 162 | * Method to add item 163 | * Keep the row and column children's weight, and the selected tab's index after rearranging the layout 164 | 165 | ## 0.3.0 166 | 167 | * Method to remove item 168 | 169 | ## 0.2.0 170 | 171 | * Drag and Drop 172 | 173 | ## 0.1.0 174 | 175 | * Docking layout 176 | * Docking areas 177 | * Initial version of drag and drop areas 178 | 179 | ## 0.0.1 180 | 181 | * Package creation -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2021 Carlos Eduardo Leite de Andrade 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | [![pub](https://img.shields.io/pub/v/docking.svg)](https://pub.dev/packages/docking) 2 | [![](https://img.shields.io/badge/demo-try%20it%20out-blue)](https://caduandrade.github.io/docking_flutter_demo/) 3 | [![pub2](https://img.shields.io/badge/Flutter-%E2%9D%A4-red)](https://flutter.dev/) 4 | ![](https://img.shields.io/badge/%F0%9F%91%8D%20and%20%E2%AD%90-are%20free%20and%20motivate%20me-yellow) 5 | 6 | # Docking 7 | 8 | Layout for placing widgets in docking areas and arrange them into split and tabbed views. 9 | 10 | ![](https://caduandrade.github.io/docking_flutter/docking_v3.png) 11 | 12 | --- 13 | 14 | See full documentation at [https://caduandrade.github.io/docking_flutter/](https://caduandrade.github.io/docking_flutter/) -------------------------------------------------------------------------------- /docs/_config.yml: -------------------------------------------------------------------------------- 1 | markdown: GFM 2 | -------------------------------------------------------------------------------- /docs/_includes/header.html: -------------------------------------------------------------------------------- 1 |

2 | 3 | 4 | 5 | 6 | 7 | 8 |

-------------------------------------------------------------------------------- /docs/_layouts/default.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | {% seo %} 9 | 10 | {% include head-custom.html %} 11 | 12 | 13 |
14 | {% include header.html %} 15 | 16 | {{ content }} 17 |
18 | 19 | 20 | 21 | 22 | -------------------------------------------------------------------------------- /docs/column_v3.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/docs/column_v3.png -------------------------------------------------------------------------------- /docs/combined_v3.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/docs/combined_v3.png -------------------------------------------------------------------------------- /docs/divider_theme_v2.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/docs/divider_theme_v2.png -------------------------------------------------------------------------------- /docs/divider_theme_v3.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/docs/divider_theme_v3.png -------------------------------------------------------------------------------- /docs/docking_buttons_build_v2.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/docs/docking_buttons_build_v2.png -------------------------------------------------------------------------------- /docs/docking_layout_uml_v3.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/docs/docking_layout_uml_v3.png -------------------------------------------------------------------------------- /docs/docking_layout_uml_v4.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/docs/docking_layout_uml_v4.png -------------------------------------------------------------------------------- /docs/docking_layout_uml_v5.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/docs/docking_layout_uml_v5.png -------------------------------------------------------------------------------- /docs/docking_v3.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/docs/docking_v3.png -------------------------------------------------------------------------------- /docs/item_buttons_v2.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/docs/item_buttons_v2.png -------------------------------------------------------------------------------- /docs/item_leading_v1.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/docs/item_leading_v1.png -------------------------------------------------------------------------------- /docs/nonclosable_v2.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/docs/nonclosable_v2.png -------------------------------------------------------------------------------- /docs/nonmaximizable_v1.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/docs/nonmaximizable_v1.png -------------------------------------------------------------------------------- /docs/old_versions.md: -------------------------------------------------------------------------------- 1 | # Docking - Old versions 2 | 3 | [1.13.0](index_1_13_0.md) 4 | [1.12.0](index_1_12_0.md) -------------------------------------------------------------------------------- /docs/row_v3.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/docs/row_v3.png -------------------------------------------------------------------------------- /docs/tabs_theme_v2.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/docs/tabs_theme_v2.png -------------------------------------------------------------------------------- /docs/tabs_v2.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/docs/tabs_v2.png -------------------------------------------------------------------------------- /docs/versions.md: -------------------------------------------------------------------------------- 1 | # Docking 2 | 3 | #### Old versions -------------------------------------------------------------------------------- /example/.gitignore: -------------------------------------------------------------------------------- 1 | # Miscellaneous 2 | *.class 3 | *.log 4 | *.pyc 5 | *.swp 6 | .DS_Store 7 | .atom/ 8 | .buildlog/ 9 | .history 10 | .svn/ 11 | 12 | # IntelliJ related 13 | *.iml 14 | *.ipr 15 | *.iws 16 | .idea/ 17 | 18 | # The .vscode folder contains launch configuration and tasks you configure in 19 | # VS Code which you may wish to be included in version control, so this line 20 | # is commented out by default. 21 | #.vscode/ 22 | 23 | # Flutter/Dart/Pub related 24 | **/doc/api/ 25 | **/ios/Flutter/.last_build_id 26 | .dart_tool/ 27 | .flutter-plugins 28 | .flutter-plugins-dependencies 29 | .packages 30 | .pub-cache/ 31 | .pub/ 32 | /build/ 33 | 34 | # Web related 35 | lib/generated_plugin_registrant.dart 36 | 37 | # Symbolication related 38 | app.*.symbols 39 | 40 | # Obfuscation related 41 | app.*.map.json 42 | 43 | # Android Studio will place build artifacts here 44 | /android/app/debug 45 | /android/app/profile 46 | /android/app/release 47 | -------------------------------------------------------------------------------- /example/.metadata: -------------------------------------------------------------------------------- 1 | # This file tracks properties of this Flutter project. 2 | # Used by Flutter tool to assess capabilities and perform upgrades etc. 3 | # 4 | # This file should be version controlled and should not be manually edited. 5 | 6 | version: 7 | revision: "4cf269e36de2573851eaef3c763994f8f9be494d" 8 | channel: "stable" 9 | 10 | project_type: app 11 | 12 | # Tracks metadata for the flutter migrate command 13 | migration: 14 | platforms: 15 | - platform: root 16 | create_revision: 4cf269e36de2573851eaef3c763994f8f9be494d 17 | base_revision: 4cf269e36de2573851eaef3c763994f8f9be494d 18 | - platform: android 19 | create_revision: 4cf269e36de2573851eaef3c763994f8f9be494d 20 | base_revision: 4cf269e36de2573851eaef3c763994f8f9be494d 21 | - platform: ios 22 | create_revision: 4cf269e36de2573851eaef3c763994f8f9be494d 23 | base_revision: 4cf269e36de2573851eaef3c763994f8f9be494d 24 | - platform: linux 25 | create_revision: 4cf269e36de2573851eaef3c763994f8f9be494d 26 | base_revision: 4cf269e36de2573851eaef3c763994f8f9be494d 27 | - platform: macos 28 | create_revision: 4cf269e36de2573851eaef3c763994f8f9be494d 29 | base_revision: 4cf269e36de2573851eaef3c763994f8f9be494d 30 | - platform: web 31 | create_revision: 4cf269e36de2573851eaef3c763994f8f9be494d 32 | base_revision: 4cf269e36de2573851eaef3c763994f8f9be494d 33 | - platform: windows 34 | create_revision: 4cf269e36de2573851eaef3c763994f8f9be494d 35 | base_revision: 4cf269e36de2573851eaef3c763994f8f9be494d 36 | 37 | # User provided section 38 | 39 | # List of Local paths (relative to this file) that should be 40 | # ignored by the migrate tool. 41 | # 42 | # Files that are not part of the templates will be ignored by default. 43 | unmanaged_files: 44 | - 'lib/main.dart' 45 | - 'ios/Runner.xcodeproj/project.pbxproj' 46 | -------------------------------------------------------------------------------- /example/README.md: -------------------------------------------------------------------------------- 1 | # example 2 | 3 | A new Flutter project. 4 | 5 | ## Getting Started 6 | 7 | This project is a starting point for a Flutter application. 8 | 9 | A few resources to get you started if this is your first Flutter project: 10 | 11 | - [Lab: Write your first Flutter app](https://flutter.dev/docs/get-started/codelab) 12 | - [Cookbook: Useful Flutter samples](https://flutter.dev/docs/cookbook) 13 | 14 | For help getting started with Flutter, view our 15 | [online documentation](https://flutter.dev/docs), which offers tutorials, 16 | samples, guidance on mobile development, and a full API reference. 17 | -------------------------------------------------------------------------------- /example/analysis_options.yaml: -------------------------------------------------------------------------------- 1 | # This file configures the analyzer, which statically analyzes Dart code to 2 | # check for errors, warnings, and lints. 3 | # 4 | # The issues identified by the analyzer are surfaced in the UI of Dart-enabled 5 | # IDEs (https://dart.dev/tools#ides-and-editors). The analyzer can also be 6 | # invoked from the command line by running `flutter analyze`. 7 | 8 | # The following line activates a set of recommended lints for Flutter apps, 9 | # packages, and plugins designed to encourage good coding practices. 10 | include: package:flutter_lints/flutter.yaml 11 | 12 | linter: 13 | # The lint rules applied to this project can be customized in the 14 | # section below to disable rules from the `package:flutter_lints/flutter.yaml` 15 | # included above or to enable additional rules. A list of all available lints 16 | # and their documentation is published at https://dart.dev/lints. 17 | # 18 | # Instead of disabling a lint rule for the entire project in the 19 | # section below, it can also be suppressed for a single line of code 20 | # or a specific dart file by using the `// ignore: name_of_lint` and 21 | # `// ignore_for_file: name_of_lint` syntax on the line or in the file 22 | # producing the lint. 23 | rules: 24 | # avoid_print: false # Uncomment to disable the `avoid_print` rule 25 | # prefer_single_quotes: true # Uncomment to enable the `prefer_single_quotes` rule 26 | 27 | # Additional information about this file can be found at 28 | # https://dart.dev/guides/language/analysis-options 29 | -------------------------------------------------------------------------------- /example/android/.gitignore: -------------------------------------------------------------------------------- 1 | gradle-wrapper.jar 2 | /.gradle 3 | /captures/ 4 | /gradlew 5 | /gradlew.bat 6 | /local.properties 7 | GeneratedPluginRegistrant.java 8 | 9 | # Remember to never publicly share your keystore. 10 | # See https://flutter.dev/docs/deployment/android#reference-the-keystore-from-the-app 11 | key.properties 12 | -------------------------------------------------------------------------------- /example/android/app/build.gradle: -------------------------------------------------------------------------------- 1 | def localProperties = new Properties() 2 | def localPropertiesFile = rootProject.file('local.properties') 3 | if (localPropertiesFile.exists()) { 4 | localPropertiesFile.withReader('UTF-8') { reader -> 5 | localProperties.load(reader) 6 | } 7 | } 8 | 9 | def flutterRoot = localProperties.getProperty('flutter.sdk') 10 | if (flutterRoot == null) { 11 | throw new GradleException("Flutter SDK not found. Define location with flutter.sdk in the local.properties file.") 12 | } 13 | 14 | def flutterVersionCode = localProperties.getProperty('flutter.versionCode') 15 | if (flutterVersionCode == null) { 16 | flutterVersionCode = '1' 17 | } 18 | 19 | def flutterVersionName = localProperties.getProperty('flutter.versionName') 20 | if (flutterVersionName == null) { 21 | flutterVersionName = '1.0' 22 | } 23 | 24 | apply plugin: 'com.android.application' 25 | apply plugin: 'kotlin-android' 26 | apply from: "$flutterRoot/packages/flutter_tools/gradle/flutter.gradle" 27 | 28 | android { 29 | compileSdkVersion 30 30 | 31 | sourceSets { 32 | main.java.srcDirs += 'src/main/kotlin' 33 | } 34 | 35 | defaultConfig { 36 | // TODO: Specify your own unique Application ID (https://developer.android.com/studio/build/application-id.html). 37 | applicationId "com.example.example" 38 | minSdkVersion 16 39 | targetSdkVersion 30 40 | versionCode flutterVersionCode.toInteger() 41 | versionName flutterVersionName 42 | } 43 | 44 | buildTypes { 45 | release { 46 | // TODO: Add your own signing config for the release build. 47 | // Signing with the debug keys for now, so `flutter run --release` works. 48 | signingConfig signingConfigs.debug 49 | } 50 | } 51 | } 52 | 53 | flutter { 54 | source '../..' 55 | } 56 | 57 | dependencies { 58 | implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:$kotlin_version" 59 | } 60 | -------------------------------------------------------------------------------- /example/android/app/src/debug/AndroidManifest.xml: -------------------------------------------------------------------------------- 1 | 3 | 6 | 7 | 8 | -------------------------------------------------------------------------------- /example/android/app/src/main/AndroidManifest.xml: -------------------------------------------------------------------------------- 1 | 3 | 6 | 13 | 17 | 21 | 26 | 30 | 31 | 32 | 33 | 34 | 35 | 37 | 40 | 41 | 42 | -------------------------------------------------------------------------------- /example/android/app/src/main/kotlin/com/example/example/MainActivity.kt: -------------------------------------------------------------------------------- 1 | package com.example.example 2 | 3 | import io.flutter.embedding.android.FlutterActivity 4 | 5 | class MainActivity: FlutterActivity() { 6 | } 7 | -------------------------------------------------------------------------------- /example/android/app/src/main/res/drawable-v21/launch_background.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 12 | 13 | -------------------------------------------------------------------------------- /example/android/app/src/main/res/drawable/launch_background.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 6 | 7 | 12 | 13 | -------------------------------------------------------------------------------- /example/android/app/src/main/res/mipmap-hdpi/ic_launcher.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/android/app/src/main/res/mipmap-hdpi/ic_launcher.png -------------------------------------------------------------------------------- /example/android/app/src/main/res/mipmap-mdpi/ic_launcher.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/android/app/src/main/res/mipmap-mdpi/ic_launcher.png -------------------------------------------------------------------------------- /example/android/app/src/main/res/mipmap-xhdpi/ic_launcher.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/android/app/src/main/res/mipmap-xhdpi/ic_launcher.png -------------------------------------------------------------------------------- /example/android/app/src/main/res/mipmap-xxhdpi/ic_launcher.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/android/app/src/main/res/mipmap-xxhdpi/ic_launcher.png -------------------------------------------------------------------------------- /example/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/android/app/src/main/res/mipmap-xxxhdpi/ic_launcher.png -------------------------------------------------------------------------------- /example/android/app/src/main/res/values-night/styles.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 9 | 15 | 18 | 19 | -------------------------------------------------------------------------------- /example/android/app/src/main/res/values/styles.xml: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 9 | 15 | 18 | 19 | -------------------------------------------------------------------------------- /example/android/app/src/profile/AndroidManifest.xml: -------------------------------------------------------------------------------- 1 | 3 | 6 | 7 | 8 | -------------------------------------------------------------------------------- /example/android/build.gradle: -------------------------------------------------------------------------------- 1 | buildscript { 2 | ext.kotlin_version = '1.3.50' 3 | repositories { 4 | google() 5 | jcenter() 6 | } 7 | 8 | dependencies { 9 | classpath 'com.android.tools.build:gradle:4.1.0' 10 | classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version" 11 | } 12 | } 13 | 14 | allprojects { 15 | repositories { 16 | google() 17 | jcenter() 18 | } 19 | } 20 | 21 | rootProject.buildDir = '../build' 22 | subprojects { 23 | project.buildDir = "${rootProject.buildDir}/${project.name}" 24 | project.evaluationDependsOn(':app') 25 | } 26 | 27 | task clean(type: Delete) { 28 | delete rootProject.buildDir 29 | } 30 | -------------------------------------------------------------------------------- /example/android/gradle.properties: -------------------------------------------------------------------------------- 1 | org.gradle.jvmargs=-Xmx1536M 2 | android.useAndroidX=true 3 | android.enableJetifier=true 4 | -------------------------------------------------------------------------------- /example/android/gradle/wrapper/gradle-wrapper.properties: -------------------------------------------------------------------------------- 1 | #Fri Jun 23 08:50:38 CEST 2017 2 | distributionBase=GRADLE_USER_HOME 3 | distributionPath=wrapper/dists 4 | zipStoreBase=GRADLE_USER_HOME 5 | zipStorePath=wrapper/dists 6 | distributionUrl=https\://services.gradle.org/distributions/gradle-6.7-all.zip 7 | -------------------------------------------------------------------------------- /example/android/settings.gradle: -------------------------------------------------------------------------------- 1 | include ':app' 2 | 3 | def localPropertiesFile = new File(rootProject.projectDir, "local.properties") 4 | def properties = new Properties() 5 | 6 | assert localPropertiesFile.exists() 7 | localPropertiesFile.withReader("UTF-8") { reader -> properties.load(reader) } 8 | 9 | def flutterSdkPath = properties.getProperty("flutter.sdk") 10 | assert flutterSdkPath != null, "flutter.sdk not set in local.properties" 11 | apply from: "$flutterSdkPath/packages/flutter_tools/gradle/app_plugin_loader.gradle" 12 | -------------------------------------------------------------------------------- /example/ios/.gitignore: -------------------------------------------------------------------------------- 1 | **/dgph 2 | *.mode1v3 3 | *.mode2v3 4 | *.moved-aside 5 | *.pbxuser 6 | *.perspectivev3 7 | **/*sync/ 8 | .sconsign.dblite 9 | .tags* 10 | **/.vagrant/ 11 | **/DerivedData/ 12 | Icon? 13 | **/Pods/ 14 | **/.symlinks/ 15 | profile 16 | xcuserdata 17 | **/.generated/ 18 | Flutter/App.framework 19 | Flutter/Flutter.framework 20 | Flutter/Flutter.podspec 21 | Flutter/Generated.xcconfig 22 | Flutter/ephemeral/ 23 | Flutter/app.flx 24 | Flutter/app.zip 25 | Flutter/flutter_assets/ 26 | Flutter/flutter_export_environment.sh 27 | ServiceDefinitions.json 28 | Runner/GeneratedPluginRegistrant.* 29 | 30 | # Exceptions to above rules. 31 | !default.mode1v3 32 | !default.mode2v3 33 | !default.pbxuser 34 | !default.perspectivev3 35 | -------------------------------------------------------------------------------- /example/ios/Flutter/AppFrameworkInfo.plist: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | CFBundleDevelopmentRegion 6 | en 7 | CFBundleExecutable 8 | App 9 | CFBundleIdentifier 10 | io.flutter.flutter.app 11 | CFBundleInfoDictionaryVersion 12 | 6.0 13 | CFBundleName 14 | App 15 | CFBundlePackageType 16 | FMWK 17 | CFBundleShortVersionString 18 | 1.0 19 | CFBundleSignature 20 | ???? 21 | CFBundleVersion 22 | 1.0 23 | MinimumOSVersion 24 | 12.0 25 | 26 | 27 | -------------------------------------------------------------------------------- /example/ios/Flutter/Debug.xcconfig: -------------------------------------------------------------------------------- 1 | #include "Generated.xcconfig" 2 | -------------------------------------------------------------------------------- /example/ios/Flutter/Release.xcconfig: -------------------------------------------------------------------------------- 1 | #include "Generated.xcconfig" 2 | -------------------------------------------------------------------------------- /example/ios/Runner.xcodeproj/project.xcworkspace/contents.xcworkspacedata: -------------------------------------------------------------------------------- 1 | 2 | 4 | 6 | 7 | 8 | -------------------------------------------------------------------------------- /example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | IDEDidComputeMac32BitWarning 6 | 7 | 8 | 9 | -------------------------------------------------------------------------------- /example/ios/Runner.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | PreviewsEnabled 6 | 7 | 8 | 9 | -------------------------------------------------------------------------------- /example/ios/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme: -------------------------------------------------------------------------------- 1 | 2 | 5 | 8 | 9 | 15 | 21 | 22 | 23 | 24 | 25 | 30 | 31 | 37 | 38 | 39 | 40 | 43 | 49 | 50 | 51 | 52 | 53 | 63 | 65 | 71 | 72 | 73 | 74 | 80 | 82 | 88 | 89 | 90 | 91 | 93 | 94 | 97 | 98 | 99 | -------------------------------------------------------------------------------- /example/ios/Runner.xcworkspace/contents.xcworkspacedata: -------------------------------------------------------------------------------- 1 | 2 | 4 | 6 | 7 | 8 | -------------------------------------------------------------------------------- /example/ios/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | IDEDidComputeMac32BitWarning 6 | 7 | 8 | 9 | -------------------------------------------------------------------------------- /example/ios/Runner.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | PreviewsEnabled 6 | 7 | 8 | 9 | -------------------------------------------------------------------------------- /example/ios/Runner/AppDelegate.swift: -------------------------------------------------------------------------------- 1 | import Flutter 2 | import UIKit 3 | 4 | @main 5 | @objc class AppDelegate: FlutterAppDelegate { 6 | override func application( 7 | _ application: UIApplication, 8 | didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]? 9 | ) -> Bool { 10 | GeneratedPluginRegistrant.register(with: self) 11 | return super.application(application, didFinishLaunchingWithOptions: launchOptions) 12 | } 13 | } 14 | -------------------------------------------------------------------------------- /example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json: -------------------------------------------------------------------------------- 1 | { 2 | "images" : [ 3 | { 4 | "size" : "20x20", 5 | "idiom" : "iphone", 6 | "filename" : "Icon-App-20x20@2x.png", 7 | "scale" : "2x" 8 | }, 9 | { 10 | "size" : "20x20", 11 | "idiom" : "iphone", 12 | "filename" : "Icon-App-20x20@3x.png", 13 | "scale" : "3x" 14 | }, 15 | { 16 | "size" : "29x29", 17 | "idiom" : "iphone", 18 | "filename" : "Icon-App-29x29@1x.png", 19 | "scale" : "1x" 20 | }, 21 | { 22 | "size" : "29x29", 23 | "idiom" : "iphone", 24 | "filename" : "Icon-App-29x29@2x.png", 25 | "scale" : "2x" 26 | }, 27 | { 28 | "size" : "29x29", 29 | "idiom" : "iphone", 30 | "filename" : "Icon-App-29x29@3x.png", 31 | "scale" : "3x" 32 | }, 33 | { 34 | "size" : "40x40", 35 | "idiom" : "iphone", 36 | "filename" : "Icon-App-40x40@2x.png", 37 | "scale" : "2x" 38 | }, 39 | { 40 | "size" : "40x40", 41 | "idiom" : "iphone", 42 | "filename" : "Icon-App-40x40@3x.png", 43 | "scale" : "3x" 44 | }, 45 | { 46 | "size" : "60x60", 47 | "idiom" : "iphone", 48 | "filename" : "Icon-App-60x60@2x.png", 49 | "scale" : "2x" 50 | }, 51 | { 52 | "size" : "60x60", 53 | "idiom" : "iphone", 54 | "filename" : "Icon-App-60x60@3x.png", 55 | "scale" : "3x" 56 | }, 57 | { 58 | "size" : "20x20", 59 | "idiom" : "ipad", 60 | "filename" : "Icon-App-20x20@1x.png", 61 | "scale" : "1x" 62 | }, 63 | { 64 | "size" : "20x20", 65 | "idiom" : "ipad", 66 | "filename" : "Icon-App-20x20@2x.png", 67 | "scale" : "2x" 68 | }, 69 | { 70 | "size" : "29x29", 71 | "idiom" : "ipad", 72 | "filename" : "Icon-App-29x29@1x.png", 73 | "scale" : "1x" 74 | }, 75 | { 76 | "size" : "29x29", 77 | "idiom" : "ipad", 78 | "filename" : "Icon-App-29x29@2x.png", 79 | "scale" : "2x" 80 | }, 81 | { 82 | "size" : "40x40", 83 | "idiom" : "ipad", 84 | "filename" : "Icon-App-40x40@1x.png", 85 | "scale" : "1x" 86 | }, 87 | { 88 | "size" : "40x40", 89 | "idiom" : "ipad", 90 | "filename" : "Icon-App-40x40@2x.png", 91 | "scale" : "2x" 92 | }, 93 | { 94 | "size" : "76x76", 95 | "idiom" : "ipad", 96 | "filename" : "Icon-App-76x76@1x.png", 97 | "scale" : "1x" 98 | }, 99 | { 100 | "size" : "76x76", 101 | "idiom" : "ipad", 102 | "filename" : "Icon-App-76x76@2x.png", 103 | "scale" : "2x" 104 | }, 105 | { 106 | "size" : "83.5x83.5", 107 | "idiom" : "ipad", 108 | "filename" : "Icon-App-83.5x83.5@2x.png", 109 | "scale" : "2x" 110 | }, 111 | { 112 | "size" : "1024x1024", 113 | "idiom" : "ios-marketing", 114 | "filename" : "Icon-App-1024x1024@1x.png", 115 | "scale" : "1x" 116 | } 117 | ], 118 | "info" : { 119 | "version" : 1, 120 | "author" : "xcode" 121 | } 122 | } 123 | -------------------------------------------------------------------------------- /example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-1024x1024@1x.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-1024x1024@1x.png -------------------------------------------------------------------------------- /example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@1x.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@1x.png -------------------------------------------------------------------------------- /example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@2x.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@2x.png -------------------------------------------------------------------------------- /example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@3x.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-20x20@3x.png -------------------------------------------------------------------------------- /example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@1x.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@1x.png -------------------------------------------------------------------------------- /example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@2x.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@2x.png -------------------------------------------------------------------------------- /example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@3x.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-29x29@3x.png -------------------------------------------------------------------------------- /example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@1x.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@1x.png -------------------------------------------------------------------------------- /example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@2x.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@2x.png -------------------------------------------------------------------------------- /example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@3x.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-40x40@3x.png -------------------------------------------------------------------------------- /example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@2x.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@2x.png -------------------------------------------------------------------------------- /example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@3x.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-60x60@3x.png -------------------------------------------------------------------------------- /example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@1x.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@1x.png -------------------------------------------------------------------------------- /example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@2x.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-76x76@2x.png -------------------------------------------------------------------------------- /example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-83.5x83.5@2x.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/ios/Runner/Assets.xcassets/AppIcon.appiconset/Icon-App-83.5x83.5@2x.png -------------------------------------------------------------------------------- /example/ios/Runner/Assets.xcassets/LaunchImage.imageset/Contents.json: -------------------------------------------------------------------------------- 1 | { 2 | "images" : [ 3 | { 4 | "idiom" : "universal", 5 | "filename" : "LaunchImage.png", 6 | "scale" : "1x" 7 | }, 8 | { 9 | "idiom" : "universal", 10 | "filename" : "LaunchImage@2x.png", 11 | "scale" : "2x" 12 | }, 13 | { 14 | "idiom" : "universal", 15 | "filename" : "LaunchImage@3x.png", 16 | "scale" : "3x" 17 | } 18 | ], 19 | "info" : { 20 | "version" : 1, 21 | "author" : "xcode" 22 | } 23 | } 24 | -------------------------------------------------------------------------------- /example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage.png -------------------------------------------------------------------------------- /example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@2x.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@2x.png -------------------------------------------------------------------------------- /example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@3x.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/ios/Runner/Assets.xcassets/LaunchImage.imageset/LaunchImage@3x.png -------------------------------------------------------------------------------- /example/ios/Runner/Assets.xcassets/LaunchImage.imageset/README.md: -------------------------------------------------------------------------------- 1 | # Launch Screen Assets 2 | 3 | You can customize the launch screen with your own desired assets by replacing the image files in this directory. 4 | 5 | You can also do it by opening your Flutter project's Xcode project with `open ios/Runner.xcworkspace`, selecting `Runner/Assets.xcassets` in the Project Navigator and dropping in the desired images. -------------------------------------------------------------------------------- /example/ios/Runner/Base.lproj/LaunchScreen.storyboard: -------------------------------------------------------------------------------- 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 | -------------------------------------------------------------------------------- /example/ios/Runner/Base.lproj/Main.storyboard: -------------------------------------------------------------------------------- 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 | -------------------------------------------------------------------------------- /example/ios/Runner/Info.plist: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | CFBundleDevelopmentRegion 6 | $(DEVELOPMENT_LANGUAGE) 7 | CFBundleDisplayName 8 | Example 9 | CFBundleExecutable 10 | $(EXECUTABLE_NAME) 11 | CFBundleIdentifier 12 | $(PRODUCT_BUNDLE_IDENTIFIER) 13 | CFBundleInfoDictionaryVersion 14 | 6.0 15 | CFBundleName 16 | example 17 | CFBundlePackageType 18 | APPL 19 | CFBundleShortVersionString 20 | $(FLUTTER_BUILD_NAME) 21 | CFBundleSignature 22 | ???? 23 | CFBundleVersion 24 | $(FLUTTER_BUILD_NUMBER) 25 | LSRequiresIPhoneOS 26 | 27 | UILaunchStoryboardName 28 | LaunchScreen 29 | UIMainStoryboardFile 30 | Main 31 | UISupportedInterfaceOrientations 32 | 33 | UIInterfaceOrientationPortrait 34 | UIInterfaceOrientationLandscapeLeft 35 | UIInterfaceOrientationLandscapeRight 36 | 37 | UISupportedInterfaceOrientations~ipad 38 | 39 | UIInterfaceOrientationPortrait 40 | UIInterfaceOrientationPortraitUpsideDown 41 | UIInterfaceOrientationLandscapeLeft 42 | UIInterfaceOrientationLandscapeRight 43 | 44 | CADisableMinimumFrameDurationOnPhone 45 | 46 | UIApplicationSupportsIndirectInputEvents 47 | 48 | 49 | 50 | -------------------------------------------------------------------------------- /example/ios/Runner/Runner-Bridging-Header.h: -------------------------------------------------------------------------------- 1 | #import "GeneratedPluginRegistrant.h" 2 | -------------------------------------------------------------------------------- /example/ios/RunnerTests/RunnerTests.swift: -------------------------------------------------------------------------------- 1 | import Flutter 2 | import UIKit 3 | import XCTest 4 | 5 | class RunnerTests: XCTestCase { 6 | 7 | func testExample() { 8 | // If you add code to the Runner application, consider adding tests here. 9 | // See https://developer.apple.com/documentation/xctest for more information about using XCTest. 10 | } 11 | 12 | } 13 | -------------------------------------------------------------------------------- /example/lib/main.dart: -------------------------------------------------------------------------------- 1 | import 'package:docking/docking.dart'; 2 | import 'package:flutter/material.dart'; 3 | 4 | void main() { 5 | runApp(const DockingExampleApp()); 6 | } 7 | 8 | class DockingExampleApp extends StatelessWidget { 9 | const DockingExampleApp({Key? key}) : super(key: key); 10 | 11 | @override 12 | Widget build(BuildContext context) { 13 | return MaterialApp( 14 | debugShowCheckedModeBanner: false, 15 | title: 'Docking example', 16 | theme: ThemeData( 17 | primarySwatch: Colors.blue, 18 | ), 19 | home: const DockingExamplePage(), 20 | ); 21 | } 22 | } 23 | 24 | class DockingExamplePage extends StatefulWidget { 25 | const DockingExamplePage({Key? key}) : super(key: key); 26 | 27 | @override 28 | DockingExamplePageState createState() => DockingExamplePageState(); 29 | } 30 | 31 | class DockingExamplePageState extends State { 32 | late DockingLayout _layout; 33 | 34 | @override 35 | void initState() { 36 | super.initState(); 37 | int v = 1; 38 | _layout = DockingLayout( 39 | root: DockingRow([ 40 | _buildItem(v++, weight: .2), 41 | DockingColumn([ 42 | DockingRow([_nonMaximizableItem, _nonClosableItem, _minimalSizeItem]), 43 | DockingTabs([_buildItem(v++), _buildItem(v++)]), 44 | _minimalWeightItem 45 | ]) 46 | ])); 47 | } 48 | 49 | DockingItem get _minimalWeightItem => DockingItem( 50 | name: 'minimalSize', 51 | minimalWeight: .15, 52 | widget: const CenterText(text: 'minimalWeight: .15')); 53 | 54 | DockingItem get _minimalSizeItem => DockingItem( 55 | name: 'minimalSize', 56 | minimalSize: 150, 57 | widget: const CenterText(text: 'minimalSize: 150')); 58 | 59 | DockingItem get _nonMaximizableItem => DockingItem( 60 | name: 'non-maximizable', 61 | maximizable: false, 62 | widget: const CenterText(text: 'non-maximizable')); 63 | 64 | DockingItem get _nonClosableItem => DockingItem( 65 | name: 'non-closable', 66 | closable: false, 67 | widget: const CenterText(text: 'non-closable')); 68 | 69 | DockingItem _buildItem(int value, 70 | {double? weight, bool closable = true, bool? maximizable}) { 71 | return DockingItem( 72 | weight: weight, 73 | name: value.toString(), 74 | closable: closable, 75 | maximizable: maximizable, 76 | widget: Center(child: Text('$value'))); 77 | } 78 | 79 | @override 80 | Widget build(BuildContext context) { 81 | return Scaffold( 82 | body: TabbedViewTheme( 83 | data: TabbedViewThemeData.classic(), 84 | child: Container( 85 | padding: const EdgeInsets.all(16), 86 | child: Docking(layout: _layout)))); 87 | } 88 | } 89 | 90 | class CenterText extends StatelessWidget { 91 | const CenterText({Key? key, required this.text}) : super(key: key); 92 | 93 | final String text; 94 | 95 | @override 96 | Widget build(BuildContext context) { 97 | return Center(child: Text(text, overflow: TextOverflow.ellipsis)); 98 | } 99 | } 100 | -------------------------------------------------------------------------------- /example/linux/.gitignore: -------------------------------------------------------------------------------- 1 | flutter/ephemeral 2 | -------------------------------------------------------------------------------- /example/linux/CMakeLists.txt: -------------------------------------------------------------------------------- 1 | # Project-level configuration. 2 | cmake_minimum_required(VERSION 3.10) 3 | project(runner LANGUAGES CXX) 4 | 5 | # The name of the executable created for the application. Change this to change 6 | # the on-disk name of your application. 7 | set(BINARY_NAME "example") 8 | # The unique GTK application identifier for this application. See: 9 | # https://wiki.gnome.org/HowDoI/ChooseApplicationID 10 | set(APPLICATION_ID "com.example.example") 11 | 12 | # Explicitly opt in to modern CMake behaviors to avoid warnings with recent 13 | # versions of CMake. 14 | cmake_policy(SET CMP0063 NEW) 15 | 16 | # Load bundled libraries from the lib/ directory relative to the binary. 17 | set(CMAKE_INSTALL_RPATH "$ORIGIN/lib") 18 | 19 | # Root filesystem for cross-building. 20 | if(FLUTTER_TARGET_PLATFORM_SYSROOT) 21 | set(CMAKE_SYSROOT ${FLUTTER_TARGET_PLATFORM_SYSROOT}) 22 | set(CMAKE_FIND_ROOT_PATH ${CMAKE_SYSROOT}) 23 | set(CMAKE_FIND_ROOT_PATH_MODE_PROGRAM NEVER) 24 | set(CMAKE_FIND_ROOT_PATH_MODE_PACKAGE ONLY) 25 | set(CMAKE_FIND_ROOT_PATH_MODE_LIBRARY ONLY) 26 | set(CMAKE_FIND_ROOT_PATH_MODE_INCLUDE ONLY) 27 | endif() 28 | 29 | # Define build configuration options. 30 | if(NOT CMAKE_BUILD_TYPE AND NOT CMAKE_CONFIGURATION_TYPES) 31 | set(CMAKE_BUILD_TYPE "Debug" CACHE 32 | STRING "Flutter build mode" FORCE) 33 | set_property(CACHE CMAKE_BUILD_TYPE PROPERTY STRINGS 34 | "Debug" "Profile" "Release") 35 | endif() 36 | 37 | # Compilation settings that should be applied to most targets. 38 | # 39 | # Be cautious about adding new options here, as plugins use this function by 40 | # default. In most cases, you should add new options to specific targets instead 41 | # of modifying this function. 42 | function(APPLY_STANDARD_SETTINGS TARGET) 43 | target_compile_features(${TARGET} PUBLIC cxx_std_14) 44 | target_compile_options(${TARGET} PRIVATE -Wall -Werror) 45 | target_compile_options(${TARGET} PRIVATE "$<$>:-O3>") 46 | target_compile_definitions(${TARGET} PRIVATE "$<$>:NDEBUG>") 47 | endfunction() 48 | 49 | # Flutter library and tool build rules. 50 | set(FLUTTER_MANAGED_DIR "${CMAKE_CURRENT_SOURCE_DIR}/flutter") 51 | add_subdirectory(${FLUTTER_MANAGED_DIR}) 52 | 53 | # System-level dependencies. 54 | find_package(PkgConfig REQUIRED) 55 | pkg_check_modules(GTK REQUIRED IMPORTED_TARGET gtk+-3.0) 56 | 57 | add_definitions(-DAPPLICATION_ID="${APPLICATION_ID}") 58 | 59 | # Define the application target. To change its name, change BINARY_NAME above, 60 | # not the value here, or `flutter run` will no longer work. 61 | # 62 | # Any new source files that you add to the application should be added here. 63 | add_executable(${BINARY_NAME} 64 | "main.cc" 65 | "my_application.cc" 66 | "${FLUTTER_MANAGED_DIR}/generated_plugin_registrant.cc" 67 | ) 68 | 69 | # Apply the standard set of build settings. This can be removed for applications 70 | # that need different build settings. 71 | apply_standard_settings(${BINARY_NAME}) 72 | 73 | # Add dependency libraries. Add any application-specific dependencies here. 74 | target_link_libraries(${BINARY_NAME} PRIVATE flutter) 75 | target_link_libraries(${BINARY_NAME} PRIVATE PkgConfig::GTK) 76 | 77 | # Run the Flutter tool portions of the build. This must not be removed. 78 | add_dependencies(${BINARY_NAME} flutter_assemble) 79 | 80 | # Only the install-generated bundle's copy of the executable will launch 81 | # correctly, since the resources must in the right relative locations. To avoid 82 | # people trying to run the unbundled copy, put it in a subdirectory instead of 83 | # the default top-level location. 84 | set_target_properties(${BINARY_NAME} 85 | PROPERTIES 86 | RUNTIME_OUTPUT_DIRECTORY "${CMAKE_BINARY_DIR}/intermediates_do_not_run" 87 | ) 88 | 89 | # Generated plugin build rules, which manage building the plugins and adding 90 | # them to the application. 91 | include(flutter/generated_plugins.cmake) 92 | 93 | 94 | # === Installation === 95 | # By default, "installing" just makes a relocatable bundle in the build 96 | # directory. 97 | set(BUILD_BUNDLE_DIR "${PROJECT_BINARY_DIR}/bundle") 98 | if(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT) 99 | set(CMAKE_INSTALL_PREFIX "${BUILD_BUNDLE_DIR}" CACHE PATH "..." FORCE) 100 | endif() 101 | 102 | # Start with a clean build bundle directory every time. 103 | install(CODE " 104 | file(REMOVE_RECURSE \"${BUILD_BUNDLE_DIR}/\") 105 | " COMPONENT Runtime) 106 | 107 | set(INSTALL_BUNDLE_DATA_DIR "${CMAKE_INSTALL_PREFIX}/data") 108 | set(INSTALL_BUNDLE_LIB_DIR "${CMAKE_INSTALL_PREFIX}/lib") 109 | 110 | install(TARGETS ${BINARY_NAME} RUNTIME DESTINATION "${CMAKE_INSTALL_PREFIX}" 111 | COMPONENT Runtime) 112 | 113 | install(FILES "${FLUTTER_ICU_DATA_FILE}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" 114 | COMPONENT Runtime) 115 | 116 | install(FILES "${FLUTTER_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}" 117 | COMPONENT Runtime) 118 | 119 | foreach(bundled_library ${PLUGIN_BUNDLED_LIBRARIES}) 120 | install(FILES "${bundled_library}" 121 | DESTINATION "${INSTALL_BUNDLE_LIB_DIR}" 122 | COMPONENT Runtime) 123 | endforeach(bundled_library) 124 | 125 | # Fully re-copy the assets directory on each build to avoid having stale files 126 | # from a previous install. 127 | set(FLUTTER_ASSET_DIR_NAME "flutter_assets") 128 | install(CODE " 129 | file(REMOVE_RECURSE \"${INSTALL_BUNDLE_DATA_DIR}/${FLUTTER_ASSET_DIR_NAME}\") 130 | " COMPONENT Runtime) 131 | install(DIRECTORY "${PROJECT_BUILD_DIR}/${FLUTTER_ASSET_DIR_NAME}" 132 | DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" COMPONENT Runtime) 133 | 134 | # Install the AOT library on non-Debug builds only. 135 | if(NOT CMAKE_BUILD_TYPE MATCHES "Debug") 136 | install(FILES "${AOT_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}" 137 | COMPONENT Runtime) 138 | endif() 139 | -------------------------------------------------------------------------------- /example/linux/flutter/CMakeLists.txt: -------------------------------------------------------------------------------- 1 | # This file controls Flutter-level build steps. It should not be edited. 2 | cmake_minimum_required(VERSION 3.10) 3 | 4 | set(EPHEMERAL_DIR "${CMAKE_CURRENT_SOURCE_DIR}/ephemeral") 5 | 6 | # Configuration provided via flutter tool. 7 | include(${EPHEMERAL_DIR}/generated_config.cmake) 8 | 9 | # TODO: Move the rest of this into files in ephemeral. See 10 | # https://github.com/flutter/flutter/issues/57146. 11 | 12 | # Serves the same purpose as list(TRANSFORM ... PREPEND ...), 13 | # which isn't available in 3.10. 14 | function(list_prepend LIST_NAME PREFIX) 15 | set(NEW_LIST "") 16 | foreach(element ${${LIST_NAME}}) 17 | list(APPEND NEW_LIST "${PREFIX}${element}") 18 | endforeach(element) 19 | set(${LIST_NAME} "${NEW_LIST}" PARENT_SCOPE) 20 | endfunction() 21 | 22 | # === Flutter Library === 23 | # System-level dependencies. 24 | find_package(PkgConfig REQUIRED) 25 | pkg_check_modules(GTK REQUIRED IMPORTED_TARGET gtk+-3.0) 26 | pkg_check_modules(GLIB REQUIRED IMPORTED_TARGET glib-2.0) 27 | pkg_check_modules(GIO REQUIRED IMPORTED_TARGET gio-2.0) 28 | 29 | set(FLUTTER_LIBRARY "${EPHEMERAL_DIR}/libflutter_linux_gtk.so") 30 | 31 | # Published to parent scope for install step. 32 | set(FLUTTER_LIBRARY ${FLUTTER_LIBRARY} PARENT_SCOPE) 33 | set(FLUTTER_ICU_DATA_FILE "${EPHEMERAL_DIR}/icudtl.dat" PARENT_SCOPE) 34 | set(PROJECT_BUILD_DIR "${PROJECT_DIR}/build/" PARENT_SCOPE) 35 | set(AOT_LIBRARY "${PROJECT_DIR}/build/lib/libapp.so" PARENT_SCOPE) 36 | 37 | list(APPEND FLUTTER_LIBRARY_HEADERS 38 | "fl_basic_message_channel.h" 39 | "fl_binary_codec.h" 40 | "fl_binary_messenger.h" 41 | "fl_dart_project.h" 42 | "fl_engine.h" 43 | "fl_json_message_codec.h" 44 | "fl_json_method_codec.h" 45 | "fl_message_codec.h" 46 | "fl_method_call.h" 47 | "fl_method_channel.h" 48 | "fl_method_codec.h" 49 | "fl_method_response.h" 50 | "fl_plugin_registrar.h" 51 | "fl_plugin_registry.h" 52 | "fl_standard_message_codec.h" 53 | "fl_standard_method_codec.h" 54 | "fl_string_codec.h" 55 | "fl_value.h" 56 | "fl_view.h" 57 | "flutter_linux.h" 58 | ) 59 | list_prepend(FLUTTER_LIBRARY_HEADERS "${EPHEMERAL_DIR}/flutter_linux/") 60 | add_library(flutter INTERFACE) 61 | target_include_directories(flutter INTERFACE 62 | "${EPHEMERAL_DIR}" 63 | ) 64 | target_link_libraries(flutter INTERFACE "${FLUTTER_LIBRARY}") 65 | target_link_libraries(flutter INTERFACE 66 | PkgConfig::GTK 67 | PkgConfig::GLIB 68 | PkgConfig::GIO 69 | ) 70 | add_dependencies(flutter flutter_assemble) 71 | 72 | # === Flutter tool backend === 73 | # _phony_ is a non-existent file to force this command to run every time, 74 | # since currently there's no way to get a full input/output list from the 75 | # flutter tool. 76 | add_custom_command( 77 | OUTPUT ${FLUTTER_LIBRARY} ${FLUTTER_LIBRARY_HEADERS} 78 | ${CMAKE_CURRENT_BINARY_DIR}/_phony_ 79 | COMMAND ${CMAKE_COMMAND} -E env 80 | ${FLUTTER_TOOL_ENVIRONMENT} 81 | "${FLUTTER_ROOT}/packages/flutter_tools/bin/tool_backend.sh" 82 | ${FLUTTER_TARGET_PLATFORM} ${CMAKE_BUILD_TYPE} 83 | VERBATIM 84 | ) 85 | add_custom_target(flutter_assemble DEPENDS 86 | "${FLUTTER_LIBRARY}" 87 | ${FLUTTER_LIBRARY_HEADERS} 88 | ) 89 | -------------------------------------------------------------------------------- /example/linux/flutter/generated_plugin_registrant.cc: -------------------------------------------------------------------------------- 1 | // 2 | // Generated file. Do not edit. 3 | // 4 | 5 | // clang-format off 6 | 7 | #include "generated_plugin_registrant.h" 8 | 9 | 10 | void fl_register_plugins(FlPluginRegistry* registry) { 11 | } 12 | -------------------------------------------------------------------------------- /example/linux/flutter/generated_plugin_registrant.h: -------------------------------------------------------------------------------- 1 | // 2 | // Generated file. Do not edit. 3 | // 4 | 5 | // clang-format off 6 | 7 | #ifndef GENERATED_PLUGIN_REGISTRANT_ 8 | #define GENERATED_PLUGIN_REGISTRANT_ 9 | 10 | #include 11 | 12 | // Registers Flutter plugins. 13 | void fl_register_plugins(FlPluginRegistry* registry); 14 | 15 | #endif // GENERATED_PLUGIN_REGISTRANT_ 16 | -------------------------------------------------------------------------------- /example/linux/flutter/generated_plugins.cmake: -------------------------------------------------------------------------------- 1 | # 2 | # Generated file, do not edit. 3 | # 4 | 5 | list(APPEND FLUTTER_PLUGIN_LIST 6 | ) 7 | 8 | list(APPEND FLUTTER_FFI_PLUGIN_LIST 9 | ) 10 | 11 | set(PLUGIN_BUNDLED_LIBRARIES) 12 | 13 | foreach(plugin ${FLUTTER_PLUGIN_LIST}) 14 | add_subdirectory(flutter/ephemeral/.plugin_symlinks/${plugin}/linux plugins/${plugin}) 15 | target_link_libraries(${BINARY_NAME} PRIVATE ${plugin}_plugin) 16 | list(APPEND PLUGIN_BUNDLED_LIBRARIES $) 17 | list(APPEND PLUGIN_BUNDLED_LIBRARIES ${${plugin}_bundled_libraries}) 18 | endforeach(plugin) 19 | 20 | foreach(ffi_plugin ${FLUTTER_FFI_PLUGIN_LIST}) 21 | add_subdirectory(flutter/ephemeral/.plugin_symlinks/${ffi_plugin}/linux plugins/${ffi_plugin}) 22 | list(APPEND PLUGIN_BUNDLED_LIBRARIES ${${ffi_plugin}_bundled_libraries}) 23 | endforeach(ffi_plugin) 24 | -------------------------------------------------------------------------------- /example/linux/main.cc: -------------------------------------------------------------------------------- 1 | #include "my_application.h" 2 | 3 | int main(int argc, char** argv) { 4 | g_autoptr(MyApplication) app = my_application_new(); 5 | return g_application_run(G_APPLICATION(app), argc, argv); 6 | } 7 | -------------------------------------------------------------------------------- /example/linux/my_application.cc: -------------------------------------------------------------------------------- 1 | #include "my_application.h" 2 | 3 | #include 4 | #ifdef GDK_WINDOWING_X11 5 | #include 6 | #endif 7 | 8 | #include "flutter/generated_plugin_registrant.h" 9 | 10 | struct _MyApplication { 11 | GtkApplication parent_instance; 12 | char** dart_entrypoint_arguments; 13 | }; 14 | 15 | G_DEFINE_TYPE(MyApplication, my_application, GTK_TYPE_APPLICATION) 16 | 17 | // Implements GApplication::activate. 18 | static void my_application_activate(GApplication* application) { 19 | MyApplication* self = MY_APPLICATION(application); 20 | GtkWindow* window = 21 | GTK_WINDOW(gtk_application_window_new(GTK_APPLICATION(application))); 22 | 23 | // Use a header bar when running in GNOME as this is the common style used 24 | // by applications and is the setup most users will be using (e.g. Ubuntu 25 | // desktop). 26 | // If running on X and not using GNOME then just use a traditional title bar 27 | // in case the window manager does more exotic layout, e.g. tiling. 28 | // If running on Wayland assume the header bar will work (may need changing 29 | // if future cases occur). 30 | gboolean use_header_bar = TRUE; 31 | #ifdef GDK_WINDOWING_X11 32 | GdkScreen* screen = gtk_window_get_screen(window); 33 | if (GDK_IS_X11_SCREEN(screen)) { 34 | const gchar* wm_name = gdk_x11_screen_get_window_manager_name(screen); 35 | if (g_strcmp0(wm_name, "GNOME Shell") != 0) { 36 | use_header_bar = FALSE; 37 | } 38 | } 39 | #endif 40 | if (use_header_bar) { 41 | GtkHeaderBar* header_bar = GTK_HEADER_BAR(gtk_header_bar_new()); 42 | gtk_widget_show(GTK_WIDGET(header_bar)); 43 | gtk_header_bar_set_title(header_bar, "example"); 44 | gtk_header_bar_set_show_close_button(header_bar, TRUE); 45 | gtk_window_set_titlebar(window, GTK_WIDGET(header_bar)); 46 | } else { 47 | gtk_window_set_title(window, "example"); 48 | } 49 | 50 | gtk_window_set_default_size(window, 1280, 720); 51 | gtk_widget_show(GTK_WIDGET(window)); 52 | 53 | g_autoptr(FlDartProject) project = fl_dart_project_new(); 54 | fl_dart_project_set_dart_entrypoint_arguments(project, self->dart_entrypoint_arguments); 55 | 56 | FlView* view = fl_view_new(project); 57 | gtk_widget_show(GTK_WIDGET(view)); 58 | gtk_container_add(GTK_CONTAINER(window), GTK_WIDGET(view)); 59 | 60 | fl_register_plugins(FL_PLUGIN_REGISTRY(view)); 61 | 62 | gtk_widget_grab_focus(GTK_WIDGET(view)); 63 | } 64 | 65 | // Implements GApplication::local_command_line. 66 | static gboolean my_application_local_command_line(GApplication* application, gchar*** arguments, int* exit_status) { 67 | MyApplication* self = MY_APPLICATION(application); 68 | // Strip out the first argument as it is the binary name. 69 | self->dart_entrypoint_arguments = g_strdupv(*arguments + 1); 70 | 71 | g_autoptr(GError) error = nullptr; 72 | if (!g_application_register(application, nullptr, &error)) { 73 | g_warning("Failed to register: %s", error->message); 74 | *exit_status = 1; 75 | return TRUE; 76 | } 77 | 78 | g_application_activate(application); 79 | *exit_status = 0; 80 | 81 | return TRUE; 82 | } 83 | 84 | // Implements GObject::dispose. 85 | static void my_application_dispose(GObject* object) { 86 | MyApplication* self = MY_APPLICATION(object); 87 | g_clear_pointer(&self->dart_entrypoint_arguments, g_strfreev); 88 | G_OBJECT_CLASS(my_application_parent_class)->dispose(object); 89 | } 90 | 91 | static void my_application_class_init(MyApplicationClass* klass) { 92 | G_APPLICATION_CLASS(klass)->activate = my_application_activate; 93 | G_APPLICATION_CLASS(klass)->local_command_line = my_application_local_command_line; 94 | G_OBJECT_CLASS(klass)->dispose = my_application_dispose; 95 | } 96 | 97 | static void my_application_init(MyApplication* self) {} 98 | 99 | MyApplication* my_application_new() { 100 | return MY_APPLICATION(g_object_new(my_application_get_type(), 101 | "application-id", APPLICATION_ID, 102 | "flags", G_APPLICATION_NON_UNIQUE, 103 | nullptr)); 104 | } 105 | -------------------------------------------------------------------------------- /example/linux/my_application.h: -------------------------------------------------------------------------------- 1 | #ifndef FLUTTER_MY_APPLICATION_H_ 2 | #define FLUTTER_MY_APPLICATION_H_ 3 | 4 | #include 5 | 6 | G_DECLARE_FINAL_TYPE(MyApplication, my_application, MY, APPLICATION, 7 | GtkApplication) 8 | 9 | /** 10 | * my_application_new: 11 | * 12 | * Creates a new Flutter-based application. 13 | * 14 | * Returns: a new #MyApplication. 15 | */ 16 | MyApplication* my_application_new(); 17 | 18 | #endif // FLUTTER_MY_APPLICATION_H_ 19 | -------------------------------------------------------------------------------- /example/macos/.gitignore: -------------------------------------------------------------------------------- 1 | # Flutter-related 2 | **/Flutter/ephemeral/ 3 | **/Pods/ 4 | 5 | # Xcode-related 6 | **/dgph 7 | **/xcuserdata/ 8 | -------------------------------------------------------------------------------- /example/macos/Flutter/Flutter-Debug.xcconfig: -------------------------------------------------------------------------------- 1 | #include "ephemeral/Flutter-Generated.xcconfig" 2 | -------------------------------------------------------------------------------- /example/macos/Flutter/Flutter-Release.xcconfig: -------------------------------------------------------------------------------- 1 | #include "ephemeral/Flutter-Generated.xcconfig" 2 | -------------------------------------------------------------------------------- /example/macos/Flutter/GeneratedPluginRegistrant.swift: -------------------------------------------------------------------------------- 1 | // 2 | // Generated file. Do not edit. 3 | // 4 | 5 | import FlutterMacOS 6 | import Foundation 7 | 8 | 9 | func RegisterGeneratedPlugins(registry: FlutterPluginRegistry) { 10 | } 11 | -------------------------------------------------------------------------------- /example/macos/Runner.xcodeproj/project.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | IDEDidComputeMac32BitWarning 6 | 7 | 8 | 9 | -------------------------------------------------------------------------------- /example/macos/Runner.xcodeproj/xcshareddata/xcschemes/Runner.xcscheme: -------------------------------------------------------------------------------- 1 | 2 | 5 | 8 | 9 | 15 | 21 | 22 | 23 | 24 | 25 | 30 | 31 | 37 | 38 | 39 | 40 | 43 | 49 | 50 | 51 | 52 | 53 | 63 | 65 | 71 | 72 | 73 | 74 | 80 | 82 | 88 | 89 | 90 | 91 | 93 | 94 | 97 | 98 | 99 | -------------------------------------------------------------------------------- /example/macos/Runner.xcworkspace/contents.xcworkspacedata: -------------------------------------------------------------------------------- 1 | 2 | 4 | 6 | 7 | 8 | -------------------------------------------------------------------------------- /example/macos/Runner.xcworkspace/xcshareddata/IDEWorkspaceChecks.plist: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | IDEDidComputeMac32BitWarning 6 | 7 | 8 | 9 | -------------------------------------------------------------------------------- /example/macos/Runner/AppDelegate.swift: -------------------------------------------------------------------------------- 1 | import Cocoa 2 | import FlutterMacOS 3 | 4 | @main 5 | class AppDelegate: FlutterAppDelegate { 6 | override func applicationShouldTerminateAfterLastWindowClosed(_ sender: NSApplication) -> Bool { 7 | return true 8 | } 9 | } 10 | -------------------------------------------------------------------------------- /example/macos/Runner/Assets.xcassets/AppIcon.appiconset/Contents.json: -------------------------------------------------------------------------------- 1 | { 2 | "images" : [ 3 | { 4 | "size" : "16x16", 5 | "idiom" : "mac", 6 | "filename" : "app_icon_16.png", 7 | "scale" : "1x" 8 | }, 9 | { 10 | "size" : "16x16", 11 | "idiom" : "mac", 12 | "filename" : "app_icon_32.png", 13 | "scale" : "2x" 14 | }, 15 | { 16 | "size" : "32x32", 17 | "idiom" : "mac", 18 | "filename" : "app_icon_32.png", 19 | "scale" : "1x" 20 | }, 21 | { 22 | "size" : "32x32", 23 | "idiom" : "mac", 24 | "filename" : "app_icon_64.png", 25 | "scale" : "2x" 26 | }, 27 | { 28 | "size" : "128x128", 29 | "idiom" : "mac", 30 | "filename" : "app_icon_128.png", 31 | "scale" : "1x" 32 | }, 33 | { 34 | "size" : "128x128", 35 | "idiom" : "mac", 36 | "filename" : "app_icon_256.png", 37 | "scale" : "2x" 38 | }, 39 | { 40 | "size" : "256x256", 41 | "idiom" : "mac", 42 | "filename" : "app_icon_256.png", 43 | "scale" : "1x" 44 | }, 45 | { 46 | "size" : "256x256", 47 | "idiom" : "mac", 48 | "filename" : "app_icon_512.png", 49 | "scale" : "2x" 50 | }, 51 | { 52 | "size" : "512x512", 53 | "idiom" : "mac", 54 | "filename" : "app_icon_512.png", 55 | "scale" : "1x" 56 | }, 57 | { 58 | "size" : "512x512", 59 | "idiom" : "mac", 60 | "filename" : "app_icon_1024.png", 61 | "scale" : "2x" 62 | } 63 | ], 64 | "info" : { 65 | "version" : 1, 66 | "author" : "xcode" 67 | } 68 | } 69 | -------------------------------------------------------------------------------- /example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_1024.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_1024.png -------------------------------------------------------------------------------- /example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_128.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_128.png -------------------------------------------------------------------------------- /example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_16.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_16.png -------------------------------------------------------------------------------- /example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_256.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_256.png -------------------------------------------------------------------------------- /example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_32.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_32.png -------------------------------------------------------------------------------- /example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_512.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_512.png -------------------------------------------------------------------------------- /example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_64.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/macos/Runner/Assets.xcassets/AppIcon.appiconset/app_icon_64.png -------------------------------------------------------------------------------- /example/macos/Runner/Configs/AppInfo.xcconfig: -------------------------------------------------------------------------------- 1 | // Application-level settings for the Runner target. 2 | // 3 | // This may be replaced with something auto-generated from metadata (e.g., pubspec.yaml) in the 4 | // future. If not, the values below would default to using the project name when this becomes a 5 | // 'flutter create' template. 6 | 7 | // The application's name. By default this is also the title of the Flutter window. 8 | PRODUCT_NAME = example 9 | 10 | // The application's bundle identifier 11 | PRODUCT_BUNDLE_IDENTIFIER = com.example.example 12 | 13 | // The copyright displayed in application information 14 | PRODUCT_COPYRIGHT = Copyright © 2024 com.example. All rights reserved. 15 | -------------------------------------------------------------------------------- /example/macos/Runner/Configs/Debug.xcconfig: -------------------------------------------------------------------------------- 1 | #include "../../Flutter/Flutter-Debug.xcconfig" 2 | #include "Warnings.xcconfig" 3 | -------------------------------------------------------------------------------- /example/macos/Runner/Configs/Release.xcconfig: -------------------------------------------------------------------------------- 1 | #include "../../Flutter/Flutter-Release.xcconfig" 2 | #include "Warnings.xcconfig" 3 | -------------------------------------------------------------------------------- /example/macos/Runner/Configs/Warnings.xcconfig: -------------------------------------------------------------------------------- 1 | WARNING_CFLAGS = -Wall -Wconditional-uninitialized -Wnullable-to-nonnull-conversion -Wmissing-method-return-type -Woverlength-strings 2 | GCC_WARN_UNDECLARED_SELECTOR = YES 3 | CLANG_UNDEFINED_BEHAVIOR_SANITIZER_NULLABILITY = YES 4 | CLANG_WARN_UNGUARDED_AVAILABILITY = YES_AGGRESSIVE 5 | CLANG_WARN__DUPLICATE_METHOD_MATCH = YES 6 | CLANG_WARN_PRAGMA_PACK = YES 7 | CLANG_WARN_STRICT_PROTOTYPES = YES 8 | CLANG_WARN_COMMA = YES 9 | GCC_WARN_STRICT_SELECTOR_MATCH = YES 10 | CLANG_WARN_OBJC_REPEATED_USE_OF_WEAK = YES 11 | CLANG_WARN_OBJC_IMPLICIT_RETAIN_SELF = YES 12 | GCC_WARN_SHADOW = YES 13 | CLANG_WARN_UNREACHABLE_CODE = YES 14 | -------------------------------------------------------------------------------- /example/macos/Runner/DebugProfile.entitlements: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | com.apple.security.app-sandbox 6 | 7 | com.apple.security.cs.allow-jit 8 | 9 | com.apple.security.network.server 10 | 11 | 12 | 13 | -------------------------------------------------------------------------------- /example/macos/Runner/Info.plist: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | CFBundleDevelopmentRegion 6 | $(DEVELOPMENT_LANGUAGE) 7 | CFBundleExecutable 8 | $(EXECUTABLE_NAME) 9 | CFBundleIconFile 10 | 11 | CFBundleIdentifier 12 | $(PRODUCT_BUNDLE_IDENTIFIER) 13 | CFBundleInfoDictionaryVersion 14 | 6.0 15 | CFBundleName 16 | $(PRODUCT_NAME) 17 | CFBundlePackageType 18 | APPL 19 | CFBundleShortVersionString 20 | $(FLUTTER_BUILD_NAME) 21 | CFBundleVersion 22 | $(FLUTTER_BUILD_NUMBER) 23 | LSMinimumSystemVersion 24 | $(MACOSX_DEPLOYMENT_TARGET) 25 | NSHumanReadableCopyright 26 | $(PRODUCT_COPYRIGHT) 27 | NSMainNibFile 28 | MainMenu 29 | NSPrincipalClass 30 | NSApplication 31 | 32 | 33 | -------------------------------------------------------------------------------- /example/macos/Runner/MainFlutterWindow.swift: -------------------------------------------------------------------------------- 1 | import Cocoa 2 | import FlutterMacOS 3 | 4 | class MainFlutterWindow: NSWindow { 5 | override func awakeFromNib() { 6 | let flutterViewController = FlutterViewController() 7 | let windowFrame = self.frame 8 | self.contentViewController = flutterViewController 9 | self.setFrame(windowFrame, display: true) 10 | 11 | RegisterGeneratedPlugins(registry: flutterViewController) 12 | 13 | super.awakeFromNib() 14 | } 15 | } 16 | -------------------------------------------------------------------------------- /example/macos/Runner/Release.entitlements: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | com.apple.security.app-sandbox 6 | 7 | 8 | 9 | -------------------------------------------------------------------------------- /example/macos/RunnerTests/RunnerTests.swift: -------------------------------------------------------------------------------- 1 | import Cocoa 2 | import FlutterMacOS 3 | import XCTest 4 | 5 | class RunnerTests: XCTestCase { 6 | 7 | func testExample() { 8 | // If you add code to the Runner application, consider adding tests here. 9 | // See https://developer.apple.com/documentation/xctest for more information about using XCTest. 10 | } 11 | 12 | } 13 | -------------------------------------------------------------------------------- /example/pubspec.yaml: -------------------------------------------------------------------------------- 1 | name: docking_example 2 | description: Docking example. 3 | 4 | # The following line prevents the package from being accidentally published to 5 | # pub.dev using `pub publish`. This is preferred for private packages. 6 | publish_to: 'none' # Remove this line if you wish to publish to pub.dev 7 | 8 | # The following defines the version and build number for your application. 9 | # A version number is three numbers separated by dots, like 1.2.43 10 | # followed by an optional build number separated by a +. 11 | # Both the version and the builder number may be overridden in flutter 12 | # build by specifying --build-name and --build-number, respectively. 13 | # In Android, build-name is used as versionName while build-number used as versionCode. 14 | # Read more about Android versioning at https://developer.android.com/studio/publish/versioning 15 | # In iOS, build-name is used as CFBundleShortVersionString while build-number used as CFBundleVersion. 16 | # Read more about iOS versioning at 17 | # https://developer.apple.com/library/archive/documentation/General/Reference/InfoPlistKeyReference/Articles/CoreFoundationKeys.html 18 | version: 1.0.0+1 19 | 20 | environment: 21 | sdk: ">=2.12.0 <4.0.0" 22 | 23 | dependencies: 24 | flutter: 25 | sdk: flutter 26 | docking: #^1.11.0 27 | path: ../ 28 | #tabbed_view: ^1.16.0 29 | 30 | 31 | dev_dependencies: 32 | flutter_test: 33 | sdk: flutter 34 | 35 | flutter_lints: ^2.0.2 36 | 37 | # For information on the generic Dart part of this file, see the 38 | # following page: https://dart.dev/tools/pub/pubspec 39 | 40 | # The following section is specific to Flutter. 41 | flutter: 42 | 43 | # The following line ensures that the Material Icons font is 44 | # included with your application, so that you can use the icons in 45 | # the material Icons class. 46 | uses-material-design: true 47 | 48 | # To add assets to your application, add an assets section, like this: 49 | # assets: 50 | # - images/a_dot_burr.jpeg 51 | # - images/a_dot_ham.jpeg 52 | 53 | # An image asset can refer to one or more resolution-specific "variants", see 54 | # https://flutter.dev/assets-and-images/#resolution-aware. 55 | 56 | # For details regarding adding assets from package dependencies, see 57 | # https://flutter.dev/assets-and-images/#from-packages 58 | 59 | # To add custom fonts to your application, add a fonts section here, 60 | # in this "flutter" section. Each entry in this list should have a 61 | # "family" key with the font family name, and a "fonts" key with a 62 | # list giving the asset and other descriptors for the font. For 63 | # example: 64 | # fonts: 65 | # - family: Schyler 66 | # fonts: 67 | # - asset: fonts/Schyler-Regular.ttf 68 | # - asset: fonts/Schyler-Italic.ttf 69 | # style: italic 70 | # - family: Trajan Pro 71 | # fonts: 72 | # - asset: fonts/TrajanPro.ttf 73 | # - asset: fonts/TrajanPro_Bold.ttf 74 | # weight: 700 75 | # 76 | # For details regarding fonts from package dependencies, 77 | # see https://flutter.dev/custom-fonts/#from-packages 78 | -------------------------------------------------------------------------------- /example/web/favicon.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/web/favicon.png -------------------------------------------------------------------------------- /example/web/icons/Icon-192.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/web/icons/Icon-192.png -------------------------------------------------------------------------------- /example/web/icons/Icon-512.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/web/icons/Icon-512.png -------------------------------------------------------------------------------- /example/web/icons/Icon-maskable-192.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/web/icons/Icon-maskable-192.png -------------------------------------------------------------------------------- /example/web/icons/Icon-maskable-512.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/web/icons/Icon-maskable-512.png -------------------------------------------------------------------------------- /example/web/index.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 17 | 18 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | example 33 | 34 | 35 | 36 | 37 | 38 | 39 | -------------------------------------------------------------------------------- /example/web/manifest.json: -------------------------------------------------------------------------------- 1 | { 2 | "name": "example", 3 | "short_name": "example", 4 | "start_url": ".", 5 | "display": "standalone", 6 | "background_color": "#0175C2", 7 | "theme_color": "#0175C2", 8 | "description": "A new Flutter project.", 9 | "orientation": "portrait-primary", 10 | "prefer_related_applications": false, 11 | "icons": [ 12 | { 13 | "src": "icons/Icon-192.png", 14 | "sizes": "192x192", 15 | "type": "image/png" 16 | }, 17 | { 18 | "src": "icons/Icon-512.png", 19 | "sizes": "512x512", 20 | "type": "image/png" 21 | }, 22 | { 23 | "src": "icons/Icon-maskable-192.png", 24 | "sizes": "192x192", 25 | "type": "image/png", 26 | "purpose": "maskable" 27 | }, 28 | { 29 | "src": "icons/Icon-maskable-512.png", 30 | "sizes": "512x512", 31 | "type": "image/png", 32 | "purpose": "maskable" 33 | } 34 | ] 35 | } 36 | -------------------------------------------------------------------------------- /example/windows/.gitignore: -------------------------------------------------------------------------------- 1 | flutter/ephemeral/ 2 | 3 | # Visual Studio user-specific files. 4 | *.suo 5 | *.user 6 | *.userosscache 7 | *.sln.docstates 8 | 9 | # Visual Studio build-related files. 10 | x64/ 11 | x86/ 12 | 13 | # Visual Studio cache files 14 | # files ending in .cache can be ignored 15 | *.[Cc]ache 16 | # but keep track of directories ending in .cache 17 | !*.[Cc]ache/ 18 | -------------------------------------------------------------------------------- /example/windows/CMakeLists.txt: -------------------------------------------------------------------------------- 1 | # Project-level configuration. 2 | cmake_minimum_required(VERSION 3.14) 3 | project(example LANGUAGES CXX) 4 | 5 | # The name of the executable created for the application. Change this to change 6 | # the on-disk name of your application. 7 | set(BINARY_NAME "example") 8 | 9 | # Explicitly opt in to modern CMake behaviors to avoid warnings with recent 10 | # versions of CMake. 11 | cmake_policy(VERSION 3.14...3.25) 12 | 13 | # Define build configuration option. 14 | get_property(IS_MULTICONFIG GLOBAL PROPERTY GENERATOR_IS_MULTI_CONFIG) 15 | if(IS_MULTICONFIG) 16 | set(CMAKE_CONFIGURATION_TYPES "Debug;Profile;Release" 17 | CACHE STRING "" FORCE) 18 | else() 19 | if(NOT CMAKE_BUILD_TYPE AND NOT CMAKE_CONFIGURATION_TYPES) 20 | set(CMAKE_BUILD_TYPE "Debug" CACHE 21 | STRING "Flutter build mode" FORCE) 22 | set_property(CACHE CMAKE_BUILD_TYPE PROPERTY STRINGS 23 | "Debug" "Profile" "Release") 24 | endif() 25 | endif() 26 | # Define settings for the Profile build mode. 27 | set(CMAKE_EXE_LINKER_FLAGS_PROFILE "${CMAKE_EXE_LINKER_FLAGS_RELEASE}") 28 | set(CMAKE_SHARED_LINKER_FLAGS_PROFILE "${CMAKE_SHARED_LINKER_FLAGS_RELEASE}") 29 | set(CMAKE_C_FLAGS_PROFILE "${CMAKE_C_FLAGS_RELEASE}") 30 | set(CMAKE_CXX_FLAGS_PROFILE "${CMAKE_CXX_FLAGS_RELEASE}") 31 | 32 | # Use Unicode for all projects. 33 | add_definitions(-DUNICODE -D_UNICODE) 34 | 35 | # Compilation settings that should be applied to most targets. 36 | # 37 | # Be cautious about adding new options here, as plugins use this function by 38 | # default. In most cases, you should add new options to specific targets instead 39 | # of modifying this function. 40 | function(APPLY_STANDARD_SETTINGS TARGET) 41 | target_compile_features(${TARGET} PUBLIC cxx_std_17) 42 | target_compile_options(${TARGET} PRIVATE /W4 /WX /wd"4100") 43 | target_compile_options(${TARGET} PRIVATE /EHsc) 44 | target_compile_definitions(${TARGET} PRIVATE "_HAS_EXCEPTIONS=0") 45 | target_compile_definitions(${TARGET} PRIVATE "$<$:_DEBUG>") 46 | endfunction() 47 | 48 | # Flutter library and tool build rules. 49 | set(FLUTTER_MANAGED_DIR "${CMAKE_CURRENT_SOURCE_DIR}/flutter") 50 | add_subdirectory(${FLUTTER_MANAGED_DIR}) 51 | 52 | # Application build; see runner/CMakeLists.txt. 53 | add_subdirectory("runner") 54 | 55 | 56 | # Generated plugin build rules, which manage building the plugins and adding 57 | # them to the application. 58 | include(flutter/generated_plugins.cmake) 59 | 60 | 61 | # === Installation === 62 | # Support files are copied into place next to the executable, so that it can 63 | # run in place. This is done instead of making a separate bundle (as on Linux) 64 | # so that building and running from within Visual Studio will work. 65 | set(BUILD_BUNDLE_DIR "$") 66 | # Make the "install" step default, as it's required to run. 67 | set(CMAKE_VS_INCLUDE_INSTALL_TO_DEFAULT_BUILD 1) 68 | if(CMAKE_INSTALL_PREFIX_INITIALIZED_TO_DEFAULT) 69 | set(CMAKE_INSTALL_PREFIX "${BUILD_BUNDLE_DIR}" CACHE PATH "..." FORCE) 70 | endif() 71 | 72 | set(INSTALL_BUNDLE_DATA_DIR "${CMAKE_INSTALL_PREFIX}/data") 73 | set(INSTALL_BUNDLE_LIB_DIR "${CMAKE_INSTALL_PREFIX}") 74 | 75 | install(TARGETS ${BINARY_NAME} RUNTIME DESTINATION "${CMAKE_INSTALL_PREFIX}" 76 | COMPONENT Runtime) 77 | 78 | install(FILES "${FLUTTER_ICU_DATA_FILE}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" 79 | COMPONENT Runtime) 80 | 81 | install(FILES "${FLUTTER_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_LIB_DIR}" 82 | COMPONENT Runtime) 83 | 84 | if(PLUGIN_BUNDLED_LIBRARIES) 85 | install(FILES "${PLUGIN_BUNDLED_LIBRARIES}" 86 | DESTINATION "${INSTALL_BUNDLE_LIB_DIR}" 87 | COMPONENT Runtime) 88 | endif() 89 | 90 | # Copy the native assets provided by the build.dart from all packages. 91 | set(NATIVE_ASSETS_DIR "${PROJECT_BUILD_DIR}native_assets/windows/") 92 | install(DIRECTORY "${NATIVE_ASSETS_DIR}" 93 | DESTINATION "${INSTALL_BUNDLE_LIB_DIR}" 94 | COMPONENT Runtime) 95 | 96 | # Fully re-copy the assets directory on each build to avoid having stale files 97 | # from a previous install. 98 | set(FLUTTER_ASSET_DIR_NAME "flutter_assets") 99 | install(CODE " 100 | file(REMOVE_RECURSE \"${INSTALL_BUNDLE_DATA_DIR}/${FLUTTER_ASSET_DIR_NAME}\") 101 | " COMPONENT Runtime) 102 | install(DIRECTORY "${PROJECT_BUILD_DIR}/${FLUTTER_ASSET_DIR_NAME}" 103 | DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" COMPONENT Runtime) 104 | 105 | # Install the AOT library on non-Debug builds only. 106 | install(FILES "${AOT_LIBRARY}" DESTINATION "${INSTALL_BUNDLE_DATA_DIR}" 107 | CONFIGURATIONS Profile;Release 108 | COMPONENT Runtime) 109 | -------------------------------------------------------------------------------- /example/windows/flutter/CMakeLists.txt: -------------------------------------------------------------------------------- 1 | # This file controls Flutter-level build steps. It should not be edited. 2 | cmake_minimum_required(VERSION 3.14) 3 | 4 | set(EPHEMERAL_DIR "${CMAKE_CURRENT_SOURCE_DIR}/ephemeral") 5 | 6 | # Configuration provided via flutter tool. 7 | include(${EPHEMERAL_DIR}/generated_config.cmake) 8 | 9 | # TODO: Move the rest of this into files in ephemeral. See 10 | # https://github.com/flutter/flutter/issues/57146. 11 | set(WRAPPER_ROOT "${EPHEMERAL_DIR}/cpp_client_wrapper") 12 | 13 | # Set fallback configurations for older versions of the flutter tool. 14 | if (NOT DEFINED FLUTTER_TARGET_PLATFORM) 15 | set(FLUTTER_TARGET_PLATFORM "windows-x64") 16 | endif() 17 | 18 | # === Flutter Library === 19 | set(FLUTTER_LIBRARY "${EPHEMERAL_DIR}/flutter_windows.dll") 20 | 21 | # Published to parent scope for install step. 22 | set(FLUTTER_LIBRARY ${FLUTTER_LIBRARY} PARENT_SCOPE) 23 | set(FLUTTER_ICU_DATA_FILE "${EPHEMERAL_DIR}/icudtl.dat" PARENT_SCOPE) 24 | set(PROJECT_BUILD_DIR "${PROJECT_DIR}/build/" PARENT_SCOPE) 25 | set(AOT_LIBRARY "${PROJECT_DIR}/build/windows/app.so" PARENT_SCOPE) 26 | 27 | list(APPEND FLUTTER_LIBRARY_HEADERS 28 | "flutter_export.h" 29 | "flutter_windows.h" 30 | "flutter_messenger.h" 31 | "flutter_plugin_registrar.h" 32 | "flutter_texture_registrar.h" 33 | ) 34 | list(TRANSFORM FLUTTER_LIBRARY_HEADERS PREPEND "${EPHEMERAL_DIR}/") 35 | add_library(flutter INTERFACE) 36 | target_include_directories(flutter INTERFACE 37 | "${EPHEMERAL_DIR}" 38 | ) 39 | target_link_libraries(flutter INTERFACE "${FLUTTER_LIBRARY}.lib") 40 | add_dependencies(flutter flutter_assemble) 41 | 42 | # === Wrapper === 43 | list(APPEND CPP_WRAPPER_SOURCES_CORE 44 | "core_implementations.cc" 45 | "standard_codec.cc" 46 | ) 47 | list(TRANSFORM CPP_WRAPPER_SOURCES_CORE PREPEND "${WRAPPER_ROOT}/") 48 | list(APPEND CPP_WRAPPER_SOURCES_PLUGIN 49 | "plugin_registrar.cc" 50 | ) 51 | list(TRANSFORM CPP_WRAPPER_SOURCES_PLUGIN PREPEND "${WRAPPER_ROOT}/") 52 | list(APPEND CPP_WRAPPER_SOURCES_APP 53 | "flutter_engine.cc" 54 | "flutter_view_controller.cc" 55 | ) 56 | list(TRANSFORM CPP_WRAPPER_SOURCES_APP PREPEND "${WRAPPER_ROOT}/") 57 | 58 | # Wrapper sources needed for a plugin. 59 | add_library(flutter_wrapper_plugin STATIC 60 | ${CPP_WRAPPER_SOURCES_CORE} 61 | ${CPP_WRAPPER_SOURCES_PLUGIN} 62 | ) 63 | apply_standard_settings(flutter_wrapper_plugin) 64 | set_target_properties(flutter_wrapper_plugin PROPERTIES 65 | POSITION_INDEPENDENT_CODE ON) 66 | set_target_properties(flutter_wrapper_plugin PROPERTIES 67 | CXX_VISIBILITY_PRESET hidden) 68 | target_link_libraries(flutter_wrapper_plugin PUBLIC flutter) 69 | target_include_directories(flutter_wrapper_plugin PUBLIC 70 | "${WRAPPER_ROOT}/include" 71 | ) 72 | add_dependencies(flutter_wrapper_plugin flutter_assemble) 73 | 74 | # Wrapper sources needed for the runner. 75 | add_library(flutter_wrapper_app STATIC 76 | ${CPP_WRAPPER_SOURCES_CORE} 77 | ${CPP_WRAPPER_SOURCES_APP} 78 | ) 79 | apply_standard_settings(flutter_wrapper_app) 80 | target_link_libraries(flutter_wrapper_app PUBLIC flutter) 81 | target_include_directories(flutter_wrapper_app PUBLIC 82 | "${WRAPPER_ROOT}/include" 83 | ) 84 | add_dependencies(flutter_wrapper_app flutter_assemble) 85 | 86 | # === Flutter tool backend === 87 | # _phony_ is a non-existent file to force this command to run every time, 88 | # since currently there's no way to get a full input/output list from the 89 | # flutter tool. 90 | set(PHONY_OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/_phony_") 91 | set_source_files_properties("${PHONY_OUTPUT}" PROPERTIES SYMBOLIC TRUE) 92 | add_custom_command( 93 | OUTPUT ${FLUTTER_LIBRARY} ${FLUTTER_LIBRARY_HEADERS} 94 | ${CPP_WRAPPER_SOURCES_CORE} ${CPP_WRAPPER_SOURCES_PLUGIN} 95 | ${CPP_WRAPPER_SOURCES_APP} 96 | ${PHONY_OUTPUT} 97 | COMMAND ${CMAKE_COMMAND} -E env 98 | ${FLUTTER_TOOL_ENVIRONMENT} 99 | "${FLUTTER_ROOT}/packages/flutter_tools/bin/tool_backend.bat" 100 | ${FLUTTER_TARGET_PLATFORM} $ 101 | VERBATIM 102 | ) 103 | add_custom_target(flutter_assemble DEPENDS 104 | "${FLUTTER_LIBRARY}" 105 | ${FLUTTER_LIBRARY_HEADERS} 106 | ${CPP_WRAPPER_SOURCES_CORE} 107 | ${CPP_WRAPPER_SOURCES_PLUGIN} 108 | ${CPP_WRAPPER_SOURCES_APP} 109 | ) 110 | -------------------------------------------------------------------------------- /example/windows/flutter/generated_plugin_registrant.cc: -------------------------------------------------------------------------------- 1 | // 2 | // Generated file. Do not edit. 3 | // 4 | 5 | // clang-format off 6 | 7 | #include "generated_plugin_registrant.h" 8 | 9 | 10 | void RegisterPlugins(flutter::PluginRegistry* registry) { 11 | } 12 | -------------------------------------------------------------------------------- /example/windows/flutter/generated_plugin_registrant.h: -------------------------------------------------------------------------------- 1 | // 2 | // Generated file. Do not edit. 3 | // 4 | 5 | // clang-format off 6 | 7 | #ifndef GENERATED_PLUGIN_REGISTRANT_ 8 | #define GENERATED_PLUGIN_REGISTRANT_ 9 | 10 | #include 11 | 12 | // Registers Flutter plugins. 13 | void RegisterPlugins(flutter::PluginRegistry* registry); 14 | 15 | #endif // GENERATED_PLUGIN_REGISTRANT_ 16 | -------------------------------------------------------------------------------- /example/windows/flutter/generated_plugins.cmake: -------------------------------------------------------------------------------- 1 | # 2 | # Generated file, do not edit. 3 | # 4 | 5 | list(APPEND FLUTTER_PLUGIN_LIST 6 | ) 7 | 8 | list(APPEND FLUTTER_FFI_PLUGIN_LIST 9 | ) 10 | 11 | set(PLUGIN_BUNDLED_LIBRARIES) 12 | 13 | foreach(plugin ${FLUTTER_PLUGIN_LIST}) 14 | add_subdirectory(flutter/ephemeral/.plugin_symlinks/${plugin}/windows plugins/${plugin}) 15 | target_link_libraries(${BINARY_NAME} PRIVATE ${plugin}_plugin) 16 | list(APPEND PLUGIN_BUNDLED_LIBRARIES $) 17 | list(APPEND PLUGIN_BUNDLED_LIBRARIES ${${plugin}_bundled_libraries}) 18 | endforeach(plugin) 19 | 20 | foreach(ffi_plugin ${FLUTTER_FFI_PLUGIN_LIST}) 21 | add_subdirectory(flutter/ephemeral/.plugin_symlinks/${ffi_plugin}/windows plugins/${ffi_plugin}) 22 | list(APPEND PLUGIN_BUNDLED_LIBRARIES ${${ffi_plugin}_bundled_libraries}) 23 | endforeach(ffi_plugin) 24 | -------------------------------------------------------------------------------- /example/windows/runner/CMakeLists.txt: -------------------------------------------------------------------------------- 1 | cmake_minimum_required(VERSION 3.14) 2 | project(runner LANGUAGES CXX) 3 | 4 | # Define the application target. To change its name, change BINARY_NAME in the 5 | # top-level CMakeLists.txt, not the value here, or `flutter run` will no longer 6 | # work. 7 | # 8 | # Any new source files that you add to the application should be added here. 9 | add_executable(${BINARY_NAME} WIN32 10 | "flutter_window.cpp" 11 | "main.cpp" 12 | "utils.cpp" 13 | "win32_window.cpp" 14 | "${FLUTTER_MANAGED_DIR}/generated_plugin_registrant.cc" 15 | "Runner.rc" 16 | "runner.exe.manifest" 17 | ) 18 | 19 | # Apply the standard set of build settings. This can be removed for applications 20 | # that need different build settings. 21 | apply_standard_settings(${BINARY_NAME}) 22 | 23 | # Add preprocessor definitions for the build version. 24 | target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION=\"${FLUTTER_VERSION}\"") 25 | target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_MAJOR=${FLUTTER_VERSION_MAJOR}") 26 | target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_MINOR=${FLUTTER_VERSION_MINOR}") 27 | target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_PATCH=${FLUTTER_VERSION_PATCH}") 28 | target_compile_definitions(${BINARY_NAME} PRIVATE "FLUTTER_VERSION_BUILD=${FLUTTER_VERSION_BUILD}") 29 | 30 | # Disable Windows macros that collide with C++ standard library functions. 31 | target_compile_definitions(${BINARY_NAME} PRIVATE "NOMINMAX") 32 | 33 | # Add dependency libraries and include directories. Add any application-specific 34 | # dependencies here. 35 | target_link_libraries(${BINARY_NAME} PRIVATE flutter flutter_wrapper_app) 36 | target_link_libraries(${BINARY_NAME} PRIVATE "dwmapi.lib") 37 | target_include_directories(${BINARY_NAME} PRIVATE "${CMAKE_SOURCE_DIR}") 38 | 39 | # Run the Flutter tool portions of the build. This must not be removed. 40 | add_dependencies(${BINARY_NAME} flutter_assemble) 41 | -------------------------------------------------------------------------------- /example/windows/runner/Runner.rc: -------------------------------------------------------------------------------- 1 | // Microsoft Visual C++ generated resource script. 2 | // 3 | #pragma code_page(65001) 4 | #include "resource.h" 5 | 6 | #define APSTUDIO_READONLY_SYMBOLS 7 | ///////////////////////////////////////////////////////////////////////////// 8 | // 9 | // Generated from the TEXTINCLUDE 2 resource. 10 | // 11 | #include "winres.h" 12 | 13 | ///////////////////////////////////////////////////////////////////////////// 14 | #undef APSTUDIO_READONLY_SYMBOLS 15 | 16 | ///////////////////////////////////////////////////////////////////////////// 17 | // English (United States) resources 18 | 19 | #if !defined(AFX_RESOURCE_DLL) || defined(AFX_TARG_ENU) 20 | LANGUAGE LANG_ENGLISH, SUBLANG_ENGLISH_US 21 | 22 | #ifdef APSTUDIO_INVOKED 23 | ///////////////////////////////////////////////////////////////////////////// 24 | // 25 | // TEXTINCLUDE 26 | // 27 | 28 | 1 TEXTINCLUDE 29 | BEGIN 30 | "resource.h\0" 31 | END 32 | 33 | 2 TEXTINCLUDE 34 | BEGIN 35 | "#include ""winres.h""\r\n" 36 | "\0" 37 | END 38 | 39 | 3 TEXTINCLUDE 40 | BEGIN 41 | "\r\n" 42 | "\0" 43 | END 44 | 45 | #endif // APSTUDIO_INVOKED 46 | 47 | 48 | ///////////////////////////////////////////////////////////////////////////// 49 | // 50 | // Icon 51 | // 52 | 53 | // Icon with lowest ID value placed first to ensure application icon 54 | // remains consistent on all systems. 55 | IDI_APP_ICON ICON "resources\\app_icon.ico" 56 | 57 | 58 | ///////////////////////////////////////////////////////////////////////////// 59 | // 60 | // Version 61 | // 62 | 63 | #if defined(FLUTTER_VERSION_MAJOR) && defined(FLUTTER_VERSION_MINOR) && defined(FLUTTER_VERSION_PATCH) && defined(FLUTTER_VERSION_BUILD) 64 | #define VERSION_AS_NUMBER FLUTTER_VERSION_MAJOR,FLUTTER_VERSION_MINOR,FLUTTER_VERSION_PATCH,FLUTTER_VERSION_BUILD 65 | #else 66 | #define VERSION_AS_NUMBER 1,0,0,0 67 | #endif 68 | 69 | #if defined(FLUTTER_VERSION) 70 | #define VERSION_AS_STRING FLUTTER_VERSION 71 | #else 72 | #define VERSION_AS_STRING "1.0.0" 73 | #endif 74 | 75 | VS_VERSION_INFO VERSIONINFO 76 | FILEVERSION VERSION_AS_NUMBER 77 | PRODUCTVERSION VERSION_AS_NUMBER 78 | FILEFLAGSMASK VS_FFI_FILEFLAGSMASK 79 | #ifdef _DEBUG 80 | FILEFLAGS VS_FF_DEBUG 81 | #else 82 | FILEFLAGS 0x0L 83 | #endif 84 | FILEOS VOS__WINDOWS32 85 | FILETYPE VFT_APP 86 | FILESUBTYPE 0x0L 87 | BEGIN 88 | BLOCK "StringFileInfo" 89 | BEGIN 90 | BLOCK "040904e4" 91 | BEGIN 92 | VALUE "CompanyName", "com.example" "\0" 93 | VALUE "FileDescription", "example" "\0" 94 | VALUE "FileVersion", VERSION_AS_STRING "\0" 95 | VALUE "InternalName", "example" "\0" 96 | VALUE "LegalCopyright", "Copyright (C) 2024 com.example. All rights reserved." "\0" 97 | VALUE "OriginalFilename", "example.exe" "\0" 98 | VALUE "ProductName", "example" "\0" 99 | VALUE "ProductVersion", VERSION_AS_STRING "\0" 100 | END 101 | END 102 | BLOCK "VarFileInfo" 103 | BEGIN 104 | VALUE "Translation", 0x409, 1252 105 | END 106 | END 107 | 108 | #endif // English (United States) resources 109 | ///////////////////////////////////////////////////////////////////////////// 110 | 111 | 112 | 113 | #ifndef APSTUDIO_INVOKED 114 | ///////////////////////////////////////////////////////////////////////////// 115 | // 116 | // Generated from the TEXTINCLUDE 3 resource. 117 | // 118 | 119 | 120 | ///////////////////////////////////////////////////////////////////////////// 121 | #endif // not APSTUDIO_INVOKED 122 | -------------------------------------------------------------------------------- /example/windows/runner/flutter_window.cpp: -------------------------------------------------------------------------------- 1 | #include "flutter_window.h" 2 | 3 | #include 4 | 5 | #include "flutter/generated_plugin_registrant.h" 6 | 7 | FlutterWindow::FlutterWindow(const flutter::DartProject& project) 8 | : project_(project) {} 9 | 10 | FlutterWindow::~FlutterWindow() {} 11 | 12 | bool FlutterWindow::OnCreate() { 13 | if (!Win32Window::OnCreate()) { 14 | return false; 15 | } 16 | 17 | RECT frame = GetClientArea(); 18 | 19 | // The size here must match the window dimensions to avoid unnecessary surface 20 | // creation / destruction in the startup path. 21 | flutter_controller_ = std::make_unique( 22 | frame.right - frame.left, frame.bottom - frame.top, project_); 23 | // Ensure that basic setup of the controller was successful. 24 | if (!flutter_controller_->engine() || !flutter_controller_->view()) { 25 | return false; 26 | } 27 | RegisterPlugins(flutter_controller_->engine()); 28 | SetChildContent(flutter_controller_->view()->GetNativeWindow()); 29 | 30 | flutter_controller_->engine()->SetNextFrameCallback([&]() { 31 | this->Show(); 32 | }); 33 | 34 | // Flutter can complete the first frame before the "show window" callback is 35 | // registered. The following call ensures a frame is pending to ensure the 36 | // window is shown. It is a no-op if the first frame hasn't completed yet. 37 | flutter_controller_->ForceRedraw(); 38 | 39 | return true; 40 | } 41 | 42 | void FlutterWindow::OnDestroy() { 43 | if (flutter_controller_) { 44 | flutter_controller_ = nullptr; 45 | } 46 | 47 | Win32Window::OnDestroy(); 48 | } 49 | 50 | LRESULT 51 | FlutterWindow::MessageHandler(HWND hwnd, UINT const message, 52 | WPARAM const wparam, 53 | LPARAM const lparam) noexcept { 54 | // Give Flutter, including plugins, an opportunity to handle window messages. 55 | if (flutter_controller_) { 56 | std::optional result = 57 | flutter_controller_->HandleTopLevelWindowProc(hwnd, message, wparam, 58 | lparam); 59 | if (result) { 60 | return *result; 61 | } 62 | } 63 | 64 | switch (message) { 65 | case WM_FONTCHANGE: 66 | flutter_controller_->engine()->ReloadSystemFonts(); 67 | break; 68 | } 69 | 70 | return Win32Window::MessageHandler(hwnd, message, wparam, lparam); 71 | } 72 | -------------------------------------------------------------------------------- /example/windows/runner/flutter_window.h: -------------------------------------------------------------------------------- 1 | #ifndef RUNNER_FLUTTER_WINDOW_H_ 2 | #define RUNNER_FLUTTER_WINDOW_H_ 3 | 4 | #include 5 | #include 6 | 7 | #include 8 | 9 | #include "win32_window.h" 10 | 11 | // A window that does nothing but host a Flutter view. 12 | class FlutterWindow : public Win32Window { 13 | public: 14 | // Creates a new FlutterWindow hosting a Flutter view running |project|. 15 | explicit FlutterWindow(const flutter::DartProject& project); 16 | virtual ~FlutterWindow(); 17 | 18 | protected: 19 | // Win32Window: 20 | bool OnCreate() override; 21 | void OnDestroy() override; 22 | LRESULT MessageHandler(HWND window, UINT const message, WPARAM const wparam, 23 | LPARAM const lparam) noexcept override; 24 | 25 | private: 26 | // The project to run. 27 | flutter::DartProject project_; 28 | 29 | // The Flutter instance hosted by this window. 30 | std::unique_ptr flutter_controller_; 31 | }; 32 | 33 | #endif // RUNNER_FLUTTER_WINDOW_H_ 34 | -------------------------------------------------------------------------------- /example/windows/runner/main.cpp: -------------------------------------------------------------------------------- 1 | #include 2 | #include 3 | #include 4 | 5 | #include "flutter_window.h" 6 | #include "utils.h" 7 | 8 | int APIENTRY wWinMain(_In_ HINSTANCE instance, _In_opt_ HINSTANCE prev, 9 | _In_ wchar_t *command_line, _In_ int show_command) { 10 | // Attach to console when present (e.g., 'flutter run') or create a 11 | // new console when running with a debugger. 12 | if (!::AttachConsole(ATTACH_PARENT_PROCESS) && ::IsDebuggerPresent()) { 13 | CreateAndAttachConsole(); 14 | } 15 | 16 | // Initialize COM, so that it is available for use in the library and/or 17 | // plugins. 18 | ::CoInitializeEx(nullptr, COINIT_APARTMENTTHREADED); 19 | 20 | flutter::DartProject project(L"data"); 21 | 22 | std::vector command_line_arguments = 23 | GetCommandLineArguments(); 24 | 25 | project.set_dart_entrypoint_arguments(std::move(command_line_arguments)); 26 | 27 | FlutterWindow window(project); 28 | Win32Window::Point origin(10, 10); 29 | Win32Window::Size size(1280, 720); 30 | if (!window.Create(L"example", origin, size)) { 31 | return EXIT_FAILURE; 32 | } 33 | window.SetQuitOnClose(true); 34 | 35 | ::MSG msg; 36 | while (::GetMessage(&msg, nullptr, 0, 0)) { 37 | ::TranslateMessage(&msg); 38 | ::DispatchMessage(&msg); 39 | } 40 | 41 | ::CoUninitialize(); 42 | return EXIT_SUCCESS; 43 | } 44 | -------------------------------------------------------------------------------- /example/windows/runner/resource.h: -------------------------------------------------------------------------------- 1 | //{{NO_DEPENDENCIES}} 2 | // Microsoft Visual C++ generated include file. 3 | // Used by Runner.rc 4 | // 5 | #define IDI_APP_ICON 101 6 | 7 | // Next default values for new objects 8 | // 9 | #ifdef APSTUDIO_INVOKED 10 | #ifndef APSTUDIO_READONLY_SYMBOLS 11 | #define _APS_NEXT_RESOURCE_VALUE 102 12 | #define _APS_NEXT_COMMAND_VALUE 40001 13 | #define _APS_NEXT_CONTROL_VALUE 1001 14 | #define _APS_NEXT_SYMED_VALUE 101 15 | #endif 16 | #endif 17 | -------------------------------------------------------------------------------- /example/windows/runner/resources/app_icon.ico: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/caduandrade/docking_flutter/6185ab4334e91ec3a0dc5ba822d2d45a2eec0af6/example/windows/runner/resources/app_icon.ico -------------------------------------------------------------------------------- /example/windows/runner/runner.exe.manifest: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | PerMonitorV2 6 | 7 | 8 | 9 | 10 | 11 | 12 | 13 | 14 | 15 | -------------------------------------------------------------------------------- /example/windows/runner/utils.cpp: -------------------------------------------------------------------------------- 1 | #include "utils.h" 2 | 3 | #include 4 | #include 5 | #include 6 | #include 7 | 8 | #include 9 | 10 | void CreateAndAttachConsole() { 11 | if (::AllocConsole()) { 12 | FILE *unused; 13 | if (freopen_s(&unused, "CONOUT$", "w", stdout)) { 14 | _dup2(_fileno(stdout), 1); 15 | } 16 | if (freopen_s(&unused, "CONOUT$", "w", stderr)) { 17 | _dup2(_fileno(stdout), 2); 18 | } 19 | std::ios::sync_with_stdio(); 20 | FlutterDesktopResyncOutputStreams(); 21 | } 22 | } 23 | 24 | std::vector GetCommandLineArguments() { 25 | // Convert the UTF-16 command line arguments to UTF-8 for the Engine to use. 26 | int argc; 27 | wchar_t** argv = ::CommandLineToArgvW(::GetCommandLineW(), &argc); 28 | if (argv == nullptr) { 29 | return std::vector(); 30 | } 31 | 32 | std::vector command_line_arguments; 33 | 34 | // Skip the first argument as it's the binary name. 35 | for (int i = 1; i < argc; i++) { 36 | command_line_arguments.push_back(Utf8FromUtf16(argv[i])); 37 | } 38 | 39 | ::LocalFree(argv); 40 | 41 | return command_line_arguments; 42 | } 43 | 44 | std::string Utf8FromUtf16(const wchar_t* utf16_string) { 45 | if (utf16_string == nullptr) { 46 | return std::string(); 47 | } 48 | unsigned int target_length = ::WideCharToMultiByte( 49 | CP_UTF8, WC_ERR_INVALID_CHARS, utf16_string, 50 | -1, nullptr, 0, nullptr, nullptr) 51 | -1; // remove the trailing null character 52 | int input_length = (int)wcslen(utf16_string); 53 | std::string utf8_string; 54 | if (target_length == 0 || target_length > utf8_string.max_size()) { 55 | return utf8_string; 56 | } 57 | utf8_string.resize(target_length); 58 | int converted_length = ::WideCharToMultiByte( 59 | CP_UTF8, WC_ERR_INVALID_CHARS, utf16_string, 60 | input_length, utf8_string.data(), target_length, nullptr, nullptr); 61 | if (converted_length == 0) { 62 | return std::string(); 63 | } 64 | return utf8_string; 65 | } 66 | -------------------------------------------------------------------------------- /example/windows/runner/utils.h: -------------------------------------------------------------------------------- 1 | #ifndef RUNNER_UTILS_H_ 2 | #define RUNNER_UTILS_H_ 3 | 4 | #include 5 | #include 6 | 7 | // Creates a console for the process, and redirects stdout and stderr to 8 | // it for both the runner and the Flutter library. 9 | void CreateAndAttachConsole(); 10 | 11 | // Takes a null-terminated wchar_t* encoded in UTF-16 and returns a std::string 12 | // encoded in UTF-8. Returns an empty std::string on failure. 13 | std::string Utf8FromUtf16(const wchar_t* utf16_string); 14 | 15 | // Gets the command line arguments passed in as a std::vector, 16 | // encoded in UTF-8. Returns an empty std::vector on failure. 17 | std::vector GetCommandLineArguments(); 18 | 19 | #endif // RUNNER_UTILS_H_ 20 | -------------------------------------------------------------------------------- /example/windows/runner/win32_window.h: -------------------------------------------------------------------------------- 1 | #ifndef RUNNER_WIN32_WINDOW_H_ 2 | #define RUNNER_WIN32_WINDOW_H_ 3 | 4 | #include 5 | 6 | #include 7 | #include 8 | #include 9 | 10 | // A class abstraction for a high DPI-aware Win32 Window. Intended to be 11 | // inherited from by classes that wish to specialize with custom 12 | // rendering and input handling 13 | class Win32Window { 14 | public: 15 | struct Point { 16 | unsigned int x; 17 | unsigned int y; 18 | Point(unsigned int x, unsigned int y) : x(x), y(y) {} 19 | }; 20 | 21 | struct Size { 22 | unsigned int width; 23 | unsigned int height; 24 | Size(unsigned int width, unsigned int height) 25 | : width(width), height(height) {} 26 | }; 27 | 28 | Win32Window(); 29 | virtual ~Win32Window(); 30 | 31 | // Creates a win32 window with |title| that is positioned and sized using 32 | // |origin| and |size|. New windows are created on the default monitor. Window 33 | // sizes are specified to the OS in physical pixels, hence to ensure a 34 | // consistent size this function will scale the inputted width and height as 35 | // as appropriate for the default monitor. The window is invisible until 36 | // |Show| is called. Returns true if the window was created successfully. 37 | bool Create(const std::wstring& title, const Point& origin, const Size& size); 38 | 39 | // Show the current window. Returns true if the window was successfully shown. 40 | bool Show(); 41 | 42 | // Release OS resources associated with window. 43 | void Destroy(); 44 | 45 | // Inserts |content| into the window tree. 46 | void SetChildContent(HWND content); 47 | 48 | // Returns the backing Window handle to enable clients to set icon and other 49 | // window properties. Returns nullptr if the window has been destroyed. 50 | HWND GetHandle(); 51 | 52 | // If true, closing this window will quit the application. 53 | void SetQuitOnClose(bool quit_on_close); 54 | 55 | // Return a RECT representing the bounds of the current client area. 56 | RECT GetClientArea(); 57 | 58 | protected: 59 | // Processes and route salient window messages for mouse handling, 60 | // size change and DPI. Delegates handling of these to member overloads that 61 | // inheriting classes can handle. 62 | virtual LRESULT MessageHandler(HWND window, 63 | UINT const message, 64 | WPARAM const wparam, 65 | LPARAM const lparam) noexcept; 66 | 67 | // Called when CreateAndShow is called, allowing subclass window-related 68 | // setup. Subclasses should return false if setup fails. 69 | virtual bool OnCreate(); 70 | 71 | // Called when Destroy is called. 72 | virtual void OnDestroy(); 73 | 74 | private: 75 | friend class WindowClassRegistrar; 76 | 77 | // OS callback called by message pump. Handles the WM_NCCREATE message which 78 | // is passed when the non-client area is being created and enables automatic 79 | // non-client DPI scaling so that the non-client area automatically 80 | // responds to changes in DPI. All other messages are handled by 81 | // MessageHandler. 82 | static LRESULT CALLBACK WndProc(HWND const window, 83 | UINT const message, 84 | WPARAM const wparam, 85 | LPARAM const lparam) noexcept; 86 | 87 | // Retrieves a class instance pointer for |window| 88 | static Win32Window* GetThisFromHandle(HWND const window) noexcept; 89 | 90 | // Update the window frame's theme to match the system theme. 91 | static void UpdateTheme(HWND const window); 92 | 93 | bool quit_on_close_ = false; 94 | 95 | // window handle for top level window. 96 | HWND window_handle_ = nullptr; 97 | 98 | // window handle for hosted content. 99 | HWND child_content_ = nullptr; 100 | }; 101 | 102 | #endif // RUNNER_WIN32_WINDOW_H_ 103 | -------------------------------------------------------------------------------- /lib/docking.dart: -------------------------------------------------------------------------------- 1 | library docking; 2 | 3 | export 'src/layout/docking_layout.dart'; 4 | export 'src/layout/docking_area_type.dart'; 5 | export 'src/layout/drop_position.dart'; 6 | export 'src/layout/layout_parser.dart'; 7 | export 'src/layout/area_builder.dart'; 8 | export 'src/on_item_selection.dart'; 9 | export 'src/on_item_close.dart'; 10 | export 'src/docking_buttons_builder.dart'; 11 | export 'src/docking_icons.dart'; 12 | export 'src/docking.dart'; 13 | export 'src/theme/docking_theme.dart'; 14 | export 'src/theme/docking_theme_data.dart'; 15 | export 'package:multi_split_view/multi_split_view.dart'; 16 | export 'package:tabbed_view/tabbed_view.dart'; 17 | -------------------------------------------------------------------------------- /lib/src/docking.dart: -------------------------------------------------------------------------------- 1 | import 'package:docking/src/docking_buttons_builder.dart'; 2 | import 'package:docking/src/drag_over_position.dart'; 3 | import 'package:docking/src/internal/widgets/docking_item_widget.dart'; 4 | import 'package:docking/src/internal/widgets/docking_tabs_widget.dart'; 5 | import 'package:docking/src/layout/docking_layout.dart'; 6 | import 'package:docking/src/on_item_close.dart'; 7 | import 'package:docking/src/on_item_selection.dart'; 8 | import 'package:flutter/material.dart'; 9 | import 'package:flutter/widgets.dart'; 10 | import 'package:multi_split_view/multi_split_view.dart'; 11 | 12 | /// The docking widget. 13 | class Docking extends StatefulWidget { 14 | const Docking( 15 | {Key? key, 16 | this.layout, 17 | this.onItemSelection, 18 | this.onItemClose, 19 | this.itemCloseInterceptor, 20 | this.dockingButtonsBuilder, 21 | this.maximizableItem = true, 22 | this.maximizableTab = true, 23 | this.maximizableTabsArea = true, 24 | this.antiAliasingWorkaround = true, 25 | this.draggable = true}) 26 | : super(key: key); 27 | 28 | final DockingLayout? layout; 29 | final OnItemSelection? onItemSelection; 30 | final OnItemClose? onItemClose; 31 | final ItemCloseInterceptor? itemCloseInterceptor; 32 | final DockingButtonsBuilder? dockingButtonsBuilder; 33 | final bool maximizableItem; 34 | final bool maximizableTab; 35 | final bool maximizableTabsArea; 36 | final bool antiAliasingWorkaround; 37 | final bool draggable; 38 | 39 | @override 40 | State createState() => _DockingState(); 41 | } 42 | 43 | /// The [Docking] state. 44 | class _DockingState extends State { 45 | final DragOverPosition _dragOverPosition = DragOverPosition(); 46 | 47 | @override 48 | void initState() { 49 | super.initState(); 50 | _dragOverPosition.addListener(_forceRebuild); 51 | widget.layout?.addListener(_forceRebuild); 52 | } 53 | 54 | @override 55 | void dispose() { 56 | super.dispose(); 57 | _dragOverPosition.removeListener(_forceRebuild); 58 | widget.layout?.removeListener(_forceRebuild); 59 | } 60 | 61 | @override 62 | void didUpdateWidget(Docking oldWidget) { 63 | super.didUpdateWidget(oldWidget); 64 | if (oldWidget.layout != widget.layout) { 65 | oldWidget.layout?.removeListener(_forceRebuild); 66 | widget.layout?.addListener(_forceRebuild); 67 | } 68 | } 69 | 70 | @override 71 | Widget build(BuildContext context) { 72 | if (widget.layout != null) { 73 | if (widget.layout!.maximizedArea != null) { 74 | List areas = widget.layout!.layoutAreas(); 75 | List children = []; 76 | for (DockingArea area in areas) { 77 | if (area != widget.layout!.maximizedArea!) { 78 | if (area is DockingItem && 79 | area.globalKey != null && 80 | area.parent != widget.layout?.maximizedArea) { 81 | // keeping alive other areas 82 | children.add(ExcludeFocus( 83 | child: Offstage(child: _buildArea(context, area)))); 84 | } 85 | } 86 | } 87 | children.add(_buildArea(context, widget.layout!.maximizedArea!)); 88 | return Stack(children: children); 89 | } 90 | if (widget.layout!.root != null) { 91 | return _buildArea(context, widget.layout!.root!); 92 | } 93 | } 94 | return Container(); 95 | } 96 | 97 | Widget _buildArea(BuildContext context, DockingArea area) { 98 | if (area is DockingItem) { 99 | return DockingItemWidget( 100 | key: area.key, 101 | layout: widget.layout!, 102 | dragOverPosition: _dragOverPosition, 103 | draggable: widget.draggable, 104 | item: area, 105 | onItemSelection: widget.onItemSelection, 106 | itemCloseInterceptor: widget.itemCloseInterceptor, 107 | onItemClose: widget.onItemClose, 108 | dockingButtonsBuilder: widget.dockingButtonsBuilder, 109 | maximizable: widget.maximizableItem); 110 | } else if (area is DockingRow) { 111 | return _row(context, area); 112 | } else if (area is DockingColumn) { 113 | return _column(context, area); 114 | } else if (area is DockingTabs) { 115 | if (area.childrenCount == 1) { 116 | return DockingItemWidget( 117 | key: area.key, 118 | layout: widget.layout!, 119 | dragOverPosition: _dragOverPosition, 120 | draggable: widget.draggable, 121 | item: area.childAt(0), 122 | onItemSelection: widget.onItemSelection, 123 | itemCloseInterceptor: widget.itemCloseInterceptor, 124 | onItemClose: widget.onItemClose, 125 | dockingButtonsBuilder: widget.dockingButtonsBuilder, 126 | maximizable: widget.maximizableItem); 127 | } 128 | return DockingTabsWidget( 129 | key: area.key, 130 | layout: widget.layout!, 131 | dragOverPosition: _dragOverPosition, 132 | draggable: widget.draggable, 133 | dockingTabs: area, 134 | onItemSelection: widget.onItemSelection, 135 | onItemClose: widget.onItemClose, 136 | itemCloseInterceptor: widget.itemCloseInterceptor, 137 | dockingButtonsBuilder: widget.dockingButtonsBuilder, 138 | maximizableTab: widget.maximizableTab, 139 | maximizableTabsArea: widget.maximizableTabsArea); 140 | } 141 | throw UnimplementedError( 142 | 'Unrecognized runtimeType: ' + area.runtimeType.toString()); 143 | } 144 | 145 | Widget _row(BuildContext context, DockingRow row) { 146 | List children = []; 147 | row.forEach((child) { 148 | children.add(_buildArea(context, child)); 149 | }); 150 | 151 | return MultiSplitView( 152 | key: row.key, 153 | children: children, 154 | axis: Axis.horizontal, 155 | controller: row.controller, 156 | antiAliasingWorkaround: widget.antiAliasingWorkaround); 157 | } 158 | 159 | Widget _column(BuildContext context, DockingColumn column) { 160 | List children = []; 161 | column.forEach((child) { 162 | children.add(_buildArea(context, child)); 163 | }); 164 | 165 | return MultiSplitView( 166 | key: column.key, 167 | children: children, 168 | axis: Axis.vertical, 169 | controller: column.controller, 170 | antiAliasingWorkaround: widget.antiAliasingWorkaround); 171 | } 172 | 173 | void _forceRebuild() { 174 | setState(() { 175 | // just rebuild 176 | }); 177 | } 178 | } 179 | -------------------------------------------------------------------------------- /lib/src/docking_buttons_builder.dart: -------------------------------------------------------------------------------- 1 | import 'package:docking/docking.dart'; 2 | import 'package:flutter/widgets.dart'; 3 | 4 | /// Buttons builder for [DockingItem] and [DockingTabs]. 5 | typedef DockingButtonsBuilder = List Function( 6 | BuildContext context, DockingTabs? dockingTabs, DockingItem? dockingItem); 7 | -------------------------------------------------------------------------------- /lib/src/docking_icons.dart: -------------------------------------------------------------------------------- 1 | import 'dart:ui'; 2 | 3 | /// Docking icons 4 | class DockingIcons { 5 | DockingIcons._(); 6 | 7 | static Path restore(Size size) { 8 | Path path = Path(); 9 | path.moveTo(size.width * 0.3000000, size.height * 0.2500000); 10 | path.lineTo(size.width * 0.3000000, size.height * 0.7500000); 11 | path.lineTo(size.width * 0.8000000, size.height * 0.7500000); 12 | path.close(); 13 | return path; 14 | } 15 | } 16 | -------------------------------------------------------------------------------- /lib/src/drag_over_position.dart: -------------------------------------------------------------------------------- 1 | import 'package:flutter/widgets.dart'; 2 | 3 | class DragOverPosition extends ChangeNotifier { 4 | bool _enable = false; 5 | 6 | bool get enable => _enable; 7 | 8 | set enable(bool value) { 9 | _enable = value; 10 | notifyListeners(); 11 | } 12 | } 13 | -------------------------------------------------------------------------------- /lib/src/internal/debug.dart: -------------------------------------------------------------------------------- 1 | import 'package:meta/meta.dart'; 2 | 3 | @internal 4 | class DockingDebug { 5 | static const bool dropAreaVisible = false; 6 | } 7 | -------------------------------------------------------------------------------- /lib/src/internal/docking_provider.dart: -------------------------------------------------------------------------------- 1 | import 'package:docking/src/docking_buttons_builder.dart'; 2 | import 'package:docking/src/layout/docking_layout.dart'; 3 | import 'package:docking/src/on_item_close.dart'; 4 | import 'package:docking/src/on_item_selection.dart'; 5 | 6 | class DockingProvider { 7 | const DockingProvider( 8 | {required this.layout, 9 | required this.onItemSelection, 10 | required this.onItemClose, 11 | required this.itemCloseInterceptor, 12 | required this.dockingButtonsBuilder, 13 | required this.maximizableItem, 14 | required this.maximizableTab, 15 | required this.maximizableTabsArea, 16 | required this.antiAliasingWorkaround}); 17 | 18 | final DockingLayout? layout; 19 | final OnItemSelection? onItemSelection; 20 | final OnItemClose? onItemClose; 21 | final ItemCloseInterceptor? itemCloseInterceptor; 22 | final DockingButtonsBuilder? dockingButtonsBuilder; 23 | final bool maximizableItem; 24 | final bool maximizableTab; 25 | final bool maximizableTabsArea; 26 | final bool antiAliasingWorkaround; 27 | } 28 | -------------------------------------------------------------------------------- /lib/src/internal/layout/add_item.dart: -------------------------------------------------------------------------------- 1 | import 'package:docking/src/internal/layout/drop_item.dart'; 2 | import 'package:docking/src/layout/docking_layout.dart'; 3 | import 'package:docking/src/layout/drop_position.dart'; 4 | import 'package:meta/meta.dart'; 5 | 6 | /// Adds [DockingItem] to the layout. 7 | @internal 8 | class AddItem extends DropItem { 9 | AddItem( 10 | {required DockingItem newItem, 11 | required DropArea targetArea, 12 | DropPosition? dropPosition, 13 | int? dropIndex}) 14 | : super( 15 | dropItem: newItem, 16 | targetArea: targetArea, 17 | dropPosition: dropPosition, 18 | dropIndex: dropIndex); 19 | 20 | @override 21 | void validateDropItem(DockingLayout layout, DockingArea area) { 22 | super.validateDropItem(layout, area); 23 | if (area.layoutId != -1) { 24 | throw ArgumentError('DockingArea already belongs to some layout.'); 25 | } 26 | } 27 | 28 | @override 29 | void validateTargetArea(DockingLayout layout, DockingArea area) { 30 | super.validateTargetArea(layout, area); 31 | if (area.layoutId != layout.id) { 32 | throw ArgumentError( 33 | 'DockingArea belongs to another layout. Keep the layout in the state of your StatefulWidget.'); 34 | } 35 | } 36 | } 37 | -------------------------------------------------------------------------------- /lib/src/internal/layout/layout_modifier.dart: -------------------------------------------------------------------------------- 1 | import 'package:docking/src/layout/docking_layout.dart'; 2 | import 'package:meta/meta.dart'; 3 | 4 | /// Represents a layout modifier. 5 | @internal 6 | abstract class LayoutModifier { 7 | /// Builds a new root given a layout. 8 | DockingArea? newLayout(DockingLayout layout); 9 | 10 | /// Validates a [DockingArea] parameter for this modifier. 11 | void validate(DockingLayout layout, DockingArea area) { 12 | if (area.disposed) { 13 | throw ArgumentError('DockingArea already has been disposed.'); 14 | } 15 | } 16 | } 17 | -------------------------------------------------------------------------------- /lib/src/internal/layout/layout_stringify.dart: -------------------------------------------------------------------------------- 1 | import 'package:docking/src/layout/docking_layout.dart'; 2 | import 'package:docking/src/layout/layout_parser.dart'; 3 | import 'package:meta/meta.dart'; 4 | 5 | @internal 6 | class LayoutStringify { 7 | /// Converts a layout into a String to be stored. 8 | /// 9 | /// The String will have the following structure: 10 | /// VERSION:AREAS_LENGTH:AREAS 11 | /// 12 | /// The VERSION group has a fixed value: V1 13 | /// 14 | /// The AREAS group separates each area with a comma and follows the 15 | /// pattern: AREA_INDEX_1(AREA_CONFIGURATION),...,AREA_INDEX_N(AREA_CONFIGURATION) 16 | /// Example: 1(AREA_CONFIGURATION),2(AREA_CONFIGURATION),3(AREA_CONFIGURATION) 17 | /// 18 | /// The AREA_CONFIGURATION group represents all area data given the class: 19 | /// 20 | /// * [DockingItem] 21 | /// * AREA_ACRONYM 22 | /// * ID_LENGTH 23 | /// * ID 24 | /// * WEIGHT 25 | /// * MAXIMIZED 26 | /// * [DockingColumn] 27 | /// * AREA_ACRONYM 28 | /// * ID_LENGTH 29 | /// * ID 30 | /// * WEIGHT 31 | /// * CHILDREN_INDEXES 32 | /// * [DockingRow] 33 | /// * AREA_ACRONYM 34 | /// * ID_LENGTH 35 | /// * ID 36 | /// * WEIGHT 37 | /// * CHILDREN_INDEXES 38 | /// * [DockingTabs] 39 | /// * AREA_ACRONYM 40 | /// * ID_LENGTH 41 | /// * ID 42 | /// * WEIGHT 43 | /// * MAXIMIZED 44 | /// * CHILDREN_INDEXES 45 | /// 46 | /// Example: 47 | /// V1:3:1(R;0;;;2,3),2(I;6;my_id1;0.5;F),3(I;6;my_id2;0.5;F) 48 | static String stringify( 49 | {required LayoutParser parser, required List areas}) { 50 | String str = 'V1:${areas.length}:'; 51 | for (int i = 0; i < areas.length; i++) { 52 | if (i > 0) { 53 | str += ','; 54 | } 55 | final DockingArea area = areas[i]; 56 | str += '${area.index}('; 57 | str += '${area.areaAcronym};'; 58 | str += '${stringifyArea(parser: parser, area: area)}'; 59 | 60 | if (area is DockingItem) { 61 | str += ';'; 62 | str += stringifyItem(item: area); 63 | } else if (area is DockingTabs) { 64 | str += ';'; 65 | str += stringifyTabs(tabs: area); 66 | } 67 | 68 | if (area is DockingParentArea) { 69 | str += ';'; 70 | str += stringifyParent(parent: area); 71 | } 72 | str += ')'; 73 | } 74 | 75 | return str; 76 | } 77 | 78 | /// Converts the [DockingArea] configuration into a String with the 79 | /// following data separated by semicolons: 80 | /// * ID_LENGTH 81 | /// * ID 82 | /// * WEIGHT 83 | /// 84 | /// Example: 3;id1;.2 85 | static String stringifyArea( 86 | {required LayoutParser parser, required DockingArea area}) { 87 | List data = []; 88 | // ID_LENGTH and ID 89 | final String id = parser.idToString(area.id); 90 | data.add(id.length.toString()); 91 | data.add(id); 92 | // WEIGHT 93 | final String weight = area.weight != null ? area.weight.toString() : ''; 94 | data.add(weight); 95 | 96 | return data.join(';'); 97 | } 98 | 99 | /// Converts the [DockingItem] configuration into a String with the 100 | /// following data: 101 | /// * MAXIMIZED 102 | /// 103 | /// [T] is [TRUE] and [F] is [FALSE]. 104 | /// 105 | /// Example: 106 | /// F 107 | static String stringifyItem({required DockingItem item}) { 108 | return item.maximized ? 'T' : 'F'; 109 | } 110 | 111 | /// Converts the [DockingTabs] configuration into a String with the 112 | /// following data: 113 | /// * MAXIMIZED 114 | /// 115 | /// Example: 116 | /// T 117 | static String stringifyTabs({required DockingTabs tabs}) { 118 | return tabs.maximized ? 'T' : 'F'; 119 | } 120 | 121 | /// Converts the children indexes to String separated by colon. 122 | /// 123 | /// Example: 124 | /// 4,5,6 125 | static String stringifyParent({required DockingParentArea parent}) { 126 | List indexes = []; 127 | for (int i = 0; i < parent.childrenCount; i++) { 128 | final DockingArea child = parent.childAt(i); 129 | if (child.index == -1) { 130 | throw StateError('Child does not belong to any layout.'); 131 | } 132 | indexes.add(child.index.toString()); 133 | } 134 | return indexes.join(','); 135 | } 136 | } 137 | -------------------------------------------------------------------------------- /lib/src/internal/layout/layout_tokenizer.dart: -------------------------------------------------------------------------------- 1 | import 'package:meta/meta.dart'; 2 | 3 | /// Tokenizer for the layout string. 4 | @internal 5 | class Tokenizer { 6 | Tokenizer(String layout) : _layout = layout; 7 | 8 | String _layout; 9 | 10 | String get layout => _layout; 11 | 12 | bool get isNotEmpty => _layout.isNotEmpty; 13 | 14 | bool get isEmpty => _layout.isEmpty; 15 | 16 | String removeNext() { 17 | if (_layout.isEmpty) { 18 | throw new StateError('Insufficient characters.'); 19 | } 20 | final String next = _layout.substring(0, 1); 21 | _layout = _layout.substring(1); 22 | return next; 23 | } 24 | 25 | List removeChildrenIndexes() { 26 | final String token = 27 | removeFirstToken(stop: ')', errorMessage: 'Invalid children indexes.'); 28 | if (token.isEmpty) { 29 | throw StateError('Parent without child.'); 30 | } 31 | List indexes = []; 32 | token.split(',').forEach((str) { 33 | int? index = int.tryParse(str); 34 | if (index == null) { 35 | throw StateError('Invalid index: $str'); 36 | } 37 | indexes.add(index); 38 | }); 39 | return indexes; 40 | } 41 | 42 | bool removeFirstRequiredBool( 43 | {required String stop, required String errorMessage}) { 44 | final String token = 45 | removeFirstToken(stop: stop, errorMessage: errorMessage); 46 | if (token == 'T') { 47 | return true; 48 | } 49 | if (token == 'F') { 50 | return false; 51 | } 52 | throw StateError(errorMessage); 53 | } 54 | 55 | double? removeFirstOptionalDouble( 56 | {required String stop, required String errorMessage}) { 57 | final String token = 58 | removeFirstToken(stop: stop, errorMessage: errorMessage); 59 | if (token.isEmpty) { 60 | return null; 61 | } 62 | final double? number = double.tryParse(token); 63 | if (number == null) { 64 | throw StateError(errorMessage); 65 | } 66 | return number; 67 | } 68 | 69 | int removeFirstRequiredInt( 70 | {required String stop, required String errorMessage}) { 71 | final String token = 72 | removeFirstToken(stop: stop, errorMessage: errorMessage); 73 | final int? number = int.tryParse(token); 74 | if (number == null) { 75 | throw StateError(errorMessage); 76 | } 77 | return number; 78 | } 79 | 80 | String removeFirstToken( 81 | {required String stop, required String errorMessage}) { 82 | final int index = _layout.indexOf(stop); 83 | if (index == -1) { 84 | throw StateError(errorMessage); 85 | } 86 | final String token = _layout.substring(0, index); 87 | _layout = _layout.substring(index + 1); 88 | return token; 89 | } 90 | 91 | String removeToken({required int length, required String errorMessage}) { 92 | if (_layout.length < length) { 93 | throw StateError(errorMessage); 94 | } 95 | final String token = _layout.substring(0, length); 96 | _layout = _layout.substring(length + 1); 97 | return token; 98 | } 99 | } 100 | -------------------------------------------------------------------------------- /lib/src/internal/layout/move_item.dart: -------------------------------------------------------------------------------- 1 | import 'package:docking/src/internal/layout/drop_item.dart'; 2 | import 'package:docking/src/layout/docking_layout.dart'; 3 | import 'package:docking/src/layout/drop_position.dart'; 4 | import 'package:meta/meta.dart'; 5 | 6 | /// Rearranges the layout given a new location for a [DockingItem]. 7 | @internal 8 | class MoveItem extends DropItem { 9 | MoveItem( 10 | {required DockingItem draggedItem, 11 | required DropArea targetArea, 12 | required DropPosition? dropPosition, 13 | required int? dropIndex}) 14 | : super( 15 | dropItem: draggedItem, 16 | targetArea: targetArea, 17 | dropPosition: dropPosition, 18 | dropIndex: dropIndex); 19 | 20 | @override 21 | void validate(DockingLayout layout, DockingArea area) { 22 | super.validate(layout, area); 23 | if (area.layoutId != layout.id) { 24 | throw ArgumentError( 25 | 'DockingArea belongs to another layout. Keep the layout in the state of your StatefulWidget.'); 26 | } 27 | } 28 | } 29 | -------------------------------------------------------------------------------- /lib/src/internal/layout/remove_item.dart: -------------------------------------------------------------------------------- 1 | import 'package:docking/src/internal/layout/layout_modifier.dart'; 2 | import 'package:docking/src/layout/docking_layout.dart'; 3 | import 'package:meta/meta.dart'; 4 | 5 | /// Removes [DockingItem] from this layout. 6 | @internal 7 | class RemoveItem extends LayoutModifier { 8 | RemoveItem({required this.itemToRemove}); 9 | 10 | final DockingItem itemToRemove; 11 | 12 | @override 13 | void validate(DockingLayout layout, DockingArea area) { 14 | super.validate(layout, area); 15 | if (area.layoutId != layout.id) { 16 | throw ArgumentError( 17 | 'DockingArea belongs to another layout. Keep the layout in the state of your StatefulWidget.'); 18 | } 19 | } 20 | 21 | @override 22 | DockingArea? newLayout(DockingLayout layout) { 23 | validate(layout, itemToRemove); 24 | if (layout.root != null) { 25 | return _buildLayout(layout.root!); 26 | } 27 | return null; 28 | } 29 | 30 | /// Builds a new root. 31 | DockingArea? _buildLayout(DockingArea area) { 32 | if (area is DockingItem) { 33 | DockingItem dockingItem = area; 34 | if (dockingItem == itemToRemove) { 35 | return null; 36 | } 37 | return dockingItem; 38 | } else if (area is DockingTabs) { 39 | DockingTabs dockingTabs = area; 40 | List children = []; 41 | dockingTabs.forEach((child) { 42 | if (child != itemToRemove) { 43 | children.add(child); 44 | } 45 | }); 46 | if (children.length == 1) { 47 | return children.first; 48 | } 49 | if (children.isEmpty) { 50 | return null; 51 | } 52 | DockingTabs newDockingTabs = DockingTabs(children, 53 | id: dockingTabs.id, 54 | maximized: dockingTabs.maximized, 55 | maximizable: dockingTabs.maximizable); 56 | newDockingTabs.selectedIndex = dockingTabs.selectedIndex; 57 | return newDockingTabs; 58 | } else if (area is DockingParentArea) { 59 | List children = []; 60 | area.forEach((child) { 61 | DockingArea? newChild = _buildLayout(child); 62 | if (newChild != null) { 63 | children.add(newChild); 64 | } 65 | }); 66 | if (children.length == 0) { 67 | return null; 68 | } else if (children.length == 1) { 69 | return children.first; 70 | } 71 | if (area is DockingRow) { 72 | return DockingRow(children, id: area.id); 73 | } else if (area is DockingColumn) { 74 | return DockingColumn(children, id: area.id); 75 | } 76 | throw ArgumentError( 77 | 'DockingArea class not recognized: ' + area.runtimeType.toString()); 78 | } 79 | throw ArgumentError( 80 | 'DockingArea class not recognized: ' + area.runtimeType.toString()); 81 | } 82 | } 83 | -------------------------------------------------------------------------------- /lib/src/internal/layout/remove_item_by_id.dart: -------------------------------------------------------------------------------- 1 | import 'package:docking/src/layout/docking_layout.dart'; 2 | import 'package:docking/src/internal/layout/layout_modifier.dart'; 3 | import 'package:meta/meta.dart'; 4 | 5 | /// Removes [DockingItem] by id from this layout. 6 | @internal 7 | class RemoveItemById extends LayoutModifier { 8 | RemoveItemById({required this.id}); 9 | 10 | final dynamic id; 11 | 12 | @override 13 | DockingArea? newLayout(DockingLayout layout) { 14 | if (layout.root != null) { 15 | return _buildLayout(layout.root!); 16 | } 17 | return null; 18 | } 19 | 20 | /// Builds a new root. 21 | DockingArea? _buildLayout(DockingArea area) { 22 | if (area is DockingItem) { 23 | DockingItem dockingItem = area; 24 | if (dockingItem.id == id) { 25 | return null; 26 | } 27 | return dockingItem; 28 | } else if (area is DockingTabs) { 29 | DockingTabs dockingTabs = area; 30 | List children = []; 31 | dockingTabs.forEach((child) { 32 | if (child.id != id) { 33 | children.add(child); 34 | } 35 | }); 36 | if (children.length == 1) { 37 | return children.first; 38 | } 39 | DockingTabs newDockingTabs = DockingTabs(children, 40 | id: dockingTabs.id, 41 | maximized: dockingTabs.maximized, 42 | maximizable: dockingTabs.maximizable); 43 | newDockingTabs.selectedIndex = dockingTabs.selectedIndex; 44 | return newDockingTabs; 45 | } else if (area is DockingParentArea) { 46 | List children = []; 47 | area.forEach((child) { 48 | DockingArea? newChild = _buildLayout(child); 49 | if (newChild != null) { 50 | children.add(newChild); 51 | } 52 | }); 53 | if (children.length == 0) { 54 | return null; 55 | } else if (children.length == 1) { 56 | return children.first; 57 | } 58 | if (area is DockingRow) { 59 | return DockingRow(children, id: area.id); 60 | } else if (area is DockingColumn) { 61 | return DockingColumn(children, id: area.id); 62 | } 63 | throw ArgumentError( 64 | 'DockingArea class not recognized: ' + area.runtimeType.toString()); 65 | } 66 | throw ArgumentError( 67 | 'DockingArea class not recognized: ' + area.runtimeType.toString()); 68 | } 69 | } 70 | -------------------------------------------------------------------------------- /lib/src/internal/widgets/docking_item_widget.dart: -------------------------------------------------------------------------------- 1 | import 'package:docking/src/docking_buttons_builder.dart'; 2 | import 'package:docking/src/drag_over_position.dart'; 3 | import 'package:docking/src/internal/widgets/draggable_config_mixin.dart'; 4 | import 'package:docking/src/internal/widgets/drop/content_wrapper.dart'; 5 | import 'package:docking/src/internal/widgets/drop/drop_feedback_widget.dart'; 6 | import 'package:docking/src/layout/docking_layout.dart'; 7 | import 'package:docking/src/layout/drop_position.dart'; 8 | import 'package:docking/src/on_item_close.dart'; 9 | import 'package:docking/src/on_item_selection.dart'; 10 | import 'package:docking/src/theme/docking_theme.dart'; 11 | import 'package:docking/src/theme/docking_theme_data.dart'; 12 | import 'package:flutter/material.dart'; 13 | import 'package:meta/meta.dart'; 14 | import 'package:tabbed_view/tabbed_view.dart'; 15 | 16 | /// Represents a widget for [DockingItem]. 17 | @internal 18 | class DockingItemWidget extends StatefulWidget { 19 | DockingItemWidget( 20 | {Key? key, 21 | required this.layout, 22 | required this.dragOverPosition, 23 | required this.item, 24 | this.onItemSelection, 25 | this.onItemClose, 26 | this.itemCloseInterceptor, 27 | this.dockingButtonsBuilder, 28 | required this.maximizable, 29 | required this.draggable}) 30 | : super(key: key); 31 | 32 | final DockingLayout layout; 33 | final DockingItem item; 34 | final OnItemSelection? onItemSelection; 35 | final OnItemClose? onItemClose; 36 | final ItemCloseInterceptor? itemCloseInterceptor; 37 | final DockingButtonsBuilder? dockingButtonsBuilder; 38 | final bool maximizable; 39 | final DragOverPosition dragOverPosition; 40 | final bool draggable; 41 | 42 | @override 43 | State createState() => DockingItemWidgetState(); 44 | } 45 | 46 | class DockingItemWidgetState extends State 47 | with DraggableConfigMixin { 48 | DropPosition? _activeDropPosition; 49 | 50 | @override 51 | Widget build(BuildContext context) { 52 | String name = widget.item.name != null ? widget.item.name! : ''; 53 | Widget content = widget.item.widget; 54 | if (widget.item.globalKey != null) { 55 | content = KeyedSubtree(child: content, key: widget.item.globalKey); 56 | } 57 | List? buttons; 58 | if (widget.item.buttons != null && widget.item.buttons!.isNotEmpty) { 59 | buttons = []; 60 | buttons.addAll(widget.item.buttons!); 61 | } 62 | final bool maximizable = widget.item.maximizable != null 63 | ? widget.item.maximizable! 64 | : widget.maximizable; 65 | if (maximizable) { 66 | if (buttons == null) { 67 | buttons = []; 68 | } 69 | DockingThemeData data = DockingTheme.of(context); 70 | 71 | if (widget.layout.maximizedArea != null && 72 | widget.layout.maximizedArea == widget.item) { 73 | buttons.add(TabButton( 74 | icon: data.restoreIcon, onPressed: () => widget.layout.restore())); 75 | } else { 76 | buttons.add(TabButton( 77 | icon: data.maximizeIcon, 78 | onPressed: () => widget.layout.maximizeDockingItem(widget.item))); 79 | } 80 | } 81 | 82 | List tabs = [ 83 | TabData( 84 | value: widget.item, 85 | text: name, 86 | content: content, 87 | closable: widget.item.closable, 88 | leading: widget.item.leading, 89 | buttons: buttons, 90 | draggable: widget.draggable) 91 | ]; 92 | TabbedViewController controller = TabbedViewController(tabs); 93 | 94 | OnTabSelection? onTabSelection; 95 | if (widget.onItemSelection != null) { 96 | onTabSelection = (int? index) { 97 | if (index != null) { 98 | widget.onItemSelection!(widget.item); 99 | } 100 | }; 101 | } 102 | 103 | Widget tabbedView = TabbedView( 104 | tabsAreaButtonsBuilder: _tabsAreaButtonsBuilder, 105 | onTabSelection: onTabSelection, 106 | tabCloseInterceptor: _tabCloseInterceptor, 107 | onTabClose: _onTabClose, 108 | controller: controller, 109 | onDraggableBuild: widget.draggable 110 | ? (TabbedViewController controller, int tabIndex, TabData tabData) { 111 | return buildDraggableConfig( 112 | dockingDrag: widget.dragOverPosition, tabData: tabData); 113 | } 114 | : null, 115 | contentBuilder: (context, tabIndex) => ItemContentWrapper( 116 | listener: _updateActiveDropPosition, 117 | layout: widget.layout, 118 | dockingItem: widget.item, 119 | child: controller.tabs[tabIndex].content!), 120 | onBeforeDropAccept: widget.draggable ? _onBeforeDropAccept : null); 121 | if (widget.draggable && widget.dragOverPosition.enable) { 122 | return DropFeedbackWidget( 123 | dropPosition: _activeDropPosition, child: tabbedView); 124 | } 125 | return tabbedView; 126 | } 127 | 128 | bool _onBeforeDropAccept( 129 | DraggableData source, TabbedViewController target, int newIndex) { 130 | DockingItem dockingItem = source.tabData.value; 131 | if (dockingItem != widget.item) { 132 | widget.layout.moveItem( 133 | draggedItem: dockingItem, 134 | targetArea: widget.item, 135 | dropIndex: newIndex); 136 | } 137 | return true; 138 | } 139 | 140 | void _updateActiveDropPosition(DropPosition? dropPosition) { 141 | if (_activeDropPosition != dropPosition) { 142 | setState(() { 143 | _activeDropPosition = dropPosition; 144 | }); 145 | } 146 | } 147 | 148 | List _tabsAreaButtonsBuilder(BuildContext context, int tabsCount) { 149 | if (widget.dockingButtonsBuilder != null) { 150 | return widget.dockingButtonsBuilder!(context, null, widget.item); 151 | } 152 | return []; 153 | } 154 | 155 | bool _tabCloseInterceptor(int tabIndex) { 156 | if (widget.itemCloseInterceptor != null) { 157 | return widget.itemCloseInterceptor!(widget.item); 158 | } 159 | return true; 160 | } 161 | 162 | void _onTabClose(int tabIndex, TabData tabData) { 163 | widget.layout.removeItem(item: widget.item); 164 | if (widget.onItemClose != null) { 165 | widget.onItemClose!(widget.item); 166 | } 167 | } 168 | } 169 | -------------------------------------------------------------------------------- /lib/src/internal/widgets/draggable_config_mixin.dart: -------------------------------------------------------------------------------- 1 | import 'package:docking/src/drag_over_position.dart'; 2 | import 'package:docking/src/layout/docking_layout.dart'; 3 | import 'package:flutter/material.dart'; 4 | import 'package:meta/meta.dart'; 5 | import 'package:tabbed_view/tabbed_view.dart'; 6 | 7 | /// Represents a draggable widget mixin. 8 | @internal 9 | mixin DraggableConfigMixin { 10 | DraggableConfig buildDraggableConfig( 11 | {required DragOverPosition dockingDrag, required TabData tabData}) { 12 | DockingItem item = tabData.value; 13 | String name = item.name != null ? item.name! : ''; 14 | return DraggableConfig( 15 | feedback: buildFeedback(name), 16 | dragAnchorStrategy: (Draggable draggable, BuildContext context, 17 | Offset position) => 18 | Offset(20, 20), 19 | onDragStarted: () { 20 | dockingDrag.enable = true; 21 | }, 22 | onDragCompleted: () { 23 | dockingDrag.enable = false; 24 | }); 25 | } 26 | 27 | Widget buildFeedback(String name) { 28 | return Material( 29 | child: Container( 30 | child: ConstrainedBox( 31 | constraints: new BoxConstraints( 32 | minHeight: 0, 33 | minWidth: 30, 34 | maxHeight: double.infinity, 35 | maxWidth: 150.0, 36 | ), 37 | child: Padding( 38 | child: Text(name, overflow: TextOverflow.ellipsis), 39 | padding: EdgeInsets.all(4))), 40 | decoration: 41 | BoxDecoration(border: Border.all(), color: Colors.grey[300]))); 42 | } 43 | } 44 | -------------------------------------------------------------------------------- /lib/src/internal/widgets/drop/content_wrapper.dart: -------------------------------------------------------------------------------- 1 | import 'package:docking/src/internal/widgets/drop/drop_anchor_widget.dart'; 2 | import 'package:docking/src/layout/docking_layout.dart'; 3 | import 'package:docking/src/layout/drop_position.dart'; 4 | import 'package:flutter/material.dart'; 5 | import 'package:meta/meta.dart'; 6 | 7 | @internal 8 | abstract class ContentWrapperBase extends StatelessWidget { 9 | const ContentWrapperBase( 10 | {Key? key, 11 | required this.layout, 12 | required this.listener, 13 | required this.child}) 14 | : super(key: key); 15 | 16 | final DockingLayout layout; 17 | final Widget child; 18 | final DropWidgetListener listener; 19 | 20 | @nonVirtual 21 | @override 22 | Widget build(BuildContext context) { 23 | return LayoutBuilder( 24 | builder: (BuildContext context, BoxConstraints constraints) { 25 | List children = [Positioned.fill(child: child)]; 26 | 27 | // percentage of width reserved for detecting center area 28 | const double centerWidthRatio = 50; 29 | // reserved width to detect center area 30 | final double centerWidth = centerWidthRatio * constraints.maxWidth / 100; 31 | // reserved width to detect left and right areas 32 | final double horizontalEdgeWidth = 33 | (constraints.maxWidth - centerWidth) / 2; 34 | // height reserved for detecting the top and bottom areas 35 | final double verticalEdgeHeight = constraints.maxHeight / 2; 36 | 37 | children.add(Positioned( 38 | child: buildDropAnchor(DropPosition.left), 39 | width: horizontalEdgeWidth, 40 | bottom: 0, 41 | top: 0, 42 | left: 0)); 43 | 44 | children.add(Positioned( 45 | child: buildDropAnchor(DropPosition.right), 46 | width: horizontalEdgeWidth, 47 | bottom: 0, 48 | top: 0, 49 | right: 0)); 50 | 51 | children.add(Positioned( 52 | child: buildDropAnchor(DropPosition.top), 53 | height: verticalEdgeHeight, 54 | top: 0, 55 | left: horizontalEdgeWidth, 56 | right: horizontalEdgeWidth)); 57 | 58 | children.add(Positioned( 59 | child: buildDropAnchor(DropPosition.bottom), 60 | height: verticalEdgeHeight, 61 | bottom: 0, 62 | left: horizontalEdgeWidth, 63 | right: horizontalEdgeWidth)); 64 | 65 | return Stack(children: children); 66 | }); 67 | } 68 | 69 | DropAnchorBaseWidget buildDropAnchor(DropPosition dropPosition); 70 | } 71 | 72 | @internal 73 | class ItemContentWrapper extends ContentWrapperBase { 74 | ItemContentWrapper( 75 | {required DockingLayout layout, 76 | required DropWidgetListener listener, 77 | required DockingItem dockingItem, 78 | required Widget child}) 79 | : _dockingItem = dockingItem, 80 | super(layout: layout, listener: listener, child: child); 81 | 82 | final DockingItem _dockingItem; 83 | 84 | @override 85 | DropAnchorBaseWidget buildDropAnchor(DropPosition dropPosition) { 86 | return ItemDropAnchorWidget( 87 | layout: layout, 88 | listener: listener, 89 | dropPosition: dropPosition, 90 | dockingItem: _dockingItem); 91 | } 92 | } 93 | 94 | @internal 95 | class TabsContentWrapper extends ContentWrapperBase { 96 | TabsContentWrapper( 97 | {required DockingLayout layout, 98 | required DropWidgetListener listener, 99 | required DockingTabs dockingTabs, 100 | required Widget child}) 101 | : _dockingTabs = dockingTabs, 102 | super(layout: layout, listener: listener, child: child); 103 | 104 | final DockingTabs _dockingTabs; 105 | 106 | @override 107 | DropAnchorBaseWidget buildDropAnchor(DropPosition dropPosition) { 108 | return TabsDropAnchorWidget( 109 | layout: layout, 110 | listener: listener, 111 | dropPosition: dropPosition, 112 | dockingTabs: _dockingTabs); 113 | } 114 | } 115 | -------------------------------------------------------------------------------- /lib/src/internal/widgets/drop/drop_anchor_widget.dart: -------------------------------------------------------------------------------- 1 | import 'package:docking/src/internal/debug.dart'; 2 | import 'package:docking/src/layout/docking_layout.dart'; 3 | import 'package:docking/src/layout/drop_position.dart'; 4 | import 'package:flutter/material.dart'; 5 | import 'package:meta/meta.dart'; 6 | import 'package:tabbed_view/tabbed_view.dart'; 7 | 8 | typedef DropWidgetListener = void Function(DropPosition? dropPosition); 9 | 10 | @internal 11 | abstract class DropAnchorBaseWidget extends StatelessWidget { 12 | const DropAnchorBaseWidget( 13 | {required this.layout, 14 | required this.dropPosition, 15 | required this.listener}); 16 | 17 | final DockingLayout layout; 18 | final DropPosition dropPosition; 19 | final DropWidgetListener listener; 20 | 21 | @nonVirtual 22 | @override 23 | Widget build(BuildContext context) { 24 | return MouseRegion( 25 | hitTestBehavior: HitTestBehavior.translucent, 26 | onExit: (e) => listener(null), 27 | child: DragTarget( 28 | builder: _buildDropWidget, 29 | onWillAcceptWithDetails: 30 | (DragTargetDetails details) { 31 | final DraggableData draggableData = details.data; 32 | final TabData? draggedTabData = draggableData.tabData; 33 | final DockingItem? draggedItem = draggedTabData?.value; 34 | if (draggedItem != null) { 35 | bool willAccept = onWillAccept(draggedItem); 36 | if (willAccept) { 37 | listener(dropPosition); 38 | } else { 39 | listener(null); 40 | } 41 | return willAccept; 42 | } else { 43 | listener(null); 44 | } 45 | return false; 46 | }, 47 | onAcceptWithDetails: (DragTargetDetails details) { 48 | final DraggableData draggableData = details.data; 49 | final TabData tabData = draggableData.tabData; 50 | final DockingItem draggableItem = tabData.value; 51 | onAccept(draggableItem); 52 | })); 53 | } 54 | 55 | bool onWillAccept(DockingItem draggedItem); 56 | 57 | void onAccept(DockingItem draggedItem); 58 | 59 | Widget _buildDropWidget(BuildContext context, 60 | List candidateTabData, List rejectedData) { 61 | if (DockingDebug.dropAreaVisible) { 62 | Color color = Colors.deepOrange; 63 | if (dropPosition == DropPosition.top) { 64 | color = Colors.blue; 65 | } else if (dropPosition == DropPosition.bottom) { 66 | color = Colors.green; 67 | } else if (dropPosition == DropPosition.left) { 68 | color = Colors.purple; 69 | } 70 | return Container(child: Placeholder(color: color)); 71 | } 72 | return Container(); 73 | } 74 | } 75 | 76 | @internal 77 | class ItemDropAnchorWidget extends DropAnchorBaseWidget { 78 | const ItemDropAnchorWidget( 79 | {required DockingLayout layout, 80 | required DropPosition dropPosition, 81 | required DropWidgetListener listener, 82 | required DockingItem dockingItem}) 83 | : _dockingItem = dockingItem, 84 | super(layout: layout, dropPosition: dropPosition, listener: listener); 85 | 86 | final DockingItem _dockingItem; 87 | 88 | @override 89 | void onAccept(DockingItem draggedItem) { 90 | layout.moveItem( 91 | draggedItem: draggedItem, 92 | targetArea: _dockingItem, 93 | dropPosition: dropPosition); 94 | } 95 | 96 | @override 97 | bool onWillAccept(DockingItem draggedItem) { 98 | return _dockingItem != draggedItem; 99 | } 100 | } 101 | 102 | @internal 103 | class TabsDropAnchorWidget extends DropAnchorBaseWidget { 104 | const TabsDropAnchorWidget( 105 | {required DockingLayout layout, 106 | required DropPosition dropPosition, 107 | required DropWidgetListener listener, 108 | required DockingTabs dockingTabs}) 109 | : _dockingTabs = dockingTabs, 110 | super(layout: layout, dropPosition: dropPosition, listener: listener); 111 | 112 | final DockingTabs _dockingTabs; 113 | 114 | @override 115 | void onAccept(DockingItem draggedItem) { 116 | layout.moveItem( 117 | draggedItem: draggedItem, 118 | targetArea: _dockingTabs, 119 | dropPosition: dropPosition); 120 | } 121 | 122 | @override 123 | bool onWillAccept(DockingItem draggedItem) { 124 | return true; 125 | } 126 | } 127 | -------------------------------------------------------------------------------- /lib/src/internal/widgets/drop/drop_feedback_widget.dart: -------------------------------------------------------------------------------- 1 | import 'package:docking/docking.dart'; 2 | import 'package:flutter/material.dart'; 3 | import 'package:meta/meta.dart'; 4 | 5 | @internal 6 | class DropFeedbackWidget extends StatelessWidget { 7 | final Widget child; 8 | final DropPosition? dropPosition; 9 | 10 | const DropFeedbackWidget({Key? key, this.dropPosition, required this.child}) 11 | : super(key: key); 12 | 13 | @override 14 | Widget build(BuildContext context) { 15 | return CustomPaint( 16 | foregroundPainter: _CustomPainter(dropPosition), child: child); 17 | } 18 | } 19 | 20 | class _CustomPainter extends CustomPainter { 21 | _CustomPainter(this.dropPosition); 22 | 23 | final DropPosition? dropPosition; 24 | 25 | @override 26 | void paint(Canvas canvas, Size size) { 27 | if (dropPosition != null) { 28 | Paint paint = Paint() 29 | ..color = Colors.black.withOpacity(.5) 30 | ..style = PaintingStyle.fill; 31 | late Rect rect; 32 | if (dropPosition == DropPosition.top) { 33 | rect = Rect.fromLTWH(0, 0, size.width, size.height / 2); 34 | } else if (dropPosition == DropPosition.bottom) { 35 | rect = Rect.fromLTWH(0, size.height / 2, size.width, size.height / 2); 36 | } else if (dropPosition == DropPosition.left) { 37 | rect = Rect.fromLTWH(0, 0, size.width / 2, size.height); 38 | } else if (dropPosition == DropPosition.right) { 39 | rect = Rect.fromLTWH(size.width / 2, 0, size.width / 2, size.height); 40 | } else { 41 | throw StateError('Unexpected drop position: $dropPosition'); 42 | } 43 | canvas.drawRect(rect, paint); 44 | } 45 | } 46 | 47 | @override 48 | bool shouldRepaint(covariant _CustomPainter oldDelegate) => 49 | dropPosition != oldDelegate.dropPosition; 50 | } 51 | -------------------------------------------------------------------------------- /lib/src/layout/area_builder.dart: -------------------------------------------------------------------------------- 1 | import 'package:docking/src/layout/docking_layout.dart'; 2 | 3 | abstract class AreaBuilder { 4 | const AreaBuilder(); 5 | 6 | /// Builds a [DockingItem]. 7 | DockingItem buildDockingItem( 8 | {required dynamic id, required double? weight, required bool maximized}); 9 | 10 | /// Builds a [DockingRow]. 11 | DockingRow buildDockingRow( 12 | {required dynamic id, 13 | required double? weight, 14 | required List children}); 15 | 16 | /// Builds a [DockingColumn]. 17 | DockingColumn buildDockingColumn( 18 | {required dynamic id, 19 | required double? weight, 20 | required List children}); 21 | 22 | /// Builds a [DockingTabs]. 23 | DockingTabs buildDockingTabs( 24 | {required dynamic id, 25 | required double? weight, 26 | required bool maximized, 27 | required List children}); 28 | } 29 | 30 | mixin AreaBuilderMixin implements AreaBuilder { 31 | DockingRow buildDockingRow( 32 | {required dynamic id, 33 | required double? weight, 34 | required List children}) { 35 | return DockingRow(children, id: id, weight: weight); 36 | } 37 | 38 | DockingColumn buildDockingColumn( 39 | {required dynamic id, 40 | required double? weight, 41 | required List children}) { 42 | return DockingColumn(children, id: id, weight: weight); 43 | } 44 | 45 | /// Builds a [DockingTabs]. 46 | DockingTabs buildDockingTabs( 47 | {required dynamic id, 48 | required double? weight, 49 | required bool maximized, 50 | required List children}) { 51 | return DockingTabs(children, id: id, weight: weight, maximized: maximized); 52 | } 53 | } 54 | -------------------------------------------------------------------------------- /lib/src/layout/docking_area_type.dart: -------------------------------------------------------------------------------- 1 | /// Represents the [DockingArea] type. 2 | enum DockingAreaType { item, tabs, row, column } 3 | -------------------------------------------------------------------------------- /lib/src/layout/drop_position.dart: -------------------------------------------------------------------------------- 1 | /// Represents all positions available for a drop event that will 2 | /// rearrange the layout. 3 | enum DropPosition { top, bottom, left, right } 4 | -------------------------------------------------------------------------------- /lib/src/layout/layout_parser.dart: -------------------------------------------------------------------------------- 1 | /// Parser between DockingLayout and String. 2 | abstract class LayoutParser { 3 | const LayoutParser(); 4 | 5 | /// Converts ID to String. 6 | String idToString(dynamic id); 7 | 8 | /// Converts String to ID. 9 | dynamic stringToId(String id); 10 | } 11 | 12 | mixin LayoutParserMixin implements LayoutParser { 13 | /// Default conversion from ID to String. 14 | String idToString(dynamic id) { 15 | return id == null ? '' : id.toString(); 16 | } 17 | 18 | /// Default conversion from String to ID. 19 | dynamic stringToId(String id) { 20 | return id == '' ? null : id; 21 | } 22 | } 23 | -------------------------------------------------------------------------------- /lib/src/on_item_close.dart: -------------------------------------------------------------------------------- 1 | import 'package:docking/src/layout/docking_layout.dart'; 2 | 3 | /// Event that will be triggered after a [DockingItem] close. 4 | typedef OnItemClose = void Function(DockingItem item); 5 | 6 | /// Intercepts a [DockingItem] close event to indicates whether it can be closed. 7 | typedef ItemCloseInterceptor = bool Function(DockingItem item); 8 | -------------------------------------------------------------------------------- /lib/src/on_item_selection.dart: -------------------------------------------------------------------------------- 1 | import 'package:docking/src/layout/docking_layout.dart'; 2 | 3 | /// Event that will be triggered when a [DockingItem] selection is changed. 4 | typedef OnItemSelection = void Function(DockingItem item); 5 | -------------------------------------------------------------------------------- /lib/src/theme/docking_theme.dart: -------------------------------------------------------------------------------- 1 | import 'package:docking/src/theme/docking_theme_data.dart'; 2 | import 'package:flutter/widgets.dart'; 3 | 4 | /// Applies a [Docking] theme to descendant widgets. 5 | /// See also: 6 | /// 7 | /// * [DockingThemeData], which describes the actual configuration of a theme. 8 | class DockingTheme extends StatelessWidget { 9 | /// Applies the given theme [data] to [child]. 10 | /// 11 | /// The [data] and [child] arguments must not be null. 12 | const DockingTheme({ 13 | Key? key, 14 | required this.child, 15 | required this.data, 16 | }) : super(key: key); 17 | 18 | /// Specifies the theme for descendant widgets. 19 | final DockingThemeData data; 20 | 21 | /// The widget below this widget in the tree. 22 | final Widget child; 23 | 24 | static final DockingThemeData _defaultTheme = DockingThemeData(); 25 | 26 | /// The data from the closest [DockingTheme] instance that encloses the given 27 | /// context. 28 | static DockingThemeData of(BuildContext context) { 29 | final _InheritedTheme? inheritedTheme = 30 | context.dependOnInheritedWidgetOfExactType<_InheritedTheme>(); 31 | final DockingThemeData data = inheritedTheme?.data ?? _defaultTheme; 32 | return data; 33 | } 34 | 35 | @override 36 | Widget build(BuildContext context) { 37 | return _InheritedTheme(data: data, child: child); 38 | } 39 | } 40 | 41 | class _InheritedTheme extends InheritedWidget { 42 | const _InheritedTheme({ 43 | Key? key, 44 | required this.data, 45 | required Widget child, 46 | }) : super(key: key, child: child); 47 | 48 | final DockingThemeData data; 49 | 50 | @override 51 | bool updateShouldNotify(_InheritedTheme old) => data != old.data; 52 | } 53 | -------------------------------------------------------------------------------- /lib/src/theme/docking_theme_data.dart: -------------------------------------------------------------------------------- 1 | import 'package:docking/src/docking_icons.dart'; 2 | import 'package:flutter/material.dart'; 3 | import 'package:tabbed_view/tabbed_view.dart'; 4 | 5 | /// The [Docking] theme. 6 | /// Defines the configuration of the overall visual [Theme] for a widget subtree within the app. 7 | class DockingThemeData { 8 | DockingThemeData({IconProvider? restoreIcon, IconProvider? maximizeIcon}) 9 | : this.restoreIcon = restoreIcon != null 10 | ? restoreIcon 11 | : IconProvider.path(DockingIcons.restore), 12 | this.maximizeIcon = maximizeIcon != null 13 | ? maximizeIcon 14 | : IconProvider.data(Icons.web_asset_sharp); 15 | 16 | /// Icon for the restore button. 17 | IconProvider restoreIcon; 18 | 19 | /// Icon for the maximize button. 20 | IconProvider maximizeIcon; 21 | 22 | @override 23 | bool operator ==(Object other) => 24 | identical(this, other) || 25 | other is DockingThemeData && 26 | runtimeType == other.runtimeType && 27 | restoreIcon == other.restoreIcon && 28 | maximizeIcon == other.maximizeIcon; 29 | 30 | @override 31 | int get hashCode => restoreIcon.hashCode ^ maximizeIcon.hashCode; 32 | } 33 | -------------------------------------------------------------------------------- /pubspec.yaml: -------------------------------------------------------------------------------- 1 | name: docking 2 | description: Flutter layout for placing widgets in docking areas and arrange them into split and tabbed views. 3 | version: 1.16.1 4 | homepage: https://caduandrade.github.io/docking_flutter/ 5 | repository: https://github.com/caduandrade/docking_flutter 6 | 7 | environment: 8 | sdk: ">=2.12.0 <4.0.0" 9 | flutter: ">=1.17.0" 10 | 11 | dependencies: 12 | flutter: 13 | sdk: flutter 14 | meta: ^1.7.0 15 | tabbed_view: '>=1.18.0 <1.19.0' 16 | #path: ../tabbed_view/ 17 | multi_split_view: '>=2.4.0 <2.5.0' 18 | #path: ../multi_split_view/ 19 | 20 | dev_dependencies: 21 | flutter_test: 22 | sdk: flutter 23 | 24 | flutter_lints: ^2.0.2 25 | 26 | # For information on the generic Dart part of this file, see the 27 | # following page: https://dart.dev/tools/pub/pubspec 28 | 29 | # The following section is specific to Flutter. 30 | flutter: 31 | 32 | # To add assets to your package, add an assets section, like this: 33 | # assets: 34 | # - images/a_dot_burr.jpeg 35 | # - images/a_dot_ham.jpeg 36 | # 37 | # For details regarding assets in packages, see 38 | # https://flutter.dev/assets-and-images/#from-packages 39 | # 40 | # An image asset can refer to one or more resolution-specific "variants", see 41 | # https://flutter.dev/assets-and-images/#resolution-aware. 42 | 43 | # To add custom fonts to your package, add a fonts section here, 44 | # in this "flutter" section. Each entry in this list should have a 45 | # "family" key with the font family name, and a "fonts" key with a 46 | # list giving the asset and other descriptors for the font. For 47 | # example: 48 | # fonts: 49 | # - family: Schyler 50 | # fonts: 51 | # - asset: fonts/Schyler-Regular.ttf 52 | # - asset: fonts/Schyler-Italic.ttf 53 | # style: italic 54 | # - family: Trajan Pro 55 | # fonts: 56 | # - asset: fonts/TrajanPro.ttf 57 | # - asset: fonts/TrajanPro_Bold.ttf 58 | # weight: 700 59 | # 60 | # For details regarding fonts in packages, see 61 | # https://flutter.dev/custom-fonts/#from-packages 62 | -------------------------------------------------------------------------------- /svgs/restore.svg: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | -------------------------------------------------------------------------------- /test/add_test.dart: -------------------------------------------------------------------------------- 1 | import 'package:docking/docking.dart'; 2 | import 'package:flutter_test/flutter_test.dart'; 3 | 4 | import 'exceptions.dart'; 5 | import 'utils.dart'; 6 | 7 | void main() { 8 | group('add item - exceptions', () { 9 | test('dropItem == targetArea', () { 10 | DockingItem item = dockingItem('a'); 11 | DockingLayout layout = DockingLayout(root: item); 12 | expect(() => addItemOnRootPosition(layout, item, DropPosition.left), 13 | sameDraggedItemAndTargetAreaException()); 14 | }); 15 | 16 | test('area.layoutId != -1', () { 17 | DockingItem itemA = dockingItem('a'); 18 | DockingItem itemB = dockingItem('b'); 19 | DockingRow row = DockingRow([itemA, itemB]); 20 | DockingLayout layout = DockingLayout(root: row); 21 | expect(() => addItemOn(layout, itemB, itemA, DropPosition.right), 22 | dockingAreaInSomeLayoutException()); 23 | }); 24 | }); 25 | 26 | group('add item', () { 27 | test('item on root - left', () { 28 | DockingItem item = dockingItem('a'); 29 | DockingLayout layout = DockingLayout(root: item); 30 | addItemOnRootPosition(layout, dockingItem('b'), DropPosition.left); 31 | testHierarchy(layout, 'R(Ib,Ia)'); 32 | }); 33 | 34 | test('item on root - right', () { 35 | DockingItem item = dockingItem('a'); 36 | DockingLayout layout = DockingLayout(root: item); 37 | addItemOnRootPosition(layout, dockingItem('b'), DropPosition.right); 38 | testHierarchy(layout, 'R(Ia,Ib)'); 39 | }); 40 | 41 | test('item on root - top', () { 42 | DockingItem item = dockingItem('a'); 43 | DockingLayout layout = DockingLayout(root: item); 44 | addItemOnRootPosition(layout, dockingItem('b'), DropPosition.top); 45 | testHierarchy(layout, 'C(Ib,Ia)'); 46 | }); 47 | 48 | test('item on root - bottom', () { 49 | DockingItem item = dockingItem('a'); 50 | DockingLayout layout = DockingLayout(root: item); 51 | addItemOnRootPosition(layout, dockingItem('b'), DropPosition.bottom); 52 | testHierarchy(layout, 'C(Ia,Ib)'); 53 | }); 54 | 55 | test('item on root - index 0', () { 56 | DockingItem item = dockingItem('a'); 57 | DockingLayout layout = DockingLayout(root: item); 58 | addItemOnRootIndex(layout, dockingItem('b'), 0); 59 | testHierarchy(layout, 'T(Ib,Ia)'); 60 | }); 61 | 62 | test('item on root - index 1', () { 63 | DockingItem item = dockingItem('a'); 64 | DockingLayout layout = DockingLayout(root: item); 65 | addItemOnRootIndex(layout, dockingItem('b'), 1); 66 | testHierarchy(layout, 'T(Ia,Ib)'); 67 | }); 68 | 69 | test('item on row - right', () { 70 | DockingItem itemA = dockingItem('a'); 71 | DockingItem itemB = dockingItem('b'); 72 | DockingRow row = DockingRow([itemA, itemB]); 73 | DockingLayout layout = DockingLayout(root: row); 74 | addItemOn(layout, dockingItem('c'), itemA, DropPosition.right); 75 | testHierarchy(layout, 'R(Ia,Ic,Ib)'); 76 | }); 77 | }); 78 | } 79 | -------------------------------------------------------------------------------- /test/constructors_test.dart: -------------------------------------------------------------------------------- 1 | import 'package:docking/docking.dart'; 2 | import 'package:flutter_test/flutter_test.dart'; 3 | 4 | import 'utils.dart'; 5 | 6 | void main() { 7 | test('DockingItem', () { 8 | testDockingItem(dockingItem(null), 9 | layoutIndex: -1, hasParent: false, level: 0, path: 'I'); 10 | testDockingItem(dockingItem('a'), 11 | layoutIndex: -1, name: 'a', hasParent: false, level: 0, path: 'I'); 12 | }); 13 | 14 | test('empty layout', () { 15 | DockingLayout layout = DockingLayout(); 16 | expect(layout.root, isNull); 17 | }); 18 | 19 | group('not allowed', () { 20 | test('column children count', () { 21 | expect(() => DockingColumn([dockingItem('a')]), throwsArgumentError); 22 | expect(() => DockingColumn([]), throwsArgumentError); 23 | }); 24 | 25 | test('row children count', () { 26 | expect(() => DockingRow([dockingItem('a')]), throwsArgumentError); 27 | expect(() => DockingRow([]), throwsArgumentError); 28 | }); 29 | 30 | test('tabs children count', () { 31 | expect(() => DockingTabs([]), throwsArgumentError); 32 | }); 33 | }); 34 | } 35 | -------------------------------------------------------------------------------- /test/defaults_test.dart: -------------------------------------------------------------------------------- 1 | import 'package:docking/docking.dart'; 2 | import 'package:flutter_test/flutter_test.dart'; 3 | 4 | import 'utils.dart'; 5 | 6 | void main() { 7 | group('default id and parent', () { 8 | test('item', () { 9 | DockingLayout layout = DockingLayout(root: dockingItem('a')); 10 | expect(layout.root, isNotNull); 11 | testDockingItem(layout.root!, 12 | layoutIndex: 1, name: 'a', hasParent: false, path: 'I'); 13 | }); 14 | 15 | test('row', () { 16 | DockingItem itemA = dockingItem('a'); 17 | DockingItem itemB = dockingItem('b'); 18 | DockingRow row = DockingRow([itemA, itemB]); 19 | DockingLayout layout = DockingLayout(root: row); 20 | expect(layout.root, row); 21 | testDockingParentArea(row, 22 | childrenCount: 2, hasParent: false, path: 'R', level: 0); 23 | testDockingItem(row.childAt(0), 24 | layoutIndex: 2, name: 'a', hasParent: true, path: 'RI', level: 1); 25 | expect(row.childAt(0), itemA); 26 | testDockingItem(row.childAt(1), 27 | layoutIndex: 3, name: 'b', hasParent: true, path: 'RI', level: 1); 28 | expect(row.childAt(1), itemB); 29 | }); 30 | 31 | test('column', () { 32 | DockingItem itemA = dockingItem('a'); 33 | DockingItem itemB = dockingItem('b'); 34 | DockingLayout layout = DockingLayout(root: DockingColumn([itemA, itemB])); 35 | DockingColumn column = rootAsColumn(layout); 36 | expect(column.childrenCount, 2); 37 | testDockingItem(column.childAt(0), 38 | layoutIndex: 2, name: 'a', hasParent: true); 39 | expect(column.childAt(0), itemA); 40 | testDockingItem(column.childAt(1), 41 | layoutIndex: 3, name: 'b', hasParent: true); 42 | expect(column.childAt(1), itemB); 43 | }); 44 | }); 45 | } 46 | -------------------------------------------------------------------------------- /test/exceptions.dart: -------------------------------------------------------------------------------- 1 | import 'package:flutter_test/flutter_test.dart'; 2 | 3 | Matcher sameDraggedItemAndTargetAreaException() { 4 | return throwsA(predicate((x) => 5 | x is ArgumentError && 6 | x.message == 7 | "Argument draggedItem cannot be the same as argument targetArea. A DockingItem cannot be rearranged on itself.")); 8 | } 9 | 10 | Matcher dockingAreaInSomeLayoutException() { 11 | return throwsA(predicate((x) => 12 | x is ArgumentError && 13 | x.message == "DockingArea already belongs to some layout.")); 14 | } 15 | 16 | Matcher childNotBelongAnyLayoutException() { 17 | return throwsA(predicate((x) => 18 | x is StateError && x.message == "Child does not belong to any layout.")); 19 | } 20 | -------------------------------------------------------------------------------- /test/layout_index_test.dart: -------------------------------------------------------------------------------- 1 | import 'package:docking/docking.dart'; 2 | import 'package:flutter_test/flutter_test.dart'; 3 | 4 | import 'utils.dart'; 5 | 6 | void main() { 7 | group('Layout indexes', () { 8 | test('Indexes', () { 9 | DockingItem itemA = dockingItem('a'); 10 | DockingItem itemB = dockingItem('b'); 11 | DockingItem itemC = dockingItem('c'); 12 | DockingItem itemD = dockingItem('d'); 13 | DockingItem itemE = dockingItem('e'); 14 | DockingRow row = DockingRow([itemB, itemC]); 15 | DockingTabs tabs = DockingTabs([itemD, itemE]); 16 | DockingColumn column = DockingColumn([itemA, row, tabs]); 17 | DockingLayout layout = DockingLayout(root: column); 18 | expect(column.index, 1); 19 | expect(itemA.index, 2); 20 | expect(row.index, 3); 21 | expect(itemB.index, 4); 22 | expect(itemC.index, 5); 23 | expect(tabs.index, 6); 24 | expect(itemD.index, 7); 25 | expect(itemE.index, 8); 26 | expect(layout.hierarchy(indexInfo: true), 'C1(I2,R3(I4,I5),T6(I7,I8))'); 27 | }); 28 | }); 29 | } 30 | -------------------------------------------------------------------------------- /test/layout_stringify_test.dart: -------------------------------------------------------------------------------- 1 | import 'package:docking/docking.dart'; 2 | import 'package:docking/src/internal/layout/layout_stringify.dart'; 3 | import 'package:flutter/widgets.dart'; 4 | import 'package:flutter_test/flutter_test.dart'; 5 | 6 | import 'exceptions.dart'; 7 | import 'utils.dart'; 8 | 9 | void main() { 10 | final LayoutParser defaultParser = DefaultLayoutParser(); 11 | 12 | group('LayoutParser - stringify', () { 13 | test('stringifyParent', () { 14 | DockingItem itemA = dockingItem('a'); 15 | DockingItem itemB = dockingItem('b'); 16 | DockingItem itemC = dockingItem('c'); 17 | DockingItem itemD = dockingItem('d'); 18 | DockingItem itemE = dockingItem('e'); 19 | DockingRow row = DockingRow([itemB, itemC]); 20 | DockingTabs tabs = DockingTabs([itemD, itemE]); 21 | DockingColumn column = DockingColumn([itemA, row, tabs]); 22 | 23 | expect(() => LayoutStringify.stringifyParent(parent: column), 24 | childNotBelongAnyLayoutException()); 25 | expect(() => LayoutStringify.stringifyParent(parent: row), 26 | childNotBelongAnyLayoutException()); 27 | expect(() => LayoutStringify.stringifyParent(parent: tabs), 28 | childNotBelongAnyLayoutException()); 29 | 30 | DockingLayout(root: column); 31 | 32 | expect(LayoutStringify.stringifyParent(parent: column), '2,3,6'); 33 | expect(LayoutStringify.stringifyParent(parent: row), '4,5'); 34 | expect(LayoutStringify.stringifyParent(parent: tabs), '7,8'); 35 | }); 36 | test('stringifyArea', () { 37 | DockingItem itemA = DockingItem(widget: Container()); 38 | DockingItem itemB = DockingItem(widget: Container(), weight: .2); 39 | DockingItem itemC = DockingItem(id: 'idC', widget: Container()); 40 | DockingItem itemD = DockingItem(id: 1.2, widget: Container()); 41 | DockingItem itemE = DockingItem(widget: Container(), weight: .3); 42 | DockingRow row = DockingRow([itemB, itemC], weight: .4); 43 | DockingTabs tabs = DockingTabs([itemD, itemE]); 44 | DockingColumn column = DockingColumn([itemA, row, tabs]); 45 | 46 | DockingLayout(root: column); 47 | 48 | expect(LayoutStringify.stringifyArea(parser: defaultParser, area: column), 49 | '0;;'); 50 | expect(LayoutStringify.stringifyArea(parser: defaultParser, area: row), 51 | '0;;0.4'); 52 | expect(LayoutStringify.stringifyArea(parser: defaultParser, area: tabs), 53 | '0;;'); 54 | expect(LayoutStringify.stringifyArea(parser: defaultParser, area: itemA), 55 | '0;;'); 56 | expect(LayoutStringify.stringifyArea(parser: defaultParser, area: itemB), 57 | '0;;0.2'); 58 | expect(LayoutStringify.stringifyArea(parser: defaultParser, area: itemC), 59 | '3;idC;'); 60 | expect(LayoutStringify.stringifyArea(parser: defaultParser, area: itemD), 61 | '3;1.2;'); 62 | expect(LayoutStringify.stringifyArea(parser: defaultParser, area: itemE), 63 | '0;;0.3'); 64 | }); 65 | test('stringifyTabs', () { 66 | DockingItem itemA = dockingItem('a'); 67 | DockingItem itemB = dockingItem('b'); 68 | DockingTabs tabs = DockingTabs([itemA, itemB], maximized: true); 69 | 70 | DockingLayout(root: tabs); 71 | 72 | expect(LayoutStringify.stringifyTabs(tabs: tabs), 'T'); 73 | }); 74 | test('stringifyItem', () { 75 | DockingItem itemA = DockingItem(widget: Container()); 76 | DockingItem itemB = DockingItem(maximized: true, widget: Container()); 77 | DockingRow row = DockingRow([itemA, itemB]); 78 | 79 | DockingLayout(root: row); 80 | 81 | expect(LayoutStringify.stringifyItem(item: itemA), 'F'); 82 | expect(LayoutStringify.stringifyItem(item: itemB), 'T'); 83 | }); 84 | test('stringifyArea - CustomIdParser', () { 85 | DockingItem itemA = DockingItem(id: 1.2, widget: Container()); 86 | DockingItem itemB = DockingItem(id: 3.3, widget: Container()); 87 | DockingRow row = DockingRow([itemA, itemB], id: 5.5); 88 | 89 | DockingLayout(root: row); 90 | 91 | LayoutParser parser = CustomIdParser(); 92 | 93 | expect( 94 | LayoutStringify.stringifyArea(parser: parser, area: itemA), '3;2.2;'); 95 | expect( 96 | LayoutStringify.stringifyArea(parser: parser, area: itemB), '3;4.3;'); 97 | expect( 98 | LayoutStringify.stringifyArea(parser: parser, area: row), '3;6.5;'); 99 | }); 100 | test('stringifyArea - CustomIdClassParser', () { 101 | DockingItem itemA = 102 | DockingItem(id: CustomClass('itemA'), widget: Container()); 103 | DockingItem itemB = 104 | DockingItem(id: CustomClass('itemB'), widget: Container()); 105 | DockingRow row = DockingRow([itemA, itemB], id: CustomClass('row')); 106 | 107 | DockingLayout(root: row); 108 | 109 | LayoutParser parser = CustomIdClassParser(); 110 | 111 | expect(LayoutStringify.stringifyArea(parser: parser, area: itemA), 112 | '5;itemA;'); 113 | expect(LayoutStringify.stringifyArea(parser: parser, area: itemB), 114 | '5;itemB;'); 115 | expect( 116 | LayoutStringify.stringifyArea(parser: parser, area: row), '3;row;'); 117 | }); 118 | test('stringify - simple', () { 119 | DockingItem itemA = 120 | DockingItem(id: 'idA', value: 'valueA', widget: Container()); 121 | DockingItem itemB = 122 | DockingItem(id: 'idB', value: 'valueB', widget: Container()); 123 | 124 | DockingRow row = DockingRow([itemA, itemB], weight: 1); 125 | 126 | DockingLayout layout = DockingLayout(root: row); 127 | 128 | expect(layout.stringify(parser: defaultParser), 129 | 'V1:3:1(R;0;;1.0;2,3),2(I;3;idA;;F),3(I;3;idB;;F)'); 130 | }); 131 | }); 132 | } 133 | 134 | class CustomClass { 135 | CustomClass(this.value); 136 | 137 | final String value; 138 | } 139 | 140 | class DefaultLayoutParser extends LayoutParser with LayoutParserMixin {} 141 | 142 | class DefaultAreaBuilder extends AreaBuilder with AreaBuilderMixin { 143 | @override 144 | DockingItem buildDockingItem( 145 | {required id, required double? weight, required bool maximized}) { 146 | throw UnimplementedError(); 147 | } 148 | } 149 | 150 | class CustomIdParser extends DefaultLayoutParser { 151 | @override 152 | String idToString(dynamic id) { 153 | return (id + 1).toString(); 154 | } 155 | 156 | @override 157 | dynamic stringToId(String id) { 158 | double v = double.parse(id); 159 | return v - 1; 160 | } 161 | } 162 | 163 | class CustomIdClassParser extends DefaultLayoutParser { 164 | @override 165 | String idToString(dynamic id) { 166 | CustomClass customClass = id; 167 | return customClass.value; 168 | } 169 | 170 | @override 171 | dynamic stringToId(String id) { 172 | return CustomClass(id); 173 | } 174 | } 175 | -------------------------------------------------------------------------------- /test/remove_test.dart: -------------------------------------------------------------------------------- 1 | import 'package:docking/docking.dart'; 2 | import 'package:flutter_test/flutter_test.dart'; 3 | 4 | import 'utils.dart'; 5 | 6 | void main() { 7 | group('remove item', () { 8 | test('item', () { 9 | DockingItem item = dockingItem('a'); 10 | DockingLayout layout = DockingLayout(root: item); 11 | testHierarchy(layout, 'Ia'); 12 | removeItem(layout, item); 13 | testHierarchy(layout, ''); 14 | }); 15 | 16 | test('item without layout', () { 17 | DockingLayout layout = DockingLayout(); 18 | expect(() => removeItem(layout, dockingItem('a')), throwsArgumentError); 19 | layout = DockingLayout(root: dockingItem('a')); 20 | expect(() => removeItem(layout, dockingItem('b')), throwsArgumentError); 21 | }); 22 | 23 | test('item from another layout', () { 24 | DockingLayout layout1 = DockingLayout(root: dockingItem('a')); 25 | DockingLayout layout2 = DockingLayout(root: dockingItem('b')); 26 | expect( 27 | () => removeItem(layout2, layout1.layoutAreas().first as DockingItem), 28 | throwsArgumentError); 29 | }); 30 | 31 | test('row item 1', () { 32 | DockingItem itemA = dockingItem('a'); 33 | DockingItem itemB = dockingItem('b'); 34 | DockingItem itemC = dockingItem('c'); 35 | DockingRow row = DockingRow([itemA, itemB, itemC]); 36 | DockingLayout layout = DockingLayout(root: row); 37 | 38 | testHierarchy(layout, 'R(Ia,Ib,Ic)'); 39 | 40 | removeItem(layout, itemA); 41 | 42 | testHierarchy(layout, 'R(Ib,Ic)'); 43 | }); 44 | 45 | test('row item 2', () { 46 | DockingItem itemA = dockingItem('a'); 47 | DockingItem itemB = dockingItem('b'); 48 | DockingRow row = DockingRow([itemA, itemB]); 49 | DockingLayout layout = DockingLayout(root: row); 50 | 51 | testHierarchy(layout, 'R(Ia,Ib)'); 52 | 53 | removeItem(layout, itemA); 54 | 55 | testHierarchy(layout, 'Ib'); 56 | }); 57 | 58 | test('column item 1', () { 59 | DockingItem itemA = dockingItem('a'); 60 | DockingItem itemB = dockingItem('b'); 61 | DockingItem itemC = dockingItem('c'); 62 | DockingColumn column = DockingColumn([itemA, itemB, itemC]); 63 | DockingLayout layout = DockingLayout(root: column); 64 | 65 | testHierarchy(layout, 'C(Ia,Ib,Ic)'); 66 | 67 | removeItem(layout, itemA); 68 | 69 | testHierarchy(layout, 'C(Ib,Ic)'); 70 | }); 71 | 72 | test('column item 2', () { 73 | DockingItem itemA = dockingItem('a'); 74 | DockingItem itemB = dockingItem('b'); 75 | DockingColumn column = DockingColumn([itemA, itemB]); 76 | DockingLayout layout = DockingLayout(root: column); 77 | 78 | testHierarchy(layout, 'C(Ia,Ib)'); 79 | 80 | removeItem(layout, itemA); 81 | 82 | testHierarchy(layout, 'Ib'); 83 | }); 84 | 85 | test('tabs single item', () { 86 | DockingItem itemA = dockingItem('a'); 87 | DockingTabs tabs = DockingTabs([itemA]); 88 | DockingLayout layout = DockingLayout(root: tabs); 89 | 90 | testHierarchy(layout, 'T(Ia)'); 91 | 92 | removeItem(layout, itemA); 93 | 94 | testHierarchy(layout, ''); 95 | }); 96 | 97 | test('tabs item 1', () { 98 | DockingItem itemA = dockingItem('a'); 99 | DockingItem itemB = dockingItem('b'); 100 | DockingItem itemC = dockingItem('c'); 101 | DockingTabs tabs = DockingTabs([itemA, itemB, itemC]); 102 | DockingLayout layout = DockingLayout(root: tabs); 103 | 104 | testHierarchy(layout, 'T(Ia,Ib,Ic)'); 105 | 106 | removeItem(layout, itemA); 107 | 108 | testHierarchy(layout, 'T(Ib,Ic)'); 109 | }); 110 | 111 | test('tabs item 2', () { 112 | DockingItem itemA = dockingItem('a'); 113 | DockingItem itemB = dockingItem('b'); 114 | DockingTabs tabs = DockingTabs([itemA, itemB]); 115 | DockingLayout layout = DockingLayout(root: tabs); 116 | 117 | testHierarchy(layout, 'T(Ia,Ib)'); 118 | 119 | removeItem(layout, itemA); 120 | 121 | testHierarchy(layout, 'Ib'); 122 | }); 123 | 124 | test('column row item 1', () { 125 | DockingItem itemA = dockingItem('a'); 126 | DockingItem itemB = dockingItem('b'); 127 | DockingItem itemC = dockingItem('c'); 128 | DockingRow row = DockingRow([itemA, itemB]); 129 | DockingColumn column = DockingColumn([row, itemC]); 130 | DockingLayout layout = DockingLayout(root: column); 131 | 132 | testHierarchy(layout, 'C(R(Ia,Ib),Ic)'); 133 | 134 | removeItem(layout, itemC); 135 | 136 | testHierarchy(layout, 'R(Ia,Ib)'); 137 | }); 138 | 139 | test('column row item 2', () { 140 | DockingItem itemA = dockingItem('a'); 141 | DockingItem itemB = dockingItem('b'); 142 | DockingItem itemC = dockingItem('c'); 143 | DockingRow row = DockingRow([itemA, itemB]); 144 | DockingColumn column = DockingColumn([row, itemC]); 145 | DockingLayout layout = DockingLayout(root: column); 146 | 147 | testHierarchy(layout, 'C(R(Ia,Ib),Ic)'); 148 | 149 | removeItem(layout, itemA); 150 | 151 | testHierarchy(layout, 'C(Ib,Ic)'); 152 | }); 153 | 154 | test('row column row item', () { 155 | DockingItem itemA = dockingItem('a'); 156 | DockingItem itemB = dockingItem('b'); 157 | DockingItem itemC = dockingItem('c'); 158 | DockingItem itemD = dockingItem('d'); 159 | DockingRow row = DockingRow([itemB, itemC]); 160 | DockingColumn column = DockingColumn([row, itemD]); 161 | DockingRow rootRow = DockingRow([itemA, column]); 162 | DockingLayout layout = DockingLayout(root: rootRow); 163 | 164 | testHierarchy(layout, 'R(Ia,C(R(Ib,Ic),Id))'); 165 | 166 | removeItem(layout, itemD); 167 | 168 | testHierarchy(layout, 'R(Ia,Ib,Ic)'); 169 | }); 170 | }); 171 | } 172 | -------------------------------------------------------------------------------- /test/utils.dart: -------------------------------------------------------------------------------- 1 | import 'package:docking/docking.dart'; 2 | import 'package:flutter/widgets.dart'; 3 | import 'package:flutter_test/flutter_test.dart'; 4 | 5 | DockingItem dockingItem(String? name, {dynamic id}) { 6 | return DockingItem(id: id, name: name, widget: Container()); 7 | } 8 | 9 | void removeItemById(DockingLayout layout, List ids) { 10 | List itemsToDispose = []; 11 | for (dynamic id in ids) { 12 | DockingItem? item = layout.findDockingItem(id); 13 | if (item != null) { 14 | itemsToDispose.add(item); 15 | } 16 | } 17 | List areas = layout.layoutAreas(); 18 | layout.removeItemByIds(ids); 19 | areas.forEach((area) { 20 | bool areaIsDisposedItem = false; 21 | for (DockingItem disposedItem in itemsToDispose) { 22 | if (area == disposedItem) { 23 | areaIsDisposedItem = true; 24 | break; 25 | } 26 | } 27 | if (area is DockingItem && !areaIsDisposedItem) { 28 | testNonDisposedArea(area); 29 | } else { 30 | testDisposed(area); 31 | } 32 | }); 33 | } 34 | 35 | void removeItem(DockingLayout layout, DockingItem item) { 36 | List areas = layout.layoutAreas(); 37 | layout.removeItem(item: item); 38 | testOldAreas(areas, disposedItem: item); 39 | } 40 | 41 | void moveItemToPosition(DockingLayout layout, DockingItem draggedItem, 42 | DropArea targetArea, DropPosition dropPosition) { 43 | List areas = layout.layoutAreas(); 44 | layout.moveItem( 45 | draggedItem: draggedItem, 46 | targetArea: targetArea, 47 | dropPosition: dropPosition); 48 | testOldAreas(areas); 49 | } 50 | 51 | void moveItemToIndex(DockingLayout layout, DockingItem draggedItem, 52 | DropArea targetArea, int dropIndex) { 53 | List areas = layout.layoutAreas(); 54 | layout.moveItem( 55 | draggedItem: draggedItem, targetArea: targetArea, dropIndex: dropIndex); 56 | testOldAreas(areas); 57 | } 58 | 59 | void addItemOnRootPosition( 60 | DockingLayout layout, DockingItem newItem, DropPosition dropPosition) { 61 | List areas = layout.layoutAreas(); 62 | layout.addItemOnRoot(newItem: newItem, dropPosition: dropPosition); 63 | testOldAreas(areas); 64 | } 65 | 66 | void addItemOnRootIndex( 67 | DockingLayout layout, DockingItem newItem, int dropIndex) { 68 | List areas = layout.layoutAreas(); 69 | layout.addItemOnRoot(newItem: newItem, dropIndex: dropIndex); 70 | testOldAreas(areas); 71 | } 72 | 73 | void addItemOn(DockingLayout layout, DockingItem newItem, DropArea targetArea, 74 | DropPosition dropPosition) { 75 | List areas = layout.layoutAreas(); 76 | layout.addItemOn( 77 | newItem: newItem, targetArea: targetArea, dropPosition: dropPosition); 78 | testOldAreas(areas); 79 | } 80 | 81 | int _testAreasAttributes(DockingArea parent, bool value, int level, int index) { 82 | expect(parent.parent != null, value); 83 | expect(parent.level, level); 84 | expect(parent.index, index); 85 | index++; 86 | if (parent is DockingParentArea) { 87 | parent.forEach((child) { 88 | index = _testAreasAttributes(child, true, level + 1, index); 89 | }); 90 | } 91 | return index; 92 | } 93 | 94 | void testAreasAttributes(DockingLayout layout) { 95 | if (layout.root != null) { 96 | _testAreasAttributes(layout.root!, false, 0, 1); 97 | } 98 | } 99 | 100 | void testHierarchy(DockingLayout layout, String hierarchy) { 101 | if (hierarchy.length == 0) { 102 | expect(layout.root, isNull); 103 | } else { 104 | expect(layout.root, isNotNull); 105 | testAreasAttributes(layout); 106 | expect(layout.hierarchy(nameInfo: true), hierarchy); 107 | } 108 | } 109 | 110 | void testNonDisposedArea(DockingArea area) { 111 | expect(area.layoutId > -1, true, reason: 'has layoutId'); 112 | expect(area.index > -1, true, reason: 'has index'); 113 | } 114 | 115 | void testOldAreas(List layoutAreas, {DockingItem? disposedItem}) { 116 | layoutAreas.forEach((area) { 117 | if (area is DockingItem && area != disposedItem) { 118 | testNonDisposedArea(area); 119 | } else { 120 | testDisposed(area); 121 | } 122 | }); 123 | } 124 | 125 | void testDockingArea(DockingArea area, 126 | {int? layoutIndex, bool? hasParent, int? level, String? path}) { 127 | if (layoutIndex != null) { 128 | expect(area.index, layoutIndex, reason: 'layoutIndex'); 129 | } 130 | if (hasParent != null) { 131 | expect(area.parent != null, hasParent, reason: 'hasParent'); 132 | } 133 | if (level != null) { 134 | expect(area.level, level, reason: 'level'); 135 | } 136 | 137 | if (path != null) { 138 | expect(area.path, path, reason: 'path'); 139 | } 140 | } 141 | 142 | void testDisposed(DockingArea area) { 143 | testDockingArea(area, 144 | layoutIndex: -1, hasParent: false, path: area.typeAcronym, level: 0); 145 | } 146 | 147 | void testDockingParentArea(DockingParentArea parent, 148 | {int? layoutIndex, 149 | int? childrenCount, 150 | bool? hasParent, 151 | int? level, 152 | String? path}) { 153 | testDockingArea(parent, 154 | layoutIndex: layoutIndex, hasParent: hasParent, level: level, path: path); 155 | if (childrenCount != null) { 156 | expect(parent.childrenCount, childrenCount, reason: 'childrenCount'); 157 | } 158 | } 159 | 160 | void testDockingItem(DockingArea item, 161 | {int? layoutIndex, 162 | String? name, 163 | bool? hasParent, 164 | int? level, 165 | String? path}) { 166 | testDockingArea(item, 167 | layoutIndex: layoutIndex, hasParent: hasParent, level: level, path: path); 168 | expect(item.type, DockingAreaType.item, reason: 'type'); 169 | DockingItem _item = item as DockingItem; 170 | expect(_item.name, name, reason: 'name'); 171 | } 172 | 173 | DockingRow rootAsRow(DockingLayout layout) { 174 | expect(layout.root, isNotNull); 175 | expect(layout.root!.type, DockingAreaType.row); 176 | return layout.root as DockingRow; 177 | } 178 | 179 | DockingColumn rootAsColumn(DockingLayout layout) { 180 | expect(layout.root, isNotNull); 181 | expect(layout.root!.type, DockingAreaType.column); 182 | return layout.root as DockingColumn; 183 | } 184 | 185 | DockingTabs rootAsTabs(DockingLayout layout) { 186 | expect(layout.root, isNotNull); 187 | expect(layout.root!.type, DockingAreaType.tabs); 188 | return layout.root as DockingTabs; 189 | } 190 | -------------------------------------------------------------------------------- /uml/layout.uml: -------------------------------------------------------------------------------- 1 | @startuml 2 | 3 | class DropArea << (M,lightgray) >> #line:black 4 | 5 | abstract class DockingArea << (C,lightgray) >> #line:black { 6 | index: int 7 | layoutId: int 8 | parent: DockingParentArea? 9 | } 10 | 11 | abstract class DockingParentArea << (C,lightgray) >> #line:black { 12 | childrenCount: int 13 | } 14 | 15 | class DockingItem << (C,lightgray) >> #line:black { 16 | name: String? 17 | widget: Widget 18 | closable: bool 19 | keepAlive: bool 20 | maximizable: bool 21 | value: dynamic 22 | } 23 | 24 | class DockingRow << (C,lightgray) >> #line:black { 25 | DockingRow(children: List) 26 | forEach(f: void (DockingArea child)) 27 | } 28 | 29 | class DockingColumn << (C,lightgray) >> #line:black { 30 | DockingColumn(children: List) 31 | forEach(f: void (DockingArea child)) 32 | } 33 | 34 | class DockingTabs << (C,lightgray) >> #line:black { 35 | maximizable: bool 36 | DockingTabs(children: List) 37 | forEach(f: void (DockingItem child)) 38 | } 39 | 40 | class Area << (C,lightgray) >> #line:black { 41 | minimalWeight: double? 42 | minimalSize: double? 43 | size: double? 44 | weight: double? 45 | } 46 | 47 | Area <|-- DockingArea #line:black 48 | DockingArea <|-- DockingParentArea #line:black 49 | DockingArea <|-- DockingItem #line:black 50 | DockingParentArea <|-- DockingRow #line:black 51 | DockingParentArea <|-- DockingColumn #line:black 52 | DockingParentArea <|-- DockingTabs #line:black 53 | DropArea <|-- DockingItem #line:black 54 | DropArea <|-- DockingTabs #line:black 55 | 56 | @enduml --------------------------------------------------------------------------------