CSS によるスクロール留め — CSS Scroll Snap Module Level 1

1.1. ~module間の相互作用

この~moduleは、 `CSS2$r `§ ~overflow＠~CSS22/visufx.html#overflow-clipping$ に定義される~scroll用の~UI特能を拡張する。 ◎ This module extends the scrolling user interface features defined in [CSS2] section 11.1.

この~moduleに定義される~propは、［ `first-line$pe ／ `first-letter$pe ］疑似要素には適用されない。 ◎ None of the properties in this module apply to the ::first-line and ::first-letter pseudo-elements.

1.2. 値~定義

【 この節の内容は、 `~CSS日本語訳 共通~page＠~CSScommon#values$に移譲。 】

4.1. ~scroll留ngの規則： `scroll-snap-type^p ~prop

`scroll-snap-type$p ~propは、 `~scroll容器$は`~scroll留め容器$になるかどうか, および［ そうであれば、 どの軸が考慮され，どの~~程度~厳密に`留められ$るべきか ］を指定する。 `厳密度~値$は、 指定されていない場合は `proximity$v と見做される。 ◎ The scroll-snap-type property specifies whether a scroll container is a scroll snap container, how strictly it snaps, and which axes are considered. If no strictness value is specified, proximity is assumed.

html {
  scroll-snap-type: block;   /* 
文書~全体の~scroll域に適用される
◎
applied to main document scroller
 */
}
h1, h2, h3, h4, h5, h6 {
  scroll-snap-align: start;  /* 
表示域の始端（上端）に留める
◎
snap to the start (top) of the viewport
 */
}

~UAは、 `根~要素$に設定された `scroll-snap-type$p 値を文書~表示域に適用するモノトスル。 （ `overflow$p と違って、 `scroll-snap-type^p 値は，~HTML `body$e 要素からは`伝播しない^emことに注意。） ◎ UAs must apply the scroll-snap-type value set on the root element to the document viewport. Note that, unlike overflow, scroll-snap-type values are not propagated from HTML body.

.log {
  scroll-snap-type: y proximity;
  align-content: end;
}
.log::after {
  display: block;
  content: "";
  scroll-snap-align: end;
}

4.2. ~scroll留域： `scroll-padding^p ~prop

この~propは、 ~scrollportを成す `最適な~view用~領域@ を定義する~offsetを指定する（`~scroll留め容器$のみならず，すべての`~scroll容器$用に） — その領域は、 利用者の~viewにモノを配置する領域として利用される。 これにより，作者は、 `~scrollport$内の［ 他の内容（`固定的に位置され$た~toolbarや~sidebarなど）に遮られる領域 ］を除外したり， 単純に［ 当の要素と~scrollportの各~辺との合間に余白をとる ］ことが可能になる。 ◎ This property specifies (for all scroll containers, not just scroll snap containers) offsets that define the optimal viewing region of a scrollport: the region used as the target region for placing things in view of the user. This allows the author to exclude regions of the scrollport that are obscured by other content (such as fixed-positioned toolbars or sidebars) or simply to put more breathing room between a targeted element and the edges of the scrollport.

`scroll-padding$p ~propは、 すべての `scroll-padding-*^p 下位propを 一つの宣言でまとめて設定する`略式~prop$であり， 各~側を表現している値をその各 下位propにアテガう — `padding$p ~propがその各 下位propに値をアテガうときとちょうど同じように。 各種~値の意味は： ◎ The scroll-padding property is a shorthand property that sets all of the scroll-padding-* longhands in one declaration, assigning values to the longhands representing each side exactly as the padding property does for its longhands. Values have the following meanings:

`length-percentage [0,∞]$t

`~scrollport$の対応する辺から内方への~offsetを定義する。 根~表示域に適用されるときは、 ~offsetは，（可視域ではなく）~layout表示域に相対的に — `固定的に位置され$た~boxの対応する`~inset~prop$と同じ仕方で — 計算された上で適用される。 `最適な~view用~領域$は、 その結果と可視域が交差する区画になる。 【~layout表示域は、~scrollして見出せるもの全体を囲う区画と考えればよいであろう（一般に，可視域より広くなる）。】 ◎ Defines an inward offset from the corresponding edge of the scrollport. When applied to the root viewport, the offset is calculated and applied relative to the layout viewport (rather than the visual viewport) the same way as the corresponding inset properties on fixed-positioned boxes; the optimal viewing region is the remaining area that intersects with the visual viewport.

`auto@v

