From 4b8ddecee7199922b1fb19a4cb19655b115d7b3b Mon Sep 17 00:00:00 2001 From: Farzad Hayat Date: Mon, 8 Jul 2024 17:00:41 +1000 Subject: [PATCH] INT-3312: Update README.md (#57) * INT-3312: Update README.md * Update README.md Co-authored-by: Daniel Oakman <141111365+danoaky-tiny@users.noreply.github.com> --------- Co-authored-by: Daniel Oakman <141111365+danoaky-tiny@users.noreply.github.com> --- README.md | 191 ++++-------------------------------------------------- 1 file changed, 11 insertions(+), 180 deletions(-) diff --git a/README.md b/README.md index 267d175..d078153 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,16 @@ -# TinyMCE Svelte component +# Official TinyMCE Svelte component ## About This package is a thin wrapper around [TinyMCE](https://github.com/tinymce/tinymce) to make it easier to use in a Svelte application. +* For the TinyMCE Svelte Quick Start, see: [TinyMCE Documentation - Svelte Integration](https://www.tiny.cloud/docs/tinymce/7/svelte-cloud/). +* For a self-hosted setup using TinyMCE package with TinyMCE Svelte, see: [TinyMCE Documentation - TinyMCE package with Svelte](https://www.tiny.cloud/docs/tinymce/7/svelte-pm/). +* For a self-hosted setup using TinyMCE .zip package with TinyMCE Svelte, see: [TinyMCE Documentation - TinyMCE .zip package with Svelte](https://www.tiny.cloud/docs/tinymce/7/svelte-zip/). +* For the TinyMCE Svelte Technical Reference, see: [TinyMCE Documentation - TinyMCE Svelte Technical Reference](https://www.tiny.cloud/docs/tinymce/7/svelte-ref/). +* For our quick demos, check out the TinyMCE Svelte [Storybook](https://tinymce.github.io/tinymce-svelte/). + + ## Quick start ### Create a Svelte App from a template @@ -15,7 +22,7 @@ cd my-tiny-app ### Add the Editor component -Installl the editor component in your project +Install the editor component in your project ``` npm install @tinymce/tinymce-svelte @@ -36,183 +43,7 @@ import Editor from '@tinymce/tinymce-svelte'; ``` -## TinyMCE Svelte technical reference - -### Configuring the TinyMCE svelte integration - -The editor component accepts the following properties: - -``` - -``` - -#### ApiKey - -Tiny Cloud API key. Required for deployments using the Tiny Cloud to provide the TinyMCE editor. - -Default value: no-api-key -Type: string - -##### Example using ApiKey -``` - - -``` -#### License Key - -Tiny Cloud license key. Use this when self-hosting TinyMCE instead of loading from Tiny Cloud. - -Default value: undefined -Type: "gpl" or a valid TinyMCE license key - -##### Example using licenseKey -``` - -``` - -#### Channel - -Specifies the Tiny Cloud channel to use. For more information on TinyMCE development channels, see: [Specifying the TinyMCE editor version deployed from Cloud - dev, testing, and stable releases](https://www.tiny.cloud/docs/cloud-deployment-guide/editor-plugin-version/#devtestingandstablereleases) - -Default value: '5' -Type: string - -##### Example using channel -``` - -``` - -#### CssClass - -Specifies the name of the class or classes to use for the `div` wrapping the editor. - -Default value: 'tinymce-wrapper' -Type: string - -##### Example using cssClass -``` - - -``` - -#### Id - -Specified an Id for the editor. Used for retrieving the editor instance using the `tinymce.get('ID')` method. - -Default value: Automatically generated UUID -Type: string - -##### Example using Id -``` - -``` - -#### Inline - -Set the editor to inline mode. - -Default value: false -Type: bool - -##### Example using Inline -``` - -``` - -#### Disabled - -Set the editor to readonly mode. - -Default value: false -Type: bool - -##### Example using Disabled -``` - -``` - -#### Conf - -Specify a set of properties for the `Tinymce.init` method to initialize the editor. - -Default value: {} -Type: Object - -##### Example using Conf -``` - -
- -
-``` - -### Component binding - -#### Input binding - -The editor component allows users to bind the contents of editor to a variable. By specifying the `bind:value`, users can do two-way binding on a select variable. - -#### Example of input binding - -``` - -
- -
{@html value}
- -
-``` - - -#### Binding text output - -The editor exposes the `text` property as a read-only value you can bind to get the editor content as text. It is important to remember that changes will not propagate up the editor if the text bound variable changes. It will only propagate changes from the editor. -#### Example of text binding +### Issues -``` - -
- -
{text}
-
-``` \ No newline at end of file +Have you found an issue with tinymce-svelte or do you have a feature request? Open up an [issue](https://github.com/tinymce/tinymce-svelte/issues) and let us know or submit a [pull request](https://github.com/tinymce/tinymce-svelte/pulls). *Note: For issues concerning TinyMCE please visit the [TinyMCE repository](https://github.com/tinymce/tinymce).* \ No newline at end of file