typed_soup 1.0.1
typed_soup: ^1.0.1 copied to clipboard
Dart native package inspired by Beautiful Soup 4 Python library. Provides easy ways of navigating, searching, and modifying the HTML tree.
example/main.dart
// ignore_for_file: constant_identifier_names
import 'package:typed_soup/typed_soup.dart';
const html_doc = """
<html>
<head>
<title>The Dormouse's story</title>
</head>
<body>
<p class="title"><b>The Dormouse's story</b></p>
<p class="story">Once upon a time there were three little sisters; and their names were
<a href="http://example.com/elsie" class="sister" id="link1">Elsie</a>,
<a href="http://example.com/lacie" class="sister" id="link2">Lacie</a> and
<a class="sister" id="link3">Tillie</a>;
and they lived at the bottom of a well.
<a href="unknown">Some name</a>
</p>
<p class="story">...</p>
</body>
</html>
""";
void main() {
// 1. parse a document
TypedSoup bs = TypedSoup(
html_doc,
); // use TypedSoup.fragment(html_doc_string) if you parse a part of html
// 2. navigate quickly to any element
print(
bs.body!.a!.toString(),
); // get String representation of this element, same as outerHtml, finds: "<a href="http://example.com/elsie" class="sister" id="link1">Elsie</a>"
bs.find(
'p',
class_: 'story',
); // finds first element with html tag "p" and which has "class" attribute with value "story"
bs.findAll(
'a',
attrs: {'class': true},
); // finds all elements with html tag "a" and which have defined "class" attribute with whatever value
bs.find('*', id: 'link1'); // find by id
bs.find(
'*',
regex: r'^b',
); // find any element which tag starts with "b", for example: body, b, ...
bs.find(
'p',
string: r'^Article #\d*',
); // find "p" element which text starts with "Article #[number]"
bs.find(
'a',
attrs: {'href': 'http://example.com/elsie'},
); // finds by "href" attribute
// 3. perform any other actions for the navigated element
TsElement bs4 = bs
.body!
.p!; // quickly with tags, finds and navigates to: "<p class="title"><b>The Dormouse's story</b></p>"
bs4.name; // get tag name, finds: "p"
bs4.string; // get text, finds: "The Dormouse's story";
bs4.innerHtml; // get html elements inside the element, finds: "<b>The Dormouse's story</b>"
bs4.className; // get class attribute value, finds: "title"
bs4['id']; // get class attribute value, finds: null
bs4['class'] =
'board'; // change class attribute value from 'title' to 'board'
TsElement bs4Alt = bs.find(
'p',
attrs: {'class': 'story'},
)!; // with query func you can specify attributes
bs4.replaceWith(bs4Alt); // replace with other element
bs4Alt
.children; // get all element's children elements, finds: list with four "a" elements
}