`~scrollport$の対応する辺からの~offsetは、 ~UAが決定することを指示する。 これに対する使用~長さは，一般に既定で `0px^v になるべきであるが、 ~UAは， 0 以外の値の方が適切になるときは，それを検出する経験則を利用してヨイ。 ◎ Indicates that the offset for the corresponding edge of the scrollport is UA-determined. This should generally default to a used length of 0px, but UAs may use heuristics to detect when a non-zero value is more appropriate.

例えば~UAは、［ `固定的に位置され$た【！position:fixed】要素が不透明な~scroll不能な “頭部見出し” として利用されていて， それが下にある内容を遮っていることを検出した ］ときは、 上端~offsetを，その要素の縦幅に解決することもできる — “~pageをめくる” 操作o （ PgDn キーを押下げたときなど）が， 内容の “可視な 1 ~page” 分だけ自動的に~scrollするように。 ◎ For example, a UA could detect when a position:fixed element is being used as an opaque unscrollable “header” that obscures the content below it, and resolve the top offset to the height of that element so that a “page down” operation (such as pressing PgDn) automatically scrolls by one “visible page” of content.

当の`~scroll容器$が`留め容器$でもある場合、 この領域は，その `留域@ も定義する。 それは、 当の容器の`~scrollport$内の区画であり， `留め位置$を計算するときに`~scroll留め区画$用の`整列~容器$として利用される。 ◎ For a scroll snap container this region also defines the scroll snapport—the area of the scrollport that is used as the alignment container for the scroll snap areas when calculating snap positions.

html {
    `overflow-x$p: auto;
    `overflow-y$p: hidden;
    `scroll-snap-type$p: `x$v `mandatory$v;
    `scroll-padding$p: 0 500px 0 0;
}
.toolbar {
    position: fixed;
    height: 100%;
    width: 500px;
    right: 0;
}
img {
    `scroll-snap-align$p: none `center$v;
}

~UAは、 `根~要素$に設定された `scroll-padding$p 値を文書~表示域に適用するモノトスル。 （ `overflow$p と違って， `scroll-padding^p 値は、 ~HTML `body$e 要素からは`伝播しない^emことに注意。） ◎ UAs must apply the scroll-padding values set on the root element to the document viewport. (Note that, unlike overflow, scroll-padding values are not propagated from HTML body.)

5.1. ~scroll留め区画： `scroll-margin^p ~prop

この~propは、 すべての `scroll-margin-*^p 下位propを 一つの宣言でまとめて設定する`略式~prop$であり， 各~側を表現している値をその各 下位propにアテガう — `margin$p ~propがその各 下位propにアテガうときとちょうど同じように。 ◎ This property is a shorthand property that sets all of the scroll-margin-* longhands in one declaration, assigning values to the longhands representing each side exactly as the margin property does for its longhands.

値を成す各~長さは、 外方への~offsetを表現する。 それらは、 当の要素の `~scroll留め区画@ — 当の要素を`留域$に`留める$ときに利用される~box — を定義する。 `~scroll留め区画$は、［ 変形された`~border~box$†から （`~scroll容器$の座標~空間に軸が整列された）矩形な限界~boxを見出した結果 ］に［ 指定された外方への~offset ］たちを加算する††ことにより，決定される。 ◎ Values represent outsets defining the scroll snap area that is used for snapping this box to the snapport. The scroll snap area is determined by taking the transformed border box, finding its rectangular bounding box (axis-aligned in the scroll container’s coordinate space), then adding the specified outsets.

【† 当の要素の~border~boxに `transform$p などによる変形を（適用-可能ならば）適用した結果。 】【†† 負な値を与えた場合、 内方へ~offsetされることになる。 】

注記： これは、 `~scroll留め区画$が常に矩形になり， その軸は`~scroll容器$の座標~空間に整列されることを確保する。 ◎ Note: This ensures that the scroll snap area is always rectangular and axis-aligned to the scroll container’s coordinate space.

~UAは、［ ~target要素を定義する素片 （ `target$ps に合致するもの／ `scrollIntoView()$m の~targetになるもの） へ~pageが~navigateされた ］ときに［ `~scroll可能な~overflow区画$を成す どの区画を~viewの中へ持込むか決定する ］ときには，当の要素の［ `~border~box$ではなく，`~scroll留め区画$ ］を利用するべきである — 当の要素に対し`留ngが［~offにされた／適用されない］ときでも^em。 ◎ If a page is navigated to a fragment that defines a target element (one that would be matched by :target, or the target of scrollIntoView()), the UA should use the element’s scroll snap area, rather than just its border box, to determine which area of the scrollable overflow area to bring into view, even when snapping is off or not applied on this element.

5.2. ~scroll留ngの整列-法： `scroll-snap-align^p ~prop

