Compare commits

...

13 Commits

@ -0,0 +1,226 @@
# Remove the line below if you want to inherit .editorconfig settings from higher directories
root = true
# C# files
[*.cs]
#### Core EditorConfig Options ####
# Indentation and spacing
indent_size = 3
indent_style = tab
tab_width = 3
# New line preferences
end_of_line = crlf
insert_final_newline = false
#### .NET Coding Conventions ####
# Organize usings
dotnet_separate_import_directive_groups = false
dotnet_sort_system_directives_first = false
file_header_template = unset
# this. and Me. preferences
dotnet_style_qualification_for_event = false:suggestion
dotnet_style_qualification_for_field = false:suggestion
dotnet_style_qualification_for_method = false:suggestion
dotnet_style_qualification_for_property = false:suggestion
# Language keywords vs BCL types preferences
dotnet_style_predefined_type_for_locals_parameters_members = true:suggestion
dotnet_style_predefined_type_for_member_access = true:suggestion
# Parentheses preferences
dotnet_style_parentheses_in_arithmetic_binary_operators = always_for_clarity:suggestion
dotnet_style_parentheses_in_other_binary_operators = always_for_clarity:suggestion
dotnet_style_parentheses_in_other_operators = never_if_unnecessary:suggestion
dotnet_style_parentheses_in_relational_binary_operators = always_for_clarity:suggestion
# Modifier preferences
dotnet_style_require_accessibility_modifiers = for_non_interface_members
# Expression-level preferences
dotnet_style_coalesce_expression = true
dotnet_style_collection_initializer = true
dotnet_style_explicit_tuple_names = true
dotnet_style_namespace_match_folder = true
dotnet_style_null_propagation = true
dotnet_style_object_initializer = true
dotnet_style_operator_placement_when_wrapping = beginning_of_line
dotnet_style_prefer_auto_properties = true:suggestion
dotnet_style_prefer_compound_assignment = true
dotnet_style_prefer_conditional_expression_over_assignment = true:suggestion
dotnet_style_prefer_conditional_expression_over_return = true:suggestion
dotnet_style_prefer_foreach_explicit_cast_in_source = when_strongly_typed
dotnet_style_prefer_inferred_anonymous_type_member_names = true
dotnet_style_prefer_inferred_tuple_names = false
dotnet_style_prefer_is_null_check_over_reference_equality_method = true
dotnet_style_prefer_simplified_boolean_expressions = true
dotnet_style_prefer_simplified_interpolation = true
# Field preferences
dotnet_style_readonly_field = true
# Parameter preferences
dotnet_code_quality_unused_parameters = all
# Suppression preferences
dotnet_remove_unnecessary_suppression_exclusions = 0
# New line preferences
dotnet_style_allow_multiple_blank_lines_experimental = false:suggestion
dotnet_style_allow_statement_immediately_after_block_experimental = false:suggestion
#### C# Coding Conventions ####
# var preferences
csharp_style_var_elsewhere = true:warning
csharp_style_var_for_built_in_types = true:warning
csharp_style_var_when_type_is_apparent = true:warning
# Expression-bodied members
csharp_style_expression_bodied_accessors = when_on_single_line:suggestion
csharp_style_expression_bodied_constructors = when_on_single_line:suggestion
csharp_style_expression_bodied_indexers = when_on_single_line:suggestion
csharp_style_expression_bodied_lambdas = when_on_single_line:suggestion
csharp_style_expression_bodied_local_functions = when_on_single_line:suggestion
csharp_style_expression_bodied_methods = when_on_single_line:suggestion
csharp_style_expression_bodied_operators = when_on_single_line:suggestion
csharp_style_expression_bodied_properties = when_on_single_line:suggestion
# Pattern matching preferences
csharp_style_pattern_matching_over_as_with_null_check = true
csharp_style_pattern_matching_over_is_with_cast_check = true
csharp_style_prefer_extended_property_pattern = true
csharp_style_prefer_not_pattern = true
csharp_style_prefer_pattern_matching = true:suggestion
csharp_style_prefer_switch_expression = true
# Null-checking preferences
csharp_style_conditional_delegate_call = true
# Modifier preferences
csharp_prefer_static_local_function = true
csharp_preferred_modifier_order = public,private,protected,internal,static,extern,new,virtual,abstract,sealed,override,readonly,unsafe,volatile,async
csharp_style_prefer_readonly_struct = true
# Code-block preferences
csharp_prefer_braces = when_multiline:suggestion
csharp_prefer_simple_using_statement = true
csharp_style_namespace_declarations = file_scoped:warning
csharp_style_prefer_method_group_conversion = true:suggestion
csharp_style_prefer_top_level_statements = false:suggestion
# Expression-level preferences
csharp_prefer_simple_default_expression = true
csharp_style_deconstructed_variable_declaration = true
csharp_style_implicit_object_creation_when_type_is_apparent = true
csharp_style_inlined_variable_declaration = true
csharp_style_prefer_index_operator = true
csharp_style_prefer_local_over_anonymous_function = true
csharp_style_prefer_null_check_over_type_check = true
csharp_style_prefer_range_operator = true
csharp_style_prefer_tuple_swap = true
csharp_style_prefer_utf8_string_literals = true
csharp_style_throw_expression = true
csharp_style_unused_value_assignment_preference = discard_variable
csharp_style_unused_value_expression_statement_preference = discard_variable:suggestion
# 'using' directive preferences
csharp_using_directive_placement = outside_namespace:suggestion
# New line preferences
csharp_style_allow_blank_line_after_colon_in_constructor_initializer_experimental = true:suggestion
csharp_style_allow_blank_lines_between_consecutive_braces_experimental = false:suggestion
csharp_style_allow_embedded_statements_on_same_line_experimental = false:suggestion
#### C# Formatting Rules ####
# New line preferences
csharp_new_line_before_catch = true
csharp_new_line_before_else = true
csharp_new_line_before_finally = true
csharp_new_line_before_members_in_anonymous_types = true
csharp_new_line_before_members_in_object_initializers = true
csharp_new_line_before_open_brace = all
csharp_new_line_between_query_expression_clauses = true
# Indentation preferences
csharp_indent_block_contents = true
csharp_indent_braces = false
csharp_indent_case_contents = true
csharp_indent_case_contents_when_block = true
csharp_indent_labels = no_change
csharp_indent_switch_labels = true
# Space preferences
csharp_space_after_cast = false
csharp_space_after_colon_in_inheritance_clause = true
csharp_space_after_comma = true
csharp_space_after_dot = false
csharp_space_after_keywords_in_control_flow_statements = true
csharp_space_after_semicolon_in_for_statement = true
csharp_space_around_binary_operators = before_and_after
csharp_space_around_declaration_statements = false
csharp_space_before_colon_in_inheritance_clause = true
csharp_space_before_comma = false
csharp_space_before_dot = false
csharp_space_before_open_square_brackets = false
csharp_space_before_semicolon_in_for_statement = false
csharp_space_between_empty_square_brackets = false
csharp_space_between_method_call_empty_parameter_list_parentheses = false
csharp_space_between_method_call_name_and_opening_parenthesis = false
csharp_space_between_method_call_parameter_list_parentheses = false
csharp_space_between_method_declaration_empty_parameter_list_parentheses = false
csharp_space_between_method_declaration_name_and_open_parenthesis = false
csharp_space_between_method_declaration_parameter_list_parentheses = false
csharp_space_between_parentheses = false
csharp_space_between_square_brackets = false
# Wrapping preferences
csharp_preserve_single_line_blocks = true
csharp_preserve_single_line_statements = true
#### Naming styles ####
# Naming rules
dotnet_naming_rule.interface_should_be_begins_with_i.severity = suggestion
dotnet_naming_rule.interface_should_be_begins_with_i.symbols = interface
dotnet_naming_rule.interface_should_be_begins_with_i.style = begins_with_i
dotnet_naming_rule.types_should_be_pascal_case.severity = suggestion
dotnet_naming_rule.types_should_be_pascal_case.symbols = types
dotnet_naming_rule.types_should_be_pascal_case.style = pascal_case
dotnet_naming_rule.non_field_members_should_be_pascal_case.severity = suggestion
dotnet_naming_rule.non_field_members_should_be_pascal_case.symbols = non_field_members
dotnet_naming_rule.non_field_members_should_be_pascal_case.style = pascal_case
# Symbol specifications
dotnet_naming_symbols.interface.applicable_kinds = interface
dotnet_naming_symbols.interface.applicable_accessibilities = public, internal, private, protected, protected_internal, private_protected
dotnet_naming_symbols.interface.required_modifiers =
dotnet_naming_symbols.types.applicable_kinds = class, struct, interface, enum
dotnet_naming_symbols.types.applicable_accessibilities = public, internal, private, protected, protected_internal, private_protected
dotnet_naming_symbols.types.required_modifiers =
dotnet_naming_symbols.non_field_members.applicable_kinds = property, event, method
dotnet_naming_symbols.non_field_members.applicable_accessibilities = public, internal, private, protected, protected_internal, private_protected
dotnet_naming_symbols.non_field_members.required_modifiers =
# Naming styles
dotnet_naming_style.pascal_case.required_prefix =
dotnet_naming_style.pascal_case.required_suffix =
dotnet_naming_style.pascal_case.word_separator =
dotnet_naming_style.pascal_case.capitalization = pascal_case
dotnet_naming_style.begins_with_i.required_prefix = I
dotnet_naming_style.begins_with_i.required_suffix =
dotnet_naming_style.begins_with_i.word_separator =
dotnet_naming_style.begins_with_i.capitalization = pascal_case

2
.gitignore vendored

@ -412,3 +412,5 @@ FodyWeavers.xsd
# Built Visual Studio Code Extensions
*.vsix
# Minified css files
**.min.css

@ -0,0 +1,31 @@

Microsoft Visual Studio Solution File, Format Version 12.00
# Visual Studio Version 17
VisualStudioVersion = 17.4.33020.496
MinimumVisualStudioVersion = 10.0.40219.1
Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Connected.Components", "src\connected.components\Connected.Components.csproj", "{70BF497D-6519-401B-A0EE-2E9856B13D96}"
EndProject
Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "Connected.Components.Showcase", "src\Connected.Components.Showcase\Connected.Components.Showcase.csproj", "{EBB24FD8-A554-427C-A93B-B48C047D34CC}"
EndProject
Global
GlobalSection(SolutionConfigurationPlatforms) = preSolution
Debug|Any CPU = Debug|Any CPU
Release|Any CPU = Release|Any CPU
EndGlobalSection
GlobalSection(ProjectConfigurationPlatforms) = postSolution
{70BF497D-6519-401B-A0EE-2E9856B13D96}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
{70BF497D-6519-401B-A0EE-2E9856B13D96}.Debug|Any CPU.Build.0 = Debug|Any CPU
{70BF497D-6519-401B-A0EE-2E9856B13D96}.Release|Any CPU.ActiveCfg = Release|Any CPU
{70BF497D-6519-401B-A0EE-2E9856B13D96}.Release|Any CPU.Build.0 = Release|Any CPU
{EBB24FD8-A554-427C-A93B-B48C047D34CC}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
{EBB24FD8-A554-427C-A93B-B48C047D34CC}.Debug|Any CPU.Build.0 = Debug|Any CPU
{EBB24FD8-A554-427C-A93B-B48C047D34CC}.Release|Any CPU.ActiveCfg = Release|Any CPU
{EBB24FD8-A554-427C-A93B-B48C047D34CC}.Release|Any CPU.Build.0 = Release|Any CPU
EndGlobalSection
GlobalSection(SolutionProperties) = preSolution
HideSolutionNode = FALSE
EndGlobalSection
GlobalSection(ExtensibilityGlobals) = postSolution
SolutionGuid = {CBDD97EC-4855-4005-97A7-29FE298FB057}
EndGlobalSection
EndGlobal

@ -0,0 +1,14 @@
<Project Sdk="Microsoft.NET.Sdk.Razor">
<PropertyGroup>
<TargetFramework>net7.0</TargetFramework>
<Nullable>enable</Nullable>
<ImplicitUsings>enable</ImplicitUsings>
</PropertyGroup>
<ItemGroup>
<PackageReference Include="Microsoft.AspNetCore.Components.WebAssembly" Version="7.0.0" />
<PackageReference Include="Microsoft.AspNetCore.Components.WebAssembly.DevServer" Version="7.0.0" PrivateAssets="all" />
</ItemGroup>
</Project>

@ -0,0 +1,5 @@
@inherits LayoutComponentBase
<main>
@Body
</main>

@ -0,0 +1,3 @@
@page "/"
<h1>Hello, world!</h1>

@ -0,0 +1,38 @@
{
"iisSettings": {
"iisExpress": {
"applicationUrl": "http://localhost:30375",
"sslPort": 44321
}
},
"profiles": {
"http": {
"commandName": "Project",
"dotnetRunMessages": true,
"launchBrowser": true,
"inspectUri": "{wsProtocol}://{url.hostname}:{url.port}/_framework/debug/ws-proxy?browser={browserInspectUri}",
"applicationUrl": "http://localhost:5035",
"environmentVariables": {
"ASPNETCORE_ENVIRONMENT": "Development"
}
},
"https": {
"commandName": "Project",
"dotnetRunMessages": true,
"launchBrowser": true,
"inspectUri": "{wsProtocol}://{url.hostname}:{url.port}/_framework/debug/ws-proxy?browser={browserInspectUri}",
"applicationUrl": "https://localhost:0;http://localhost:5035",
"environmentVariables": {
"ASPNETCORE_ENVIRONMENT": "Development"
}
},
"IIS Express": {
"commandName": "IISExpress",
"launchBrowser": true,
"inspectUri": "{wsProtocol}://{url.hostname}:{url.port}/_framework/debug/ws-proxy?browser={browserInspectUri}",
"environmentVariables": {
"ASPNETCORE_ENVIRONMENT": "Development"
}
}
}
}

@ -0,0 +1,7 @@
@using System.Net.Http
@using System.Net.Http.Json
@using Microsoft.AspNetCore.Components.Routing
@using Microsoft.AspNetCore.Components.Web
@using Microsoft.AspNetCore.Components.WebAssembly.Http
@using Microsoft.JSInterop
@using Connected.Components.Showcase

@ -0,0 +1,32 @@
h1:focus {
outline: none;
}
#blazor-error-ui {
background: lightyellow;
bottom: 0;
box-shadow: 0 -1px 2px rgba(0, 0, 0, 0.2);
display: none;
left: 0;
padding: 0.6rem 1.25rem 0.7rem 1.25rem;
position: fixed;
width: 100%;
z-index: 1000;
}
#blazor-error-ui .dismiss {
cursor: pointer;
position: absolute;
right: 0.75rem;
top: 0.5rem;
}
.blazor-error-boundary {
background: url(data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iNTYiIGhlaWdodD0iNDkiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgeG1sbnM6eGxpbms9Imh0dHA6Ly93d3cudzMub3JnLzE5OTkveGxpbmsiIG92ZXJmbG93PSJoaWRkZW4iPjxkZWZzPjxjbGlwUGF0aCBpZD0iY2xpcDAiPjxyZWN0IHg9IjIzNSIgeT0iNTEiIHdpZHRoPSI1NiIgaGVpZ2h0PSI0OSIvPjwvY2xpcFBhdGg+PC9kZWZzPjxnIGNsaXAtcGF0aD0idXJsKCNjbGlwMCkiIHRyYW5zZm9ybT0idHJhbnNsYXRlKC0yMzUgLTUxKSI+PHBhdGggZD0iTTI2My41MDYgNTFDMjY0LjcxNyA1MSAyNjUuODEzIDUxLjQ4MzcgMjY2LjYwNiA1Mi4yNjU4TDI2Ny4wNTIgNTIuNzk4NyAyNjcuNTM5IDUzLjYyODMgMjkwLjE4NSA5Mi4xODMxIDI5MC41NDUgOTIuNzk1IDI5MC42NTYgOTIuOTk2QzI5MC44NzcgOTMuNTEzIDI5MSA5NC4wODE1IDI5MSA5NC42NzgyIDI5MSA5Ny4wNjUxIDI4OS4wMzggOTkgMjg2LjYxNyA5OUwyNDAuMzgzIDk5QzIzNy45NjMgOTkgMjM2IDk3LjA2NTEgMjM2IDk0LjY3ODIgMjM2IDk0LjM3OTkgMjM2LjAzMSA5NC4wODg2IDIzNi4wODkgOTMuODA3MkwyMzYuMzM4IDkzLjAxNjIgMjM2Ljg1OCA5Mi4xMzE0IDI1OS40NzMgNTMuNjI5NCAyNTkuOTYxIDUyLjc5ODUgMjYwLjQwNyA1Mi4yNjU4QzI2MS4yIDUxLjQ4MzcgMjYyLjI5NiA1MSAyNjMuNTA2IDUxWk0yNjMuNTg2IDY2LjAxODNDMjYwLjczNyA2Ni4wMTgzIDI1OS4zMTMgNjcuMTI0NSAyNTkuMzEzIDY5LjMzNyAyNTkuMzEzIDY5LjYxMDIgMjU5LjMzMiA2OS44NjA4IDI1OS4zNzEgNzAuMDg4N0wyNjEuNzk1IDg0LjAxNjEgMjY1LjM4IDg0LjAxNjEgMjY3LjgyMSA2OS43NDc1QzI2Ny44NiA2OS43MzA5IDI2Ny44NzkgNjkuNTg3NyAyNjcuODc5IDY5LjMxNzkgMjY3Ljg3OSA2Ny4xMTgyIDI2Ni40NDggNjYuMDE4MyAyNjMuNTg2IDY2LjAxODNaTTI2My41NzYgODYuMDU0N0MyNjEuMDQ5IDg2LjA1NDcgMjU5Ljc4NiA4Ny4zMDA1IDI1OS43ODYgODkuNzkyMSAyNTkuNzg2IDkyLjI4MzcgMjYxLjA0OSA5My41Mjk1IDI2My41NzYgOTMuNTI5NSAyNjYuMTE2IDkzLjUyOTUgMjY3LjM4NyA5Mi4yODM3IDI2Ny4zODcgODkuNzkyMSAyNjcuMzg3IDg3LjMwMDUgMjY2LjExNiA4Ni4wNTQ3IDI2My41NzYgODYuMDU0N1oiIGZpbGw9IiNGRkU1MDAiIGZpbGwtcnVsZT0iZXZlbm9kZCIvPjwvZz48L3N2Zz4=) no-repeat 1rem/1.8rem, #b32121;
padding: 1rem 1rem 1rem 3.7rem;
color: white;
}
.blazor-error-boundary::after {
content: "An error has occurred."
}

@ -0,0 +1,21 @@
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8" />
<base href="/" />
<link href="css/app.css" rel="stylesheet" />
</head>
<body>
<div id="app">Loading...</div>
<div id="blazor-error-ui">
An unhandled error has occurred.
<a href="" class="reload">Reload</a>
<a class="dismiss">🗙</a>
</div>
<script src="_framework/blazor.webassembly.js"></script>
</body>
</html>

