blob: df4f64308e6a19979f642e5732a97628a37d3f5f (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
# Swatches
To make it easier to experiment with the client's component framework, the client exposes "swatches" - pages demonstrating individual components in isolation.
Swatches are available from a running client at the `/.swatch/` URL. This URL is not linked in the client; you Just Need To Know.
## Writing Swatches
Swatches are manually curated. When adding a component, add a swatch if you can.
Things to consider:
- For complex values, use a parser, so that the user reading your swatch can edit the structure as text.
- For freeform values whose meaning is significant, provide buttons to let the user rapidly enter and experiment with interesting values.
- Be thorough. Let the user experiment with values, even if you think those values may be nonsensical.
- Try to show the component _without_ supporting markup, as far as is possible. However, if a component generates markup that requires context - a table row component needs a table, for example, or a list element needs a list - then include that markup in the swatch.
|
