The rest of this tutorial will explain each of these steps in detail.
Step 1: Prepare your page
The UI Options component includes templates for its user interface, so you do not need to actually create any HTML if you're happy with the defaults. For the full-page version of UI Options, all you need to do is create an HTML page that has:
- one identifiable
<div> where the UI Options markup will be inserted
<div> where the Table of Contents will be displayed (UI Options allows users to request a table of contents be displayed on each page; see the UI Enhancer tutorial for more information about this).
You might also choose to add a heading to the page. This all might look as shown below:
<!-- This div should be placed where the Table of Contents is to be displayed -->
<div class="flc-toc-tocContainer"> </div>
<h1>Customize Your Presentation Settings</h1>
<!-- This is the div that will contain the UI Options component -->
<div id="myUIOptions"> </div>
Note that we've put an ID on the
<div>. This ID will be used to tell UI Options exactly which element to use as the main container for all of its markup. You can use any kind of CSS-based selector (e.g. a classname), so long as you are sure it will uniquely identify one and only one element.
If you open this page in your browser, you'll only see the header, since UI Options isn't present on the page yet:
Step 2: Add dependencies to the page
|_UIO tutorials adding dependencies 1||nopanel||true|
|_UIO tutorials adding dependencies 1|
You'll also need the UI Options CSS files specific to the Full Page UI Options:
<link rel="stylesheet" type="text/css" href="components/uiOptions/css/UIOptions.css" />
<link rel="stylesheet" type="text/css" href="components/uiOptions/css/FullUIOptions.css" />
<link rel="stylesheet" type="text/css" href="components/uiOptions/css/FullNoPreviewUIOptions.css" />
|_UIO tutorials adding dependencies 2||nopanel||true|
|_UIO tutorials adding dependencies 2|
Step 3: Write a script to create the UI Options component
|_UIO tutorials script 1 enhancernopanel||true|
|_UIO tutorials script 1 enhancer|
|_UIO tutorials script 2 uioptions||nopanel||true|
|_UIO tutorials script 2 uioptions|
We will use the options to tell the component about two things:
- where it's living in relation to the HTML templates included in Infusion: the
- where to redirect when the Cancel button is pressed: an
onCancel listener in the
// Instantiate the UI Enhancer component, specifying the table of contents' template URL
tocTemplate: "<path to your copy of Infusion>/components/tableOfContents/html/TableOfContents.html"
// Instantiate the UI Options component
// Tell UIOptions where to find all the templates, relative to this file
prefix: "<path to your copy of Infusion>/components/uiOptions/html/",
// Tell UIOptions where to redirect to if the user cancels the operation
window.location = "<the URL of the page to return to>";
Now, when you load your page in your browser, you will see the UI Options controls:
UI Options is now fully functional on your page. If you adjust the controls and click "Save and Apply," your changes will be applied to the page. If you've also added the UI Enhancer to the other pages of your site, those pages will also be transformed.
One last thing!
Don't forget to add a link to the the UI Options page to your site – somewhere easy-to-find, such as your site's header or footer.