Home
Framework and Author Mode Customization
Tutorials and details about customizing frameworks and the visual Author editing mode
CSS Support in Author Mode
CSS Extensions
Form Controls
Audio File Player Form Control
The oxy_audio built-in form control is used for providing a mechanism to play audio clips.

Introduction
Welcome to the User Manual of Oxygen XML Author Eclipse plugin 27.1
Getting Started
Information and resources to help you get started using Oxygen XML Author Eclipse plugin as quickly as possible
Installation
The requirements and installation instructions for each platform
Configuration
Description of all of the options that allow you to configure Oxygen XML Author Eclipse plugin
Perspectives
The Editor and Database perspectives
Editing Modes
The Text, Grid, and Author editing modes
Working With Documents
General information about features available when working with documents
Editing Supported Document Types
Details about the various types of supported documents and their unique editing features
Built-in Frameworks (Document Types)
The editing frameworks that are supported in Oxygen XML Author Eclipse plugin
Additional XML Editing Frameworks (Document Types)
The custom frameworks that are supported in Oxygen XML Author Eclipse plugin
Publishing
Details about transformation scenarios and customizing various types of output
Working with XPath Expressions
Information about using XPath Expressions in Oxygen XML Author Eclipse plugin
Working with Archives
Describes how to use the Archive Browser to work with various type of archives
Databases and SharePoint
Connecting to supported databases and integrating Oxygen XML Author Eclipse plugin with SharePoint
Importing Data
Information about how to import data from external sources into XML documents
Framework and Author Mode Customization
Tutorials and details about customizing frameworks and the visual Author editing mode
- Creating and Configuring Custom Frameworks
- Basic Framework Customization Tutorial
- CSS Support in Author Mode
  - Associating a CSS with an XML Document
  - Handling CSS Imports
  - Displaying Processing Instructions from Other XML Editors
  - Specifying Media Types in the CSS
  - CSS At-Rules
  - Standard W3C CSS Supported Features
  - CSS Extensions
    - Built-in CSS Selectors
    - Additional CSS Selectors
    - Additional CSS Properties
    - Custom CSS Functions
    - Form Controls
      - Audio File Player Form Control
        The oxy_audio built-in form control is used for providing a mechanism to play audio clips.
      - Browser Form Control
        The oxy_browser built-in form control is used for providing a mechanism to integrate HTML frames or interact with SVG documents directly in the Author mode editor. It can also be used to load HTML that executes JavaScript and from that JavaScript you can access the Oxygen XML Author Eclipse plugin workspace.
      - Button Form Control
        The oxy_button built-in form control is used for graphical user interface objects that invoke a custom Author mode action (defined in the associated Document Type) referencing it by its ID, or directly in the CSS.
      - Button Group Form Control
        The oxy_buttonGroup built-in form control is used for a graphical user interface group of buttons that invokes one of several custom Author mode actions (defined in the associated Document Type) referencing it by its ID, or directly in the CSS.
      - Checkbox Form Control
        The oxy_checkbox built-in form control is used for a graphical user interface box that you can click to enable or disable an option. A single checkbox or multiple checkboxes can be used to present and edit the value on an attribute or element.
      - Combo Box Form Control
        The oxy_combobox built-in form control is used for providing a graphical user interface object that is a drop-down menu of proposed values. This form control can also be used for a combination of a drop-down menu and an editable single-line text field.
      - Date Picker Form Control
        The oxy_datePicker built-in form control is used for offering a text field with a calendar browser that allows the user to choose a certain date in a specified format.
      - HTML Content Form Control
        The oxy_htmlContent built-in form control is used for rendering HTML content. This HTML content is displayed as a graphical element shaped as a box. The shape of the box is determined by a given width and the height is computed based upon the length of the text.
      - Pop-up Form Control
        The oxy_popup built-in form control is used to offer a contextual menu that provides quick access to various actions. A pop-up form control can display single or multiple selections.
      - Text Area Form Control
        The oxy_textArea built-in form control is used for entering multiple lines of text in a graphical user interface box. A text area may include optional syntax highlight capabilities to present the form control.
      - Text Field Form Control
        The oxy_textfield built-in form control is used for entering a single line of text in a graphical user interface box. A text field may include optional content completion capabilities, used to present and edit the value of an attribute or an element.
      - URL Chooser Form Control
        The oxy_urlChooser built-in form control is used for a dialog box that allows you to select the location of local or remote resources. The inserted reference is made relative to the URL of the currently open editor.
      - Video Player Form Control
        The oxy_video built-in form control is used for providing a mechanism to play videos.
      - Implementing Custom Form Controls
        If the built-in form controls are not sufficient for your needs, you can implement custom form controls in Java.
      - Editing Processing Instructions Using a Form Control
        Oxygen XML Author Eclipse plugin allows you to edit processing instructions, comments, and CDATA by using CSS extensions.
    - Custom CSS Pseudo-classes
    - Using the :before(n) and :after(n) CSS Pseudo-Elements
  - Debugging CSS Stylesheets
Extension Points for the Oxygen Eclipse Plugin
A list of extension points available for the Oxygen Eclipse plugin
Tools
Specifics about the various tools that are included in Oxygen XML Author Eclipse plugin
Troubleshooting
A compilation of common problems and their solutions
DITA Authoring
A guide to help content authors who create and publish DITA content
Scripting Oxygen
Details about the scripting possibilities that are available with Oxygen XML Author Eclipse plugin
Glossary
Copyright
Legal information

Audio File Player Form Control

The oxy_audio built-in form control is used for providing a mechanism to play audio clips.

The oxy_audio form control supports the following properties:

href - The absolute or relative location of a resource. This property is mandatory. Relative values are resolved relative to the CSS. If you have media resources relative to the XML document, you can specify their paths like this:
```
oxy_audio(href, oxy_url(oxy_base-uri(), 'ex.mp3')), width, 400px)
```
width - Specifies the width of the content area using relative (em, ex), absolute (in, cm, mm, pt, pc, px), and percentage (followed by the % character) length units.

Example: oxy_audio Form Control

object {
    content:
        oxy_audio(
            href, 'resources/audio.mp3',
            width, 200px),
}

Tip:

To insert a sample of the oxy_audio form control in a CSS file , invoke the Content Completion Assistant by pressing Ctrl + Space and select the

oxy_audio code template.

To see more detailed examples and more information about how form controls work in Oxygen XML Author Eclipse plugin, see the sample files in the following directory: [OXYGEN_INSTALL_DIR]/samples/form-controls.

Resources

For more information about form controls, watch our video demonstration: