Farbtastic 技术文档

2024-12-16 15:00:53作者：尤辰城Agatha

jQuery Color Wheel

项目地址：https://gitcode.com/gh_mirrors/fa/farbtastic

1. 安装指南

为了使用 Farbtastic 插件，您需要遵循以下步骤：

确保您的页面已经包含了 jQuery 库。
下载 Farbtastic 插件文件 farbtastic.js。
在 HTML 文件的 <head> 部分或页面的底部，包含这个 JavaScript 文件：
```
<script type="text/javascript" src="farbtastic.js"></script>
```
如果您使用的是不支持 HTML5 canvas 元素的浏览器（如 Internet Explorer），则需要包含 Explorer Canvas polyfill。

2. 项目的使用说明

基本使用

在您的 HTML 中包含一个用于显示颜色选择器的 <div> 元素和一个文本输入框，并为它们设置唯一的 ID：
```
<form>
  <input type="text" id="color" name="color" value="#123456" />
</form>
<div id="colorpicker"></div>
```
在文档的 ready() 事件中初始化颜色选择器，并将其与文本输入框相连接：
```
$(document).ready(function() {
  $('#colorpicker').farbtastic('#color');
});
```

高级使用

jQuery 方法

使用 $(...).farbtastic() 可以在选定的对象中创建颜色选择器。callback 是可选的，可以是：

DOM 节点、jQuery 对象或 jQuery 选择器：颜色选择器将同步选中元素的值（对于表单元素）和颜色。
函数：每次用户选择不同的颜色时，这个函数将被调用。

对象方法

$.farbtastic(placeholder) 与使用 $(placeholder).farbtastic() 相同，但它返回的是一个 Farbtastic 对象而不是 jQuery 对象。这允许您使用下面的 Farbtastic 方法和属性。注意，每个占位符只有一个 Farbtastic 对象。如果使用相同的占位符两次调用 $.farbtastic(placeholder)，每次都会得到相同的对象。

可选的回调参数的行为与 jQuery 方法中的相同。

选项

$(...).farbtastic(options) 或 $.farbtastic(placeholder, options) 允许您传递除了回调之外的其他选项。可能的选项包括：

callback: 如前所述的回调。
height: 小部件的高度。
width: 小部件的宽度。

例如：$(...).farbtastic({ callback: '#color2', width: 150 })。

方法

.linkTo(callback)：允许您设置一个新的回调。任何现有的回调将被移除。
.setColor(string)：将选择器的颜色设置为给定的十六进制颜色。
.setColor([h, s, l])：将选择器的颜色设置为规范化的 HSL 颜色（0..1 的比例）。

属性

.linked：此选择器链接到的元素（jQuery 对象）或回调函数。
.color：当前的十六进制颜色表示。
.hsl：当前的规范化 HSL 颜色。

3. 项目 API 使用文档

请参考上文中的“高级使用”部分，其中详细介绍了如何使用 Farbtastic 提供的 API 方法。

4. 项目安装方式

项目的安装方式已在“安装指南”部分进行了说明。请按照给定步骤下载并包含必要的 JavaScript 文件。

jQuery Color Wheel

项目地址：https://gitcode.com/gh_mirrors/fa/farbtastic

热门内容推荐

1 开发者路线图项目教程 2 开源项目 `awesome-selfhosted` 使用教程 3 Vue.js 教程与指南 4 探索Vue 2的持久魅力：一个开源项目的深度解析 5 推荐项目：探索 Linux 内核的奥秘 6 开源项目指南：Linux 内核 7 Linux内核项目技术文档 8 TensorFlow 开源项目指南 9 TensorFlow 开源项目教程 10 TensorFlow：开启机器学习新纪元

最新内容推荐

《深入掌握OpenPTrack：安装与实战指南》《RBM-MNIST深度学习算法安装与实战指南》《Boundingmesh项目实战指南：安装、配置与深度探索》探索三维世界：cpu_tsdf开源项目的安装与使用教程探索Embxx：嵌入式C++库的安装与使用指南深入解析Valijson：安装、使用与实践指南《稳健点集配准算法GMMReg的安装与使用教程》《luacppinterface：C++与Lua混合编程的桥梁》深入掌握makerscanner：安装与使用指南《SoftModem：开源的Arduino与手机通信解决方案》

项目优选

收起

Python-100-Days

Python - 100天从新手到大师

HarmonyOS-Examples

本仓将收集和展示仓颉鸿蒙应用示例代码，欢迎大家投稿，在仓颉鸿蒙社区展现你的妙趣设计！

Cangjie-Examples

本仓将收集和展示高质量的仓颉示例代码，欢迎大家投稿，让全世界看到您的妙趣设计，也让更多人通过您的编码理解和喜爱仓颉语言。

学之思开源考试系统是一款 java + vue 的前后端分离的考试系统。主要优点是开发、部署简单快捷、界面设计友好、代码结构清晰。支持web端和微信小程序，能覆盖到pc机和手机等设备。支持多种部署方式：集成部署、前后端分离部署、docker部署

LangChat: Java LLMs/AI Project, Supports Multi AI Providers( Gitee AI/ 智谱清言 / 阿里通义 / 百度千帆 / DeepSeek / 抖音豆包 / 零一万物 / 讯飞星火 / OpenAI / Gemini / Ollama / Azure / Claude 等大模型), Java生态下AI大模型产品解决方案，快速构建企业级AI知识库、AI机器人应用

🚀Vite+Vue3+Gin的开发基础平台，支持TS和JS混用。它集成了JWT鉴权、权限管理、动态路由、显隐可控组件、分页封装、多点登录拦截、资源权限、上传下载、代码生成器【可AI辅助】、表单生成器和可配置的导入导出等开发必备功能。

🔥 一直想做一款追求极致用户体验的快速开发平台，看了很多优秀的开源项目但是发现没有合适的。于是利用空闲休息时间对若依框架进行扩展写了一套快速开发系统。如此有了开源字节快速开发平台。该平台基于 Spring Boot + MyBatis + Vue & Element ，包含微信小程序 & Uniapp， Web 报表、可视化大屏、三方登录、支付、短信、邮件、OSS...

CangjieCommunity

为仓颉编程语言开发者打造活跃、开放、高质量的社区环境

基于Webman的权限管理系统

cool-admin-java

🔥 cool-admin(java版)一个很酷的后台权限管理框架，Ai编码、流程编排、模块化、插件化、CRUD极速开发，永久开源免费，基于springboot3、typescript、vue3、vite、element-ui等构建