What are some of the basic things I should consider when building a Klip?
Consider the following when building a Klip:
By default, if a column is too narrow, a Klip will wrap the data in the column on to up to three lines. If you want certain pieces of data to not wrap, be sure to add wrap: false to the style definition for that item. To make the default setting in the Klip to display items on a single line, add <wrap>false</wrap> to the Klip's <setup> block.
When the user sizes the Klip to be narrow, Klipfolio Dashboard by default displays the left-hand-most columns and hides the other columns. To control which columns are given priority in a narrow Klip, add the priority CSS property to your style definitions. For instance, the column that is priority: 1 will be the last column removed from a narrow Klip, the column that is priority: 2 will be the second-last to be removed, and so on.
If your Klip uses columns, Klipfolio Dashboard will by default only make the column as wide as the widest piece of data in the column, which can result in the column header being truncated. To display the full column headers in your Klip, add truncate="false" to the <columns> tag in your <setup> block.
By default, each item in your Klip is uniquely identified by the data in every style in your stylesheet. If the Klip's items should be identified by only one piece of data, use key: override in the style definition for that item. If the Klip's items contain one or more styles with frequently changing data, use key: exclude for those styles. Properly defined keys helps to prevent duplicate items in your Klip.
For more details and examples, see the how-to article on keys.
Before releasing your Klip, be sure that the identifying information in the Klip file is correct and complete. In particular, check the information in the <owner> block at the top of the Klip, and check the title, description and version number in the <identity> block. Also, be sure your Klip has a klip location specified in the <locations> block -- if the Klip has no klip location, you will not be able to provide upgrades to your users.