@ -0,0 +1,538 @@
namespace Connected.Annotations;
/// <summary>
/// Specifies the name of the category in which to group the property of a MudBlazor component when displayed in the API documentation.
/// </summary>
/// <remarks>
/// Use this attribute together with the <see cref="Microsoft.AspNetCore.Components.ParameterAttribute"/>. <br/>
/// This attribute is similar to <see cref="System.ComponentModel.CategoryAttribute"/>. <br/>
/// The name of the category can be specified by using a constant defined in the <see cref="CategoryTypes"/> class.
/// </remarks>
[AttributeUsage(AttributeTargets.Property, AllowMultiple = false, Inherited = true)]
public class CategoryAttribute : Attribute
{
public CategoryAttribute(string name)
{
if (string.IsNullOrEmpty(name))
throw new ArgumentException("The category name cannot be null nor empty.");
if (!categoryOrder.ContainsKey(name))
throw new ArgumentException($"The given category name '{name}' isn't in the categoryOrder field.");
Name = name;
}
/// <summary> The name of the category. </summary>
public string Name { get; }
/// <summary> The order of the category - the greater the number the lower the category will be displayed in the API documentation. </summary>
public int Order => categoryOrder[Name];
// Possible categories of component properties and the order in which they are displayed in the API documentation.
private static readonly Dictionary<string, int> categoryOrder = new()
{
["Data"] = 0, // general category
["Validation"] = 1, // general category
// specific categories associated with data
["Validated data"] = 2,
["Validation result"] = 3,
["Behavior"] = 100, // general category
["Header"] = 101,
["Rows"] = 102,
["Footer"] = 103,
// specific behaviors of a component
["Filtering"] = 200,
["Grouping"] = 201,
["Expanding"] = 202,
["Sorting"] = 203,
["Pagination"] = 204,
["Selecting"] = 205,
["Editing"] = 206,
["Click action"] = 207,
["Items"] = 208,
["Disable"] = 209,
["DraggingClass"] = 210,
["DropRules"] = 211,
["Appearance"] = 300, // general category
// specific parts of a component together with their behavior and appearance
["Popup behavior"] = 400,
["Popup appearance"] = 401,
["List behavior"] = 402,
["List appearance"] = 403,
["Picker behavior"] = 404,
["Picker appearance"] = 405,
["Dot"] = 406,
// "Miscellaneous" category. In classes inheriting from MudComponentBase it can be used only exceptionally -
// - only when the property can define behavior or appearance depending on value of the property.
["Misc"] = int.MaxValue - 1,
["Common"] = int.MaxValue // general category
};
}
/// <summary>
/// Possible categories of MudBlazor components properties.
/// </summary>
/// <remarks>
/// <b>General categories</b>
/// <para>
/// - <i>Data</i> - Used e.g. in form fields, pickers, <see cref="MudRating"/>, <see cref="MudTable{T}"/>, <see cref="MudTreeView{T}"/>,
/// <see cref="MudTreeViewItem{T}"/>, and <see cref="MudCarousel{TData}"/>. Containers have this group when their items can be defined
/// not only in markup language, but also programmatically in the Items property and by specifying ItemTemplate.<br/>
/// - <i>Validation</i> - Used in form fields and pickers.<br/>
/// - <i>Behavior</i> - Changing these properties changes behavior of the component and behavior of the application. So in some way they are or may be more
/// important than the "Appearance" category. Example properties are: a) the <c>Disabled</c> property, b) icons (or avatars) without default value
/// (because setting their value can pass additional information).<br/>
/// - <i>Appearance</i> - Changing these properties doesn't change behavior of the component and behavior of the application, but only changes the appearance
/// of the component irrelevant to the understanding of the application by a user. So in some way they are less important than the "Behavior"
/// category, because they are only used to adjust the look of the application. Example properties are: a) <c>Elevation</c>, <c>Outlined</c>,
/// <c>Square</c>, <c>Rounded</c>, <c>DisableGutters</c>, <c>Dense</c>, <c>DisableRipple</c>; b) size, color, and typography of the item
/// and its subelements; c) CSS classes and styles of subelements; d) icons with the default value already set (because most often changing its value
/// doesn't change passed information).<br/>
/// - <i>Common</i> - Properties defined in <see cref="UIComponent"/>.
/// </para>
/// <para>
/// Note: The following properties belong to the "Behavior" group, not to the "Appearance" group:<br/>
/// - <see cref="IconButton.Icon"/> - because it describes meaning of the button, since MudIconButton doesn't have text,<br/>
/// - <see cref="InputBase{T}.Label"/> - because it describes meaning of the field,<br/>
/// - <see cref="InputBase{T}.AdornmentText"/> - because it can describe information important to a user, e.g. a numeric field unit such as kilograms.<br/>
/// Sometimes choosing a category can be difficult - in such case choose a category that makes the most sense.
/// </para>
///
/// <b>Categories for specific behaviors or specific parts of components</b>
/// <para>If some elements or behaviors can be distinguished in a component, then their properties are included in separate groups.</para>
///
/// <para>Note: If a property qualifies for both the "Appearance" or "Behavior" group, and for some special group, then this special group takes precedence.
/// For example, <see cref="MudTableBase.CommitEditIcon"/> could belong to the "Appearance" group, but belongs to the "Editing" group.</para>
///
/// <b>Additional information</b>
/// <para>The list of categories is inspired by the categories displayed for Windows Forms and Web Forms components in the Visual Studio "Properties" window.</para>
/// </remarks>
public static class CategoryTypes
{
/* Implementation note:
* Almost all components use the "Behavior" and "Appearance" categories. We could simplify the code
* by inheriting these constants, but C# doesn't allow to inherit static members of a class.
*/
/// <summary>Used in <see cref="UIComponent"/>.</summary>
public static class ComponentBase
{
public const string Common = "Common";
}
/// <summary>Used in: <see cref="ButtonBase"/>, all components inheriting from it, and <see cref="MudToggleIconButton"/>.</summary>
public static class Button
{
public const string Behavior = "Behavior";
public const string ClickAction = "Click action";
public const string Appearance = "Appearance";
}
/// <summary>Used in <see cref="FormComponent{T, U}"/> and all components inheriting from it.</summary>
public static class FormComponent
{
public const string Data = "Data";
public const string Validation = "Validation";
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
public const string ListBehavior = "List behavior";
public const string ListAppearance = "List appearance";
public const string PickerBehavior = "Picker behavior";
public const string PickerAppearance = "Picker appearance";
}
/// <summary>Used in all charts, that is in <see cref="MudChartBase"/> and all components inheriting from it.</summary>
public static class Chart
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
/// <summary>Used in other base classes.</summary>
public static class General
{
public const string Data = "Data";
public const string Behavior = "Behavior";
public const string ClickAction = "Click action";
public const string Appearance = "Appearance";
}
public static class Alert
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class AppBar
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class Avatar
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class AvatarGroup
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class Badge
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class Breadcrumbs
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class BreakpointProvider
{
public const string Behavior = "Behavior";
}
public static class ButtonGroup
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class Card
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class Carousel
{
public const string Data = "Data";
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class Chip
{
public const string Behavior = "Behavior";
public const string ClickAction = "Click action";
public const string Appearance = "Appearance";
}
public static class ChipSet
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class Container
{
public const string Behavior = "Behavior";
}
public static class Dialog
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
public const string Misc = "Misc";
}
public static class Divider
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class Drawer
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class DropZone
{
public const string Appearance = "Appearance";
public const string Behavior = "Behavior";
public const string Disabled = "Disable";
public const string Sorting = "Sorting";
public const string DraggingClass = "DraggingClass";
public const string DropRules = "DropRules";
public const string Items = "Items";
}
public static class Element
{
public const string Misc = "Misc";
}
public static class ExpansionPanel
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class Field
{
public const string Data = "Data";
public const string Validation = "Validation";
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class FileUpload
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class FocusTrap
{
public const string Behavior = "Behavior";
}
public static class Form
{
public const string ValidatedData = "Validated data";
public const string ValidationResult = "Validation result";
public const string Behavior = "Behavior";
}
public static class Grid
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class Highlighter
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class Image
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class Item
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class Hidden
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class Icon
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class Link
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class List
{
public const string Behavior = "Behavior";
public const string Expanding = "Expanding";
public const string Selecting = "Selecting";
public const string ClickAction = "Click action";
public const string Appearance = "Appearance";
}
public static class MainContent
{
public const string Behavior = "Behavior";
}
public static class Menu
{
public const string Behavior = "Behavior";
public const string ClickAction = "Click action";
public const string Appearance = "Appearance";
public const string PopupBehavior = "Popup behavior";
public const string PopupAppearance = "Popup appearance";
}
public static class MessageBox
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class NavMenu
{
public const string Behavior = "Behavior";
public const string ClickAction = "Click action";
public const string Appearance = "Appearance";
}
public static class Overlay
{
public const string Behavior = "Behavior";
public const string ClickAction = "Click action";
}
public static class Pagination
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class Paper
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class Popover
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class ProgressLinear
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class ProgressCircular
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class Radio
{
public const string Data = "Data";
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class Rating
{
public const string Data = "Data";
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class RTLProvider
{
public const string Behavior = "Behavior";
}
public static class ScrollToTop
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class Skeleton
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class Stack
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class Slider
{
public const string Data = "Data";
public const string Validation = "Validation";
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class SwipeArea
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class Table
{
public const string Data = "Data";
public const string Behavior = "Behavior";
public const string Header = "Header";
public const string Rows = "Rows";
public const string Footer = "Footer";
public const string Filtering = "Filtering";
public const string Grouping = "Grouping";
public const string Sorting = "Sorting";
public const string Pagination = "Pagination";
public const string Selecting = "Selecting";
public const string Editing = "Editing";
public const string Appearance = "Appearance";
}
public static class SimpleTable
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class Tabs
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class Timeline
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
public const string Dot = "Dot";
}
public static class ToolBar
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class Tooltip
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
public static class TreeView
{
public const string Data = "Data";
public const string Behavior = "Behavior";
public const string Expanding = "Expanding";
public const string Selecting = "Selecting";
public const string ClickAction = "Click action";
public const string Appearance = "Appearance";
}
public static class Text
{
public const string Behavior = "Behavior";
public const string Appearance = "Appearance";
}
}

@ -0,0 +1,12 @@
namespace Connected.Annotations;
[AttributeUsage(AttributeTargets.Property | AttributeTargets.Field, AllowMultiple = false)]
public class LabelAttribute : Attribute
{
public LabelAttribute(string name)
{
Name = name;
}
public string Name { get; }
}

@ -0,0 +1,343 @@
using System.Diagnostics.CodeAnalysis;
namespace Connected;
[ExcludeFromCodeCoverage]
public static class Colors
{
public static partial class Red
{
public static string Default { get; } = "#F44336";
public static string Lighten5 { get; } = "#FFEBEE";
public static string Lighten4 { get; } = "#FFCDD2";
public static string Lighten3 { get; } = "#EF9A9A";
public static string Lighten2 { get; } = "#E57373";
public static string Lighten1 { get; } = "#EF5350";
public static string Darken1 { get; } = "#E53935";
public static string Darken2 { get; } = "#D32F2F";
public static string Darken3 { get; } = "#C62828";
public static string Darken4 { get; } = "#B71C1C";
public static string Accent1 { get; } = "#FF8A80";
public static string Accent2 { get; } = "#FF5252";
public static string Accent3 { get; } = "#FF1744";
public static string Accent4 { get; } = "#D50000";
}
public static class Pink
{
public static string Default { get; } = "#E91E63";
public static string Lighten5 { get; } = "#FCE4EC";
public static string Lighten4 { get; } = "#F8BBD0";
public static string Lighten3 { get; } = "#F48FB1";
public static string Lighten2 { get; } = "#F06292";
public static string Lighten1 { get; } = "#EC407A";
public static string Darken1 { get; } = "#D81B60";
public static string Darken2 { get; } = "#C2185B";
public static string Darken3 { get; } = "#AD1457";
public static string Darken4 { get; } = "#880E4F";
public static string Accent1 { get; } = "#FF80AB";
public static string Accent2 { get; } = "#FF4081";
public static string Accent3 { get; } = "#F50057";
public static string Accent4 { get; } = "#C51162";
}
public static class Purple
{
public static string Default { get; } = "#9C27B0";
public static string Lighten5 { get; } = "#F3E5F5";
public static string Lighten4 { get; } = "#E1BEE7";
public static string Lighten3 { get; } = "#CE93D8";
public static string Lighten2 { get; } = "#BA68C8";
public static string Lighten1 { get; } = "#AB47BC";
public static string Darken1 { get; } = "#8E24AA";
public static string Darken2 { get; } = "#7B1FA2";
public static string Darken3 { get; } = "#6A1B9A";
public static string Darken4 { get; } = "#4A148C";
public static string Accent1 { get; } = "#EA80FC";
public static string Accent2 { get; } = "#E040FB";
public static string Accent3 { get; } = "#D500F9";
public static string Accent4 { get; } = "#AA00FF";
}
public static class DeepPurple
{
public static string Default { get; } = "#673AB7";
public static string Lighten5 { get; } = "#EDE7F6";
public static string Lighten4 { get; } = "#D1C4E9";
public static string Lighten3 { get; } = "#B39DDB";
public static string Lighten2 { get; } = "#9575CD";
public static string Lighten1 { get; } = "#7E57C2";
public static string Darken1 { get; } = "#5E35B1";
public static string Darken2 { get; } = "#512DA8";
public static string Darken3 { get; } = "#4527A0";
public static string Darken4 { get; } = "#311B92";
public static string Accent1 { get; } = "#B388FF";
public static string Accent2 { get; } = "#7C4DFF";
public static string Accent3 { get; } = "#651FFF";
public static string Accent4 { get; } = "#6200EA";
}
public static class Indigo
{
public static string Default { get; } = "#3F51B5";
public static string Lighten5 { get; } = "#E8EAF6";
public static string Lighten4 { get; } = "#C5CAE9";
public static string Lighten3 { get; } = "#9FA8DA";
public static string Lighten2 { get; } = "#7986CB";
public static string Lighten1 { get; } = "#5C6BC0";
public static string Darken1 { get; } = "#3949AB";
public static string Darken2 { get; } = "#303F9F";
public static string Darken3 { get; } = "#283593";
public static string Darken4 { get; } = "#1A237E";
public static string Accent1 { get; } = "#8C9EFF";
public static string Accent2 { get; } = "#536DFE";
public static string Accent3 { get; } = "#3D5AFE";
public static string Accent4 { get; } = "#304FFE";
}
public static class Blue
{
public static string Default { get; } = "#2196F3";
public static string Lighten5 { get; } = "#E3F2FD";
public static string Lighten4 { get; } = "#BBDEFB";
public static string Lighten3 { get; } = "#90CAF9";
public static string Lighten2 { get; } = "#64B5F6";
public static string Lighten1 { get; } = "#42A5F5";
public static string Darken1 { get; } = "#1E88E5";
public static string Darken2 { get; } = "#1976D2";
public static string Darken3 { get; } = "#1565C0";
public static string Darken4 { get; } = "#0D47A1";
public static string Accent1 { get; } = "#82B1FF";
public static string Accent2 { get; } = "#448AFF";
public static string Accent3 { get; } = "#2979FF";
public static string Accent4 { get; } = "#2962FF";
}
public static class LightBlue
{
public static string Default { get; } = "#03A9F4";
public static string Lighten5 { get; } = "#E1F5FE";
public static string Lighten4 { get; } = "#B3E5FC";
public static string Lighten3 { get; } = "#81D4FA";
public static string Lighten2 { get; } = "#4FC3F7";
public static string Lighten1 { get; } = "#29B6F6";
public static string Darken1 { get; } = "#039BE5";
public static string Darken2 { get; } = "#0288D1";
public static string Darken3 { get; } = "#0277BD";
public static string Darken4 { get; } = "#01579B";
public static string Accent1 { get; } = "#80D8FF";
public static string Accent2 { get; } = "#40C4FF";
public static string Accent3 { get; } = "#00B0FF";
public static string Accent4 { get; } = "#0091EA";
}
public static class Cyan
{
public static string Default { get; } = "#00BCD4";
public static string Lighten5 { get; } = "#E0F7FA";
public static string Lighten4 { get; } = "#B2EBF2";
public static string Lighten3 { get; } = "#80DEEA";
public static string Lighten2 { get; } = "#4DD0E1";
public static string Lighten1 { get; } = "#26C6DA";
public static string Darken1 { get; } = "#00ACC1";
public static string Darken2 { get; } = "#0097A7";
public static string Darken3 { get; } = "#00838F";
public static string Darken4 { get; } = "#006064";
public static string Accent1 { get; } = "#84FFFF";
public static string Accent2 { get; } = "#18FFFF";
public static string Accent3 { get; } = "#00E5FF";
public static string Accent4 { get; } = "#00B8D4";
}
public static class Teal
{
public static string Default { get; } = "#009688";
public static string Lighten5 { get; } = "#E0F2F1";
public static string Lighten4 { get; } = "#B2DFDB";
public static string Lighten3 { get; } = "#80CBC4";
public static string Lighten2 { get; } = "#4DB6AC";
public static string Lighten1 { get; } = "#26A69A";
public static string Darken1 { get; } = "#00897B";
public static string Darken2 { get; } = "#00796B";
public static string Darken3 { get; } = "#00695C";
public static string Darken4 { get; } = "#004D40";
public static string Accent1 { get; } = "#A7FFEB";
public static string Accent2 { get; } = "#64FFDA";
public static string Accent3 { get; } = "#1DE9B6";
public static string Accent4 { get; } = "#00BFA5";
}
public static class Green
{
public static string Default { get; } = "#4CAF50";
public static string Lighten5 { get; } = "#E8F5E9";
public static string Lighten4 { get; } = "#C8E6C9";
public static string Lighten3 { get; } = "#A5D6A7";
public static string Lighten2 { get; } = "#81C784";
public static string Lighten1 { get; } = "#66BB6A";
public static string Darken1 { get; } = "#43A047";
public static string Darken2 { get; } = "#388E3C";
public static string Darken3 { get; } = "#2E7D32";
public static string Darken4 { get; } = "#1B5E20";
public static string Accent1 { get; } = "#B9F6CA";
public static string Accent2 { get; } = "#69F0AE";
public static string Accent3 { get; } = "#00E676";
public static string Accent4 { get; } = "#00C853";
}
public static class LightGreen
{
public static string Default { get; } = "#8BC34A";
public static string Lighten5 { get; } = "#F1F8E9";
public static string Lighten4 { get; } = "#DCEDC8";
public static string Lighten3 { get; } = "#C5E1A5";
public static string Lighten2 { get; } = "#AED581";
public static string Lighten1 { get; } = "#9CCC65";
public static string Darken1 { get; } = "#7CB342";
public static string Darken2 { get; } = "#689F38";
public static string Darken3 { get; } = "#558B2F";
public static string Darken4 { get; } = "#33691E";
public static string Accent1 { get; } = "#CCFF90";
public static string Accent2 { get; } = "#B2FF59";
public static string Accent3 { get; } = "#76FF03";
public static string Accent4 { get; } = "#64DD17";
}
public static class Lime
{
public static string Default { get; } = "#CDDC39";
public static string Lighten5 { get; } = "#F9FBE7";
public static string Lighten4 { get; } = "#F0F4C3";
public static string Lighten3 { get; } = "#E6EE9C";
public static string Lighten2 { get; } = "#DCE775";
public static string Lighten1 { get; } = "#D4E157";
public static string Darken1 { get; } = "#C0CA33";
public static string Darken2 { get; } = "#AFB42B";
public static string Darken3 { get; } = "#9E9D24";
public static string Darken4 { get; } = "#827717";
public static string Accent1 { get; } = "#F4FF81";
public static string Accent2 { get; } = "#EEFF41";
public static string Accent3 { get; } = "#C6FF00";
public static string Accent4 { get; } = "#AEEA00";
}
public static class Yellow
{
public static string Default { get; } = "#FFEB3B";
public static string Lighten5 { get; } = "#FFFDE7";
public static string Lighten4 { get; } = "#FFF9C4";
public static string Lighten3 { get; } = "#FFF59D";
public static string Lighten2 { get; } = "#FFF176";
public static string Lighten1 { get; } = "#FFEE58";
public static string Darken1 { get; } = "#FDD835";
public static string Darken2 { get; } = "#FBC02D";
public static string Darken3 { get; } = "#F9A825";
public static string Darken4 { get; } = "#F57F17";
public static string Accent1 { get; } = "#FFFF8D";
public static string Accent2 { get; } = "#FFFF00";
public static string Accent3 { get; } = "#FFEA00";
public static string Accent4 { get; } = "#FFD600";
}
public static class Amber
{
public static string Default { get; } = "#FFC107";
public static string Lighten5 { get; } = "#FFF8E1";
public static string Lighten4 { get; } = "#FFECB3";
public static string Lighten3 { get; } = "#FFE082";
public static string Lighten2 { get; } = "#FFD54F";
public static string Lighten1 { get; } = "#FFCA28";
public static string Darken1 { get; } = "#FFB300";
public static string Darken2 { get; } = "#FFA000";
public static string Darken3 { get; } = "#FF8F00";
public static string Darken4 { get; } = "#FF6F00";
public static string Accent1 { get; } = "#FFE57F";
public static string Accent2 { get; } = "#FFD740";
public static string Accent3 { get; } = "#FFC400";
public static string Accent4 { get; } = "#FFAB00";
}
public static class Orange
{
public static string Default { get; } = "#FF9800";
public static string Lighten5 { get; } = "#FFF3E0";
public static string Lighten4 { get; } = "#FFE0B2";
public static string Lighten3 { get; } = "#FFCC80";
public static string Lighten2 { get; } = "#FFB74D";
public static string Lighten1 { get; } = "#FFA726";
public static string Darken1 { get; } = "#FB8C00";
public static string Darken2 { get; } = "#F57C00";
public static string Darken3 { get; } = "#EF6C00";
public static string Darken4 { get; } = "#E65100";
public static string Accent1 { get; } = "#FFD180";
public static string Accent2 { get; } = "#FFAB40";
public static string Accent3 { get; } = "#FF9100";
public static string Accent4 { get; } = "#FF6D00";
}
public static class DeepOrange
{
public static string Default { get; } = "#FF5722";
public static string Lighten5 { get; } = "#FBE9E7";
public static string Lighten4 { get; } = "#FFCCBC";
public static string Lighten3 { get; } = "#FFAB91";
public static string Lighten2 { get; } = "#FF8A65";
public static string Lighten1 { get; } = "#FF7043";
public static string Darken1 { get; } = "#F4511E";
public static string Darken2 { get; } = "#E64A19";
public static string Darken3 { get; } = "#D84315";
public static string Darken4 { get; } = "#BF360C";
public static string Accent1 { get; } = "#FF9E80";
public static string Accent2 { get; } = "#FF6E40";
public static string Accent3 { get; } = "#FF3D00";
public static string Accent4 { get; } = "#DD2C00";
}
public static class Brown
{
public static string Default { get; } = "#795548";
public static string Lighten5 { get; } = "#EFEBE9";
public static string Lighten4 { get; } = "#D7CCC8";
public static string Lighten3 { get; } = "#BCAAA4";
public static string Lighten2 { get; } = "#A1887F";
public static string Lighten1 { get; } = "#8D6E63";
public static string Darken1 { get; } = "#6D4C41";
public static string Darken2 { get; } = "#5D4037";
public static string Darken3 { get; } = "#4E342E";
public static string Darken4 { get; } = "#3E2723";
}
public static class BlueGrey
{
public static string Default { get; } = "#607D8B";
public static string Lighten5 { get; } = "#ECEFF1";
public static string Lighten4 { get; } = "#CFD8DC";
public static string Lighten3 { get; } = "#B0BEC5";
public static string Lighten2 { get; } = "#90A4AE";
public static string Lighten1 { get; } = "#78909C";
public static string Darken1 { get; } = "#546E7A";
public static string Darken2 { get; } = "#455A64";
public static string Darken3 { get; } = "#37474F";
public static string Darken4 { get; } = "#263238";
}
public static class Grey
{
public static string Default { get; } = "#9E9E9E";
public static string Lighten5 { get; } = "#FAFAFA";
public static string Lighten4 { get; } = "#F5F5F5";
public static string Lighten3 { get; } = "#EEEEEE";
public static string Lighten2 { get; } = "#E0E0E0";
public static string Lighten1 { get; } = "#BDBDBD";
public static string Darken1 { get; } = "#757575";
public static string Darken2 { get; } = "#616161";
public static string Darken3 { get; } = "#424242";
public static string Darken4 { get; } = "#212121";
}
public static class Shades
{
public static string Black { get; } = "#000000";
public static string White { get; } = "#FFFFFF";
public static string Transparent { get; } = "transparent";
}
}

@ -0,0 +1,26 @@
@namespace Connected.Components
@inherits UIComponent
<div @attributes="UserAttributes" role="alert" class="@ClassList" Style="@Style" @onclick="OnClick">
<div class="@ClassPosition">
@if (!GlyphVisible)
{
<div class="alert-icon alert-icon-left">
<Icon Glyph="@Glyph" />
</div>
}
<div class="alert-message">
@ChildContent
</div>
</div>
@if (CloseGlyphVisible)
{
<div class="alert-close">
<ToggleIconButton Glyph="@CloseGlyph" @onclick="OnCloseGlyphClick" Size="Size.Small" />
</div>
}
</div>

@ -0,0 +1,143 @@
using System.Diagnostics.CodeAnalysis;
using Connected.Extensions;
using Connected.Utilities;
using Microsoft.AspNetCore.Components;
using Microsoft.AspNetCore.Components.Web;
namespace Connected.Components;
public partial class Alert : UIComponent
{
[CascadingParameter(Name = "RightToLeft")]
public bool RightToLeft { get; set; }
/// <summary>
/// Sets the position of the text to the start (Left in LTR and right in RTL).
/// </summary>
[Parameter]
public HorizontalAlignment Alignment { get; set; } = HorizontalAlignment.Left;
/// <summary>
/// The callback, when the close button has been clicked.
/// </summary>
[Parameter] public EventCallback<Alert> CloseGlyphClicked { get; set; }
/// <summary>
/// Define the icon used for the close button.
/// </summary>
[Parameter]
public string CloseGlyph { get; set; } = Icons.Material.Filled.Close;
/// <summary>
/// Sets if the alert shows a close icon.
/// </summary>
[Parameter]
public bool CloseGlyphVisible { get; set; }
/// <summary>
/// The higher the number, the heavier the drop-shadow. 0 for no shadow.
/// </summary>
[Parameter]
public int Elevation { set; get; } = 0;
/// <summary>
/// If true, rounded corners are disabled.
/// </summary>
[Parameter]
public bool Square { get; set; }
/// <summary>
/// If true, compact padding will be used.
/// </summary>
[Parameter]
public bool Dense { get; set; }
/// <summary>
/// If true, no alert icon will be used.
/// </summary>
[Parameter]
public bool GlyphVisible { get; set; }
/// <summary>
/// The severity of the alert. This defines the color and icon used.
/// </summary>
[Parameter]
public Severity Severity { get; set; } = Severity.Normal;
/// <summary>
/// The variant to use.
/// </summary>
[Parameter]
public Variant Variant { get; set; } = Variant.Text;
/// <summary>
/// Child content of the component.
/// </summary>
[Parameter]
public RenderFragment? ChildContent { get; set; }
/// <summary>
/// Custom icon, leave unset to use the standard icon which depends on the Severity
/// </summary>
[Parameter]
public string Glyph { get; set; } = default!;
/// <summary>
/// Raised when the alert is clicked
/// </summary>
[Parameter]
public EventCallback<MouseEventArgs> OnClick { get; set; }
protected string ClassList
{
get
{
return new CssBuilder("alert")
.AddClass($"alert-{Variant.ToDescriptionString()}-{Severity.ToDescriptionString()}")
.AddClass($"dense", Dense)
.AddClass($"square", Square)
.AddClass($"elevation-{Elevation}")
.AddClass(Class)
.Build();
}
}
protected string ClassPosition
{
get
{
return new CssBuilder("alert-position")
.AddClass($"justify-sm-{ConvertHorizontalAlignment(Alignment).ToDescriptionString()}")
.Build();
}
}
private HorizontalAlignment ConvertHorizontalAlignment(HorizontalAlignment contentAlignment)
{
return contentAlignment switch
{
HorizontalAlignment.Right => RightToLeft ? HorizontalAlignment.Start : HorizontalAlignment.End,
HorizontalAlignment.Left => RightToLeft ? HorizontalAlignment.End : HorizontalAlignment.Start,
_ => contentAlignment
};
}
internal async Task OnCloseGlyphClick()
{
if (CloseGlyphClicked.HasDelegate)
{
await CloseGlyphClicked.InvokeAsync(this);
return;
}
await Task.CompletedTask;
}
//If we can check this exception can include the coverage again
[ExcludeFromCodeCoverage]
protected override void OnParametersSet()
{
if (!string.IsNullOrEmpty(Glyph))
return;
Glyph = Severity switch
{
Severity.Normal => Icons.Material.Outlined.EventNote,
Severity.Info => Icons.Material.Outlined.Info,
Severity.Success => Icons.Custom.Uncategorized.AlertSuccess,
Severity.Warning => Icons.Material.Outlined.ReportProblem,
Severity.Error => Icons.Material.Filled.ErrorOutline,
_ => throw new ArgumentOutOfRangeException(nameof(Severity)),
};
}
}

@ -0,0 +1,10 @@
@namespace Connected.Components
@inherits UIComponent
<header @attributes="UserAttributes" class="@ClassList" style="@Style">
<ToolBar Dense="@Dense" DisableGutters="@DisableGutters" Class="@ToolBarClassList()">
@ChildContent
</ToolBar>
</header>

@ -0,0 +1,75 @@
using Connected.Extensions;
using Connected.Utilities;
using Microsoft.AspNetCore.Components;
namespace Connected.Components;
public partial class AppBar : UIComponent
{
/// <summary>
/// If true, Appbar will be placed at the bottom of the screen.
/// </summary>
[Parameter]
public bool Bottom { get; set; }
/// <summary>
/// The higher the number, the heavier the drop-shadow. 0 for no shadow.
/// </summary>
[Parameter]
public int Elevation { set; get; } = 4;
/// <summary>
/// If true, compact padding will be used.
/// </summary>
[Parameter]
public bool Dense { get; set; }
/// <summary>
/// If true, the left and right padding is removed from from the appbar.
/// </summary>
[Parameter]
public bool DisableGutters { get; set; }
/// <summary>
/// The color of the component. It supports the theme colors.
/// </summary>
[Parameter]
public ThemeColor Color { get; set; } = ThemeColor.Default;
/// <summary>
/// If true, appbar will be Fixed.
/// </summary>
[Parameter]
public bool Fixed { get; set; } = true;
/// <summary>
/// User class names, separated by spaces for the nested toolbar.
/// </summary>
[Parameter]
public string? ToolBarClass { get; set; }
/// <summary>
/// Child content of the component.
/// </summary>
[Parameter]
public RenderFragment? ChildContent { get; set; }
protected string ClassList()
{
return new CssBuilder("appbar")
.AddClass($"appbar-dense", Dense)
.AddClass($"appbar-fixed-top", Fixed && !Bottom)
.AddClass($"appbar-fixed-bottom", Fixed && Bottom)
.AddClass($"elevation-{Elevation}")
.AddClass($"theme-{Color.ToDescriptionString()}", Color != ThemeColor.Default)
.AddClass(Class)
.Build();
}
protected string ToolBarClassList()
{
return new CssBuilder("toolbar-appbar")
.AddClass(ToolBarClass)
.Build();
}
}

@ -0,0 +1,96 @@
@namespace Connected.Components
@inherits InputBase<T>
@typeparam T
<CascadingValue Name="SubscribeToParentForm" Value="false" IsFixed="true">
<div class="@AutocompleteClassList">
<InputControl Label="@Label" Variant="@Variant" HelperText="@HelperText" HelperTextOnFocus="@HelperTextOnFocus" FullWidth="@FullWidth" Margin="@Margin" Class="@ClassList()" Style="@Style"
Error="@HasError" ErrorText="@ErrorText" Disabled="@Disabled" @onclick="@ToggleMenu" Required="@Required" ForId="@FieldId">
<InputContent>
<Input @ref="_elementReference" @key="_elementKey" InputType="InputType.Text"
Class="select-input" Margin="@Margin"
Variant="@Variant"
TextUpdateSuppression="@TextUpdateSuppression"
Value="@Text" DisableUnderLine="@DisableUnderLine"
Disabled="@Disabled" ReadOnly="@ReadOnly" Error="@HasError"
OnAdornmentClick="@OnAdornmentClick" AdornmentIcon="@CurrentIcon" Adornment="@Adornment" AdornmentColor="@AdornmentColor" IconSize="@IconSize" AdornmentText="@AdornmentText"
Clearable="@Clearable" OnClearButtonClick="@OnClearButtonClick"
@attributes="UserAttributes"
TextChanged="OnTextChanged" OnBlur="OnInputBlurred"
OnKeyDown="@this.OnInputKeyDown"
OnKeyUp="@this.OnInputKeyUp" autocomplete=@("disabled-"+Guid.NewGuid()) KeyUpPreventDefault="KeyUpPreventDefault"
Placeholder="@Placeholder" Immediate="true"
InputMode="@InputMode" Pattern="@Pattern"
T="string" />
@if (ShowProgressIndicator && IsLoading)
{
@if (ProgressIndicatorTemplate is not null)
{
@ProgressIndicatorTemplate
}
else
{
<div class="@CircularProgressClassList">
<ProgressCircular Color="ProgressIndicatorColor" Indeterminate="true" Size="Size.Small"/>
</div>
}
}
<Popover Open="@IsOpen" MaxHeight="@MaxHeight" AnchorOrigin="@AnchorOrigin" TransformOrigin="@TransformOrigin" Class="@PopoverClass" RelativeWidth="true">
@if(ProgressIndicatorInPopoverTemplate != null && IsLoading)
{
@ProgressIndicatorInPopoverTemplate
}
else if (_items != null && _items.Length != 0)
{
<List Clickable="true" Dense="@Dense">
@for (var index = 0; index < _items.Length; index++)
{
var item = _items[index];
bool is_selected = index == _selectedListItemIndex;
bool is_disabled = !_enabledItemIndices.Contains(index);
<ListItem @key="@item" id="@GetListItemId(index)" Disabled="@(is_disabled)" OnClick="@(async() => await ListItemOnClick(item))" OnClickHandlerPreventDefault="true" Class="@(is_selected ? "selected-item primary-text primary-hover" : "")">
@if (ItemTemplate == null)
{
@GetItemString(item)
}
else if (is_disabled && ItemDisabledTemplate is not null)
{
@ItemDisabledTemplate(item)
}
else if (is_selected)
{
@if (ItemSelectedTemplate is null)
@ItemTemplate(item)
else
@ItemSelectedTemplate(item)
}
else
{
@ItemTemplate(item)
}
</ListItem>
}
@if (MoreItemsTemplate is not null && _itemsReturned > MaxItems)
{
<div class="pa-1">
@MoreItemsTemplate
</div>
}
</List>
}
else if (NoItemsTemplate is not null)
{
<div class="pa-1">
@NoItemsTemplate
</div>
}
</Popover>
</InputContent>
</InputControl>
</div>
</CascadingValue>
<Overlay Visible="IsOpen" OnClick="@ToggleMenu" @ontouchstart="@ToggleMenu" LockScroll="false" />

@ -0,0 +1,693 @@
using Connected.Utilities;
using Microsoft.AspNetCore.Components;
using Microsoft.AspNetCore.Components.Web;
namespace Connected.Components;
public partial class Autocomplete<T> : InputBase<T>, IDisposable
{
private Func<T, string>? _toStringFunc;
private Task _currentSearchTask;
private CancellationTokenSource _cancellationTokenSrc;
private bool _isOpen;
private Timer _timer;
private T[] _items;
private int _selectedListItemIndex = 0;
private IList<int> _enabledItemIndices = new List<int>();
private int _itemsReturned; //the number of items returned by the search function
int _elementKey = 0;
/// <summary>
/// This boolean will keep track if the clear function is called too keep the set text function to be called.
/// </summary>
private bool _isCleared;
private Input<string> _elementReference;
/// <summary>
/// We need a random id for the year items in the year list so we can scroll to the item safely in every DatePicker.
/// </summary>
private readonly string _componentId = Guid.NewGuid().ToString();
public Autocomplete()
{
Adornment = Adornment.End;
IconSize = Size.Medium;
}
[Inject]
IScrollManager ScrollManager { get; set; }
/// <summary>
/// User class names for the popover, separated by space
/// </summary>
[Parameter]
public string PopoverClass { get; set; }
/// <summary>
/// Set the anchor origin point to determen where the popover will open from.
/// </summary>
[Parameter]
public Origin AnchorOrigin { get; set; } = Origin.BottomCenter;
/// <summary>
/// Sets the transform origin point for the popover.
/// </summary>
[Parameter]
public Origin TransformOrigin { get; set; } = Origin.TopCenter;
/// <summary>
/// If true, compact vertical padding will be applied to all Autocomplete items.
/// </summary>
[Parameter]
public bool Dense { get; set; }
/// <summary>
/// The Open Autocomplete Icon
/// </summary>
[Parameter]
public string OpenIcon { get; set; } = Icons.Material.Filled.ArrowDropDown;
/// <summary>
/// The Close Autocomplete Icon
/// </summary>
[Parameter]
public string CloseIcon { get; set; } = Icons.Material.Filled.ArrowDropUp;
/// <summary>
/// The maximum height of the Autocomplete when it is open.
/// </summary>
[Parameter]
public int MaxHeight { get; set; } = 300;
/// <summary>
/// Defines how values are displayed in the drop-down list
/// </summary>
[Parameter]
public Func<T, string>? ToStringFunc
{
get => _toStringFunc;
set
{
if (_toStringFunc == value)
return;
_toStringFunc = value;
SetConverter(new LambdaConverter<T, string>(_toStringFunc ?? (x => x?.ToString()), null));
}
}
/// <summary>
/// Whether to show the progress indicator.
/// </summary>
[Parameter]
public bool ShowProgressIndicator { get; set; } = false;
/// <summary>
/// The color of the progress indicator.
/// </summary>
[Parameter]
public ThemeColor ProgressIndicatorColor { get; set; } = ThemeColor.Default;
private bool IsLoading => _currentSearchTask is not null && !_currentSearchTask.IsCompleted;
/// <summary>
/// Func that returns a list of items matching the typed text. Provides a cancellation token that
/// is marked as cancelled when the user changes the search text or selects a value from the list.
/// This can be used to cancel expensive asynchronous work occuring within the SearchFunc itself.
/// </summary>
[Parameter]
public Func<string, CancellationToken, Task<IEnumerable<T>>> SearchFuncWithCancel { get; set; }
/// <summary>
/// The SearchFunc returns a list of items matching the typed text
/// </summary>
[Parameter]
public Func<string, Task<IEnumerable<T>>> SearchFunc { get; set; }
/// <summary>
/// Maximum items to display, defaults to 10.
/// A null value will display all items.
/// </summary>
[Parameter]
public int? MaxItems { get; set; } = 10;
/// <summary>
/// Minimum characters to initiate a search
/// </summary>
[Parameter]
public int MinCharacters { get; set; } = 0;
/// <summary>
/// Reset value if user deletes the text
/// </summary>
[Parameter]
public bool ResetValueOnEmptyText { get; set; } = false;
/// <summary>
/// If true, clicking the text field will select (highlight) its contents.
/// </summary>
[Parameter]
public bool SelectOnClick { get; set; } = true;
/// <summary>
/// Debounce interval in milliseconds.
/// </summary>
[Parameter]
public int DebounceInterval { get; set; } = 100;
/// <summary>
/// Optional presentation template for unselected items
/// </summary>
[Parameter]
public RenderFragment<T> ItemTemplate { get; set; }
/// <summary>
/// Optional presentation template for the selected item
/// </summary>
[Parameter]
public RenderFragment<T> ItemSelectedTemplate { get; set; }
/// <summary>
/// Optional presentation template for disabled item
/// </summary>
[Parameter]
public RenderFragment<T> ItemDisabledTemplate { get; set; }
/// <summary>
/// Optional presentation template for when more items were returned from the Search function than the MaxItems limit
/// </summary>
[Parameter]
public RenderFragment MoreItemsTemplate { get; set; }
/// <summary>
/// Optional presentation template for when no items were returned from the Search function
/// </summary>
[Parameter]
public RenderFragment NoItemsTemplate { get; set; }
/// <summary>
/// Optional template for progress indicator
/// </summary>
[Parameter]
public RenderFragment ProgressIndicatorTemplate { get; set; }
/// <summary>
/// Optional template for showing progress indicator inside the popover
/// </summary>
[Parameter]
public RenderFragment ProgressIndicatorInPopoverTemplate { get; set; }
/// <summary>
/// On drop-down close override Text with selected Value. This makes it clear to the user
/// which list value is currently selected and disallows incomplete values in Text.
/// </summary>
[Parameter]
public bool CoerceText { get; set; } = true;
/// <summary>
/// If user input is not found by the search func and CoerceValue is set to true the user input
/// will be applied to the Value which allows to validate it and display an error message.
/// </summary>
[Parameter]
public bool CoerceValue { get; set; }
/// <summary>
/// Function to be invoked when checking whether an item should be disabled or not
/// </summary>
[Parameter]
public Func<T, bool> ItemDisabledFunc { get; set; }
/// <summary>
/// Returns the open state of the drop-down.
/// </summary>
public bool IsOpen
{
get => _isOpen;
// Note: the setter is protected because it was needed by a user who derived his own autocomplete from this class.
// Note: setting IsOpen will not open or close it. Use ToggleMenu() for that.
protected set
{
if (value == _isOpen)
return;
_isOpen = value;
IsOpenChanged.InvokeAsync(_isOpen).AndForget();
}
}
/// <summary>
/// An event triggered when the state of IsOpen has changed
/// </summary>
[Parameter]
public EventCallback<bool> IsOpenChanged { get; set; }
/// <summary>
/// If true, the currently selected item from the drop-down (if it is open) is selected.
/// </summary>
[Parameter]
public bool SelectValueOnTab { get; set; } = false;
/// <summary>
/// Show clear button.
/// </summary>
[Parameter]
public bool Clearable { get; set; } = false;
/// <summary>
/// Button click event for clear button. Called after text and value has been cleared.
/// </summary>
[Parameter]
public EventCallback<MouseEventArgs> OnClearButtonClick { get; set; }
private string CurrentIcon => !string.IsNullOrWhiteSpace(AdornmentIcon) ? AdornmentIcon : _isOpen ? CloseIcon : OpenIcon;
protected string ClassList()
{
return new CssBuilder("select")
.AddClass(Class)
.Build();
}
protected string AutocompleteClassList()
{
return new CssBuilder("select")
.AddClass("autocomplete")
.AddClass("width-full", FullWidth)
.AddClass("autocomplete--with-progress", ShowProgressIndicator && IsLoading)
.Build();
}
protected string CircularProgressClassList()
{
return new CssBuilder("progress-indicator-circular")
.AddClass("progress-indicator-circular--with-adornment", Adornment == Adornment.End)
.Build();
}
public async Task SelectOption(T value)
{
await SetValueAsync(value);
if (_items is not null)
_selectedListItemIndex = Array.IndexOf(_items, value);
var optionText = GetItemString(value);
if (!_isCleared)
await SetTextAsync(optionText, false);
_timer?.Dispose();
IsOpen = false;
BeginValidate();
if (!_isCleared)
_elementReference?.SetText(optionText);
_elementReference?.FocusAsync().AndForget();
StateHasChanged();
}
/// <summary>
/// Toggle the menu (if not disabled or not readonly, and is opened).
/// </summary>
public async Task ToggleMenu()
{
if ((Disabled || ReadOnly) && !IsOpen)
return;
await ChangeMenu(!IsOpen);
}
private async Task ChangeMenu(bool open)
{
if (open)
{
if (SelectOnClick)
await _elementReference.SelectAsync();
await OnSearchAsync();
}
else
{
_timer?.Dispose();
RestoreScrollPosition();
await CoerceTextToValue();
IsOpen = false;
StateHasChanged();
}
}
protected override void OnInitialized()
{
var text = GetItemString(Value);
if (!string.IsNullOrWhiteSpace(text))
Text = text;
}
protected override void OnAfterRender(bool firstRender)
{
_isCleared = false;
base.OnAfterRender(firstRender);
}
protected override Task UpdateTextPropertyAsync(bool updateValue)
{
_timer?.Dispose();
// This keeps the text from being set when clear() was called
if (_isCleared)
return Task.CompletedTask;
return base.UpdateTextPropertyAsync(updateValue);
}
protected override async Task UpdateValuePropertyAsync(bool updateText)
{
_timer?.Dispose();
if (ResetValueOnEmptyText && string.IsNullOrWhiteSpace(Text))
await SetValueAsync(default, updateText);
if (DebounceInterval <= 0)
await OnSearchAsync();
else
_timer = new Timer(OnTimerComplete, null, DebounceInterval, Timeout.Infinite);
}
private void OnTimerComplete(object stateInfo)
{
InvokeAsync(OnSearchAsync);
}
private void CancelToken()
{
try
{
_cancellationTokenSrc?.Cancel();
}
catch
{
}
_cancellationTokenSrc = new CancellationTokenSource();
}
/// <remarks>
/// This async method needs to return a task and be awaited in order for
/// unit tests that trigger this method to work correctly.
/// </remarks>
private async Task OnSearchAsync()
{
if (MinCharacters > 0 && (string.IsNullOrWhiteSpace(Text) || Text.Length < MinCharacters))
{
IsOpen = false;
StateHasChanged();
return;
}
IEnumerable<T> searchedItems = Array.Empty<T>();
CancelToken();
try
{
if (ProgressIndicatorInPopoverTemplate is not null)
IsOpen = true;
var searchTask = SearchFuncWithCancel is not null ? SearchFuncWithCancel(Text, _cancellationTokenSrc.Token) : SearchFunc(Text);
_currentSearchTask = searchTask;
StateHasChanged();
searchedItems = await searchTask ?? Array.Empty<T>();
}
catch (TaskCanceledException)
{
}
catch (OperationCanceledException)
{
}
catch (Exception e)
{
Console.WriteLine($"The search function failed to return results: {e.Message}");
}
_itemsReturned = searchedItems.Count();
if (MaxItems.HasValue)
searchedItems = searchedItems.Take(MaxItems.Value);
_items = searchedItems.ToArray();
_enabledItemIndices = _items.Select((item, idx) => (item, idx)).Where(tuple => ItemDisabledFunc?.Invoke(tuple.item) != true).Select(tuple => tuple.idx).ToList();
_selectedListItemIndex = _enabledItemIndices.Any() ? _enabledItemIndices.First() : -1;
IsOpen = true;
if (_items?.Length == 0)
{
await CoerceValueToText();
StateHasChanged();
return;
}
StateHasChanged();
}
/// <summary>
/// Clears the autocomplete's text
/// </summary>
public async Task Clear()
{
_isCleared = true;
IsOpen = false;
await SetTextAsync(string.Empty, updateValue: false);
await CoerceValueToText();
if (_elementReference is not null)
await _elementReference.SetText(string.Empty);
_timer?.Dispose();
StateHasChanged();
}
protected override async void ResetValue()
{
await Clear();
base.ResetValue();
}
private string GetItemString(T item)
{
if (item is null)
return string.Empty;
try
{
return Converter.Convert(item);
}
catch (NullReferenceException) { }
return "null";
}
internal virtual async Task OnInputKeyDown(KeyboardEventArgs args)
{
switch (args.Key)
{
case "Tab":
// NOTE: We need to catch Tab in Keydown because a tab will move focus to the next element and thus
// in OnInputKeyUp we'd never get the tab key
if (!IsOpen)
return;
if (SelectValueOnTab)
await OnEnterKey();
else
IsOpen = false;
break;
}
}
internal virtual async Task OnInputKeyUp(KeyboardEventArgs args)
{
switch (args.Key)
{
case "Enter":
case "NumpadEnter":
if (!IsOpen)
await ToggleMenu();
else
await OnEnterKey();
break;
case "ArrowDown":
if (!IsOpen)
await ToggleMenu();
else
{
var increment = _enabledItemIndices.ElementAtOrDefault(_enabledItemIndices.IndexOf(_selectedListItemIndex) + 1) - _selectedListItemIndex;
await SelectNextItem(increment < 0 ? 1 : increment);
}
break;
case "ArrowUp":
if (args.AltKey)
await ChangeMenu(false);
else if (!IsOpen)
await ToggleMenu();
else
{
var decrement = _selectedListItemIndex - _enabledItemIndices.ElementAtOrDefault(_enabledItemIndices.IndexOf(_selectedListItemIndex) - 1);
await SelectNextItem(-(decrement < 0 ? 1 : decrement));
}
break;
case "Escape":
await ChangeMenu(false);
break;
case "Tab":
await Task.Delay(1);
if (!IsOpen)
return;
if (SelectValueOnTab)
await OnEnterKey();
else
await ToggleMenu();
break;
case "Backspace":
if (args.CtrlKey && args.ShiftKey)
Reset();
break;
}
base.InvokeKeyUp(args);
}
private ValueTask SelectNextItem(int increment)
{
if (increment == 0 || _items is null || !_items.Any() || !_enabledItemIndices.Any())
return ValueTask.CompletedTask;
// if we are at the end, or the beginning we just do an rollover
_selectedListItemIndex = Math.Clamp(value: (10 * _items.Length + _selectedListItemIndex + increment) % _items.Length, min: 0, max: _items.Length - 1);
return ScrollToListItem(_selectedListItemIndex);
}
/// <summary>
/// Scroll to a specific item index in the Autocomplete list of items.
/// </summary>
/// <param name="index">the index to scroll to</param>
public ValueTask ScrollToListItem(int index)
{
var id = GetListItemId(index);
//id of the scrolled element
return ScrollManager.ScrollToListItemAsync(id);
}
/*
* This restores the scroll position after closing the menu and element being 0
*/
private void RestoreScrollPosition()
{
if (_selectedListItemIndex != 0)
return;
ScrollManager.ScrollToListItemAsync(GetListItemId(0));
}
private string GetListItemId(in int index)
{
return $"{_componentId}_item{index}";
}
internal Task OnEnterKey()
{
if (!IsOpen)
return Task.CompletedTask;
if (_items is null || !_items.Any())
return Task.CompletedTask;
if (_selectedListItemIndex >= 0 && _selectedListItemIndex < _items.Length)
return SelectOption(_items[_selectedListItemIndex]);
return Task.CompletedTask;
}
private Task OnInputBlurred(FocusEventArgs args)
{
OnBlur.InvokeAsync(args);
return Task.CompletedTask;
// we should not validate on blur in autocomplete, because the user needs to click out of the input to select a value,
// resulting in a premature validation. thus, don't call base
//base.OnBlurred(args);
}
private Task CoerceTextToValue()
{
if (!CoerceText)
return Task.CompletedTask;
_timer?.Dispose();
var text = Value is null ? null : GetItemString(Value);
/*
* Don't update the value to prevent the popover from opening again after coercion
*/
if (text != Text)
return SetTextAsync(text, updateValue: false);
return Task.CompletedTask;
}
private Task CoerceValueToText()
{
if (!CoerceValue)
return Task.CompletedTask;
_timer?.Dispose();
var value = Converter.ConvertBack(Text);
return SetValueAsync(value, updateText: false);
}
protected override void Dispose(bool disposing)
{
_timer?.Dispose();
if (_cancellationTokenSrc is not null)
{
try
{
_cancellationTokenSrc.Dispose();
}
catch { }
}
base.Dispose(disposing);
}
/// <summary>
/// Focus the input in the Autocomplete component.
/// </summary>
public override ValueTask FocusAsync()
{
return _elementReference.FocusAsync();
}
/// <summary>
/// Blur from the input in the Autocomplete component.
/// </summary>
public override ValueTask BlurAsync()
{
return _elementReference.BlurAsync();
}
/// <summary>
/// Select all text within the Autocomplete input.
/// </summary>
public override ValueTask SelectAsync()
{
return _elementReference.SelectAsync();
}
/// <summary>
/// Select all text within the Autocomplete input and aligns its start and end points to the text content of the current input.
/// </summary>
public override ValueTask SelectRangeAsync(int pos1, int pos2)
{
return _elementReference.SelectRangeAsync(pos1, pos2);
}
private async Task OnTextChanged(string text)
{
await TextChanged.InvokeAsync();
if (text is null)
return;
await SetTextAsync(text, true);
}
private async Task ListItemOnClick(T item)
{
await SelectOption(item);
}
}

@ -0,0 +1,23 @@
@namespace Connected.Components
@inherits UIComponent
@if(AvatarGroup == null || AvatarGroup.MaxGroupReached(this))
{
<div @attributes="UserAttributes" class="@Classname" style="@Stylesname">
@if (!String.IsNullOrEmpty(Image))
{
if (!String.IsNullOrEmpty(Alt))
{
<img src="@Image" alt="@Alt" class="mud-avatar-img" />
}
else
{
<img src="@Image" class="mud-avatar-img" />
}
}
else
{
@ChildContent
}
</div>
}

@ -0,0 +1,108 @@
using Connected.Annotations;
using Connected.Extensions;
using Connected.Utilities;
using Microsoft.AspNetCore.Components;
namespace Connected.Components;
partial class Avatar : UIComponent, IDisposable
{
[CascadingParameter] protected AvatarGroup AvatarGroup { get; set; }
protected string Classname =>
new CssBuilder("mud-avatar")
.AddClass($"mud-avatar-{Size.ToDescriptionString()}")
.AddClass($"mud-avatar-rounded", Rounded)
.AddClass($"mud-avatar-square", Square)
.AddClass($"mud-avatar-{Variant.ToDescriptionString()}")
.AddClass($"mud-avatar-{Variant.ToDescriptionString()}-{Color.ToDescriptionString()}")
.AddClass($"mud-elevation-{Elevation.ToString()}")
.AddClass(AvatarGroup?.GetAvatarSpacing() ?? new CssBuilder(), AvatarGroup != null)
.AddClass(Class)
.Build();
protected string Stylesname =>
new StyleBuilder()
.AddStyle(AvatarGroup?.GetAvatarZindex(this) ?? new StyleBuilder(), AvatarGroup != null)
.AddStyle(Style)
.Build();
/// <summary>
/// The higher the number, the heavier the drop-shadow.
/// </summary>
[Parameter]
[Category(CategoryTypes.Avatar.Appearance)]
public int Elevation { set; get; } = 0;
/// <summary>
/// If true, border-radius is set to 0.
/// </summary>
[Parameter]
[Category(CategoryTypes.Avatar.Appearance)]
public bool Square { get; set; }
/// <summary>
/// If true, border-radius is set to the themes default value.
/// </summary>
[Parameter]
[Category(CategoryTypes.Avatar.Appearance)]
public bool Rounded { get; set; }
/// <summary>
/// Link to image, if set a image will be displayed instead of text.
/// </summary>
[Parameter]
[Category(CategoryTypes.Avatar.Behavior)]
public string Image { get; set; }
/// <summary>
/// If set (and Image is also set), will add an alt property to the img element
/// </summary>
[Parameter]
[Category(CategoryTypes.Avatar.Behavior)]
public string Alt { get; set; }
/// <summary>
/// The color of the component. It supports the theme colors.
/// </summary>
[Parameter]
[Category(CategoryTypes.Avatar.Appearance)]
public ThemeColor Color { get; set; } = ThemeColor.Default;
/// <summary>
/// The Size of the MudAvatar.
/// </summary>
[Parameter]
[Category(CategoryTypes.Avatar.Appearance)]
public Size Size { get; set; } = Size.Medium;
/// <summary>
/// The variant to use.
/// </summary>
[Parameter]
[Category(CategoryTypes.Avatar.Appearance)]
public Variant Variant { get; set; } = Variant.Filled;
/// <summary>
/// Child content of the component.
/// </summary>
[Parameter]
[Category(CategoryTypes.Avatar.Behavior)]
public RenderFragment ChildContent { get; set; }
protected override void OnInitialized()
{
base.OnInitialized();
AvatarGroup?.AddAvatar(this);
}
public void Dispose()
{
AvatarGroup?.RemoveAvatar(this);
}
internal void ForceRedraw()
{
StateHasChanged();
}
}

@ -0,0 +1,14 @@
@namespace Connected.Components
@inherits UIComponent
<div @attributes="UserAttributes" class="@Classname" style="@Style">
<CascadingValue Value="this" IsFixed="true">
@ChildContent
</CascadingValue>
@if(_avatars.Count > Max)
{
<Avatar Class="@MaxAvatarClassname" Color="@MaxColor" Size="@MaxSize" Variant="@MaxVariant" Rounded="@MaxRounded" Square="@MaxSquare" Elevation="@MaxElevation">
@($"+{_avatars.Count - Max}")
</Avatar>
}
</div>

@ -0,0 +1,176 @@
using Connected.Annotations;
using Connected.Extensions;
using Connected.Utilities;
using Microsoft.AspNetCore.Components;
namespace Connected.Components;
partial class AvatarGroup : UIComponent
{
private bool _childrenNeedUpdates = false;
protected string Classname =>
new CssBuilder("mud-avatar-group")
.AddClass($"mud-avatar-group-outlined", Outlined)
.AddClass($"mud-avatar-group-outlined-{OutlineColor.ToDescriptionString()}", Outlined)
.AddClass(Class)
.Build();
protected string MaxAvatarClassname =>
new CssBuilder("mud-avatar-group-max-avatar")
.AddClass($"ms-n{Spacing}")
.AddClass(MaxAvatarClass)
.Build();
private int _spacing = 3;
/// <summary>
/// Spacing between avatars where 0 is none and 16 max.
/// </summary>
[Parameter]
[Category(CategoryTypes.AvatarGroup.Behavior)]
public int Spacing
{
get => _spacing;
set
{
if (value != _spacing)
{
_spacing = value;
_childrenNeedUpdates = true;
}
}
}
/// <summary>
/// Outlines the grouped avatars to distinguish them, useful when avatars are the same color or uses images.
/// </summary>
[Parameter]
[Category(CategoryTypes.AvatarGroup.Appearance)]
public bool Outlined { get; set; } = true;
/// <summary>
/// Sets the color of the outline if its used.
/// </summary>
[Parameter]
[Category(CategoryTypes.AvatarGroup.Appearance)]
public ThemeColor OutlineColor { get; set; } = ThemeColor.Surface;
/// <summary>
/// Elevation of the MaxAvatar the higher the number, the heavier the drop-shadow.
/// </summary>
[Parameter]
[Category(CategoryTypes.AvatarGroup.Appearance)]
public int MaxElevation { set; get; } = 0;
/// <summary>
/// If true, MaxAvatar border-radius is set to 0.
/// </summary>
[Parameter]
[Category(CategoryTypes.AvatarGroup.Appearance)]
public bool MaxSquare { get; set; }
/// <summary>
/// If true, MaxAvatar will be rounded.
/// </summary>
[Parameter]
[Category(CategoryTypes.AvatarGroup.Appearance)]
public bool MaxRounded { get; set; }
/// <summary>
/// Color for the MaxAvatar.
/// </summary>
[Parameter]
[Category(CategoryTypes.AvatarGroup.Appearance)]
public ThemeColor MaxColor { get; set; } = ThemeColor.Default;
/// <summary>
/// Size of the MaxAvatar.
/// </summary>
[Parameter]
[Category(CategoryTypes.AvatarGroup.Appearance)]
public Size MaxSize { get; set; } = Size.Medium;
/// <summary>
/// Variant of the MaxAvatar.
/// </summary>
[Parameter]
[Category(CategoryTypes.AvatarGroup.Appearance)]
public Variant MaxVariant { get; set; } = Variant.Filled;
private int _max = 3;
/// <summary>
/// Max avatars to show before showing +x avatar, default value 0 has no max.
/// </summary>
[Parameter]
[Category(CategoryTypes.AvatarGroup.Behavior)]
public int Max
{
get => _max;
set
{
if (value != _max)
{
_max = value;
_childrenNeedUpdates = true;
}
}
}
/// <summary>
/// Custom class/classes for MaxAvatar
/// </summary>
[Parameter]
[Category(CategoryTypes.AvatarGroup.Appearance)]
public string MaxAvatarClass { get; set; }
/// <summary>
/// Child content of the component.
/// </summary>
[Parameter]
[Category(CategoryTypes.AvatarGroup.Behavior)]
public RenderFragment ChildContent { get; set; }
internal List<Avatar> _avatars = new();
internal void AddAvatar(Avatar avatar)
{
_avatars.Add(avatar);
StateHasChanged();
}
internal void RemoveAvatar(Avatar avatar)
{
_avatars.Remove(avatar);
}
internal CssBuilder GetAvatarSpacing() => new CssBuilder()
.AddClass($"ms-n{Spacing}");
internal StyleBuilder GetAvatarZindex(Avatar avatar) => new StyleBuilder()
.AddStyle("z-index", $"{_avatars.Count - _avatars.IndexOf(avatar)}");
internal bool MaxGroupReached(Avatar avatar)
{
if (_avatars.IndexOf(avatar) < Max)
return true;
else
return false;
}
protected override void OnParametersSet()
{
base.OnParametersSet();
if (_childrenNeedUpdates == true)
{
foreach (var avatar in _avatars)
{
avatar.ForceRedraw();
}
_childrenNeedUpdates = false;
}
}
}

@ -0,0 +1,24 @@
@namespace Connected.Components
@inherits UIComponent
<span @attributes="UserAttributes" class="@Classname" style="@Style">
@ChildContent
@if (Visible)
{
<span class="@WrapperClass">
<span class="@BadgeClassName" @onclick="HandleBadgeClick">
@if (!Dot)
{
@if (!String.IsNullOrEmpty(Icon))
{
<Icon Icon="@Icon" Class="mud-icon-badge" />
}
else
{
@_content
}
}
</span>
</span>
}
</span>

@ -0,0 +1,176 @@
using System.Diagnostics.CodeAnalysis;
using Connected.Annotations;
using Connected.Extensions;
using Connected.Utilities;
using Microsoft.AspNetCore.Components;
using Microsoft.AspNetCore.Components.Web;
namespace Connected.Components;
public partial class Badge : UIComponent
{
protected string Classname =>
new CssBuilder("mud-badge-root")
.AddClass(Class)
.Build();
protected string WrapperClass =>
new CssBuilder("mud-badge-wrapper")
.AddClass($"mud-badge-{Origin.ToDescriptionString().Replace("-", " ")}")
.Build();
protected string BadgeClassName =>
new CssBuilder("mud-badge")
.AddClass("mud-badge-dot", Dot)
.AddClass("mud-badge-bordered", Bordered)
.AddClass("mud-badge-icon", !string.IsNullOrEmpty(Icon) && !Dot)
.AddClass($"mud-badge-{Origin.ToDescriptionString().Replace("-", " ")}")
.AddClass($"mud-elevation-{Elevation.ToString()}")
.AddClass("mud-theme-" + Color.ToDescriptionString(), Color != ThemeColor.Default)
.AddClass("mud-badge-default", Color == ThemeColor.Default)
.AddClass("mud-badge-overlap", Overlap)
.AddClass(BadgeClass)
.Build();
/// <summary>
/// The placement of the badge.
/// </summary>
[Parameter]
[Category(CategoryTypes.Badge.Appearance)]
public Origin Origin { get; set; } = Origin.TopRight;
/// <summary>
/// The higher the number, the heavier the drop-shadow.
/// </summary>
[Parameter]
[Category(CategoryTypes.Badge.Appearance)]
public int Elevation { set; get; } = 0;
/// <summary>
/// The visibility of the badge.
/// </summary>
[Parameter]
[Category(CategoryTypes.Badge.Behavior)]
public bool Visible { get; set; } = true;
/// <summary>
/// The color of the badge.
/// </summary>
[Parameter]
[Category(CategoryTypes.Badge.Appearance)]
public ThemeColor Color { get; set; } = ThemeColor.Default;
/// <summary>
/// Aligns the badge to bottom.
/// </summary>
[ExcludeFromCodeCoverage]
[Obsolete("Use Origin instead.", true)]
[Parameter] public bool Bottom { get; set; }
/// <summary>
/// Aligns the badge to left.
/// </summary>
[ExcludeFromCodeCoverage]
[Obsolete("Use Origin instead.", true)]
[Parameter] public bool Left { get => Start; set { Start = value; } }
/// <summary>
/// Aligns the badge to the start (Left in LTR and right in RTL).
/// </summary>
[ExcludeFromCodeCoverage]
[Obsolete("Use Origin instead.", true)]
[Parameter] public bool Start { get; set; }
/// <summary>
/// Reduces the size of the badge and hide any of its content.
/// </summary>
[Parameter]
[Category(CategoryTypes.Badge.Behavior)]
public bool Dot { get; set; }
/// <summary>
/// Overlaps the childcontent on top of the content.
/// </summary>
[Parameter]
[Category(CategoryTypes.Badge.Appearance)]
public bool Overlap { get; set; }
/// <summary>
/// Applies a border around the badge.
/// </summary>
[Parameter]
[Category(CategoryTypes.Badge.Appearance)]
public bool Bordered { get; set; }
/// <summary>
/// Sets the Icon to use in the badge.
/// </summary>
[Parameter]
[Category(CategoryTypes.Badge.Behavior)]
public string Icon { get; set; }
/// <summary>
/// Max value to show when content is integer type.
/// </summary>
[Parameter]
[Category(CategoryTypes.Badge.Behavior)]
public int Max { get; set; } = 99;
/// <summary>
/// Content you want inside the badge. Supported types are string and integer.
/// </summary>
[Parameter]
[Category(CategoryTypes.Badge.Behavior)]
public object Content { get; set; }
/// <summary>
/// Badge class names, separated by space.
/// </summary>
[Parameter]
[Category(CategoryTypes.Badge.Appearance)]
public string BadgeClass { get; set; }
/// <summary>
/// Child content of component, the content that the badge will apply to.
/// </summary>
[Parameter]
[Category(CategoryTypes.Badge.Behavior)]
public RenderFragment ChildContent { get; set; }
/// <summary>
/// Button click event if set.
/// </summary>
[Parameter] public EventCallback<MouseEventArgs> OnClick { get; set; }
private string _content;
internal Task HandleBadgeClick(MouseEventArgs e)
{
if (OnClick.HasDelegate)
return OnClick.InvokeAsync(e);
return Task.CompletedTask;
}
protected override void OnParametersSet()
{
if (Content is string stringContent)
{
_content = stringContent;
}
else if (Content is int numberContent)
{
if (numberContent > Max)
{
_content = Max + "+";
}
else
{
_content = numberContent.ToString();
}
}
else
{
_content = null;
}
}
}

@ -0,0 +1,31 @@
using Connected.Annotations;
using Microsoft.AspNetCore.Components;
namespace Connected.Components;
public abstract class BindableItemsControlBase<TChildComponent, TData> : ItemsControlBase<TChildComponent>
where TChildComponent : UIComponent
{
/// <summary>
/// Items Collection - For databinding usage
/// </summary>
[Parameter]
[Category(CategoryTypes.General.Data)]
public IEnumerable<TData> ItemsSource { get; set; }
/// <summary>
/// Template for each Item in ItemsSource collection
/// </summary>
[Parameter]
[Category(CategoryTypes.General.Appearance)]
public RenderFragment<TData> ItemTemplate { get; set; }
/// <summary>
/// Gets the Selected Item from ItemsSource, or Selected TChildComponent, when it's null
/// </summary>
public object SelectedItem
{
get => ItemsSource == null ? Items[SelectedIndex] : ItemsSource.ElementAtOrDefault(SelectedIndex);
}
}

@ -0,0 +1,89 @@
using Connected.Annotations;
using Microsoft.AspNetCore.Components;
namespace Connected.Components;
public class BooleanInput<T> : FormComponent<T, bool?>
{
public BooleanInput() : base(new BoolConverter<T>()) { }
/// <summary>
/// If true, the input will be disabled.
/// </summary>
[Parameter]
[Category(CategoryTypes.FormComponent.Behavior)]
public bool Disabled { get; set; }
/// <summary>
/// If true, the input will be read-only.
/// </summary>
[Parameter]
[Category(CategoryTypes.FormComponent.Behavior)]
public bool ReadOnly { get; set; }
/// <summary>
/// The state of the component
/// </summary>
[Parameter]
[Category(CategoryTypes.FormComponent.Data)]
public T Checked
{
get => _value;
set => _value = value;
}
/// <summary>
/// If true will prevent the click from bubbling up the event tree.
/// </summary>
[Parameter]
[Category(CategoryTypes.FormComponent.Behavior)]
public bool StopClickPropagation { get; set; } = true;
/// <summary>
/// Fired when Checked changes.
/// </summary>
[Parameter] public EventCallback<T> CheckedChanged { get; set; }
protected bool? BoolValue => Converter.Convert(Checked);
protected virtual Task OnChange(ChangeEventArgs args)
{
Modified = true;
return SetBoolValueAsync((bool?)args.Value);
}
protected Task SetBoolValueAsync(bool? value)
{
return SetCheckedAsync(Converter.ConvertBack(value));
}
protected async Task SetCheckedAsync(T value)
{
if (Disabled)
return;
if (!EqualityComparer<T>.Default.Equals(Checked, value))
{
Checked = value;
await CheckedChanged.InvokeAsync(value);
BeginValidate();
FieldChanged(Checked);
}
}
protected override bool SetConverter(Converter<T, bool?> value)
{
var changed = base.SetConverter(value);
if (changed)
SetBoolValueAsync(Converter.Convert(Checked)).AndForget();
return changed;
}
/// <summary>
/// A value is required, so if not checked we return ERROR.
/// </summary>
protected override bool HasValue(T value)
{
return (BoolValue == true);
}
}

@ -0,0 +1,17 @@
namespace Connected.Components;
public class BreadcrumbItem
{
public string Text { get; }
public string Href { get; }
public bool Disabled { get; }
public string Icon { get; }
public BreadcrumbItem(string text, string href, bool disabled = false, string icon = null)
{
Text = text;
Disabled = disabled;
Href = href;
Icon = icon;
}
}

@ -0,0 +1,19 @@
@namespace Connected.Components
@inherits UIComponent
<li class="@Classname">
@if (Parent?.ItemTemplate is null)
{
<a href="@(Item?.Href ?? "#")">
@if (Item?.Icon != null)
{
<Icon Icon="@Item?.Icon" Size="Size.Small" />
}
@Item?.Text
</a>
}
else
{
@Parent?.ItemTemplate(Item);
}
</li>

@ -0,0 +1,16 @@
using Connected.Utilities;
using Microsoft.AspNetCore.Components;
namespace Connected.Components;
public partial class BreadcrumbLink : UIComponent
{
[Parameter]
public BreadcrumbItem Item { get; set; }
[CascadingParameter]
public Breadcrumbs Parent { get; set; }
private string Classname => new CssBuilder("mud-breadcrumb-item")
.AddClass("mud-disabled", Item?.Disabled)
.Build();
}

@ -0,0 +1,13 @@
@namespace Connected.Components
@inherits UIComponent
<li aria-hidden="true" class="mud-breadcrumb-separator mud-ltr mud-flip-x-rtl">
@if (Parent?.SeparatorTemplate is null)
{
<span>@Parent?.Separator</span>
}
else
{
@Parent?.SeparatorTemplate
}
</li>

@ -0,0 +1,8 @@
using Microsoft.AspNetCore.Components;
namespace Connected.Components;
public partial class BreadcrumbSeparator : UIComponent
{
[CascadingParameter]
public Breadcrumbs Parent { get; set; }
}

@ -0,0 +1,35 @@
@namespace Connected.Components
@inherits UIComponent
@if (Items is null || !Items.Any())
{
return;
}
<CascadingValue Value="this" IsFixed="true">
<ul @attributes="UserAttributes" class=@Classname style="@Style">
@if (MaxItems is not null && Collapsed && Items.Count > MaxItems)
{
<BreadcrumbLink Item="Items[0]"></BreadcrumbLink>
<BreadcrumbSeparator></BreadcrumbSeparator>
<li class="mud-breadcrumbs-expander" @onclick="Expand">
<Icon Icon="@ExpanderIcon" Size="Size.Small"></Icon>
</li>
<BreadcrumbSeparator></BreadcrumbSeparator>
<BreadcrumbLink Item="Items[Items.Count - 1]"></BreadcrumbLink>
}
else
{
@for (var i = 0; i < Items.Count; i++)
{
var item = Items[i];
<BreadcrumbLink Item="item"></BreadcrumbLink>
if (i != Items.Count - 1)
{
<BreadcrumbSeparator></BreadcrumbSeparator>
}
}
}
</ul>
</CascadingValue>

@ -0,0 +1,72 @@
using Connected.Annotations;
using Connected.Utilities;
using Microsoft.AspNetCore.Components;
namespace Connected.Components;
public partial class Breadcrumbs : UIComponent
{
/// <summary>
/// A list of breadcrumb items/links.
/// </summary>
[Parameter]
[Category(CategoryTypes.Breadcrumbs.Behavior)]
public List<BreadcrumbItem> Items { get; set; }
/// <summary>
/// Specifies the separator between the items.
/// </summary>
[Parameter]
[Category(CategoryTypes.Breadcrumbs.Appearance)]
public string Separator { get; set; } = "/";
/// <summary>
/// Specifies a RenderFragment to use as the separator.
/// </summary>
[Parameter]
[Category(CategoryTypes.Breadcrumbs.Appearance)]
public RenderFragment SeparatorTemplate { get; set; }
/// <summary>
/// Specifies a RenderFragment to use as the items' contents.
/// </summary>
[Parameter]
[Category(CategoryTypes.Breadcrumbs.Behavior)]
public RenderFragment<BreadcrumbItem> ItemTemplate { get; set; }
/// <summary>
/// Controls when (and if) the breadcrumbs will automatically collapse.
/// </summary>
[Parameter]
[Category(CategoryTypes.Breadcrumbs.Behavior)]
public byte? MaxItems { get; set; }
/// <summary>
/// Custom expander icon.
/// </summary>
[Parameter]
[Category(CategoryTypes.Breadcrumbs.Appearance)]
public string ExpanderIcon { get; set; } = Icons.Material.Filled.SettingsEthernet;
public bool Collapsed { get; private set; } = true;
private string Classname => new CssBuilder("mud-breadcrumbs")
.AddClass("mud-typography-body1")
.AddClass(Class)
.Build();
internal static string GetItemClassname(BreadcrumbItem item)
{
return new CssBuilder("mud-breadcrumb-item")
.AddClass("mud-disabled", item.Disabled)
.Build();
}
internal void Expand()
{
if (!Collapsed)
return;
Collapsed = false;
StateHasChanged();
}
}

@ -0,0 +1,6 @@
@namespace Connected.Components
@inherits UIComponent
<CascadingValue Value="Breakpoint">
@ChildContent
</CascadingValue>

@ -0,0 +1,46 @@
using Connected.Annotations;
using Connected.Services;
using Microsoft.AspNetCore.Components;
namespace Connected.Components;
public partial class BreakpointProvider : UIComponent, IAsyncDisposable
{
private Guid _breakPointListenerSubscriptionId;
public Breakpoint Breakpoint { get; private set; } = Breakpoint.Always;
[Parameter] public EventCallback<Breakpoint> OnBreakpointChanged { get; set; }
[Inject] public IBreakpointService Service { get; set; }
[Parameter]
[Category(CategoryTypes.BreakpointProvider.Behavior)]
public RenderFragment ChildContent { get; set; }
protected override async Task OnAfterRenderAsync(bool firstRender)
{
await base.OnAfterRenderAsync(firstRender);
if (firstRender == true)
{
var attachResult = await Service.Subscribe(SetBreakpointCallback);
_breakPointListenerSubscriptionId = attachResult.SubscriptionId;
Breakpoint = attachResult.Breakpoint;
await OnBreakpointChanged.InvokeAsync(Breakpoint);
StateHasChanged();
}
}
private void SetBreakpointCallback(Breakpoint breakpoint)
{
InvokeAsync(() =>
{
Breakpoint = breakpoint;
OnBreakpointChanged.InvokeAsync(breakpoint);
StateHasChanged();
}).AndForget();
}
public async ValueTask DisposeAsync() => await Service.Unsubscribe(_breakPointListenerSubscriptionId);
}

@ -0,0 +1,31 @@
@namespace Connected.Components
@using Connected.Extensions;
@inherits ButtonBase
<Element @bind-Ref="@_elementReference"
HtmlTag="@HtmlTag"
Class="@Classname"
Style="@Style"
@attributes="UserAttributes"
@onclick="OnClickHandler"
type="@ButtonType.ToDescriptionString()"
href="@Href"
target="@Target"
rel="@(Target=="_blank"?"noopener":null)"
disabled="@Disabled">
<span class="mud-button-label">
@if (!string.IsNullOrWhiteSpace(StartIcon))
{
<span class="@StartIconClass">
<Icon Icon="@StartIcon" Size="@Size" Color="@IconColor" />
</span>
}
@ChildContent
@if (!string.IsNullOrWhiteSpace(@EndIcon))
{
<span class="@EndIconClass">
<Icon Glyph="@EndIcon" Size="@Size" Color="@IconColor" />
</span>
}
</span>
</Element>

@ -0,0 +1,96 @@
using Connected.Annotations;
using Connected.Extensions;
using Connected.Utilities;
using Microsoft.AspNetCore.Components;
namespace Connected.Components;
public partial class Button : ButtonBase
{
protected string Classname =>
new CssBuilder("mud-button-root mud-button")
.AddClass($"mud-button-{Variant.ToDescriptionString()}")
.AddClass($"mud-button-{Variant.ToDescriptionString()}-{Color.ToDescriptionString()}")
.AddClass($"mud-button-{Variant.ToDescriptionString()}-size-{Size.ToDescriptionString()}")
.AddClass($"mud-width-full", FullWidth)
.AddClass($"mud-ripple", !DisableRipple)
.AddClass($"mud-button-disable-elevation", DisableElevation)
.AddClass(Class)
.Build();
protected string StartIconClass =>
new CssBuilder("mud-button-icon-start")
.AddClass($"mud-button-icon-size-{Size.ToDescriptionString()}")
.AddClass(IconClass)
.Build();
protected string EndIconClass =>
new CssBuilder("mud-button-icon-end")
.AddClass($"mud-button-icon-size-{Size.ToDescriptionString()}")
.AddClass(IconClass)
.Build();
/// <summary>
/// Icon placed before the text if set.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Behavior)]
public string StartIcon { get; set; }
/// <summary>
/// Icon placed after the text if set.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Behavior)]
public string EndIcon { get; set; }
/// <summary>
/// The color of the icon. It supports the theme colors.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Appearance)]
public ThemeColor IconColor { get; set; } = ThemeColor.Inherit;
/// <summary>
/// Icon class names, separated by space
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Appearance)]
public string IconClass { get; set; }
/// <summary>
/// The color of the component. It supports the theme colors.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Appearance)]
public ThemeColor Color { get; set; } = ThemeColor.Default;
/// <summary>
/// The Size of the component.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Appearance)]
public Size Size { get; set; } = Size.Medium;
/// <summary>
/// The variant to use.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Appearance)]
public Variant Variant { get; set; } = Variant.Text;
/// <summary>
/// If true, the button will take up 100% of available width.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Appearance)]
public bool FullWidth { get; set; }
/// <summary>
/// Child content of component.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Behavior)]
public RenderFragment ChildContent { get; set; }
}

@ -0,0 +1,143 @@
using System.Windows.Input;
using Connected.Annotations;
using Microsoft.AspNetCore.Components;
using Microsoft.AspNetCore.Components.Web;
using static System.String;
namespace Connected.Components;
public abstract class ButtonBase : UIComponent
{
/// <summary>
/// Potential activation target for this button. This enables RenderFragments with user-defined
/// buttons which will automatically activate the intended functionality.
/// </summary>
[CascadingParameter] protected IActivatable Activateable { get; set; }
/// <summary>
/// The HTML element that will be rendered in the root by the component
/// By default, is a button
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.ClickAction)]
public string HtmlTag { get; set; } = "button";
/// <summary>
/// The button Type (Button, Submit, Refresh)
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.ClickAction)]
public ButtonType ButtonType { get; set; }
/// <summary>
/// If set to a URL, clicking the button will open the referenced document. Use Target to specify where
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.ClickAction)]
public string Href { get; set; }
/// <summary>
/// If set to a URL, clicking the button will open the referenced document. Use Target to specify where (Obsolete replaced by Href)
/// </summary>
[Obsolete("Use Href Instead.", false)]
[Parameter]
[Category(CategoryTypes.Button.ClickAction)]
public string Link
{
get => Href;
set => Href = value;
}
/// <summary>
/// The target attribute specifies where to open the link, if Link is specified. Possible values: _blank | _self | _parent | _top | <i>framename</i>
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.ClickAction)]
public string Target { get; set; }
/// <summary>
/// If true, the button will be disabled.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Behavior)]
public bool Disabled { get; set; }
/// <summary>
/// If true, no drop-shadow will be used.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Appearance)]
public bool DisableElevation { get; set; }
/// <summary>
/// If true, disables ripple effect.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Appearance)]
public bool DisableRipple { get; set; }
/// <summary>
/// Command executed when the user clicks on an element.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.ClickAction)]
public ICommand Command { get; set; }
/// <summary>
/// Command parameter.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.ClickAction)]
public object CommandParameter { get; set; }
/// <summary>
/// Button click event.
/// </summary>
[Parameter]
public EventCallback<MouseEventArgs> OnClick { get; set; }
protected async Task OnClickHandler(MouseEventArgs ev)
{
if (Disabled)
return;
await OnClick.InvokeAsync(ev);
if (Command?.CanExecute(CommandParameter) ?? false)
{
Command.Execute(CommandParameter);
}
Activateable?.Activate(this, ev);
}
protected override void OnInitialized()
{
SetDefaultValues();
}
protected override void OnParametersSet()
{
//if params change, must set default values again
SetDefaultValues();
}
//Set the default value for HtmlTag, Link and Target
private void SetDefaultValues()
{
if (Disabled)
{
HtmlTag = "button";
Href = null;
Target = null;
return;
}
// Render an anchor element if Link property is set and is not disabled
if (!IsNullOrWhiteSpace(Href))
{
HtmlTag = "a";
}
}
protected ElementReference _elementReference;
public ValueTask FocusAsync() => _elementReference.FocusAsync();
}

