Skip to content

Commit

Permalink
update specs changelog v1.0.18
Browse files Browse the repository at this point in the history
  • Loading branch information
@elff1 @harry75369
elff1 authored and harry75369 committed Jun 19, 2024
1 parent 7ae90e0 commit dabf1f2
Show file tree
Hide file tree
Showing 6 changed files with 82 additions and 16 deletions.
5 changes: 5 additions & 0 deletions docs/specs/changelog.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,11 @@
title: VGG Specs Changelog
---

## v1.0.18 (Jun 18, 2024)

* Add `frameType` of `frame`.
* Update some descriptions.

## v1.0.17 (May 21, 2024)

* Support negative `gap`s in flexbox layout.
Expand Down
20 changes: 10 additions & 10 deletions docs/specs/layout/flexbox-layout.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -330,7 +330,7 @@ Description

<div>

This property is used to set the size of the gap between rows in a grid layout. It defines the whitespace distance between adjacent rows within the grid container, allowing for a certain vertical spacing between grid items. This property accepts values in pixels (px) as units. This value can be negative.
This property is used to set the size of the gap between rows in a flexbox layout. It defines the whitespace distance between adjacent rows within the flexbox container, allowing for a certain vertical spacing between flexbox items. This property accepts values in pixels (px) as units. This value can be negative.

</div>

Expand Down Expand Up @@ -362,7 +362,7 @@ Description

<div>

This property is used to set the size of the gap between columns in a grid layout. It defines the whitespace distance between adjacent columns within the grid container, allowing for a certain amount of spacing horizontally for grid items. This property accepts values in pixels (px) as units. This value can be negative.
This property is used to set the size of the gap between columns in a flexbox layout. It defines the whitespace distance between adjacent columns within the flexbox container, allowing for a certain amount of spacing horizontally for flexbox items. This property accepts values in pixels (px) as units. This value can be negative.

</div>

Expand Down Expand Up @@ -394,14 +394,14 @@ Description

<div>

If `smartSpacing` is false, nothing is done.
If `smartSpacing` is true, then
A. when `justifyContent` is `space between` and wrap is `no wrap`, then
1\. When the container has only one child, the margins on the main axis direction of that child are set to `auto`.
2\. When the container has more than one child, the margins on the main axis are set to 0 for the start direction of the first child and the end direction of the last child, and `auto` for the rest.
3\. Ignore the value of main axis gap and treat is as 0.
B. when `justifyContent` is `space between` and wrap is `wrap`, ignore the value of main axis gap and treat is as 0.
C. when `alignContent` is `space between`, ignore the value of cross axis gap and treat is as 0.
If this item is false, then no action is taken.
If this item is true, then:
A. When `justifyContent` is `space between`, and the container does not wrap, and all elements in the main axis direction have a length that is not `auto`, then:
1\. When the container has only one child, the two margins of this child in the main axis direction will be set to `auto`.
2\. When the container has more than one child, in the main axis direction, the start margin of the first child and the end margin of the last child will be set to 0, and the remaining margins will all be set to `auto`.
3\. Ignore the value of the `gap` in the main axis direction, and treat its value as 0.
B. When `justifyContent` is `space between`, and the container wraps, ignore the value of the `gap` in the main axis direction, and treat its value as 0.
C. When `alignContent` is `space between`, ignore the value of the `gap` in the cross axis direction, and treat it as 0.

</div>

