Introdução ao BlazorIntroduction to Blazor

Por Daniel Roth e Luke LathamBy Daniel Roth and Luke Latham

Bem-vindo ao Blazor!Welcome to Blazor!

O Blazor é uma estrutura para criar uma interface do usuário web interativa do lado do cliente com o .NET:Blazor is a framework for building interactive client-side web UI with .NET:

  • Crie interfaces do usuário interativas avançadas usando C# em vez de JavaScript.Create rich interactive UIs using C# instead of JavaScript.
  • Compartilhe a lógica de aplicativo do lado do cliente e do servidor gravada no .NET.Share server-side and client-side app logic written in .NET.
  • Renderize a interface do usuário, como HTML e CSS para suporte amplo de navegadores, incluindo navegadores móveis.Render the UI as HTML and CSS for wide browser support, including mobile browsers.

Usar o .NET para desenvolvimento web do lado do cliente oferece as seguintes vantagens:Using .NET for client-side web development offers the following advantages:

  • escreva o código em C# em vez de JavaScript.Write code in C# instead of JavaScript.
  • Aproveite o ecossistema .NET existente das bibliotecas .NET.Leverage the existing .NET ecosystem of .NET libraries.
  • Compartilhe a lógica de aplicativo entre o servidor e o cliente.Share app logic across server and client.
  • Beneficie-se com o desempenho, confiabilidade e segurança do .NET.Benefit from .NET's performance, reliability, and security.
  • mantenha-se produtivo com o Visual Studio no Windows, Linux e macOS.Stay productive with Visual Studio on Windows, Linux, and macOS.
  • Crie um conjunto comum de linguagens, estruturas e ferramentas que são estáveis, com recursos avançados e fáceis de usar.Build on a common set of languages, frameworks, and tools that are stable, feature-rich, and easy to use.

ComponentesComponents

Os aplicativos Blazor se baseiam em componentes.Blazor apps are based on components. Um componente no Blazor é um elemento da interface do usuário, como uma página, uma caixa de diálogo ou um formulário de entrada de dados.A component in Blazor is an element of UI, such as a page, dialog, or data entry form.

Os componentes são classes do .NET incorporadas a assemblies .NET que:Components are .NET classes built into .NET assemblies that:

A classe do componente geralmente é gravada na forma de uma página de marcação do Razor com uma extensão de arquivo .razor.The component class is usually written in the form of a Razor markup page with a .razor file extension. Os componentes no Blazor são formalmente chamados de componentes do Razor.Components in Blazor are formally referred to as Razor components. O Razor é uma sintaxe para a combinação de marcação HTML com o código C# projetada para melhorar a produtividade do desenvolvedor.Razor is a syntax for combining HTML markup with C# code designed for developer productivity. O Razor permite que você alterne entre a marcação HTML e C# no mesmo arquivo com suporte IntelliSense.Razor allows you to switch between HTML markup and C# in the same file with IntelliSense support. As Razor Pages e MVC também usam o Razor.Razor Pages and MVC also use Razor. Ao contrário das Razor Pages e das MVC, que são criadas ao redor de um modelo de solicitação/resposta, os componentes são usados especificamente para composição e lógica da interface do usuário do lado do cliente.Unlike Razor Pages and MVC, which are built around a request/response model, components are used specifically for client-side UI logic and composition.

A seguinte marcação Razor demonstra um componente (Dialog.razor), que pode ser aninhado dentro de outro componente:The following Razor markup demonstrates a component (Dialog.razor), which can be nested within another component:

<div>
    <h1>@Title</h1>

    @ChildContent

    <button @onclick="OnYes">Yes!</button>
</div>

@code {
    [Parameter]
    public string Title { get; set; }

    [Parameter]
    public RenderFragment ChildContent { get; set; }

    private void OnYes()
    {
        Console.WriteLine("Write to the console in C#! 'Yes' button was selected.");
    }
}

O conteúdo do corpo da caixa de diálogo (ChildContent) e o título (Title) são fornecidos pelo componente que usa esse componente em sua interface do usuário.The dialog's body content (ChildContent) and title (Title) are provided by the component that uses this component in its UI. OnYes é um método C# disparado pelo evento onclick do botão.OnYes is a C# method triggered by the button's onclick event.