@ -0,0 +1,30 @@
@namespace Connected.Components
@inherits ButtonBase
@using Connected.Extensions;
<Element @bind-Ref="@_elementReference"
HtmlTag="@HtmlTag"
Class="@Classname"
Style="@Style"
@attributes="UserAttributes"
@onclick="OnClickHandler"
type="@ButtonType.ToDescriptionString()"
href="@Href"
target="@Target"
rel="@(Target=="_blank"?"noopener":null)"
disabled="@Disabled"
title="@Title">
<span class="mud-fab-label">
@if (!string.IsNullOrWhiteSpace(StartIcon))
{
<Icon Icon="@StartIcon" Color="@IconColor" Size="@IconSize" />
}
@Label
@if (!string.IsNullOrWhiteSpace(EndIcon))
{
<Icon Icon="@EndIcon" Color="@IconColor" Size="@IconSize" />
}
</span>
</Element>

@ -0,0 +1,80 @@
using Connected.Annotations;
using Connected.Extensions;
using Connected.Utilities;
using Microsoft.AspNetCore.Components;
namespace Connected.Components;
public partial class Fab : ButtonBase
{
protected string Classname =>
new CssBuilder("mud-button-root mud-fab")
.AddClass($"mud-fab-extended", !string.IsNullOrEmpty(Label))
.AddClass($"mud-fab-{Color.ToDescriptionString()}")
.AddClass($"mud-fab-size-{Size.ToDescriptionString()}")
.AddClass($"mud-ripple", !DisableRipple && !Disabled)
.AddClass($"mud-fab-disable-elevation", DisableElevation)
.AddClass(Class)
.Build();
/// <summary>
/// The color of the component. It supports the theme colors.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Appearance)]
public ThemeColor Color { get; set; } = ThemeColor.Default;
/// <summary>
/// The Size of the component.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Appearance)]
public Size Size { get; set; } = Size.Large;
/// <summary>
/// If applied Icon will be added at the start of the component.
/// </summary>
[Obsolete("This property is obsolete. Use StartIcon instead.")][Parameter] public string Icon { get => StartIcon; set => StartIcon = value; }
/// <summary>
/// If applied Icon will be added at the start of the component.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Behavior)]
public string StartIcon { get; set; }
/// <summary>
/// If applied Icon will be added at the end of the component.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Behavior)]
public string EndIcon { get; set; }
/// <summary>
/// The color of the icon. It supports the theme colors.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Appearance)]
public ThemeColor IconColor { get; set; } = ThemeColor.Inherit;
/// <summary>
/// The size of the icon.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Appearance)]
public Size IconSize { get; set; } = Size.Medium;
/// <summary>
/// If applied the text will be added to the component.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Behavior)]
public string Label { get; set; }
/// <summary>
/// Title of the icon used for accessibility.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Behavior)]
public string Title { get; set; }
}

