diff --git a/.github/workflows/blazor-hybrid-issue-processing.yml b/.github/workflows/blazor-hybrid-issue-processing.yml index 3271e29d21f6..8323394b5c23 100644 --- a/.github/workflows/blazor-hybrid-issue-processing.yml +++ b/.github/workflows/blazor-hybrid-issue-processing.yml @@ -17,23 +17,9 @@ jobs: issue_number: context.issue.number, owner: context.repo.owner, repo: context.repo.repo, - body: `### πŸ‚πŸŽ **_Happy Holidays!_** ❄️⛄ + body: `### πŸ’ƒπŸ•ΊπŸ₯³ **_Happy New Year!_** πŸŽˆπŸŽ†πŸΎπŸ₯‚πŸŽ‰ - This issue has been marked for triage on the Blazor Hybrid Docs GitHub project, and we'll respond as soon as we return from the holiday vacation after New Year's. - - We only work on documentation on this repo. If you need product support, close this issue and seek assistance through one or more of the following support channels: - - * [Stack Overflow (tagged: 'blazor')](https://stackoverflow.com/questions/tagged/blazor) - * [General ASP.NET Core Slack Team](https://aspnetcore.slack.com/join/shared_invite/zt-1mv5487zb-EOZxJ1iqb0A0ajowEbxByQ#/shared-invite/email) - * [Blazor Gitter](https://gitter.im/aspnet/Blazor) - - If you think that you found a potential bug in the framework or have product feedback, close this issue and open a new issue for the ASP.NET Core product unit at [dotnet/aspnetcore issues](https://github.com/dotnet/aspnetcore/issues). Bug reports require a clear explanation of the problem, usually including a minimal repro project placed on GitHub for the product unit engineers to download and run. If you determine with the product unit that it isn't a bug but merely requires documentation, please re-open this docs issue and place a cross-link to your engineering issue discussion. - - For problems or feedback on Visual Studio, close this issue and use the [**Report a Problem**](https://docs.microsoft.com/visualstudio/ide/how-to-report-a-problem-with-visual-studio) or [**Suggest a Feature**](https://docs.microsoft.com/visualstudio/ide/suggest-a-feature) processes from within VS, which open internal issues for the VS product unit. For more information, see [Visual Studio Feedback](https://developercommunity.visualstudio.com/home). - - For problems with Visual Studio Code, close this issue and ask for support on community support forums. For bug reports and product feedback, open an issue on the [microsoft/vscode GitHub repo](https://github.com/microsoft/vscode/issues). - - πŸ’ƒπŸ•ΊπŸ₯³ **_Happy New Year!_** πŸŽˆπŸŽ†πŸΎπŸ₯‚πŸŽ‰ **_See you in 2025!_**` + A green dinosaur πŸ¦– will be along shortly to assist. *Stand-by ........*` }) await github.rest.issues.addLabels({ issue_number: context.issue.number, diff --git a/.github/workflows/blazor-issue-processing.yml b/.github/workflows/blazor-issue-processing.yml index 34d79b0670b3..11eaf2da9950 100644 --- a/.github/workflows/blazor-issue-processing.yml +++ b/.github/workflows/blazor-issue-processing.yml @@ -22,23 +22,9 @@ jobs: issue_number: context.issue.number, owner: context.repo.owner, repo: context.repo.repo, - body: `### πŸ‚πŸŽ **_Happy Holidays!_** ❄️⛄ + body: `### πŸ’ƒπŸ•ΊπŸ₯³ **_Happy New Year!_** πŸŽˆπŸŽ†πŸΎπŸ₯‚πŸŽ‰ - This issue has been marked for triage on the Blazor Docs GitHub project, and I'll respond as soon as I return from the holiday vacation after New Year's. - - We only work on documentation on this repo. If you need product support, close this issue and seek assistance through one or more of the following support channels: - - * [Stack Overflow (tagged: 'blazor')](https://stackoverflow.com/questions/tagged/blazor) - * [General ASP.NET Core Slack Team](https://aspnetcore.slack.com/join/shared_invite/zt-1mv5487zb-EOZxJ1iqb0A0ajowEbxByQ#/shared-invite/email) - * [Blazor Gitter](https://gitter.im/aspnet/Blazor) - - If you think that you found a potential bug in the framework or have product feedback, close this issue and open a new issue for the ASP.NET Core product unit at [dotnet/aspnetcore issues](https://github.com/dotnet/aspnetcore/issues). Bug reports require a clear explanation of the problem, usually including a minimal repro project placed on GitHub for the product unit engineers to download and run. If you determine with the product unit that it isn't a bug but merely requires documentation, please re-open this docs issue and place a cross-link to your engineering issue discussion. - - For problems or feedback on Visual Studio, close this issue and use the [**Report a Problem**](https://docs.microsoft.com/visualstudio/ide/how-to-report-a-problem-with-visual-studio) or [**Suggest a Feature**](https://docs.microsoft.com/visualstudio/ide/suggest-a-feature) processes from within VS, which open internal issues for the VS product unit. For more information, see [Visual Studio Feedback](https://developercommunity.visualstudio.com/home). - - For problems with Visual Studio Code, close this issue and ask for support on community support forums. For bug reports and product feedback, open an issue on the [microsoft/vscode GitHub repo](https://github.com/microsoft/vscode/issues). - - πŸ’ƒπŸ•ΊπŸ₯³ **_Happy New Year!_** πŸŽˆπŸŽ†πŸΎπŸ₯‚πŸŽ‰ **_See you in 2025!_**` + *Stand-by!* ... A green dinosaur πŸ¦– will be along shortly to assist.` }) await github.rest.issues.addLabels({ issue_number: context.issue.number, diff --git a/aspnetcore/blazor/forms/index.md b/aspnetcore/blazor/forms/index.md index 99c8268a295a..0d4f6b112d27 100644 --- a/aspnetcore/blazor/forms/index.md +++ b/aspnetcore/blazor/forms/index.md @@ -114,13 +114,13 @@ A form is defined using the Blazor framework's component is rendered where the `` element appears. The form is named with the [`@formname`](xref:mvc/views/razor#formname) directive attribute, which uniquely identifies the form to the Blazor framework. +* The component is rendered where the `` element appears. The form is named with the property, which uniquely identifies the form to the Blazor framework. * The model is created in the component's `@code` block and held in a public property (`Model`). The property is assigned to the parameter. The `[SupplyParameterFromForm]` attribute indicates that the value of the associated property should be supplied from the form data. Data in the request that matches the property's name is bound to the property. * The component is an [input component](xref:blazor/forms/input-components) for editing string values. The `@bind-Value` directive attribute binds the `Model.Id` model property to the component's property. * The `Submit` method is registered as a handler for the callback. The handler is called when the form is submitted by the user. > [!IMPORTANT] -> Always use the [`@formname`](xref:mvc/views/razor#formname) directive attribute with a unique form name. +> Always use the property with a unique form name. Blazor enhances page navigation and form handling for components. For more information, see . diff --git a/aspnetcore/blazor/globalization-localization.md b/aspnetcore/blazor/globalization-localization.md index 2a755f3738a9..1995d67115b2 100644 --- a/aspnetcore/blazor/globalization-localization.md +++ b/aspnetcore/blazor/globalization-localization.md @@ -276,9 +276,6 @@ For information on ordering the Localization Middleware in the middleware pipeli Use the `CultureExample1` component shown in the [Demonstration component](#demonstration-component) section to study how globalization works. Issue a request with United States English (`en-US`). Switch to Costa Rican Spanish (`es-CR`) in the browser's language settings. Request the webpage again. -> [!NOTE] -> Some browsers force you to use the default language setting for both requests and the browser's own UI settings. This can make changing the language back to one that you understand difficult because all of the setting UI screens might end up in a language that you can't read. A browser such as [Opera](https://www.opera.com/download) is a good choice for testing because it permits you to set a default language for webpage requests but leave the browser's settings UI in your language. - When the culture is United States English (`en-US`), the rendered component uses month/day date formatting (`6/7`), 12-hour time (`AM`/`PM`), and comma separators in numbers with a dot for the decimal value (`1,999.69`): * **Date**: 6/7/2021 6:45:22 AM diff --git a/aspnetcore/blazor/hosting-models.md b/aspnetcore/blazor/hosting-models.md index e60b784d3bac..ab0408face71 100644 --- a/aspnetcore/blazor/hosting-models.md +++ b/aspnetcore/blazor/hosting-models.md @@ -50,8 +50,18 @@ In a traditional server-rendered app, opening the same app in multiple browser s ![The browser interacts with Blazor (hosted inside of an ASP.NET Core app) on the server over a SignalR connection.](~/blazor/hosting-models/_static/blazor-server.png) +:::moniker range=">= aspnetcore-10.0" + +On the client, the Blazor script establishes the SignalR connection with the server. The script is served as a static web asset with automatic compression and [fingerprinting](https://developer.mozilla.org/docs/Glossary/Fingerprinting). + +:::moniker-end + +:::moniker range="< aspnetcore-10.0" + On the client, the Blazor script establishes the SignalR connection with the server. The script is served from an embedded resource in the ASP.NET Core shared framework. +:::moniker-end + The Blazor Server hosting model offers several benefits: * Download size is significantly smaller than when the Blazor WebAssembly hosting model is used, and the app loads much faster. @@ -97,8 +107,8 @@ A Blazor WebAssembly app built as a [Progressive Web App (PWA)](xref:blazor/prog The Blazor script handles: -* Downloading the .NET runtime, Razor components, and the component's dependencies. -* Initialization of the runtime. +* Downloading the .NET runtime, Razor components, and dependencies. +* Runtime initialization. The size of the published app, its *payload size*, is a critical performance factor for an app's usability. A large app takes a relatively long time to download to a browser, which diminishes the user experience. Blazor WebAssembly optimizes payload size to reduce download times: diff --git a/aspnetcore/blazor/includes/js-interop/js-collocation.md b/aspnetcore/blazor/includes/js-interop/js-collocation.md index 4170582bf5cc..8804b10bf555 100644 --- a/aspnetcore/blazor/includes/js-interop/js-collocation.md +++ b/aspnetcore/blazor/includes/js-interop/js-collocation.md @@ -152,6 +152,9 @@ export function showPrompt2(message) { } ``` +> [!IMPORTANT] +> Don't place a `