%~box の`留め位置$は、 値に応じて，［ 対応する軸において， %~subject, %容器 を次のように整列させる位置 ］として定義される： ◎ Values are defined as follows:

`none@v

`留め位置$は定義されず， %~subject, %容器 は互いに整列されない。 ◎ This box does not define a snap position in the specified axis.

`start@v

%~subject, %容器 の始端どうしを整列させる。 ◎ Start alignment of this box’s scroll snap area within the scroll container’s snapport is a snap position in the specified axis.

`end@v

%~subject, %容器 の終端どうしを整列させる。 ◎ End alignment of this box’s scroll snap area within the scroll container’s snapport is a snap position in the specified axis.

`center@v

%~subject, %容器 の中央どうしを整列させる。 ◎ Center alignment of this box’s scroll snap area within the scroll container’s snapport is a snap position in the specified axis.

［ 始端／終端 ］どうしの整列は、 %~box の`留め容器$の`書字~mode$に基づいて解決される — ただし， %~subject が %容器 より大きい事例では、 %~box の`書字~mode$に基づいて解決される （これは、［ 容器~内の~subjectたち【！items】の留め整列が，一般には一貫する ］ことを許容しつつ，［ `start$v は，常に［ %~box の内容を始めから読める ］ように %~subject 【！the item】を整列する ］ことを確保する。） ◎ Start and end alignments are resolved with respect to the writing mode of the snap container unless the scroll snap area is larger than the snapport, in which case they are resolved with respect to the writing mode of the box itself. (This allows items in a container to have consistent snap alignment in general, while ensuring that start always aligns the item to allow reading its contents from the beginning.)

5.3. ~scroll留めに対する制限s： `scroll-snap-stop^p ~prop

ある意図された方向へ~scrollするとき、 `~scroll容器$は，［ `自然な終止-点$に到達して最終的な`~scroll位置$を選定する前 ］に いくつかのアリな`留め位置$ （同じ方向へ~scrollする距離がより短い場合に，留めるに妥当な位置） を “通過-” し得る。 `scroll-snap-stop$p ~propは、 そのようなアリな`留め位置$が~scrollingを “捉えて”，［ それが自然に終止する前に`~scroll容器$を停止する ］よう強制することを許容する。 ◎ When scrolling with an intended direction, the scroll container can “pass over” several possible snap positions (that would be valid to snap to, if the scrolling operation used the same direction but a lesser distance) before reaching the natural endpoint of the scroll operation and selecting its final scroll position. The scroll-snap-stop property allows such a possible snap position to “trap” the scrolling operation, forcing the scroll container to stop before the scrolling operation would naturally end.

各種 値の定義は： ◎ Values are defined as follows:

`normal@v

`~scroll容器$は、 ~scrollingを実行する間， この要素により定義される`留め位置$を通過してもヨイ。 ◎ The scroll container may pass over a snap position defined by this element during the execution of a scrolling operation.

`always@v

`~scroll容器$は、 ~scrollingを実行する間， この要素により定義される`留め位置$を通過しないモノトスル — そのような要素たちの`留め位置$のうち，最初に~~遭遇した所で留めるモノトスル。 ◎ The scroll container must not pass over a snap position defined by this element during the execution of a scrolling operation; it must instead snap to the first of this element’s snap positions.

この~propは、 `終止-位置のみ意図され$ている~scrollingには効果がない — それは、 概念的に`留め位置$を “通過しない” ので。 ◎ This property has no effect on scrolling operations with only an intended end position, as they do not conceptually “pass over” any snap positions.

6. 留ngの仕組み

留める際に`留め位置$を選定する~modelを成す精確な~algoは、 意図的に，ほぼ未定義である — ~UAは、［ 利用者の意図n, 利用者-ヤリトリ ］が成す~modelを［ 利用者に最善に仕える ］ように洗練して，［ 時間~越しにどう応答するか ］を調整できる。 ◎ The precise model algorithm to select a snap position to snap to is intentionally left mostly undefined, so that user agents can take into account sophisticated models of user intention and interaction and adjust how they respond over time, to best serve the user.

