Thanks to visit codestin.com
Credit goes to github.com

Skip to content
This repository was archived by the owner on Feb 7, 2019. It is now read-only.

arc-archive/docs-parameters-table

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

58 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Build Status Dependency Status

docs-parameters-table

<docs-parameters-table> A parameters list and description table for the RAML documentation view

This element renders a table of paramteres with the doccumentation. It can be used to display URL parameters. For headers documentation table pleae, use <docs-headers-table> element. For types documentation table pleae, use <docs-body-parameters-table> element.

Example

<docs-parameters-table
  uri-parameters="[[uriParameters]]"
  query-parameters="[[queryParameters]]"></docs-parameters-table>

Object properties

An object in both arrays can contain any property that URI and query parameters can contain.

Currently following properties are supported:

  • name (required) - name of the property, in case of UIR parameter it should be the parameter itself
  • type - the type of the parameter, any RAML allowed value will be accepted
  • description - description of the parameter
  • required - mark that the property is a required property
  • pattern - validation pattern to be applied to the parameter value
  • example - example value of the parameter
  • min - minimum value of the parametre when the type is numeric
  • max - maximum value of the parametre when the type is numeric

Styling

<docs-parameters-table> provides the following custom properties and mixins for styling:

Custom property Description Default
--docs-parameters-table Mixin applied to all parameter table elements {}
--docs-parameters-url-table Mixin applied to this elements {}
--params-table-header-background-color Background color of table header #00A1DF
--params-table-header-color Font color of table header rgba(255, 255, 255, 0.87)
--params-table-subheader-background-color Background color of table subheader rgba(0, 161, 223, 0.24)
--params-table-subheader-color Font color of table subheader rgba(0, 0, 0, 0.87)
--params-table-row-border-color Border color of table's each row #00A1DF
--params-table-row-background-color Background color of table's each row #fff
--params-table-row-color Font color of table's each row #fff
--docs-parameters-table-cell Mixin applied to each cell {}
--docs-parameters-table-meta Mixin applied to property's metadata (example, pattern, etc) {}

docs-headers-table

<docs-headers-table> A headers list documentation table for the RAML documentation view.

Example

<docs-headers-table
  headers="[[headers]]"></docs-headers-table>

Object properties

An object in headers object can contain any property that header can contain according to the RAML spec.

Currently following properties are supported:

  • name (required) - name of the property, in case of UIR parameter it should be the parameter itself
  • type - the type of the parameter, any RAML allowed value will be accepted
  • description - description of the parameter
  • required - mark that the property is a required property
  • pattern - validation pattern to be applied to the parameter value
  • example - example value of the parameter
  • min - minimum value of the parametre when the type is numeric
  • max - maximum value of the parametre when the type is numeric

Styling

<docs-headers-table> provides the following custom properties and mixins for styling:

Custom property Description Default
--docs-parameters-table Mixin applied to all parameter table elements {}
--docs-parameters-url-table Mixin applied to this elements {}
--params-table-header-background-color Background color of table header #00A1DF
--params-table-header-color Font color of table header rgba(255, 255, 255, 0.87)
--params-table-subheader-background-color Background color of table subheader rgba(0, 161, 223, 0.24)
--params-table-subheader-color Font color of table subheader rgba(0, 0, 0, 0.87)
--params-table-row-border-color Border color of table's each row #00A1DF
--params-table-row-background-color Background color of table's each row #fff
--params-table-row-color Font color of table's each row #fff
--docs-parameters-table-cell Mixin applied to each cell {}
--docs-parameters-table-meta Mixin applied to property's metadata (example, pattern, etc) {}

docs-body-parameters-table

<docs-parameters-table> A parameters list and description table for the RAML documentation view

This element renders a table of body type paramteres with the doccumentation.

For headers documentation table pleae, use <docs-headers-table> element. For uri parameters documentation table pleae, use <docs-parameters-table> element.

Example

<docs-body-parameters-table
  type="[[bodType]]"></docs-body-parameters-table>

Currently following properties are supported:

  • name (required) - name of the property, in case of UIR parameter it should be the parameter itself
  • type - the type of the parameter, any RAML allowed value will be accepted
  • description - description of the parameter
  • required - mark that the property is a required property
  • pattern - validation pattern to be applied to the parameter value
  • example - example value of the parameter
  • min - minimum value of the parametre when the type is numeric
  • max - maximum value of the parametre when the type is numeric

Styling

<docs-body-parameters-table> provides the following custom properties and mixins for styling:

Custom property Description Default
--docs-parameters-table Mixin applied to all parameter table elements {}
--docs-parameters-url-table Mixin applied to this elements {}
--params-table-header-background-color Background color of table header #00A1DF
--params-table-header-color Font color of table header rgba(255, 255, 255, 0.87)
--params-table-subheader-background-color Background color of table subheader rgba(0, 161, 223, 0.24)
--params-table-subheader-color Font color of table subheader rgba(0, 0, 0, 0.87)
--params-table-row-border-color Border color of table's each row #00A1DF
--params-table-row-background-color Background color of table's each row #fff
--params-table-row-color Font color of table's each row #fff
--docs-parameters-table-cell Mixin applied to each cell {}
--docs-parameters-table-meta Mixin applied to property's metadata (example, pattern, etc) {}
--docs-body-parameters-table-json Mixin applied to the JSON output {}
--docs-body-parameters-table-type-name Mixin applied to the name of the type {}

docs-body-table

The docs-body-table is a view for the RAML documentation body. Body may contain more than one type (RAML's union types) so in this case this will show a more than one table of the parameters.

docs-json-parameters-table

<docs-json-parameters-table> displays a documentation view for JSON structured body.

Example

<docs-json-parameters-table
  type="[[ramlJsonType]]"></docs-json-parameters-table>

Currently following properties are supported:

  • name (required) - name of the property, in case of UIR parameter it should be the parameter itself
  • type - the type of the parameter, any RAML allowed value will be accepted
  • description - description of the parameter
  • required - mark that the property is a required property
  • pattern - validation pattern to be applied to the parameter value
  • example - example value of the parameter
  • min - minimum value of the parametre when the type is numeric
  • max - maximum value of the parametre when the type is numeric

Styling

<docs-json-parameters-table> provides the following custom properties and mixins for styling:

Custom property Description Default
--docs-parameters-table Mixin applied to all parameter table elements {}
--docs-parameters-url-table Mixin applied to this elements {}
--params-table-header-background-color Background color of table header #00A1DF
--params-table-header-color Font color of table header rgba(255, 255, 255, 0.87)
--params-table-subheader-background-color Background color of table subheader rgba(0, 161, 223, 0.24)
--params-table-subheader-color Font color of table subheader rgba(0, 0, 0, 0.87)
--params-table-row-border-color Border color of table rows rgba(0, 161, 223, 1)
--params-table-row-subproperty-border-color Border color of table row which is a description of child property. rgba(0, 161, 223, 0.24)
--params-table-row-background-color Background color of table's each row #fff
--params-table-row-color Font color of table's each row #fff
--docs-parameters-table-cell Mixin applied to each cell {}
--docs-parameters-table-meta Mixin applied to property's metadata (example, pattern, etc) {}
--docs-body-parameters-table-json Mixin applied to the JSON output {}
--docs-body-parameters-table-type-name Mixin applied to the name of the type {}

About

Set of documentation tables for RAML types used in the API Console

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Contributors 3

  •  
  •  
  •