3 Copyright (c) 2003-2016, CKSource - Frederico Knabben. All rights reserved.
4 For licensing, see LICENSE.md or http://ckeditor.com/license
9 <title>AutoGrow Plugin — CKEditor Sample</title>
10 <script src="../../../ckeditor.js"></script>
11 <link rel="stylesheet" href="../../../samples/old/sample.css">
12 <meta name="ckeditor-sample-name" content="AutoGrow plugin">
13 <meta name="ckeditor-sample-group" content="Plugins">
14 <meta name="ckeditor-sample-description" content="Using the AutoGrow plugin in order to make the editor grow to fit the size of its content.">
18 <a href="../../../samples/old/index.html">CKEditor Samples</a> » Using AutoGrow Plugin
20 <div class="warning deprecated">
21 This sample is not maintained anymore. Check out its <a href="http://sdk.ckeditor.com/samples/autogrow.html">brand new version in CKEditor SDK</a>.
23 <div class="description">
25 This sample shows how to configure CKEditor instances to use the
26 <strong>AutoGrow</strong> (<code>autogrow</code>) plugin that lets the editor window expand
27 and shrink depending on the amount and size of content entered in the editing area.
30 In its default implementation the <strong>AutoGrow feature</strong> can expand the
31 CKEditor window infinitely in order to avoid introducing scrollbars to the editing area.
34 It is also possible to set a maximum height for the editor window. Once CKEditor
35 editing area reaches the value in pixels specified in the
36 <code><a class="samples" href="http://docs.ckeditor.com/#!/api/CKEDITOR.config-cfg-autoGrow_maxHeight">autoGrow_maxHeight</a></code>
37 configuration setting, scrollbars will be added and the editor window will no longer expand.
40 To add a CKEditor instance using the <code>autogrow</code> plugin and its
41 <code>autoGrow_maxHeight</code> attribute, insert the following JavaScript call to your code:
44 CKEDITOR.replace( '<em>textarea_id</em>', {
45 <strong>extraPlugins: 'autogrow',</strong>
46 autoGrow_maxHeight: 800,
48 // Remove the Resize plugin as it does not make sense to use it in conjunction with the AutoGrow plugin.
49 removePlugins: 'resize'
52 Note that <code><em>textarea_id</em></code> in the code above is the <code>id</code> attribute of
53 the <code><textarea></code> element to be replaced with CKEditor. The maximum height should
57 <form action="../../../samples/sample_posteddata.php" method="post">
60 CKEditor using the <code>autogrow</code> plugin with its default configuration:
62 <textarea cols="80" id="editor1" name="editor1" rows="10"><p>This is some <strong>sample text</strong>. You are using <a href="http://ckeditor.com/">CKEditor</a>.</p></textarea>
65 CKEDITOR.replace( 'editor1', {
66 extraPlugins: 'autogrow',
67 removePlugins: 'resize'
74 CKEditor using the <code>autogrow</code> plugin with maximum height set to 400 pixels:
76 <textarea cols="80" id="editor2" name="editor2" rows="10"><p>This is some <strong>sample text</strong>. You are using <a href="http://ckeditor.com/">CKEditor</a>.</p></textarea>
79 CKEDITOR.replace( 'editor2', {
80 extraPlugins: 'autogrow',
81 autoGrow_maxHeight: 400,
82 removePlugins: 'resize'
88 <input type="submit" value="Submit">
94 CKEditor - The text editor for the Internet - <a class="samples" href="http://ckeditor.com/">http://ckeditor.com</a>
97 Copyright © 2003-2016, <a class="samples" href="http://cksource.com/">CKSource</a> - Frederico
98 Knabben. All rights reserved.