この節では、［ ~scroll留ngの機構について論じる ］ため, および［ 効果的な~scroll留ng策は どの様なものになるかについて，いくつかの指針を供する ］ために有用になる概念を，いくつか定義する。 ~UAには、 この指導に順応するように，［ 自身による最善な判定を適用しつつ，留ngにおける自前の挙動を定義する ］ことが奨励される。 それはまた、 作者が［ ~scroll留ngを念頭に，自身の~UIを設計する ］ときに依存できるような，［ 最低限の適度な挙動を確保するための，少数の要件 ］も供する。 ◎ This section defines some useful concepts to aid in discussing scroll-snapping mechanics, and provides some guidelines for what an effective scroll-snapping strategy might look like. User agents are encouraged to adapt this guidance and apply their own best judgement when defining their own snapping behavior. It also provides a small number of behavior requirements, to ensure a minimum reasonable behavior that authors can depend on when designing their interfaces with scroll-snapping in mind.

6.1. ~scrolling~methodの種別

~pageの~scroll動作は、 意図された［ 終止-位置 ／ 方向 ］の下で遂行される。 ~scrollingは、 この 2 つの組合nに応じて，次に挙げるものに類別される — それぞれが，少しばかり異なる扱いになるような： ◎ When a page is scrolled, the action is performed with an intended end position and/or an intended direction. Each combination of these two things defines a distinct category of scrolling, which can be treated slightly differently:

`終止-位置のみ意図され@ る~scroll ◎ intended end position

`終止-位置のみ意図され$る~scrollに共通的な例としては、 次が挙げられる： ◎ Common examples of scrolls with only an intended end position include:

• 勢いを伴わずに放された，~panning~gesture ◎ a panning gesture, released without momentum
• ~scrollbarの “つまみ” を明示的に操作するとき ◎ manipulating the scrollbar “thumb” explicitly
• `scrollTo()$m などの API を介して~program的に~scrollするとき ◎ programmatically scrolling via APIs such as scrollTo()
• 文書の~focus可能な要素を，~tabbing-throughするとき ◎ tabbing through the document’s focusable elements
• ~page内のある~anchorへ~navigateするとき ◎ navigating to an anchor within the page
• ~homing操作o — Home ／ End ~UIkeyなどによる ◎ homing operations such as the Home/End keys

`方向, 終止-位置ともに意図され@ る~scroll ◎ intended direction and end position

`方向, 終止-位置ともに意図され$る~scrollに共通的な例としては、 次が挙げられる： ◎ Common examples of scrolls with both an intended direction and end position include:

• 勢いを伴う “投げつけ（ `fling^en ）” ~gestureに解釈されるもの ◎ a “fling” gesture, interpreted with momentum
• `scrollBy()$m などの API を介して~program的に~scrollするとき ◎ programmatically scrolling via APIs such as scrollBy()
• ~paging — PageDown ／ PageUp ~UIkeyなどによる （あるいは ~scrollbarから誘発される等価な操作o） ◎ paging operations such as the PgUp/PgDn keys (or equivalent operations on the scrollbar)

この~scrollに意図される終止-点 — 留め点などの特能から干渉されない下でのそれ — を指して， `自然な終止-点@ という。 ◎ The intended end point of the scroll prior to intervention from features such as snap points is its natural end-point.

`方向のみ意図され@ る~scroll ◎ intended direction

`方向のみ意図され$る~scrollに共通的な例としては、 次が挙げられる： ◎ Common examples of scrolls with only an intended direction include:

• ~keyboardの矢印~UIkeyの押下げ（または~scrollbarに対する等価な操作o）によるもの ◎ pressing an arrow key on the keyboard (or equivalent operations on the scrollbar)
• （慣性的でなく）固定的な~scrollとして解釈されるような，~swiping~gesture ◎ a swiping gesture interpreted as a fixed (rather than inertial) scroll

