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.

m
 
(4 intermediate revisions by one other user not shown)
Line 1: Line 1:
 +
{{#CUSTOMTITLE:Inserting Flash}}
 
__TOC__
 
__TOC__
 
 
CKEditor allows you to add [http://www.adobe.com/flashplatform/ Adobe Flash] files to your documents in an easy and intuitive way.
 
CKEditor allows you to add [http://www.adobe.com/flashplatform/ Adobe Flash] files to your documents in an easy and intuitive way.
  
To insert a Flash object simply 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's source, its size, display properties, or other advanced properties.
+
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.
  
 
The '''Flash Properties''' dialog window includes four tabs that group Flash object options:
 
The '''Flash Properties''' dialog window includes four tabs that group Flash object options:
* [[CKEditor_3.x/Users_Guide/Common_Tasks/Inserting_Flash#General|General]]
+
* [[CKEditor_3.x/Users_Guide/Rich Text/Flash#General|General]]
* [[CKEditor_3.x/Users_Guide/Common_Tasks/Inserting_Flash#Upload|Upload]]
+
* [[CKEditor_3.x/Users_Guide/Rich Text/Flash#Upload|Upload]]
* [[CKEditor_3.x/Users_Guide/Common_Tasks/Inserting_Flash#Properties|Properties]]
+
* [[CKEditor_3.x/Users_Guide/Rich Text/Flash#Properties|Properties]]
* [[CKEditor_3.x/Users_Guide/Common_Tasks/Inserting_Flash#Advanced|Advanced]]
+
* [[CKEditor_3.x/Users_Guide/Rich Text/Flash#Advanced|Advanced]]
 
 
All tabs contain the [[Image:CKEditor_ok_button.png‎|OK]] and [[Image:CKEditor_cancel_button.png‎|Cancel]] buttons that let you accept the changes or close the dialog window without performing any changes, respectively.
 
 
 
Once inserted into the document, the Flash object can be edited at any time by double-clicking it. The '''Flash Properties''' dialog window will open again and you will be able to introduce changes to the Flash object configuration options.
 
 
 
If you attempt to close the '''Flash Properties''' dialog window without saving the changes, you will be prompted to do so:
 
 
 
[[Image:CKEditor_options_changed.png|frame|center|alt=An alert window prompting to save the changes made to the Flash object|An alert window prompting to save the changes made to the Flash object]]
 
 
 
 
 
You can either proceed without saving your changes by choosing '''OK''' or close the alert window with the '''Cancel''' command and save the changes.
 
  
 +
{{CKEditor Dialog Windows}}
  
 
== General ==
 
== General ==
 
 
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.
 
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.
  
[[Image:CKEditor_flash_general.png|frame|center|alt=General tab of the Flash Properties window|General tab of the Flash Properties window]]
+
[[Image:CKEditor_flash_general.png|frame|center|General tab of the Flash Properties window]]
  
  
Line 34: Line 23:
 
** External server: If you want to use an external address, use the full absolute path.
 
** External server: If you want to use an external address, use the full absolute path.
 
**: Example:
 
**: Example:
**: http://example.com/flash1.swf
+
**: <code><nowiki>http://example.com/flash1.swf</nowiki></code>
** Local server: If the image is located on the same server, you can use an absolute path that omits the domain name and starts with a slash.
+
** 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:
 
**: Example:
**: [[/animations/flash2.swf]]
+
**: <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.
 
**: 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.
  
Line 49: Line 38:
  
 
== Upload ==
 
== 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]).
 
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]).
  
[[Image:CKEditor_flash_upload.png|frame|center|alt=Upload tab of the Flash Properties window|Upload tab of the Flash Properties window]]
+
[[Image:CKEditor_flash_upload.png|frame|center|Upload tab of the Flash Properties window]]
  
  
Line 58: Line 46:
  
 
== Properties ==
 
== 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.
 
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.
  
[[Image:CKEditor_flash_properties.png|frame|center|alt=Properties tab of the Flash Properties window|Properties tab of the Flash Properties window]]
+
[[Image:CKEditor_flash_properties.png|frame|center|Properties tab of the Flash Properties window]]
  
  
 
Below is an overview of all '''Properties''' tab elements:  
 
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:
+
* '''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.
+
** '''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).
+
** '''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.
+
** '''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:
 
* '''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.
+
** '''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.
+
** '''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.
+
** '''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 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.
+
** '''Window''' &ndash; the Flash object is shown in its own window on a document.
** Opaque &ndash; the Flash object hides everything underneath.
+
** '''Opaque''' &ndash; the Flash object hides everything underneath.
** Transparent &ndash; the document background shows through all transparent parts of the Flash object.
+
** '''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:
 
* '''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.
+
** '''Best''' &ndash; best appearance, speed is disregarded.
** High &ndash; appearance is favored over speed.
+
** '''High''' &ndash; appearance is favored over speed.
** Auto High &ndash; speed and appearance are equally emphasized.
+
** '''Auto Hig'''h &ndash; speed and appearance are equally emphasized.
** Medium &ndash; speed is favored over quality, but some anti-aliasing is applied.
+
** '''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.
+
** '''Auto Low''' &ndash; speed is favored over quality, but quality is improved whenever possible.
** Low &ndash; speed is favoured over quality and anti-aliasing is never applied.
+
** '''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.
+
* '''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'''.
  
  
Line 94: Line 81:
  
 
== Advanced ==
 
== 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.
  
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 and CSS and gives nearly endless possibilities as far as the presentation of the Flash object is concerned.
+
[[Image:CKEditor_flash_advanced.png|frame|center|Advanced tab of the Flash Properties window]]
 
 
[[Image:CKEditor_flash_advanced.png|frame|center|alt=Advanced tab of the Flash Properties window|Advanced tab of the Flash Properties window]]
 
  
  
Line 105: Line 91:
 
* '''Advisory Title''' &ndash; the text of the tooltip that is shown when the mouse cursor hovers over the Flash object (<code>title</code> attribute).
 
* '''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.
 
* '''Background color''' &ndash; the color that is visible beneath the transparent portions of the Flash object.
* '''Stylesheet Classes''' &ndash; a 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.
+
* '''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.
 
* '''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
This page was last edited on 8 August 2012, at 12:45.