Inserting Flash

This website contains links to software which is either no longer maintained or will be supported only until the end of 2019 (CKFinder 2). For the latest documentation about current CKSource projects, including software like CKEditor 4/CKEditor 5, CKFinder 3, Cloud Services, Letters, Accessibility Checker, please visit the new documentation website.

If you look for an information about very old versions of CKEditor, FCKeditor and CKFinder check also the CKEditor forum, which was closed in 2015. If not, please head to StackOverflow for support.

(→‎Properties)
m
 
(24 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
Inserting Flash in CKEditor is very simple task. To add flash press the [[Image:CKEditor_flash.png‎]] button on the toolbar. A popup window called "FlashProperties" appears. It includes four bookmarks:<br>
+
{{#CUSTOMTITLE:Inserting Flash}}
 +
__TOC__
 +
CKEditor allows you to add [http://www.adobe.com/flashplatform/ Adobe Flash] files to your documents in an easy and intuitive way.
  
−
=== General ===
+
In order to insert a Flash object, press the [[Image:CKEditor_flash.png‎|Flash]] button on the toolbar. The '''Flash Properties''' dialog window that will open lets you set configuration options that define the Flash object source, its size, display properties, or other advanced properties.
  
−
[[Image:CKEditor_flash_properties.png]]
+
The '''Flash Properties''' dialog window includes four tabs that group Flash object options:
 +
* [[CKEditor_3.x/Users_Guide/Rich Text/Flash#General|General]]
 +
* [[CKEditor_3.x/Users_Guide/Rich Text/Flash#Upload|Upload]]
 +
* [[CKEditor_3.x/Users_Guide/Rich Text/Flash#Properties|Properties]]
 +
* [[CKEditor_3.x/Users_Guide/Rich Text/Flash#Advanced|Advanced]]
  
−
The first bookmark named "General" refers to:<br>
+
{{CKEditor Dialog Windows}}
  
−
* '''URL''': defines the URL address of the flash object. You may also use the "Browse Sever" in order to browse the files.
+
== General ==
−
* '''Width''': specifies flash object width.<br>
+
The '''General''' tab is the default tab that opens after you press the [[Image:CKEditor_flash.png‎|Flash]] button on the toolbar. It allows you to set the URL of the Flash object and configure the way it will appear in the document.
−
* '''Height''': specifies flash object height.
 
−
* '''HSpace''': defines the size of the horizontal gap.
 
−
* '''VSpace''': defines the size of the vertical gap.
 
−
* '''Preview''': in this window user may view how the window looks with the added flash object.  
 
  
 +
[[Image:CKEditor_flash_general.png|frame|center|General tab of the Flash Properties window]]
  
−
Pressing "'''OK'''" inserts the image with the specified properties.
 
  
−
=== Upload ===
+
Below is an overview of all '''General''' tab elements:
 +
* '''URL''' &ndash; the web address of the Flash object. The object may be located on the same server as the web site you are currently in or on an external server.
 +
** External server: If you want to use an external address, use the full absolute path.
 +
**: Example:
 +
**: <code><nowiki>http://example.com/flash1.swf</nowiki></code>
 +
** Local server: If the image is located on the same server, you can use a relative path that omits the domain name and starts with a slash.
 +
**: Example:
 +
**: <code><nowiki>/animation/flash2.swf</nowiki></code>
 +
**: If CKEditor is integrated with a file browser (like [http://ckfinder.com/ CKFinder]), you can also use the '''Browse Server''' button to select a Flash object from the ones that are available on the server.
  
−
The second bookmarks refers to "Upload" option:<br>
+
* '''Width''' &ndash;  the width of the Flash object in pixels.
 +
* '''Height''' &ndash; the height of the Flash object in pixels.
  
−
[[Image:CKEditor_flash_upload.png]]
+
* '''HSpace''' &ndash; the horizontal spacing (or margin) between the Flash object and other document elements that surround it, in pixels.
 +
* '''VSpace''' &ndash; the vertical spacing (or margin) between the Flash object and other document elements that surround it, in pixels.
  
−
* '''Upload''': specifies the location of the flash file on your local hard drive. User may also use "browse" instead of typing the location manually.
+
* '''Preview''' &ndash; a preliminary view of the selected Flash object formatted according to the options chosen above.
  
−
Pressing "'''Send it to the Server'''" sends the flash object to the server.
+
== Upload ==
 +
The '''Upload''' tab of the '''Flash Properties''' dialog window allows you to send your own Flash objects to the server. It is only visible if the server accepts files uploaded by the users and CKEditor is integrated with a file browser (like [http://ckfinder.com/ CKFinder]).
  
−
=== Properties ===
+
[[Image:CKEditor_flash_upload.png|frame|center|Upload tab of the Flash Properties window]]
  
−
The third bookmark is the "Properties" section:
 
  
−
[[Image:CKEditor_properties_flash.png]]
+
To upload a Flash file, click the file input field or the '''Browse''' button next to it. When the file browser of your operating system opens, navigate to an appropriate folder and choose a file by double clicking it or using the '''Open''' button. To send the file to the server, click the '''Send it to the Server''' button of CKEditor.
  
−
This bookmark allows user to set following option:
+
== Properties ==
 +
The '''Properties''' tab lets you configure various Flash options that control the behavior of the inserted object. They also provide access to Adobe Flash Player settings that enable the object to play automatically or loop.
  
−
* '''Scale''' specifies scale of the flash object. User may choose one from: Show all, No Border, Exact Fit.
+
[[Image:CKEditor_flash_properties.png|frame|center|Properties tab of the Flash Properties window]]
−
* '''Script Access''' specifies how to run external scripts. User may choose one of three  option: Always, Same domain, Never.
 
−
* '''Window mode''' specifies how to window looks like. User may choose one from: Window, Opaque, Transparent.
 
−
* '''Quality''': specifies the quality of the flash object. User may choose one of six option: Best, High, Auto High, Medium, Auto Low, Low.
 
−
* '''Align''': specifies the alignment of the flash object. User may choose from: Left, Abs Bottom, Abs Middle, Baseline, Bottom, Middle, Right, Text Top or Top.
 
  
−
And checkbox option:
 
−
* '''Enable Flash Menu'''
 
−
* '''Auto Play'''
 
−
* '''Loop'''
 
−
* '''Allow Fullscreen'''
 
  
 +
Below is an overview of all '''Properties''' tab elements:
 +
* '''Scale''' &ndash; the parameter that controls the scaling, stretching, or shrinking of the Flash object when the browser window is resized (<code>scale</code> attribute). You can choose between the following options:
 +
** '''Show all''' &ndash; the entire object is visible with original aspect ratio retained. Borders may be present.
 +
** '''No Border''' &ndash; the object is scaled to fit within the specified area without any borders, with original aspect ratio retained (the sides of the object may be cropped).
 +
** '''Exact Fit''' &ndash; the entire object is visible within the specified area, but the original aspect ratio might not be retained thus making the object distorted.
 +
* '''Script Access''' &ndash; the parameter that controls the ability of the Flash object to communicate with the page it is embedded in (<code>allowScriptAccess</code> attribute). You can choose between the following options:
 +
** '''Always''' &ndash; the Flash object can communicate with the HTML page it is embedded in even if they are from different domains.
 +
** '''Same domain''' &ndash; the Flash object can communicate with the HTML page it is embedded in only if they are from the same domain.
 +
** '''Never''' &ndash; the Flash object cannot communicate with the HTML page it is embedded in.
 +
* '''Window mode''' &ndash; the parameter that controls the layering of the Flash object in the browser window (<code>wmode</code> attribute). You can choose between the following options:
 +
** '''Window''' &ndash; the Flash object is shown in its own window on a document.
 +
** '''Opaque''' &ndash; the Flash object hides everything underneath.
 +
** '''Transparent''' &ndash; the document background shows through all transparent parts of the Flash object.
 +
* '''Quality''' &ndash; the parameter that controls the relation between the speed of the object and its appearance (<code>quality</code> attribute). You can choose between the following options:
 +
** '''Best''' &ndash; best appearance, speed is disregarded.
 +
** '''High''' &ndash; appearance is favored over speed.
 +
** '''Auto Hig'''h &ndash; speed and appearance are equally emphasized.
 +
** '''Medium''' &ndash; speed is favored over quality, but some anti-aliasing is applied.
 +
** '''Auto Low''' &ndash; speed is favored over quality, but quality is improved whenever possible.
 +
** '''Low''' &ndash; speed is favored over quality and anti-aliasing is never applied.
 +
* '''Align''' &ndash; the parameter that controls the alignment of the Flash object in the document (<code>align</code> attribute). You can choose between the following options: '''Left''', '''Abs Bottom''', '''Abs Middle''', '''Baseline''', '''Bottom''', '''Middle''', '''Right''', '''Text Top''', or '''Top'''.
  
−
Press "'''OK'''" to save the changes.
 
  
−
=== Advanced ===
+
The '''Properties''' tab lets you configure four additional options pertaining to the Flash Player:
 +
* '''Enable Flash Menu''' &ndash; the parameter that controls whether the Flash context menu is enabled.
 +
* '''Auto Play''' &ndash; the parameter that controls whether the Flash object will start playing automatically right after you open the document.
 +
* '''Loop''' &ndash; the parameter that controls whether the Flash object will play continuously in a loop.
 +
* '''Allow Fullscreen''' &ndash; the parameter that controls whether the Flash object may be played in the full screen mode.
  
−
This bookmark allow user to set advanced properties:
+
== Advanced ==
 +
The '''Advanced''' tab lets you configure additional Flash object options such as assign it an ID, a class, a tooltip, or CSS style properties. It is meant for advanced users with knowledge of HTML as well as CSS, and gives nearly endless possibilities as far as the presentation of the Flash object is concerned.
  
−
[[Image:CKEditor_flash_advanced.png]]
+
[[Image:CKEditor_flash_advanced.png|frame|center|Advanced tab of the Flash Properties window]]
  
−
* '''Id''': specifies the ID of the flash object.
+
 
−
* '''Advisory Title''': specifies the description of the target object.
+
Below is the overview of all '''Advanced''' tab elements:
−
* '''Background color''': sets background's color.
+
 
−
* '''Stylesheet Classes''': specifies the name of the CSS class.
+
* '''Id''' &ndash; a unique identifier for a Flash object element in the document (<code>id</code> attribute).
−
* '''Style''': specifies the style.
+
* '''Advisory Title''' &ndash; the text of the tooltip that is shown when the mouse cursor hovers over the Flash object (<code>title</code> attribute).
 +
* '''Background color''' &ndash; the color that is visible beneath the transparent portions of the Flash object.
 +
* '''Stylesheet Classes''' &ndash; the class of the Flash object element (<code>class</code> attribute). Note that a Flash object element might be assigned more than one class. If this is a case, separate class names with spaces.
 +
* '''Style''' &ndash; CSS style definitions (<code>style</code> attribute). Note that each value must end with a semi-colon and individual properties should be separated with spaces.
 +
 
 +
== Flash Object Preview ==
 +
Please note that on inserting into the document, the Flash object will be displayed in the CKEditor editing area as a fake element.
 +
 
 +
[[Image:CKEditor_flash_example.png|frame|center|Flash object as seen in the editor window]]
 +
 
 +
 
 +
If you want to see check its final appearance, press the [[Image:CKEditor_preview.png|Preview]] toolbar button to use the [[CKEditor_3.x/Users_Guide/Document/Preview|Preview]] feature of CKEditor. The figure below shows the same Flash object in the preview mode.
 +
 
 +
[[Image:CKEditor_flash_preview.png|frame|center|Flash object as seen in the preview window]]

Latest revision as of 12:45, 8 August 2012

CKEditor allows you to add Adobe Flash files to your documents in an easy and intuitive way.

In order to insert a Flash object, press the Flash button on the toolbar. The Flash Properties dialog window that will open lets you set configuration options that define the Flash object source, its size, display properties, or other advanced properties.

The Flash Properties dialog window includes four tabs that group Flash object options:

For general information on using dialog windows please refer to the Dialog Windows section of the User's Guide.

General

The General tab is the default tab that opens after you press the Flash button on the toolbar. It allows you to set the URL of the Flash object and configure the way it will appear in the document.

General tab of the Flash Properties window


Below is an overview of all General tab elements:

  • URL – the web address of the Flash object. The object may be located on the same server as the web site you are currently in or on an external server.
    • External server: If you want to use an external address, use the full absolute path.
      Example:
      http://example.com/flash1.swf
    • Local server: If the image is located on the same server, you can use a relative path that omits the domain name and starts with a slash.
      Example:
      /animation/flash2.swf
      If CKEditor is integrated with a file browser (like CKFinder), you can also use the Browse Server button to select a Flash object from the ones that are available on the server.
  • Width – the width of the Flash object in pixels.
  • Height – the height of the Flash object in pixels.
  • HSpace – the horizontal spacing (or margin) between the Flash object and other document elements that surround it, in pixels.
  • VSpace – the vertical spacing (or margin) between the Flash object and other document elements that surround it, in pixels.
  • Preview – a preliminary view of the selected Flash object formatted according to the options chosen above.

Upload

The Upload tab of the Flash Properties dialog window allows you to send your own Flash objects to the server. It is only visible if the server accepts files uploaded by the users and CKEditor is integrated with a file browser (like CKFinder).

Upload tab of the Flash Properties window


To upload a Flash file, click the file input field or the Browse button next to it. When the file browser of your operating system opens, navigate to an appropriate folder and choose a file by double clicking it or using the Open button. To send the file to the server, click the Send it to the Server button of CKEditor.

Properties

The Properties tab lets you configure various Flash options that control the behavior of the inserted object. They also provide access to Adobe Flash Player settings that enable the object to play automatically or loop.

Properties tab of the Flash Properties window


Below is an overview of all Properties tab elements:

  • Scale – the parameter that controls the scaling, stretching, or shrinking of the Flash object when the browser window is resized (scale attribute). You can choose between the following options:
    • Show all – the entire object is visible with original aspect ratio retained. Borders may be present.
    • No Border – the object is scaled to fit within the specified area without any borders, with original aspect ratio retained (the sides of the object may be cropped).
    • Exact Fit – the entire object is visible within the specified area, but the original aspect ratio might not be retained thus making the object distorted.
  • Script Access – the parameter that controls the ability of the Flash object to communicate with the page it is embedded in (allowScriptAccess attribute). You can choose between the following options:
    • Always – the Flash object can communicate with the HTML page it is embedded in even if they are from different domains.
    • Same domain – the Flash object can communicate with the HTML page it is embedded in only if they are from the same domain.
    • Never – the Flash object cannot communicate with the HTML page it is embedded in.
  • Window mode – the parameter that controls the layering of the Flash object in the browser window (wmode attribute). You can choose between the following options:
    • Window – the Flash object is shown in its own window on a document.
    • Opaque – the Flash object hides everything underneath.
    • Transparent – the document background shows through all transparent parts of the Flash object.
  • Quality – the parameter that controls the relation between the speed of the object and its appearance (quality attribute). You can choose between the following options:
    • Best – best appearance, speed is disregarded.
    • High – appearance is favored over speed.
    • Auto High – speed and appearance are equally emphasized.
    • Medium – speed is favored over quality, but some anti-aliasing is applied.
    • Auto Low – speed is favored over quality, but quality is improved whenever possible.
    • Low – speed is favored over quality and anti-aliasing is never applied.
  • Align – the parameter that controls the alignment of the Flash object in the document (align attribute). You can choose between the following options: Left, Abs Bottom, Abs Middle, Baseline, Bottom, Middle, Right, Text Top, or Top.


The Properties tab lets you configure four additional options pertaining to the Flash Player:

  • Enable Flash Menu – the parameter that controls whether the Flash context menu is enabled.
  • Auto Play – the parameter that controls whether the Flash object will start playing automatically right after you open the document.
  • Loop – the parameter that controls whether the Flash object will play continuously in a loop.
  • Allow Fullscreen – the parameter that controls whether the Flash object may be played in the full screen mode.

Advanced

The Advanced tab lets you configure additional Flash object options such as assign it an ID, a class, a tooltip, or CSS style properties. It is meant for advanced users with knowledge of HTML as well as CSS, and gives nearly endless possibilities as far as the presentation of the Flash object is concerned.

Advanced tab of the Flash Properties window


Below is the overview of all Advanced tab elements:

  • Id – a unique identifier for a Flash object element in the document (id attribute).
  • Advisory Title – the text of the tooltip that is shown when the mouse cursor hovers over the Flash object (title attribute).
  • Background color – the color that is visible beneath the transparent portions of the Flash object.
  • Stylesheet Classes – the class of the Flash object element (class attribute). Note that a Flash object element might be assigned more than one class. If this is a case, separate class names with spaces.
  • Style – CSS style definitions (style attribute). Note that each value must end with a semi-colon and individual properties should be separated with spaces.

Flash Object Preview

Please note that on inserting into the document, the Flash object will be displayed in the CKEditor editing area as a fake element.

Flash object as seen in the editor window


If you want to see check its final appearance, press the Preview toolbar button to use the Preview feature of CKEditor. The figure below shows the same Flash object in the preview mode.

Flash object as seen in the preview window
Retrieved from "https://docs-old.ckeditor.com/index.php?title=CKEditor_3.x/Users_Guide/Rich_Text/Flash&oldid=7198"
This page was last edited on 8 August 2012, at 12:45.