加えて、 ~pageの内容は，通例的に［ 縦, 横 ］軸に整列するように~lay-outされるので、 ~UAは，その方向が［ 縦／横 ］に十分近いときには、 ~scrollをその `軸に~lock@ することもある。 `軸に~lock$された~scrollは、 その軸のみに沿って~scrollするよう束縛される。 これは、 入力の仕組みが精確さに欠くときでも， 軸からそれていかないようにする。 ◎ Additionally, because page layouts usually align things vertically and/or horizontally, UAs sometimes axis-lock a scroll when its direction is sufficiently vertical or horizontal. An axis-locked scroll is bound to only scroll along that axis. This prevents less-precise input mechanisms from drifting in the non-primary axis.

注記： この仕様が適用されるのは、 ~UAが~supportする~scrolling~methodに限られる。 ~UAには、 特定0の［ 入力／~scrolling ］~methodを~supportすることは，要求されない。 ◎ Note: This specification only applies to scrolling methods supported by the user agent; it does not require the user agent to support any particular input or scrolling method.

6.2. 留め位置の選び方

`~scroll容器$は、 その`~scroll可能な~overflow区画$に散らばる多数の`留め区画$を有し得る。 素朴な~algoで`留め位置$を選定すると，利用者にとって直感に反する挙動を生産し得るので、 選定~algoを設計する際には~careが要求される。 以下に，~UAが~~考慮すべき事項を挙げる： ◎ A scroll container can have many snap areas scattered throughout its scrollable overflow area. A naïve algorithm for selecting a snap position can produce behavior that is unintuitive for users, so care is required when designing a selection algorithm. Here are a few pointers that can aid in the selection process:

• `留め位置$は、［ 終止-点（または`自然な終止-点$）と最終的に留められる~scroll位置との距離 ］を最小~化するように選ぶべきである。 これは、 この節に挙げる追加的な拘束の~subjectになる。 ◎ Snap positions should be chosen to minimize the distance between the end-point (or the natural end-point) and the final snapped scroll position, subject to the additional constraints listed in this section.
• ~scrollが`軸に~lock$されていてる場合、 ~scrollしている間は，他方の軸における`留め位置$を無視するべきである （それでも、 他方の軸における`留め位置$は，最終的な~scroll位置に効果を及ぼし得る）。 ◎ If a scroll is axis-locked, any snap positions in the other axis should be ignored during the scroll. (However, snap positions in the other axis can still effect the final scroll position.)
• ［ ~screenから遠く外れた要素が~scroll位置に不可解な効果を及ぼす ］ことを防止するため、［ 各~要素の`留め位置$のうち，`留域$が定義する “回廊” から遠く外れたもの ］は，無視するべきである — ここでの回廊とは ⇒＃ `~scroll可能な~overflow区画$を通って移動する回廊 ／ `方向のみ意図され$た~scrollにおける~~仮想の “回廊” ／ `終止-位置のみ意図され$た~scroll後の`留域$ ◎ In order to prevent a far-offscreen element from having difficult-to-understand effects on the scroll position, snap positions should be ignored if their elements are far outside of the “corridor” that the snapport defines as it moves through the scrollable overflow area, or a hypothetical “corridor” in the direction of a scroll with only an intended direction, or the snapport after an scroll with only an intended end position.

• ~UAは、 ~scroll~methodに関わらず， 利用者が`留め位置$から “逃れられる” ことを確保する`モノトスル^em。 例えば，［ 留め種別が `mandatory$v で，次にある`留め位置$が~screen幅の 2 倍より離れている ］場合、 “常に最も近傍に留める” ような素朴な選定~algoでは，［ 終止-位置が~screen幅の 1 倍までしか離れていない場合に，利用者を “嵌め続ける” ］ことになりかねない。 代わりに，［ 終止-点までの距離が開始-時の`留め位置$から相応に近いときに限り，開始-時の`留め位置$に戻り、 他の場合は，開始-時の留め位置を無視する ］方が，もっと良い挙動を与える賢い~algoになる。 ◎ User agents must ensure that a user can “escape” a snap position, regardless of the scroll method. For example, if the snap type is mandatory and the next snap position is more than two screen-widths away, a naïve “always snap to nearest” selection algorithm might “trap” the user if their end position was only one screen-width away. Instead, a smarter algorithm that only returned to the starting snap position if the end-point was a fairly small distance from it, and otherwise ignored the starting snap position, would give better behavior.

  （これは、 `方向のみ意図され$る~scrollにおいては， 開始-時の`留め位置$を常に無視するモノトスルことを含意する。） ◎ (This implies that a scroll with only an intended direction must always ignore the starting snap positions.)

• ~target要素 %要素 を定義する素片 （例： `target$ps に合致するもの／ `scrollIntoView()$m の~targetになるもの） へ~pageが~navigateされたときは、 %要素 に`留め位置$が定義されている場合には，~UAは：

  • %要素 に最も近い`~scroll容器$ %容器 が`~scroll留め容器$であるならば、 %容器 を %要素 のいずれかの【縦, 横いずれかの軸における】`留め位置$に`留める$モノトスル。
  • 他の場合（ %容器 の `scroll-snap-type$p は `none^v のとき）でも，そうしてヨイ。
  ◎ If a page is navigated to a fragment that defines a target element (e.g. one that would be matched by :target, or the target of scrollIntoView()), and that element defines some snap positions, the user agent must snap to one of that element’s snap positions if its nearest scroll container is a scroll snap container. The user agent may also do this even when the scroll container has scroll-snap-type: none.

