Line

Read as Markdown

import { Line } from "@pibbl/core";

Line uses LineProps and LineStyle. Its numeric coordinate pairs define an ordered polyline; it rejects children. Stroke targeting uses lineInteractionWidth when supplied. Coordinates must be finite logical Canvas units.

<Line
  style={{
    coords: [
      [12, 72],
      [64, 20],
      [128, 72],
    ],
    stroke: "#1d4ed8",
    strokeWidth: 5,
  }}
/>

Try the Line live example.

API details from source

Describes a polyline primitive for JSX or createElement authoring.

Line: PibblPrimitiveComponent<LineProps, PrimitiveInput<LineProps, LineStyle>>

Parameters

props — Authored component inputs, supplied through JSX or createElement. See the linked props and style types.

Throws

When called directly; Pibbl mounts this component through JSX or createElement.

Implementation guidance for agents

Read the Drawing, layout, and effects companion for ownership, adaptation, failure modes, and verification. Agent start provides the version-selection workflow.

Complete minimal example

Compile this TSX module with jsx: "react-jsx" and jsxImportSource: "@pibbl/core", then load it from a browser entry point after the document body exists. It creates and mounts one canvas; dispose the controller before removing or replacing that canvas. The interactive study linked below adds controls beyond this minimal use case.

Download source

/** @jsxImportSource @pibbl/core */
import { pibbl, Line } from '@pibbl/core';

const canvas = document.createElement('canvas');
canvas.width = 320;
canvas.height = 240;
document.body.append(canvas);

const controller = pibbl(canvas, (
<Line
  style={{
    coords: [
      [12, 72],
      [64, 20],
      [128, 72],
    ],
    stroke: "#1d4ed8",
    strokeWidth: 5,
  }}
/>
));

window.addEventListener('pagehide', () => controller.dispose(), { once: true });

Complete minimal examples

Lines and authored paths: Combine polyline, axis-aligned strokes, mutable geometry, and SVG path data. Plain source

Interactive examples

Line · Full page

Documentation version

Documentation built with @pibbl/core 0.0.2, revision 380919b. ALPHA — NOT FOR PRODUCTION USE.