Buscar pacotes, repositórios e categorias de apps

Detalhes do pacotev2.3.0

universal_html

Um 'dart:html' que funciona em todas as plataformas, incluindo Flutter e servidor. Facilita o desenvolvimento multiplataforma e o processamento de HTML/XML.

AndroidiOSmacOSWindowsLinux
Downloads em 30 dias
662 mil
Curtidas
516
Pontos Pub
150

Instalar pacote

flutter pub add universal_html

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

universal_html fornece uma API unificada 'dart:html' que funciona em todas as plataformas, incluindo Flutter em dispositivos móveis, desktop e ambientes do lado do servidor. Ela permite um processamento consistente de HTML e XML independentemente do tempo de execução, simplificando o desenvolvimento multiplataforma. Este pacote fecha a lacuna entre contextos web e não web ao oferecer uma interface compatível para manipulação do DOM, requisições HTTP e análise de conteúdo estruturado. Ideal para lógica compartilhada entre web e serviços de backend, reduz duplicação de código e agiliza os fluxos de desenvolvimento.

Casos de uso

  • Lógica de web e servidor multiplataforma
  • Análise compartilhada de HTML/XML
  • Utilitários de renderização do lado do servidor
  • Reutilização de componentes da Web em aplicativos Flutter
  • Construindo aplicativos universais em Dart

Principais recursos

  • API dart:html independente de plataforma
  • Suporte à manipulação do DOM em todas as plataformas
  • Análise XML/HTML embutida
  • Funciona sem problemas com o Flutter e servidores
  • Leve e dependências mínimas

Indicado para

  • Desenvolvedores direcionados para múltiplas plataformas
  • Serviços de backend que precisam de processamento HTML
  • Aplicativos Flutter que exigem recursos semelhantes aos da web
  • Compartilhamento de código entre web e servidor
  • Projetos evitando condicionais específicos da plataforma

Considerações

  • Recursos específicos do navegador limitados em plataformas não web
  • Sem suporte para certos eventos do DOM fora da web
  • O desempenho pode variar na execução do lado do servidor
  • Não destinado à emulação completa do navegador
  • Requer manipulação cuidadosa de operações assíncronas

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

Pub Package package publisher Github Actions CI

Introduction

A cross-platform replacement for dart:html (or package:web):

  • Eases cross-platform development
    • You can use this package in browsers, mobile, desktop, and server-side VM, and Node.JS.
    • Just replace dart:html / package:web imports with package:universal_html/universal_html.dart. Normal dart:html will continue to be used when application run in browsers.
  • Extensive support for processing HTML and XML documents
  • EventSource streaming support
    • Cross-platform dart:html EventSource ("application/event-stream").
    • If you want to customize EventSource HTTP headers outside browsers, see EventSourceOutsideBrowser.

The project is licensed under the Apache License 2.0. Some of the source code was adopted from the original dart:html in Dart SDK, which is documented in the relevant files.

Documentation

Similar projects

Getting started

1. Add dependency

In pubspec.yaml:

dependencies:
  universal_html: ^2.3.0

2. Use

import "package:universal_html/universal_html.dart";

void main() {
  // Create a DOM tree
  final div = DivElement();
  div.append(Element.tag("h1")
    ..classes.add("greeting")
    ..appendText("Hello world!"));

  // Print outer HTML
  print(div.outerHtml);
  // --> <div><h1>Hello world</h1></div>

  // Do a CSS query
  print(div.querySelector("div > .greeting").text);
  // --> Hello world
}

Examples

Parsing HTML

Use parseHtmlDocument:

import 'package:universal_html/parsing.dart';

void main() {
  final htmlDocument = parseHtmlDocument('<html>...</html>');
}

Parsing XML

Use parseXmlDocument:

import 'package:universal_html/parsing.dart';

void main() {
  final xmlDocument = parseXmlDocument('<xml>...</xml>');
}

Scraping a website

Load a Window with WindowController:

import 'dart:io' show Cookie;
import 'package:universal_html/controller.dart';

Future main() async {
  // Load a document.
  final controller = WindowController();
  controller.defaultHttpClient.userAgent = 'My Hacker News client';
  await controller.openHttp(
    method: 'GET',
    uri: Uri.parse("https://news.ycombinator.com/"),
    onRequest: (HttpClientRequest request) {
      // Add custom headers
      request.headers.set('Authorization', 'headerValue');
      request.cookies.add(Cookie('cookieName', 'cookieValue'));
    },
    onResponse: (HttpClientResponse response) {
      print('Status code: ${response.statusCode}');
    },
  );

  // Select the top story using a CSS query
  final titleElements = controller.document.querySelectorAll(".athing > .title");
  final topStoryTitle = titleElements.first.text;

  // Print result
  print("Top Hacker News story is: $topStoryTitle");
}

EventSource

EventSource (see mozilla.org) is a browser API for reading "application/event-stream" streams. It has been supported by browsers for a long time.

import 'package:universal_html/universal_html.dart';

Future<void> main() async {
  final eventSource = EventSource('http://example.com/events');
  await for (var message in event.onMessage) {
    print('Event type: ${message.type}');
    print('Event data: ${message.data}');
  }
}

EventSource requests from real browsers are typically authenticated using cookies. If you want to add cookies or customize other HTTP headers, you need to use EventSourceOutsideBrowser:

import 'package:universal_html/universal_html.dart';
import 'dart:io' show Cookie;

Future<void> main() async {
  final eventSource = EventSource('http://example.com/events');
  
  // The following block will NOT be executed in browsers.
  // Because compiler can infer instances of EventSourceOutsideBrowser are never constructed,
  // it will not appear in Javascript either.
  if (eventSource is EventSourceOutsideBrowser) {
    eventSource.onHttpClientRequest = (eventSource, request) {
      request.headers.set('Authorization', 'example');
      request.cookies.add(Cookie('name', 'value'));
    };
    eventSource.onHttpClientResponse = (eventSource, request, response) {
      // ...
    };
  }
  
  await for (var message in eventSource.onMessage) {
    print('Event:');
    print('  type: ${message.type}');
    print('  data: ${message.data}');
  }
}

Testing

import 'package:universal_html/controller.dart';
import 'package:test/test.dart';

void main() {
  setUp(() {
    WindowController.instance = WindowController();
  });
  
  test('test #1', () {
    // ...
  });
  
  test('test #2', () {
    // ...
  });
}

Categorias

Dependências

Lista de dependências 9 itens

Repositório-fonte

Projetos que usam este pacote