O Blazor usa marcações HTML naturais para composição de interface do usuário.Blazor uses natural HTML tags for UI composition. Os elementos HTML especificam componentes e os atributos da marcação transmitem valores para as propriedades de um componente.HTML elements specify components, and a tag's attributes pass values to a component's properties.

No exemplo a seguir, o componente Index usa o componente Dialog.In the following example, the Index component uses the Dialog component. ChildContent e Title são definidos pelos atributos e pelo conteúdo do elemento <Dialog>.ChildContent and Title are set by the attributes and content of the <Dialog> element.

Index.razor:Index.razor:

@page "/"

<h1>Hello, world!</h1>

Welcome to your new app.

<Dialog Title="Blazor">
    Do you want to <i>learn more</i> about Blazor?
</Dialog>

A caixa de diálogo é renderizada quando o pai (Index.razor) é acessado em um navegador:The dialog is rendered when the parent (Index.razor) is accessed in a browser:

Componente da caixa de diálogo renderizada no navegador

Quando esse componente é usado no aplicativo, o IntelliSense no Visual Studio e no Visual Studio Code acelera o desenvolvimento com o preenchimento de sintaxe e de parâmetro.When this component is used in the app, IntelliSense in Visual Studio and Visual Studio Code speeds development with syntax and parameter completion.

Os componentes são renderizados em uma representação na memória do Modelo de Objeto do Documento (DOM) do navegador chamada árvore de renderização, que é usada para atualizar a interface do usuário de maneira flexível e eficiente.Components render into an in-memory representation of the browser's Document Object Model (DOM) called a render tree, which is used to update the UI in a flexible and efficient way.

Webassembly mais incrivelmenteBlazor WebAssembly

Webassembly mais simples é uma estrutura de aplicativo de página única para criar aplicativos Web do lado do cliente interativos com o .NET.Blazor WebAssembly is a single-page app framework for building interactive client-side web apps with .NET. Webassembly mais versátil usa padrões abertos da Web sem plug-ins ou código transpilação e trabalha em todos os navegadores modernos da Web, incluindo navegadores móveis.Blazor WebAssembly uses open web standards without plugins or code transpilation and works in all modern web browsers, including mobile browsers.

A execução do código do .NET em navegadores da Web é possibilitada por WebAssembly (abreviado como wasm).Running .NET code inside web browsers is made possible by WebAssembly (abbreviated wasm). O WebAssembly é um formato de código de bytes compacto, otimizado para download rápido e máxima velocidade de execução.WebAssembly is a compact bytecode format optimized for fast download and maximum execution speed. O WebAssembly é um padrão aberto da Web compatível com navegadores da Web sem plug-ins.WebAssembly is an open web standard and supported in web browsers without plugins.

O código WebAssembly pode acessar a funcionalidade completa do navegador por meio de JavaScript, chamado Interoperabilidade do JavaScript (ou Interop do JavaScript).WebAssembly code can access the full functionality of the browser via JavaScript, called JavaScript interoperability (or JavaScript interop). O código .NET executado por meio da WebAssembly no navegador é executado na área restrita do JavaScript do navegador com as proteções que a área restrita oferece contra ações mal intencionadas no computador cliente..NET code executed via WebAssembly in the browser runs in the browser's JavaScript sandbox with the protections that the sandbox provides against malicious actions on the client machine.

Webassembly mais incrivelmente executa o código .NET no navegador com Webassembly.

Quando um aplicativo Webassembly mais elaborado é criado e executado em um navegador:When a Blazor WebAssembly app is built and run in a browser:

  • os arquivos C# e os arquivos Razor são compilados em assemblies do .NET.C# code files and Razor files are compiled into .NET assemblies.
  • os assemblies e o tempo de execução do .NET são baixados no navegador.The assemblies and the .NET runtime are downloaded to the browser.
  • O Webassembly de mais incrivelmente Inicializa o tempo de execução do .NET e configura o tempo de execução para carregar os assemblies para o aplicativo.Blazor WebAssembly bootstraps the .NET runtime and configures the runtime to load the assemblies for the app. O tempo de execução do Webassembly mais incrivelmente usa a interoperabilidade JavaScript para lidar com a manipulação de DOM e chamadas de API de navegadorThe Blazor WebAssembly runtime uses JavaScript interop to handle DOM manipulation and browser API calls.

