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)
|
||||
|
||||
Objects contains a standard collection of re-usable objects. All objects in this
|
||||
module visually conform to whatever the theme is set to.
|
||||
Objects contains a standard collection of re-usable objects. It should be viewed
|
||||
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