@ -0,0 +1,29 @@
@namespace Connected.Components
@inherits ButtonBase
@using Connected.Extensions;
<Element @bind-Ref="@_elementReference"
HtmlTag="@HtmlTag"
Class="@Classname"
Style="@Style"
@attributes="UserAttributes"
@onclick="OnClickHandler"
type="@ButtonType.ToDescriptionString()"
href="@Href"
target="@Target"
rel="@(Target=="_blank"?"noopener":null)"
disabled="@Disabled"
title="@Title">
@if (!String.IsNullOrEmpty(Icon))
{
<span class="mud-icon-button-label">
<Icon Glyph="@Icon" Size="@Size" />
</span>
}
else
{
<TextContent Typo="Typo.body2" Color="ThemeColor.Inherit">@ChildContent</TextContent>
}
</Element>

@ -0,0 +1,76 @@
using Connected.Annotations;
using Connected.Extensions;
using Connected.Utilities;
using Microsoft.AspNetCore.Components;
namespace Connected.Components;
public partial class IconButton : ButtonBase
{
protected string Classname =>
new CssBuilder("mud-button-root mud-icon-button")
.AddClass("mud-button", when: AsButton)
.AddClass($"mud-{Color.ToDescriptionString()}-text hover:mud-{Color.ToDescriptionString()}-hover", !AsButton && Color != ThemeColor.Default)
.AddClass($"mud-button-{Variant.ToDescriptionString()}", AsButton)
.AddClass($"mud-button-{Variant.ToDescriptionString()}-{Color.ToDescriptionString()}", AsButton)
.AddClass($"mud-button-{Variant.ToDescriptionString()}-size-{Size.ToDescriptionString()}", AsButton)
.AddClass($"mud-ripple", !DisableRipple)
.AddClass($"mud-ripple-icon", !DisableRipple && !AsButton)
.AddClass($"mud-icon-button-size-{Size.ToDescriptionString()}", when: () => Size != Size.Medium)
.AddClass($"mud-icon-button-edge-{Edge.ToDescriptionString()}", when: () => Edge != Edge.False)
.AddClass($"mud-button-disable-elevation", DisableElevation)
.AddClass(Class)
.Build();
protected bool AsButton => Variant != Variant.Text;
/// <summary>
/// The Icon that will be used in the component.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Behavior)]
public string Icon { get; set; }
/// <summary>
/// Title of the icon used for accessibility.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Behavior)]
public string Title { get; set; }
/// <summary>
/// The color of the component. It supports the theme colors.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Appearance)]
public ThemeColor Color { get; set; } = ThemeColor.Default;
/// <summary>
/// The Size of the component.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Appearance)]
public Size Size { get; set; } = Size.Medium;
/// <summary>
/// If set uses a negative margin.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Appearance)]
public Edge Edge { get; set; }
/// <summary>
/// Child content of component, only shows if Icon is null or Empty.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Behavior)]
public RenderFragment ChildContent { get; set; }
/// <summary>
/// The variant to use.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Appearance)]
public Variant Variant { get; set; } = Variant.Text;
}

@ -0,0 +1,21 @@
@namespace Connected.Components
@inherits UIComponent
@{
var ariaPressedValue = @Toggled ? "true" : "false";
}
<IconButton Icon="@(Toggled ? ToggledIcon : Icon)"
Size="(Toggled ? ToggledSize : Size)"
Color="(Toggled ? ToggledColor : Color)"
Title="@(Toggled && ToggledTitle != null ? ToggledTitle : Title)"
Variant="Variant"
Disabled="Disabled"
Edge="Edge"
DisableRipple="DisableRipple"
OnClick="Toggle"
Class="@Class"
Style="@Style"
aria-pressed="@ariaPressedValue"
@attributes="UserAttributes" />

@ -0,0 +1,119 @@
using Connected.Annotations;
using Microsoft.AspNetCore.Components;
namespace Connected.Components;
public partial class ToggleIconButton : UIComponent
{
/// <summary>
/// The toggled value.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Behavior)]
public bool Toggled { get; set; }
/// <summary>
/// Fires whenever toggled is changed.
/// </summary>
[Parameter] public EventCallback<bool> ToggledChanged { get; set; }
/// <summary>
/// The Icon that will be used in the untoggled state.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Behavior)]
public string Icon { get; set; }
/// <summary>
/// The Icon that will be used in the toggled state.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Behavior)]
public string ToggledIcon { get; set; }
/// <summary>
/// Title of the icon used for accessibility.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Behavior)]
public string Title { get; set; }
/// <summary>
/// Title used in toggled state, if different.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Behavior)]
public string ToggledTitle { get; set; }
/// <summary>
/// The color of the icon in the untoggled state. It supports the theme colors.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Appearance)]
public ThemeColor Color { get; set; } = ThemeColor.Default;
/// <summary>
/// The color of the icon in the toggled state. It supports the theme colors.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Appearance)]
public ThemeColor ToggledColor { get; set; } = ThemeColor.Default;
/// <summary>
/// The Size of the component in the untoggled state.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Appearance)]
public Size Size { get; set; } = Size.Medium;
/// <summary>
/// The Size of the component in the toggled state.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Appearance)]
public Size ToggledSize { get; set; } = Size.Medium;
/// <summary>
/// If set uses a negative margin.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Appearance)]
public Edge Edge { get; set; }
/// <summary>
/// If true, disables ripple effect.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Appearance)]
public bool DisableRipple { get; set; }
/// <summary>
/// If true, the button will be disabled.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Behavior)]
public bool Disabled { get; set; }
/// <summary>
/// The variant to use.
/// </summary>
[Parameter]
[Category(CategoryTypes.Button.Appearance)]
public Variant Variant { get; set; } = Variant.Text;
public Task Toggle()
{
return SetToggledAsync(!Toggled);
}
protected internal async Task SetToggledAsync(bool toggled)
{
if (Disabled)
return;
if (Toggled != toggled)
{
Toggled = toggled;
await ToggledChanged.InvokeAsync(Toggled);
}
}
}

@ -0,0 +1,12 @@
@namespace Connected.Components
@inherits UIComponent
<Element HtmlTag="div" Class="@Classname" Style="@Style" Tag="@Tag" UserAttributes="@UserAttributes">
@ChildContent
</Element>
@{
if(!UserAttributes.ContainsKey("role"))
UserAttributes.Add("role", "group");
}

@ -0,0 +1,75 @@
using Connected.Annotations;
using Connected.Extensions;
using Connected.Utilities;
using Microsoft.AspNetCore.Components;
namespace Connected.Components;
public partial class ButtonGroup : UIComponent
{
protected string Classname =>
new CssBuilder("mud-button-group-root")
.AddClass($"mud-button-group-override-styles", OverrideStyles)
.AddClass($"mud-button-group-{Variant.ToDescriptionString()}")
.AddClass($"mud-button-group-{Variant.ToDescriptionString()}-{Color.ToDescriptionString()}")
.AddClass($"mud-button-group-{Variant.ToDescriptionString()}-size-{Size.ToDescriptionString()}")
.AddClass($"mud-button-group-vertical", VerticalAlign)
.AddClass($"mud-button-group-horizontal", !VerticalAlign)
.AddClass($"mud-button-group-disable-elevation", DisableElevation)
.AddClass($"mud-button-group-rtl", RightToLeft)
.AddClass(Class)
.Build();
[CascadingParameter(Name = "RightToLeft")]
public bool RightToLeft { get; set; }
/// <summary>
/// If true, the button group will override the styles of the individual buttons.
/// </summary>
[Parameter]
[Category(CategoryTypes.ButtonGroup.Appearance)]
public bool OverrideStyles { get; set; } = true;
/// <summary>
/// Child content of component.
/// </summary>
[Parameter]
[Category(CategoryTypes.ButtonGroup.Behavior)]
public RenderFragment ChildContent { get; set; }
/// <summary>
/// If true, the button group will be displayed vertically.
/// </summary>
[Parameter]
[Category(CategoryTypes.ButtonGroup.Appearance)]
public bool VerticalAlign { get; set; } = false;
/// <summary>
/// If true, no drop-shadow will be used.
/// </summary>
[Parameter]
[Category(CategoryTypes.ButtonGroup.Appearance)]
public bool DisableElevation { get; set; } = false;
/// <summary>
/// The color of the component. It supports the theme colors.
/// </summary>
[Parameter]
[Category(CategoryTypes.ButtonGroup.Appearance)]
public ThemeColor Color { get; set; } = ThemeColor.Default;
/// <summary>
/// The size of the component.
/// </summary>
[Parameter]
[Category(CategoryTypes.ButtonGroup.Appearance)]
public Size Size { get; set; } = Size.Medium;
/// <summary>
/// The variant to use.
/// </summary>
[Parameter]
[Category(CategoryTypes.ButtonGroup.Appearance)]
public Variant Variant { get; set; } = Variant.Text;
}

@ -0,0 +1,7 @@
@namespace Connected.Components
@inherits UIComponent
<Paper @attributes="UserAttributes" Class="@Classname" Style="@Style" Outlined="@Outlined" Square="@Square" Elevation="@Elevation">
@ChildContent
</Paper>

@ -0,0 +1,41 @@
using Connected.Annotations;
using Connected.Utilities;
using Microsoft.AspNetCore.Components;
namespace Connected.Components;
public partial class Card : UIComponent
{
protected string Classname =>
new CssBuilder("mud-card")
.AddClass(Class)
.Build();
/// <summary>
/// The higher the number, the heavier the drop-shadow. 0 for no shadow.
/// </summary>
[Parameter]
[Category(CategoryTypes.Card.Appearance)]
public int Elevation { set; get; } = 1;
/// <summary>
/// If true, border-radius is set to 0.
/// </summary>
[Parameter]
[Category(CategoryTypes.Card.Appearance)]
public bool Square { get; set; }
/// <summary>
/// If true, card will be outlined.
/// </summary>
[Parameter]
[Category(CategoryTypes.Card.Appearance)]
public bool Outlined { get; set; }
/// <summary>
/// Child content of the component.
/// </summary>
[Parameter]
[Category(CategoryTypes.Card.Behavior)]
public RenderFragment ChildContent { get; set; }
}

@ -0,0 +1,7 @@
@namespace Connected.Components
@inherits UIComponent
<div @attributes="UserAttributes" class="@Classname" style="@Style">
@ChildContent
</div>

@ -0,0 +1,20 @@
using Connected.Annotations;
using Connected.Utilities;
using Microsoft.AspNetCore.Components;
namespace Connected.Components;
public partial class CardActions : UIComponent
{
protected string Classname =>
new CssBuilder("mud-card-actions")
.AddClass(Class)
.Build();
/// <summary>
/// Child content of the component.
/// </summary>
[Parameter]
[Category(CategoryTypes.Card.Behavior)]
public RenderFragment ChildContent { get; set; }
}

@ -0,0 +1,7 @@
@namespace Connected.Components
@inherits UIComponent
<div @attributes="UserAttributes" class="@Classname" style="@Style">
@ChildContent
</div>

@ -0,0 +1,20 @@
using Connected.Annotations;
using Connected.Utilities;
using Microsoft.AspNetCore.Components;
namespace Connected.Components;
public partial class CardContent : UIComponent
{
protected string Classname =>
new CssBuilder("mud-card-content")
.AddClass(Class)
.Build();
/// <summary>
/// Child content of the component.
/// </summary>
[Parameter]
[Category(CategoryTypes.Card.Behavior)]
public RenderFragment ChildContent { get; set; }
}

@ -0,0 +1,22 @@
@namespace Connected.Components
@inherits UIComponent
<div @attributes="UserAttributes" class="@Classname" style="@Style">
@if (CardHeaderAvatar is not null)
{
<div class="mud-card-header-avatar">@CardHeaderAvatar</div>
}
@if (CardHeaderContent is not null)
{
<div class="mud-card-header-content">@CardHeaderContent</div>
}
@if (CardHeaderActions is not null)
{
<div class="mud-card-header-actions">@CardHeaderActions</div>
}
@if (ChildContent is not null)
{
@ChildContent
}
</div>

@ -0,0 +1,41 @@
using Connected.Annotations;
using Connected.Utilities;
using Microsoft.AspNetCore.Components;
namespace Connected.Components;
public partial class CardHeader : UIComponent
{
protected string Classname =>
new CssBuilder("mud-card-header")
.AddClass(Class)
.Build();
/// <summary>
/// If used renders child content of the CardHeaderAvatar.
/// </summary>
[Parameter]
[Category(CategoryTypes.Card.Behavior)]
public RenderFragment CardHeaderAvatar { get; set; }
/// <summary>
/// If used renders child content of the CardHeaderContent.
/// </summary>
[Parameter]
[Category(CategoryTypes.Card.Behavior)]
public RenderFragment CardHeaderContent { get; set; }
/// <summary>
/// If used renders child content of the CardHeaderActions.
/// </summary>
[Parameter]
[Category(CategoryTypes.Card.Behavior)]
public RenderFragment CardHeaderActions { get; set; }
/// <summary>
/// Optional child content
/// </summary>
[Parameter]
[Category(CategoryTypes.Card.Behavior)]
public RenderFragment ChildContent { get; set; }
}

@ -0,0 +1,5 @@
@namespace Connected.Components
@inherits UIComponent
<div @attributes="UserAttributes" title="@Title" class="@Classname" style="@StyleString"></div>

