API de transformations
17 min
les transforms sont des fonctions d’assistance qui opèrent sur le document elles peuvent être utilisées pour définir vos propres commandes options de nœud docid\ n1djuyjsvzlrs5eeg5z1vméthodes statiques docid\ n1djuyjsvzlrs5eeg5z1vtransforms de nœud docid\ n1djuyjsvzlrs5eeg5z1vtransforms de sélection docid\ n1djuyjsvzlrs5eeg5z1vtransforms de texte docid\ n1djuyjsvzlrs5eeg5z1vtransforms de l’éditeur docid\ n1djuyjsvzlrs5eeg5z1v options de nœud toutes les transforms prennent en charge un paramètre options cela inclut des options spécifiques à la transform, ainsi que des nodeoptions générales pour préciser sur quels nœuds du document la transform est appliquée interface nodeoptions { at? location match? (node node, path location) => boolean mode? 'highest' | 'lowest' voids? boolean } l’option à sélectionne une emplacement docid\ bjhocffjjpgpomv99nfbw dans l’éditeur par défaut, elle correspond à la sélection actuelle de l’utilisateur en savoir plus sur l’option at docid\ t7rxa56eyva1ymry3zpsc l’option match filtre l’ensemble des nœuds avec une fonction personnalisée en savoir plus sur l’option match docid\ t7rxa56eyva1ymry3zpsc l’option mode filtre également l’ensemble des nœuds lorsque vides est false, les éléments void docid\ n1djuyjsvzlrs5eeg5z1v sont filtrés méthodes statiques transforms de nœud transforms qui opèrent sur des nœuds transforms insertfragment(editor editor, fragment node\[], options?) insère un fragment de nœuds à l’emplacement spécifié dans le document si aucun emplacement n’est spécifié, insère à la sélection actuelle options {at? location, hanging? boolean, voids? boolean} transforms insertnodes(editor editor, nodes node | node\[], options?) insère atomiquement des nœuds à l’emplacement spécifié dans le document si aucun emplacement n’est spécifié, insère à la sélection actuelle s’il n’y a pas de sélection, insère à la fin du document options prises en charge nodeoptions & {hanging? boolean, select? boolean} par exemple, pour insérer à la toute fin, sans remplacer la sélection actuelle et indépendamment de l’imbrication des blocs, utilisez transforms insertnodes( editor, { type targettype, children \[{ text '' }] }, { at \[editor children length] } ) transforms removenodes(editor editor, options?) supprime les nœuds à l’emplacement spécifié dans le document si aucun emplacement n’est spécifié, supprime les nœuds dans la sélection options prises en charge nodeoptions & {hanging? boolean} transforms mergenodes(editor editor, options?) fusionne un nœud à l’emplacement spécifié avec le nœud précédent au même niveau de profondeur si aucun emplacement n’est spécifié, utilise la sélection les nœuds conteneurs vides résultants sont supprimés options prises en charge nodeoptions & {hanging? boolean} transforms splitnodes(editor editor, options?) divise les nœuds à l’emplacement spécifié si aucun emplacement n’est spécifié, divise la sélection options prises en charge nodeoptions & {height? number, always? boolean} transforms wrapnodes(editor editor, element element, options?) enveloppe les nœuds à l’emplacement spécifié dans le conteneur élément si aucun emplacement n’est spécifié, enveloppe la sélection options prises en charge nodeoptions & {split? boolean} options mode 'tous' est également pris en charge options split indique qu’il est acceptable de diviser un nœud afin d’envelopper l’emplacement par exemple, si ipsum était sélectionné dans un nœud texte contenant lorem ipsum dolar , split true envelopperait uniquement le mot ipsum , entraînant la division du nœud texte si split false , le nœud texte entier contenant lorem ipsum dolar serait enveloppé transforms unwrapnodes(editor editor, options?) retire l’enveloppe des nœuds à l’emplacement spécifié si nécessaire, le nœud parent est divisé si aucun emplacement n’est spécifié, utilise la sélection options prises en charge nodeoptions & {split? boolean} pour options mode , 'tous' est également pris en charge transforms setnodes(editor editor, props partial\<node>, options?) définit les propriétés des nœuds à l’emplacement spécifié si aucun emplacement n’est spécifié, utilise la sélection options prises en charge nodeoptions & {hanging? boolean, split? boolean} pour options mode , 'tous' est également pris en charge transforms unsetnodes(editor editor, props string | string\[], options?) annule les propriétés des nœuds à l’emplacement spécifié si aucun emplacement n’est spécifié, utilise la sélection options prises en charge nodeoptions & {split? boolean} pour options mode , 'tous' est également pris en charge transforms liftnodes(editor editor, options?) remonte les nœuds à l’emplacement spécifié dans l’arborescence du document si nécessaire, le nœud parent est divisé si aucun emplacement n’est spécifié, utilise la sélection options prises en charge nodeoptions pour options mode , 'tous' est également pris en charge transforms movenodes(editor editor, options) déplace les nœuds depuis une source vers une destination une destination doit être spécifiée dans les options si aucune source n’est spécifiée, déplace la sélection options prises en charge nodeoptions & {to path} pour options mode , 'tous' est également pris en charge transformations de sélection transformations qui opèrent sur la sélection du document transforms collapse(editor editor, options?) réduit la sélection à un seul point options {edge? 'anchor' | 'focus' | 'start' | 'end'} transforms select(editor editor, target location) définit la sélection sur une nouvelle valeur spécifiée par cible lorsqu’une sélection existe déjà, cette méthode est simplement un proxy pour setselection et mettra à jour la valeur existante par exemple, pour définir la sélection sur l’intégralité du contenu de l’éditeur transforms select(editor, { anchor editor start(editor, \[]), focus editor end(editor, \[]), }) transforms deselect(editor editor) désactiver la sélection transforms move(editor editor, options?) déplacer le point de la sélection vers l'avant ou vers l'arrière options {distance? number, unit? 'offset' | 'character' | 'word' | 'line', reverse? boolean, edge? 'anchor' | 'focus' | 'start' | 'end'} transforms setpoint(editor editor, props partial\<point>, options?) définir de nouvelles propriétés sur l’un des points de la sélection options {edge? 'anchor' | 'focus' | 'start' | 'end'} transforms setselection(editor editor, props partial\<range>) définir de nouvelles propriétés sur une sélection active comme la valeur est un partial\<range> , cette méthode ne peut gérer que les mises à jour d’une sélection existante s’il n’y a aucune sélection active, l’opération sera annulée utilisez sélectionner si vous souhaitez créer une sélection lorsqu’il n’y en a aucune transformations de texte transformations qui opèrent sur le texte transforms delete(editor editor, options?) supprimer du texte dans le document options {at? location, distance? number, unit? 'character' | 'word' | 'line' | 'block', reverse? boolean, hanging? boolean, voids? boolean} transforms inserttext(editor editor, text string, options?) insérer une chaîne de texte à l’emplacement spécifié dans le document si aucun emplacement n’est spécifié, insérer à la sélection actuelle options {at? location, voids? boolean} transformations de l’éditeur transforms transform(editor editor, transform transform) transformer l’ éditeur par une opération