blog-tutorial-post-template

Tutorials

Getting Started

To begin, add a Mod Keys stack to the area in the editor where you want mod key–activated content to appear. Then, select the stack and open the settings panel.

Below is a description of each available setting:

Settings

Type

Choose the function of this Mod Keys stack:

  • Reveal – Reveals active-state content.

  • Swap – Swaps inactive content with active-state content.

  • Toggle – Displays an onscreen toggle that can be used to activate other Reveal or Swap elements.

  • Note – Displays custom content tailored to the user’s operating system (macOS or Windows). You can also choose whether this content appears for users with a physical keyboard or those using a touchscreen device.

Mod Keys

This setting is available when Type is set to Reveal, Swap, or Toggle.

  • Reveal – Select the keyboard key that must be pressed to reveal content.
  • Swap – Select the key that triggers the content swap.
  • Toggle – Select the key the toggle is linked to. When toggled on, any other Mod Keys stack using the same key(s) will also activate.

Each option shows the corresponding key for both macOS and Windows keyboards. Choosing Custom allows you to define your own keys—separately for macOS and Windows.

macOS & Windows

These input fields appear when Mod Keys is set to Custom. They allow you to define one or more required keys for each operating system.

Keys can be referenced in three ways:

  • By label – e.g., A, Option
  • By name – e.g., KeyA, Alt
  • By code – e.g., 65, 18

To require multiple key presses, separate them using a plus sign (+).
Example combinations for Alt + A:

  • Label: Option+A
  • Name: Alt+KeyA
  • Code: 18+65

Refer to the chart below for a full list of labels, names, and codes. For non-U.S. keyboards, use the U.S. equivalent.

Activate State On

Available for Reveal and Swap types. Choose how the active state is triggered:

  • Press – The content becomes active when the specified key(s) are pressed. Pressing the same key(s) again toggles the state off.
  • Press & Hold – The content stays active only while the key(s) are being held down. Releasing any key will deactivate the state.

Animation

Also available for Reveal and Swap. Choose how the active content appears when triggered.
Select None to disable animations.

Maintain Vertical Spacing

Available for Reveal and Swap types. When enabled, content activation won’t change the layout vertical height:

  • With Reveal, empty space is reserved when the content is hidden.
  • With Swap, both active and inactive states occupy the same vertical space.

Toggle Styles

These settings are available when the Type is set to Toggle.

Size

Adjusts the overall size of the toggle graphic.

Type

Choose from three toggle types: Default, Thin, and Checkbox.
This setting affects appearance only; all types function the same.

Style

Select from three styles: Default, Flat, and Detailed.
Each style visually modifies the toggle based on the selected type.

High Contrast

This option appears when Style is set to Detailed.
Enable this setting to increase shadow contrast—especially useful when using dark backgrounds or dark-colored toggles.

Shape

Choose the edge style of the toggle graphic:

  • Round
  • Rounded
  • Square
  • Square Sharp

Align

Controls the toggle’s alignment based on available space to the left and right.

Content Styles & Layout

These settings apply to the following, depending on the Type:

  • Reveal / Swap – Active-state content
  • Toggle – The toggle container
  • Note – The OS-specific content display

Most settings are self-explanatory, except for Width & Position, which offers more advanced layout options.

Width & Position

Choose how the content is sized and positioned within the layout. Four options are available:

  • None
    Content fills the entire available horizontal space.
  • Static
    Set a fixed width. The content stays in flow with surrounding elements and can be horizontally aligned.
  • Absolute
    Set a width and position the content on top of surrounding elements. You can also define:

    • z-index
    • Horizontal/vertical positioning
    • Margins for offset adjustments
  • Fixed
    Set a width and position the content fixed to the browser window. You can define:

    • z-index
    • Horizontal/vertical positioning
    • Margins for offsets from the edges of the viewport

RapidWeaver Stack Tutorials

RapidWeaver Theme Tutorials

RapidWeaver Project Documentation

Tutorials and documentation for all 1LD Project files can be found at the link below.

See Documentation

Get the power of a framework, for the price of a theme, in the convenience of a prebuilt RapidWeaver project file

Blog

Live Search 2

Live Search 2 has been updated with new features, improvements, and important bug fixes – all designed to make your site’s search experience even faster and more precise.

This update is free and automatic for all existing customers.

Don’t own it yet? Now’s the perfect time to jump in — Live Search 2 is 30% off for a limited time! No code needed — your discount is automatically applied at checkout.

New Features:

  • Added support for exact match searches using quotation marks around parts of a search phrase.
  • New option to show a “Clear Input” button.
  • Added Replace Character feature.
  • Now supports two separately defined search bars on the same page.
  • New option to adjust z-index.

Improvements:

  • Index file generation now detects and ignores duplicate content, such as text found in every page header and footer.
  • If any pages are missing from the index file, they will now still be searched dynamically.
  • Index file data is now compressed to reduce file size.
  • Pages at https://website/folder/index.(php|html) and https://website/folder/ are now treated as duplicates and will not be indexed separately.
  • Search results container height now only stays fixed during pagination — it will shrink dynamically for new searches.
  • When searching custom sitemaps, the default sitemap will now be ignored.
  • The popout search results container will now automatically hide when the search input is empty.

Bug Fixes:

  • Fixed an issue that prevented custom text/language settings from applying correctly.
  • Fixed a bug where result descriptions could fail to display a local section title.
  • Fixed a bug that could trigger an error if suggestions were enabled but the stack was not published to the page.
  • Prevents form submission before the page is fully loaded, avoiding unwanted page refreshes on slow-loading pages. A loading indicator is shown until the page is ready.

Check it out in action!

© 2011 One Little Designer, 1 Little Designer (1LD)

RapidWeaver is a trademark of Realmac Software