Descriptor List
and adding Descriptors in a PowerBlock
and adding Descriptors in a PowerBlock
When creating a PowerBlock you can add descriptors to fields inside the Block. These descriptors will allow the user to enter in those field values when they drag the PowerBlock into their app.
Here is a list of descriptors and images of the prompts that they will create when the PowerBlock is dragged into the app.
custom_block
color
checkbox
dimension
feed
feed_field
field_or_expr
font_spec
font_style
gravity
height
html
image
key
layer
margin
text
text_box
text_only
transition
url
variable_name
view
So let's see how we add and configure 3 descriptors to an app. We are going to add the following descriptors:
feed
feed_field
image
For this example we are going to use a List Block, but descriptors can be added anywhere in a Blocks configuration field.
The first field we will add is the descriptor value "feed".
In the Block itself we can define the field as whatever value we want and in the settings we will assign the descriptor value to that value in the settings.
In the text Block field "Data Source" we add the value {Data Source}. Again, we can define this as any intuitive value.
image
For this example we are going to use a List Block, but descriptors can be added anywhere in a Blocks configuration field.
The first field we will add is the descriptor value "feed".
In the Block itself we can define the field as whatever value we want and in the settings we will assign the descriptor value to that value in the settings.
In the text Block field "Data Source" we add the value {Data Source}. Again, we can define this as any intuitive value.
If we click on the pencil in the Data Source field we can add our user defined value in the field
To assign a descriptor value to the user defined value we click on "Edit" next to "PowerBlock".
Now click on the "PowerBlock" tab. and go down to where it says "Power block descriptor". Here is where you assign the descriptor value "feed" to the user defined value {Data Source}. You would put the value like this:
"Data Source: feed"
"Data Source: feed"
Below that is the field "Item Level Help (formatted). This will be the text when you click on the help bubble when the PowerBlock is dragged into the app. (See below). "Data Source" is the user defined value in the Block.
Click "Update" to save your changes.
Now lets see what the user will see when they drag the PowerBlock into their app.
A
A dialog will popup prompting the user to add an existing data source to the PowerBlock. You can see the definition "Data Source" is now prompting the user to add a data source to the Block.
If we click the help bubble the text we defined in the settings will hover on the prompt.
So let's add two more descriptors to the Block.
Let's add the value {Title} for the value of a column in the Data Source.
Let's add the value {Title} for the value of a column in the Data Source.
And let's add the value {Image} for the left image in the list.
Now we can add define the values with Descriptors in the Edit/Settings of the PowerBlock. Also the help that appears when the user clicks on the help bubble for that item.
Now when we drag the PowerBlock into a regular app we will see the 3 descriptors we have defined to allow the user to define the assets or settings of the PowerBlock to their app.
Learn More
- Building a PowerBlock
- Descriptor Field Types for Blocks
Learn More
- Building a PowerBlock
- Descriptor Field Types for Blocks