Add cite attribute (#192)

It can appear in a `<blockquote>`.

- Closes #189

Signed-off-by: Yarden Shoham <[email protected]>

README.md

@@ -145,10 +145,11 @@ For more complete examples, see [the examples directory](examples/).
 
 ### What's up with the specially named elements and attributes?
 
-Unfortunately, there are five main name clashes in HTML elements and attributes, so they need an `El` or `Attr` suffix,
+Unfortunately, there are six main name clashes in HTML elements and attributes, so they need an `El` or `Attr` suffix,
 to be able to co-exist in the same package in Go. I've chosen one or the other based on what I think is the common usage.
 In either case, the less-used variant also exists in the codebase:
 
+- `cite` (`CiteEl`/`Cite`, `CiteAttr` also exists)
 - `data` (`DataEl`/`Data`, `DataAttr` also exists)
 - `form` (`Form`/`FormAttr`, `FormEl` also exists)
 - `label` (`Label`/`LabelAttr`, `LabelEl` also exists)

html/attributes.go

@@ -101,6 +101,10 @@ func Charset(v string) g.Node {
  return g.Attr("charset", v)
 }
 
+func CiteAttr(v string) g.Node {
+ return g.Attr("cite", v)
+}
+
 func Class(v string) g.Node {
  return g.Attr("class", v)
 }

html/attributes_test.go

@@ -49,6 +49,7 @@ func TestSimpleAttributes(t *testing.T) {
  {Name: "as", Func: As},
  {Name: "autocomplete", Func: AutoComplete},
  {Name: "charset", Func: Charset},
+ {Name: "cite", Func: CiteAttr},
  {Name: "class", Func: Class},
  {Name: "cols", Func: Cols},
  {Name: "colspan", Func: ColSpan},

html/elements.go

@@ -73,6 +73,11 @@ func Cite(children ...g.Node) g.Node {
  return g.El("cite", children...)
 }
 
+// Deprecated: Use [Cite] instead.
+func CiteEl(children ...g.Node) g.Node {
+ return Cite(children...)
+}
+
 func Code(children ...g.Node) g.Node {
  return g.El("code", children...)
 }

html/elements_test.go

@@ -45,6 +45,7 @@ func TestSimpleElements(t *testing.T) {
  {Name: "canvas", Func: Canvas},
  {Name: "caption", Func: Caption},
  {Name: "cite", Func: Cite},
+ {Name: "cite", Func: CiteEl},
  {Name: "code", Func: Code},
  {Name: "colgroup", Func: ColGroup},
  {Name: "data", Func: DataEl},