Special XML conversion code for Firefox >= 20.0
[infodrom/rico3] / documentation / GridStyles.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">\r
2 <html>\r
3 <head>\r
4 <title>Rico Grid Styles</title>\r
5 <link href="ricoDocs.css" rel="Stylesheet" type="text/css">
6 </head>\r
7 \r
8 <body>\r
9 <h1>Grid Styles</h1>\r
10 \r
11 <p>It is very easy to customize the style of Rico LiveGrids and SimpleGrids.\r
12 In fact, LiveGrids and SimpleGrids share many of the same class names\r
13 and DOM structures, so styles that apply to one can be applied to the other.\r
14 \r
15 <h2>Pre-configured Styles</h2>\r
16 \r
17 <p>Rico comes with a variety of stylesheets for LiveGrid.\r
18 You can see how each of them looks by selecting the\r
19 first LiveGrid example in the PHP, ASP, .net, or Perl section.\r
20 At the top of the example page, try each of the "style" selections\r
21 to find one you like. The actual stylesheets are located\r
22 in the src/css directory.\r
23 \r
24 <p>Here are screen shots of each style, taken with "highlight" set to "Cursor Row".\r
25 \r
26 <p><strong>greenHdg.css</strong>\r
27 <br><img src='images/gridsamples/greenHdg.png'>\r
28 \r
29 <p><strong>seaglass.css</strong>\r
30 <br><img src='images/gridsamples/seaglass.png'>\r
31 \r
32 <p><strong>grayedout.css</strong>\r
33 <br><img src='images/gridsamples/grayedout.png'>\r
34 \r
35 <p><strong>coffee-with-milk.css</strong>\r
36 <br><img src='images/gridsamples/coffee-with-milk.png'>\r
37 \r
38 <p><strong>warmfall.css</strong>\r
39 <br><img src='images/gridsamples/warmfall.png'>\r
40 \r
41 <p>Several of these styles are adapted from the\r
42 <a href="http://icant.co.uk/csstablegallery/index.php">CSS Table Gallery</a>.\r
43 The gallery can serve as an inspiration for styling LiveGrids, however,\r
44 the CSS used in the gallery examples cannot be applied directly to a LiveGrid.\r
45 \r
46 <h2>Customizing a Style</h2>\r
47 \r
48 <p>Even with the variety of pre-configured styles available,\r
49 inevitably some style declarations will need to be overridden\r
50 to display your data the way you want it. What follows are some\r
51 common situations that require a style to be overridden and \r
52 the suggested CSS styling to solve the issue.\r
53 \r
54 <h3>Row height of column headings</h3>\r
55 \r
56 <p>When column headings get too long, you typically want to allow\r
57 the words to wrap and to display the heading as 2 or 3 lines of text.\r
58 \r
59 <p>Shows headings with 2 lines of text:\r
60 <pre>\r
61 .ricoLG_top div.ricoLG_cell {\r
62   height:2.5em;\r
63 }\r
64 </pre>\r
65 \r
66 <p>Shows headings with 3 lines of text:\r
67 <pre>\r
68 .ricoLG_top div.ricoLG_cell {\r
69   height:3.5em;\r
70 }\r
71 </pre>\r
72 \r
73 <h3>Row height in grid body</h3>\r
74 \r
75 <p>Similarly you might need each row in the grid body\r
76 to be taller in order to display long content.\r
77 \r
78 <p>Show body rows with 2 lines of text:\r
79 <pre>\r
80 .ricoLG_bottom div.ricoLG_cell {\r
81   height:2.5em;\r
82 }\r
83 </pre>\r
84 \r
85 <h3>Word Wrap</h3>\r
86 \r
87 <p>By default, word-wrapping is enabled in each grid cell.\r
88 But sometimes it makes sense to turn word wrapping off.\r
89 \r
90 <p>Turn word-wrap off in headings and body:\r
91 <pre>\r
92 div.ricoLG_cell {\r
93   white-space:nowrap;\r
94 }\r
95 </pre>\r
96 \r
97 <p>Turn word-wrap off in body only:\r
98 <pre>\r
99 .ricoLG_bottom div.ricoLG_cell {\r
100   white-space:nowrap;\r
101 }\r
102 </pre>\r
103 \r
104 <h3>Referencing an entire grid</h3>\r
105 \r
106 <p>Sometimes you want to apply a style to an entire grid.\r
107 Each grid is enclosed in a &lt;div&gt; with a class of\r
108 "ricoLG_outerDiv" and an id equal to the id you passed\r
109 to the LiveGrid constructor appended with "_outerDiv"\r
110 (i.e. the id of the grid in the first example is "ex1_outerDiv").\r
111 Thus, you can use ".ricoLG_outerDiv" as a selector when applying\r
112 a style to all grids on a page, or "#ex1_outerDiv" when applying\r
113 a style to only the ex1 grid.\r
114 \r
115 <p>Set the grid's background color:\r
116 <pre>\r
117 div.ricoLG_outerDiv {\r
118   background-color:aqua;\r
119 }\r
120 </pre>\r
121 \r
122 </body>\r
123 </html>\r