@ -0,0 +1,39 @@
using Connected.Annotations;
using Connected.Utilities;
using Microsoft.AspNetCore.Components;
namespace Connected.Components;
public partial class CardMedia : UIComponent
{
protected string StyleString =>
StyleBuilder.Default($"background-image:url(\"{Image}\");height: {Height}px;")
.AddStyle(this.Style)
.Build();
protected string Classname =>
new CssBuilder("mud-card-media")
.AddClass(Class)
.Build();
/// <summary>
/// Title of the image used for accessibility.
/// </summary>
[Parameter]
[Category(CategoryTypes.Card.Behavior)]
public string Title { get; set; }
/// <summary>
/// Specifies the path to the image.
/// </summary>
[Parameter]
[Category(CategoryTypes.Card.Behavior)]
public string Image { get; set; }
/// <summary>
/// Specifies the height of the image in px.
/// </summary>
[Parameter]
[Category(CategoryTypes.Card.Behavior)]
public int Height { get; set; } = 300;
}

@ -0,0 +1,84 @@
@namespace Connected.Components
@inherits BindableItemsControlBase<CarouselItem, TData>
@using Connected.Extensions
@implements IAsyncDisposable
@typeparam TData
<section @attributes="UserAttributes" aria-roledescription="carousel" class="@Classname" style="@Style">
<CascadingValue Value="this">
<SwipeArea OnSwipe="OnSwipe" Class="mud-carousel-swipe">
@*Selected Content*@
@if (ItemsSource == null)
{
@ChildContent
}
else
{
foreach (TData item in ItemsSource)
{
<CarouselItem>
@ItemTemplate(item)
</CarouselItem>
}
}
</SwipeArea>
@*Controls*@
<div class="d-flex flex-grow-1 align-self-auto">
@*Left Arrow*@
@if (ShowArrows)
{
@if (PreviousButtonTemplate == null)
{
<IconButton tabindex="1" aria-label="Go to previous" Class="@NavigationButtonsClassName" Style="z-index:3;opacity:0.75" Icon="@PreviousIcon" OnClick="Previous" Color="ThemeColor.Inherit" />
}
else
{
<div @onclick="Previous" tabindex="1" aria-label="Go to previous" class="@NavigationButtonsClassName" style="z-index:3">
@PreviousButtonTemplate
</div>
}
}
@*Bullets*@
<div class="@($"flex-grow-1 align-self-{ConvertPosition(BulletsPosition).ToDescriptionString()}")" style="z-index:3">
@if (ShowBullets)
{
<div class="d-flex justify-center">
@for (int i = 0; i < Items.Count; i++)
{
int current = i;
if (BulletTemplate == null)
{
<IconButton tabindex="@(i+3)" aria-label="@(i+1)" Class="@BulletsButtonsClassName" Style="z-index:3;opacity:0.75" Icon="@(current == SelectedIndex ? CheckedIcon : UncheckedIcon)" OnClick="(() => MoveTo(current))" Color="ThemeColor.Inherit" />
}
else
{
<div @onclick="() => MoveTo(current)" class="@BulletsButtonsClassName" style="z-index:3">
@BulletTemplate(current == SelectedIndex)
</div>
}
}
</div>
}
</div>
@*Right Arrow*@
@if (ShowArrows)
{
@if (NextButtonTemplate == null)
{
<IconButton tabindex="2" aria-label="Go to next" Class="@NavigationButtonsClassName" Style="z-index:3;opacity:0.75" Icon="@NextIcon" OnClick="Next" Color="ThemeColor.Inherit" />
}
else
{
<div @onclick="Next" tabindex="2" aria-label="Go to next" class="@NavigationButtonsClassName" style="z-index:3">
@NextButtonTemplate
</div>
}
}
</div>
</CascadingValue>
</section>

@ -0,0 +1,349 @@
using System.Diagnostics.CodeAnalysis;
using Connected.Annotations;
using Connected.Extensions;
using Connected.Utilities;
using Microsoft.AspNetCore.Components;
namespace Connected.Components;
public partial class Carousel<TData> : BindableItemsControlBase<CarouselItem, TData>, IAsyncDisposable
{
protected string Classname =>
new CssBuilder("mud-carousel")
.AddClass($"mud-carousel-{(BulletsColor ?? _currentColor).ToDescriptionString()}")
.AddClass(Class)
.Build();
protected string NavigationButtonsClassName =>
new CssBuilder()
.AddClass($"align-self-{ConvertPosition(ArrowsPosition).ToDescriptionString()}", !(NavigationButtonsClass ?? "").Contains("align-self-"))
.AddClass("mud-carousel-elements-rtl", RightToLeft)
.AddClass(NavigationButtonsClass)
.Build();
protected string BulletsButtonsClassName =>
new CssBuilder()
.AddClass(BulletsClass)
.Build();
private Timer _timer;
private bool _autoCycle = true;
private ThemeColor _currentColor = ThemeColor.Inherit;
private TimeSpan _cycleTimeout = TimeSpan.FromSeconds(5);
private void TimerElapsed(object stateInfo) => InvokeAsync(async () => await TimerTickAsync());
private static Position ConvertPosition(Position position)
{
return position switch
{
Position.Top => Position.Start,
Position.Start => Position.Start,
Position.Bottom => Position.End,
Position.End => Position.End,
_ => position
};
}
[CascadingParameter(Name = "RightToLeft")] public bool RightToLeft { get; set; }
/// <summary>
/// Gets or Sets if 'Next' and 'Previous' arrows must be visible
/// </summary>
[Parameter]
[Category(CategoryTypes.Carousel.Behavior)]
public bool ShowArrows { get; set; } = true;
/// <summary>
/// Sets the position of the arrows. By default, the position is the Center position
/// </summary>
[Parameter]
[Category(CategoryTypes.Carousel.Appearance)]
public Position ArrowsPosition { get; set; } = Position.Center;
/// <summary>
/// Gets or Sets if bar with Bullets must be visible
/// </summary>
[Category(CategoryTypes.Carousel.Behavior)]
[Parameter] public bool ShowBullets { get; set; } = true;
/// <summary>
/// Sets the position of the bullets. By default, the position is the Bottom position
/// </summary>
[Category(CategoryTypes.Carousel.Appearance)]
[Parameter] public Position BulletsPosition { get; set; } = Position.Bottom;
/// <summary>
/// Gets or Sets the Bullets color.
/// If not set, the color is determined based on the <see cref="MudCarouselItem.Color"/> property of the active child.
/// </summary>
[Category(CategoryTypes.Carousel.Appearance)]
[Parameter] public ThemeColor? BulletsColor { get; set; }
/// <summary>
/// Gets or Sets if bottom bar with Delimiters must be visible.
/// Deprecated, use ShowBullets instead.
/// </summary>
[Category(CategoryTypes.Carousel.Behavior)]
[Obsolete($"Use {nameof(ShowBullets)} instead", false)]
[ExcludeFromCodeCoverage]
[Parameter] public bool ShowDelimiters { get => ShowBullets; set => ShowBullets = value; }
/// <summary>
/// Gets or Sets the Delimiters color.
/// If not set, the color is determined based on the <see cref="MudCarouselItem.Color"/> property of the active child.
/// Deprecated, use BulletsColor instead.
/// </summary>
[Obsolete($"Use {nameof(BulletsColor)} instead", false)]
[Category(CategoryTypes.Carousel.Appearance)]
[ExcludeFromCodeCoverage]
[Parameter] public ThemeColor? DelimitersColor { get => BulletsColor; set => BulletsColor = value; }
/// <summary>
/// Gets or Sets automatic cycle on item collection.
/// </summary>
[Parameter]
[Category(CategoryTypes.Carousel.Behavior)]
public bool AutoCycle
{
get => _autoCycle;
set
{
_autoCycle = value;
if (_autoCycle)
InvokeAsync(async () => await ResetTimerAsync());
else
InvokeAsync(async () => await StopTimerAsync());
}
}
/// <summary>
/// Gets or Sets the Auto Cycle time
/// </summary>
[Parameter]
[Category(CategoryTypes.Carousel.Behavior)]
public TimeSpan AutoCycleTime
{
get => _cycleTimeout;
set
{
_cycleTimeout = value;
if (_autoCycle == true)
InvokeAsync(async () => await ResetTimerAsync());
else
InvokeAsync(async () => await StopTimerAsync());
}
}
/// <summary>
/// Gets or Sets custom class(es) for 'Next' and 'Previous' arrows
/// </summary>
[Parameter]
[Category(CategoryTypes.Carousel.Appearance)]
public string NavigationButtonsClass { get; set; }
/// <summary>
/// Gets or Sets custom class(es) for Bullets buttons
/// </summary>
[Category(CategoryTypes.Carousel.Appearance)]
[Parameter] public string BulletsClass { get; set; }
/// <summary>
/// Gets or Sets custom class(es) for Delimiters buttons.
/// Deprecated, use BulletsClass instead.
/// </summary>
[Category(CategoryTypes.Carousel.Appearance)]
[Obsolete($"Use {nameof(BulletsClass)} instead", false)]
[ExcludeFromCodeCoverage]
[Parameter] public string DelimitersClass { get => BulletsClass; set => BulletsClass = value; }
/// <summary>
/// Custom previous navigation icon.
/// </summary>
[Parameter]
[Category(CategoryTypes.Carousel.Appearance)]
public string PreviousIcon { get; set; } = Icons.Material.Filled.NavigateBefore;
/// <summary>
/// Custom selected bullet icon.
/// </summary>
[Parameter]
[Category(CategoryTypes.Carousel.Appearance)]
public string CheckedIcon { get; set; } = Icons.Material.Filled.RadioButtonChecked;
/// <summary>
/// Custom unselected bullet icon.
/// </summary>
[Parameter]
[Category(CategoryTypes.Carousel.Appearance)]
public string UncheckedIcon { get; set; } = Icons.Material.Filled.RadioButtonUnchecked;
/// <summary>
/// Custom next navigation icon.
/// </summary>
[Parameter]
[Category(CategoryTypes.Carousel.Appearance)]
public string NextIcon { get; set; } = Icons.Material.Filled.NavigateNext;
/// <summary>
/// Gets or Sets the Template for the Left Arrow
/// </summary>
[Parameter]
[Category(CategoryTypes.Carousel.Appearance)]
public RenderFragment NextButtonTemplate { get; set; }
/// <summary>
/// Gets or Sets the Template for the Right Arrow
/// </summary>
[Parameter]
[Category(CategoryTypes.Carousel.Appearance)]
public RenderFragment PreviousButtonTemplate { get; set; }
/// <summary>
/// Gets or Sets the Template for Bullets
/// </summary>
[Category(CategoryTypes.Carousel.Appearance)]
[Parameter] public RenderFragment<bool> BulletTemplate { get; set; }
/// <summary>
/// Gets or Sets if swipe gestures are allowed for touch devices.
/// </summary>
[Category(CategoryTypes.Carousel.Behavior)]
[Parameter]
public bool EnableSwipeGesture { get; set; } = true;
/// <summary>
/// Gets or Sets the Template for Delimiters.
/// Deprecated, use BulletsTemplate instead.
/// </summary>
[Category(CategoryTypes.Carousel.Appearance)]
[Obsolete($"Use {nameof(BulletTemplate)} instead", false)]
[ExcludeFromCodeCoverage]
[Parameter] public RenderFragment<bool> DelimiterTemplate { get => BulletTemplate; set => BulletTemplate = value; }
/// <summary>
/// Called when selected Index changed on base class
/// </summary>
protected override void SelectionChanged()
{
InvokeAsync(async () => await ResetTimerAsync());
_currentColor = SelectedContainer?.Color ?? ThemeColor.Inherit;
}
//When an item is added, it automatically checks the color
public override void AddItem(CarouselItem item)
{
Items.Add(item);
if (Items.Count - 1 == SelectedIndex)
{
_currentColor = item.Color;
StateHasChanged();
}
}
/// <summary>
/// Provides Selection changes by horizontal swipe gesture
/// </summary>
private void OnSwipe(SwipeDirection direction)
{
if (!EnableSwipeGesture)
{
return;
}
switch (direction)
{
case SwipeDirection.LeftToRight:
if (RightToLeft) Next();
else Previous();
break;
case SwipeDirection.RightToLeft:
if (RightToLeft) Previous();
else Next();
break;
}
}
/// <summary>
/// Immediately starts the AutoCycle timer
/// </summary>
private ValueTask StartTimerAsync()
{
if (AutoCycle)
_timer?.Change(AutoCycleTime, TimeSpan.Zero);
return ValueTask.CompletedTask;
}
/// <summary>
/// Immediately stops the AutoCycle timer
/// </summary>
private ValueTask StopTimerAsync()
{
_timer?.Change(Timeout.Infinite, Timeout.Infinite);
return ValueTask.CompletedTask;
}
/// <summary>
/// Stops and restart the AutoCycle timer
/// </summary>
private async ValueTask ResetTimerAsync()
{
await StopTimerAsync();
await StartTimerAsync();
}
/// <summary>
/// Changes the SelectedIndex to a next one (or restart on 0)
/// </summary>
private async ValueTask TimerTickAsync()
{
await InvokeAsync(Next);
}
protected override async Task OnAfterRenderAsync(bool firstRender)
{
await base.OnAfterRenderAsync(firstRender);
if (firstRender)
{
_timer = new Timer(TimerElapsed, null, AutoCycle ? AutoCycleTime : Timeout.InfiniteTimeSpan, AutoCycleTime);
}
}
public async ValueTask DisposeAsync()
{
await DisposeAsync(true);
GC.SuppressFinalize(this);
}
protected virtual async ValueTask DisposeAsync(bool disposing)
{
if (disposing)
{
await StopTimerAsync();
var timer = _timer;
if (timer != null)
{
_timer = null;
await timer.DisposeAsync();
}
}
}
}

@ -0,0 +1,10 @@
@namespace Connected.Components
@inherits UIComponent
@if (IsVisible)
{
<div @attributes="UserAttributes" class="@Classname" style="@Style">
@ChildContent
</div>
}

@ -0,0 +1,91 @@
using Connected.Annotations;
using Connected.Extensions;
using Connected.Utilities;
using Microsoft.AspNetCore.Components;
namespace Connected.Components;
public partial class CarouselItem : UIComponent, IDisposable
{
protected string Classname =>
new CssBuilder("mud-carousel-item")
.AddClass($"mud-carousel-item-{Color.ToDescriptionString()}")
.AddClass("mud-carousel-item-exit", !_disposed && Parent.LastContainer == this)
.AddClass("mud-carousel-transition-fade-in", !_disposed && Transition == Transition.Fade && Parent.SelectedContainer == this)
.AddClass("mud-carousel-transition-fade-out", !_disposed && Transition == Transition.Fade && Parent.LastContainer == this)
.AddClass("mud-carousel-transition-slide-next-enter", !_disposed && Transition == Transition.Slide && RightToLeft == false && Parent.SelectedContainer == this && Parent._moveNext)
.AddClass("mud-carousel-transition-slide-next-exit", !_disposed && Transition == Transition.Slide && RightToLeft == false && Parent.LastContainer == this && Parent._moveNext)
.AddClass("mud-carousel-transition-slide-prev-enter", !_disposed && Transition == Transition.Slide && RightToLeft == false && Parent.SelectedContainer == this && !Parent._moveNext)
.AddClass("mud-carousel-transition-slide-prev-exit", !_disposed && Transition == Transition.Slide && RightToLeft == false && Parent.LastContainer == this && !Parent._moveNext)
.AddClass("mud-carousel-transition-slide-next-rtl-enter", !_disposed && Transition == Transition.Slide && RightToLeft == true && Parent.SelectedContainer == this && Parent._moveNext)
.AddClass("mud-carousel-transition-slide-next-rtl-exit", !_disposed && Transition == Transition.Slide && RightToLeft == true && Parent.LastContainer == this && Parent._moveNext)
.AddClass("mud-carousel-transition-slide-prev-rtl-enter", !_disposed && Transition == Transition.Slide && RightToLeft == true && Parent.SelectedContainer == this && !Parent._moveNext)
.AddClass("mud-carousel-transition-slide-prev-rtl-exit", !_disposed && Transition == Transition.Slide && RightToLeft == true && Parent.LastContainer == this && !Parent._moveNext)
.AddClass("mud-carousel-transition-none", !_disposed && Transition == Transition.None && Parent.SelectedContainer != this)
.AddClass(CustomTransitionEnter, !_disposed && Transition == Transition.Custom && Parent.SelectedContainer == this && Parent.SelectedContainer == this)
.AddClass(CustomTransitionExit, !_disposed && Transition == Transition.Custom && Parent.LastContainer == this && Parent.LastContainer == this)
.AddClass(Class)
.Build();
[Parameter]
[Category(CategoryTypes.Carousel.Behavior)]
public RenderFragment ChildContent { get; set; }
[CascadingParameter] protected internal ItemsControlBase<CarouselItem> Parent { get; set; }
[CascadingParameter(Name = "RightToLeft")] public bool RightToLeft { get; set; }
/// <summary>
/// The color of the component. It supports the theme colors.
/// </summary>
[Parameter]
[Category(CategoryTypes.Carousel.Appearance)]
public ThemeColor Color { get; set; } = ThemeColor.Default;
/// <summary>
/// The transition effect of the component.
/// </summary>
[Parameter]
[Category(CategoryTypes.Carousel.Appearance)]
public Transition Transition { get; set; } = Transition.Slide;
/// <summary>
/// The name of custom transition on entrance time
/// </summary>
[Parameter]
[Category(CategoryTypes.Carousel.Appearance)]
public string CustomTransitionEnter { get; set; }
/// <summary>
/// The name of custom transition on exiting time
/// </summary>
[Parameter]
[Category(CategoryTypes.Carousel.Appearance)]
public string CustomTransitionExit { get; set; }
public bool IsVisible => Parent != null && (Parent.LastContainer == this || Parent.SelectedIndex == Parent.Items.IndexOf(this));
protected override Task OnInitializedAsync()
{
Parent?.AddItem(this);
return Task.CompletedTask;
}
private bool _disposed = false;
public void Dispose()
{
_disposed = true;
Parent?.Items.Remove(this);
}
}

@ -0,0 +1,25 @@
@namespace Connected.Components
@inherits UIComponent
<CascadingValue Value="@this" IsFixed="true">
<div @attributes="UserAttributes" class="@Classname" style="@Style" dir="ltr">
@if (ChartType == ChartType.Donut)
{
<Donut InputData="@InputData" @bind-SelectedIndex="@SelectedIndex" InputLabels="@InputLabels"></Donut>
}
@if (ChartType == ChartType.Pie)
{
<Pie InputData="@InputData" @bind-SelectedIndex="@SelectedIndex" InputLabels="@InputLabels"></Pie>
}
@if (ChartType == ChartType.Line)
{
<Line ChartSeries="@ChartSeries" @bind-SelectedIndex="@SelectedIndex" XAxisLabels="@XAxisLabels"></Line>
}
@if (ChartType == ChartType.Bar)
{
<Bar ChartSeries="@ChartSeries" @bind-SelectedIndex="@SelectedIndex" XAxisLabels="@XAxisLabels"></Bar>
}
</div>
</CascadingValue>

@ -0,0 +1,136 @@
using System.Globalization;
using Connected.Annotations;
using Connected.Extensions;
using Connected.Utilities;
using Microsoft.AspNetCore.Components;
namespace Connected.Components;
public partial class Chart : UIComponent
{
[Parameter]
[Category(CategoryTypes.Chart.Behavior)]
public double[] InputData { get; set; } = Array.Empty<double>();
[Parameter]
[Category(CategoryTypes.Chart.Behavior)]
public string[] InputLabels { get; set; } = Array.Empty<string>();
[Parameter]
[Category(CategoryTypes.Chart.Behavior)]
public string[] XAxisLabels { get; set; } = Array.Empty<string>();
[Parameter]
[Category(CategoryTypes.Chart.Behavior)]
public List<ChartSeries> ChartSeries { get; set; } = new();
[Parameter]
[Category(CategoryTypes.Chart.Appearance)]
public ChartOptions ChartOptions { get; set; } = new();
/// <summary>
/// RenderFragment for costumization inside the chart's svg.
/// </summary>
[Parameter]
[Category(CategoryTypes.Chart.Appearance)]
public RenderFragment CustomGraphics { get; set; }
protected string Classname =>
new CssBuilder("mud-chart")
.AddClass($"mud-chart-legend-{ConvertLegendPosition(LegendPosition).ToDescriptionString()}")
.AddClass(Class)
.Build();
[CascadingParameter(Name = "RightToLeft")] public bool RightToLeft { get; set; }
/// <summary>
/// The Type of the chart.
/// </summary>
[Parameter]
[Category(CategoryTypes.Chart.Behavior)]
public ChartType ChartType { get; set; }
/// <summary>
/// The Width of the chart, end with % or px.
/// </summary>
[Parameter]
[Category(CategoryTypes.Chart.Appearance)]
public string Width { get; set; } = "80%";
/// <summary>
/// The Height of the chart, end with % or px.
/// </summary>
[Parameter]
[Category(CategoryTypes.Chart.Appearance)]
public string Height { get; set; } = "80%";
/// <summary>
/// The placement direction of the legend if used.
/// </summary>
[Parameter]
[Category(CategoryTypes.Chart.Appearance)]
public Position LegendPosition { get; set; } = Position.Bottom;
private Position ConvertLegendPosition(Position position)
{
return position switch
{
Position.Start => RightToLeft ? Position.Right : Position.Left,
Position.End => RightToLeft ? Position.Left : Position.Right,
_ => position
};
}
private int _selectedIndex;
/// <summary>
/// Selected index of a portion of the chart.
/// </summary>
[Parameter]
[Category(CategoryTypes.Chart.Behavior)]
public int SelectedIndex
{
get => _selectedIndex;
set
{
if (value != _selectedIndex)
{
_selectedIndex = value;
SelectedIndexChanged.InvokeAsync(value);
}
}
}
/// <summary>
/// Selected index of a portion of the chart.
/// </summary>
[Parameter] public EventCallback<int> SelectedIndexChanged { get; set; }
/// <summary>
/// Scales the input data to the range between 0 and 1
/// </summary>
protected double[] GetNormalizedData()
{
if (InputData == null)
return Array.Empty<double>();
var total = InputData.Sum();
return InputData.Select(x => Math.Abs(x) / total).ToArray();
}
protected string ToS(double d, string format = null)
{
if (string.IsNullOrEmpty(format))
return d.ToString(CultureInfo.InvariantCulture);
return d.ToString(format);
}
}
public enum ChartType
{
Donut,
Line,
Pie,
Bar
}

@ -0,0 +1,45 @@
@namespace Connected.Components
@using System.Globalization;
@inherits Chart
<svg @attributes="UserAttributes" class="mud-chart-line mud-ltr" width="@ChartParent?.Width" height="@ChartParent?.Height" viewBox="0 0 650 350">
<g class="mud-charts-grid">
<g class="mud-charts-gridlines-yaxis">
@foreach (var horizontalLine in _horizontalLines)
{
<path stroke="#e0e0e0" stroke-width="0.3" d="@horizontalLine.Data"></path>
}
</g>
@if (ChartParent?.ChartOptions.XAxisLines==true)
{
<g class="mud-charts-gridlines-xaxis-lines">
@foreach (var verticalLine in _verticalLines)
{
<path stroke="gray" stroke-width="0.3" d="@verticalLine.Data"></path>
}
</g>
}
</g>
<g class="mud-charts-yaxis">
@foreach (var horizontalLineValue in _horizontalValues)
{
@((MarkupString)$"<text x='{horizontalLineValue.X.ToString(CultureInfo.InvariantCulture)}' y='{horizontalLineValue.Y.ToString(CultureInfo.InvariantCulture)}' font-size='12px' text-anchor='end' dominant-baseline='auto'>{horizontalLineValue.Value.ToString(CultureInfo.InvariantCulture)}</text>")
}
</g>
<g class="mud-charts-xaxis">
@foreach (var verticalLineValue in _verticalValues)
{
@((MarkupString)$"<text x='{verticalLineValue.X.ToString(CultureInfo.InvariantCulture)}' y='{verticalLineValue.Y.ToString(CultureInfo.InvariantCulture)}' font-size='12px' text-anchor='middle'>{verticalLineValue.Value.ToString(CultureInfo.InvariantCulture)}</text>")
}
</g>
<g class="mud-charts-bar-series">
@foreach (var bar in _bars)
{
<path class="mud-chart-bar" @onclick="() => SelectedIndex = bar.Index" fill="@(ChartParent.ChartOptions.ChartPalette.GetValue(bar.Index % ChartOptions.ChartPalette.Count()))" stroke="@(ChartParent.ChartOptions.ChartPalette.GetValue(bar.Index % ChartOptions.ChartPalette.Count()))" stroke-width="8" d="@bar.Data"></path>
}
</g>
@ChartParent?.CustomGraphics
</svg>
<Legend Data="@_legends" />

@ -0,0 +1,150 @@
using Microsoft.AspNetCore.Components;
namespace Connected.Components;
partial class Bar : Chart
{
[CascadingParameter] public Chart ChartParent { get; set; }
private List<SvgPath> _horizontalLines = new();
private List<SvgText> _horizontalValues = new();
private List<SvgPath> _verticalLines = new();
private List<SvgText> _verticalValues = new();
private List<SvgLegend> _legends = new();
private List<ChartSeries> _series = new();
private List<SvgPath> _bars = new();
protected override void OnParametersSet()
{
base.OnParametersSet();
_horizontalLines.Clear();
_verticalLines.Clear();
_horizontalValues.Clear();
_verticalValues.Clear();
_legends.Clear();
_bars.Clear();
if (ChartParent != null)
_series = ChartParent.ChartSeries;
var maxY = 0.0;
var numValues = 0;
var numXLabels = XAxisLabels.Length;
foreach (var item in _series)
{
if (numValues < item.Data.Length)
{
numValues = item.Data.Length;
}
foreach (int i in item.Data)
{
if (maxY < i)
{
maxY = i;
}
}
}
var boundHeight = 350.0;
var boundWidth = 650.0;
double gridYUnits = ChartParent?.ChartOptions.YAxisTicks ?? 20;
double gridXUnits = 30;
var numVerticalLines = numValues - 1;
var numHorizontalLines = ((int)(maxY / gridYUnits)) + 1;
var verticalStartSpace = 25.0;
var horizontalStartSpace = 30.0;
var verticalEndSpace = 25.0;
var horizontalEndSpace = 30.0;
var verticalSpace = (boundHeight - verticalStartSpace - verticalEndSpace) / (numHorizontalLines);
var horizontalSpace = (boundWidth - horizontalStartSpace - horizontalEndSpace) / (numVerticalLines);
//Horizontal Grid Lines
var y = verticalStartSpace;
double startGridY = 0;
for (var counter = 0; counter <= numHorizontalLines; counter++)
{
var line = new SvgPath()
{
Index = counter,
Data = $"M {ToS(horizontalStartSpace)} {ToS((boundHeight - y))} L {ToS((boundWidth - horizontalEndSpace))} {ToS((boundHeight - y))}"
};
_horizontalLines.Add(line);
var lineValue = new SvgText() { X = (horizontalStartSpace - 10), Y = (boundHeight - y + 5), Value = ToS(startGridY, ChartParent?.ChartOptions.YAxisFormat) };
_horizontalValues.Add(lineValue);
startGridY += gridYUnits;
y += verticalSpace;
}
//Vertical Grid Lines
var x = horizontalStartSpace;
double startGridX = 0;
for (var counter = 0; counter <= numVerticalLines; counter++)
{
var line = new SvgPath()
{
Index = counter,
Data = $"M {ToS(x)} {ToS((boundHeight - verticalStartSpace))} L {ToS(x)} {ToS(verticalEndSpace)}"
};
_verticalLines.Add(line);
var xLabels = "";
if (counter < numXLabels)
{
xLabels = XAxisLabels[counter];
}
var lineValue = new SvgText() { X = x, Y = boundHeight - 2, Value = xLabels };
_verticalValues.Add(lineValue);
startGridX += gridXUnits;
x += horizontalSpace;
}
//Bars
var colorcounter = 0;
double barsPerSeries = 0;
foreach (var item in _series)
{
double gridValueX = horizontalStartSpace + barsPerSeries;
double gridValueY = boundHeight - verticalStartSpace;
foreach (var dataLine in item.Data)
{
var dataValue = dataLine * verticalSpace / gridYUnits;
var gridValue = gridValueY - dataValue;
var bar = $"M {ToS(gridValueX)} {ToS(gridValueY)} L {ToS(gridValueX)} {ToS(gridValue)}";
gridValueX += horizontalSpace;
var line = new SvgPath()
{
Index = colorcounter,
Data = bar
};
_bars.Add(line);
}
barsPerSeries += 10;
var legend = new SvgLegend()
{
Index = colorcounter,
Labels = item.Name
};
colorcounter++;
_legends.Add(legend);
}
}
}

@ -0,0 +1,22 @@
@namespace Connected.Components
@using System.Globalization
@inherits Chart
<svg @attributes="UserAttributes" class="mud-chart-donut" width="@ParentWidth" height="@ParentHeight" viewBox="0 0 42 42">
<Filters />
<circle class="mud-donut-ring" cx="21" cy="21" r="15.91549430918954"></circle>
@foreach (var item in _circles.ToList())
{
<circle class="mud-chart-serie mud-donut-segment" @onclick="() => SelectedIndex = item.Index" stroke="@(ChartParent.ChartOptions.ChartPalette.GetValue(item.Index % ChartOptions.ChartPalette.Count()))"
cx="@ToS(item.CX)"
cy="@ToS(item.CY)"
r="@ToS(item.Radius)"
stroke-dasharray="@item.StrokeDashArray"
stroke-dashoffset="@ToS(item.StrokeDashOffset)">
</circle>
}
<circle class="mud-donut-hole" cx="21" cy="21" r="13.4"></circle>
@ChartParent?.CustomGraphics
</svg>
<Legend Data="@_legends" />

