Pakete, Repositories und App-Kategorien suchen

Paketdetailsv2.3.0

universal_html

Ein 'dart:html', das auf allen Plattformen funktioniert, einschließlich Flutter und Server-Seite. Vereinfacht die Entwicklung für mehrere Plattformen und die Verarbeitung von HTML/XML.

AndroidiOSmacOSWindowsLinux
30-Tage-Downloads
662.000
Likes
516
Pub-Punkte
150

Paket installieren

flutter pub add universal_html

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

universal_html bietet eine einheitliche 'dart:html'-API, die auf allen Plattformen funktioniert, einschließlich Flutter auf mobilen Geräten, Desktop und serverseitigen Umgebungen. Sie ermöglicht eine konsistente Verarbeitung von HTML und XML unabhängig vom Laufzeitumfeld und vereinfacht die Entwicklung für mehrere Plattformen. Dieses Paket schließt die Lücke zwischen Web- und Nicht-Web-Umgebungen, indem es eine kompatible Schnittstelle für DOM-Manipulation, HTTP-Anfragen und das Parsen strukturierter Inhalte bereitstellt. Ideal für gemeinsame Logik zwischen Web und Backend-Diensten, reduziert es Code-Wiederholungen und optimiert Entwicklungsabläufe.

Anwendungsfälle

  • Plattformübergreifende Web- und Server-Logik
  • Geteilte HTML/XML-Auswertung
  • Server-seitige Rendering-Utilities
  • Wiederverwendung von Web-Komponenten in Flutter-Apps
  • Universelle Dart-Anwendungen erstellen

Hauptmerkmale

  • plattformunabhängige dart:html-API
  • Unterstützt DOM-Manipulation auf allen Plattformen
  • Eingebaute XML-/HTML-Parsing
  • Läuft nahtlos mit Flutter und Servern zusammen
  • Leichtgewichtig und minimale Abhängigkeiten

Geeignet für

  • Entwickler, die mehrere Plattformen ansprechen
  • Backend-Dienste, die HTML-Verarbeitung benötigen
  • Flutter-Anwendungen, die webähnliche Funktionen erfordern
  • Code-Sharing zwischen Web und Server
  • Projekte, die plattformspezifische Bedingungen vermeiden

Hinweise

  • Beschränkte browser-spezifische Funktionen auf nicht-Web-Plattformen
  • Keine Unterstützung für bestimmte DOM-Ereignisse außerhalb der Webumgebung
  • Die Leistung kann bei der Ausführung auf dem Server variieren
  • Nicht für die vollständige Browser-Simulation vorgesehen
  • Erfordert sorgfältige Behandlung asynchroner Operationen

Original-README

Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.

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', () {
    // ...
  });
}

Kategorien

Abhängigkeiten

Abhängigkeiten 9 Einträge

Quell-Repository

Projekte, die dieses Paket verwenden