Browse Source

Add documentation for Formula Result Formatting (#9275)

* formula result formatting doc with images

* updated formula result formatting doc
pull/9292/head
Lisa VC 3 months ago committed by GitHub
parent
commit
8a90447297
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
  1. 2
      packages/noco-docs/docs/070.fields/040.field-types/030.select-based/030.rating.md
  2. 73
      packages/noco-docs/docs/070.fields/040.field-types/060.formula/070.formula-result-formatting.md
  3. BIN
      packages/noco-docs/static/img/v2/fields/boolean-format.png
  4. BIN
      packages/noco-docs/static/img/v2/fields/date-format.png
  5. BIN
      packages/noco-docs/static/img/v2/fields/numeric-format.png
  6. BIN
      packages/noco-docs/static/img/v2/fields/text-format.png
  7. BIN
      packages/noco-docs/static/img/v2/fields/types/formula-format.png

2
packages/noco-docs/docs/070.fields/040.field-types/030.select-based/030.rating.md

@ -6,7 +6,7 @@ keywords: ['Fields', 'Field types', 'Custom types', 'Rating', 'Create rating fie
---
The
The `Rating field` allows you to capture and display ratings using a visual scale. The scale can be customized with different icons, colors, and maximum values. This makes it ideal for collecting feedback or evaluations in a visually intuitive way.
## Create a checkbox field
1. Click on `+` icon to the right of `Fields header`

73
packages/noco-docs/docs/070.fields/040.field-types/060.formula/070.formula-result-formatting.md

@ -0,0 +1,73 @@
---
title: 'Formatting Formula Results'
description: 'This article explains how to format the output of formulas in NocoDB, covering various formatting options based on the result type.'
tags: ['Fields', 'Field types', 'Formula', 'Formatting']
keywords: ['Fields', 'Field types', 'Formula', 'Formatting', 'Create formula field', 'Formatting options']
---
Formatting the output of formulas allows you to tailor how your data is displayed based on the type of result. Various formatting options are available to ensure that your data is presented in the most useful and visually appealing way.
![image](/img/v2/fields/types/formula-format.png)
## Numeric Formats
<img src="/img/v2/fields/numeric-format.png" alt="image" width="400"/>
### Decimal
The `Decimal format` is used to display results with a specified number of decimal places, allowing you to define the precision.
### Currency
The `Currency format` is ideal for displaying monetary values, with the option to set and display a specific currency symbol.
### Percent
The `Percent format` displays results as a number and includes an option to configure it as a progress bar.
### Rating
The `Rating format` is ideal for ratings on a scale from 1 to 10. It allows you to customize the icon, color, and choose the maximum rating value within that range.
## Date Formats
<img src="/img/v2/fields/date-format.png" alt="image" width="400"/>
### Date Time
The `Date Time format` displays both date and time values.
### Date
The `Date format` displays only the date values, with a wide range of date formats available.
### Time
The `Time format` displays the result in either 12-hour or 24-hour time format.
## Text Formats
<img src="/img/v2/fields/text-format.png" alt="image" width="400"/>
### Email
The `Email format` is used to display results as clickable email links. When an email address is detected in the formula output, it will be formatted as a mailto link, allowing users to click and open their default email client to send an email.
### URL
The `URL format` is designed to display results as clickable web links. When a valid URL is recognized in the formula output, it will be formatted as a hyperlink, enabling users to click and navigate directly to the specified web address.
### Phone Number
The `Phone number format` is ideal for displaying the results as phone numbers.
## Boolean Format
<img src="/img/v2/fields/boolean-format.png" alt="image" width="400"/>
### Checkbox
When NocoDB recognizes a formula's output as a Boolean result, you can apply the `Checkbox format` to display it in a manner similar to a checkbox field. You can customize icon and color as required.
---
## Related Articles
- [Numeric Functions](020.numeric-functions.md)
- [String Functions](030.string-functions.md)
- [Date Functions](040.date-functions.md)
- [Conditional Expressions](050.conditional-expressions.md)

BIN
packages/noco-docs/static/img/v2/fields/boolean-format.png vendored

Binary file not shown.

After

Width:  |  Height:  |  Size: 94 KiB

BIN
packages/noco-docs/static/img/v2/fields/date-format.png vendored

Binary file not shown.

After

Width:  |  Height:  |  Size: 106 KiB

BIN
packages/noco-docs/static/img/v2/fields/numeric-format.png vendored

Binary file not shown.

After

Width:  |  Height:  |  Size: 114 KiB

BIN
packages/noco-docs/static/img/v2/fields/text-format.png vendored

Binary file not shown.

After

Width:  |  Height:  |  Size: 106 KiB

BIN
packages/noco-docs/static/img/v2/fields/types/formula-format.png vendored

Binary file not shown.

After

Width:  |  Height:  |  Size: 599 KiB

Loading…
Cancel
Save