@ -0,0 +1,60 @@
using Microsoft.AspNetCore.Components;
namespace Connected.Components;
partial class Donut : Chart
{
[CascadingParameter] public Chart ChartParent { get; set; }
private List<SvgCircle> _circles = new();
private List<SvgLegend> _legends = new();
protected string ParentWidth => ChartParent?.Width;
protected string ParentHeight => ChartParent?.Height;
protected override void OnParametersSet()
{
_circles.Clear();
_legends.Clear();
double counterClockwiseOffset = 25;
double totalPercent = 0;
double offset;
var counter = 0;
foreach (var data in GetNormalizedData())
{
var percent = data * 100;
var reversePercent = 100 - percent;
offset = 100 - totalPercent + counterClockwiseOffset;
totalPercent += percent;
var circle = new SvgCircle()
{
Index = counter,
CX = 21,
CY = 21,
Radius = 15.91549430918954,
StrokeDashArray = $"{ToS(percent)} {ToS(reversePercent)}",
StrokeDashOffset = offset
};
_circles.Add(circle);
var labels = "";
if (counter < InputLabels.Length)
{
labels = InputLabels[counter];
}
var legend = new SvgLegend()
{
Index = counter,
Labels = labels,
Data = data.ToString()
};
_legends.Add(legend);
counter += 1;
}
}
}

@ -0,0 +1,44 @@
@namespace Connected.Components
@using System.Globalization;
@inherits Chart
<svg @attributes="UserAttributes" class="mud-chart-line mud-ltr" width="@ChartParent?.Width" height="@ChartParent?.Height" viewBox="0 0 650 350">
<g class="mud-charts-grid">
<g class="mud-charts-gridlines-yaxis">
@foreach (var horizontalLine in _horizontalLines)
{
<path stroke="#e0e0e0" stroke-width="0.3" d="@horizontalLine.Data"></path>
}
</g>
@if (ChartParent?.ChartOptions.XAxisLines==true)
{
<g class="mud-charts-gridlines-xaxis-lines">
@foreach (var verticalLine in _verticalLines)
{
<path stroke="gray" stroke-width="0.3" d="@verticalLine.Data"></path>
}
</g>
}
</g>
<g class="mud-charts-yaxis">
@foreach (var horizontalLineValue in _horizontalValues)
{
@((MarkupString)$"<text x='{horizontalLineValue.X.ToString(CultureInfo.InvariantCulture)}' y='{horizontalLineValue.Y.ToString(CultureInfo.InvariantCulture)}' font-size='12px' text-anchor='end' dominant-baseline='auto'>{horizontalLineValue.Value.ToString(CultureInfo.InvariantCulture)}</text>")
}
</g>
<g class="mud-charts-xaxis">
@foreach (var verticalLineValue in _verticalValues)
{
@((MarkupString)$"<text x='{verticalLineValue.X.ToString(CultureInfo.InvariantCulture)}' y='{verticalLineValue.Y.ToString(CultureInfo.InvariantCulture)}' font-size='12px' text-anchor='middle'>{verticalLineValue.Value.ToString(CultureInfo.InvariantCulture)}</text>")
}
</g>
<g class="mud-charts-line-series">
@foreach (var chartLine in _chartLines)
{
<path class="mud-chart-line" @onclick="() => SelectedIndex = chartLine.Index" fill="none" stroke="@(ChartParent.ChartOptions.ChartPalette.GetValue(chartLine.Index % ChartOptions.ChartPalette.Count()))" stroke-width="@(ChartParent.ChartOptions.LineStrokeWidth)" d="@chartLine.Data"></path>
}
</g>
@ChartParent?.CustomGraphics
</svg>
<Legend Data="@_legends" />

@ -0,0 +1,231 @@
using Microsoft.AspNetCore.Components;
namespace Connected.Components;
partial class Line : Chart
{
private const int MaxHorizontalGridLines = 100;
[CascadingParameter] public Chart ChartParent { get; set; }
private List<SvgPath> _horizontalLines = new();
private List<SvgText> _horizontalValues = new();
private List<SvgPath> _verticalLines = new();
private List<SvgText> _verticalValues = new();
private List<SvgLegend> _legends = new();
private List<ChartSeries> _series = new();
private List<SvgPath> _chartLines = new();
protected override void OnParametersSet()
{
base.OnParametersSet();
_horizontalLines.Clear();
_verticalLines.Clear();
_horizontalValues.Clear();
_verticalValues.Clear();
_legends.Clear();
_chartLines.Clear();
if (ChartParent != null)
_series = ChartParent.ChartSeries;
var maxY = 0.0;
var numValues = 0;
var numXLabels = XAxisLabels.Length;
foreach (var item in _series)
{
if (numValues < item.Data.Length)
{
numValues = item.Data.Length;
}
foreach (int i in item.Data)
{
if (maxY < i)
{
maxY = i;
}
}
}
var boundHeight = 350.0;
var boundWidth = 650.0;
double gridYUnits = ChartParent?.ChartOptions.YAxisTicks ?? 20;
if (gridYUnits <= 0)
gridYUnits = 20;
int maxYTicks = ChartParent?.ChartOptions.MaxNumYAxisTicks ?? 100;
double gridXUnits = 30;
var numVerticalLines = numValues - 1;
var numHorizontalLines = ((int)(maxY / gridYUnits)) + 1;
// this is a safeguard against millions of gridlines which might arise with very high values
while (numHorizontalLines > maxYTicks)
{
gridYUnits *= 2;
numHorizontalLines = ((int)(maxY / gridYUnits)) + 1;
}
var verticalStartSpace = 25.0;
var horizontalStartSpace = 30.0;
var verticalEndSpace = 25.0;
var horizontalEndSpace = 30.0;
var verticalSpace = (boundHeight - verticalStartSpace - verticalEndSpace) / (numHorizontalLines);
var horizontalSpace = (boundWidth - horizontalStartSpace - horizontalEndSpace) / (numVerticalLines);
var interpolationOption = ChartParent?.ChartOptions.InterpolationOption ?? InterpolationOption.Straight;
//Horizontal Grid Lines
var y = verticalStartSpace;
double startGridY = 0;
for (var counter = 0; counter <= numHorizontalLines; counter++)
{
var line = new SvgPath()
{
Index = counter,
Data = $"M {ToS(horizontalStartSpace)} {ToS((boundHeight - y))} L {ToS((boundWidth - horizontalEndSpace))} {ToS((boundHeight - y))}"
};
_horizontalLines.Add(line);
var lineValue = new SvgText() { X = (horizontalStartSpace - 10), Y = (boundHeight - y + 5), Value = ToS(startGridY, ChartParent?.ChartOptions.YAxisFormat) };
_horizontalValues.Add(lineValue);
startGridY += gridYUnits;
y += verticalSpace;
}
//Vertical Grid Lines
var x = horizontalStartSpace;
double startGridX = 0;
for (var counter = 0; counter <= numVerticalLines; counter++)
{
var line = new SvgPath()
{
Index = counter,
Data = $"M {ToS(x)} {ToS((boundHeight - verticalStartSpace))} L {ToS(x)} {ToS(verticalEndSpace)}"
};
_verticalLines.Add(line);
var xLabels = "";
if (counter < numXLabels)
{
xLabels = XAxisLabels[counter];
}
var lineValue = new SvgText() { X = x, Y = boundHeight - 2, Value = xLabels };
_verticalValues.Add(lineValue);
startGridX += gridXUnits;
x += horizontalSpace;
}
//Chart Lines
var colorcounter = 0;
foreach (var item in _series)
{
var chartLine = "";
double gridValueX = 0;
double gridValueY = 0;
var firstTime = true;
double[] XValues = new double[item.Data.Length];
double[] YValues = new double[item.Data.Length];
ILineInterpolator interpolator;
for (var i = 0; i <= item.Data.Length - 1; i++)
{
if (i == 0)
XValues[i] = 30;
else
XValues[i] = XValues[i - 1] + horizontalSpace;
var gridValue = (item.Data[i]) * verticalSpace / gridYUnits;
YValues[i] = boundHeight - (verticalStartSpace + gridValue);
}
switch (interpolationOption)
{
case InterpolationOption.NaturalSpline:
interpolator = new NaturalSpline(XValues, YValues);
break;
case InterpolationOption.EndSlope:
interpolator = new EndSlopeSpline(XValues, YValues);
break;
case InterpolationOption.Periodic:
interpolator = new PeriodicSpline(XValues, YValues);
break;
case InterpolationOption.Straight:
default:
interpolator = new NoInterpolation();
break;
}
if (interpolator?.InterpolationRequired == true)
{
horizontalSpace = (boundWidth - horizontalStartSpace - horizontalEndSpace) / interpolator.InterpolatedXs.Length;
foreach (var yValue in interpolator.InterpolatedYs)
{
if (firstTime)
{
chartLine += "M ";
firstTime = false;
gridValueX = horizontalStartSpace;
gridValueY = verticalStartSpace;
}
else
{
chartLine += " L ";
gridValueX += horizontalSpace;
gridValueY = verticalStartSpace;
}
gridValueY = yValue;
chartLine = chartLine + ToS(gridValueX) + " " + ToS(gridValueY);
}
}
else
{
foreach (var dataLine in item.Data)
{
if (firstTime)
{
chartLine += "M ";
firstTime = false;
gridValueX = horizontalStartSpace;
gridValueY = verticalStartSpace;
}
else
{
chartLine += " L ";
gridValueX += horizontalSpace;
gridValueY = verticalStartSpace;
}
var gridValue = ((double)dataLine) * verticalSpace / gridYUnits;
gridValueY = boundHeight - (gridValueY + gridValue);
chartLine = chartLine + ToS(gridValueX) + " " + ToS(gridValueY);
}
}
var line = new SvgPath()
{
Index = colorcounter,
Data = chartLine
};
var legend = new SvgLegend()
{
Index = colorcounter,
Labels = item.Name
};
colorcounter++;
_chartLines.Add(line);
_legends.Add(legend);
}
}
}

@ -0,0 +1,14 @@
@namespace Connected.Components
@using System.Globalization
@inherits Chart
<svg @attributes="UserAttributes" class="mud-chart-pie" width="@ChartParent?.Width" height="@ChartParent?.Height" viewBox="-1 -1 2 2" style="transform: rotate(-90deg);">
<Filters />
@foreach (var item in _paths.ToList())
{
<path @onclick="() => SelectedIndex = item.Index" class="mud-chart-serie" fill="@(ChartParent.ChartOptions.ChartPalette.GetValue(item.Index % ChartOptions.ChartPalette.Count()))" d="@item.Data"></path>
}
@ChartParent?.CustomGraphics
</svg>
<Legend Data="@_legends" />

@ -0,0 +1,55 @@
using Microsoft.AspNetCore.Components;
namespace Connected.Components;
partial class Pie : Chart
{
[CascadingParameter] public Chart ChartParent { get; set; }
private List<SvgPath> _paths = new();
private List<SvgLegend> _legends = new();
protected override void OnParametersSet()
{
_paths.Clear();
_legends.Clear();
double startx, starty, endx, endy;
var ndata = GetNormalizedData();
double cumulativeRadians = 0;
for (var i = 0; i < ndata.Length; i++)
{
var data = ndata[i];
startx = Math.Cos(cumulativeRadians);
starty = Math.Sin(cumulativeRadians);
cumulativeRadians += 2 * Math.PI * data;
endx = Math.Cos(cumulativeRadians);
endy = Math.Sin(cumulativeRadians);
var largeArcFlag = data > 0.5 ? 1 : 0;
var path = new SvgPath()
{
Index = i,
Data = $"M {ToS(startx)} {ToS(starty)} A 1 1 0 {ToS(largeArcFlag)} 1 {ToS(endx)} {ToS(endy)} L 0 0"
};
_paths.Add(path);
}
var counter = 0;
foreach (var data in ndata)
{
var percent = data * 100;
var labels = "";
if (counter < InputLabels.Length)
{
labels = InputLabels[counter];
}
var legend = new SvgLegend()
{
Index = counter,
Labels = labels,
Data = ToS(Math.Round(percent, 1))
};
_legends.Add(legend);
counter += 1;
}
}
}

@ -0,0 +1,75 @@
/*
* Work in this file is derived from code originally written by Hans-Peter Moser:
* http://www.mosismath.com/AngleSplines/EndSlopeSplines.html
*/
namespace Connected.Components;
public class EndSlopeSpline : SplineInterpolator
{
public EndSlopeSpline(double[] xs, double[] ys,
int resolution = 10, double firstSlopeDegrees = 0, double lastSlopeDegrees = 0) :
base(xs, ys, resolution)
{
m = new Matrix(n);
gauss = new MatrixSolver(n, m);
a = new double[n];
b = new double[n];
c = new double[n];
d = new double[n];
h = new double[n];
CalcParameters(firstSlopeDegrees, lastSlopeDegrees);
Integrate();
Interpolate();
}
public void CalcParameters(double alpha, double beta)
{
for (int i = 0; i < n; i++)
a[i] = GivenYs[i];
for (int i = 0; i < n - 1; i++)
h[i] = GivenXs[i + 1] - GivenXs[i];
m.a[0, 0] = 2.0 * h[0];
m.a[0, 1] = h[0];
m.y[0] = 3 * ((a[1] - a[0]) / h[0] - Math.Tan(alpha * Math.PI / 180));
for (int i = 0; i < n - 2; i++)
{
m.a[i + 1, i] = h[i];
m.a[i + 1, i + 1] = 2.0 * (h[i] + h[i + 1]);
if (i < n - 2)
m.a[i + 1, i + 2] = h[i + 1];
if ((h[i] != 0.0) && (h[i + 1] != 0.0))
m.y[i + 1] = ((a[i + 2] - a[i + 1]) / h[i + 1] - (a[i + 1] - a[i]) / h[i]) * 3.0;
else
m.y[i + 1] = 0.0;
}
m.a[n - 1, n - 2] = h[n - 2];
m.a[n - 1, n - 1] = 2.0 * h[n - 2];
m.y[n - 1] = 3.0 * (Math.Tan(beta * Math.PI / 180) - (a[n - 1] - a[n - 2]) / h[n - 2]);
if (gauss.Eliminate() == false)
throw new InvalidOperationException();
gauss.Solve();
for (int i = 0; i < n; i++)
{
c[i] = m.x[i];
}
for (int i = 0; i < n; i++)
{
if (h[i] != 0.0)
{
d[i] = 1.0 / 3.0 / h[i] * (c[i + 1] - c[i]);
b[i] = 1.0 / h[i] * (a[i + 1] - a[i]) - h[i] / 3.0 * (c[i + 1] + 2 * c[i]);
}
}
}
}

@ -0,0 +1,11 @@
namespace Connected.Components;
public interface ILineInterpolator
{
public double[] GivenYs { get; set; }
public double[] GivenXs { get; set; }
public double[] InterpolatedXs { get; set; }
public double[] InterpolatedYs { get; set; }
public bool InterpolationRequired { get; set; }
}

@ -0,0 +1,15 @@
namespace Connected.Components;
public class Matrix
{
public double[,] a;
public double[] y;
public double[] x;
public Matrix(int size)
{
a = new double[size, size];
y = new double[size];
x = new double[size];
}
}

@ -0,0 +1,89 @@
/*
* Work in this file is derived from code originally written by Hans-Peter Moser:
* http://www.mosismath.com/Basics/Basics.html
* http://www.mosismath.com/Matrix_Gauss/MatrixGauss.html
*/
namespace Connected.Components;
// Matrix equation solver using the Gaussian elimination algorithm
public class MatrixSolver
{
public readonly Matrix m;
public readonly int maxOrder;
public bool calcError;
public MatrixSolver(int size, Matrix mi)
{
maxOrder = size;
m = mi;
}
void SwitchRows(int n)
{
double tempD;
int i, j;
for (i = n; i <= maxOrder - 2; i++)
{
for (j = 0; j <= maxOrder - 1; j++)
{
tempD = m.a[i, j];
m.a[i, j] = m.a[i + 1, j];
m.a[i + 1, j] = tempD;
}
tempD = m.y[i];
m.y[i] = m.y[i + 1];
m.y[i + 1] = tempD;
}
}
public bool Eliminate()
{
int i, k, l;
calcError = false;
for (k = 0; k <= maxOrder - 2; k++)
{
for (i = k; i <= maxOrder - 2; i++)
{
if (Math.Abs(m.a[i + 1, i]) < 1e-8)
{
SwitchRows(i + 1);
}
if (m.a[i + 1, k] != 0.0)
{
for (l = k + 1; l <= maxOrder - 1; l++)
{
if (!calcError)
{
m.a[i + 1, l] = m.a[i + 1, l] * m.a[k, k] - m.a[k, l] * m.a[i + 1, k];
if (m.a[i + 1, l] > 10E260)
{
m.a[i + 1, k] = 0;
calcError = true;
}
}
}
m.y[i + 1] = m.y[i + 1] * m.a[k, k] - m.y[k] * m.a[i + 1, k];
m.a[i + 1, k] = 0;
}
}
}
return !calcError;
}
public void Solve()
{
int k, l;
for (k = maxOrder - 1; k >= 0; k--)
{
for (l = maxOrder - 1; l >= k; l--)
{
m.y[k] = m.y[k] - m.x[l] * m.a[k, l];
}
if (m.a[k, k] != 0)
m.x[k] = m.y[k] / m.a[k, k];
else
m.x[k] = 0;
}
}
}

@ -0,0 +1,87 @@
/*
* Work in this file is derived from code originally written by Hans-Peter Moser:
* http://www.mosismath.com/NaturalSplines/NaturalSplines.html
*/
namespace Connected.Components;
public class NaturalSpline : SplineInterpolator
{
/// <summary>
/// Natural Spline data interpolator
/// </summary>
public NaturalSpline(double[] xs, double[] ys, int resolution = 10) : base(xs, ys, resolution)
{
m = new Matrix(n - 2);
gauss = new MatrixSolver(n - 2, m);
a = new double[n];
b = new double[n];
c = new double[n];
d = new double[n];
h = new double[n - 1];
CalcParameters();
Integrate();
Interpolate();
}
public void CalcParameters()
{
for (int i = 0; i < n; i++)
a[i] = GivenYs[i];
for (int i = 0; i < n - 1; i++)
h[i] = GivenXs[i + 1] - GivenXs[i];
for (int i = 0; i < n - 2; i++)
{
for (int k = 0; k < n - 2; k++)
{
m.a[i, k] = 0.0;
m.y[i] = 0.0;
m.x[i] = 0.0;
}
}
for (int i = 0; i < n - 2; i++)
{
if (i == 0)
{
m.a[i, 0] = 2.0 * (h[0] + h[1]);
m.a[i, 1] = h[1];
}
else
{
m.a[i, i - 1] = h[i];
m.a[i, i] = 2.0 * (h[i] + h[i + 1]);
if (i < n - 3)
m.a[i, i + 1] = h[i + 1];
}
if ((h[i] != 0.0) && (h[i + 1] != 0.0))
m.y[i] = ((a[i + 2] - a[i + 1]) / h[i + 1] - (a[i + 1] - a[i]) / h[i]) * 3.0;
else
m.y[i] = 0.0;
}
if (gauss.Eliminate() == false)
throw new InvalidOperationException("error in matrix calculation");
gauss.Solve();
c[0] = 0.0;
c[n - 1] = 0.0;
for (int i = 1; i < n - 1; i++)
c[i] = m.x[i - 1];
for (int i = 0; i < n - 1; i++)
{
if (h[i] != 0.0)
{
d[i] = 1.0 / 3.0 / h[i] * (c[i + 1] - c[i]);
b[i] = 1.0 / h[i] * (a[i + 1] - a[i]) - h[i] / 3.0 * (c[i + 1] + 2 * c[i]);
}
}
}
}

@ -0,0 +1,10 @@
namespace Connected.Components;
public class NoInterpolation : ILineInterpolator
{
public double[] GivenYs { get; set; }
public double[] GivenXs { get; set; }
public double[] InterpolatedXs { get; set; }
public double[] InterpolatedYs { get; set; }
public bool InterpolationRequired { get; set; } = false;
}

@ -0,0 +1,86 @@
/*
* Work in this file is derived from code originally written by Hans-Peter Moser:
* http://www.mosismath.com/PeriodicSplines/PeriodicSplines.html
*/
namespace Connected.Components;
public class PeriodicSpline : SplineInterpolator
{
public PeriodicSpline(double[] xs, double[] ys, int resolution = 10) : base(xs, ys, resolution)
{
m = new Matrix(n - 1);
gauss = new MatrixSolver(n - 1, m);
a = new double[n + 1];
b = new double[n + 1];
c = new double[n + 1];
d = new double[n + 1];
h = new double[n];
CalcParameters();
Integrate();
Interpolate();
}
public void CalcParameters()
{
for (int i = 0; i < n; i++)
a[i] = GivenYs[i];
for (int i = 0; i < n - 1; i++)
h[i] = GivenXs[i + 1] - GivenXs[i];
a[n] = GivenYs[1];
h[n - 1] = h[0];
for (int i = 0; i < n - 1; i++)
for (int k = 0; k < n - 1; k++)
{
m.a[i, k] = 0.0;
m.y[i] = 0.0;
m.x[i] = 0.0;
}
for (int i = 0; i < n - 1; i++)
{
if (i == 0)
{
m.a[i, 0] = 2.0 * (h[0] + h[1]);
m.a[i, 1] = h[1];
}
else
{
m.a[i, i - 1] = h[i];
m.a[i, i] = 2.0 * (h[i] + h[i + 1]);
if (i < n - 2)
m.a[i, i + 1] = h[i + 1];
}
if ((h[i] != 0.0) && (h[i + 1] != 0.0))
m.y[i] = ((a[i + 2] - a[i + 1]) / h[i + 1] - (a[i + 1] - a[i]) / h[i]) * 3.0;
else
m.y[i] = 0.0;
}
m.a[0, n - 2] = h[0];
m.a[n - 2, 0] = h[0];
if (gauss.Eliminate() == false)
throw new InvalidOperationException();
gauss.Solve();
for (int i = 1; i < n; i++)
c[i] = m.x[i - 1];
c[0] = c[n - 1];
for (int i = 0; i < n; i++)
{
if (h[i] != 0.0)
{
d[i] = 1.0 / 3.0 / h[i] * (c[i + 1] - c[i]);
b[i] = 1.0 / h[i] * (a[i + 1] - a[i]) - h[i] / 3.0 * (c[i + 1] + 2 * c[i]);
}
}
}
}

@ -0,0 +1,83 @@
namespace Connected.Components;
public abstract class SplineInterpolator : ILineInterpolator
{
protected Matrix m;
protected MatrixSolver gauss;
protected readonly int n;
protected double[] a, b, c, d, h;
public double[] GivenYs { get; set; }
public double[] GivenXs { get; set; }
public double[] InterpolatedXs { get; set; }
public double[] InterpolatedYs { get; set; }
public bool InterpolationRequired { get; set; } = true;
public SplineInterpolator(double[] xs, double[] ys, int resolution = 10)
{
if (xs is null || ys is null)
throw new ArgumentException("xs and ys cannot be null");
if (xs.Length != ys.Length)
throw new ArgumentException("xs and ys must have the same length");
if (xs.Length < 4)
throw new ArgumentException("xs and ys must have a length of 4 or greater");
if (resolution < 1)
throw new ArgumentException("resolution must be 1 or greater");
GivenXs = xs;
GivenYs = ys;
n = xs.Length;
InterpolatedXs = new double[n * resolution];
InterpolatedYs = new double[n * resolution];
}
public void Interpolate()
{
int resolution = InterpolatedXs.Length / n;
for (int i = 0; i < h.Length; i++)
{
for (int k = 0; k < resolution; k++)
{
double deltaX = (double)k / resolution * h[i];
double termA = a[i];
double termB = b[i] * deltaX;
double termC = c[i] * deltaX * deltaX;
double termD = d[i] * deltaX * deltaX * deltaX;
int interpolatedIndex = i * resolution + k;
InterpolatedXs[interpolatedIndex] = deltaX + GivenXs[i];
InterpolatedYs[interpolatedIndex] = termA + termB + termC + termD;
}
}
// After interpolation the last several values of the interpolated arrays
// contain uninitialized data. This section identifies the values which are
// populated with values and copies just the useful data into new arrays.
int pointsToKeep = resolution * (n - 1) + 1;
double[] interpolatedXsCopy = new double[pointsToKeep];
double[] interpolatedYsCopy = new double[pointsToKeep];
Array.Copy(InterpolatedXs, 0, interpolatedXsCopy, 0, pointsToKeep - 1);
Array.Copy(InterpolatedYs, 0, interpolatedYsCopy, 0, pointsToKeep - 1);
InterpolatedXs = interpolatedXsCopy;
InterpolatedYs = interpolatedYsCopy;
InterpolatedXs[pointsToKeep - 1] = GivenXs[n - 1];
InterpolatedYs[pointsToKeep - 1] = GivenYs[n - 1];
}
public double Integrate()
{
double integral = 0;
for (int i = 0; i < h.Length; i++)
{
double termA = a[i] * h[i];
double termB = b[i] * Math.Pow(h[i], 2) / 2.0;
double termC = c[i] * Math.Pow(h[i], 3) / 3.0;
double termD = d[i] * Math.Pow(h[i], 4) / 4.0;
integral += termA + termB + termC + termD;
}
return integral;
}
}

@ -0,0 +1,40 @@
namespace Connected.Components;
public class ChartOptions
{
/// <summary>
/// Spacing of Y-axis ticks.
/// </summary>
public int YAxisTicks { get; set; } = 20;
/// <summary>
/// Maximum number of Y-axis ticks. The ticks will be thinned out if the value range is leading to too many ticks.
/// </summary>
public int MaxNumYAxisTicks { get; set; } = 20;
public string YAxisFormat { get; set; }
public bool YAxisLines { get; set; } = true;
public bool XAxisLines { get; set; }
/// <summary>
/// If true, legend will not be displayed.
/// </summary>
public bool DisableLegend { get; set; }
public string[] ChartPalette { get; set; } = { Colors.Blue.Accent3, Colors.Teal.Accent3, Colors.Amber.Accent3, Colors.Orange.Accent3, Colors.Red.Accent3, Colors.DeepPurple.Accent3,
Colors.Green.Accent3, Colors.LightBlue.Accent3, Colors.Teal.Lighten1, Colors.Amber.Lighten1, Colors.Orange.Lighten1, Colors.Red.Lighten1,
Colors.DeepPurple.Lighten1, Colors.Green.Lighten1, Colors.LightBlue.Lighten1, Colors.Amber.Darken2, Colors.Orange.Darken2,
Colors.Red.Darken2, Colors.DeepPurple.Darken2, Colors.Grey.Darken2 };
public InterpolationOption InterpolationOption { get; set; } = InterpolationOption.Straight;
/// <summary>
/// Line width of series in px
/// </summary>
public double LineStrokeWidth { get; set; } = 3;
}
public enum InterpolationOption
{
NaturalSpline,
EndSlope,
Periodic,
Straight
}

@ -0,0 +1,8 @@
namespace Connected.Components;
public class ChartSeries
{
public string Name { get; set; }
public double[] Data { get; set; }
}

@ -0,0 +1,5 @@
@namespace Connected.Components
<filter id="lighten">
<feColorMatrix type="matrix" values="1.5 0 0 0 0 0 1.5 0 0 0 0 0 1.5 0 0 0 0 0 1 0" />
</filter>

@ -0,0 +1,15 @@
@namespace Connected.Components
@inherits Chart
@if (ChartParent?.ChartOptions.DisableLegend != true)
{
<div @attributes="UserAttributes" class="mud-chart-legend">
@foreach (var item in Data)
{
<div class="mud-chart-legend-item" @onclick=@(()=>{ if (ChartParent!=null) { ChartParent.SelectedIndex=item.Index; }}) @onclick:stopPropagation=@(ChartParent!=null)>
<span class="mud-chart-legend-marker" style="@($"background-color:{ChartParent.ChartOptions.ChartPalette.GetValue(item.Index % ChartOptions.ChartPalette.Count())}")"></span>
<TextContent Typo="Typo.body2" Inline="true">@item.Labels</TextContent>
</div>
}
</div>
}

@ -0,0 +1,9 @@
using Microsoft.AspNetCore.Components;
namespace Connected.Components;
public partial class Legend : Chart
{
[CascadingParameter] public Chart ChartParent { get; set; }
[Parameter] public List<SvgLegend> Data { get; set; } = new List<SvgLegend>();
}

@ -0,0 +1,11 @@
namespace Connected.Components;
public class SvgCircle
{
public int Index { get; set; }
public double CX { get; set; }
public double CY { get; set; }
public double Radius { get; set; }
public string StrokeDashArray { get; set; }
public double StrokeDashOffset { get; set; }
}

@ -0,0 +1,8 @@
namespace Connected.Components;
public class SvgLegend
{
public int Index { get; set; }
public string Labels { get; set; }
public string Data { get; set; }
}

@ -0,0 +1,7 @@
namespace Connected.Components;
public class SvgPath
{
public int Index { get; set; }
public string Data { get; set; }
}

@ -0,0 +1,8 @@
namespace Connected.Components;
public class SvgText
{
public double X { get; set; }
public double Y { get; set; }
public string Value { get; set; }
}

