Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Support validate options in node and mark attribute definitions. #5991

Open
wants to merge 2 commits into
base: next
Choose a base branch
from

Conversation

bobthecow
Copy link

Changes Overview

ProseMirror allows node and mark specs to define a validate function or type, which is used when deserializing JSON, parsing from the DOM, etc.

See https://prosemirror.net/docs/ref/#model.AttributeSpec.validate

Implementation Approach

Currently, default is the only attribute spec option passed through to ProseMirror when resolving the schema. This change updates getAttributesFromExtensions and getSchemaByResolvedExtensions (and relevant types) to also pass through any defined validate attribute option.

Testing Done

Manual testing (plus using the patch in production!)

Verification Steps

To use this, add a validate type or function option in any extension's addAttributes or addGlobalAttributes definition, e.g.:

export const NodeId = Extension.create({
  name: 'nodeId',

  addGlobalAttributes() {
    return [
      {
        types: [...],
        attributes: {
          nodeId: {
            default: '__node_id__',
            validate: 'string',
            ...
          }
        }
      }
    ]
  }
});

A more complex validation could ensure that the ID is shaped like a UUID, or allow it to be null or undefined.

Additional Notes

Checklist

  • I have created a changeset for this PR if necessary.
  • My changes do not break the library.
  • I have added tests where applicable.
  • I have followed the project guidelines.
  • I have fixed any lint issues.

Related Issues

…initions.

ProseMirror allows node and mark specs to define a `validate` function or type, which is used when deserializing JSON, parsing from the DOM, etc.

See https://prosemirror.net/docs/ref/#model.AttributeSpec.validate

Currently, `default` is the only attribute spec option passed through to ProseMirror when resolving the schema. This change updates `getAttributesFromExtensions` and `getSchemaByResolvedExtensions` (and relevant types) to also pass through any defined `validate` attribute option.

To use this, add a `validate` type or function option in any extension's `addAttributes` or `addGlobalAttributes` definition, e.g.:

```
export const NodeId = Extension.create({
  name: 'nodeId',

  addGlobalAttributes() {
    return [
      {
        types: [...],
        attributes: {
          nodeId: {
            default: '__node_id__',
            validate: 'string',
            ...
          }
        }
      }
    ]
  }
});
```

A more complex validation could ensure that the ID is shaped like a UUID, or allow it to be `null` or `undefined`.
Copy link

changeset-bot bot commented Jan 6, 2025

🦋 Changeset detected

Latest commit: f172ddb

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 57 packages
Name Type
@tiptap/core Major
@tiptap/extension-blockquote Major
@tiptap/extension-bold Major
@tiptap/extension-bubble-menu Major
@tiptap/extension-bullet-list Major
@tiptap/extension-character-count Major
@tiptap/extension-code-block-lowlight Major
@tiptap/extension-code-block Major
@tiptap/extension-code Major
@tiptap/extension-collaboration-cursor Major
@tiptap/extension-collaboration Major
@tiptap/extension-color Major
@tiptap/extension-document Major
@tiptap/extension-dropcursor Major
@tiptap/extension-floating-menu Major
@tiptap/extension-focus Major
@tiptap/extension-font-family Major
@tiptap/extension-font-size Major
@tiptap/extension-gapcursor Major
@tiptap/extension-hard-break Major
@tiptap/extension-heading Major
@tiptap/extension-highlight Major
@tiptap/extension-history Major
@tiptap/extension-horizontal-rule Major
@tiptap/extension-image Major
@tiptap/extension-italic Major
@tiptap/extension-link Major
@tiptap/extension-list-item Major
@tiptap/extension-list-keymap Major
@tiptap/extension-mention Major
@tiptap/extension-ordered-list Major
@tiptap/extension-paragraph Major
@tiptap/extension-placeholder Major
@tiptap/extension-strike Major
@tiptap/extension-subscript Major
@tiptap/extension-superscript Major
@tiptap/extension-table-cell Major
@tiptap/extension-table-header Major
@tiptap/extension-table-row Major
@tiptap/extension-table Major
@tiptap/extension-task-item Major
@tiptap/extension-task-list Major
@tiptap/extension-text-align Major
@tiptap/extension-text-style Major
@tiptap/extension-text Major
@tiptap/extension-typography Major
@tiptap/extension-underline Major
@tiptap/extension-utils Major
@tiptap/extension-youtube Major
@tiptap/html Major
@tiptap/pm Major
@tiptap/react Major
@tiptap/starter-kit Major
@tiptap/static-renderer Major
@tiptap/suggestion Major
@tiptap/vue-2 Major
@tiptap/vue-3 Major

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

Copy link

netlify bot commented Jan 6, 2025

Deploy Preview for tiptap-embed ready!

Name Link
🔨 Latest commit f172ddb
🔍 Latest deploy log https://app.netlify.com/sites/tiptap-embed/deploys/677d1a4737ce1e000800cc73
😎 Deploy Preview https://deploy-preview-5991--tiptap-embed.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify site configuration.

Copy link
Contributor

@nperez0111 nperez0111 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a fantastic PR, I'm going to merge this to be part of the next branch, as we are in a sort of feature freeze for Titpap v2

@nperez0111 nperez0111 changed the base branch from develop to next January 7, 2025 12:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants