README
¶
CSS selectors in Go
This package implements a CSS selector compiler for Go's HTML parsing package golang.org/x/net/html.
package main
import (
"fmt"
"os"
"strings"
"github.com/ericchiang/css"
"golang.org/x/net/html"
)
var data = `
<p>
<h2 id="foo">a header</h2>
<h2 id="bar">another header</h2>
</p>`
func main() {
sel, err := css.Parse("h2#foo")
if err != nil {
panic(err)
}
node, err := html.Parse(strings.NewReader(data))
if err != nil {
panic(err)
}
for _, ele := range sel.Select(node) {
html.Render(os.Stdout, ele)
}
fmt.Println()
}
$ go run example/css.go
<h2 id="foo">a header</h2>
Documentation
¶
Overview ¶
Package css implements CSS selector HTML search.
Selectors compiled by this package search through golang.org/x/net/html nodes and should be used in conjunction with that package.
data := `<p>
<h2 id="foo">a header</h2>
<h2 id="bar">another header</h2>
</p>`
sel, err := css.Parse("h2#foo")
if err != nil {
// handle error
}
node, err := html.Parse(strings.NewReader(data))
if err != nil {
// handle error
}
elements := sel.Select(node)
This package aims to support Selectors Level 4 https://www.w3.org/TR/selectors-4/.
The following selectors are supported:
- // Universal selector a // Type selector ns|a // Type selector with namespace .red // Class selector #demo // ID selector [attr] // Attribute selector [attr=value] // Attribute selector value [attr~=value] // Attribute selector element of list [attr|=value] // Attribute selector value or "{value}-" prefix [attr^=value] // Attribute selector prefix [attr$=value] // Attribute selector suffix [attr*=value] // Attribute selector contains value [attr=value i] // Attribute selector case insensitive modifier foo, bar // Selector list foo bar // Descendant combinator foo > bar // Child combinator foo ~ bar // General sibling combinator foo + bar // Adjacent sibling combinator :empty // Element with no children :first-child // First child of parent :first-of-type // First child of its type of parent :last-child // Last child of parent :last-of-type // Last child of its type of parent :only-child // Only child of parent :only-of-type // Only child of its type parent :root // Root element :nth-child(An+B) // Positional child matcher :nth-last-child(An+B) // Reverse positional child matcher :nth-last-of-type(An+B) // Reverse positional child matcher of type :nth-of-type(An+B) // Positional child matcher of type
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type ParseError ¶
ParseError is returned indicating an lex, parse, or compilation error with the associated position in the string the error occurred.
func (*ParseError) Error ¶
func (p *ParseError) Error() string
Error returns a formatted version of the error.
type Selector ¶
type Selector struct {
// contains filtered or unexported fields
}
Selector is a compiled CSS selector.
Source Files
Click to show internal directories.
Click to hide internal directories.