Improve README.md
This commit is contained in:
parent
6089dd3ff1
commit
e1cef9bb37
24
README.md
24
README.md
@ -2,5 +2,25 @@
|
|||||||
|
|
||||||
[![Go Reference](https://pkg.go.dev/badge/git.tebibyte.media/tomo/objects.svg)](https://pkg.go.dev/git.tebibyte.media/tomo/objects)
|
[![Go Reference](https://pkg.go.dev/badge/git.tebibyte.media/tomo/objects.svg)](https://pkg.go.dev/git.tebibyte.media/tomo/objects)
|
||||||
|
|
||||||
Objects contains a standard collection of re-usable objects. All objects in this
|
Objects contains a standard collection of re-usable objects. It should be viewed
|
||||||
module visually conform to whatever the theme is set to.
|
also as a reference for how to create custom objects in Tomo.
|
||||||
|
|
||||||
|
## Styling
|
||||||
|
All objects in this module have roles of the form:
|
||||||
|
|
||||||
|
```
|
||||||
|
objects.TypeName
|
||||||
|
```
|
||||||
|
|
||||||
|
Where `TypeName` is the exact Go type name of the object in question. Objects
|
||||||
|
may also have different tags to indicate variations, states, etc. If applicable,
|
||||||
|
they are listed and described in the doc comment for the object's type. More
|
||||||
|
complex objects may have sub-components that are not accessible from the API.
|
||||||
|
These are listed alongside the tags.
|
||||||
|
|
||||||
|
## Setting Attributes
|
||||||
|
It is generally not recommended to set attributes on these objects. However, if
|
||||||
|
you must, they can be set by obtaining the object's underlying box through the
|
||||||
|
`GetBox` method. Be aware that the exact type of box that is returned here is
|
||||||
|
not part of the API, and may change unexpectedly even after v1.0. This caveat
|
||||||
|
also applies to children created/managed by the objects.
|
||||||
|
Loading…
Reference in New Issue
Block a user