`scroll-padding$p 用の物理的な下位prop

`scroll-padding$p を成すこれらの `下位prop$は、 順に，`留域$の［ 上端, 右端, 下端, 左端 ］辺を指定する。 負な値は無効。 ◎ These longhands of scroll-padding specify the top, right, bottom, and left edges of the snapport, respectively. Negative values are invalid.

`scroll-padding$p 用の~flowに相対的な下位prop

`scroll-padding$p を成すこれらの`下位prop$は、 順に，`留域$の［ 塊-始端, 行内-始端, 塊-終端, 行内-終端 ］辺を指定する。 負な値は無効。 ◎ These longhands of scroll-padding specify the block-start, inline-start, block-end, and inline-end edges of the snapport, respectively. Negative values are invalid.

これらは， `scroll-padding$p を成す`下位prop$であると同時に、 前者は［ `scroll-padding-block-start$p, `scroll-padding-block-end$p ］用の, 後者は［ `scroll-padding-inline-start$p, `scroll-padding-inline-end$p ］用の`略式~prop$であり、 順に，`留域$の［ `塊-軸$, `行内-軸$ ］辺を指定する。 ◎ These shorthands of scroll-padding-block-start + scroll-padding-block-end and scroll-padding-inline-start + scroll-padding-inline-end are longhands of scroll-padding, and specify the block-axis and inline-axis edges of the snapport, respectively.

値が 2 個~指定された場合、 順に，［ 始端, 終端 ］用の値を与える。 ◎ If two values are specified, the first gives the start value and the second gives the end value.

値が 1 個だけ指定された場合、 その値が 2 個目の値も与える。 ◎ If only one value is specified, the second value defaults to the same value.

`scroll-margin$p 用の物理的な下位prop

`scroll-margin$p を成すこれらの`下位prop$は、 順に，`~scroll留め区画$の［ 上端, 右端, 下端, 左端 ］辺を指定する。 ◎ These longhands of scroll-margin specify the top, right, bottom, and left edges of the scroll snap area, respectively.

`scroll-margin$p 用の~flowに相対的な下位prop

`scroll-margin$p を成すこれらの`下位prop$は、 順に，`~scroll留め区画$の［ 塊-始端, 行内-始端, 塊-終端, 行内-終端 ］辺を指定する。 ◎ These longhands of scroll-margin specify the block-start, inline-start, block-end, and inline-end edges of the scroll snap area, respectively.

これらは， `scroll-margin$p を成す`下位prop$であると同時に、 前者は［ `scroll-margin-block-start$p, `scroll-margin-block-end$p ］用の, 後者は［ `scroll-margin-inline-start$p, `scroll-margin-inline-end$p ］用の`略式~prop$であり、 順に，`~scroll留め区画$の［ `塊-軸$, `行内-軸$ ］辺を指定する。 ◎ These shorthands of scroll-margin-block-start + scroll-margin-block-end and scroll-margin-inline-start + scroll-margin-inline-end are longhands of scroll-margin, and specify the block-axis and inline-axis edges of the scroll snap area, respectively.

値が 2 個~指定された場合、 順に，［ 始端, 終端 ］用の値を与える。 ◎ If two values are specified, the first gives the start value and the second gives the end value.

値が 1 個だけ指定された場合、 その値が 2 個目の値も与える。 ◎ If only one value is specified, the second value defaults to the same value.