折れ線チャートのオプション
LineChartOptions API。シリーズ、軸、インタラクション、アニメーション、ラベル、オーバーレイ、及び詳細度を構成します。
import type { LineChartOptions } from "@sixtyfold/line";上記の公開エントリポイントを使用します。型のみのインポートはアプリケーション JavaScript から削除されます。
BandOptions
範囲/バンド固有の視覚オプション
インポート @sixtyfold/line・インターフェース
interface BandOptions| メンバー | 定義 | 説明 |
|---|---|---|
border | string | undefined | 上下境界の共通境界色(ボーダーが有効な場合はデフォルトでシリーズ色) |
border | BandBorderStyle | undefined= solid | ボーダーの線種 |
border | number | undefined | 境界線の幅(ピクセル)。境界線を無効にするには0に設定します。 |
fill? | number | boolean | undefined | バンドの塗りつぶし。 - false: 塗りつぶしなし - true: シリーズ色で既定の不透明度で塗りつぶす - number (0-1): 指定した不透明度でシリーズ色を塗りつぶす |
fill | string | SeriesGradient | undefined | バンドの塗り色 — 単色文字列またはグラデーションオブジェクト。指定されている場合は塗り不透明度を上書きします |
lower | string | undefined | 下限の色を上書きします |
upper | string | undefined | 上側境界線の色を上書き |
BarOptions
棒/カラム固有の表示オプション
Import @sixtyfold/line·interface
interface BarOptions| メンバー | 定義 | 説明 |
|---|---|---|
baseline? | number | undefined= 0 | 棒が成長するデータ値 |
border | string | undefined | 共通の棒の境界線色(境界線有効時はデフォルトでシリーズ色) |
border | BarBorderStyle | undefined= solid | 境界線の線種 |
border | number | undefined | 境界線の幅(ピクセル)。0に設定すると境界線を無効化します。 |
fill? | number | boolean | undefined | 棒の塗りつぶし。- false: 塗りなし - true: シリーズの色で既定の不透明度で塗る - 数値 (0–1): 指定した不透明度でシリーズの色を塗る |
fill | string | SeriesGradient | undefined | 棒の塗り色 — 単色文字列またはグラデーションオブジェクト。指定されている場合、塗りの不透明度を上書きします |
max | number | undefined= 24 | ピクセル単位の最大バー幅 |
min | number | undefined= 1 | ピクセル単位の最小バー幅 |
width | number | undefined= 0.7 | 利用可能なサンプル間隔に対する各バーで使用される比率 |
LegendLabelFontOptions
凡例ラベルのフォントに関するオプション。
Import @sixtyfold/line·interface
interface LegendLabelFontOptionsLegendOptions
Canvas2D組み込み凡例の配置、レイアウト、タイポグラフィ、スウォッチ、インタラクション。
インポート @sixtyfold/line·インターフェイス
interface LegendOptions| Member | Definition | 説明 |
|---|---|---|
align? | LegendAlign | undefined= center | 凡例領域内の配置 |
allow | boolean | undefined= false | すべての系列を非表示にできるようにする |
inactive | number | undefined= 0.45 | 非表示の系列の凡例項目の不透明度 |
interactive? | boolean | undefined= false | クリックで切り替える対話を有効にする |
item | number | undefined= 12 | 項目間の間隔(ピクセル) |
label | LegendLabelFontOptions | undefined | 凡例ラベルのフォントスタイル |
layout? | LegendLayout | undefined= column | アイテムのレイアウト |
padding? | { top?: number; right?: number; bottom?: number; left?: number; } | undefined= 8 | 凡例領域内のパディング(px) |
position? | LegendPosition | undefined= right | チャート領域周辺の凡例位置 |
swatch? | LegendSwatchOptions | undefined | スウォッチのスタイルオプション |
swatch | number | undefined= 6 | スウォッチとラベル間の間隔(px) |
visible? | boolean | undefined | 凡例を表示します。legend を指定すると既定で有効になり、legend を省略すると無効になります。 |
LegendSwatchOptions
凡例スウォッチのオプション。
Import @sixtyfold/line·interface
interface LegendSwatchOptions| メンバー | 定義 | 説明 |
|---|---|---|
border | string | undefined= transparent | スウォッチの境界色 |
border | number | undefined= 0 | スウォッチの境界幅(px) |
shape? | LegendSwatchShape | undefined= circle | スウォッチの形状 |
size? | number | undefined= 10 | スウォッチのサイズ(px) |
LineAppearanceOptions
折れ線グラフの外観 — ベース外観 + 凡例 + マーカー
Import @sixtyfold/line·interface
interface LineAppearanceOptions extends BaseAppearanceOptions| メンバー | 定義 | 説明 |
|---|---|---|
axis? | AxisAppearanceOptions | undefined | ランタイムでの軸の外観オプション。 |
chart | BackgroundOptions | undefined | チャートの背景に関する実行時表示オプション。 |
crosshair | CrosshairOptions | undefined | クロスヘアスタイルに関する実行時表示オプション。 |
grid? | GridOptions | undefined | グリッドに関する実行時表示オプション。 |
labels? | ChartLabels | undefined | ラベルに関する実行時表示オプション。 |
legend? | LegendOptions | undefined | 凡例の実行時表示オプション。 |
marker? | MarkerOptions | undefined | マーカーの実行時表示オプション。 |
overlay? | OverlayOptions | undefined | オーバーレイの実行時表示オプション。 |
padding? | PaddingOptions | undefined | パディングの実行時表示オプション。 |
range | RangeSelectorAppearanceOptions | undefined | 範囲セレクターのランタイム表示オプション。 |
selection? | SelectionOptions | undefined | 選択のランタイム表示オプション。 |
text | TextDirection | undefined | テキスト方向のランタイム表示オプション。 |
tooltip? | TooltipOptions | undefined | ツールチップのランタイム表示オプション。 |
LineChartOptions
ラインチャートの構築、操作、外観、系列、および詳細度(LOD)オプション。
インポート @sixtyfold/line·インターフェース
interface LineChartOptions| メンバー | 定義 | 説明 |
|---|---|---|
animated? | boolean | undefined | データの表示およびビューポート/軸の遷移をアニメーション化します。省略した場合、ブラウザがprefers-reduced-motion: reduceを報告していない限りアニメーションは有効になります。 |
axis? | AxisOptions | undefined | 軸のカスタマイズ(線色およびラベル色) |
chart | BackgroundOptions | undefined= #16213e | チャート背景(プレビュー領域を含むキャンバス全体を覆います)。単色文字列、グラデーション定義、または画像を指定できます。 |
crosshair | CrosshairOptions | undefined | クロスヘア線のスタイリング(垂直および水平のガイド線) |
grid? | GridOptions | undefined | メインチャートのグリッド線カスタマイズ |
interactive? | boolean | undefined= true | ユーザー操作(パン/ズーム/ピンチ)を有効にします。false の場合、チャートは閲覧専用になりますが、ホバー時のクロスヘア/ツールチップは表示されます。 |
interpolation? | "none" | "linear" | "spline" | undefined= linear | データ点間の値の補間モード — 'none': 補間なし、最も近いデータ点にスナップ — 'linear': 隣接点間の線形補間 — 'spline': 滑らかな曲線のための Catmull-Rom スプライン補間 |
keep | number | undefined= 0 (disabled) | Safari が GPU リソースを解放するのを防ぐためのキープアライブ間隔(秒)。Safari は「未使用」キャンバスを積極的にクリーンアップし、チャートが白くなることがあります。 |
keyboard | "focus" | "hover" | undefined | キーボード操作が有効になる方法。- "focus"(デフォルト):チャートが DOM フォーカスを持つ必要がある - "hover": マウスポインタ下のチャートがキーボードナビゲーションを受け取る |
keyboard | false | KeyboardAnnouncementMessages | undefined | 支援技術向けにキーボード操作のアナウンスをローカライズするか、無効化するには false を設定してください。省略されたメッセージは簡潔な英語のデフォルトが使用されます。 |
keyboard | number | undefined= 0.1 (10%) | キーボードでのパン速度(矢印キー)。各キー押下ごとに表示範囲の何分の一をパンするか。1(10%) |
keyboard | number | undefined= 0.1 (10% per keypress) | キーボードズーム速度(+/-キー)。値が大きいほどズームが速くなります。1(各キー押下で10%) |
labels? | ChartLabels | undefined | チャート周辺のテキストラベル(タイトル、軸ラベル) |
legend? | LegendOptions | undefined | 系列凡例オプション |
lod? | LineLODOptions | undefined | 詳細度表示ポリシー。 |
marker? | MarkerOptions | undefined | ホバー時ポイントの既定マーカースタイル(系列ごとに上書き可能) |
min | number | undefined | インタラクティブなXビューポートの最小幅(チャートのX値と同じ単位で表現)。無効または非正の値はチャートタイプの既定値を維持します。この構成オプションは可変の外観設定には含まれません。 |
overlay? | OverlayOptions | undefined | チャートコンテンツの上にレンダリングされる宣言的オーバーレイプリミティブ |
padding? | PaddingOptions | undefined= { top: 20, right: 80, bottom: 40, left: 80 } | ピクセル単位のカスタムパディング |
range | RangeSelectorOptions | undefined | 範囲セレクター(プレビュー表示チャート)の設定 |
renderer | number | undefined= 15000 | レンダラー起動に許可される最大時間(ミリ秒)。ウォッチドッグはチャート構築中に開始するため、BaseChart.initializeをawaitしないアプリケーションも保護します。無効にするには0に設定してください。 |
render | "auto" | "worker" | "main" | undefined | 描画モードを選択します。auto は Worker + OffscreenCanvas を優先し、worker は未対応時にメインスレッドへフォールバックし、main は DOM を必要とするブラウザーのメインスレッドで描画します。 |
selection? | SelectionOptions | undefined | 選択範囲(ドラッグでズーム)のスタイル指定 |
series? | SeriesOptions[] | undefined | シリーズごとの設定(色、塗りつぶし、グラデーション) |
text | TextDirection | undefined= inherit | Canvas2Dテキストに使用する方向。各文字列の最初の強い文字から推論するには"auto"を使用し、チャート全体の方向を強制するには"rtl"/"ltr"を使用してください。 |
tooltip? | TooltipOptions | undefined | ツールチップ(クロスヘア情報ボックス)のスタイル |
wheel | "up-in" | "up-out" | undefined | マウスホイールのズーム方向。 - 「up-in」(既定):ホイールを上/後方に回すとズームイン、下/前方でズームアウト - 「up-out」:ホイールを上/後方に回すとズームアウト、下/前方でズームイン |
wheel | number | undefined= 0.1 (10% per wheel tick) | マウスホイールのズーム速度。値が大きいほどズームが速くなります。1(ホイール1目盛りあたり10%) |
y | YDomainOptions | undefined | 描画されるYドメインの片側または両側を固定します。省略された辺は表示中のデータから自動スケールを継続します。両端の有限値を指定すると、ズーム、詳細度(LOD)選択、およびストリーミング更新間でYビューポートが安定します。このオプションはデフォルトで無効であり、可変の表示設定ではなく構築時の構成です。 |
LineChartStatsOptions
ラインのテレメトリが公開される頻度を制御します。
インポート @sixtyfold/line·インターフェース
interface LineChartStatsOptionsLineDataUpdateOptions
一括のラインデータ置換で使用されるアニメーション遷移を制御します。
インポート @sixtyfold/line·インターフェース
interface LineDataUpdateOptionsLineLODOptions
安定したスクリーンスペースでの表示ポリシーと忠実度/滑らかさの係数。
インポート @sixtyfold/line·インターフェース
interface LineLODOptionsMarkerGlowOptions
ホバー マーカー用のオプションのグロー効果
インポート @sixtyfold/line·インターフェース
interface MarkerGlowOptionsMarkerOptions
ホバーポイント表示のマーカーオプション
Import @sixtyfold/line·interface
interface MarkerOptions| メンバー | 定義 | 説明 |
|---|---|---|
border | string | undefined= #fff | 境界線/ストロークの色 |
border | number | undefined= 1 | 境界線/ストロークの幅(ピクセル) |
glow? | boolean | MarkerGlowOptions | undefined | マーカーの周囲に任意のグロー |
shape? | MarkerShape | undefined= circle | マーカー形状 |
size? | number | undefined= 5 | マーカーのサイズ(ピクセル)— 円の場合は半径、その他は半幅 |
PointOptions
散布図/ポイント固有の視覚オプション
インポート @sixtyfold/line·インターフェース
interface PointOptions| メンバー | 定義 | 説明 |
|---|---|---|
border | string | undefined= #fff | ポイントの境界線/ストロークの色 |
border | number | undefined= 0 | ポイントの境界線/ストローク幅(ピクセル) |
color? | string | undefined | ポイントの塗りの色(デフォルトはシリーズの色) |
opacity? | number | undefined= 1 | ポイントの不透明度 0–1 |
shape? | MarkerShape | undefined= circle | 点の形状 |
size? | number | undefined= 3 | ピクセル単位の点サイズ — 円は半径、その他は半幅 |
SeriesAppearanceOptions
シリーズごとの表示フィールド — 視覚的およびプレゼンテーションのみ
インポート @sixtyfold/line·型
type SeriesAppearanceOptions = Pick<SeriesOptions, "type" | "color" | "fill" | "fillColor" | "fillToZero" | "fillEffect" | "band" | "bar" | "stack" | "point" | "width" | "name" | "unit" | "marker">| Member | Definition | Description |
|---|---|---|
band? | BandOptions | undefined | 範囲/バンドごとの塗りと境界のスタイリング |
bar? | BarOptions | undefined | 棒/カラムごとの塗り、境界、幅、およびベースラインのスタイリング |
color? | string | undefined | 線の色(指定がない場合はデフォルトパレットにフォールバック) |
fill? | number | boolean | undefined | 線の下の領域を塗りつぶします。 - false: 塗りつぶさない(デフォルト) - true: 線の色を40%不透明度で塗りつぶす - number (0-1): 指定した不透明度で線の色を塗りつぶす |
fill | string | SeriesGradient | undefined | 塗りつぶしの色 — 単色のカラーストリングまたはグラデーションオブジェクト。指定されている場合は塗りつぶし不透明度を上書きします |
fill | "none" | "glow" | "layered" | undefined | 塗りつぶしスタイル効果 — 'none': 平坦な単色塗り(デフォルト) - 'glow': 線から柔らかい光彩が広がる - 'layered': 深みを出すため不透明度を変えた重ね塗り |
fill | boolean | undefined= true | ゼロ基準まで塗りつぶす(チャート下端ではなく) true のとき: 正の値はゼロまで下方向に塗られ、負の値はゼロまで上方向に塗られます false のとき: 常にチャート下端まで塗りつぶします |
marker? | MarkerOptions | undefined | この系列のホバーポイントのマーカースタイル(チャートレベルのマーカーを上書きします) |
name? | string | undefined | 系列の表示名(凡例およびツールチップで使用されます)。 |
point? | PointOptions | undefined | 散布図/ポイント固有のマーカーのスタイリング |
stack? | StackOptions | undefined | 積み上げ面グラフ固有の塗りと上端境界のスタイリング |
type? | LineSeriesType | undefined= line | 系列の描画スタイル。"step"は"step-after"の別名、"band"は"range"の別名、"points"は"scatter"の別名、"column"は"bar"の別名、"stackedArea"は"stacked-area"の別名です。 |
unit? | UnitOptions | undefined | この系列の単位設定(ツールチップおよび軸ラベルで使用) |
width? | number | undefined= 1.5 | 線のストローク幅(ピクセル)。範囲の塗り、ツールチップ、その他の系列レイヤーは維持したままストロークのみを抑制するには0に設定します。 |
SeriesGradient
系列の塗りに使うグラデーション定義
インポート @sixtyfold/line·インターフェース
interface SeriesGradientSeriesOptions
単一シリーズの構成
Import @sixtyfold/line·interface
interface SeriesOptions| メンバー | 定義 | 説明 |
|---|---|---|
band? | BandOptions | undefined | 範囲/バンドごとの塗りつぶしおよび境界線のスタイリング |
bar? | BarOptions | undefined | 棒/カラムごとの塗りつぶし、境界線、幅、およびベースラインのスタイリング |
color? | string | undefined | 線の色(指定がない場合はデフォルトパレットにフォールバック) |
fill? | number | boolean | undefined | 線の下の領域を塗りつぶします。 - false: 塗りつぶさない(デフォルト) - true: 線の色で不透明度40%で塗りつぶす - 数値(0〜1): 指定された不透明度で線の色で塗りつぶす |
fill | string | SeriesGradient | undefined | 塗りの色 — 単色文字列またはグラデーションオブジェクト。指定されている場合は塗りの不透明度を上書きします |
fill | "none" | "glow" | "layered" | undefined | 塗りスタイル効果 — 'none': 単色塗り(デフォルト) — 'glow': 線から広がるソフトグロー — 'layered': 不透明度を変えた重ね塗りで奥行きを表現 |
fill | boolean | undefined= true | チャートの底ではなくゼロ基準に向かって塗る true の場合:正の値はゼロまで塗り下ろし、負の値はゼロまで塗り上げる false の場合:常にチャート底まで塗る |
marker? | MarkerOptions | undefined | この系列のホバーポイント用マーカースタイル(チャートレベルのマーカーを上書き) |
name? | string | undefined | シリーズ表示名(凡例とツールチップで使用)。 |
point? | PointOptions | undefined | 散布/ポイント固有のマーカー スタイリング |
stack? | StackOptions | undefined | 積み上げエリア固有の塗りと上端境界のスタイリング |
type? | LineSeriesType | undefined= line | シリーズ描画スタイル。"step"は"step-after"の別名;"band"は"range"の別名;"points"は"scatter"の別名;"column"は"bar"の別名;"stackedArea"は"stacked-area"の別名。 |
unit? | UnitOptions | undefined | この系列の単位設定(ツールチップと軸ラベルで使用) |
width? | number | undefined= 1.5 | 線のストローク幅(ピクセル)。塗りつぶし、ツールチップ、その他の系列レイヤーを保持したままストロークのみ無効にするには0に設定します。 |
StackOptions
積み上げ面グラフ固有の表示オプション
インポート @sixtyfold/line·interface
interface StackOptions| Member | Definition | Description |
|---|---|---|
border | string | undefined | 上辺の色(既定はシリーズの色) |
border | StackBorderStyle | undefined= solid | 上辺の線種 |
border | number | undefined | 上辺の幅(ピクセル単位、既定はシリーズ幅)。無効にするには0に設定。 |
curve? | StackCurveStyle | undefined= linear | 塗りつぶされた帯と上境界の境界形状。 |
fill? | number | boolean | undefined | 積み上げ領域を塗りつぶします。 - false: 領域を塗りつぶさない - true: シリーズ色でデフォルト不透明度で塗りつぶす - 数値 (0-1): 指定した不透明度でシリーズ色を塗りつぶす |
fill | string | SeriesGradient | undefined | 領域塗りつぶしの色 — 単色のカラー文字列またはグラデーションオブジェクト。指定されている場合は塗り不透明度を上書きします |