@ -0,0 +1,25 @@
@namespace Connected.Components
@inherits BooleanInput<T>
@typeparam T
<InputControl Class="@Classname" Style="@Style" Error="@HasErrors" ErrorText="@GetErrorText()" Required="@Required">
<InputContent>
<label class="@LabelClassname" id="@_elementId" @onkeydown="HandleKeyDown" @onclick:stopPropagation="@StopClickPropagation">
<span tabindex="0" class="@CheckBoxClassname">
@*note: stopping the click propagation is important here. otherwise checking the checkbox results in click events on its parent (i.e. table row), which is generally not what you would want*@
<input tabindex="-1" @attributes="UserAttributes" type="checkbox" class="mud-checkbox-input" checked="@BoolValue" @onchange="@OnChange" disabled="@Disabled" @onclick:preventDefault="@ReadOnly" />
<Icon Icon="@GetIcon()" Color="HasErrors ? ThemeColor.Error : ThemeColor.Inherit" Size="@Size" />
</span>
@if (!String.IsNullOrEmpty(Label))
{
<TextContent Color="HasErrors ? ThemeColor.Error : ThemeColor.Inherit">@Label</TextContent>
}
@if (ChildContent != null)
{
<TextContent Color="HasErrors ? ThemeColor.Error : ThemeColor.Inherit">
@ChildContent
</TextContent>
}
</label>
</InputContent>
</InputControl>

@ -0,0 +1,254 @@
using Connected.Annotations;
using Connected.Extensions;
using Connected.Services;
using Connected.Utilities;
using Microsoft.AspNetCore.Components;
using Microsoft.AspNetCore.Components.Web;
namespace Connected.Components;
public partial class CheckBox<T> : BooleanInput<T>
{
protected string Classname =>
new CssBuilder("mud-input-control-boolean-input")
.AddClass(Class)
.Build();
protected string LabelClassname =>
new CssBuilder("mud-checkbox")
.AddClass($"mud-disabled", Disabled)
.AddClass($"mud-readonly", ReadOnly)
.AddClass(LabelPosition == LabelPosition.End ? "mud-ltr" : "mud-rtl", true)
.Build();
protected string CheckBoxClassname =>
new CssBuilder("mud-button-root mud-icon-button")
.AddClass($"mud-{Color.ToDescriptionString()}-text hover:mud-{Color.ToDescriptionString()}-hover", UnCheckedColor == null || (UnCheckedColor != null && BoolValue == true))
.AddClass($"mud-{UnCheckedColor?.ToDescriptionString()}-text hover:mud-{UnCheckedColor?.ToDescriptionString()}-hover", UnCheckedColor != null && BoolValue == false)
.AddClass($"mud-checkbox-dense", Dense)
.AddClass($"mud-ripple mud-ripple-checkbox", !DisableRipple && !ReadOnly && !Disabled)
.AddClass($"mud-disabled", Disabled)
.AddClass($"mud-readonly", ReadOnly)
.Build();
/// <summary>
/// The color of the component. It supports the theme colors.
/// </summary>
[Parameter]
[Category(CategoryTypes.FormComponent.Appearance)]
public ThemeColor Color { get; set; } = ThemeColor.Default;
/// <summary>
/// The base color of the component in its none active/unchecked state. It supports the theme colors.
/// </summary>
[Parameter]
[Category(CategoryTypes.Radio.Appearance)]
public ThemeColor? UnCheckedColor { get; set; } = null;
/// <summary>
/// The text/label will be displayed next to the checkbox if set.
/// </summary>
[Parameter]
[Category(CategoryTypes.FormComponent.Behavior)]
public string Label { get; set; }
/// <summary>
/// The position of the text/label.
/// </summary>
[Parameter]
[Category(CategoryTypes.FormComponent.Behavior)]
public LabelPosition LabelPosition { get; set; } = LabelPosition.End;
/// <summary>
/// If true, the checkbox can be controlled with the keyboard.
/// </summary>
[Parameter]
[Category(CategoryTypes.FormComponent.Behavior)]
public bool KeyboardEnabled { get; set; } = true;
/// <summary>
/// If true, disables ripple effect.
/// </summary>
[Parameter]
[Category(CategoryTypes.FormComponent.Appearance)]
public bool DisableRipple { get; set; }
/// <summary>
/// If true, compact padding will be applied.
/// </summary>
[Parameter]
[Category(CategoryTypes.FormComponent.Appearance)]
public bool Dense { get; set; }
/// <summary>
/// The Size of the component.
/// </summary>
[Parameter]
[Category(CategoryTypes.FormComponent.Appearance)]
public Size Size { get; set; } = Size.Medium;
/// <summary>
/// Child content of component.
/// </summary>
[Parameter]
[Category(CategoryTypes.FormComponent.Behavior)]
public RenderFragment ChildContent { get; set; }
/// <summary>
/// Custom checked icon, leave null for default.
/// </summary>
[Parameter]
[Category(CategoryTypes.FormComponent.Appearance)]
public string CheckedIcon { get; set; } = Icons.Material.Filled.CheckBox;
/// <summary>
/// Custom unchecked icon, leave null for default.
/// </summary>
[Parameter]
[Category(CategoryTypes.FormComponent.Appearance)]
public string UncheckedIcon { get; set; } = Icons.Material.Filled.CheckBoxOutlineBlank;
/// <summary>
/// Custom indeterminate icon, leave null for default.
/// </summary>
[Parameter]
[Category(CategoryTypes.FormComponent.Appearance)]
public string IndeterminateIcon { get; set; } = Icons.Material.Filled.IndeterminateCheckBox;
/// <summary>
/// Define if the checkbox can cycle again through indeterminate status.
/// </summary>
[Parameter]
[Category(CategoryTypes.FormComponent.Validation)]
public bool TriState { get; set; }
private string GetIcon()
{
if (BoolValue == true)
{
return CheckedIcon;
}
if (BoolValue == false)
{
return UncheckedIcon;
}
return IndeterminateIcon;
}
protected override Task OnChange(ChangeEventArgs args)
{
Modified = true;
// Apply only when TriState parameter is set to true and T is bool?
if (TriState && typeof(T) == typeof(bool?))
{
// The cycle is forced with the following steps: true, false, indeterminate, true, false, indeterminate...
if (!((bool?)(object)_value).HasValue)
{
return SetBoolValueAsync(true);
}
else
{
return ((bool?)(object)_value).Value ? SetBoolValueAsync(false) : SetBoolValueAsync(default);
}
}
else
{
return SetBoolValueAsync((bool?)args.Value);
}
}
protected void HandleKeyDown(KeyboardEventArgs obj)
{
if (Disabled || ReadOnly || !KeyboardEnabled)
return;
switch (obj.Key)
{
case "Delete":
SetBoolValueAsync(false);
break;
case "Enter":
case "NumpadEnter":
SetBoolValueAsync(true);
break;
case "Backspace":
if (TriState)
{
SetBoolValueAsync(null);
}
break;
case " ":
if (BoolValue == null)
{
SetBoolValueAsync(true);
}
else if (BoolValue == true)
{
SetBoolValueAsync(false);
}
else if (BoolValue == false)
{
if (TriState == true)
{
SetBoolValueAsync(null);
}
else
{
SetBoolValueAsync(true);
}
}
break;
}
}
private IKeyInterceptor _keyInterceptor;
[Inject] private IKeyInterceptorFactory _keyInterceptorFactory { get; set; }
private string _elementId = "checkbox" + Guid.NewGuid().ToString().Substring(0, 8);
protected override void OnInitialized()
{
base.OnInitialized();
if (Label == null && For != null)
Label = For.GetLabelString();
}
protected override async Task OnAfterRenderAsync(bool firstRender)
{
if (firstRender)
{
_keyInterceptor = _keyInterceptorFactory.Create();
await _keyInterceptor.Connect(_elementId, new KeyInterceptorOptions()
{
//EnableLogging = true,
TargetClass = "mud-button-root",
Keys = {
new KeyOptions { Key=" ", PreventDown = "key+none", PreventUp = "key+none" }, // prevent scrolling page
new KeyOptions { Key="Enter", PreventDown = "key+none" },
new KeyOptions { Key="NumpadEnter", PreventDown = "key+none" },
new KeyOptions { Key="Backspace", PreventDown = "key+none" },
},
});
_keyInterceptor.KeyDown += HandleKeyDown;
}
await base.OnAfterRenderAsync(firstRender);
}
protected override void Dispose(bool disposing)
{
base.Dispose(disposing);
if (disposing == true)
{
if (_keyInterceptor != null)
{
_keyInterceptor.KeyDown -= HandleKeyDown;
_keyInterceptor.Dispose();
}
}
}
}

@ -0,0 +1,33 @@
@namespace Connected.Components
@inherits UIComponent
<div tabindex="0" @attributes="UserAttributes" class="@Classname" style="@Style" @onclick="@OnClickHandler">
@if (!String.IsNullOrEmpty(Avatar))
{
<Avatar Class="@AvatarClass" Color="@Color">
<MudIcon Icon="@Avatar" />
</Avatar>
}
else if (!String.IsNullOrEmpty(Icon) && !IsChecked)
{
<Icon Icon="@Icon" Class="mud-chip-icon" Size="Size.Small" Color="@IconColor" />
}
else if (IsChecked)
{
<Icon Icon="@CheckedIcon" Class="mud-chip-icon" Size="Size.Small" />
}
<span class="mud-chip-content">
@if (ChildContent == null)
{
@Text
}
else
{
@ChildContent
}
@if (OnClose.HasDelegate || ChipSet?.AllClosable==true)
{
<IconButton Class="mud-chip-close-button" Icon="@(String.IsNullOrEmpty(CloseIcon) ? $"{Icons.Material.Filled.Cancel}" : $"{CloseIcon}")" OnClick="OnCloseHandler" Size="Size.Small"/>
}
</span>
</div>

@ -0,0 +1,335 @@
using System.Diagnostics.CodeAnalysis;
using System.Windows.Input;
using Connected.Annotations;
using Connected.Extensions;
using Connected.Utilities;
using Microsoft.AspNetCore.Components;
using Microsoft.AspNetCore.Components.Web;
namespace Connected.Components;
public partial class Chip : UIComponent, IDisposable
{
private bool _isSelected;
[Inject] public NavigationManager UriHelper { get; set; }
[Inject] public IJsApiService JsApiService { get; set; }
protected string Classname =>
new CssBuilder("mud-chip")
.AddClass($"mud-chip-{GetVariant().ToDescriptionString()}")
.AddClass($"mud-chip-size-{Size.ToDescriptionString()}")
.AddClass($"mud-chip-color-{GetColor().ToDescriptionString()}")
.AddClass("mud-clickable", !ChipSet?.ReadOnly ?? OnClick.HasDelegate)
.AddClass("mud-ripple", !ChipSet?.ReadOnly ?? OnClick.HasDelegate && !DisableRipple)
.AddClass("mud-chip-label", Label)
.AddClass("mud-disabled", Disabled)
.AddClass("mud-chip-selected", IsSelected)
.AddClass(Class)
.Build();
//Cannot test the get variant (last line)
[ExcludeFromCodeCoverage]
private Variant GetVariant()
{
return Variant switch
{
Variant.Text => IsSelected ? Variant.Filled : Variant.Text,
Variant.Filled => IsSelected ? Variant.Text : Variant.Filled,
Variant.Outlined => Variant.Outlined,
_ => Variant
};
}
private ThemeColor GetColor()
{
if (IsSelected && SelectedColor != ThemeColor.Inherit)
{
return SelectedColor;
}
else if (IsSelected && SelectedColor == ThemeColor.Inherit)
{
return Color;
}
else
{
return Color;
}
}
[CascadingParameter] ChipSet ChipSet { get; set; }
/// <summary>
/// The color of the component.
/// </summary>
[Parameter]
[Category(CategoryTypes.Chip.Appearance)]
public ThemeColor Color { get; set; } = ThemeColor.Default;
/// <summary>
/// The size of the button. small is equivalent to the dense button styling.
/// </summary>
[Parameter]
[Category(CategoryTypes.Chip.Appearance)]
public Size Size { get; set; } = Size.Medium;
/// <summary>
/// The variant to use.
/// </summary>
[Parameter]
[Category(CategoryTypes.Chip.Appearance)]
public Variant Variant { get; set; } = Variant.Filled;
/// <summary>
/// The selected color to use when selected, only works together with ChipSet, Color.Inherit for default value.
/// </summary>
[Parameter]
[Category(CategoryTypes.Chip.Appearance)]
public ThemeColor SelectedColor { get; set; } = ThemeColor.Inherit;
/// <summary>
/// Avatar Icon, Overrides the regular Icon if set.
/// </summary>
[Parameter]
[Category(CategoryTypes.Chip.Behavior)]
public string Avatar { get; set; }
/// <summary>
/// Avatar CSS Class, appends to Chips default avatar classes.
/// </summary>
[Parameter]
[Category(CategoryTypes.Chip.Appearance)]
public string AvatarClass { get; set; }
/// <summary>
/// Removes circle edges and applies theme default.
/// </summary>
[Parameter]
[Category(CategoryTypes.Chip.Appearance)]
public bool Label { get; set; }
/// <summary>
/// If true, the chip will be displayed in disabled state and no events possible.
/// </summary>
[Parameter]
[Category(CategoryTypes.Chip.Behavior)]
public bool Disabled { get; set; }
/// <summary>
/// Sets the Icon to use.
/// </summary>
[Parameter]
[Category(CategoryTypes.Chip.Behavior)]
public string Icon { get; set; }
/// <summary>
/// Custom checked icon.
/// </summary>
[Parameter]
[Category(CategoryTypes.Chip.Appearance)]
public string CheckedIcon { get; set; } = Icons.Material.Filled.Check;
/// <summary>
/// The color of the icon.
/// </summary>
[Parameter]
[Category(CategoryTypes.Chip.Appearance)]
public ThemeColor IconColor { get; set; } = ThemeColor.Inherit;
/// <summary>
/// Overrides the default close icon, only shown if OnClose is set.
/// </summary>
[Parameter]
[Category(CategoryTypes.Chip.Appearance)]
public string CloseIcon { get; set; }
/// <summary>
/// If true, disables ripple effect, ripple effect is only applied to clickable chips.
/// </summary>
[Parameter]
[Category(CategoryTypes.Chip.Appearance)]
public bool DisableRipple { get; set; }
/// <summary>
/// Child content of component.
/// </summary>
[Parameter]
[Category(CategoryTypes.Chip.Behavior)]
public RenderFragment ChildContent { get; set; }
/// <summary>
/// If set to a URL, clicking the button will open the referenced document. Use Target to specify where (Obsolete replaced by Href)
/// </summary>
[Obsolete("Use Href Instead.", false)]
[Parameter]
[Category(CategoryTypes.Chip.ClickAction)]
public string Link
{
get => Href;
set => Href = value;
}
/// <summary>
/// If set to a URL, clicking the button will open the referenced document. Use Target to specify where
/// </summary>
[Parameter]
[Category(CategoryTypes.Chip.ClickAction)]
public string Href { get; set; }
/// <summary>
/// The target attribute specifies where to open the link, if Href is specified. Possible values: _blank | _self | _parent | _top | <i>framename</i>
/// </summary>
[Parameter]
[Category(CategoryTypes.Chip.ClickAction)]
public string Target { get; set; }
/// <summary>
/// A string you want to associate with the chip. If the ChildContent is not set this will be shown as chip text.
/// </summary>
[Parameter]
[Category(CategoryTypes.Chip.Behavior)]
public string Text { get; set; }
/// <summary>
/// A value that should be managed in the SelectedValues collection.
/// Note: do not change the value during the chip's lifetime
/// </summary>
[Parameter]
[Category(CategoryTypes.Chip.Behavior)]
public object Value { get; set; }
/// <summary>
/// If true, force browser to redirect outside component router-space.
/// </summary>
[Parameter]
[Category(CategoryTypes.Chip.ClickAction)]
public bool ForceLoad { get; set; }
/// <summary>
/// If true, this chip is selected by default if used in a ChipSet.
/// </summary>
[Parameter]
[Category(CategoryTypes.Chip.Behavior)]
public bool? Default { get; set; }
/// <summary>
/// Command executed when the user clicks on an element.
/// </summary>
[Parameter]
[Category(CategoryTypes.Chip.ClickAction)]
public ICommand Command { get; set; }
/// <summary>
/// Command parameter.
/// </summary>
[Parameter]
[Category(CategoryTypes.Chip.ClickAction)]
public object CommandParameter { get; set; }
/// <summary>
/// Chip click event, if set the chip focus, hover and click effects are applied.
/// </summary>
[Parameter] public EventCallback<MouseEventArgs> OnClick { get; set; }
/// <summary>
/// Chip delete event, if set the delete icon will be visible.
/// </summary>
[Parameter] public EventCallback<Chip> OnClose { get; set; }
/// <summary>
/// Set by MudChipSet
/// </summary>
public bool IsChecked
{
get => _isSelected && ChipSet?.Filter == true;
}
/// <summary>
/// If false, this chip has not been seen before
/// </summary>
public bool DefaultProcessed { get; set; }
/// <summary>
/// Set by MudChipSet
/// </summary>
public bool IsSelected
{
get => _isSelected;
set
{
if (_isSelected == value)
return;
_isSelected = value;
StateHasChanged();
}
}
protected override void OnInitialized()
{
base.OnInitialized();
if (Value == null)
Value = this;
}
protected internal async Task OnClickHandler(MouseEventArgs ev)
{
if (ChipSet?.ReadOnly == true)
{
return;
}
if (ChipSet != null)
{
_ = ChipSet.OnChipClicked(this);
}
if (Href != null)
{
// TODO: use MudElement to render <a> and this code can be removed. we know that it has potential problems on iOS
if (string.IsNullOrWhiteSpace(Target))
UriHelper.NavigateTo(Href, ForceLoad);
else
await JsApiService.Open(Href, Target);
}
else
{
await OnClick.InvokeAsync(ev);
if (Command?.CanExecute(CommandParameter) ?? false)
{
Command.Execute(CommandParameter);
}
}
}
protected async Task OnCloseHandler(MouseEventArgs ev)
{
if (ChipSet?.ReadOnly == true)
{
return;
}
await OnClose.InvokeAsync(this);
ChipSet?.OnChipDeleted(this);
StateHasChanged();
}
protected override Task OnInitializedAsync()
{
ChipSet?.Add(this);
return base.OnInitializedAsync();
}
internal void ForceRerender() => StateHasChanged();
//Exclude because we don't test to catching exception yet
[ExcludeFromCodeCoverage]
public void Dispose()
{
try
{
ChipSet?.Remove(this);
}
catch (Exception)
{
/* ignore! */
}
}
}

@ -0,0 +1,8 @@
@namespace Connected.Components
@inherits UIComponent
<div @attributes="UserAttributes" class="@Classname" style="@Style" >
<CascadingValue IsFixed="true" Value="this">
@ChildContent
</CascadingValue>
</div>

@ -0,0 +1,342 @@
using Connected.Annotations;
using Connected.Utilities;
using Microsoft.AspNetCore.Components;
namespace Connected.Components;
public partial class ChipSet : UIComponent, IDisposable
{
protected string Classname =>
new CssBuilder("mud-chipset")
.AddClass(Class)
.Build();
/// <summary>
/// Child content of component.
/// </summary>
[Parameter]
[Category(CategoryTypes.ChipSet.Behavior)]
public RenderFragment ChildContent { get; set; }
/// <summary>
/// Allows to select more than one chip.
/// </summary>
[Parameter]
[Category(CategoryTypes.ChipSet.Behavior)]
public bool MultiSelection { get; set; } = false;
/// <summary>
/// Will not allow to deselect the selected chip in single selection mode.
/// </summary>
[Parameter]
[Category(CategoryTypes.ChipSet.Behavior)]
public bool Mandatory { get; set; } = false;
/// <summary>
/// Will make all chips closable.
/// </summary>
[Parameter]
[Category(CategoryTypes.ChipSet.Behavior)]
public bool AllClosable { get; set; } = false;
/// <summary>
/// Will show a check-mark for the selected components.
/// </summary>
[Parameter]
[Category(CategoryTypes.ChipSet.Appearance)]
public bool Filter
{
get => _filter;
set
{
if (_filter == value)
return;
_filter = value;
StateHasChanged();
foreach (var chip in _chips)
chip.ForceRerender();
}
}
/// <summary>
/// Will make all chips read only.
/// </summary>
[Parameter]
[Category(CategoryTypes.ChipSet.Behavior)]
public bool ReadOnly { get; set; } = false;
/// <summary>
/// The currently selected chip in Choice mode
/// </summary>
[Parameter]
[Category(CategoryTypes.ChipSet.Behavior)]
public Chip SelectedChip
{
get { return _chips.OfType<Chip>().FirstOrDefault(x => x.IsSelected); }
set
{
if (value == null)
{
foreach (var chip in _chips)
{
chip.IsSelected = false;
}
}
else
{
foreach (var chip in _chips)
{
chip.IsSelected = (chip == value);
}
}
this.InvokeAsync(StateHasChanged);
}
}
/// <summary>
/// Called when the selected chip changes, in Choice mode
/// </summary>
[Parameter]
public EventCallback<Chip> SelectedChipChanged { get; set; }
/// <summary>
/// The currently selected chips in Filter mode
/// </summary>
[Parameter]
[Category(CategoryTypes.ChipSet.Behavior)]
public Chip[] SelectedChips
{
get { return _chips.OfType<Chip>().Where(x => x.IsSelected).ToArray(); }
set
{
if (value == null || value.Length == 0)
{
foreach (var chip in _chips)
{
chip.IsSelected = false;
}
}
else
{
var selected = new HashSet<Chip>(value);
foreach (var chip in _chips)
{
chip.IsSelected = selected.Contains(chip);
}
}
StateHasChanged();
}
}
protected override void OnInitialized()
{
base.OnInitialized();
if (_selectedValues == null)
_selectedValues = new HashSet<object>(_comparer);
_initialSelectedValues = new HashSet<object>(_selectedValues, _comparer);
}
private IEqualityComparer<object> _comparer;
private HashSet<object> _selectedValues;
private HashSet<object> _initialSelectedValues;
/// <summary>
/// The Comparer to use for comparing selected values internally.
/// </summary>
[Parameter]
[Category(CategoryTypes.ChipSet.Behavior)]
public IEqualityComparer<object> Comparer
{
get => _comparer;
set
{
_comparer = value;
// Apply comparer and refresh selected values
_selectedValues = new HashSet<object>(_selectedValues, _comparer);
SelectedValues = _selectedValues;
}
}
/// <summary>
/// Called when the selection changed, in Filter mode
/// </summary>
[Parameter]
public EventCallback<Chip[]> SelectedChipsChanged { get; set; }
/// <summary>
/// The current selected value.
/// Note: make the list Clickable for item selection to work.
/// </summary>
[Parameter]
[Category(CategoryTypes.ChipSet.Behavior)]
public ICollection<object> SelectedValues
{
get => _selectedValues;
set
{
if (value == null)
SetSelectedValues(new object[0]);
else
SetSelectedValues(value.ToArray()).AndForget();
}
}
/// <summary>
/// Called whenever the selection changed
/// </summary>
[Parameter] public EventCallback<ICollection<object>> SelectedValuesChanged { get; set; }
internal Task SetSelectedValues(object[] values)
{
HashSet<object> newValues = null;
if (values == null)
values = new object[0];
if (MultiSelection)
newValues = new HashSet<object>(values, _comparer);
else
{
newValues = new HashSet<object>(_comparer);
if (values.Length > 0)
newValues.Add(values.First());
}
// avoid update with same values
if (_selectedValues.IsEqualTo(newValues))
return Task.CompletedTask;
_selectedValues = newValues;
foreach (var chip in _chips.ToArray())
{
var isSelected = _selectedValues.Contains(chip.Value);
chip.IsSelected = isSelected;
}
return NotifySelection();
}
/// <summary>
/// Called when a Chip was deleted (by click on the close icon)
/// </summary>
[Parameter]
public EventCallback<Chip> OnClose { get; set; }
internal Task Add(Chip chip)
{
_chips.Add(chip);
if (_selectedValues.Contains(chip.Value))
chip.IsSelected = true;
return CheckDefault(chip);
}
internal void Remove(Chip chip)
{
_chips.Remove(chip);
if (chip.IsSelected)
{
_selectedValues.Remove(chip.Value);
NotifySelection().AndForget();
}
}
private async Task CheckDefault(Chip chip)
{
if (!MultiSelection)
return;
if (chip.DefaultProcessed)
return;
chip.DefaultProcessed = true;
if (chip.Default == null)
return;
var oldSelected = chip.IsSelected;
chip.IsSelected = chip.Default == true;
if (chip.IsSelected != oldSelected)
{
if (chip.IsSelected)
_selectedValues.Add(chip.Value);
else
_selectedValues.Remove(chip.Value);
await NotifySelection();
}
}
private HashSet<Chip> _chips = new();
private bool _filter;
internal Task OnChipClicked(Chip chip)
{
var wasSelected = chip.IsSelected;
if (MultiSelection)
{
chip.IsSelected = !chip.IsSelected;
}
else
{
foreach (var ch in _chips)
{
ch.IsSelected = (ch == chip); // <-- exclusively select the one chip only, thus all others must be deselected
}
if (!Mandatory)
chip.IsSelected = !wasSelected;
}
UpdateSelectedValues();
return NotifySelection();
}
private void UpdateSelectedValues()
{
_selectedValues = new HashSet<object>(_chips.Where(x => x.IsSelected).Select(x => x.Value), _comparer);
}
private object[] _lastSelectedValues = null;
private async Task NotifySelection()
{
if (_disposed)
return;
// to avoid endless notification loops we check if selection has really changed
if (_selectedValues.IsEqualTo(_lastSelectedValues))
return;
_lastSelectedValues = _selectedValues.ToArray();
await SelectedChipChanged.InvokeAsync(SelectedChip);
await SelectedChipsChanged.InvokeAsync(SelectedChips);
await SelectedValuesChanged.InvokeAsync(SelectedValues);
StateHasChanged();
}
public void OnChipDeleted(Chip chip)
{
Remove(chip);
OnClose.InvokeAsync(chip);
}
protected override async void OnAfterRender(bool firstRender)
{
if (firstRender)
await SelectDefaultChips();
base.OnAfterRender(firstRender);
}
private async Task SelectDefaultChips()
{
if (!MultiSelection)
{
var anySelected = false;
var defaultChip = _chips.LastOrDefault(chip => chip.Default == true);
if (defaultChip != null)
{
defaultChip.IsSelected = true;
anySelected = true;
}
if (anySelected)
{
UpdateSelectedValues();
await NotifySelection();
}
}
}
private bool _disposed;
public void Dispose()
{
_disposed = true;
}
}

@ -0,0 +1,11 @@
@namespace Connected.Components
@inherits UIComponent
@using System.Globalization;
<div @onanimationend="EventUtil.AsNonRenderingEventHandler(AnimationEnd)" @attributes="UserAttributes" class="@Classname" style="@Stylename">
<div @ref="_wrapper" class="mud-collapse-wrapper">
<div class="mud-collapse-wrapper-inner">
@ChildContent
</div>
</div>
</div>

