The Property Library¶
Fields, Models, and Pages¶
Fields [[]]¶
Once fields are added to the Table or Form component, each has a specific set of properties. These properties vary, depending upon the component and field type. Click on the field within the table to reveal and edit its properties.
Basic tab [[]]¶
Field ID: The API name of the selected field.
Label/Custom label: The name for the field (or template field). Replaces default field label with custom text. Use the field picker to select a field to use as the column label.
Note
This feature lets you choose another field’s name and re-label the column with it, to shorten or clarify the column’s identity or purpose for users.
Placeholder: Text or prompts that appear inside editable sections within the component. Commonly used to provide instruction for more complex field requirements, this field is compatible with merge syntax.
Read-only: If checked, text fields are read only and cannot be edited by users. This setting does not persist across Skuid pages.
Note
Skuid automatically respects the validation rules and field-level security from your data source.
Required: If checked, text input is required.This setting does not persist across Skuid pages and will not override existing data model settings within the data source.
Note
Skuid automatically respects the validation rules and field-level security from your data source.
Clip heading text: If checked, if a column’s heading text exceeds the size of the column, the text is truncated (with ellipses indicating additional content.)
Horizontal alignment: Adjusts alignment of text or value within a field to left (default) or right.
Display as: Determines how values are entered in Edit mode.
Text (String fields): Renders the field as text.
Password (String fields): Renders the field as a password, with the content hidden by asterisks.
Picklist: (Reference fields) Renders the reference field options as a picklist: a dropdown menu of selectable options.
Radio: (Picklists fields) Renders the field as radio buttons.
Note
For multi-select picklists, Skuid renders a multi-select list of checkboxes instead.
Button Group: (Picklist fields) Renders the field as a set of buttons.
Combobox (Picklist fields): Renders the picklist field options as a combox, a text box in which user entry triggers a dropdown menu. As users type, the menu narrows available options. Users can also access the dropdown using the combobox’s menu selector (
).Date (Date-time fields): Renders the field as a date.
Datetime (Date fields): Renders the field as a datetime.
Autocomplete: (Reference fields) The default for reference fields, this renderer tries to autocomplete entries based on the options available for this field.
Checkbox (Boolean fields): Renders the field as a checkbox.
Switch (Boolean fields): Renders the field as a toggle switch.
Custom:
- Display method: Sets a custom display method defined in JS snippets.
Numeric field types have different field renderer options:
Number: Renders the field as a number.
Slider: Allows the user to enter the value as a position on a slider.
- Minimum value: The starting numerical range for the slider.
- Maximum value: The ending numerical range for the slider
- Step: The increments used in the slider.
Stepper: Allows the user to enter the value via an entry box with “+” and “-” handles to increment or decrement the numeric value
- Minimum value: The starting numerical range for the stepper.
- Maximum value: The ending numerical range for the stepper
- Step: The increments used in the stepper.
Add “None” option: Includes a null value in the list.
- None Option Label: Sets the text for the “None” option.
Limit # values to: For reference fields rendered as picklists, restricts the number of allowed values on the picklist.
Note
The default behavior displays all values for the field. However, if the field includes a large number of distinct values, the page may need to query a lot of data, resulting in a slow page load. Limiting the number of picklist options reduces the query and load time.
Allow user to hide/show?: Permits the user to show or hide columns using the Table Setting modal, and determines whether the selected column is shown by default.
- Yes, and show the field by default
- Yes, and hide the field by default
- No
Note
This property is available when Allow column hiding is checked in the Display tab’s Configuration section (in Table properties).
Column summaries: (Number fields) Add summaries to the bottom of each column: Sum, Average, Min, Max, or Median. Enter the value as a:
Minimum value: The starting numerical range for the stepper.
Maximum value: The ending numerical range for the stepper
Step: The increments used in the stepper.
# of decimal places: (Currency and measurement fields) Choose the number of decimal places. Options: 0-8 or use the field’s metadata to determine the number of decimal places.
Show length counter (Textarea fields): When the field is in Edit mode, it displays a character countdown (“25/ 128”) indicating the number of characters used and how many total characters are allowed.
Note
- The counter is enabled by default for standard textarea fields.
- The counter is not available for Salesforce rich text area fields.
- Template: (Template fields) Specifies which fields the template field should include by either selecting them from the field picker, manually entering their merge variables, or using custom text.
- Sort field: (Template fields) When sorting is enabled for the table, specifies which of the template’s fields to use for sorting.
Search tab [[]]¶
(For reference fields)
The Search tab is available for reference fields on the Form and on the Table component when the Table or Form is in Edit mode. Search allows end users to search for content from within the model (or from a selected model) when editing a reference field.
Search Properties [[]]¶
Option source:
Automatic: Searches for and lists possible content options from within the object the reference field is referencing.
Model: Searches for and lists possible content options from any model on the page.
- Option model: If using “Model” as the Option source, the name of the model.
Display template: Select fields to use (via merge syntax) as the template for the returned list of items for a search.
Search template: Select fields to use (via merge syntax) as the template for the Search list.
Visible Rows: Determines the amount of results available from the model (5, 10, 25, 50, Show all)
Tokenize autocomplete search: If checked, each word typed into the search bar is “tokenized” — meaning each word is searched for individually. A tokenized search for “George Washington” returns any record with “George” and “Washington”. For example, “George Washington,” “George Michael Washington,” and “George is headed to Washington”. An untokenized search for “George Washington” returns only records with “George Washington” exactly.
Search Fields [[]]¶
Note
Depending on the data source used for the model attached to the component, this property may not be available.
Use SOSL to improve search performance: (Salesforce data sources only) SOSL quickly can search multiple objects at a time within a single search query. SOSL does not directly search the database, but instead queries an index of Salesforce text fields. Individual search fields may not be added when this property is enabled.
Warning
Because the search is against the index, results are limited to what is present in the index, and will not include data that may have been recently updated in the database. The index updates very quickly, but expect a delay of up to 30 seconds between changes made to the database, and their appearance in the search results.
Note
SOSL can search text fields (including long text fields), but not picklist fields and reference fields.
Fields to search: Sets which Types of fields to query with SOSL. The options are:
- Name Fields (default)
- All Text Fields
- Email Field
- Phone Fields
- SideBar Fields (Name, Phone, Email, External Ids)
Searches on Salesforce data sources can use one of two query languages: SOQL or SOSL. SOQL can only search one object at a time in a single query, but searches all searchable fields in that object in real-time.
Use default ordering: If checked, no additional sorting is applied to the result of the search.
- Fields to order records by: If Use default ordering is unchecked, sets how the returned items will be ordered using the field name and the order instructions. For example, Name ASC orders the list by name, from A to Z; Name DESC orders the list by name, from Z to A.
If Use SOSL to improve search performance is not checked, Search can be narrowed to individual fields by clicking
Add new search field and then configuring the search parameters- Field: The field to use in the search. Use the field picker to select.
Note
(Salesforce data sources only) SOQL can search picklist fields and Reference fields, but not long text fields. To search long text fields, use SOSL.
Return field in query results: Returns field data, even if the field isn’t searched, and makes that field data available for merge variables
Show field in search popup: Show a field in the search popup, even if the column that contains the field is hidden on the table.
- Custom label: Displays a custom header for the column being searched in the popup.
Search using Salesforce fields [[]]¶
By default, Salesforce Objects use SOQL. To ensure proper functionality, enable the Allow Search property on any Salesforce objects to be included in the search.
For more information on using these search options with Salesforce, check out Salesforce’s SOQL and SOSL Reference Guide.
Link tab [[]]¶
(For reference fields)
The Link tab determines whether an end user can navigate to a referenced record’s detail page (or some other custom URL) by clicking on the record in the table. If using the field as a link, you can set the following properties:
Navigation type:
Data source default: If a data source type has default behaviors configured for reference fields—for example, navigating to a detail page using the record ID a la Salesforce—then that behavior will be used in Skuid.
No link: The reference fields will display as unclickable plain text.
Skuid page: Set the field to link to a Skuid page.
- Skuid page: The name of the linked Skuid page.
Route: Set the field to link to a Page URL slug in Skuid Platform. (This will create a link to that page.)
- Skuid route: The name of the route.
Custom URL: Set the field to link to a specified URL.
URL: The URL that an end user will be taken to. Can accept merge syntax, which can be particularly useful for URL parameters.
Open URL in:
Current Window:
- Opens the URL in the current window.
- If using the Skuid page is within an iFrame, opens the URL in the current iFrame.
Note
Other content blocks on the page will remain the same.
New Tab: Opens the URL in a new tab.
Styles tab [[]]¶
Interactions tab [[]]¶
(For template fields on Table and Form components)
Filters tab [[]]¶
(For reference fields)
In partnership with the settings in the Search Tab, the Filters tab lets you create Lookup Filters to limit the search/display content provided when editing reference fields.
Click
Add New Lookup Filter and set the following properties for Lookup Filter conditions:Set the following properties for Lookup Filter conditions:
Field: The field in the current model to use as a filter for the searchable reference field.
Operator: The relationship between the field and its filter content.
Content: The type of value used to filter the reference field’s data.
Single specified value: Returns records that meet the specified value.
- Value: Indicate the value to filter by.
Multiple specified values: Returns records that meet at least one of the several specified values.
- Values: Indicate the values to filter by; for each separate value, click Add Another Value.
Field from another model: Use a field from another model as the filter for the Lookup field.
- Source model: The name of the model.
- Source field: Field on the source model.
- If no row in source model, then …
- Deactivate this Condition
- Abort this Model’s Query
Page/URL parameter value: (Skuid on Salesforce) Returns records that meet the specified Salesforce Lightning page or URL parameter, for example, the id parameter.
Parameter: Indicates the specific parameter to filter by.
If this Parameter is not provided, then …
- Set its value to Blank
- Deactivate this Condition
- Abort this Model’s Query
Running user attribute: Returns records if the value of a field on the model matches the value of a field on the current user’s record.
Userinfo Property: The value on the current user’s record to be used as a filter, usually an ID property. Options include:
- Default currency
- First name
- Last name
- Locale
- Name
- Organization ID
- Organization name
- Profile ID
- Profile name
- Session ID
- User ID (default)
- User name
- Use role ID
- User type
- Is multi currency org
None - blank value: Returns records only if the specified field is empty.
Another field from row: Returns records only if the field on the referenced record matches a separate field on that same record.
- Depends On: Select the field to compare with.
Advanced Tab [[]]¶
(For date- or time-related fields)
Show month & year picker: If checked, Skuid displays month and year pickers during Edit Mode, to make it easy to jump to a specific year.
Year picker lower bound and Year picker upper bound: Sets the upper and lower boundaries of the list of possible years. Options include:
- “Selected” measures from a date selected on the Date Picker. Increments are 1-10, 20, 30 40, 50, 60, 70, 80, 90, and 100.
- “Today” measures from the current date. Increments are 1-10, 20, 30 40, 50, 60, 70, 80, 90, and 100.
Show today button: If checked, the month/year pickers include a Today button that allows users to quickly jump to the current date.
Minute picker increment: For editable date-time fields, select the minute increments (1, 5, 10, 15, 20, 30) for the displayed Time Picker.
Display Logic tab [[]]¶
Field Metadata [[]]¶
Models [[]]¶
Warning
- Not all model properties listed below will be available for all data source types. If you do not see a property listed here in the app composer, it may not be available for your data source type.
Models for some data source types may have unique properties not documented here. These properties are detailed in the topics for those respective data source types.
General tab [[]]¶
Model ID: The unique name by which components refer to this model. Each model must have a unique name within one Skuid page. If other pages are included within that page—such as through the Page Include component or child pages—then the models in those pages must also have unique names.
Data source type: The data source type <data/> to use for this model, which narrows the selectable options in the Data Source property.
Data source: The data source <data/>—a connection to a system that has been configured by the Skuid builder—that the model uses to access records.
Model Object / Entity: The data object to pull data from. The label for this property can vary based on data source type, but they all mean the same thing:
- External Object Name
- Model Entity
- Salesforce Object Name
Model behavior: Some data sources allow the builder to select a specific type of model behavior:
- General: The default Skuid model.
- Aggregate: A model that collects, groups, and summarizes multiple data records into a single end result, such as a sum or a count.
- Read-only: (REST data sources) A model that can only query (and not update) data.
- Read/Write: (REST data sources) A model that can use multiple data source URLs for different data operations.
Query on page load: If unchecked, no data rows are loaded into the model when the page initially loads. Uncheck this box to use this model to create new records, or to load this model later via the Action Framework (for example, opening it in a drawer, popup, or tab).
Allow Page Render Before Query Completes: Controls whether Skuid must finish loading the metadata for the model before rendering the Skuid page. (Only available if Query on page load is checked.) By default, Skuid loads metadata for every model prior to rendering a page, even those without visible UI components. A model containing a picklist with hundreds or thousands of values could extend page load times, especially if there are many models on a page. Use this property to tailor which models have a higher priority, giving users access to the most meaningful data and UI elements first.
When unchecked, the model is considered synchronous—meaning it is given priority and its query must complete before the page renders.
When checked, the model is considered asynchronous, and the page will render even if its query is not yet finished.
Note
This model property is unavailable for server-side models.
Max # of records (limit): The maximum number of records that will be pulled in to this model when it is queried. The smaller this number is, the faster your page will load, but the less data available within the page.
Fields to order records by: Determines how the rows of records are sorted within the model. For basic models this sort statement is written as
FieldName SORT
, while for aggregate models it’s written asFUNCTION(FieldName) SORT
.Two sort commands are available:
- ASC: Ascending, meaning records of higher “value”—alphabetically or numerically—appear at the bottom of the record list. (If no sort command is specified, ASC is assumed.)
- DESC: Descending, meaning records of higher “value”—alphabetically or numerically—appear at the top of the record list.
So to sort a basic model’s rows by its amount field in descending value, use
Amount DESC
. Or to sort an aggregate model’s rows by an aggregation that sums the amount field in descending value, useSUM(Amount) DESC
.Multiple sort statements can be used in this property when separated by a comma. Sort statements are applied in the order they appear.
For example, to order a model’s rows alphabetically—ascending—by the Name field and then by their Number field descending, enter the following:
Name, Number__c DESC
(Note that the first sort statement works because ASC is assumed.)
Note
If used on a Salesforce data source model, this property is also compatible with the NULLS FIRST and NULLS LAST syntax.
Create default row if model has none: When checked, a new record will automatically be created if there are no records within the model on page load. Useful for “Create New Record” pages.
Advanced tab [[]]¶
Prevent users from leaving page if this Model has unsaved changes: When checked, a dialog box will appear to prevent users from leaving the page if there are unsaved changes in this model. If unchecked, users can leave freely but may potentially lose data changes within this model, so determine the best behavior for your use case.
Model label: If the model’s selected object does not have a singular label—such as Account—this property can be used to specify one. However, if a label is specified for the object within the data source this property has no effect. (Correlates with the {{Model.label}} merge variable for a model.)
Model plural label: If the model’s selected object does not have a plural label—such as Accounts—this property can be used to specify one. However, if a label is specified for the object within the data source this property has no effect. (Correlates with the {{Model.labelPlural}} merge variable for a model. Commonly appears at the bottom of paginated components—like Tables or Decks—and in Page Title components.)
Defer rendering: When checked, fields specified by the data source type or marked in the Fields to Defer property will load asynchronously—meaning all other fields in the model may load and display in any components as soon as they are loaded. Deferred fields display placeholder text while they load and do not prevent other fields from rendering. Useful for fields that may incur longer load times, such as image fields or other binary files.
Note
While some data source types allow for deferred fields to be specified, some will not. For data source types that do not, the Fields to Defer property will not appear.
Fields to defer: Available for some data source types, this property sets which fields should load asynchronously. Requires Defer Rendering to be checked.
Pages [[]]¶
Basic Tab [[]]¶
Page name: The name given the page when it was created.
API version: The API version the page is built on.
Note
The API version selected at page creation determines the features available to the page. You may only use the components associated with a page’s API version. Also:
- The API version of both master and child pages must match.
- The API version of a host page must match the API version of the Page Include component calling that page.
Page title: The content used in a browser’s title bar or on a tab label. (Optional)
Note
This feature has no effect if the page is:
- a child page
- displayed within a Page Include
- deployed within either the Skuid Page or Skuid Page Assignment Lightning components (Skuid on Salesforce only).
Max auto-Saves: An auto-save revision is generated each time a Skuid page is saved, allowing builders to undo recent changes. The number of auto-saves a page can generate is limited by the Max auto-saves property. Auto-save revisions are deleted—oldest first—once the page reaches this Max auto-saves limit.
Note
Despite the name, Skuid pages do not automatically save as they would in a productivity app, like Microsoft Word or Google Docs. Clicking the Save button generates an auto-save that is available to you as a page revision.
Design system: The name of the design system that governs the page styling. Choose from the dropdown.
Warn users if page has unsaved changes: If checked, when a end user tries to close the page when there are unsaved changes, Skuid issues a warning.
- No
- Yes (default)
Personalization mode: Indicates where user personalizations—remembered settings like selected tabs, filter values, etc.—are stored.
Client-side: Use for non-authenticated users (visitors to a public-facing website, community and portal users).
Note
Even if server-side is chosen for the page, non-authenticated users are defaulted to client-side storage for personalizations.
Server-side: Allows Skuid to sync user personalizations across multiple devices. (Default)
Available as a master page: When checked, the page can be selected as a master page when creating new pages.
Skuid on Salesforce only [[]]¶
Module: Allows the Skuid page to be added to a module selected from this dropdown list, which displays all modules registered within Skuid. For more information, see modules.
Tab to override: If creating a Skuid page, but still utilizing the Salesforce header UI, enter the name of your object’s tab here.
Owner: The page creator is automatically set as the owner. Select a name from the dropdown list to change a page’s owner. (You can also set a group as a page’s owner.
Note
This feature can be useful when employing field-level security to limit certain fields to access by specific end users.
Scale for Mobile Devices: Check to visually scale the page’s content and components to display more effectively on mobile devices.
Enable feedback on this page: When checked, users may submit feedback about their experience at runtime. (Checked by default.)
Layout tab [[]]¶
- Show custom header and Show Custom footer: When checked, the page displays a custom header or footer, which are separate page elements than the main canvas.
Note
Once a header or footer is enabled, click on it, and it:
- can be styled from the Styles tab
- components can be added to it
- can be made “sticky” (it remains visible no matter how much a user scrolls through the page) by selecting Sticky in the Basic tab.
To learn more, see Create a Master and Child Page, which employs a custom header and footer in the master page.
Skuid on Salesforce only [[]]¶
For Salesforce Classic
- Show Salesforce Header and Show Salesforce Footer: When checked, the page displays the standard Salesforce Header or footer. (Checked by default.)
Interactions tab [[]]¶
Adds interactions—actions from the Action Framework—to the page. Page-level interactions extend to the full page—a click anywhere on the page triggers the interaction.
Styles tab [[]]¶
- Background: All Page background properties are the same as the Wrapper background section
Skuid Platform only¶
Skuid Platform includes two additional tabs.
Voice tab [[]]¶
- Enable voice: When checked, the page can accept voice input through voice-triggered sequences. Once enabled, the following options are available:
- Voice data source: The Skuid data source connected to the voice processing system to use for this page.
- Chatbot name: The name of the chatbot to use for any voice commands entered by the end user.
- Chatbot alias: The specific alias to use for the chosen chatbot (typically used to denote versions).
Native tab [[]]¶
- Ask for user’s location before page load: Skuid will ask for the user’s location on page load. If location services are enabled on the user’s device, then their location may be used for app functionality through either native mobile actions or geolocation merge variables.
Skuid on Salesforce only¶
Skuid on Salesforce includes one additional tab.
Labels [[]]¶
Skuid allows you to use Salesforce custom labels, along with the Translation Workbench, to display user-facing text in each users’ preferred language. Learn more about creating custom labels in Salesforce.
For each custom label requested, Skuid will determine if there is a translation corresponding to the language of the end user viewing the Skuid page. If there is, Skuid displays the translated text to the user.
Note
It is considered a best-practice to use Custom Labels wherever displaying custom text to your users. Custom labels support effective localization.
To access custom labels:
- In the page properties, click the Labels tab.
- Click on
- Label ID: Enter the label’s name as it appears in Salesforce’s Custom Labels page.
Add Label.
Note
To include a custom label in a template, use {{$Label.<LabelName>}}, e.g. {{$Label.Save}}.
For more information about using custom labels in Skuid, see Label Localization.
Components: Layout¶
Accordion [[]]¶
General tab [[]]¶
One panel open at a time: If checked, only one panel of the accordion can be open at a time. If the end user opens a new panel, the previously-opened one closes.
Sections initially open: If One panel open at a time is unchecked, builders can determine which panel to open upon page load:
- First section: Opens the first Accordion section.
- All sections: Opens all Accordion sections.
- Determine by section: If selected, opens a new Section property called Initial state (see below) to determine the open state of the selected section.
- None: No Accordion sections are open upon page load.
Open panel max height: The height of the component section (minus the section title), measured in pixels, em, rem, percentage, vh, or vw.
Icons on right: If checked, each section displays clickable icons that allow the user to expand and collapse the section.
Icon style: There are two ways to format the section icons:
- One icon: A single icon is used to open and close each section. (The selected icon rotates 45° when the section is open.)
- Icon: Click the field picker to select the icon.
- Separate icons for open/close:
- Icon when opened: Use the field picker to select the icon for an opened section.
- Icon when closed: Use the field picker to select the icon for a closed section.
- One icon: A single icon is used to open and close each section. (The selected icon rotates 45° when the section is open.)
Advanced tab [[]]¶
- Unique ID (optional): Skuid automatically generates an alphanumeric ID for the component; if preferred, give it a practical name.
Styles tab [[]]¶
Display logic tab [[]]¶
Nested elements¶
Section properties¶
General tab [[]]¶
Section heading: The text heading for the section. Type in section text, or select a field to use as the header. (This property accepts merge syntax.)
Initial state:
- Closed: (Default) The section is closed upon page load.
- Open: The section is open upon page load.
- Determined by open conditions: The section’s open/closed state is determined by Display Logic.
Display logic tab [[]]¶
Button Set [[]]¶
Click the Button Set component to access this property pane.
General Tab [[]]¶
- Model: Button sets can be attached to one model. Doing so makes all data-related button types—such as Save, Cancel, and Delete—automatically affect the model selected here.
- Position: This field determines the alignment of the buttons within the container. You can choose:
- Right (default)
- Left
- Center
- Expand to fill: The Button Set component extends across the entire width of its container (whether it’s a page, a grid division, or a tab). By default, Button Groups are clustered together within the Button Set and displayed in the selected Position. When Expand to Fill is checked, Button Groups stretch horizontally across the entire area of the Button Set (even if the Button Group only holds one button).
Advanced tab [[]]¶
- Unique ID (optional): Skuid automatically generates an alphanumeric ID for the component; if preferred, give it a practical name.
Styles tab [[]]¶
Display logic tab [[]]¶
Nested elements¶
Button Group properties¶
Click the border of the Button Group to access this property pane. To add a new Button Group, click the Button Set, then click
Add button group.General tab [[]]¶
Display type:
Detached: Buttons within the Button Group are separated by spacing.
Attached: Buttons within the Button Group are attached to each other.
Combo: Buttons are stacked under the leftmost button in the Button Group and are accessible by clicking an arrow to open the dropdown button menu.
Icon: The icon to be included to the Combo button label. Click the field picker to select an icon.
Icon position: Sets the position of the icon on the button group label.
- Left
- Right
Menu: Buttons within the Button Group are displayed as a menu on the page that can be accessed by selecting the arrow next to the Button Group’s label.
Label (optional): Text for the Button Group’s label. The default label is “Select.”
Icon (optional): The icon to be included to the Button Group label. Click the field picker to select an icon.
Icon position: Sets the position of the icon on the button group label.
- Left
- Right
Advanced tab [[]]¶
- Unique ID (optional): Skuid automatically generates an alphanumeric ID for the component; if preferred, give it a practical name.
Styles tab [[]]¶
Display logic tab [[]]¶
Button properties¶
Click the button itself to access this property pane. To add an new button to a Button Group, click the Button Group’s border, then click
Add button.General tab [[]]¶
- Button label: Text for the button. The default label is “Button.”
- Button icon (optional): The icon to be included to the button label. Click the field picker to select an icon.
- Button icon position: Set the position for the icon on the button.
- Left
- Right
- Aria label: Add a label to be used by access technologies such as screen readers and conforms to Web Accessibility Initiative—Accessible Rich Internet Applications (WAI-ARIA) specifications. This property can be a specific string of text, the merge variables of one or more fields, or a combination of the two.
Note
If no Aria Label is specified, access technologies will use the Button label.
Actions tab [[]]¶
Add actions to a button:
Note
Use the Show/hide menu action to add a dropdown menu to the button.
Advanced tab [[]]¶
- Unique ID (optional): Skuid automatically generates an alphanumeric ID for the component; if preferred, give it a practical name.
Styles tab [[]]¶
Tooltip tab [[]]¶
A floating box that displays when the end user hovers over a button, the tooltip provides guidance usage.
Text: The tooltip’s content.
Position: This field determines the alignment of the tooltip relative to the button:
- Top (default): Above the button.
- Bottom: below the button.
- Left: to the left of the button.
- Right: to the right of the button.
Note
The Position settings are contingent upon available space. For example, if the Button Set is at the top of the page, and the tooltip position is set to Top, the tooltip cannot display above the button: there’s not space. So it will display below the button.
Tooltip style:
- Dark (default): The tooltip box is a black.
- Light: The tooltip box is white, with a drop shadow.
Compact size?: If checked, reduces the amount of padding around the text in the tooltip box.
Hotkeys tab [[]]¶
This tab allows you to establish a set of hotkeys that will immediately execute the actions associated with the button. Select the modifier and key, then test.
Note
Skuid focus hotkeys will not override hotkeys previously assigned by the operating system or browser, so be sure to test the key combination. If it’s not providing the expected results, the key combination may already be assigned. Try a different combination.
Click
Add Hotkey and then configure:- Modifiers include:
- Alt
- Ctrl
- Command
- Shift
- Key: Lists all available keys.
- Ignore hotkey if end user is typing in input element: If checked, the hotkey combination will be ignored while the user is entering content into any text field. (Useful if the hotkey combo would conflict with standard data entry keys, like arrows keys.)
Display logic tab [[]]¶
Masthead [[]]¶
General tab [[]]¶
- Positioning: Determines how the Masthead behaves when the page is scrolled.
- Scrolls with Page: The Masthead scrolls with all other components.
- Fixed: The Masthead is fixed to the top of the page and does not scroll (“sticky masthead”).
- Fixed when at top: If the masthead is not inherently located at the top of the page (for example, it’s beneath a large banner image), it will scroll until it reaches the top, and then become fixed there.
- Unique ID Skuid automatically generates an alphanumeric Id for the component; if preferred, give it a practical name.
Styles tab [[]]¶
Display logic tab [[]]¶
Nested elements¶
Spacing properties¶
General Tab [[]]¶
Change order: Left and right arrows move the selected spacing item left or right on the masthead.
Unique ID Skuid automatically generates an alphanumeric Id for the element; if preferred, give it a practical name.
Flex ratio: This sets the size of this spacing division relative to other items in the mastheads. For example, if there are two items in the masthead, and the flex ratio for each is 1, they will each take up ½ of the masthead. If one has a flex ratio of 2, and the other has a flex ratio of 1, the first one occupies ⅔ of the grid, and the second one occupies ⅓ of it.
Min width: Sets a minimum width for the spacer. When the minimum width is exceeded, the grid division will stack above or below other masthead items. This can be specified using px, em, rem, %, vh, or vw measurements.
Note
- Em, %, vh, or vw are more responsive to screen size.
- Ensure the division’s minimum width is at least as wide as its contents.
Styles tab [[]]¶
Logo properties¶
When you add a logo to the Masthead, the properties are the same as those for the Image component.
Responsive Grid [[]]¶
Layout tab [[]]¶
Main Axis: Determines how to align the Responsive Grid divisions.
Note
The Ink Responsive Grid has a variety of values to represent the relationships of divisions within the grid. The easiest place to start? Try:
- Main axis: Row
- Justify content: Left
- Align items: Top
Row: Aligns divisions in a row.
Justify divisions: Determines how the row of grid divisions will justify along a left-right axis.
Note
Useful to locate the divisions within the grid when they have both maximum and minimum width set.
- Left (default): Divisions are justified with the left margin of the grid.
- Center: Divisions are justified in the center of the grid.
- Right: Divisions are justified with the right margin of the grid.
- Space Between: Divisions are evenly spaced within the grid, with the first division justified to the left margin and the last division justified to the right margin.
- Space Around: Divisions are evenly spaced within the grid. There is spacing between the first division and the left margin, and between the last division and the right margin.
- Stretch: Stretches the division’s contents to fit the division’s full width.
Align divisions: Determines where divisions sit within the grid, positioning them along a top-to-bottom axis.
- Top (default): Divisions are aligned with the top of the grid.
- Middle: Divisions are aligned along a center left-right axis of the grid.
- Bottom: Divisions are aligned with the bottom of the grid.
- Stretch: Stretches the division’s contents to fit the division’s full height.
Column: Stacks division on top of one another.
Justify divisions: Determines how the stacked grid divisions will justify along a top-to-bottom axis.
Note
Useful to locate the divisions within the grid when they have both maximum and minimum width set.
- Top (default): Divisions are justified along the top of the grid.
- Middle: Divisions are justified in the center of the grid.
- Bottom: Divisions are justified along the bottom of the grid.
- Space Between: Divisions are evenly spaced within the grid, with the first division justified to the top margin and the last division justified to the bottom margin.
- Space Around: Divisions are evenly spaced within the grid. There is spacing between the first division and the top margin, and between the last division and the bottom margin.
- Stretch: Stretches the division’s contents to fit the division’s full height.
Align divisions: Determines where divisions sit within the grid, positioning them along a left-right axis.
- Left (default): Divisions are aligned with the left margin of the grid.
- Center: Divisions are aligned along the center top-to-bottom axis of the grid.
- Right: Divisions are aligned with the right margin of the grid.
- Stretch: Stretches the division’s contents to fit the division’s full width.
Column gutter size (optional): The distance between divisions when they are displayed as columns, side-by-side. (Typically affects devices with larger screens, such as desktops.)
- None
- Extra Small
- Small
- Reduced
- Regular
- Increased
- Large
- Extra Large
- Huge
Row gutter size (optional): The distance between divisions when they are stacked as rows atop one another. (Typically affects smaller screen sizes or mobile devices.)
- None
- Extra Small
- Small
- Reduced
- Regular
- Increased
- Large
- Extra Large
- Huge
Full width: If checked, the rightmost and leftmost components will ignore margins and instead sit immediately adjacent to the right and left edges of the page (respectively).
Advanced tab [[]]¶
- Unique ID (optional): Skuid automatically generates an alphanumeric ID for the component; if preferred, give it a practical name.
Interactions tab [[]]¶
Styles tab [[]]¶
Display logic tab [[]]¶
Nested elements¶
Responsive Grid divisions¶
Click on any Division header text within the grid to access its properties:
General tab [[]]¶
Flex ratio: This sets the size of this division relative to other divisions. For example, if there are two divisions in a grid, and the flex ratio for each is 1, they will each take up ½ of the grid. If one has a flex ratio of 2, and the other has a flex ratio of 1, the first one occupies ⅔ of the grid, and the second one occupies ⅓ of it.
Minimum width: Sets a minimum width for the division. This governs division wrapping on smaller screens: when the minimum width is exceeded, the grid division will stack above or below other divisions. This can be specified using px, em, rem, %, vh, or vw measurements.
Note
- Em, %, vh, or vw are more responsive to screen size.
- Ensure the division’s minimum width is at least as wide as its contents.
Maximum width: Sets a maximum width for the division.This can be specified using px, em, rem, %, vh, or vw measurements.
Align self: Sets a separate alignment for the selected division.
Note
This setting supersedes the alignment set for all divisions in the Responsive Grid properties, Layout Tab.
- Top (default): Divisions are aligned with the top of the grid.
- Middle: Divisions are aligned along a center left-right axis of the grid.
- Bottom: Divisions are aligned with the bottom of the grid.
- Stretch: Stretches the division’s contents to fit the division’s full height.
Change order: Click to move this division left or right in the grid.
Unique ID (optional): Skuid automatically generates an alphanumeric ID for the grid division; if preferred, give it a practical name.
Tab Container [[]]¶
General tab [[]]¶
- Unique ID (optional): Skuid automatically generates an alphanumeric ID for the component; if preferred, give it a practical name.
- Remember active tab: If true, Skuid’s personalization framework will remember the last tab an end user was on and will automatically reopen that tab when the user returns to this page.
- Aria label: Add a label to be used by access technologies such as screen readers and conforms to Web Accessibility Initiative—Accessible Rich Internet Applications (WAI-ARIA) specifications. This property can be a specific string of text, the merge variables of one or more fields, or a combination of the two.
Note
If no Aria Label is specified, access technologies will use the Tab label.
Styles tab [[]]¶
Display logic tab [[]]¶
Nested elements¶
Tab properties¶
General tab [[]]¶
- Tab label: The text that appears as the tab’s title in the component. Defaults to “New Tab.”
- Icon (optional): A visual icon that will appear beside the tab label. Commonly used to guide users to relevant information more quickly. Click to open the library of available icons.
Advanced tab [[]]¶
- Tab panel unique Id (optional). Allows for a tab’s content panel to be reliably referenced via JavaScript or set via a URL hash, such as
apex/skuid_UI?page=AccountDetail#CasesTab.
Actions tab [[]]¶
Use these properties to add actions to individual tabs on the Tab Container.
- When first shown: Actions will only run the first time an end user selects this Tab on page load.
- Whenever rendered: Actions will run every time an end user selects this Tab.
Display logic tab [[]]¶
Tab Set [[]]¶
General tab [[]]¶
- Unique ID (optional): Skuid automatically generates an alphanumeric ID for the component; if preferred, give it a practical name.
- Remember active tab: If true, Skuid’s personalization framework will remember the last tab an end user was on and will automatically reopen that tab when the user returns to this page.
- Aria label: Add a label to be used by access technologies such as screen readers and conforms to Web Accessibility Initiative—Accessible Rich Internet Applications (WAI-ARIA) specifications. This property can be a specific string of text, the merge variables of one or more fields, or a combination of the two.
Note
If no Aria Label is specified, access technologies will use the Tab label.
Styles tab [[]]¶
Display logic tab [[]]¶
Nested elements¶
Tab properties¶
General tab [[]]¶
- Tab label: The text that appears as the tab’s title in the component. Defaults to “New Tab.”
- Icon (optional): A visual icon that will appear beside the tab label. Commonly used to guide users to relevant information more quickly. Click to open the library of available icons.
Advanced tab [[]]¶
- Tab panel unique Id (optional). Allows for a tab’s content panel to be reliably referenced via JavaScript or set via a URL hash, such as
apex/skuid_UI?page=AccountDetail#CasesTab.
Actions tab [[]]¶
Use these properties to add actions to individual tabs on the Tab Set.
- When first shown: Actions will only run the first time an end user selects this Tab on page load.
- Whenever rendered: Actions will run every time an end user selects this Tab.
Display logic tab [[]]¶
Wizard [[]]¶
General tab [[]]¶
Wizard layout direction: Controls how the wizard’s steps are displayed.
- Horizontal
- Vertical
Vertical layout on smaller screens: If checked, when Wizard Layout Direction is set to Horizontal, but the user’s screen is too narrow to display all the steps, the steps will stack vertically.
Hide step labels: If checked, Skuid does not display the clickable progress indicator labels that appear at the top of the Wizard component. Users must navigate the Wizard using the builder-defined Step buttons at the bottom of the wizard.
Note
This option is only available with horizontal Wizard Layout Direction.
Disable step buttons: If checked, disables the clickable progress indicator buttons. These buttons can then be conditionally enabled using display logic.
Unique ID (optional): Skuid automatically generates an alphanumeric ID for the component; if preferred, give it a practical name.
Styles tab [[]]¶
Display logic tab [[]]¶
Nested elements¶
Step properties¶
General tab [[]]¶
- Step ID: How the step is identified for button navigation.
- Step label: A plain language label that tells the user what the button is for and why they might want to click it.
- Align buttons: Determines the location of the step buttons within the Wizard. Options include:
- Left: All step buttons are clustered on the left.
- Right: All step buttons are clustered on the right.
- Center: All step buttons are centered.
- Separated: Step buttons are spaced out along the length of the Wizard.
Tooltip tab [[]]¶
A floating box that displays when the user hovers over a button, the tooltip provides guidance usage.
Text: The tooltip’s content.
Position: This field determines the alignment of the tooltip relative to the button:
- Top (default): Above the button.
- Bottom: below the button.
- Left: to the left of the button.
- Right: to the right of the button.
Note
The Position settings are contingent upon available space. For example, if the Button Set is at the top of the page, and the tooltip position is set to Top, the tooltip cannot display above the button: there’s not space. So it will display below the button.
Tooltip style:
- Dark (default): The tooltip box is a black.
- Light: The tooltip box is white, with a drop shadow.
Compact size?: Reduces the amount of padding around the text in the tooltip box.
Button properties¶
The properties available on Wizard buttons are the same as those for Button Set buttons.
Wrapper [[]]¶
Components: Data¶
Deck [[]]¶
File Upload [[]]¶
Filter Set [[]]¶
General tab [[]]¶
Model: Select the model that the filters within the Filter Set will affect.
Layout: This field will determine how filters are placed within the Filter Set container.
- Horizontal: Filters and the Reset appear as buttons arranged horizontally.
- Vertical: Filters are arranged vertically; each filter stretches to fill the horizontal area of the Filter Set. The Reset button is below the filters.
- Vertical with accordions: Filters are arranged vertically in accordion sections.
Reset button: Determines when the filter’s Reset button displays:
- Enable when filters activate: The Reset button is present but disabled on the Filter Set. It is enabled when the user interacts with the filter.
- Render when filters activate: The Reset button does not display on the Filter Set until the user interacts with the filter.
- Always hide: The Reset button is always hidden.
Note
This setting can be useful when there are only 1 or 2 filters in the Filter Set.
Apply search as you type: By default, the user must click the search icon or enter key to initiate the search. If Apply Search As You Type is checked, Skuid will initiate searches as the user types in search text.
Search tab [[]]¶
In this tab are properties that control whether or not you have a search box, and when search terms and conditions are applied.
Search properties [[]]¶
Show search box: If checked, Skuid displays a search box above the component.
Search method: Determines if a search will query the server and filter its data, or filter local data on the client.
Server (default): Returns search results from all data on the server.
Client: Returns search results from only the data that is currently loaded on the page. Large data sets may require lengthy time to filter. If end users commonly need to sort only the data they have loaded within the page—as opposed to every record on the server—this property may speed the filter process.
Warning
If the server contains a large data set not yet loaded into the page, but Search Method is set to Client, the filter may return incomplete results because it’s filtering incomplete data. This may result in unexpected omissions.
Tokenize search terms: If checked, each word typed into the search bar is “tokenized” — meaning each word is searched for individually. A tokenized search for “George Washington” returns any record with “George” and “Washington”. For example, “George Washington,” “George Michael Washington,” and “George is headed to Washington”. An untokenized search for “George Washington” returns only records with “George Washington” exactly.
Search box placeholder text: The text that appears in the search box before the end user starts a search. (The default is “Search.”)
Empty search behavior: Determines what happens when the search box is emptied.
Re-query for Model Data (default): The data displayed in the component returns to the state it was in when you first loaded the page.
Remove all Model Data: The data is removed from the component and its associated model (but not from the data object).
Note
Why do this? If you want to use a component to display the list of search results—handy when you have a lot of search results—you need to have an empty component each time you do a new search, so you can display the newly returned results in it. Without this property, the component’s model will be re-queried when the text is cleared from the search box.
Search icon display: Configures the search icon.
- Button (default): The search box includes a search button with an icon. End users initiate search by entering search text and clicking the button.
- Inset icon: The search box includes a search icon at the right side of the entry field. End users initiate search by entering search text and clicking the icon.
- None: No icon is included in the search box. End users initiate search by entering search text and pressing Enter on the keyboard.
Search icon: The icon used for the search button or search inset. Click the icon selector to choose the icon.
Search fields [[]]¶
Specifies which fields will be searched against from the component’s search bar.
Note
Depending on the data source used for the model attached to the component, this property may not be available.
Use SOSL to improve search performance (Salesforce data sources only): SOSL quickly can search multiple objects at a time within a single search query. SOSL does not directly search the database, but instead queries an index of Salesforce text fields. Individual search fields may not be added when this property is enabled.
Warning
Because the search is against the index, results are limited to what is present in the index, and will not include data that may have been recently updated in the database. The index updates very quickly, but expect a delay of up to 30 seconds between changes made to the database, and their appearance in the search results.
Note
SOSL can search Text fields (including Long Text fields), but not Picklist fields and Reference fields.
Fields to search: Sets which Types of fields to query with SOSL. The options are:
- Name Fields (default)
- All Text Fields
- Email Field
- Phone Fields
- SideBar Fields (Name, Phone, Email, External Ids)
Searches on Salesforce data sources can use one of two query languages: SOQL or SOSL. SOQL can only search one object at a time in a single query, but searches all searchable fields in that object in real-time.
Field: Skuid searches on searchable fields by default. Search can be narrowed to individual fields by clicking
Add new Search Field, and then using the field picker to select the field.Note
- (Salesforce data sources only) SOQL can search Picklist fields and Reference fields, but not Long Text fields.
- You can add multiple search fields.
Search operator: Select from the following logical operators:
- =
- starts with
- Contains
Skuid on Salesforce [[]]¶
By default, Salesforce Objects use SOQL. To ensure proper functionality, enable the Allow Search property on any Salesforce objects to be included in the search.
For more information on using these search options with Salesforce, check out Salesforce’s SOQL and SOSL Reference Guide.
Advanced tab [[]]¶
- Unique ID If you’ll be adding snippets, custom components, or other developer-related additions to your page, assign a specific DOM ID for your button set.
- Apply Icon (optional): The icon on the Apply button. Click the icon selector to choose the icon.
- Reset Icon (optional): The icon on the Reset button. Click the icon selector to choose the icon.
Styles tab [[]]¶
Style variant section [[]]¶
Spacing section [[]]¶
Layout section [[]]¶
Layout: Determines how to align the filters within the Filter Set.
When the Layout property in the Basic tab is set to Horizontal:
Justify items: Determines how the row of filters will justify along a left-right axis.
- Auto: Filters are justified using the browser’s default.
- Left: Filters are justified with the left margin of the Filter Set.
- Center: Filters are justified with the center of the Filter Set.
- Right: Filters are justified with the right margin of the Filter Set.
- Space between: Filters display spaced evenly across the Filter Set.
- Space around: Filters are evenly spaced within the Filter Set. There is spacing between the first filter and the left margin, and between the last filter and the right margin.
- Stretch: Stretches the filter’s contents to fit the filter’s full width.
Note
This feature is more visible when the Layout property is set to Vertical.
Align items: Determines where filters sit within the Filter Set along a top-to-bottom axis.
- Auto: Filters are aligned using the browser’s default.
- Top: Filters are aligned with the top of the Filter Set.
- Middle: Divisions are aligned along a center left-right axis of the Filter Set.
- Bottom: Filters are aligned with the bottom of the Filter Set.
When the Layout property in the Basic tab is set to Vertical or Vertical with Accordions:
Justify items: Determines how the row of filters will justify along a top-to-bottom axis.
- Auto: Filters are justified using the browser’s default.
- Top: Filters are justified with the top margin of the Filter Set.
- Middle: Filters are justified with the center of the Filter Set.
- Bottom: Filters are justified with the bottom margin of the Filter Set.
- Space between: Filters display spaced evenly across the Filter Set.
- Space around: Filters are evenly spaced within the Filter Set. There is spacing between the first filter and the top margin, and between the last filter and the bottom margin.
- Stretch: Stretches the filter’s contents to fit the filter’s full width.
Align items: Determines where filters sit within the Filter Set along a top-to-bottom axis.
- Auto: Filters are aligned using the browser’s default.
- Left: Filters are aligned with the left margin of the Filter Set.
- Center: Divisions are aligned along the center axis of the Filter Set.
- Right: Filters are aligned with the right margin of the Filter Set.
Display logic tab [[]]¶
Nested elements¶
Filter properties¶
Properties for the individual filters. Skuid includes the following automatic filters:
- Date range: Filters a table to display items that fall within a selected date range.
- Numeric range: Filters a table to display items that fall within the designated numeric range.
- Multi-select option: Select more than one filter criteria; when activated, displays items that meet those criteria.
- Select option: Filters a table to display items that meet a specified filter criteria.
- Toggle: Toggle a filter on or off; when activated, displays only items that meet the filter criteria; click the toggle filter again to display all items.
Each filter type includes the Filter method property, which offers two options:
Client: Returns filter results from only the data that is currently loaded on the page. Large data sets may require lengthy time to filter. If users commonly need to sort only the data they have loaded within the page—as opposed to every record on the server—this property may speed the filter process.
Warning
If the server contains a large data set not yet loaded into the page, but Filter Method is set to Client, the filter results will be only a subset of the complete data set. This may result in unexpected omissions.
Server: (Default) Returns filter results from all data on the server.
Additional properties for the individual filters (by Filter type):
General tab [[]]¶
Pick options and conditions: Automatically
Skuid uses the chosen Date/Datetime field to filter.
- Date/datetime field: Select the field (that returns a date) to filter on from the picklist. The Filter button will drop down a set of entry fields for start date and end date.
- Show label above filter:
- Yes, use field’s label
- Yes, use custom label
- No
- Filter label: Enter the label for the filter button.
- Remember last-selected filter value: When a user returns to this page, Skuid will remember their previously-selected options.
Pick options and conditions: Manually
Skuid requires a condition to use as the filter.
- Filter label: Enter the label for the filter button.
- (Start of range) Model condition to affect and (End of range) Model condition to affect: Appears when Manually is selected. For Data Range and Numeric Range, use model conditions to limit the Start value and End value for the ranges.
- Remember last-selected filter value: When a user returns to this page, Skuid will remember their previously-selected options.
Pick options and conditions: Automatically
Skuid uses the chosen Numeric field as the filter.
- Numeric field: Select the field (that returns a number) to filter on from the picklist. The Filter button will drop down a set of entry fields for minimum and maximum amount.
- Show label above filter:
- Yes, use field’s label
- Yes, use custom label
- No
- Filter label: Enter the label for the filter button.
- Remember last-selected filter value: When a user returns to this page, Skuid will remember their previously-selected options.
Pick options and conditions: Manually
Skuid requires a condition to use as the filter.
- Filter label: Enter the label for the filter button.
- (Start of range) Model condition to affect and (End of range) Model condition to affect: Appears when Manually is selected. For Data Range and Numeric Range, use model conditions to limit the Start value and End value for the ranges.
- Remember last-selected filter value: When a user returns to this page, Skuid will remember their previously-selected options.
Pick options and conditions: Automatically
Note
Automatically generating the list of filter options is the best choice in most situations.
- Filter field: Select the field to filter on from the picklist. This will populate the Filter dropdown list with filter options.
- Show label above filter:
- Yes, use field’s label
- Yes, use custom label
- No
- Filter label: Enter the label for the filter button.
- Display as:
- Dropdown
- Checkboxes
- Remember last-selected filter value: When a user returns to this page, Skuid will remember their previously-selected options.
Pick options and conditions: Manually
Note
Manually generating the list of filter options can be more complicated. However for builders working with multiple or complex model conditions, or those desiring a higher degree of granularity, manually creating the option list can be a useful alternative.
- Filter label: Enter the label for the filter button.
- Model condition to affect: Select the model condition used to limit the number of displayed values for a filtered field.
- Display as:
- Dropdown
- Checkboxes
- Remember last-selected filter value: When a user returns to this page, Skuid will remember their previously-selected options.
Pick options and conditions: Automatically
Note
Automatically generating the list of filter options is the best choice in most situations.
Displays all possible options for a filter:
Filter field: Select the field to filter on from the picklist. This will populate the Filter dropdown list with filter options.
Show label above filter:
- Yes, use field’s label
- Yes, use custom label
- No
Filter label: Enter the label for the filter button.
“None Selected” option text: Enter the text displayed on the Filter button if no filter selections have been made.
Display as:
Dropdown
Checkboxes
Radio
- Option limit: Sets limit for the number values shown.
Remember last-selected filter value: When a user returns to this page, Skuid will remember their previously-selected options.
Pick options and conditions: Manually
Note
Manually generating the list of filter options can be more complicated. However for builders working with multiple or complex model conditions, or those desiring a higher degree of granularity, manually creating the option list can be a useful alternative.
Uses a condition to limit the number of choosable options for the filter:
Filter label: Enter the label for the filter button.
Model condition to affect: Select the model condition used to limit the number of displayed values for a filtered field.
Create “None Selected” option: If checked, Skuid adds a “none selected” option to the filter options list.
“None Selected” option text: Enter the text displayed on the Filter button if no filter selections have been made.
Display as:
Dropdown
Checkboxes
Radio
- Option Limit: Sets limit for the number values shown.
Remember last-selected filter value: When a user returns to this page, Skuid will remember their previously-selected options.
- Filter label: Enter the label for the filter button.
- Conditions to toggle: Allows the selection of condition(s) to toggle from a list of available conditions on the model.
- Remember last-selected filter value: When a user returns to this page, Skuid will remember their previously-selected options.
Sources tab [[]]¶
Choosing Pick options and condition Manually with Select option as the Filter Type activates the Sources feature, which allows you to control where the list of options that are listed on the filter are sourced from.
Click
Add option source, and then configure the Source Type:Manual: Manually create the list of filter options. Choosing this property activates the Option feature.
Click
Add option on the filter source, then configure. Drag and drop manual filter source entries to reorder them. Each option added has the following properties:What condition(s) will this option affect?:
Affect the default condition: The option selected is used as the value in the model’s default condition.
- Value: The data to be passed from this option item to the model condition. For example, if the value is set as 42 and the end user selects this option from the list, then the value of 42 is passed into the model condition.
Affect other condition(s): The option selected is used as the value in other conditions on the model, but not on the default condition.
Choosing this property activates the Effect feature.
Click
Add effect on the filter option, then configure:Action: Activate or deactivate a model condition. This action works in relation to the condition’s state (Always on, Filterable default on, Filterable default off, Always off).
- Activate and set value: Activate and set the condition to a specific value.
- Activate: Activate the condition without setting a value. Typically used for conditions with Always off or Filterable default off states.
- De-activate: Deactivate the condition.
Model condition: The model condition to interact with.
Value: The value to set the condition to when using the Activate and set value option.
- Label: A user-friendly label for option.
Rows in a model: Use the values in the rows of a model as the source for the filter’s options. Use this feature to create a dynamic picklist that can update with user input.
Why use this? When accessing the values from a selected model using Pick options and conditions > Automatically, Skuid only lists values that have records associated with them; “empty” values (values with no associated records) do not display on the dropdown. To ensure that all values—even newly-added—are included in the list of filter options, use Pick options and conditions > Manually and select this property for the Source Type.
Note
Filter values display according to the default order provided in the model. To change that order: in the model used to provide the filter source, include the API name (StageName, not Stage) for the field in the Fields to order records by property followed by either ASC (Z to A) or DESC (A to Z); for example StageName DESC.
Merge source: The model which contains the field employed in the default condition for this filter.
Option label template: The label for the filter option. This property accepts typed text or merge syntax (in triple brackets).
Which conditions will this source’s options affect?:
- Just the default condition
- Default condition and others
Value to inject into the default condition: This defaults to {{Id}}, but can be changed to any field in the model associated with the condition.
Warning
Be sure to include the double curly brackets to designate the value as a merge variable; if missing, the condition may misread the merge syntax and throw an error.
Picklist options for condition’s field: Use a picklist field as the source for the filter’s options. If there is a specific requirement to Pick options and conditions for the filter manually, this property replicates the results of using Pick options and conditions > Automatically: employing the field designated in the condition as the source of the filter options.
- Label prefix (optional): Text inserted before the filter’s label. For example, if the filter is on the Status field (with categories such as New, Closed, Pending, etc.), adding a prefix of
Status:
results in Option labels such asStatus: New; Status: Closed; Status: Pending
. - Label suffix (optional): Similar to Label Suffix, text to be inserted after the filter’s label. If the filter is on the Status field (with categories such as New, Closed, Pending, etc.), adding a suffix of Status results in Option labels such as New Status; Closed Statis; Pending Status.
- Label prefix (optional): Text inserted before the filter’s label. For example, if the filter is on the Status field (with categories such as New, Closed, Pending, etc.), adding a prefix of
Custom source (Snippet): Use a JavaScript snippet as the source for the filter’s options. The filter options are created from objects within the snippet. To learn more, see Use a JavaScript Snippet as a Filter Option Source.
- Snippet name: The name of the snippet that contains the list of filter option text.
Styles tab [[]]¶
Layout:
Align self: (vertically) ability to override container’s value (grid divisions do this)
- Auto
- Top
- Middle
- Bottom
Flex ratio: This sets the size of this filter relative to other filters in the Filter Set. For example, if there are two filters in a Filter Set, and the flex ratio for each is 1, they will each take up 1/2 of the Filter Set. If one has a flex ratio of 2, and the other has a flex ratio of 1, the first one occupies 2/3 of the grid, and the second one occupies 1/3 of it.
Minimum width: Sets a minimum width for the filters within the Filter Set. This governs wrapping on smaller screens: when the minimum width is exceeded, the filter will stack above or below other filters. This can be specified using px, em, rem, %, vh, or vw measurements.
Maximum width: Sets a maximum width for the division. This can be specified using px, em, rem, %, vh, or vw measurements.
Display logic tab [[]]¶
Form [[]]¶
General tab [[]]¶
Model: The model that contains the fields the Form displays. Revisions made in the Form affect the model selected here.
Default mode: Select the default record interaction for end users. Options are:
- Read with inline-edit (default): All fields will appear in read mode but can be edited on click if a user has permission to do so.
- Edit: All available fields appear in edit mode on page load.
Note
Forms are most easily read in Edit mode.
- Read-only: All fields appear in read-only mode regardless of user permissions.
Show save and cancel buttons: If true, Save/Cancel options will appear allowing end users to save changes made within the Form. If false, the Save/Cancel buttons will not appear above the component.
Display tab [[]]¶
Field layout section [[]]¶
Label position:
Top: The field’s label displays above the field.
Left: The field’s label displays to the left of the field.
- Label minimum width and Label maximum width: Sets the lower and upper size limits for the label.
- Label flex ratio: Sets the size of this label relative to the input field’s width.
- Input field/text minimum width and Input field/text maximum width: Sets the lower and upper size limits for the input field.
- Input field/text flex ratio: Sets the size of this input field relative to the label’s width.
Errors section [[]]¶
- Show errors inline: Display messages next to the field
- Show inline error only on hover: Only displays the message inline if the end user hovers over the field.
Advanced section [[]]¶
- Unique ID (optional): Skuid automatically generates an alphanumeric ID for the component; if preferred, give it a practical name.
Styles tab [[]]¶
Display logic tab [[]]¶
Nested elements¶
Basic tab [[]]¶
- Show section heading: Toggle section title text at the top of a section.
- Section heading: Update text that appears in section header.
Display logic tab [[]]¶
Field properties¶
Once fields are added to the Table component, each field has a specific set of properties. These properties vary, depending upon the field type. Click on the field within the table to reveal and edit its properties.
Template fields [[]]¶
Template fields—much like the Template component—provide a way to display arbitrary text or HTML alongside field data. Other fields may be included within a template field through the use of merge syntax.
A basic template field for a full name may look like this:
{{FirstName}} {{LastName}}
It is also possible to update any fields included within a template field at runtime by double-clicking the Template field within the component.
For additional information, see the Template component topic.
Header [[]]¶
General tab [[]]¶
- Model: The model the Header is connected to, providing fields and context to any merge variables used in the Title and Subtitle properties.
- Title: The text to be displayed as a top-level heading within the component. This property can be a specific string of text, the merge variables of one or more fields chosen with the field picker, or a combination of the two.
- Subtitle: The text to be displayed as a second-level heading above the title. This property can be a specific string of text, the merge variables of one or more fields chosen with the field picker, or a combination of the two.
- Add border separator: Adds a thin rule at the bottom of the component to visually separate it from the component that follows.
- Heading level: Indicates the hierarchical position for this Header component relative to others on the page, with 1 being the highest level. In effect, this wraps the Header’s title in HTML tags. Heading Level 1 = <h1> tags; Heading Level 2 = <h2> tags, and so on. This helps assistive technologies correctly navigate the page using the Header components as outline levels.
Note
Changing this property does not change the visual appearance of the component. Visual styles are set in the Design System.
Advanced tab [[]]¶
- Unique ID (optional): Skuid automatically generates an alphanumeric ID for the component; if preferred, give it a practical name.
Styles tab [[]]¶
Style variant: The font sizing for Titles and Subtitles is set in the theme using the Design System Studio. To adjust sizes in a specific instance, use the Style Variant. Options are:
- Default
- Small
- Medium
- Large
- Extra Large
- Huge
- Gigantic
Note
These sizes are relative to the baseline determined by the Design System settings.
Display logic tab [[]]¶
Nested elements¶
Button properties [[]]¶
When you add buttons to the Header component, these buttons have their own properties. All Header button properties are the same as those for Ink Button Set buttons.
Image [[]]¶
List [[]]¶
When you add a List to the page, there are several properties you can modify:
General tab [[]]¶
- Model: The List will draw and display data from this model.
- Title: The title that displays above the List. (If left blank, the List does not have a title.)
Display tab [[]]¶
Pagination section [[]]¶
- Visible rows: Controls how many rows are visible in the table, or you can select “Show All.” The default setting is 10 rows; this choice is displayed at the bottom of the table and can be overridden by the end users, who can also navigate through the “pages” of records.
Note
Searches, sorting, and filters will query the entire set of records—even the rows that haven’t been loaded into the List yet.
- Show page size dropdown: Checked by default, this displays a page size indicator at the bottom of the list. This indicator allows users to choose to display more or fewer records per page, overriding the Visible Rows setting.
- Reset pagination on query: Click to reset to the first page after any edits or queries to the model.
Advanced section [[]]¶
- Unique ID (optional): Skuid automatically generates an alphanumeric ID for the component; if preferred, give it a practical name.
Other section [[]]¶
Row actions on left: By default, Row Actions are displayed on the right. If checked, they will be displayed on the left.
Show “Load more” button: If the Max # of records property on the model is set to a limiting number, checking this allows the end user to load additional records.
Show header: If checked, the List header will display.
Show footer: If checked, the List footer will display.
Note
Hide Header/Hide Footer supersedes any settings for individual elements in the Header or Footer. For example, if Show Search Box is checked in the Filters and Search tab, but Hide Header is also checked, the search box (which sits within the header) will not display because the header is hidden.
Search tab [[]]¶
In this tab are properties that control whether or not you have a search box, and when search terms and conditions are applied.
Search properties [[]]¶
Show search box: If checked, Skuid displays a search box above the component.
Search method: Determines if a search will query the server and filter its data, or filter local data on the client.
Server (default): Returns search results from all data on the server.
Client: Returns search results from only the data that is currently loaded on the page. Large data sets may require lengthy time to filter. If end users commonly need to sort only the data they have loaded within the page—as opposed to every record on the server—this property may speed the filter process.
Warning
If the server contains a large data set not yet loaded into the page, but Search Method is set to Client, the filter may return incomplete results because it’s filtering incomplete data. This may result in unexpected omissions.
Tokenize search terms: If checked, each word typed into the search bar is “tokenized” — meaning each word is searched for individually. A tokenized search for “George Washington” returns any record with “George” and “Washington”. For example, “George Washington,” “George Michael Washington,” and “George is headed to Washington”. An untokenized search for “George Washington” returns only records with “George Washington” exactly.
Search box placeholder text: The text that appears in the search box before the end user starts a search. (The default is “Search.”)
Empty search behavior: Determines what happens when the search box is emptied.
Re-query for Model Data (default): The data displayed in the component returns to the state it was in when you first loaded the page.
Remove all Model Data: The data is removed from the component and its associated model (but not from the data object).
Note
Why do this? If you want to use a component to display the list of search results—handy when you have a lot of search results—you need to have an empty component each time you do a new search, so you can display the newly returned results in it. Without this property, the component’s model will be re-queried when the text is cleared from the search box.
Search fields [[]]¶
Specifies which fields will be searched against from the component’s search bar.
Note
Depending on the data source used for the model attached to the component, this property may not be available.
Use SOSL to improve search performance (Salesforce data sources only): SOSL quickly can search multiple objects at a time within a single search query. SOSL does not directly search the database, but instead queries an index of Salesforce text fields. Individual search fields may not be added when this property is enabled.
Warning
Because the search is against the index, results are limited to what is present in the index, and will not include data that may have been recently updated in the database. The index updates very quickly, but expect a delay of up to 30 seconds between changes made to the database, and their appearance in the search results.
Note
SOSL can search Text fields (including Long Text fields), but not Picklist fields and Reference fields.
Fields to search: Sets which Types of fields to query with SOSL. The options are:
- Name Fields (default)
- All Text Fields
- Email Field
- Phone Fields
- SideBar Fields (Name, Phone, Email, External Ids)
Searches on Salesforce data sources can use one of two query languages: SOQL or SOSL. SOQL can only search one object at a time in a single query, but searches all searchable fields in that object in real-time.
Field: Skuid searches on searchable fields by default. Search can be narrowed to individual fields by clicking
Add new Search Field, and then using the field picker to select the field.Note
- (Salesforce data sources only) SOQL can search Picklist fields and Reference fields, but not Long Text fields.
- You can add multiple search fields.
Search operator: Select from the following logical operators:
- =
- starts with
- Contains
Skuid on Salesforce [[]]¶
By default, Salesforce Objects use SOQL. To ensure proper functionality, enable the Allow Search property on any Salesforce objects to be included in the search.
For more information on using these search options with Salesforce, check out Salesforce’s SOQL and SOSL Reference Guide.
Interactions tab [[]]¶
Note
Using a Page Include with your List? There’s a specific action for that: Run Component > Page Include.
- Skuid page: The name of the associated page.
- Page Include Component Id: Click to select the Page Include from the list. (If you have given the Page Include a unique name, it will appear here). When a Page Include is selected, a flashing yellow outline will indicate the chosen item within the canvas.
- Query String: Use id={{Id}}. This tells the Page Include to load the record whose ID matches the ID of the record the end user clicked.
Styles tab [[]]¶
Display logic tab [[]]¶
Nested elements¶
When you add items to a List, there are several properties you can modify:
Column Properties [[]]¶
Click the item (Field, Template, Avatar, Icon, or Image) element to configure the following options:
- Width behavior: Determines the way items fill the List.
- Fill: Allots a percentage of the space to the selected item, based on the fill ratio.
- Fill Ratio: This sets the amount of space for this item relative to other items in the List. For example, a flex ratio of 2 will be double the width of an item with a flex ratio of 1.
- Fixed: Allots a fixed amount of the space to the selected item, based on the Width settings.
- Width
- Extra Small
- Small (default)
- Medium
- Large
- Extra Large
- Custom
- Custom width amount: This can be specified using px, em, %, vh, or vw measurements.
- Width
- Fill: Allots a percentage of the space to the selected item, based on the fill ratio.
Item Properties [[]]¶
Click the item (Field, Template) element to configure the following options:
Type:
- Field: Uses the field Id, i.e. {{Name}}
- Field label: Uses the plain language field name, ie., Account Name.
- Template: Opens the Template property field.
- Template: The fields (selected using the field picker) to display in the queue.
Display style override: By default, any additional fields added to an item use the default text styling. To override that, select one of the following additional style options (all of which are configured in the Design System Studio)
- None
- Style 1
- Style 2
- Style 3
Field: The field to use for the list item. Select from the picklist.
Click the item (Avatar, Icon, or Image) element to configure the following options:
Style variant: The format of the Avatar
- Default (This is set in the Design System Studio)
- Circular
- Square
Image URL: The URL for the image to be used as the Avatar. Or, pick an Image field from the picklist.
Icon: The image to be used as the icon. Select from the picklist.
Alternate text: Add descriptive text about the image that can be used by access/assistive technologies such as screen readers and conforms to Web Accessibility Initiative—Accessible Rich Internet Applications (WAI-ARIA) specifications. This property can be a specific string of text, the merge variables of one or more fields, or a combination of the two. Alt text also increases a search engine’s ability to index the image.
Note
If no Alternative Text is specified, access/assistive technologies will either ignore the image, or (in some cases) speak a generic label, such as “Image displayed.”
Size: The size of the Avatar or Icon.
- X-Small
- Small
- Medium
- Large
Fallback type: An alternative if there is not an Avatar available.
- Text: Replacement text for the Avatar.
- Fallback text: The text to be displayed instead of the Avatar.
- Icon: Replacement text for the Avatar.
- Fallback icon: The icon to be displayed instead of the Avatar.
- Text: Replacement text for the Avatar.
Drawer properties [[]]¶
General tab
Show drawer icon: Determines whether or not to display an icon next to the record. If unchecked, the drawer can be opened and closed by configuring a global action (in a Table component) or row action (in a Table or List component) to run the Open/Close A Drawer action.
Icon: Click the icon picker to select a different icon.
Configure drawer: Opens the drawer configuration modal.
Before load actions
Before Load Actions refers to actions used before a drawer is loaded. Generally, these actions are used to activate and set the values of model conditions, and to query models to ensure that the contextually-relevant data will display in the drawer.
For more information, see Add Nested Rows to your Table with Drawers
Message Area [[]]¶
General tab [[]]¶
- Model:
- None: Select this to add message block content without referencing context or using merge syntax.
- [Specific models]: All models within the page will be listed as options. To utilize context—for example, to reference a particular field—select a model.
Advanced tab [[]]¶
- Unique ID Skuid automatically generates an alphanumeric ID for the component; if preferred, give it a practical name.
Styles tab [[]]¶
Display logic tab [[]]¶
Nested elements¶
Message Block properties¶
General tab [[]]¶
- Title: Determines the bold text at the top of a message block. Not compatible with merge syntax.
- Description: Determines the full message, beneath the title, within the message block. Compatible with merge syntax, which may utilize context if a model is set on the Message Area component.
- Icon: Determines which icon is displayed beside the message block’s title and description. Defaults to an Information icon.
- Show close icon: Determines whether or not a close icon is displayed at runtime—allowing end users to dismiss message blocks within the component. If unchecked, the only way to dismiss the message block is via the Clear Message Blocks component action. Unchecked by default.
Advanced tab [[]]¶
- Unique ID Skuid automatically generates an alphanumeric ID for the component; if preferred, give it a practical name.
Styles tab [[]]¶
Context tab [[]]¶
Context condition options available.
Search [[]]¶
Table [[]]¶
General tab [[]]¶
Model: The model the Table will display data from.
Note
When you have multiple models, make sure you select the correct one!
Default mode:
- Read with inline-editing (default): Displays records in read mode on page load. End users can click Edit to convert to Edit mode.
- Edit: Records display in edit mode on page load; end users can toggle individual records to read mode by clicking Edit. Edit mode is best used for new, clone, and edit pages where you want all table rows open for editing.
- Read-only: Records display in read mode and cannot be edited.
Note
Skuid works with your data source’s security settings so users will not be able to edit records they don’t have permission to edit (even if the table is set to Edit mode). While you should not use this as a security measure, setting the Default Mode to Read-Only ensures that the end user can not edit the Table’s content on the page.
Allow Users to Sort by Column: Check this box to display buttons that allow end users to sort the table by this column’s values, both ascending and descending. (Checked by default.)
Note
Columns with sorting allowed have clickable triangles: up-pointed triangles sort the column in Ascending (Z to A) order; down-pointed triangles sort the column in Descending (A to Z) order.
Warning
To retain record cohesion, sorting an individual column simultaneously reorders the rest of the table. For this reason, sorting should be used judiciously. It is also recommended not to use more than one sorted column per table.
Sort columns client-side: If a field on a table has Allow sorting checked in the Field properties, additionally checking Sort Columns client-side means that Skuid will only sort the column field data that is currently loaded on the page. If end users commonly need to sort only the data they have loaded within the page—as opposed to every record on the server—this property may speed the filter process.
Warning
If the server contains a large data set not yet loaded into the page, but Sort columns client-side is set to Client, the data in the column will represent only a subset of the complete data set. This may result in unexpected omissions.
Enable export: Check to display the Export table data option in the Export properties.
More actions dialog, allowing end users to export the entire table (or selected rows) as a spreadsheet. See
Warning
Data export is not supported when using the Salesforce Mobile app.
- Show save and cancel buttons: Check to display the Save and Cancel buttons above the table. (Checked by default.)
- Table title: The title that displays above the Table. (If left blank, the Table does not have a title.)
Search tab [[]]¶
In this tab are properties that control whether or not you have a search box, and when search terms and conditions are applied.
Search properties [[]]¶
Show search box: If checked, Skuid displays a search box above the component.
Search method: Determines if a search will query the server and filter its data, or filter local data on the client.
Server (default): Returns search results from all data on the server.
Client: Returns search results from only the data that is currently loaded on the page. Large data sets may require lengthy time to filter. If end users commonly need to sort only the data they have loaded within the page—as opposed to every record on the server—this property may speed the filter process.
Warning
If the server contains a large data set not yet loaded into the page, but Search Method is set to Client, the filter may return incomplete results because it’s filtering incomplete data. This may result in unexpected omissions.
Tokenize search terms: If checked, each word typed into the search bar is “tokenized” — meaning each word is searched for individually. A tokenized search for “George Washington” returns any record with “George” and “Washington”. For example, “George Washington,” “George Michael Washington,” and “George is headed to Washington”. An untokenized search for “George Washington” returns only records with “George Washington” exactly.
Search box placeholder text: The text that appears in the search box before the end user starts a search. (The default is “Search.”)
Empty search behavior: Determines what happens when the search box is emptied.
Re-query for Model Data (default): The data displayed in the component returns to the state it was in when you first loaded the page.
Remove all Model Data: The data is removed from the component and its associated model (but not from the data object).
Note
Why do this? If you want to use a component to display the list of search results—handy when you have a lot of search results—you need to have an empty component each time you do a new search, so you can display the newly returned results in it. Without this property, the component’s model will be re-queried when the text is cleared from the search box.
Search fields [[]]¶
Specifies which fields will be searched against from the component’s search bar.
Note
Depending on the data source used for the model attached to the component, this property may not be available.
Use SOSL to improve search performance (Salesforce data sources only): SOSL quickly can search multiple objects at a time within a single search query. SOSL does not directly search the database, but instead queries an index of Salesforce text fields. Individual search fields may not be added when this property is enabled.
Warning
Because the search is against the index, results are limited to what is present in the index, and will not include data that may have been recently updated in the database. The index updates very quickly, but expect a delay of up to 30 seconds between changes made to the database, and their appearance in the search results.
Note
SOSL can search Text fields (including Long Text fields), but not Picklist fields and Reference fields.
Fields to search: Sets which Types of fields to query with SOSL. The options are:
- Name Fields (default)
- All Text Fields
- Email Field
- Phone Fields
- SideBar Fields (Name, Phone, Email, External Ids)
Searches on Salesforce data sources can use one of two query languages: SOQL or SOSL. SOQL can only search one object at a time in a single query, but searches all searchable fields in that object in real-time.
Field: Skuid searches on searchable fields by default. Search can be narrowed to individual fields by clicking
Add new Search Field, and then using the field picker to select the field.Note
- (Salesforce data sources only) SOQL can search Picklist fields and Reference fields, but not Long Text fields.
- You can add multiple search fields.
Search operator: Select from the following logical operators:
- =
- starts with
- Contains
Skuid on Salesforce [[]]¶
By default, Salesforce Objects use SOQL. To ensure proper functionality, enable the Allow Search property on any Salesforce objects to be included in the search.
For more information on using these search options with Salesforce, check out Salesforce’s SOQL and SOSL Reference Guide.
Display tab [[]]¶
Pagination section [[]]¶
Visible rows: Controls how many rows are visible in the table, or you can select “Show All.” The default setting is 10 rows; this choice is displayed at the bottom of the table and can be overridden by the end users, who can also navigate through the “pages” of records.
Note
Searches, sorting, and filters will query the entire set of records—even the rows that haven’t been loaded into the table yet.
Show page size dropdown: Checked by default, this displays a page size indicator at the bottom of the list. This indicator allows end users to choose to display more or fewer records per page, overriding the Visible Rows setting.
Always reset pagination after save or query: Click to reset to the first page after any edits or queries to the model.
Table height section [[]]¶
Height Strategy: This sets the height for the Table component.
Fit to content: This sizes the Table component.
Max Height (optional): The maximum height of the Table component. Options are:
None
Short
Medium
Tall
Custom: Uses a custom height.
- Custom Height: The height of the table, using a number and a sizing unit.
Min Height (optional): The minimum height of the Table. component. Options are:
None
Short
Medium
Tall
Custom: Uses a custom height.
- Custom Height: The height of the table, using a number and a sizing unit.
Fixed height: Sets an absolute height for the Table.
Height:
Fit to Content
Short
Medium
Tall
Custom: Uses a custom height.
- Custom Height: The height of the table, using a number and a sizing unit
Row height section [[]]¶
Row height strategy:
Fixed height: Sets an absolute height for rows in the table.
Height: Sets the height of the table.
Default: Uses the default row height defined in the Design System Studio.
Custom: Uses a custom row height.
- Custom Height: The height of the row, using a number and a sizing unit.
Cell overflow: Determines how content that overflows the cell is handled.
- No scroll: A cell with content that overflows the cell height does not include a scroll bar; overflow content is only accessible to the user if they choose to edit the cell.
- Scroll: A cell with content that overflows the cell height includes a scroll bar.
Fit to content: Sizes the height to fit the content.
Min height: The minimum height of the row, using a number and a sizing unit.
Max height: The maximum height of the row, using a number and a sizing unit.
Cell overflow:
- No scroll: When Max Height is set, a cell with content that overflows the set height does not include a scroll bar; overflow content is only accessible to the user if they choose to edit the cell.
- Scroll: When Max Height is set, a cell with content that overflows the set height includes a scroll bar.
Drawers section [[]]¶
- Enable drawers: When checked, Skuid adds a > (Left Arrow) at the head of the row of fields on the table. Click this arrow—or click Configure Drawer—to open the Drawer modal.
Configuration section [[]]¶
Allow users to reorder columns: If checked, allows end users to reorganize their tables in the runtime page by dragging and dropping the column headers to new locations. (Checked by default.)
Allow column hiding: Check to allow end users to choose whether to show or hide this specific column using the Table Settings dialog.
- More actions button icon: The icon that opens the More Actions dialog, allowing the end user to select Configure table or Export table data. Click the icon selector to choose the icon.
Set number of frozen columns: If you will have many columns in the Table, it can be useful to freeze 1 (or more) of the columns on the left side of the table. Users can scroll to the right to see additional columns that may not fit on screen, while still seeing the important data in the initial column(s). This property is blank by default, meaning that all columns (except the row actions and drawer icon columns) are not frozen.
Note
If Allow users to reorder columns is checked, end users can move columns into and out of the frozen zone. The number of frozen columns remains the same: a column moved in replaces one that was already in the frozen zone. That column moves outside of the frozen zone.
Allow users to freeze columns: Indicates the options for allowing the user to adjust the number of frozen columns in runtime.
Never: Users cannot adjust frozen columns
Using drag and drop: Users adjust frozen columns by hovering over the thicker column line until a colored bar displays, then moving that bar to the right side of the last column they want to freeze.
Note
The thicker column line will be on the right side of the first column—or on the right side of the last column set as frozen in the Set Number of Frozen Columns property (above).
Via Table settings modal: Users set the number of columns to freeze using the Number of Columns to Freeze option in the
Table Settings modal.Either by drag and drop or via Table settings: Users adjust columns using either the drag and drop method, or via the
Table Settings modal.
Note
Allow users to freeze columns helps end users navigate tables with extensive columns. Using this feature with drawers can produce a confusing user experience.
Errors section [[]]¶
- Show errors inline: Choose whether error messages appear inline (next to the field).
Advanced section [[]]¶
- Unique ID (optional): Skuid automatically generates an alphanumeric ID for the component; if preferred, give it a practical name.
- Enable adaptive columns: If checked, columns will adapt to the size of the content.
- Save icon (optional): The icon on the Save button. Click the icon selector to choose the icon.
- Cancel icon (optional): The icon on the Cancel button. Click the icon selector to choose the icon.
Other section [[]]¶
Row actions on left: By default, Row Actions are displayed on the right.If checked, they will be displayed on the left.
Show row numbers: If checked, each row is numbered, with the digits displayed in the far left column
Hide header: If checked, the Table header does not display.
Hide footer: If checked, the Table footer does not display.
Note
Hide header/Hide footer supersedes any settings for individual elements in the Header or Footer. For example, if Show Save/Cancel is checked—which displays the Save and Cancel buttons—but Hide Header is also checked, the Save and Cancel buttons (which sit within the header) will not display because the header is hidden.
Export tab [[]]¶
Export properties allow end users to configure and customize the data they’d like to export into a CSV file.
Warning
Data export is not supported when using the Salesforce Mobile app.
Export Options [[]]¶
Note
These properties only display if the Enable export is checked and the end user clicks Export options in the footer of the Table component.
Use table columns as export columns: If checked, the Table will export all columns added to the Table. If unchecked, Export Columns is displayed in the Properties Pane allowing users to add new columns and customize which fields are exported.
Note
Checking Allow Users to Show/Hide Column on a field’s properties will not affect which columns are exported. If users hide columns within a Table, their export will still include all columns within the component.
Append row ID column: If checked, a column will be added to the export which contains the ID of each exported row.
Attempt to load in all records before export: If checked, Skuid will load every available record before exporting.
Warning
Some data sources may limit how many records are returned in one call. If a call tries to return records that exceed a data source’s stated limit, an error will be returned and the export will fail.
Custom file name: If set, the value of this field will be used as custom name for the exported CSV file.
Export Columns [[]]¶
These properties allow end users to configure and customize the columns they’d like to export into a CSV file.
Note
These properties only display if Use Table Columns as Export Columns is unchecked, a user has added at least one column, and the new column added under Export Columns is selected.
- Column type: The type of column used in the export:
- Field: This option allows you to select a single field for export. Unselected columns will not be exported.
- Field: The specific model field to export, selectable from picklist populated with fields from the connected model.
- Header type: Determines what column header text is displayed in the exported CSV:
- Use field label: If checked, the exported CSV will display the field’s Label metadata, which is often a less-technical, human-readable name. For example: Account Name or Employees
- Use field API name: If checked, the exported CSV will display the field API name, which is often used by systems for data import or other backend processes. For example: Name or NumberOfEmployees.
- Custom label: If checked, the exported CSV will display a custom label instead of any associated label or API name.
- Label: The custom text to be displayed as a column header.
- Template: Use template column types to include multiple fields in one column through merge syntax.
- Template: Specifies which fields the template should include by either selecting them from the field picker, manually entering their merge variables, or using custom text.
- Label: The custom text to be displayed as a column header.
- Field: This option allows you to select a single field for export. Unselected columns will not be exported.
Styles tab [[]]¶
Display logic tab [[]]¶
Nested elements¶
Field properties¶
Once fields are added to the Table component, each field has a specific set of properties. These properties vary, depending upon the field type. Click on the field within the table to reveal and edit its properties.
Template fields [[]]¶
Template fields—much like the Template component—provide a way to display arbitrary text or HTML alongside field data. Other fields may be included within a template field through the use of merge syntax.
A basic template field for a full name may look like this:
{{FirstName}} {{LastName}}
It is also possible to update any fields included within a template field at runtime by double-clicking the Template field within the component.
For additional information, see the Template component topic.
Drawer properties¶
General tab
Show drawer icon: Determines whether or not to display an icon next to the record. If unchecked, the drawer can be opened and closed by configuring a global action (in a Table component) or row action (in a Table or List component) to run the Open/Close A Drawer action.
Icon: Click the icon picker to select a different icon.
Configure drawer: Opens the drawer configuration modal.
Before load actions
Before Load Actions refers to actions used before a drawer is loaded. Generally, these actions are used to activate and set the values of model conditions, and to query models to ensure that the contextually-relevant data will display in the drawer.
For more information, see Add Nested Rows to your Table with Drawers
Text [[]]¶
General tab [[]]¶
- Model:
- None: Select this to add text to the component without referencing context or using merge syntax.
- [Specific models]: All models within the page will be listed as options. To utilize context in the Text component—for example, to reference a particular field—select a model.
Advanced tab [[]]¶
Unique ID (optional): Skuid automatically generates an alphanumeric ID for the component; if preferred, give it a practical name.
Allow HTML: The template—text, HTML, or merge syntax—to use for this page. Use the picker to insert fields from the component’s chosen model as merge syntax. (Fields must be included in the model to be selectable.)
Note
Need more space?
- Click and drag the slash marks at the bottom of the entry field to enlarge that field.
- Want even more space? Click Resource Editor to open the Edit Inline Code dialog, especially useful when writing HTML code.
Styles tab [[]]¶
Display Logic tab [[]]¶
Component Accessories¶
Modal [[]]¶
General tab [[]]¶
Title: A descriptive name for the modal that will appear in the modal’s header.
Full screen modal: If checked, the modal displays across the available width of the screen.
Width: Adjust the width of the modal using percentage, pixel, or other forms of measurement.
Note
This property is not available if Full screen modal is checked.
Show close icon: If checked, the modal displays an icon at the corner that can be used to close the modal.
- Close icon (optional): The icon used to close the modal. Click the field picker to select an icon.
Show header: If checked, the modal includes a header with the Title contained within it. If unchecked, the header (and title) does not display.
Show button footer: If the Builder clicks
Add Button in the modal, this determines whether that button displays. If checked, the modal includes a footer with one (or more) button. If unchecked, the footer—and the buttons–do not display.Footer button alignment: Choose the alignment of the added buttons:
- Left
- Middle
- Right
Advanced tab [[]]¶
- Unique ID (optional): Skuid automatically generates an alphanumeric ID for the modal; if preferred, give it a practical name.
- Moveable: If checked, end users can move the modal to a different location on the screen.
- Resizable: If checked, end users can resized the modal.
Styles tab [[]]¶
After-close actions tab [[]]¶
Set actions that will occur once the modal is closed.
Nested elements¶
Modal Button properties¶
When you add buttons to the modal, these buttons have their own properties. All modal button properties are the same as those for Ink Button Set buttons.