Components / viz.mark
VizPointControls
Edits the settings for point marks.
Generated from @oods/foundry 0.10.1
- Categories
- viz.mark
- Contexts
- form
- Readiness
react-and-vue
Playground
This component's contract doesn't list typed props, so the playground shows its documented example.
Documented example VizPointControls : append x to the first field, {"chartType":"scatter","encodings":{"x":{"field":"valuex","type":"quantitative"},"y":{"field":"other","type":"quantitative"},"shape":{"field":"category","type":"nominal"}}}.
The render follows the page's theme switch: light, dark or high contrast. Both frameworks render the same example.
Events it emits: change. Use either render above, and each event shows here with the framework that sent it.
Code
The documented example. HTML is the markup the React component renders for it, which @oods/component-styles styles.
import { VizPointControls } from '@oods/components-react';
import '@oods/component-styles/css';
const value = {
"chartType": "scatter",
"encodings": {
"x": {
"field": "value",
"type": "quantitative"
},
"y": {
"field": "other",
"type": "quantitative"
},
"shape": {
"field": "category",
"type": "nominal"
}
}
};
export function Example() {
return (
<VizPointControls
value={value}
/>
);
}Props, slots and events
Contract version 1.1.0. Types are from the React declarations in @oods/components-react.
| Prop | Type | Required | Documented example |
|---|---|---|---|
title | string | undefined | no | |
value | VizIntentFragment | undefined | no | {"chartType":"scatter","encodings":{"x":{"field":"value","type":"quantitative"},"y":{"field":"other","type":"quantitative"},"shape":{"field":"category","type":"nominal"}}} |
channel | "x" | "y" | undefined | no | |
disabled | boolean | undefined | no |
Slots
none
Events
change
States
bound, editing, invalid, disabled
Accessibility
- Role
textbox- How it gets its name
labeloninput[name="x.field"]
Keyboard
| Key | What it does |
|---|---|
| Tab | Focus the labelled chart input |
| x | Edit the declared field name |
Obligations in the contract
- Native labelled controls expose focus and invalid-edit feedback; successful edits emit a typed viz.render input fragment.
Point chart: controls the public Cartesian viz.render fragment, not the legacy HTML placeholder's unimplemented styling fields. The consumer supplies rows and calls the renderer. Opacity uses six bounded presets; fields/colors/scale/chart type preserve sibling input bindings. No consumer action is executed by this component.
Tokens
The token roles this component reads.
input.backgroundinput.borderinput.textinput.focusfield.message
Readiness
The evidence recorded for this component, with its label.
react-and-vue: catalog_list gives this label when the React and Vue components have complete readiness evidence, but the sweep's generated apps don't use the component in both.
| Evidence | React | Vue |
|---|---|---|
| state | implemented-evidence-complete | implemented-evidence-complete |
| versioned contract | passed | passed |
| target implementation | passed | passed |
| package export | passed | passed |
| public declaration | passed | passed |
| dependency closure | passed | passed |
| framework scenario | passed | passed |
| accessibility | verified | verified |
| interaction | verified | verified |
| visual themes | verified | verified |
Use your own
You can replace this component with your own React or Vue component. Map it, and generated code imports yours at the exact version you name. A contract report, run in a real browser, lists what your component met, what it didn't, and what wasn't checked.
The component_map call, with the parts in angle brackets yours to fill:
{
"action": "create",
"apply": true,
"externalSystem": "<your design system>",
"externalComponent": "<YourVizPointControls>",
"oodsTraits": [
"MarkPoint"
],
"substitution": {
"component": "VizPointControls",
"react": {
"package": "<your-package>/react",
"version": "<exact version>",
"export": "<YourVizPointControls>"
},
"vue": {
"package": "<your-package>/vue",
"version": "<exact version>",
"export": "<YourVizPointControls>"
}
}
} How this page was made
Generated at build from the published data, each source with the hash of what was read. The page's manifest.
- Contract:
@oods/component-contracts@0.10.1 componentContracts.VizPointControlssha256:271fc9522643… - Documented example:
@oods/component-contracts@0.10.1 sharedScenarios VizPointControlssha256:e40e1ebe4c47… - Catalog entry (catalog_list):
generated/0.10.1/system/catalog.json VizPointControlssha256:3a06b8c065a7… - React readiness:
@oods/components-react@0.10.1 readiness VizPointControlssha256:b2ea1bcdff08… - Vue readiness:
@oods/components-vue@0.10.1 readiness VizPointControlssha256:4f27aae2a1b2… - Prop types:
generated/0.10.1/components/prop-types.json VizPointControlssha256:3200947d11d0…