@ -0,0 +1,146 @@
using System.Globalization;
using Connected.Utilities;
using Microsoft.AspNetCore.Components;
using Microsoft.JSInterop;
namespace Connected.Components;
public partial class Collapse : UIComponent
{
internal enum CollapseState
{
Entering, Entered, Exiting, Exited
}
internal double _height;
private bool _expanded, _isRendered, _updateHeight;
private ElementReference _wrapper;
internal CollapseState _state = CollapseState.Exited;
protected string Stylename =>
new StyleBuilder()
.AddStyle("max-height", MaxHeight.ToPx(), MaxHeight != null)
.AddStyle("height", "auto", _state == CollapseState.Entered)
.AddStyle("height", _height.ToPx(), _state is CollapseState.Entering or CollapseState.Exiting)
.AddStyle("animation-duration", $"{CalculatedAnimationDuration.ToString("#.##", CultureInfo.InvariantCulture)}s", _state == CollapseState.Entering)
.AddStyle(Style)
.Build();
protected string Classname =>
new CssBuilder("mud-collapse-container")
.AddClass($"mud-collapse-entering", _state == CollapseState.Entering)
.AddClass($"mud-collapse-entered", _state == CollapseState.Entered)
.AddClass($"mud-collapse-exiting", _state == CollapseState.Exiting)
.AddClass(Class)
.Build();
/// <summary>
/// If true, expands the panel, otherwise collapse it. Setting this prop enables control over the panel.
/// </summary>
[Parameter]
public bool Expanded
{
get => _expanded;
set
{
if (_expanded == value)
return;
_expanded = value;
if (_isRendered)
{
_state = _expanded ? CollapseState.Entering : CollapseState.Exiting;
_ = UpdateHeight();
_updateHeight = true;
}
else if (_expanded)
{
_state = CollapseState.Entered;
}
_ = ExpandedChanged.InvokeAsync(_expanded);
}
}
/// <summary>
/// Explicitly sets the height for the Collapse element to override the css default.
/// </summary>
[Parameter] public int? MaxHeight { get; set; }
/// <summary>
/// Child content of component.
/// </summary>
[Parameter] public RenderFragment ChildContent { get; set; }
[Parameter] public EventCallback OnAnimationEnd { get; set; }
[Parameter] public EventCallback<bool> ExpandedChanged { get; set; }
/// <summary>
/// Modified Animation duration that scales with height parameter.
/// Basic implementation for now but should be a math formula to allow it to scale between 0.1s and 1s for the effect to be consistently smooth.
/// </summary>
private double CalculatedAnimationDuration
{
get
{
if (MaxHeight != null)
{
if (MaxHeight <= 200) return 0.2;
else if (MaxHeight <= 600) return 0.4;
else if (MaxHeight <= 1400) return 0.6;
return 1;
}
return Math.Min(_height / 800.0, 1);
}
set { }
}
internal async Task UpdateHeight()
{
try
{
_height = (await _wrapper.MudGetBoundingClientRectAsync())?.Height ?? 0;
}
catch (Exception ex) when (ex is JSDisconnectedException || ex is TaskCanceledException)
{
_height = 0;
}
if (MaxHeight != null && _height > MaxHeight)
{
_height = MaxHeight.Value;
}
}
protected override async Task OnAfterRenderAsync(bool firstRender)
{
if (firstRender)
{
_isRendered = true;
await UpdateHeight();
}
else if (_updateHeight && _state is CollapseState.Entering or CollapseState.Exiting)
{
_updateHeight = false;
await UpdateHeight();
StateHasChanged();
}
await base.OnAfterRenderAsync(firstRender);
}
public void AnimationEnd()
{
if (_state == CollapseState.Entering)
{
_state = CollapseState.Entered;
StateHasChanged();
}
else if (_state == CollapseState.Exiting)
{
_state = CollapseState.Exited;
StateHasChanged();
}
OnAnimationEnd.InvokeAsync(Expanded);
}
}

@ -0,0 +1,151 @@
@namespace Connected.Components
@using System.Globalization;
@using Connected.Utilities;
@inherits Picker<Color>
@Render
@code {
protected override RenderFragment PickerContent =>
@<CascadingValue Value="@this" IsFixed="true">
<PickerToolbar DisableToolbar="@DisableToolbar" Class="mud-picker-color-toolbar">
@if (PickerVariant != PickerVariant.Static)
{
<IconButton Class="pa-1 mud-close-picker-button" Size="Size.Small" Color="ThemeColor.Inherit" Icon="@CloseIcon" OnClick="@GetEventCallback()" />
}
<Spacer />
<IconButton Class="pa-1" Size="Size.Small" Color="GetButtonColor(ColorPickerView.Spectrum)" Icon="@SpectrumIcon" OnClick="(() => ChangeView(ColorPickerView.Spectrum))" />
<IconButton Class="pa-1 mx-1" Size="Size.Small" Color="GetButtonColor(ColorPickerView.Grid)" Icon="@GridIcon" OnClick="(() => ChangeView(ColorPickerView.Grid))" />
<IconButton Class="pa-1" Size="Size.Small" Color="GetButtonColor(ColorPickerView.Palette)" Icon="@PaletteIcon" OnClick="(() => ChangeView(ColorPickerView.Palette))" />
</PickerToolbar>
<PickerContent Class="mud-picker-color-content">
@if (!DisableColorField)
{
<div class="mud-picker-color-picker">
@if (_activeColorPickerView == ColorPickerView.Spectrum)
{
<div class="mud-picker-color-overlay" style="@($"background-color: {_baseColor.ToString(ColorOutputFormats.RGB)}")">
<div class="mud-picker-color-overlay mud-picker-color-overlay-white">
<div class="mud-picker-color-overlay mud-picker-color-overlay-black">
<div class="mud-picker-color-overlay" id="@_id" @onclick="OnColorOverlayClick">
<svg class="mud-picker-color-selector" height="26" width="26" style="transform: @GetSelectorLocation()" @onclick="OnSelectorClicked" @onclick:stopPropagation="true">
<defs>
<filter id="mud-picker-color-selector-shadow" x="-50%" y="-50%" width="200%" height="200%">
<feGaussianBlur in="SourceAlpha" stdDeviation="1" />
<feOffset dx="0" dy="5" result="offsetblur" />
<feOffset dx="0" dy="-5" result="offsetblur" />
<feMerge><feMergeNode /><feMergeNode in="SourceGraphic" /></feMerge>
</filter>
</defs>
<circle r="10" cx="13" cy="13" stroke="white" stroke-width="1" fill="transparent" style="filter: url(#mud-picker-color-selector-shadow)" />
<circle r="11" cx="13" cy="13" stroke="white" stroke-width="1.5" fill="transparent" />
</svg>
</div>
</div>
</div>
</div>
}
@if (_activeColorPickerView is ColorPickerView.Grid or ColorPickerView.GridCompact)
{
<div class="mud-picker-color-grid">
@foreach (var item in _gridList)
{
<div class="@GetColorDotClass(item)" style="@($"background: {item.ToString(ColorOutputFormats.RGBA)};")" @onclick="@GetSelectPaletteColorCallback(item)"></div>
}
</div>
}
</div>
}
@if (_activeColorPickerView != ColorPickerView.GridCompact)
{
@if (!DisableSliders || !DisableInputs || !DisablePreview)
{
<div class="mud-picker-color-controls">
@if (!DisableSliders || !DisablePreview)
{
<div class="mud-picker-color-controls-row">
@if (!DisablePreview)
{
<div class="mud-picker-color-dot mud-picker-color-dot-current mud-ripple" @onclick="ToggleCollection">
<div class="mud-picker-color-fill" style="@($"background: {_color.ToString(ColorOutputFormats.RGBA)};")"></div>
</div>
}
@if (!DisableSliders && !_collectionOpen)
{
<div class="mud-picker-color-sliders">
@if (_activeColorPickerView != ColorPickerView.Grid)
{
<Slider Class="mud-picker-color-slider hue" dir="ltr" T="int" Value="(int)_color.H" ValueChanged="UpdateBaseColorSlider" Step="1" Min="0" Max="360" />
}
@if (!DisableAlpha)
{
<Slider Class="mud-picker-color-slider alpha" Value="_color.A" ValueChanged="SetAlpha" T="int" Min="0" Max="255" Step="1" Style="@AlphaSliderStyle" />
}
</div>
}
@if (_collectionOpen)
{
<div class="mud-picker-color-collection">
@foreach (var item in Palette.Take(5))
{
<div class="@GetColorDotClass(item)" style="@($"background: {item.ToString(ColorOutputFormats.RGBA)};")" @onclick="@GetSelectPaletteColorCallback(item)"></div>
}
</div>
}
</div>
}
@if (!DisableInputs)
{
<div class="mud-picker-color-controls-row">
<div class="mud-picker-color-inputs">
@switch (ColorPickerMode)
{
case ColorPickerMode.RGB:
<NumericField Value="_color.R" T="int" ValueChanged="SetR" Class="mud-picker-color-inputfield" HelperText="R" Min="0" Max="255" Variant="Variant.Outlined" HideSpinButtons="true" />
<NumericField Value="_color.G" T="int" ValueChanged="SetG" Class="mud-picker-color-inputfield" HelperText="G" Min="0" Max="255" Variant="Variant.Outlined" HideSpinButtons="true" />
<NumericField Value="_color.B" T="int" ValueChanged="SetB" Class="mud-picker-color-inputfield" HelperText="B" Min="0" Max="255" Variant="Variant.Outlined" HideSpinButtons="true" />
break;
case ColorPickerMode.HSL:
<NumericField Value="@_color.H" T="double" ValueChanged="SetH" Class="mud-picker-color-inputfield" HelperText="H" Step="1" Min="0" Max="360" Variant="Variant.Outlined" HideSpinButtons="true" />
<NumericField Value="@_color.S" T="double" ValueChanged="SetS" Class="mud-picker-color-inputfield" HelperText="S" Step="0.01" Min="0" Max="100" Variant="Variant.Outlined" HideSpinButtons="true" />
<NumericField Value="@_color.L" T="double" ValueChanged="SetL" Class="mud-picker-color-inputfield" HelperText="L" Step="0.01" Min="0" Max="100" Variant="Variant.Outlined" HideSpinButtons="true" />
break;
case ColorPickerMode.HEX:
<TextField Value="@GetColorTextValue()" ValueChanged="SetInputString" T="string" Class="mud-picker-color-inputfield" Variant="Variant.Outlined" MaxLength="@GetHexColorInputMaxLength()" HelperText="HEX" />
break;
default:
break;
}
@if (!DisableAlpha && ColorPickerMode != ColorPickerMode.HEX)
{
<NumericField Value="@( Math.Round(_color.A / 255.0, 2))" T="double" ValueChanged="SetAlpha" Class="mud-picker-color-inputfield input-field-alpha" HelperText="A" Min="0" Max="1" Step="0.01" Variant="Variant.Outlined" HideSpinButtons="true" />
}
</div>
@if (!DisableModeSwitch)
{
<div class="mud-picker-control-switch">
<IconButton OnClick="ChangeMode" Icon="@ImportExportIcon" Class="pa-1 me-n1"></IconButton>
</div>
}
</div>
}
</div>
}
@if (_activeColorPickerView == ColorPickerView.Palette)
{
<div class="mud-picker-color-view">
<div class="mud-picker-color-view-collection">
@foreach (var item in Palette)
{
<div class="@GetColorDotClass(item)" style="@($"background: {item.ToString(ColorOutputFormats.RGBA)};")" @onclick="@GetSelectPaletteColorCallback(item)"></div>
}
</div>
</div>
}
}
</PickerContent>
</CascadingValue>;
}

@ -0,0 +1,597 @@
// Copyright (c) MudBlazor 2021
// MudBlazor licenses this file to you under the MIT license.
// See the LICENSE file in the project root for more information.
using System.Globalization;
using Connected.Annotations;
using Connected.Extensions;
using Connected.Utilities;
using Microsoft.AspNetCore.Components;
using Microsoft.AspNetCore.Components.Web;
namespace Connected.Components;
public partial class ColorPicker : Picker<Color>, IAsyncDisposable
{
public ColorPicker() : base(new DefaultConverter<Color>())
{
AdornmentIcon = Icons.Material.Outlined.Palette;
DisableToolbar = true;
Value = "#594ae2"; //MudBlazor Blue
Text = GetColorTextValue();
AdornmentAriaLabel = "Open Color Picker";
}
#region Fields
private static Dictionary<int, (Func<int, int> r, Func<int, int> g, Func<int, int> b, string dominantColorPart)> _rgbToHueMapper = new()
{
{ 0, ((x) => 255, x => x, x => 0, "rb") },
{ 1, ((x) => 255 - x, x => 255, x => 0, "gb") },
{ 2, ((x) => 0, x => 255, x => x, "gr") },
{ 3, ((x) => 0, x => 255 - x, x => 255, "br") },
{ 4, ((x) => x, x => 0, x => 255, "bg") },
{ 5, ((x) => 255, x => 0, x => 255 - x, "rg") },
};
private const double _maxY = 250;
private const double _maxX = 312;
private const double _selctorSize = 26.0;
private double _selectorX;
private double _selectorY;
private bool _skipFeedback = false;
private Color _baseColor;
private Color _color;
private bool _collectionOpen;
private readonly Guid _id = Guid.NewGuid();
private Guid _throttledMouseOverEventId;
private IEventListener _throttledEventManager;
[Inject] IEventListenerFactory ThrottledEventManagerFactory { get; set; }
#endregion
#region Parameters
[CascadingParameter(Name = "RightToLeft")] public bool RightToLeft { get; set; }
private bool _disableAlpha = false;
/// <summary>
/// If true, Alpha options will not be displayed and color output will be RGB, HSL or HEX and not RGBA, HSLA or HEXA.
/// </summary>
[Parameter]
[Category(CategoryTypes.FormComponent.PickerBehavior)]
public bool DisableAlpha
{
get => _disableAlpha;
set
{
if (value != _disableAlpha)
{
_disableAlpha = value;
if (value == true)
{
Value = Value.SetAlpha(1.0);
}
Text = GetColorTextValue();
}
}
}
/// <summary>
/// If true, the color field will not be displayed.
/// </summary>
[Parameter]
[Category(CategoryTypes.FormComponent.PickerBehavior)]
public bool DisableColorField { get; set; } = false;
/// <summary>
/// If true, the switch to change color mode will not be displayed.
/// </summary>
[Parameter]
[Category(CategoryTypes.FormComponent.PickerBehavior)]
public bool DisableModeSwitch { get; set; } = false;
/// <summary>
/// If true, textfield inputs and color mode switch will not be displayed.
/// </summary>
[Parameter]
[Category(CategoryTypes.FormComponent.PickerBehavior)]
public bool DisableInputs { get; set; } = false;
/// <summary>
/// If true, hue and alpha sliders will not be displayed.
/// </summary>
[Parameter]
[Category(CategoryTypes.FormComponent.PickerBehavior)]
public bool DisableSliders { get; set; } = false;
/// <summary>
/// If true, the preview color box will not be displayed, note that the preview color functions as a button as well for collection colors.
/// </summary>
[Parameter]
[Category(CategoryTypes.FormComponent.PickerBehavior)]
public bool DisablePreview { get; set; } = false;
/// <summary>
/// The initial mode (RGB, HSL or HEX) the picker should open. Defaults to RGB
/// </summary>
[Parameter]
[Category(CategoryTypes.FormComponent.PickerBehavior)]
public ColorPickerMode ColorPickerMode { get; set; } = ColorPickerMode.RGB;
private ColorPickerView _colorPickerView = ColorPickerView.Spectrum;
private ColorPickerView _activeColorPickerView = ColorPickerView.Spectrum;
/// <summary>
/// The initial view of the picker. Views can be changed if toolbar is enabled.
/// </summary>
[Parameter]
[Category(CategoryTypes.FormComponent.PickerBehavior)]
public ColorPickerView ColorPickerView
{
get => _colorPickerView;
set
{
if (value != _colorPickerView)
{
_colorPickerView = value;
ChangeView(value).AndForget();
}
}
}
/// <summary>
/// If true, binding changes occurred also when HSL values changed without a corresponding RGB change
/// </summary>
[Parameter]
[Category(CategoryTypes.FormComponent.Behavior)]
public bool UpdateBindingIfOnlyHSLChanged { get; set; } = false;
/// <summary>
/// A two-way bindable property representing the selected value. MudColor is a utility class that can be used to get the value as RGB, HSL, hex or other value
/// </summary>
[Parameter]
[Category(CategoryTypes.FormComponent.Data)]
public Color Value
{
get => _color;
set
{
if (value == null) { return; }
var rgbChanged = value != _color;
var hslChanged = _color == null ? false : value.HslChanged(_color);
_color = value;
if (rgbChanged)
{
if (_skipFeedback == false)
{
UpdateBaseColor();
UpdateColorSelectorBasedOnRgb();
}
SetTextAsync(GetColorTextValue(), false).AndForget();
ValueChanged.InvokeAsync(value).AndForget();
FieldChanged(value);
}
if (rgbChanged == false && UpdateBindingIfOnlyHSLChanged && hslChanged == true)
{
SetTextAsync(GetColorTextValue(), false).AndForget();
ValueChanged.InvokeAsync(value).AndForget();
FieldChanged(value);
}
}
}
[Parameter] public EventCallback<Color> ValueChanged { get; set; }
/// <summary>
/// MudColor list of predefined colors. The first five colors will show up as the quick colors on preview dot click.
/// </summary>
[Parameter]
[Category(CategoryTypes.FormComponent.PickerBehavior)]
public IEnumerable<Color> Palette { get; set; } = new Color[]
{ "#424242", "#2196f3", "#00c853", "#ff9800", "#f44336",
"#f6f9fb", "#9df1fa", "#bdffcf", "#fff0a3", "#ffd254",
"#e6e9eb", "#27dbf5", "#7ef7a0", "#ffe273", "#ffb31f",
"#c9cccf", "#13b8e8", "#14dc71", "#fdd22f", "#ff9102",
"#858791", "#0989c2", "#1bbd66", "#ebb323", "#fe6800",
"#585b62", "#17698e", "#17a258", "#d9980d", "#dc3f11",
"#353940", "#113b53", "#127942", "#bf7d11", "#aa0000"
};
private IEnumerable<Color> _gridList = new Color[]
{
"#FFFFFF","#ebebeb","#d6d6d6","#c2c2c2","#adadad","#999999","#858586","#707070","#5c5c5c","#474747","#333333","#000000",
"#133648","#071d53","#0f0638","#2a093b","#370c1b","#541107","#532009","#53350d","#523e0f","#65611b","#505518","#2b3d16",
"#1e4c63","#0f2e76","#180b4e","#3f1256","#4e1629","#781e0e","#722f10","#734c16","#73591a","#8c8629","#707625","#3f5623",
"#2e6c8c","#1841a3","#280c72","#591e77","#6f223d","#a62c17","#a0451a","#a06b23","#9f7d28","#c3bc3c","#9da436","#587934",
"#3c8ab0","#2155ce","#331c8e","#702898","#8d2e4f","#d03a20","#ca5a24","#c8862e","#c99f35","#f3ec4e","#c6d047","#729b44",
"#479fd3","#2660f5","#4725ab","#8c33b5","#aa395d","#eb512e","#ed732e","#f3ae3d","#f5c944","#fefb67","#ddeb5c","#86b953",
"#59c4f7","#4e85f6","#5733e2","#af43eb","#d44a7a","#ed6c59","#ef8c56","#f3b757","#f6cd5b","#fef881","#e6ee7a","#a3d16e",
"#78d3f8","#7fa6f8","#7e52f5","#c45ff6","#de789d","#f09286","#f2a984","#f6c983","#f9da85","#fef9a1","#ebf29b","#badc94",
"#a5e1fa","#adc5fa","#ab8df7","#d696f8","#e8a7bf","#f4b8b1","#f6c7af","#f9daae","#fae5af","#fefbc0","#f3f7be","#d2e7ba",
"#d2effd","#d6e1fc","#d6c9fa","#e9cbfb","#f3d4df","#f9dcd9","#fae3d8","#fcecd7","#fdf2d8","#fefce0","#f7fade","#e3edd6"
};
/// <summary>
/// When set to true, no mouse move events in the spectrum mode will be captured, so the selector circle won't fellow the mouse.
/// Under some conditions like long latency the visual representation might not reflect the user behaviour anymore. So, it can be disabled
/// Enabled by default
/// </summary>
[Parameter]
[Category(CategoryTypes.FormComponent.PickerBehavior)]
public bool DisableDragEffect { get; set; } = false;
/// <summary>
/// Custom close icon.
/// </summary>
[Parameter]
[Category(CategoryTypes.FormComponent.PickerAppearance)]
public string CloseIcon { get; set; } = Icons.Material.Filled.Close;
/// <summary>
/// Custom spectrum icon.
/// </summary>
[Parameter]
[Category(CategoryTypes.FormComponent.PickerAppearance)]
public string SpectrumIcon { get; set; } = Icons.Material.Filled.Tune;
/// <summary>
/// Custom grid icon.
/// </summary>
[Parameter]
[Category(CategoryTypes.FormComponent.PickerAppearance)]
public string GridIcon { get; set; } = Icons.Material.Filled.Apps;
/// <summary>
/// Custom palette icon.
/// </summary>
[Parameter]
[Category(CategoryTypes.FormComponent.PickerAppearance)]
public string PaletteIcon { get; set; } = Icons.Material.Filled.Palette;
/// <summary>
/// Custom import/export icont.
/// </summary>
[Parameter]
[Category(CategoryTypes.FormComponent.PickerAppearance)]
public string ImportExportIcon { get; set; } = Icons.Material.Filled.ImportExport;
#endregion
private void ToggleCollection()
{
_collectionOpen = !_collectionOpen;
}
private void SelectPaletteColor(Color color)
{
Value = color;
_collectionOpen = false;
if (
IsAnyControlVisible() == false || _activeColorPickerView is ColorPickerView.GridCompact or ColorPickerView.Palette)
{
Close();
}
}
public void ChangeMode() =>
ColorPickerMode = ColorPickerMode switch
{
ColorPickerMode.RGB => ColorPickerMode.HSL,
ColorPickerMode.HSL => ColorPickerMode.HEX,
ColorPickerMode.HEX => ColorPickerMode.RGB,
_ => ColorPickerMode.RGB,
};
public async Task ChangeView(ColorPickerView value)
{
var oldValue = _activeColorPickerView;
_activeColorPickerView = value;
Text = GetColorTextValue();
if (oldValue == ColorPickerView.Spectrum)
{
await RemoveMouseOverEvent();
}
if (value == ColorPickerView.Spectrum)
{
_attachedMouseEvent = true;
}
}
private void UpdateBaseColorSlider(int value)
{
var diff = Math.Abs(value - (int)Value.H);
if (diff == 0) { return; }
Value = Value.SetH(value);
}
private void UpdateBaseColor()
{
var index = (int)_color.H / 60;
if (index == 6)
{
index = 5;
}
var valueInDeg = (int)_color.H - (index * 60);
var value = (int)(MathExtensions.Map(0, 60, 0, 255, valueInDeg));
var section = _rgbToHueMapper[index];
_baseColor = new(section.r(value), section.g(value), section.b(value), 255);
}
private void UpdateColorBaseOnSelection()
{
var x = _selectorX / _maxX;
var r_x = 255 - (int)((255 - _baseColor.R) * x);
var g_x = 255 - (int)((255 - _baseColor.G) * x);
var b_x = 255 - (int)((255 - _baseColor.B) * x);
var y = 1.0 - _selectorY / _maxY;
var r = r_x * y;
var g = g_x * y;
var b = b_x * y;
_skipFeedback = true;
//in this mode, H is expected to be stable, so copy H value
Value = new Color((byte)r, (byte)g, (byte)b, _color);
_skipFeedback = false;
}
private void UpdateColorSelectorBasedOnRgb()
{
var hueValue = (int)MathExtensions.Map(0, 360, 0, 6 * 255, _color.H);
var index = hueValue / 255;
if (index == 6)
{
index = 5;
}
var section = _rgbToHueMapper[index];
var colorValues = section.dominantColorPart switch
{
"rb" => (_color.R, _color.B),
"rg" => (_color.R, _color.G),
"gb" => (_color.G, _color.B),
"gr" => (_color.G, _color.R),
"br" => (_color.B, _color.R),
"bg" => (_color.B, _color.G),
_ => (255, 255)
};
var primaryDiff = 255 - colorValues.Item1;
var primaryDiffDelta = colorValues.Item1 / 255.0;
_selectorY = MathExtensions.Map(0, 255, 0, _maxY, primaryDiff);
var secondaryColorX = colorValues.Item2 * (1.0 / primaryDiffDelta);
var relation = (255 - secondaryColorX) / 255.0;
_selectorX = relation * _maxX;
}
#region mouse interactions
private void HandleColorOverlayClicked()
{
UpdateColorBaseOnSelection();
if (IsAnyControlVisible() == false)
{
Close();
}
}
private void OnSelectorClicked(MouseEventArgs e)
{
SetSelectorBasedOnMouseEvents(e, false);
HandleColorOverlayClicked();
}
private void OnColorOverlayClick(MouseEventArgs e)
{
SetSelectorBasedOnMouseEvents(e, true);
HandleColorOverlayClicked();
}
private void OnMouseOver(MouseEventArgs e)
{
if (e.Buttons == 1)
{
SetSelectorBasedOnMouseEvents(e, true);
UpdateColorBaseOnSelection();
}
}
private void SetSelectorBasedOnMouseEvents(MouseEventArgs e, bool offsetIsAbsolute)
{
_selectorX = (offsetIsAbsolute == true ? e.OffsetX : (e.OffsetX - _selctorSize / 2.0) + _selectorX).EnsureRange(_maxX);
_selectorY = (offsetIsAbsolute == true ? e.OffsetY : (e.OffsetY - _selctorSize / 2.0) + _selectorY).EnsureRange(_maxY);
}
#endregion
#region updating inputs
/// <summary>
/// Set the R (red) component of the color picker
/// </summary>
/// <param name="value">A value between 0 (no red) or 255 (max red)</param>
public void SetR(int value) => Value = Value.SetR(value);
/// <summary>
/// Set the G (green) component of the color picker
/// </summary>
/// <param name="value">A value between 0 (no green) or 255 (max green)</param>
public void SetG(int value) => Value = Value.SetG(value);
/// <summary>
/// Set the B (blue) component of the color picker
/// </summary>
/// <param name="value">A value between 0 (no blue) or 255 (max blue)</param>
public void SetB(int value) => Value = Value.SetB(value);
/// <summary>
/// Set the H (hue) component of the color picker
/// </summary>
/// <param name="value">A value between 0 and 360 (degrees)</param>
public void SetH(double value) => Value = Value.SetH(value);
/// <summary>
/// Set the S (saturation) component of the color picker
/// </summary>
/// <param name="value">A value between 0.0 (no saturation) and 1.0 (max saturation)</param>
public void SetS(double value) => Value = Value.SetS(value);
/// <summary>
/// Set the L (Lightness) component of the color picker
/// </summary>
/// <param name="value">A value between 0.0 (no light, black) and 1.0 (max light, white)</param>
public void SetL(double value) => Value = Value.SetL(value);
/// <summary>
/// Set the Alpha (transparency) component of the color picker
/// </summary>
/// <param name="value">A value between 0.0 (full transparent) and 1.0 (solid) </param>
public void SetAlpha(double value) => Value = Value.SetAlpha(value);
/// <summary>
/// Set the Alpha (transparency) component of the color picker
/// </summary>
/// <param name="value">A value between 0 (full transparent) and 1 (solid) </param>
public void SetAlpha(int value) => Value = Value.SetAlpha(value);
/// <summary>
/// Set the color of the picker based on the string input
/// </summary>
/// <param name="input">Accepting different formats for a color representation such as rbg, rgba, #</param>
public void SetInputString(string input)
{
Color color;
try
{
color = new Color(input);
}
catch (Exception)
{
return;
}
Value = color;
}
protected override Task StringValueChanged(string value)
{
SetInputString(value);
return Task.CompletedTask;
}
private bool _attachedMouseEvent = false;
protected override void OnPickerOpened()
{
base.OnPickerOpened();
_attachedMouseEvent = true;
StateHasChanged();
}
protected override void OnPickerClosed()
{
base.OnPickerClosed();
RemoveMouseOverEvent().AndForget();
}
#endregion
#region helper
private string GetSelectorLocation() => $"translate({Math.Round(_selectorX, 2).ToString(CultureInfo.InvariantCulture)}px, {Math.Round(_selectorY, 2).ToString(CultureInfo.InvariantCulture)}px);";
private string GetColorTextValue() => (DisableAlpha == true || _activeColorPickerView is ColorPickerView.Palette or ColorPickerView.GridCompact) ? _color.ToString(ColorOutputFormats.Hex) : _color.ToString(ColorOutputFormats.HexA);
private int GetHexColorInputMaxLength() => DisableAlpha ? 7 : 9;
private EventCallback<MouseEventArgs> GetEventCallback() => EventCallback.Factory.Create<MouseEventArgs>(this, () => Close());
private bool IsAnyControlVisible() => !(DisablePreview && DisableSliders && DisableInputs);
private EventCallback<MouseEventArgs> GetSelectPaletteColorCallback(Color color) => new EventCallbackFactory().Create(this, (MouseEventArgs e) => SelectPaletteColor(color));
private ThemeColor GetButtonColor(ColorPickerView view) => _activeColorPickerView == view ? ThemeColor.Primary : ThemeColor.Inherit;
private string GetColorDotClass(Color color) => new CssBuilder("mud-picker-color-dot").AddClass("selected", color == Value).ToString();
private string AlphaSliderStyle => new StyleBuilder().AddStyle($"background-image: linear-gradient(to {(RightToLeft ? "left" : "right")}, transparent, {_color.ToString(ColorOutputFormats.RGB)})").Build();
#endregion
#region life cycle hooks
protected override async Task OnAfterRenderAsync(bool firstRender)
{
await base.OnAfterRenderAsync(firstRender);
if (firstRender == true)
{
if (PickerVariant == PickerVariant.Static)
{
await AddMouseOverEvent();
}
}
if (_attachedMouseEvent == true)
{
_attachedMouseEvent = false;
await AddMouseOverEvent();
}
}
private async Task AddMouseOverEvent()
{
if (DisableDragEffect == true) { return; }
if (_throttledEventManager == null)
{
_throttledEventManager = ThrottledEventManagerFactory.Create();
}
_throttledMouseOverEventId = await
_throttledEventManager.Subscribe<MouseEventArgs>("mousemove", _id.ToString(), "mudEventProjections.correctOffset", 10, async (x) =>
{
var e = x as MouseEventArgs;
await InvokeAsync(() => OnMouseOver(e));
StateHasChanged();
});
}
private Task RemoveMouseOverEvent()
{
if (_throttledMouseOverEventId == default) { return Task.CompletedTask; }
return _throttledEventManager.Unsubscribe(_throttledMouseOverEventId);
}
public async ValueTask DisposeAsync()
{
if (_throttledEventManager == null) { return; }
await _throttledEventManager.DisposeAsync();
}
#endregion
}

@ -0,0 +1,22 @@
using Microsoft.AspNetCore.Components;
namespace Connected.Components;
public abstract class ColumnBase : ComponentBase
{
public enum Rendermode
{
Header, Item, Edit, Footer
}
[CascadingParameter(Name = "Mode")]
public Rendermode Mode { get; set; }
[Parameter] public bool Visible { get; set; } = true;
[Parameter] public string HeaderText { get; set; }
protected bool IsDefault<T>(T value)
{
return EqualityComparer<T>.Default.Equals(value, default(T));
}
}

Some files were not shown because too many files have changed in this diff Show More

Loading…
Cancel
Save