毕设&课设&项目&实训-基于Django的网页版可视化调用与结果展示一体化解决方案.zip

<h1 align="center"> <a href='https://yaireo.github.io/tagify'><img src="/docs/readme-header.svg" width="320" height="160"><a/> <br><br> <a href='https://yaireo.github.io/tagify'>Tagify</a> - <em>tags</em> input component </h1> <p align="center"> Transforms an input field or a textarea into a <em>Tags component</em>, in an easy, customizable way, with great performance and small code footprint, exploded with features. <br> <strong>Vanilla</strong> ⚡ <strong>React</strong> ⚡ <strong>Vue</strong> ⚡ <strong>Angular</strong> <p> <h3 align="center"> 👉 <a href="https://yaireo.github.io/tagify">See Demos</a> 👈 </h3> <p align="center"> <a href='https://www.npmjs.com/package/@yaireo/tagify'> <img src="https://img.shields.io/npm/v/@yaireo/tagify.svg" /> </a> <a href='https://simple.wikipedia.org/wiki/MIT_License'> <img src="https://img.shields.io/badge/license-MIT-lightgrey" /> </a> <img src="https://img.shields.io/bundlephobia/minzip/@yaireo/tagify" /> <img src="https://img.shields.io/npm/dw/@yaireo/tagify" /> </p> <p align="center"> <img src="/docs/mix3.gif?sanitize=true" /> <img src="/docs/demo.gif?sanitize=true" /> </p> ## Table of Contents <!--ts--> * [Installation](#installation) * [What can Tagify do](#features) * [Building the project](#building-the-project) * [Adding tags dynamically](#adding-tags-dynamically) * [Output value](#output-value) * [Ajax whitelist](#ajax-whitelist) * [Edit tags](#edit-tags) * [Drag & Sort](#drag--sort) * [DOM Templates](#dom-templates) * [Suggestions selectbox](#suggestions-selectbox) * [Tags mixed with text](#mixed-content) * [Single-Value Only](#single-value) * [React wrapper](#react) * [Angular wrapper](#angular) * [Vue Example](https://codesandbox.io/s/tagify-tags-component-vue-example-l8ok4) * [jQuery version](#jquery-version) * [FAQ](#FAQ) * [CSS Variables](#css-variables) * [Methods](#methods) * [Events](#events) * [Hooks](#hooks) * [Settings](#settings) <!--te--> ## Installation ```sh npm i @yaireo/tagify --save ``` ### Usage (in your bundle): [live demo using Parcel as bundler](https://codesandbox.io/s/simple-tagify-setup-6pfi2) ```js import Tagify from '@yaireo/tagify' var tagify = new Tagify(...) ``` > Don't forget to **include `tagify.css`** file in your project. > CSS location: `@yaireo/tagify/dist/tagify.css` > SCSS location: `@yaireo/tagify/src/tagify.scss` > [See SCSS usecase & example](https://github.com/yairEO/tagify/pull/282) ## Features * Can be applied on input & textarea elements * Supports [mix content](#mixed-content) (text and tags together) * Supports [single-value](#single-value) mode (like `<select>`) * Supports whitelist/blacklist * Supports Templates for: <em>component wrapper</em>, <em>tag items</em>, <em>suggestion list</em> & <em>suggestion items</em> * Shows suggestions selectbox (flexiable settings & styling) at *full (component) width* or *next to* the typed texted (caret) * Allows setting suggestions' [aliases](#example-for-a-suggestion-item-alias) for easier fuzzy-searching * Auto-suggest input as-you-type with ability to auto-complete * Can paste in multiple values: `tag 1, tag 2, tag 3` or even newline-separated tags * Tags can be created by Regex delimiter or by pressing the "Enter" key / focusing of the input * Validate tags by Regex pattern * Tags may be [editable](#edit-tags) (double-click) * <del>ARIA accessibility support</del>(Component too generic for any meaningful ARIA) * Supports read-only mode to the whole componenet or per-tag * Each tag can have any properties desired (class, data-whatever, readonly...) * Automatically disallow duplicate tags (vis "settings" object) * Has built-in CSS loader, if needed (Ex. <em>AJAX</em> whitelist pulling) * Tags can be trimmed via `hellip` by giving `max-width` to the `tag` element in your `CSS` * Easily change direction to RTL (via the SCSS file) * Internet Explorer - A polyfill script should be used: `tagify.polyfills.min.js` (in `/dist`) * Many useful custom [events](#events) * Original input/textarea element values kept in sync with Tagify ## Building the project Simply run `gulp` in your terminal, from the project's path ([Gulp](https://gulpjs.com) should be installed first). Source files are this path: `/src/` Output files, which are automatically generated using Gulp, are in: `/dist/` The rest of the files are most likely irrelevant. ## Adding tags dynamically ```javascript var tagify = new Tagify(...); tagify.addTags(["banana", "orange", "apple"]) // or add tags with pre-defined propeties tagify.addTags([{value:"banana", color:"yellow"}, {value:"apple", color:"red"}, {value:"watermelon", color:"green"}]) ``` ## Output value There are two possible ways to get the value of the tags: 1. Access the tagify's instance's `value` prop: `tagify.value` (Array of tags) 2. Access the *original* input's value: `inputElm.value` (Stringified Array of tags) The most common way is to simply listen to the `change` event on the *original input* ```javascript var inputElm = document.querySelector, tagify = new Tagify (inputElm); inputElm.addEventListener('change', onChange) function onChange(e){ // outputs a String console.log(e.target.value) } ``` ### [Modify original input value format](https://jsbin.com/paxijaj/edit?html,js,output) Default format is a JSON string:<br> `'[{"value":"cat"}, {"value":"dog"}]'` I **recommend** keeping this because some situations might have values such as addresses (tags contain commas):<br> `'[{"value":"Apt. 2A, Jacksonville, FL 39404"}, {"value":"Forrest Ray, 191-103 Integer Rd., Corona New Mexico"}]'` Another example for complex tags state might be disabled tags, or ones with custom identifier *class*:<br> *(tags can be clicked, so delevopers can choose to use this to disable/enable tags)*<br> `'[{"value":"cat", "disabled":true}, {"value":"dog"}, {"value":"bird", "class":"color-green"}]'` To change the format, assuming your tags have no commas and are fairly simple: ```js var tagify = new Tagify(inputElm, { originalInputValueFormat: valuesArr => valuesArr.map(item => item.value).join(',') }) ``` **Output:**<br> `"cat,dog"` ## Ajax whitelist Dynamically-loaded suggestions list (*whitelist*) from the server (as the user types) is a frequent need to many. Tagify comes with its own loading animation, which is a very lightweight CSS-only code, and the <em>loading</em> state is controlled by the method `tagify.loading` which accepts `true` or `false` as arguments. Below is a basic example using the `fetch` API. I advise to abort the last request on any input before starting a new request. <details> <summary>Example:</summary> ```javascript var input = document.querySelector('input'), tagify = new Tagify(input, {whitelist:[]}), controller; // for aborting the call // listen to any keystrokes which modify tagify's input tagify.on('input', onInput) function onInput( e ){ var value = e.detail.value; tagify.settings.whitelist.length = 0; // reset the whitelist // https://developer.mozilla.org/en-US/docs/Web/API/AbortController/abort controller && controller.abort(); controller = new AbortController(); // show loading animation and hide the suggestions dropdown tagify.loading(true).dropdown.hide.call(tagify) fetch('http://get_suggestions.com?value=' + value, {signal:controller.signal}) .then(RES => RES.json()) .then(function(whitelist){ // update inwhitelist Array in-place tagify.settings.whitelist.splice(0, whitelist.length, ...whitelist) tagify.loading(false).dropdown.show.call(tagify, value); // render the suggestions dropdown }) } ``` </details> ## Edit tags Tags which aren't `read-only` can be edited by double-clicking them (by default) or by changing the `editTags` *setting* to `1`, making tags editable by single-clicking them. The value is saved on `blur` or by pressing `enter` key. Pressing `Escape` will revert the change trigger `blur`. <kbd>ctrl</