grid - UNC-Project-Open-AAC/OS-DPI GitHub Wiki

Grid

A grid is the most common arrangement in AAC. As expected, the OS-DPI Grid component organizes data into rows and columns. In order for the Grid to know how to arrange the data, you will need to add Filters specifying which column to pull from in your spreadsheet. To add a Filter, select Add --> Filter from the top menu bar. Then, select from the dropdown menu to specify the Field (denoted with a # and then column name).

Grids can look like this 6x6 grid with text and an icon.

Screenshot 2023-05-23 at 11 16 01 AM

Designs using a grid could even look like the 4-quadrant keyboard below. The goal of the OS-DPI is to allow simulation of any UI the designer intends to create.

Screenshot 2023-05-23 at 11 16 11 AM

Properties

Fill Items

When checked the row and column fields from the content are ignored and the items are filled into the grid left to right and top down.

Rows

Integer number of rows in the grid when Fill Items is checked.

Columns

Integer number of columns in the grid with Fill Items is checked.

Scale

The size of the Grid relative to the other components in the same stack.

Name

The name of the Grid. This property is used in actions to specify the origin of an event.

Background

The color of the background in the Grid.

Components you may add

Filter

Filters allow you to limit the rows from your content that will be displayed in this Grid.

Field

The field from the content to test. For example `#label.

Operator

The comparison operator to apply to the field. Possible values include:

  • equals: select rows where the field equals the value.
  • less than: select rows where the field is less than the value.
  • greater than: select rows where the field is greater than the value.
  • starts with: select rows where the field starts with the value.
  • empty: select rows where the field is empty.
  • not empty: select rows where the field is not empty.
  • contains: select rows where the field contains value.
  • is contained in: select rows where the field is contained in the value.

Value

The value to compare. It can be a string like "Clear", a State like $mode, another Field like #name, or a combination of these.

Backlinks

⚠️ **GitHub.com Fallback** ⚠️