Expand Down
51 changes: 51 additions & 0 deletions docs/specs/vectorgraphics/frame.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -57,6 +57,7 @@ The group's fills affect all of its children.
| [class](#class) | `string` | <span className="property-required">Required</span> |
| [radius](#radius) | `Array<number>` | <span className="property-optional">Optional</span> |
| [backgroundColor](#backgroundcolor) | [`Color`](/specs/vectorgraphics/color) | <span className="property-optional">Optional</span> |
| [frameType](#frametype) | `integer` | <span className="property-optional">Optional</span> |

</div>

Expand Down Expand Up @@ -1129,6 +1130,56 @@ Type

</div>

<div className="property">

<div className="property-heading">

## frameType

<span className="property-optional">Optional</span>

</div>

<div className="property-item">

Description

<div>

no description

</div>

</div>

<div className="property-item">

Type

`integer`

</div>

<div className="property-item">

Value

<div className="value-description">

**enum**: the value of this property must be equal to one of the following values:

| Value | Explanation |
| :---- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `0` | <div className="enum-description">normal frame.(Default value)</div> |
| `1` | <div className="enum-description"> virtual frame. In many design software, each page may have elements that are floating outside the top-level frame(artboard). Organizing these elements into a new top-level frame would create a virtual frame. </div> |
| `2` | <div className="enum-description"> container of symbol master variants. In Figma, when creating multiple variants of a symbol master, it automatically creates a frame to contain them. </div> |

</div>

</div>

</div>

<div id="backlinks" className="section-backlinks">

<div className="backlinks-title"><h2>Backlinks</h2></div>
Expand Down
5 changes: 3 additions & 2 deletions docs/specs/vectorgraphics/image.md
View file
Original file line number Diff line number Diff line change
Expand Up @@ -1037,8 +1037,9 @@ Description

<div>

If the value is `true`, the image content is not displayed, and only the `fill` effect is shown.
Otherwise, both the image content and the `fill` effect take effect simultaneously.
If the value is `true`, the image content is not displayed, and only the `fills` effect is shown.
Otherwise, both the image content and the `fills` effect take effect simultaneously.
Note: The transparency of the image itself will always take effect.
Default value is `false`.

</div>
Expand Down
6 changes: 3 additions & 3 deletions static/schemas/layout.schema.json
View file
Original file line number Diff line number Diff line change
Expand Up @@ -137,15 +137,15 @@
},
"rowGap": {
"type": "number",
"description": "This property is used to set the size of the gap between rows in a grid layout. It defines the whitespace distance between adjacent rows within the grid container, allowing for a certain vertical spacing between grid items. This property accepts values in pixels (px) as units. This value can be negative."
"description": "This property is used to set the size of the gap between rows in a flexbox layout. It defines the whitespace distance between adjacent rows within the flexbox container, allowing for a certain vertical spacing between flexbox items. This property accepts values in pixels (px) as units. This value can be negative."
},
"columnGap": {
"type": "number",
"description": "This property is used to set the size of the gap between columns in a grid layout. It defines the whitespace distance between adjacent columns within the grid container, allowing for a certain amount of spacing horizontally for grid items. This property accepts values in pixels (px) as units. This value can be negative."
"description": "This property is used to set the size of the gap between columns in a flexbox layout. It defines the whitespace distance between adjacent columns within the flexbox container, allowing for a certain amount of spacing horizontally for flexbox items. This property accepts values in pixels (px) as units. This value can be negative."
},
"smartSpacing": {
"type": "boolean",
"description": "If `smartSpacing` is false, nothing is done.\nIf `smartSpacing` is true, then\n A. when `justifyContent` is `space between` and wrap is `no wrap`, then\n 1. When the container has only one child, the margins on the main axis direction of that child are set to `auto`.\n 2. When the container has more than one child, the margins on the main axis are set to 0 for the start direction of the first child and the end direction of the last child, and `auto` for the rest.\n 3. Ignore the value of main axis gap and treat is as 0.\n B. when `justifyContent` is `space between` and wrap is `wrap`, ignore the value of main axis gap and treat is as 0.\n C. when `alignContent` is `space between`, ignore the value of cross axis gap and treat is as 0."
"description": "If this item is false, then no action is taken.\nIf this item is true, then:\n A. When `justifyContent` is `space between`, and the container does not wrap, and all elements in the main axis direction have a length that is not `auto`, then:\n 1. When the container has only one child, the two margins of this child in the main axis direction will be set to `auto`.\n 2. When the container has more than one child, in the main axis direction, the start margin of the first child and the end margin of the last child will be set to 0, and the remaining margins will all be set to `auto`.\n 3. Ignore the value of the `gap` in the main axis direction, and treat its value as 0.\nB. When `justifyContent` is `space between`, and the container wraps, ignore the value of the `gap` in the main axis direction, and treat its value as 0.\nC. When `alignContent` is `space between`, ignore the value of the `gap` in the cross axis direction, and treat it as 0."
},
"padding": {
"type": "array",
Expand Down
11 changes: 10 additions & 1 deletion static/schemas/vectorgraphics.schema.json
View file
Original file line number Diff line number Diff line change
Expand Up @@ -211,6 +211,15 @@
"backgroundColor": {
"$ref": "#/definitions/Color",
"description": "The background color of the canvas on which the frame is positioned. Exists only on the top-level frame."
},
"frameType": {
"type": "integer",
"enum": [0, 1, 2],
"enumDescriptions": [
"normal frame.(Default value)",
" virtual frame. In many design software, each page may have elements that are floating outside the top-level frame(artboard). Organizing these elements into a new top-level frame would create a virtual frame. ",
" container of symbol master variants. In Figma, when creating multiple variants of a symbol master, it automatically creates a frame to contain them. "
]
}
},
"additionalProperties": false
Expand Down Expand Up @@ -2547,7 +2556,7 @@
},
"fillReplacesImage": {
"type": "boolean",
"description": "If the value is `true`, the image content is not displayed, and only the `fill` effect is shown.\nOtherwise, both the image content and the `fill` effect take effect simultaneously.\nDefault value is `false`."
"description": "If the value is `true`, the image content is not displayed, and only the `fills` effect is shown.\nOtherwise, both the image content and the `fills` effect take effect simultaneously.\nNote: The transparency of the image itself will always take effect.\nDefault value is `false`."
},
"imageFilters": {
"$ref": "#/definitions/ImageFilters",
Expand Down

0 comments on commit dabf1f2

Please sign in to comment.