You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
113 lines
3.8 KiB
HTML
113 lines
3.8 KiB
HTML
{{/*
|
|
|
|
Render a table listing the properties of an object, given:
|
|
|
|
* `title`: optional caption for the table
|
|
|
|
* `anchor`: optional HTML element id for the table
|
|
|
|
* `properties`: dictionary of the properties to list, each given as:
|
|
`property_name` : `property_data`
|
|
|
|
* `required`: array containing the names of required properties.
|
|
In some cases (such as response body specifications) this isn't used, and
|
|
instead properties have a `required` boolean attribute. We support this too.
|
|
|
|
*/}}
|
|
|
|
{{ $title := .title }}
|
|
{{ $properties := .properties}}
|
|
{{ $required := .required}}
|
|
|
|
{{ if $properties }}
|
|
|
|
<table{{ if .anchor }} id="{{ .anchor }}"{{ end }} class="object-table">
|
|
{{ with $title }}
|
|
<caption>{{ . }}</caption>
|
|
{{ end }}
|
|
<thead>
|
|
<th class="col-name">Name</th>
|
|
<th class="col-type">Type</th>
|
|
<th class="col-description">Description</th>
|
|
</thead>
|
|
|
|
{{ range $property_name, $property := $properties }}
|
|
|
|
{{ $property := partial "json-schema/resolve-allof" $property }}
|
|
{{ $type := $property.type }}
|
|
|
|
{{ if eq $property.type "object" }}
|
|
{{ $type = partial "type-or-title" $property }}
|
|
{{ end }}
|
|
|
|
{{/*
|
|
If the property is an array, indicate this with square brackets,
|
|
like `[type]`.
|
|
*/}}
|
|
{{ if eq $property.type "array"}}
|
|
{{ $items := $property.items }}
|
|
{{ if $property.items }}
|
|
{{ $items = partial "json-schema/resolve-allof" $property.items }}
|
|
{{ end }}
|
|
{{ $inner_type := partial "type-or-title" $items }}
|
|
{{ $type = delimit (slice "[" $inner_type "]") "" }}
|
|
{{ end }}
|
|
|
|
{{/*
|
|
If the property is an enum, indicate this.
|
|
*/}}
|
|
{{ if (and (eq $property.type "string") ($property.enum)) }}
|
|
{{ $type = "enum" }}
|
|
{{ end }}
|
|
|
|
{{/*
|
|
Handle two ways of indicating "required", one for simple parameters,
|
|
the other for request and response body objects.
|
|
*/}}
|
|
{{ $required := cond (or (in $required $property_name) ( eq $property.required true )) true false }}
|
|
|
|
<tr>
|
|
<td><code>{{ $property_name }}</code></td>
|
|
<td><code>{{ $type }}</code></td>
|
|
<td>
|
|
{{ if $required }}<strong>Required: </strong>{{end -}}
|
|
{{ $property.description | markdownify -}}
|
|
{{ if eq $type "enum"}}<p>One of: <code>[{{ delimit $property.enum ", " }}]</code>.</p>{{ end -}}
|
|
{{ if (index $property "x-addedInMatrixVersion") }}{{ partial "added-in" (dict "v" (index $property "x-addedInMatrixVersion")) }}{{ end -}}
|
|
{{ if (index $property "x-changedInMatrixVersion") }}{{ partial "changed-in" (dict "changes_dict" (index $property "x-changedInMatrixVersion")) }}{{ end -}}
|
|
</td>
|
|
</tr>
|
|
|
|
{{ end }}
|
|
|
|
</table>
|
|
|
|
{{ end }}
|
|
|
|
{{/*
|
|
Picks either the `title` of a property, or the `type`, to turn into the rendered type field.
|
|
Also handles `additionalProperties`, if no `title` is present.
|
|
*/}}
|
|
{{ define "partials/type-or-title" }}
|
|
{{ $type := "" }}
|
|
{{ if .title }}
|
|
{{/*
|
|
If the property has a `title`, use that rather than `type`.
|
|
This means we can write things like `EventFilter` rather than `object`.
|
|
*/}}
|
|
{{ $type = .title }}
|
|
{{ else if reflect.IsMap .additionalProperties }}
|
|
{{/*
|
|
If the property uses `additionalProperties` to describe its
|
|
internal structure, handle this with a bit of recursion
|
|
*/}}
|
|
{{ $type = delimit (slice "{string: " (partial "type-or-title" .additionalProperties) "}" ) "" }}
|
|
{{ else if reflect.IsSlice .type }}
|
|
{{/* It's legal to specify an array of types. Join them together in that case */}}
|
|
{{ $type = delimit .type "|" }}
|
|
{{ else }}
|
|
{{ $type = .type }}
|
|
{{ end }}
|
|
{{ return $type }}
|
|
{{ end }}
|