Sandvox Help
Index

# Object

If you have been using earlier versions of Sandvox, we had used the term "Pagelet" but now we have unified architecture, and pagelets are now called Objects.

An object is something that is put onto a page. It can go in three positions - in the main content area, mixed in with the text; as a callout, or in the sidebar. (As set in the Wrap Inspector).

## Object Types

Sandvox 2 ships with the following object types:

Text Box
  A simple section of text that you can format.
Block Quote
  A Text Box pre-configured for containing a quote.
Media Placeholder Object
  A placeholder for media, e.g. Image, Video, Audio, or Flash.
Indexes
  Collection Archive
    Generates archival pages for a collection each month to keep track of changes to the collection.
  Photo Grid
    Page thumbnails and titles in a grid arrangement.
  Site Map
    A Site Map lists all the pages of a site.
  Slide Show
    Shows a collection of images in sequence.
  Titles and Summaries
    Page Titles and/or summaries that can be customized with many different layouts.

Sharing Buttons
  Facebook
    Adds a Facebook button to your site.
  Google+
    Adds a Google+ +1 Button to your site.
  LinkedIn
    Adds a LinkedIn Share or Member Profile button to your site.
  Pinterest
    Lets your visitors post your page to their Pinterest boards.
  Tweet Button
    Help visitors tweet about your site.

Raw HTML
  An object of your own custom HTML code.
Amazon List
  A list of Amazon products
Contact Form
  A form allowing site visitors to easily contact you while protecting your e-mail address.
Delicious List
  Lists your delicious.com bookmarks.
External Page
  An external webpage contained within an object. Sometimes known as an iFrame.
External RSS Feed
  Displays the up-to-date headlines from an RSS or Atom feed.
Flickr Thumbnails
  A small gallery of photos from Flickr.
IM Status
  Displays whether your Messages (AOL/AIM), Skype, or Yahoo! Instant Messenger account is currently online or not.
List of External Links
  A customizable list of links to external webpages.
Map
  Includes a Google Map on your site.
Page Counter
  Indicates how many times your site has been visited.
RSS Badge
  Links to the RSS feed of a collection, allowing visitors to easily subscribe to it.
Sandvox Badge
  A small image that shows you used Sandvox to build the site. Click on it to go to the Sandvox site
Vimeo
  Displays a video from Vimeo
YouTube
  Displays a video from YouTube

### Custom Object Types

To expand on the basic page types, experienced Cocoa Developers can use the "Sandvox Developers Guide" to create custom object types.

For a guide on how to install such third party object types, please see "Installing Sandvox Plug-ins and Designs."

## Working With Objects

Ways to add a new object to a page:

- Click the "Objects" item in the toolbar and choose an object from the list.
- Choose "More" from the Insert menu and pick an object.

For an Index Object choose from the Index option in the Insert menu.

- Drag a media file (from the Media Browser, Finder, or another application) into the Sidebar of a page.

If you want to quickly add an object to the sidebar, select an existing object in the sidebar, then add the new object. The new object will be added above the existing one.

Ways to move an object on a page:

- You can drag objects around (up and down within main body area, and left-center-right alignment within the main body area, or just up and down within the sidebar.
- You can also change their position from the Wrap inspector.

Ways to edit an object's settings:

- Click the object to select it and open the Object Inspector.

Ways to remove an object from a page:

- Click the object to select it, and choose "Delete" from the Edit menu.
- Select the object and press the delete key.

## Object selecting and focusing

Selecting an object -- where you get resize handles -- and 'focusing' on an object, which is where you click on an object a second time.

When you focus on an object, the rest of the web view gets slightly darker. When you are focused on an object, you can interact with it; for instance on a video you can then click the controls to actually play a video.

The inspector works on the selected or focused object.

When an object is selected, you can drag it around on the page. When the object is focused, you cannnot, since clicks and drags are sent to the object for it to handle. For instance, you can skim through a video by dragging the slider left and right.

Click outside of a selected or focused object to de-select it.

## Related Articles

- Callout
- Deleting an Object
- Sidebar
- Giving an Object a Caption

Keywords: object, objects, callout, callouts, sidebar, page, mini, small, control, click, right, control-click, right-click

How can we improve this page? Let us know.