JasonWoof Got questions, comments, patches, etc.? Contact Jason Woofenden
vanilla ckeditor-3.6.1
[ckeditor.git] / _samples / autogrow.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">\r
2 <!--\r
3 Copyright (c) 2003-2011, CKSource - Frederico Knabben. All rights reserved.\r
4 For licensing, see LICENSE.html or http://ckeditor.com/license\r
5 -->\r
6 <html xmlns="http://www.w3.org/1999/xhtml">\r
7 <head>\r
8         <title>AutoGrow Plugin &mdash; CKEditor Sample</title>\r
9         <meta content="text/html; charset=utf-8" http-equiv="content-type" />\r
10         <script type="text/javascript" src="../ckeditor.js"></script>\r
11         <script src="sample.js" type="text/javascript"></script>\r
12         <link href="sample.css" rel="stylesheet" type="text/css" />\r
13 </head>\r
14 <body>\r
15         <h1 class="samples">\r
16                 CKEditor Sample &mdash; Using AutoGrow Plugin\r
17         </h1>\r
18         <div class="description">\r
19         <p>\r
20                 This sample shows how to configure CKEditor instances to use the\r
21                 <strong>autogrow</strong> plugin that lets the editor window expand and shrink\r
22                 depending on the amount and size of content entered in the editing area.\r
23         </p>\r
24         <p>\r
25                 In its default implementation the <strong>AutoGrow feature</strong> can expand the\r
26                 CKEditor window infinitely in order to avoid introducing scrollbars to the editing area.\r
27         </p>\r
28         <p>\r
29                 It is also possible to set a maximum height for the editor window. Once CKEditor\r
30                 editing area reaches the value in pixels specified in the <code>autoGrow_maxHeight</code>\r
31                 attribute, scrollbars will be added and the editor window will no longer expand.\r
32         </p>\r
33         <p>\r
34                 To add a CKEditor instance using the <strong>autogrow</strong> plugin and its\r
35                 <code>autoGrow_maxHeight</code> attribute, insert the following JavaScript call to your code:\r
36         </p>\r
37         <pre class="samples">CKEDITOR.replace( '<em>textarea_id</em>',\r
38         {\r
39                 <strong>extraPlugins : 'autogrow',</strong>\r
40                 autoGrow_maxHeight : 800,\r
41                 // Remove the resize plugin, as it doesn't make sense to use it in conjunction with the AutoGrow plugin.\r
42                 removePlugins : 'resize'\r
43         });</pre>\r
44         <p>\r
45                 Note that <code><em>textarea_id</em></code> in the code above is the <code>id</code> attribute of\r
46                 the <code>&lt;textarea&gt;</code> element to be replaced with CKEditor. The maximum height should\r
47                 be given in pixels.\r
48         </p>\r
49         </div>\r
50         <!-- This <div> holds alert messages to be display in the sample page. -->\r
51         <div id="alerts">\r
52                 <noscript>\r
53                         <p>\r
54                                 <strong>CKEditor requires JavaScript to run</strong>. In a browser with no JavaScript\r
55                                 support, like yours, you should still see the contents (HTML data) and you should\r
56                                 be able to edit it normally, without a rich editor interface.\r
57                         </p>\r
58                 </noscript>\r
59         </div>\r
60         <form action="sample_posteddata.php" method="post">\r
61                 <p>\r
62                         <label for="editor1">\r
63                                 CKEditor using the <strong>autogrow</strong> plugin with its default configuration:</label>\r
64                         <textarea cols="80" id="editor1" name="editor1" rows="10">&lt;p&gt;This is some &lt;strong&gt;sample text&lt;/strong&gt;. You are using &lt;a href="http://ckeditor.com/"&gt;CKEditor&lt;/a&gt;.&lt;/p&gt;</textarea>\r
65                         <script type="text/javascript">\r
66                         //<![CDATA[\r
67 \r
68                                 CKEDITOR.replace( 'editor1', {\r
69                                         extraPlugins : 'autogrow',\r
70                                         removePlugins : 'resize'\r
71                                 });\r
72 \r
73                         //]]>\r
74                         </script>\r
75                 </p>\r
76                 <p>\r
77                         <label for="editor2">\r
78                                 CKEditor using the <strong>autogrow</strong> plugin with maximum height set to 400:</label>\r
79                         <textarea cols="80" id="editor2" name="editor2" rows="10">&lt;p&gt;This is some &lt;strong&gt;sample text&lt;/strong&gt;. You are using &lt;a href="http://ckeditor.com/"&gt;CKEditor&lt;/a&gt;.&lt;/p&gt;</textarea>\r
80                         <script type="text/javascript">\r
81                         //<![CDATA[\r
82 \r
83                                 CKEDITOR.replace( 'editor2', {\r
84                                         extraPlugins : 'autogrow',\r
85                                         autoGrow_maxHeight : 400,\r
86                                         removePlugins : 'resize'\r
87                                 });\r
88 \r
89                         //]]>\r
90                         </script>\r
91                 </p>\r
92                 <p>\r
93                         <input type="submit" value="Submit" />\r
94                 </p>\r
95         </form>\r
96         <div id="footer">\r
97                 <hr />\r
98                 <p>\r
99                         CKEditor - The text editor for the Internet - <a class="samples" href="http://ckeditor.com/">http://ckeditor.com</a>\r
100                 </p>\r
101                 <p id="copy">\r
102                         Copyright &copy; 2003-2011, <a class="samples" href="http://cksource.com/">CKSource</a> - Frederico\r
103                         Knabben. All rights reserved.\r
104                 </p>\r
105         </div>\r
106 </body>\r
107 </html>\r