Class Doc-Comment zu Konstruktor verschieben #167

Open
flixcoo wants to merge 1 commits from refactoring/157-class-doc-comment-zu-konstruktor-verschieben into development
39 changed files with 177 additions and 219 deletions
Showing only changes of commit bb79eecdfd - Show all commits

View File

@@ -1,7 +1,11 @@
import 'dart:io'; import 'dart:io';
import 'package:flutter/cupertino.dart'; import 'package:flutter/cupertino.dart';
import 'package:flutter/material.dart'; import 'package:flutter/material.dart';
/// Returns a platform-adaptive page route based on the current platform.
/// - On iOS, it returns a [CupertinoPageRoute].
/// - On other platforms, it returns a [MaterialPageRoute].
Route<T> adaptivePageRoute<T>({ Route<T> adaptivePageRoute<T>({
required Widget Function(BuildContext) builder, required Widget Function(BuildContext) builder,
bool fullscreenDialog = false, bool fullscreenDialog = false,

View File

@@ -1,3 +1,4 @@
/// Application-wide constants
class Constants { class Constants {
Constants._(); // Private constructor to prevent instantiation Constants._(); // Private constructor to prevent instantiation

View File

@@ -1,5 +1,6 @@
import 'package:flutter/material.dart'; import 'package:flutter/material.dart';
/// Theme class that defines colors, border radius, padding, and decorations
class CustomTheme { class CustomTheme {
CustomTheme._(); // Private constructor to prevent instantiation CustomTheme._(); // Private constructor to prevent instantiation

View File

@@ -12,6 +12,8 @@ import 'package:game_tracker/presentation/views/main_menu/statistics_view.dart';
import 'package:game_tracker/presentation/widgets/navbar_item.dart'; import 'package:game_tracker/presentation/widgets/navbar_item.dart';
class CustomNavigationBar extends StatefulWidget { class CustomNavigationBar extends StatefulWidget {
/// A custom navigation bar widget that provides tabbed navigation
/// between different views: Home, Matches, Groups, and Statistics.
const CustomNavigationBar({super.key}); const CustomNavigationBar({super.key});
@override @override

View File

@@ -11,6 +11,7 @@ import 'package:game_tracker/presentation/widgets/text_input/text_input_field.da
import 'package:provider/provider.dart'; import 'package:provider/provider.dart';
class CreateGroupView extends StatefulWidget { class CreateGroupView extends StatefulWidget {
/// A view that allows the user to create a new group
const CreateGroupView({super.key}); const CreateGroupView({super.key});
@override @override

View File

@@ -14,6 +14,7 @@ import 'package:game_tracker/presentation/widgets/top_centered_message.dart';
import 'package:provider/provider.dart'; import 'package:provider/provider.dart';
class GroupsView extends StatefulWidget { class GroupsView extends StatefulWidget {
/// A view that displays a list of groups
const GroupsView({super.key}); const GroupsView({super.key});
@override @override

View File

@@ -15,6 +15,8 @@ import 'package:game_tracker/presentation/widgets/tiles/quick_info_tile.dart';
import 'package:provider/provider.dart'; import 'package:provider/provider.dart';
class HomeView extends StatefulWidget { class HomeView extends StatefulWidget {
/// The main home view of the application, displaying quick info,
/// recent matches, and quick create options.
const HomeView({super.key}); const HomeView({super.key});
@override @override

View File

@@ -6,15 +6,21 @@ import 'package:game_tracker/presentation/widgets/text_input/custom_search_bar.d
import 'package:game_tracker/presentation/widgets/tiles/title_description_list_tile.dart'; import 'package:game_tracker/presentation/widgets/tiles/title_description_list_tile.dart';
class ChooseGameView extends StatefulWidget { class ChooseGameView extends StatefulWidget {
final List<(String, String, Ruleset)> games; /// A view that allows the user to choose a game from a list of available games
final int initialGameIndex; /// - [games]: A list of tuples containing the game name, description and ruleset
/// - [initialGameIndex]: The index of the initially selected game
const ChooseGameView({ const ChooseGameView({
super.key, super.key,
required this.games, required this.games,
required this.initialGameIndex, required this.initialGameIndex,
}); });
/// A list of tuples containing the game name, description and ruleset
final List<(String, String, Ruleset)> games;
/// The index of the initially selected game
final int initialGameIndex;
@override @override
State<ChooseGameView> createState() => _ChooseGameViewState(); State<ChooseGameView> createState() => _ChooseGameViewState();
} }

View File

@@ -7,15 +7,21 @@ import 'package:game_tracker/presentation/widgets/tiles/group_tile.dart';
import 'package:game_tracker/presentation/widgets/top_centered_message.dart'; import 'package:game_tracker/presentation/widgets/top_centered_message.dart';
class ChooseGroupView extends StatefulWidget { class ChooseGroupView extends StatefulWidget {
final List<Group> groups; /// A view that allows the user to choose a group from a list of groups.
final String initialGroupId; /// - [groups]: A list of available groups to choose from
/// - [initialGroupId]: The ID of the initially selected group
const ChooseGroupView({ const ChooseGroupView({
super.key, super.key,
required this.groups, required this.groups,
required this.initialGroupId, required this.initialGroupId,
}); });
/// A list of available groups to choose from
final List<Group> groups;
/// The ID of the initially selected group
final String initialGroupId;
@override @override
State<ChooseGroupView> createState() => _ChooseGroupViewState(); State<ChooseGroupView> createState() => _ChooseGroupViewState();
} }
@@ -143,7 +149,8 @@ class _ChooseGroupViewState extends State<ChooseGroupView> {
(group) => (group) =>
group.name.toLowerCase().contains(query.toLowerCase()) || group.name.toLowerCase().contains(query.toLowerCase()) ||
group.members.any( group.members.any(
(player) => player.name.toLowerCase().contains(query.toLowerCase()), (player) =>
player.name.toLowerCase().contains(query.toLowerCase()),
), ),
), ),
); );

View File

@@ -5,15 +5,21 @@ import 'package:game_tracker/l10n/generated/app_localizations.dart';
import 'package:game_tracker/presentation/widgets/tiles/title_description_list_tile.dart'; import 'package:game_tracker/presentation/widgets/tiles/title_description_list_tile.dart';
class ChooseRulesetView extends StatefulWidget { class ChooseRulesetView extends StatefulWidget {
final List<(Ruleset, String)> rulesets; /// A view that allows the user to choose a ruleset from a list of available rulesets
final int initialRulesetIndex; /// - [rulesets]: A list of tuples containing the ruleset and its description
/// - [initialRulesetIndex]: The index of the initially selected ruleset
const ChooseRulesetView({ const ChooseRulesetView({
super.key, super.key,
required this.rulesets, required this.rulesets,
required this.initialRulesetIndex, required this.initialRulesetIndex,
}); });
/// A list of tuples containing the ruleset and its description
final List<(Ruleset, String)> rulesets;
/// The index of the initially selected ruleset
final int initialRulesetIndex;
@override @override
State<ChooseRulesetView> createState() => _ChooseRulesetViewState(); State<ChooseRulesetView> createState() => _ChooseRulesetViewState();
} }

View File

@@ -18,9 +18,13 @@ import 'package:game_tracker/presentation/widgets/tiles/choose_tile.dart';
import 'package:provider/provider.dart'; import 'package:provider/provider.dart';
class CreateMatchView extends StatefulWidget { class CreateMatchView extends StatefulWidget {
final VoidCallback? onWinnerChanged; /// A view that allows creating a new match
/// [onWinnerChanged]: Optional callback invoked when the winner is changed
const CreateMatchView({super.key, this.onWinnerChanged}); const CreateMatchView({super.key, this.onWinnerChanged});
/// Optional callback invoked when the winner is changed
final VoidCallback? onWinnerChanged;
@override @override
State<CreateMatchView> createState() => _CreateMatchViewState(); State<CreateMatchView> createState() => _CreateMatchViewState();
} }
@@ -202,7 +206,8 @@ class _CreateMatchViewState extends State<CreateMatchView> {
if (selectedGroup != null) { if (selectedGroup != null) {
filteredPlayerList = playerList filteredPlayerList = playerList
.where( .where(
(p) => !selectedGroup!.members.any((m) => m.id == p.id), (p) =>
!selectedGroup!.members.any((m) => m.id == p.id),
) )
.toList(); .toList();
} else { } else {

View File

@@ -8,11 +8,17 @@ import 'package:game_tracker/presentation/widgets/tiles/custom_radio_list_tile.d
import 'package:provider/provider.dart'; import 'package:provider/provider.dart';
class MatchResultView extends StatefulWidget { class MatchResultView extends StatefulWidget {
/// A view that allows selecting and saving the winner of a match
/// [match]: The match for which the winner is to be selected
/// [onWinnerChanged]: Optional callback invoked when the winner is changed
const MatchResultView({super.key, required this.match, this.onWinnerChanged});
/// The match for which the winner is to be selected
final Match match; final Match match;
/// Optional callback invoked when the winner is changed
final VoidCallback? onWinnerChanged; final VoidCallback? onWinnerChanged;
const MatchResultView({super.key, required this.match, this.onWinnerChanged});
@override @override
State<MatchResultView> createState() => _MatchResultViewState(); State<MatchResultView> createState() => _MatchResultViewState();
} }

View File

@@ -19,6 +19,7 @@ import 'package:game_tracker/presentation/widgets/top_centered_message.dart';
import 'package:provider/provider.dart'; import 'package:provider/provider.dart';
class MatchView extends StatefulWidget { class MatchView extends StatefulWidget {
/// A view that displays a list of matches
const MatchView({super.key}); const MatchView({super.key});
@override @override

View File

@@ -5,10 +5,13 @@ import 'package:game_tracker/presentation/views/main_menu/settings_view/licenses
import 'package:url_launcher/url_launcher.dart'; import 'package:url_launcher/url_launcher.dart';
class LicenseDetailView extends StatelessWidget { class LicenseDetailView extends StatelessWidget {
final Package package; /// A detailed view displaying information about a software package license.
/// - [package]: The package data to be displayed.
const LicenseDetailView({super.key, required this.package}); const LicenseDetailView({super.key, required this.package});
/// The package data to be displayed.
final Package package;
@override @override
Widget build(BuildContext context) { Widget build(BuildContext context) {
final loc = AppLocalizations.of(context); final loc = AppLocalizations.of(context);

View File

@@ -5,6 +5,7 @@ import 'package:game_tracker/presentation/views/main_menu/settings_view/licenses
import 'package:game_tracker/presentation/widgets/tiles/license_tile.dart'; import 'package:game_tracker/presentation/widgets/tiles/license_tile.dart';
class LicensesView extends StatelessWidget { class LicensesView extends StatelessWidget {
/// A view that displays a list of open source licenses used in the app
const LicensesView({super.key}); const LicensesView({super.key});
@override @override

View File

@@ -14,6 +14,8 @@ import 'package:package_info_plus/package_info_plus.dart';
import 'package:url_launcher/url_launcher.dart'; import 'package:url_launcher/url_launcher.dart';
class SettingsView extends StatefulWidget { class SettingsView extends StatefulWidget {
/// The settings view of the application, allowing users to manage data
/// and view legal information.
const SettingsView({super.key}); const SettingsView({super.key});
@override @override

View File

@@ -10,6 +10,7 @@ import 'package:game_tracker/presentation/widgets/top_centered_message.dart';
import 'package:provider/provider.dart'; import 'package:provider/provider.dart';
class StatisticsView extends StatefulWidget { class StatisticsView extends StatefulWidget {
/// A view that displays player statistics
const StatisticsView({super.key}); const StatisticsView({super.key});
@override @override

View File

@@ -1,11 +1,11 @@
import 'package:flutter/material.dart'; import 'package:flutter/material.dart';
import 'package:skeletonizer/skeletonizer.dart'; import 'package:skeletonizer/skeletonizer.dart';
class AppSkeleton extends StatefulWidget {
/// A widget that provides a skeleton loading effect to its child widget tree. /// A widget that provides a skeleton loading effect to its child widget tree.
/// - [child]: The widget tree to apply the skeleton effect to. /// - [child]: The widget tree to apply the skeleton effect to.
/// - [enabled]: A boolean to enable or disable the skeleton effect. /// - [enabled]: A boolean to enable or disable the skeleton effect.
/// - [fixLayoutBuilder]: A boolean to fix the layout builder for AnimatedSwitcher. /// - [fixLayoutBuilder]: A boolean to fix the layout builder for AnimatedSwitcher.
class AppSkeleton extends StatefulWidget {
const AppSkeleton({ const AppSkeleton({
super.key, super.key,
required this.child, required this.child,

View File

@@ -2,13 +2,13 @@ import 'package:flutter/material.dart';
import 'package:game_tracker/core/custom_theme.dart'; import 'package:game_tracker/core/custom_theme.dart';
import 'package:game_tracker/core/enums.dart'; import 'package:game_tracker/core/enums.dart';
class CustomWidthButton extends StatelessWidget {
/// A custom button widget that is designed to have a width relative to the screen size. /// A custom button widget that is designed to have a width relative to the screen size.
/// It supports three types of buttons: primary, secondary, and text buttons. /// It supports three types of buttons: primary, secondary, and text buttons.
/// - [text]: The text to display on the button. /// - [text]: The text to display on the button.
/// - [buttonType]: The type of button to display. Defaults to [ButtonType.primary]. /// - [buttonType]: The type of button to display. Defaults to [ButtonType.primary].
/// - [sizeRelativeToWidth]: The size of the button relative to the width of the screen. /// - [sizeRelativeToWidth]: The size of the button relative to the width of the screen.
/// - [onPressed]: The callback to be invoked when the button is pressed. /// - [onPressed]: The callback to be invoked when the button is pressed.
class CustomWidthButton extends StatelessWidget {
const CustomWidthButton({ const CustomWidthButton({
super.key, super.key,
required this.text, required this.text,

View File

@@ -1,10 +1,10 @@
import 'package:flutter/material.dart'; import 'package:flutter/material.dart';
class MainMenuButton extends StatefulWidget {
/// A button for the main menu with an optional icon and a press animation. /// A button for the main menu with an optional icon and a press animation.
/// - [text]: The text of the button. /// - [text]: The text of the button.
/// - [icon]: The icon of the button. /// - [icon]: The icon of the button.
/// - [onPressed]: The callback to be invoked when the button is pressed. /// - [onPressed]: The callback to be invoked when the button is pressed.
class MainMenuButton extends StatefulWidget {
const MainMenuButton({ const MainMenuButton({
super.key, super.key,
required this.text, required this.text,

View File

@@ -1,10 +1,10 @@
import 'package:flutter/material.dart'; import 'package:flutter/material.dart';
import 'package:game_tracker/core/custom_theme.dart'; import 'package:game_tracker/core/custom_theme.dart';
class QuickCreateButton extends StatefulWidget {
/// A button widget designed for quick creating matches in the [HomeView] /// A button widget designed for quick creating matches in the [HomeView]
/// - [text]: The text to display on the button. /// - [text]: The text to display on the button.
/// - [onPressed]: The callback to be invoked when the button is pressed. /// - [onPressed]: The callback to be invoked when the button is pressed.
class QuickCreateButton extends StatefulWidget {
const QuickCreateButton({ const QuickCreateButton({
super.key, super.key,
required this.text, required this.text,

View File

@@ -1,13 +1,13 @@
import 'package:flutter/material.dart'; import 'package:flutter/material.dart';
import 'package:game_tracker/core/custom_theme.dart'; import 'package:game_tracker/core/custom_theme.dart';
class NavbarItem extends StatefulWidget {
/// A navigation bar item widget that represents a single tab in a navigation bar. /// A navigation bar item widget that represents a single tab in a navigation bar.
/// - [index]: The index of the tab. /// - [index]: The index of the tab.
/// - [isSelected]: A boolean indicating whether the tab is currently selected. /// - [isSelected]: A boolean indicating whether the tab is currently selected.
/// - [icon]: The icon to display for the tab. /// - [icon]: The icon to display for the tab.
/// - [label]: The label to display for the tab. /// - [label]: The label to display for the tab.
/// - [onTabTapped]: The callback to be invoked when the tab is tapped. /// - [onTabTapped]: The callback to be invoked when the tab is tapped.
class NavbarItem extends StatefulWidget {
const NavbarItem({ const NavbarItem({
super.key, super.key,
required this.index, required this.index,

View File

@@ -11,14 +11,14 @@ import 'package:game_tracker/presentation/widgets/tiles/text_icon_tile.dart';
import 'package:game_tracker/presentation/widgets/top_centered_message.dart'; import 'package:game_tracker/presentation/widgets/top_centered_message.dart';
import 'package:provider/provider.dart'; import 'package:provider/provider.dart';
class PlayerSelection extends StatefulWidget {
/// A widget that allows users to select players from a list, /// A widget that allows users to select players from a list,
/// with search functionality and the ability to add new players. /// with search functionality and the ability to add new players.
/// - [availablePlayers]: An optional list of players to choose from. If null, all /// - [availablePlayers]: An optional list of players to choose from. If null,
/// players from the database are used. /// all players from the database are used.
/// - [initialSelectedPlayers]: An optional list of players that should be pre-selected. /// - [initialSelectedPlayers]: An optional list of players that should be pre-selected.
/// - [onChanged]: A callback function that is invoked whenever the selection changes, /// - [onChanged]: A callback function that is invoked whenever the selection
/// providing the updated list of selected players. /// changes, providing the updated list of selected players.
class PlayerSelection extends StatefulWidget {
const PlayerSelection({ const PlayerSelection({
super.key, super.key,
this.availablePlayers, this.availablePlayers,

View File

@@ -1,6 +1,7 @@
import 'package:flutter/material.dart'; import 'package:flutter/material.dart';
import 'package:game_tracker/core/custom_theme.dart'; import 'package:game_tracker/core/custom_theme.dart';
class CustomSearchBar extends StatelessWidget {
/// A custom search bar widget that encapsulates a [SearchBar] with additional customization options. /// A custom search bar widget that encapsulates a [SearchBar] with additional customization options.
/// - [controller]: The controller for the search bar's text input. /// - [controller]: The controller for the search bar's text input.
/// - [hintText]: The hint text displayed in the search bar when it is empty. /// - [hintText]: The hint text displayed in the search bar when it is empty.
@@ -10,7 +11,6 @@ import 'package:game_tracker/core/custom_theme.dart';
/// - [onTrailingButtonPressed]: The callback invoked when the trailing button is pressed. /// - [onTrailingButtonPressed]: The callback invoked when the trailing button is pressed.
/// - [onChanged]: The callback invoked when the text in the search bar changes. /// - [onChanged]: The callback invoked when the text in the search bar changes.
/// - [constraints]: The constraints for the search bar. /// - [constraints]: The constraints for the search bar.
class CustomSearchBar extends StatelessWidget {
const CustomSearchBar({ const CustomSearchBar({
super.key, super.key,
required this.controller, required this.controller,

View File

@@ -1,11 +1,11 @@
import 'package:flutter/material.dart'; import 'package:flutter/material.dart';
import 'package:game_tracker/core/custom_theme.dart'; import 'package:game_tracker/core/custom_theme.dart';
class TextInputField extends StatelessWidget {
/// A custom text input field widget that encapsulates a [TextField] with specific styling. /// A custom text input field widget that encapsulates a [TextField] with specific styling.
/// - [controller]: The controller for the text input field. /// - [controller]: The controller for the text input field.
/// - [onChanged]: The callback invoked when the text in the field changes. /// - [onChanged]: The callback invoked when the text in the field changes.
/// - [hintText]: The hint text displayed in the text input field when it is empty /// - [hintText]: The hint text displayed in the text input field when it is empty
class TextInputField extends StatelessWidget {
const TextInputField({ const TextInputField({
super.key, super.key,
required this.controller, required this.controller,

View File

@@ -1,11 +1,11 @@
import 'package:flutter/material.dart'; import 'package:flutter/material.dart';
import 'package:game_tracker/core/custom_theme.dart'; import 'package:game_tracker/core/custom_theme.dart';
class ChooseTile extends StatefulWidget {
/// A tile widget that allows users to choose an option by tapping on it. /// A tile widget that allows users to choose an option by tapping on it.
/// - [title]: The title text displayed on the tile. /// - [title]: The title text displayed on the tile.
/// - [trailingText]: Optional trailing text displayed on the tile. /// - [trailingText]: Optional trailing text displayed on the tile.
/// - [onPressed]: The callback invoked when the tile is tapped. /// - [onPressed]: The callback invoked when the tile is tapped.
class ChooseTile extends StatefulWidget {
const ChooseTile({ const ChooseTile({
super.key, super.key,
required this.title, required this.title,

View File

@@ -1,11 +1,11 @@
import 'package:flutter/material.dart'; import 'package:flutter/material.dart';
import 'package:game_tracker/core/custom_theme.dart'; import 'package:game_tracker/core/custom_theme.dart';
class CustomRadioListTile<T> extends StatelessWidget {
/// A custom radio list tile widget that encapsulates a [Radio] button with additional styling and functionality. /// A custom radio list tile widget that encapsulates a [Radio] button with additional styling and functionality.
/// - [text]: The text to display next to the radio button. /// - [text]: The text to display next to the radio button.
/// - [value]: The value associated with the radio button. /// - [value]: The value associated with the radio button.
/// - [onContainerTap]: The callback invoked when the container is tapped. /// - [onContainerTap]: The callback invoked when the container is tapped.
class CustomRadioListTile<T> extends StatelessWidget {
const CustomRadioListTile({ const CustomRadioListTile({
super.key, super.key,
required this.text, required this.text,

View File

@@ -3,10 +3,10 @@ import 'package:game_tracker/core/custom_theme.dart';
import 'package:game_tracker/data/dto/group.dart'; import 'package:game_tracker/data/dto/group.dart';
import 'package:game_tracker/presentation/widgets/tiles/text_icon_tile.dart'; import 'package:game_tracker/presentation/widgets/tiles/text_icon_tile.dart';
class GroupTile extends StatelessWidget {
/// A tile widget that displays information about a group, including its name and members. /// A tile widget that displays information about a group, including its name and members.
/// - [group]: The group data to be displayed. /// - [group]: The group data to be displayed.
/// - [isHighlighted]: Whether the tile should be highlighted. /// - [isHighlighted]: Whether the tile should be highlighted.
class GroupTile extends StatelessWidget {
const GroupTile({super.key, required this.group, this.isHighlighted = false}); const GroupTile({super.key, required this.group, this.isHighlighted = false});
/// The group data to be displayed. /// The group data to be displayed.

View File

@@ -1,6 +1,7 @@
import 'package:flutter/material.dart'; import 'package:flutter/material.dart';
import 'package:game_tracker/core/custom_theme.dart'; import 'package:game_tracker/core/custom_theme.dart';
class InfoTile extends StatefulWidget {
/// A tile widget that displays a title with an icon and some content below it. /// A tile widget that displays a title with an icon and some content below it.
/// - [title]: The title text displayed on the tile. /// - [title]: The title text displayed on the tile.
/// - [icon]: The icon displayed next to the title. /// - [icon]: The icon displayed next to the title.
@@ -8,7 +9,6 @@ import 'package:game_tracker/core/custom_theme.dart';
/// - [padding]: Optional padding for the tile content. /// - [padding]: Optional padding for the tile content.
/// - [height]: Optional height for the tile. /// - [height]: Optional height for the tile.
/// - [width]: Optional width for the tile. /// - [width]: Optional width for the tile.
class InfoTile extends StatefulWidget {
const InfoTile({ const InfoTile({
super.key, super.key,
required this.title, required this.title,

View File

@@ -4,10 +4,13 @@ import 'package:game_tracker/presentation/views/main_menu/settings_view/licenses
import 'package:game_tracker/presentation/views/main_menu/settings_view/licenses/oss_licenses.dart'; import 'package:game_tracker/presentation/views/main_menu/settings_view/licenses/oss_licenses.dart';
class LicenseTile extends StatelessWidget { class LicenseTile extends StatelessWidget {
final Package package; /// A tile widget that displays information about a software package license.
/// - [package]: The package data to be displayed.
const LicenseTile({super.key, required this.package}); const LicenseTile({super.key, required this.package});
/// The package data to be displayed.
final Package package;
@override @override
Widget build(BuildContext context) { Widget build(BuildContext context) {
return GestureDetector( return GestureDetector(

View File

@@ -1,95 +0,0 @@
import 'package:flutter/material.dart';
import 'package:game_tracker/core/custom_theme.dart';
import 'package:skeletonizer/skeletonizer.dart';
class MatchSummaryTile extends StatefulWidget {
final String matchTitle;
final String game;
final String ruleset;
final String players;
final String winner;
const MatchSummaryTile({
super.key,
required this.matchTitle,
required this.game,
required this.ruleset,
required this.players,
required this.winner,
});
@override
State<MatchSummaryTile> createState() => _MatchSummaryTileState();
}
class _MatchSummaryTileState extends State<MatchSummaryTile> {
@override
Widget build(BuildContext context) {
return Column(
crossAxisAlignment: CrossAxisAlignment.start,
children: [
Row(
children: [
Text(
widget.matchTitle,
style: const TextStyle(fontSize: 18, fontWeight: FontWeight.bold),
),
const SizedBox(width: 5),
Text(
widget.game,
style: const TextStyle(fontSize: 14, color: Colors.grey),
),
],
),
const SizedBox(height: 5),
Container(
padding: const EdgeInsets.symmetric(horizontal: 4),
height: 20,
decoration: BoxDecoration(
borderRadius: BorderRadius.circular(4),
color: CustomTheme.primaryColor,
),
child: Skeleton.ignore(
child: Text(
widget.ruleset,
style: const TextStyle(fontWeight: FontWeight.bold),
),
),
),
Center(
heightFactor: 1.5,
child: Text(
widget.players,
style: const TextStyle(fontWeight: FontWeight.bold),
),
),
Center(
child: Container(
padding: const EdgeInsets.symmetric(horizontal: 4),
width: 220,
decoration: BoxDecoration(
borderRadius: BorderRadius.circular(4),
color: Colors.yellow.shade300,
),
child: Skeleton.ignore(
child: Row(
mainAxisAlignment: MainAxisAlignment.center,
children: [
const Icon(Icons.emoji_events, color: Colors.black, size: 20),
Text(
widget.winner,
textAlign: TextAlign.center,
style: const TextStyle(
fontWeight: FontWeight.bold,
color: Colors.black87,
),
),
],
),
),
),
),
],
);
}
}

View File

@@ -6,13 +6,13 @@ import 'package:game_tracker/l10n/generated/app_localizations.dart';
import 'package:game_tracker/presentation/widgets/tiles/text_icon_tile.dart'; import 'package:game_tracker/presentation/widgets/tiles/text_icon_tile.dart';
import 'package:intl/intl.dart'; import 'package:intl/intl.dart';
class MatchTile extends StatefulWidget {
/// A tile widget that displays information about a match, including its name, /// A tile widget that displays information about a match, including its name,
/// creation date, associated group, winner, and players. /// creation date, associated group, winner, and players.
/// - [match]: The match data to be displayed. /// - [match]: The match data to be displayed.
/// - [onTap]: The callback invoked when the tile is tapped. /// - [onTap]: The callback invoked when the tile is tapped.
/// - [width]: Optional width for the tile. /// - [width]: Optional width for the tile.
/// - [compact]: Whether to display the tile in a compact mode /// - [compact]: Whether to display the tile in a compact mode
class MatchTile extends StatefulWidget {
const MatchTile({ const MatchTile({
super.key, super.key,
required this.match, required this.match,

View File

@@ -1,6 +1,7 @@
import 'package:flutter/material.dart'; import 'package:flutter/material.dart';
import 'package:game_tracker/core/custom_theme.dart'; import 'package:game_tracker/core/custom_theme.dart';
class QuickInfoTile extends StatefulWidget {
/// A tile widget that displays a title with an icon and a numeric value below it. /// A tile widget that displays a title with an icon and a numeric value below it.
/// - [title]: The title text displayed on the tile. /// - [title]: The title text displayed on the tile.
/// - [icon]: The icon displayed next to the title. /// - [icon]: The icon displayed next to the title.
@@ -8,7 +9,6 @@ import 'package:game_tracker/core/custom_theme.dart';
/// - [height]: Optional height for the tile. /// - [height]: Optional height for the tile.
/// - [width]: Optional width for the tile. /// - [width]: Optional width for the tile.
/// - [padding]: Optional padding for the tile content. /// - [padding]: Optional padding for the tile content.
class QuickInfoTile extends StatefulWidget {
const QuickInfoTile({ const QuickInfoTile({
super.key, super.key,
required this.title, required this.title,

View File

@@ -1,12 +1,12 @@
import 'package:flutter/material.dart'; import 'package:flutter/material.dart';
import 'package:game_tracker/core/custom_theme.dart'; import 'package:game_tracker/core/custom_theme.dart';
class SettingsListTile extends StatelessWidget {
/// A customizable settings list tile widget that displays an icon, title, and an optional suffix widget. /// A customizable settings list tile widget that displays an icon, title, and an optional suffix widget.
/// - [icon]: The icon displayed on the left side of the tile. /// - [icon]: The icon displayed on the left side of the tile.
/// - [title]: The title text displayed next to the icon. /// - [title]: The title text displayed next to the icon.
/// - [suffixWidget]: An optional widget displayed on the right side of the tile. /// - [suffixWidget]: An optional widget displayed on the right side of the tile.
/// - [onPressed]: The callback invoked when the tile is tapped. /// - [onPressed]: The callback invoked when the tile is tapped.
class SettingsListTile extends StatelessWidget {
const SettingsListTile({ const SettingsListTile({
super.key, super.key,
required this.icon, required this.icon,

View File

@@ -4,6 +4,7 @@ import 'package:flutter/material.dart';
import 'package:game_tracker/l10n/generated/app_localizations.dart'; import 'package:game_tracker/l10n/generated/app_localizations.dart';
import 'package:game_tracker/presentation/widgets/tiles/info_tile.dart'; import 'package:game_tracker/presentation/widgets/tiles/info_tile.dart';
class StatisticsTile extends StatelessWidget {
/// A tile widget that displays statistical data using horizontal bars. /// A tile widget that displays statistical data using horizontal bars.
/// - [icon]: The icon displayed next to the title. /// - [icon]: The icon displayed next to the title.
/// - [title]: The title text displayed on the tile. /// - [title]: The title text displayed on the tile.
@@ -11,7 +12,6 @@ import 'package:game_tracker/presentation/widgets/tiles/info_tile.dart';
/// - [values]: A list of tuples containing labels and their corresponding numeric values. /// - [values]: A list of tuples containing labels and their corresponding numeric values.
/// - [itemCount]: The maximum number of items to display. /// - [itemCount]: The maximum number of items to display.
/// - [barColor]: The color of the bars representing the values. /// - [barColor]: The color of the bars representing the values.
class StatisticsTile extends StatelessWidget {
const StatisticsTile({ const StatisticsTile({
super.key, super.key,
required this.icon, required this.icon,

View File

@@ -1,11 +1,11 @@
import 'package:flutter/material.dart'; import 'package:flutter/material.dart';
import 'package:game_tracker/core/custom_theme.dart'; import 'package:game_tracker/core/custom_theme.dart';
class TextIconListTile extends StatelessWidget {
/// A list tile widget that displays text with an optional icon button. /// A list tile widget that displays text with an optional icon button.
/// - [text]: The text to display in the tile. /// - [text]: The text to display in the tile.
/// - [onPressed]: The callback to be invoked when the icon is pressed. /// - [onPressed]: The callback to be invoked when the icon is pressed.
/// - [iconEnabled]: A boolean to determine if the icon should be displayed. /// - [iconEnabled]: A boolean to determine if the icon should be displayed.
class TextIconListTile extends StatelessWidget {
const TextIconListTile({ const TextIconListTile({
super.key, super.key,
required this.text, required this.text,

View File

@@ -1,11 +1,11 @@
import 'package:flutter/material.dart'; import 'package:flutter/material.dart';
import 'package:game_tracker/core/custom_theme.dart'; import 'package:game_tracker/core/custom_theme.dart';
class TextIconTile extends StatelessWidget {
/// A tile widget that displays text with an optional icon that can be tapped. /// A tile widget that displays text with an optional icon that can be tapped.
/// - [text]: The text to display in the tile. /// - [text]: The text to display in the tile.
/// - [iconEnabled]: A boolean to determine if the icon should be displayed. /// - [iconEnabled]: A boolean to determine if the icon should be displayed.
/// - [onIconTap]: The callback to be invoked when the icon is tapped. /// - [onIconTap]: The callback to be invoked when the icon is tapped.
class TextIconTile extends StatelessWidget {
const TextIconTile({ const TextIconTile({
super.key, super.key,
required this.text, required this.text,

View File

@@ -1,6 +1,7 @@
import 'package:flutter/material.dart'; import 'package:flutter/material.dart';
import 'package:game_tracker/core/custom_theme.dart'; import 'package:game_tracker/core/custom_theme.dart';
class TitleDescriptionListTile extends StatelessWidget {
/// A list tile widget that displays a title and description, with optional highlighting and badge. /// A list tile widget that displays a title and description, with optional highlighting and badge.
/// - [title]: The title text displayed on the tile. /// - [title]: The title text displayed on the tile.
/// - [description]: The description text displayed below the title. /// - [description]: The description text displayed below the title.
@@ -8,7 +9,6 @@ import 'package:game_tracker/core/custom_theme.dart';
/// - [isHighlighted]: A boolean to determine if the tile should be highlighted. /// - [isHighlighted]: A boolean to determine if the tile should be highlighted.
/// - [badgeText]: Optional text to display in a badge on the right side of the title. /// - [badgeText]: Optional text to display in a badge on the right side of the title.
/// - [badgeColor]: Optional color for the badge background. /// - [badgeColor]: Optional color for the badge background.
class TitleDescriptionListTile extends StatelessWidget {
const TitleDescriptionListTile({ const TitleDescriptionListTile({
super.key, super.key,
required this.title, required this.title,

View File

@@ -1,10 +1,10 @@
import 'package:flutter/material.dart'; import 'package:flutter/material.dart';
class TopCenteredMessage extends StatelessWidget {
/// A widget that displays a message centered at the top of the screen with an icon, title, and message. /// A widget that displays a message centered at the top of the screen with an icon, title, and message.
/// - [icon]: The icon to display above the title. /// - [icon]: The icon to display above the title.
/// - [title]: The title text to display. /// - [title]: The title text to display.
/// - [message]: The message text to display below the title. /// - [message]: The message text to display below the title.
class TopCenteredMessage extends StatelessWidget {
const TopCenteredMessage({ const TopCenteredMessage({
super.key, super.key,
required this.icon, required this.icon,