O tamanho do aplicativo publicado, seu tamanho de payload, é um fator de desempenho crítico para a utilidade do aplicativo.The size of the published app, its payload size, is a critical performance factor for an app's useability. Um aplicativo grande leva um tempo relativamente longo para baixar para um navegador, o que afeta a experiência do usuário.A large app takes a relatively long time to download to a browser, which diminishes the user experience. Webassembly mais incrivelmente otimiza o tamanho da carga para reduzir os tempos de download:Blazor WebAssembly optimizes payload size to reduce download times:

  • O código não utilizado é retirado do aplicativo quando publicado pelo Vinculador de linguagem intermediária (IL).Unused code is stripped out of the app when it's published by the Intermediate Language (IL) Linker.
  • As respostas HTTP são compactadas.HTTP responses are compressed.
  • O tempo de execução do .NET e os assemblies são armazenados em cache no navegador.The .NET runtime and assemblies are cached in the browser.

Servidor mais incrivelmenteBlazor Server

Os componentes Blazor desvinculam a lógica de renderização do componente da forma como as atualizações da interface do usuário são aplicadas.Blazor decouples component rendering logic from how UI updates are applied. O servidor mais incrivelmente dá suporte para hospedar componentes do Razor no servidor em um aplicativo ASP.NET Core.Blazor Server provides support for hosting Razor components on the server in an ASP.NET Core app. As atualizações da interface do usuário são tratadas por uma conexão SignalR.UI updates are handled over a SignalR connection.

O tempo de execução realiza o envio de eventos da interface do usuário do navegador para o servidor e executar os componentes, aplica as atualizações na interface do usuário retornadas pelo servidor ao navegador.The runtime handles sending UI events from the browser to the server and applies UI updates sent by the server back to the browser after running the components.

A conexão usada pelo servidor mais incrivelmente para se comunicar com o navegador também é usada para lidar com as chamadas de interoperabilidade do JavaScript.The connection used by Blazor Server to communicate with the browser is also used to handle JavaScript interop calls.

O servidor de mais incrivelmente executa o código .NET no servidor e interage com o Modelo de Objeto do Documento no cliente por meio de uma conexão de sinalização

Interoperabilidade do JavaScriptJavaScript interop

Para aplicativos que exigem bibliotecas JavaScript e acesso a APIs do navegador de terceiros, os componentes interoperam com o JavaScript.For apps that require third-party JavaScript libraries and access to browser APIs, components interoperate with JavaScript. Os componentes são capazes de usar qualquer biblioteca ou API que o JavaScript possa usar.Components are capable of using any library or API that JavaScript is able to use. O código C# pode chamar o código JavaScript, e o código JavaScript pode chamar o código C#.C# code can call into JavaScript code, and JavaScript code can call into C# code. Para obter mais informações, consulte ASP.NET Core a interoperabilidade de JavaScript mais incrivelmente.For more information, see ASP.NET Core a interoperabilidade de JavaScript mais incrivelmente.

Compartilhamento de código e o .NET StandardCode sharing and .NET Standard

O Blazor implementa o .NET Standard 2.0.Blazor implements .NET Standard 2.0. O .NET Standard é uma especificação formal das APIs do .NET que são comuns entre as implementações do .NET..NET Standard is a formal specification of .NET APIs that are common across .NET implementations. As bibliotecas de classe do .NET Standard podem ser compartilhadas entre diferentes plataformas do .NET, como Blazor, .NET Framework, .NET Core, Xamarin, Mono e Unity..NET Standard class libraries can be shared across different .NET platforms, such as Blazor, .NET Framework, .NET Core, Xamarin, Mono, and Unity.

As APIs que não são aplicáveis em um navegador da Web (por exemplo, para acessar o sistema de arquivos, abrir um soquete e threading) geram a PlatformNotSupportedException.APIs that aren't applicable inside of a web browser (for example, accessing the file system, opening a socket, and threading) throw a PlatformNotSupportedException.

Recursos adicionaisAdditional resources