/
fields.go
93 lines (78 loc) · 2.75 KB
/
fields.go
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
// Copyright 2017 The Mellium Contributors.
// Use of this source code is governed by the BSD 2-clause
// license that can be found in the LICENSE file.
package form
import (
"encoding/xml"
)
// A field represents a data field that may be added to a form.
type field struct {
XMLName xml.Name `xml:"field"`
Typ string `xml:"type,attr"`
Var string `xml:"var,attr,omitempty"`
Label string `xml:"label,attr,omitempty"`
Desc string `xml:"desc,omitempty"`
Value []string `xml:"value,omitempty"`
Required *struct{} `xml:"required,omitempty"`
Field []fieldopt `xml:"option,omitempty"`
}
type fieldopt struct {
XMLName xml.Name `xml:"jabber:x:data option"`
Value string `xml:"value,omitempty"`
}
func newField(typ, id string, o ...Option) func(data *Data) {
return func(data *Data) {
f := field{
Typ: typ,
Var: id,
}
getFieldOpts(&f, o...)
data.children = append(data.children, f)
}
}
// Boolean fields enable an entity to gather or provide an either-or choice
// between two options.
func Boolean(id string, o ...Option) Field {
return newField("boolean", "", o...)
}
// Fixed is intended for data description (e.g., human-readable text such as
// "section" headers) rather than data gathering or provision.
func Fixed(o ...Option) Field {
return newField("fixed", "", o...)
}
// Hidden fields are not shown by the form-submitting entity, but instead are
// returned, generally unmodified, with the form.
func Hidden(id string, o ...Option) Field {
return newField("hidden", id, o...)
}
// JIDMulti enables an entity to gather or provide multiple Jabber IDs.
func JIDMulti(id string, o ...Option) Field {
return newField("jid-multi", id, o...)
}
// JID enables an entity to gather or provide a Jabber ID.
func JID(id string, o ...Option) Field {
return newField("jid-single", id, o...)
}
// ListMulti enables an entity to gather or provide one or more entries from a
// list.
func ListMulti(id string, o ...Option) Field {
return newField("list-multi", id, o...)
}
// ListSingle enables an entity to gather or provide a single entry from a list.
func ListSingle(id string, o ...Option) Field {
return newField("list-single", id, o...)
}
// TextMulti enables an entity to gather or provide multiple lines of text.
func TextMulti(id string, o ...Option) Field {
return newField("text-multi", id, o...)
}
// TextPrivate enables an entity to gather or provide a line of text that should
// be obscured in the submitting entities interface (eg. with multiple
// asterisks).
func TextPrivate(id string, o ...Option) Field {
return newField("text-private", id, o...)
}
// TextSingle enables an entity to gather or provide a line of text.
func TextSingle(id string, o ...Option) Field {
return newField("text-single", id, o...)
}